Skip to content

_TEMPLATE agente

Jump to bottom
Petrus Silva Costa edited this page Aug 17, 2026 · 1 revision

Modelo de pagina de agente

Esta pagina e o modelo que toda pagina de agente da wiki segue. Ela serve a quem mantem a documentacao (nao e sobre um agente especifico). O objetivo e que as 51 paginas de agentes tenham a mesma estrutura, o mesmo tom didatico para iniciante e a mesma qualidade.

Padrao de nome de arquivo

Cada agente tem uma pagina propria. O nome do arquivo (que vira o titulo da pagina na wiki do GitHub) segue o padrao:

Agente-<slug>.md

O <slug> e o identificador do agente, igual ao nome do arquivo dele na pasta agents/ do repositorio, sem a extensao .md. Exemplos:

  • Agente-celso-ceo.md para o agente celso-ceo.
  • Agente-backend-engineer.md para o agente backend-engineer.
  • Agente-cosimo-chief-of-staff.md para o agente cosimo-chief-of-staff.

Os links na Home ja usam esse padrao, entao basta criar os arquivos com esses nomes para que os links funcionem.

Regras de redacao (validas para todas as paginas de agente)

  • Publico iniciante. Escreva para quem nunca programou nem usou o Claude Code. Explique todo jargao ou aponte para o Glossario.
  • Portugues do Brasil. Tom direto, frases curtas, voz ativa.
  • Sem em-dash. Nunca use o travessao longo. Use virgula, parenteses, dois-pontos ou ponto.
  • Sem dados pessoais. Nao inclua nomes de pessoas reais, e-mails, caminhos de pasta de usuario, nomes de maquina ou de provedor. O unico autor publico e petrinhu.
  • Derive, nao copie. Resuma o conteudo do arquivo do agente (em agents/<slug>.md) com suas palavras, de forma didatica. Nao cole o texto cru.
  • Hierarquia de titulos. Um unico titulo de primeiro nivel (#) por pagina; depois ## para as secoes; sem pular niveis.
  • Sempre fechar com links. Termine com um rodape que aponta para paginas relacionadas e para a Home.

Estrutura de secoes

Toda pagina de agente deve ter, nesta ordem, as secoes abaixo. O titulo de primeiro nivel da pagina e o nome amigavel do agente (por exemplo, # Celso (CEO) ou # Engenheiro Backend (backend-engineer)).

1. O que e / cargo

Uma a tres frases dizendo, em linguagem simples, qual e o cargo do agente e o que ele representa na empresa. Comece pelo essencial: "Este agente e o [cargo]; ele cuida de [area]."

2. Quando o Claude usa este agente

Liste as situacoes e os pedidos tipicos que fazem o Claude Code acionar este agente. Use exemplos de frases que o usuario poderia dizer (por exemplo, "implementar um endpoint", "revisar a seguranca", "planejar o lancamento"). Isso ajuda o leitor a saber quando esperar este especialista.

3. O que ele faz

Explique, em bullets ou paragrafos curtos, as principais responsabilidades do agente, traduzindo o jargao. Foque no valor para o leitor, nao numa lista exaustiva. De 4 a 8 pontos costuma bastar. Quando citar um termo tecnico, explique-o na hora ou aponte para o Glossario.

4. Cor e camada

Diga a cor do agente e o que ela significa:

  • Laranja: agente de lideranca C-level (decide e coordena).
  • Azul: agente operacional (executa o trabalho).

Indique tambem a familia, quando for operacional (Engenharia, Dados e IA, Produto e Design, Gestao e Pessoas, Marketing, ou Suporte e Docs).

5. Manuais que ele consulta

Liste os manuais de governanca que este agente le antes de decidir (eles ficam na pasta docs/ do repositorio). Explique em uma linha o que cada manual cobre. Exemplos comuns: CONTRACT (padrao de codigo), TESTES (qualidade e testes), AGILE (cadencia agil), DEPLOY_CHECKLIST (deploy e rollback), AUDITORIAS (checklists de revisao), ORG (governanca e quem decide), pipeline_release_1.0 (as 12 fases), TOOLING (ferramentas livres por agente). Inclua apenas os que aquele agente realmente usa, com base no arquivo dele.

6. Exemplo de pedido

De um exemplo concreto e simples de algo que o usuario poderia pedir e que acionaria este agente, com uma frase sobre o que ele entregaria em resposta. Mantenha curto e realista.

Rodape

Feche com links para agentes relacionados (por exemplo, o C-level que coordena este operacional, ou os operacionais que este C-level aciona) e para a Home.

Esqueleto pronto para copiar

# <Nome amigavel do agente> (<slug>)

Esta pagina descreve o agente `<slug>` de forma didatica. Se algum termo for novo, consulte o [Glossario](Glossario).

## O que e / cargo

<Uma a tres frases sobre o cargo e a area de atuacao.>

## Quando o Claude usa este agente

<Situacoes e pedidos tipicos, com exemplos de frases do usuario.>

## O que ele faz

- <Responsabilidade 1, com jargao explicado.>
- <Responsabilidade 2.>
- <Responsabilidade 3.>
- <Responsabilidade 4.>

## Cor e camada

Cor <laranja|azul> (<lideranca C-level|operacional>). <Se operacional, citar a familia.>

## Manuais que ele consulta

- `<MANUAL>`: <o que cobre>.
- `<MANUAL>`: <o que cobre>.

## Exemplo de pedido

<Frase de exemplo do usuario.> <O que o agente entregaria em resposta.>

---

Veja tambem <links para agentes relacionados>. Voltar para a [Home](Home).

Fonte do conteudo

O conteudo de cada pagina deriva do arquivo do agente em agents/<slug>.md do repositorio (em especial o campo description do cabecalho e as secoes "Mandato" e "Principios nao negociaveis"), resumido em linguagem para iniciante. A cor sai do campo color do mesmo arquivo. As familias e a relacao de delegacao entre C-levels e operacionais saem do manual docs/ORG.md.

Voltar para a Home.

Clone this wiki locally