Creador de ADR
Crea Registros de Decisión de Arquitectura (ADR) concisos que explican una decisión, el contexto que la motivó, las opciones consideradas y las consecuencias aceptadas.
Contrato de Activación
Usa este skill cuando el usuario solicite un ADR, registro de decisión de arquitectura, registro de decisión técnica, o cualquier registro formal de por qué se tomó una elección técnica o arquitectónica.
Por defecto, usa el modo entrevista a menos que el usuario ya haya proporcionado suficiente información para redactar un ADR completo. Haz las preguntas de la entrevista en el idioma del usuario. El artefacto del ADR debe estar en inglés, a menos que el usuario solicite explícitamente otro idioma.
Reglas Estrictas
- Haz una sola pregunta a la vez en modo entrevista.
- Indica una vez al inicio de la entrevista que el usuario puede omitir preguntas o detener la entrevista en cualquier momento.
- Mantén un contador dinámico de preguntas restantes estimadas; actualízalo cuando aparezcan o desaparezcan dependencias.
- Recomienda respuestas de ejemplo breves cuando ayuden al usuario a responder.
- Formatea las preguntas de la entrevista como Markdown legible, no como texto plano.
- Desafía constructivamente respuestas vagas, contradictorias o sin fundamento antes de redactar; continúa si el usuario dice explícitamente que sigas de todos modos.
- No inventes alternativas, pros, contras o fundamentos. Pregunta cuando falten alternativas.
- Usa
Acceptedcuando la decisión ya esté tomada; usaProposedpara propuestas, evaluaciones o estado incierto. - Escribe o modifica archivos solo cuando el usuario lo solicite explícitamente (archivo/ruta).
Flujo de Entrevista
Recopila solo lo necesario, primero las dependencias:
- Título y estado de la decisión.
- Contexto: problema, restricciones, fuerzas y por qué la decisión es importante ahora.
- Opción elegida o propuesta.
- Opciones consideradas, con pros y contras de cada una.
- Consecuencias: beneficios, desventajas, riesgos y compensaciones.
- Seguimiento solo cuando haya acciones abiertas útiles o preguntas sin resolver.
Formato de pregunta:
### Pregunta N — [pregunta enfocada]
**Respuesta recomendada:** [ejemplo breve cuando sea útil]
**Por qué es importante:** [razón breve]
**Preguntas restantes estimadas:** ~M
Mini ejemplo:
### Pregunta 1 — ¿Esta decisión ya está tomada o todavía está en propuesta?
**Respuesta recomendada:** "Aceptada — ya elegimos PostgreSQL para los datos de facturación."
**Por qué es importante:** El estado cambia si el ADR registra una decisión final o una propuesta bajo revisión.
**Preguntas restantes estimadas:** ~5
Contrato de Salida
Lee assets/template-markdown.md antes de redactar y completa esa estructura.
Por defecto, devuelve el ADR final como exactamente un bloque de código Markdown y no crees archivos. Si el usuario solicitó explícitamente un archivo/ruta, guarda el ADR allí y resume la ruta guardada en el chat.
Nunca dejes instrucciones de marcador de posición en el ADR final. Si el usuario omite intencionalmente un detalle requerido, usa TBD con moderación y solo para ese detalle omitido.
Referencia
- Plantilla:
assets/template-markdown.md