Skills

Architecture Decision Record

Crea un Registro de Decisión de Arquitectura (ADR) para cualquier decisión técnica.

Install

npx skills add mohitagw15856/pm-claude-skills --skill architecture-decision-record -g -a claude-code -y
Category
Engineering
Updated
3d ago
License
MIT
Context cost
Mediumabout 1,964 tokens
Runs scripts
No, instructions only

What it does

Crea un Registro de Decisión de Arquitectura (ADR) para cualquier decisión técnica. Úsalo cuando necesites documentar una decisión técnica, escribir un ADR, registrar una elección arquitectónica o capturar por qué se seleccionó una tecnología o enfoque. Produce un ADR estructurado con contexto, decisión, consecuencias e intercambios.

Habilidad de Registro de Decisión de Arquitectura (ADR)

Esta habilidad produce un Registro de Decisión de Arquitectura (ADR) completo siguiendo el formato Nygard, el estándar más ampliamente adoptado. Los ADRs documentan el razonamiento detrás de decisiones técnicas significativas para que los futuros miembros del equipo entiendan no solo qué se decidió, sino por qué.

Inputs Requeridos

Trabaja con lo que se proporciona. Si falta algo de esto, aun así produce el resultado completo: rellena cada vacío con una suposición razonable marcada como (asumido, confirmar) y lista esas suposiciones al final. Solo haz una pregunta cuando falta el tema central en sí (no hay nada sobre lo que escribir).

  • Número de ADR (número secuencial en tu registro de ADR, p. ej. 012; o "siguiente disponible" si es desconocido)
  • Título de la decisión (breve, p. ej. "Usar PostgreSQL como almacén de datos principal")
  • Contexto (¿qué situación llevó a que esta decisión fuera necesaria?)
  • Opciones consideradas (al menos 2; si solo se da 1, solicita alternativas que fueron consideradas o descartadas)
  • Decisión tomada (qué opción fue elegida)
  • Razón de la elección
  • Estado (Propuesto / Aceptado / Deprecado / Reemplazado)
  • Autor y fecha
  • Contexto del equipo (opcional, tamaño del equipo, experiencia relevante, restricciones organizacionales; ayuda a calibrar la formalidad y profundidad de la sección de Contexto)

Formato de Salida


ADR-[NNN]: [Título de la Decisión]

Fecha: [YYYY-MM-DD] Estado: [Propuesto / Aceptado / Deprecado / Reemplazado por ADR-NNN] Autor(es): [Nombre(s)] Responsables de la decisión: [Quién tuvo la palabra final, individuo o equipo]


Contexto

Read the whole SKILL.md on GitHub

More in Engineering