菜单
Usar para documentar decisiones arquitectónicas como ADR. Activar cuando el usuario quiera documentar por qué se tomó una decisión, registrar alternativas descartadas, crear un ADR, un decision record, dejar constancia de una elección técnica o justificar una decisión de diseño ante el equipo.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Alias global /alfred para abrir el asistente contextual de Alfred Dev sin escribir el namespace completo. Activar solo cuando el usuario invoque explicitamente /alfred.
Protocolo de respuesta ante incidentes en produccion: triaje, mitigacion, causa raiz y postmortem. Usar ante caidas, errores criticos, incidentes de seguridad o degradacion de servicio.
Usar para refactorizar código con tests como red de seguridad. Activar cuando el usuario quiera limpiar código, reducir complejidad, extraer función, mejorar nombres, eliminar duplicación, resolver un code smell o reorganizar la estructura interna sin cambiar comportamiento.
Generar Dockerfile optimizado. Activar cuando el usuario quiera crear contenedor, generar imagen Docker, configurar Docker Compose, contenerizar aplicacion o crear un Dockerfile multi-stage.
Planificar y ejecutar releases: inventario de cambios, versionado semantico, changelog, notas de release y publicacion. Usar antes de cada version nueva.
Auditar accesibilidad WCAG 2.1 nivel AA con checklist y correcciones. Activar ante: accesibilidad web, WCAG, lector de pantalla, contraste, navegacion por teclado, a11y
| name | write-adr |
| description | Usar para documentar decisiones arquitectónicas como ADR. Activar cuando el usuario quiera documentar por qué se tomó una decisión, registrar alternativas descartadas, crear un ADR, un decision record, dejar constancia de una elección técnica o justificar una decisión de diseño ante el equipo. |
Este skill genera un registro de decisión arquitectónica (ADR) siguiendo un formato estandarizado. Los ADR capturan no solo qué se decidió, sino por qué y qué alternativas se descartaron. Son la memoria institucional del proyecto: cuando dentro de seis meses alguien pregunte "por qué usamos X en vez de Y", el ADR tiene la respuesta.
Cada ADR es un fichero independiente, numerado secuencialmente, que se guarda en docs/adr/. Una vez aceptado, un ADR no se modifica; si la decisión cambia, se crea uno nuevo que lo sustituye.
Identificar la decisión a documentar. Un ADR se escribe cuando hay una decisión arquitectónica significativa: elección de tecnología, patrón de diseño, estructura de datos, estrategia de despliegue, etc. No documentar decisiones triviales.
Obtener el siguiente número secuencial. Listar los ADR existentes en docs/adr/ y asignar el siguiente número (formato NNN, por ejemplo 001, 002, 015).
Redactar el ADR con la siguiente estructura:
NNN - Descripción breve de la decisión. Ejemplo: 003 - Usar PostgreSQL como base de datos principal.propuesto, aceptado, sustituido por [NNN], rechazado.Utilizar la plantilla base. Si existe templates/adr.md, usarla como punto de partida para mantener consistencia entre ADRs del proyecto.
Guardar el fichero. Nombre: docs/adr/NNN-titulo-en-kebab-case.md. Ejemplo: docs/adr/003-usar-postgresql.md.
Actualizar el índice si existe. Si hay un fichero índice de ADRs (como docs/adr/README.md o docs/adr/index.md), añadir la nueva entrada.
Revisar con el usuario. El ADR es un registro de decisión consensuada. No se da por final hasta que el usuario lo aprueba.
Registrar la decisión en la memoria del proyecto con memory_log_decision incluyendo título, opción elegida, alternativas descartadas y justificación. Esto permite que futuros skills y sesiones tengan acceso rápido a la decisión sin necesidad de buscar el fichero ADR.
sustituido por [NNN].Este skill documenta la decisión como artefacto. La evaluación técnica previa de las opciones se hace con choose-stack (para tecnologías) o design-system (para patrones de arquitectura). Primero se evalúa, luego se documenta.
docs/adr/ con el formato de numeración correcto.