¿Qué hace create-architectural-decision-record?
Crea un documento de Registro de Decisión Arquitectónica (ADR) para documentación de decisiones optimizada para IA.
Descripción
Esta habilidad genera automáticamente un ADR completo cuando se le proporcionan los detalles clave de una decisión arquitectónica. El ADR sigue el formato estándar y está enriquecido con anotaciones semánticas para mejorar la comprensión por parte de modelos de lenguaje grandes (LLMs).
Uso
- Proporciona el título de la decisión, el contexto, las opciones consideradas y la decisión final.
- La habilidad producirá un documento ADR formateado con las secciones:
- Título: Nombre descriptivo de la decisión.
- Contexto: Motivación y fuerzas que influyen.
- Decisión: La elección realizada y su fundamento.
- Consecuencias: Impactos positivos y negativos.
Compatibilidad
Funciona con asistentes como Claude Code, Cursor, Codex y otras herramientas de IA que admitan la ejecución de habilidades personalizadas.
Ejemplo de salida
# ADR-001: Uso de PostgreSQL como base de datos principal
## Contexto
Necesitamos una base de datos relacional que soporte transacciones ACID y escalabilidad horizontal.
## Decisión
Adoptar PostgreSQL 15 con replicación en clúster.
## Consecuencias
- Mayor consistencia de datos.
- Curva de aprendizaje para el equipo.
Notas
- Los ADRs generados son markdown estándar y se pueden almacenar en el repositorio del proyecto.
- Se recomienda numerar secuencialmente los ADRs para facilitar el seguimiento.
- Las anotaciones de IA ayudan a que los LLMs interpreten correctamente las secciones del documento.