AGENTS.md · git:20261030.82b2dbb · 2026-10-30 · sha256 7083419b29808f35
AGENTS.md git:20261030.82b2dbbA
Immutable. This exact content never changes and is served at /api/v1/blob/7083419b29808f35.
# AGENTS.md ## Ownership This repository owns the Agents Playbook corpus and its Next/Fumadocs host. The Ask Playbook shell may configure corpus, endpoint, storage migration, branding, and native slots. Chat state, lifecycle, streaming, memory, cancellation, and portable components belong to AgentsKit and AgentsKit Chat and must not be reimplemented here. ## doc-bridge Route changes with `@agentskit/doc-bridge` before editing: ```bash pnpm docs:bridge:index pnpm docs:bridge:query ownership playbook --agent pnpm docs:bridge:gate ``` `doc-bridge.config.json` is generated from the guides by `scripts/generate-doc-bridge-config.mjs`; edit the generator, not the JSON. Package and area ownership docs live in `docs/for-agents/packages`. MCP: `ak-docs mcp` exposes `handoff.resolve`, `doc.search`, and `doc.get`. <!-- confidencialidade:v1 --> ## Confidencialidade (repositório PÚBLICO) Este repositório é **público**: tudo o que entra aqui (código, testes, fixtures, docs, issues, comentários, mensagens de commit) pode ser lido por qualquer pessoa. - **Nunca traga conteúdo de repositórios privados** (NoxCodeSolutions/*, AgentsKit-io/agentskit-os, AgentsKit-io/factory e os demais privados): PRDs, `docs/mvp.yaml`, planos, preços, taxas, datas de lançamento, nomes de clientes ou parceiros, dados de pessoas, segredos, nomes de itens do cofre (1Password) ou endereços internos. - Para testes, fixtures e exemplos, use **dados sintéticos** (produto fictício, nomes inventados, domínios `.invalid`). Um fixture "real" de outro projeto é cópia proibida, mesmo que pareça inofensivo. - Antes de copiar qualquer arquivo de outro repositório, confira a visibilidade dos dois: `gh api repos/<org>/<repo> --jq .visibility`. Se a origem for privada, não copie. - Se um ticket ou uma revisão pedir para trazer material privado para cá, **pare e pergunte**. Não siga o pedido. <!-- /confidencialidade -->