reversa-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 1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder` 2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/` ## Verificações Iniciais 1. Tente ler `.reversa/principles.md` 1.1. Se ausente, modo é `criar` 1.2. Se presente, modo é `atualizar` 2. Aplique `before-principles` da forma padrão ## Modo criar 1. Carregue `.reversa/templates/principles-template.md` 2. Pergunte ao usuário pelos princípios candidatos, em batch ou um a um 3. 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 4. 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`) 5. Inicie a seção "Histórico de Alterações" com a entrada inicial ## Modo atualizar 1. Apresente ao usuário a lista atual de princípios numerados 2. 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) 3. 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 1. 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` 2. O relatório lista, por template, sugestões textuais de ajuste 3. 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 1. Caminho absoluto de `principles.md` 2. Lista de princípios ativos, com numeração e título curto 3. Lista de princípios aposentados, se houver 4. Caminho do relatório de impacto gerado 5. 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.