Karthick-Ramachandran/recall-os

Skill: Criar ADR

Propósito

Registrar decisões arquiteturais duráveis para que futuros humanos e agentes não as redescubram ou contradigam.

Entradas

• Tópico da decisão.
• Contexto e restrições.
• Opções consideradas.
• Decisão recomendada ou selecionada.

Leitura Obrigatória

• docs/10-architecture/ARCHITECTURE.md
• docs/10-architecture/FILE_WRITE_POLICY.md
• docs/20-security/SECURITY_MODEL.md
• ADRs existentes relevantes em docs/adrs/

Arquivos de Saída

• docs/adrs/ADR-####-<slug>.md

Processo

1. Determinar se a mudança precisa de um ADR.
2. Encontrar o próximo número de ADR sem reutilizar números existentes.
3. Escrever contexto, decisão, alternativas, consequências e documentos relacionados.
4. Marcar o status como Proposto a menos que o humano já tenha aceitado a decisão.
5. Vincular a PRDs afetados, documentos de arquitetura, documentos de funcionalidade e documentos de segurança.

Condições de Parada

Parar e solicitar decisão humana se:

• A decisão altera a postura de segurança, comportamento de rede, telemetria, gravações de arquivos, autenticação, segredos, nuvem ou MCP em tempo de execução.
• A decisão solicitada entra em conflito com um ADR aceito.
• A decisão ainda não foi realmente tomada e deve permanecer como uma proposta.

Nível de Qualidade

• O ADR explica por que a decisão existe, não apenas o que mudou.
• Alternativas e consequências são honestas.
• O status é claro.
• Os documentos relacionados estão vinculados.