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 -->