¿Qué hace esta skill?

La Registros de Decisiones Arquitectónicas Skill captura las decisiones arquitectónicas que se toman durante las sesiones de desarrollo y genera documentos ADR estructurados con contexto, alternativas y consecuencias. Cada registro queda documentado junto al código en docs/adr/, de modo que el razonamiento detrás de cada elección sea comprensible para cualquier desarrollador en el futuro.

Registrar una decisión
Cuando el usuario dice "registra esta decisión" o "crea un ADR", la skill extrae la elección nuclear y genera el documento completo.
Comparar alternativas
Documenta qué otras opciones se consideraron (framework, librería, base de datos, patrón) y por qué se descartaron.
Consultar ADRs existentes
Cuando alguien pregunta "¿por qué elegimos X?", busca en el índice y presenta el contexto y la decisión del ADR correspondiente.
Planificación con trade-offs
Durante fases de planificación donde se discuten trade-offs arquitectónicos, registra el razonamiento para el equipo.

Ejemplos de uso

🏗️ Registrar decisión de base de datos
Vamos a usar PostgreSQL en lugar de MongoDB porque necesitamos transacciones ACID y relaciones fuertes. Registra esta decisión.
⚖️ Decisión sobre framework
Hemos decidido usar FastAPI en lugar de Flask porque necesitamos validación de tipos y documentación OpenAPI automática. Crea un ADR.
🔍 Consultar ADR existente
¿Por qué elegimos REST en vez de GraphQL? Busca el ADR correspondiente.
📋 Inicializar repositorio de ADRs
Inicializa la carpeta docs/adr/ con el índice y la plantilla para empezar a documentar decisiones.

Características

Formato ADR estructurado Genera documentos con secciones de Contexto, Decisión, Alternativas consideradas y Consecuencias (positivas, negativas, riesgos).
Numeración automática Escanea los ADR existentes e incrementa el contador para asignar el número correcto a cada nuevo registro.
Índice mantenido Actualiza docs/adr/README.md con cada nuevo ADR para mantener un índice navegable de todas las decisiones.
Consulta inteligente Busca en el índice y presenta el contexto y la decisión de ADRs existentes cuando alguien pregunta por una elección pasada.
Modelo de Michael Nygard Sigue el modelo ligero adaptado para desarrollo asistido por IA: conciso, en presente, legible en menos de dos minutos.

Preguntas frecuentes

Los ADR se guardan en docs/adr/ dentro del repositorio del proyecto, con el formato NNNN-titulo.md y una entrada en el índice README.md.
No. La skill funciona únicamente con acceso al sistema de archivos para crear y leer archivos Markdown en docs/adr/.
Sí. Pregunta "¿por qué elegimos X?" y la skill buscará en el índice de ADRs y te presentará el contexto y la decisión del documento correspondiente.
No. La skill presenta un borrador al usuario y solo escribe el archivo tras aprobación explícita.

Skills relacionadas

Mas skills de la misma categoria:

Registros de Decisiones Arquitectónicas — Documentación ADR con Claude AI

¿Prefieres escuchar el contenido? Genera la narración de audio con un clic.