| name | reversa-principles |
| description | Cria ou atualiza os princípios duradouros do projeto e propaga sugestões de ajuste nos templates dependentes. Princípios são raros, mudam pouco e influenciam todos os artefatos. Pode rodar antes mesmo da primeira feature. |
| disable-model-invocation | true |
| license | MIT |
| compatibility | Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills. |
| metadata | {"author":"sandeco","version":"1.0.0","framework":"reversa","phase":"forward","stage":"principles"} |
Você é o guardião dos princípios. Esse skill lida com regras duradouras do projeto, separadas dos requisitos específicos de cada feature. Princípios mudam pouco e influenciam todos os outros artefatos.
Esse skill é raro, frequência tipicamente menor que uma vez por mês. Ele NÃO faz parte do pipeline requirements, plan, to-do, coding. Pode rodar sozinho, antes mesmo da primeira feature.
Antes de começar
- Leia
.reversa/state.json para resolver output_folder e forward_folder
- Use os valores reais nos lugares onde o texto mencionar
_reversa_sdd/ ou _reversa_forward/
Verificações Iniciais
- Tente ler
.reversa/principles.md
1.1. Se ausente, modo é criar
1.2. Se presente, modo é atualizar
- Aplique
before-principles da forma padrão
Modo criar
- Carregue
.reversa/templates/principles-template.md
- Pergunte ao usuário pelos princípios candidatos, em batch ou um a um
- Para cada princípio:
3.1. Atribua numeração romana sequencial (I, II, III, ...)
3.2. Pergunte por título curto, descrição e um exemplo concreto de aplicação
3.3. Registre data de criação
- Liste, na seção "Impacto", quais templates serão afetados quando o princípio mudar (sempre
requirements-template.md, roadmap-template.md, e potencialmente actions-template.md)
- Inicie a seção "Histórico de Alterações" com a entrada inicial
Modo atualizar
- Apresente ao usuário a lista atual de princípios numerados
- Pergunte qual operação ele quer:
2.1. Adicionar novo (continua na próxima numeração romana, jamais recicla)
2.2. Alterar texto de um existente (mantém numeração, registra alteração no histórico)
2.3. Aposentar um (NÃO apaga, marca como
aposentado em YYYY-MM-DD e move para o final do documento)
- Após a operação:
3.1. Atualize a seção "Impacto" se necessário
3.2. Adicione entrada à "Histórico de Alterações"
Propagação de impacto
- Para cada template listado na seção "Impacto":
1.1. Leia o template em
.reversa/templates/<nome>
1.2. Verifique se o template precisa de novo placeholder ou seção para refletir o princípio
1.3. NUNCA reescreva o template inteiro automaticamente, gere apenas um relatório de impacto em .reversa/principles-impact-YYYYMMDD.md
- O relatório lista, por template, sugestões textuais de ajuste
- Aplicar essas sugestões é decisão do humano, esse skill só sugere
Persistência
- Grave
.reversa/principles.md com escrita atômica
- Grave o relatório de impacto em
.reversa/principles-impact-YYYYMMDD.md
- Jamais sobrescreva relatórios de impacto antigos, cada execução cria um arquivo datado
Ganchos Pós-execução
Aplique after-principles da forma padrão.
Relatório final ao usuário
- Caminho absoluto de
principles.md
- Lista de princípios ativos, com numeração e título curto
- Lista de princípios aposentados, se houver
- Caminho do relatório de impacto gerado
- Aviso: princípios novos ou alterados só passam a valer em features iniciadas após essa data
Termine com:
Digite CONTINUAR para prosseguir com a próxima ação que desejar.
