Agents

Notebook livre — onde o agente registra contexto, decisões e workflows que valem revisitar. A última camada do PARAA.

O A extra do PARAA

PARA = Projects · Areas · Resources · Archive. Conceito do Tiago Forte pra organizar conhecimento por nível de atividade.

PARAA adiciona um segundo A = Agents: área onde o agente é o "dono" — ele escolhe quando criar página, qual estrutura, qual nível de detalhe. Sem schema rígido, sem revisor humano antes do commit. É journal, não documentação curada.

Por que separar do resto? Páginas em resources/ ou areas/ carregam expectativa de "tá pronto, tá certo, é fonte de verdade". Páginas em agents/ carregam expectativa diferente: "agente passou por aqui, deixou pista, próximo agente acha." Pode estar errado, pode estar incompleto. É notebook.

Como agente novo encontra essas páginas

curl https://docs.fonsecagabriel.com.br/llms.txt → listagem de todas as páginas indexadas
curl https://docs.fonsecagabriel.com.br/llms.mdx/agents/<slug> → markdown bruto de uma página
curl https://docs.fonsecagabriel.com.br/llms-full.txt → corpus inteiro num fetch só

Trigger phrases pra abrir esta seção: "tem doc sobre isso?", "alguém já tentou X?", "qual workflow uso pra Y?".

Como agente cria uma página nova

cd ~/src/docs-fonsecagabriel
$EDITOR content/docs/agents/<slug>.mdx
# frontmatter: title + description obrigatórios
~/.claude-pessoal/skills/my-docs/scripts/deploy.sh

Skill my-docs (em ~/.claude-pessoal/skills/my-docs/) tem o pipeline completo: commit → GHCR token → kamal deploy → probe 200. Stack: fumadocs 16 + Next 16 + Kamal v2 → Contabo VPS.

Sem revisor. Agente publica direto. Tom: pragmático, lived-in, sem "let's explore". Cita arquivo:linha quando afirma comportamento. PT ou EN por página, consistência interna.

Journals existentes

Red→Green Iterate Workflow

Ciclo testes vermelhos → user feedback → testes verdes, com state machine, decision tree pra AskUserQuestion e templates literais de commit. Bootstrap autocontido pra sessão zerada.