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.
1---2name: reversa-principles3description: 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.4license: MIT5---67Você é 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.89Esse 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.1011## Antes de começar12131. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`142. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`1516## Verificações Iniciais17181. Tente ler `.reversa/principles.md`19 1.1. Se ausente, modo é `criar`20 1.2. Se presente, modo é `atualizar`212. Aplique `before-principles` da forma padrão2223## Modo criar24251. Carregue `.reversa/templates/principles-template.md`262. Pergunte ao usuário pelos princípios candidatos, em batch ou um a um273. Para cada princípio:28 3.1. Atribua numeração romana sequencial (I, II, III, ...)29 3.2. Pergunte por título curto, descrição e um exemplo concreto de aplicação30 3.3. Registre data de criação314. 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`)325. Inicie a seção "Histórico de Alterações" com a entrada inicial3334## Modo atualizar35361. Apresente ao usuário a lista atual de princípios numerados372. Pergunte qual operação ele quer:38 2.1. Adicionar novo (continua na próxima numeração romana, jamais recicla)39 2.2. Alterar texto de um existente (mantém numeração, registra alteração no histórico)40 2.3. Aposentar um (NÃO apaga, marca como `aposentado em YYYY-MM-DD` e move para o final do documento)413. Após a operação:42 3.1. Atualize a seção "Impacto" se necessário43 3.2. Adicione entrada à "Histórico de Alterações"4445## Propagação de impacto46471. Para cada template listado na seção "Impacto":48 1.1. Leia o template em `.reversa/templates/<nome>`49 1.2. Verifique se o template precisa de novo placeholder ou seção para refletir o princípio50 1.3. NUNCA reescreva o template inteiro automaticamente, gere apenas um relatório de impacto em `.reversa/principles-impact-YYYYMMDD.md`512. O relatório lista, por template, sugestões textuais de ajuste523. Aplicar essas sugestões é decisão do humano, esse skill só sugere5354## Persistência5556- Grave `.reversa/principles.md` com escrita atômica57- Grave o relatório de impacto em `.reversa/principles-impact-YYYYMMDD.md`58- Jamais sobrescreva relatórios de impacto antigos, cada execução cria um arquivo datado5960## Ganchos Pós-execução6162Aplique `after-principles` da forma padrão.6364## Relatório final ao usuário65661. Caminho absoluto de `principles.md`672. Lista de princípios ativos, com numeração e título curto683. Lista de princípios aposentados, se houver694. Caminho do relatório de impacto gerado705. Aviso: princípios novos ou alterados só passam a valer em features iniciadas após essa data7172Termine com:7374> Digite **CONTINUAR** para prosseguir com a próxima ação que desejar.