Karthick-Ramachandran/recall-os

Habilidad: Crear ADR

Propósito

Registrar decisiones arquitectónicas duraderas para que humanos y agentes futuros no las redescubran o contradigan.

Entradas

• Tema de la decisión.
• Contexto y restricciones.
• Opciones consideradas.
• Decisión recomendada o seleccionada.

Lectura Requerida

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

Archivos de Salida

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

Proceso

1. Determinar si el cambio necesita un ADR.
2. Encontrar el siguiente número de ADR sin reutilizar números existentes.
3. Escribir contexto, decisión, alternativas, consecuencias y documentos relacionados.
4. Marcar el estado como Propuesto a menos que el humano haya aceptado la decisión.
5. Enlazar a PRDs afectados, documentos de arquitectura, documentos de características y documentos de seguridad.

Condiciones de Parada

Detener y solicitar decisión humana si:

• La decisión cambia la postura de seguridad, el comportamiento de red, la telemetría, las escrituras de archivos, la autenticación, los secretos, la nube o el MCP en tiempo de ejecución.
• La decisión solicitada entra en conflicto con un ADR aceptado.
• La decisión aún no se ha tomado realmente y debe seguir siendo una propuesta.

Nivel de Calidad

• El ADR explica por qué existe la decisión, no solo qué cambió.
• Las alternativas y consecuencias son honestas.
• El estado es claro.
• Los documentos relacionados están enlazados.