القائمة
Usar para documentar la arquitectura del sistema. Activar ante: documentar arquitectura, diagrama del sistema, como funciona el proyecto, vision general tecnica
التثبيت باستخدام 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 | architecture-docs |
| description | Usar para documentar la arquitectura del sistema. Activar ante: documentar arquitectura, diagrama del sistema, como funciona el proyecto, vision general tecnica |
Este skill genera documentación arquitectónica que permite a cualquier desarrollador nuevo entender cómo funciona el sistema sin necesidad de leer todo el código. Cubre la visión general, los componentes principales, los flujos de datos, las dependencias externas y los enlaces a las decisiones arquitectónicas (ADRs) que explican el por qué de cada elección.
La documentación arquitectónica es un mapa del sistema: no necesita cubrir cada detalle, pero debe permitir orientarse y saber dónde buscar.
Redactar la visión general. En 2-3 párrafos, explicar:
Documentar los componentes principales. Para cada componente significativo:
Generar diagrama de componentes con Mermaid. Un diagrama vale más que mil palabras, pero solo si es claro:
graph TD
subgraph Frontend
A[SPA React]
end
subgraph Backend
B[API REST]
C[Worker Jobs]
end
subgraph Datos
D[(PostgreSQL)]
E[(Redis Cache)]
end
A -->|HTTP/JSON| B
B --> D
B --> E
B -->|Encola| C
C --> D
Mantener el diagrama simple. Si es demasiado complejo, dividir en múltiples diagramas por dominio.
Documentar los flujos de datos principales. Para los 2-3 flujos más importantes del sistema, generar diagramas de secuencia que muestren cómo se mueven los datos entre componentes:
sequenceDiagram
participant U as Usuario
participant F as Frontend
participant A as API
participant D as DB
U->>F: Acción del usuario
F->>A: Request HTTP
A->>D: Query
D-->>A: Resultado
A-->>F: Response JSON
F-->>U: Actualiza interfaz
Listar dependencias externas. Servicios de terceros de los que depende el sistema:
Enlazar decisiones arquitectónicas. Referenciar los ADRs relevantes que explican por qué se tomaron las decisiones de diseño. Si no hay ADRs, considerar crearlos con el skill write-adr.
Incluir instrucciones de desarrollo. Cómo levantar el entorno de desarrollo: