enzolduarte/agent-project-template

Base reutilizável para trabalhar com Codex e Claude Code usando as skills de engenharia do pacote mattpocock-skills.
## Configuração incluída
AGENTS.md orienta o Codex.
CLAUDE.md orienta o Claude Code.
docs/agents/issue-tracker.md configura tarefas e especificações em Markdown local, dentro de .scratch/.
docs/agents/triage-labels.md mantém as cinco labels padrão.
docs/agents/domain.md define a leitura de glossários e decisões arquiteturais.
Os três documentos em docs/agents/ são cópias integrais dos modelos originais do setup do Matt Pocock, versão 1.3.2. O modelo issue-tracker-local.md foi copiado com o nome issue-tracker.md.
A base usa contexto único, com GLOSSARY.md na raiz e decisões em docs/adr/. Esses arquivos surgem conforme o domínio é definido. Sua ausência inicial permite prosseguir normalmente.
## Aplicar a um projeto
1. Extraia a base na raiz do projeto.
2. Se já houver AGENTS.md ou CLAUDE.md, incorpore o bloco Agent skills ao arquivo existente, preservando as outras instruções. Se o bloco já existir, atualize-o.
3. Se já houver arquivos em docs/agents/, compare e incorpore as configurações conforme o projeto.
4. Se já houver um README, mantenha-o e salve este guia como docs/guia-matt-pocock.md.
5. Tenha o plugin mattpocock-skills instalado em cada ferramenta que utilizar. A base fornece a configuração do projeto; as skills vêm do plugin. A instalação no Claude precisa ser conferida nesse ambiente.
6. Abra uma conversa no Codex ou Claude Code com a pasta do projeto como diretório de trabalho.
text
meu-projeto/
├── AGENTS.md
├── CLAUDE.md
├── README.md
├── docs/agents/
│ ├── issue-tracker.md
│ ├── triage-labels.md
│ └── domain.md
└── ...código do projeto
Os arquivos de entrada apontam para a mesma documentação. Ao mudar as convenções, mantenha suas referências coerentes.
## Começar uma funcionalidade
Selecione a skill correspondente na interface, quando disponível, e descreva o objetivo. Os nomes exibidos podem incluir o prefixo do plugin.
Exemplo de pedido inicial:
> Use a skill grill-with-docs do mattpocock-skills. Quero desenvolver [sua ideia]. Leia as configurações de docs/agents/ e me ajude a definir o comportamento e as decisões necessárias.
Se precisar escolher o caminho adequado:
> Use a skill ask-matt para indicar o fluxo adequado a esta tarefa.
## Fluxo de desenvolvimento
| Etapa | Skill | Resultado |
| Escolher o caminho | ask-matt | Seleção das skills adequadas à situação. |
| Refinar a ideia | grill-with-docs | Perguntas para esclarecer a ideia, com registro de termos e decisões. |
| Especificar | to-spec | Síntese da conversa em uma especificação, com alinhamento dos pontos de teste. |
| Dividir o trabalho | to-tickets | Proposta de entregas pequenas e completas, com dependências, para aprovação. |
| Executar um ticket | implement | Implementação com TDD quando possível, verificações, revisão e commit na branch atual. |
| Executar a especificação | implement-spec | Agentes por ticket, respeitando dependências e integrando o trabalho em uma branch. |
| Preparar um PR | pr | Descrição com resumo visual, evidências e impacto da mudança, quando houver PR. |
| Fazer retrospectiva | retro | Propostas de melhoria nas instruções, ferramentas e verificações do projeto. |