Objetivo
Conduzir tarefas de governanca usando Specification-Driven Development: Specification, Discovery, Design, Development, Validation e Delivery.
Esta skill ajuda o Codex a separar regras globais, fluxos especificos e documentacao auxiliar sem aumentar desnecessariamente o contexto.
Quando usar
- Criar, revisar ou reorganizar skills em
.agents/skills/. - Ajustar
AGENTS.mdpara orientacoes globais, roteamento e convencoes compartilhadas. - Escrever ou revisar prompts SDD, politicas de uso do Codex ou governanca de automacao assistida.
- Avaliar se uma decisao deve ir para
.sdd/phase-2/decisions.mdou para documentacao operacional. - Preparar handoff entre chats.
Quando nao usar
- Implementar comportamento na aplicacao.
- Alterar testes de aplicacao.
- Corrigir pipelines sem trabalho de governanca.
- Criar scripts sem criterio deterministico, seguro e repetivel.
Processo
- Especifique a intencao da mudanca.
- Leia
AGENTS.md,.sdd/e.agents/quando existirem. - Descubra o estado real do repositorio antes de propor artefatos.
- Classifique o que pertence a regra global, skill, SDD, script ou documentacao.
- Decida antes de editar e registre decisoes duraveis.
- Crie poucos artefatos, com um proposito claro.
- Evite duplicar no
AGENTS.mdfluxos longos que pertencem a skills ou SDD. - Valide estrutura, nomes, links locais, ausencia de segredos e escopo.
- Revise diff, execute validacoes proporcionais e faca commit semantico quando solicitado.
Validacao
- Confirme frontmatter das skills com
nameedescription. - Confirme nomes em kebab-case.
- Confirme ausencia de referencias a arquivos inexistentes.
- Valide JSON, YAML e scripts quando forem criados ou alterados.
- Execute
git statuse revise o diff antes de finalizar.
Restricoes
- Nao criar skills genericas demais.
- Nao criar muitas skills para possibilidades raras.
- Nao alterar codigo de producao nem testes de aplicacao.
- Nao fazer push nem abrir Pull Request sem pedido explicito.