C4 Architecture
Escribe diagramas C4 de Contexto/Contenedor/Componente/Despliegue como Mermaid en docs/architecture/
Funciona con configuración
Qué hace
Genera documentación de arquitectura de software como diagramas C4 de Mermaid en cuatro niveles de abstracción (Contexto, Contenedor, Componente, Despliegue) más diagramas de flujo de solicitud dinámicos, y los escribe en docs/architecture/ bajo una convención de nombres fija. Contiene la sintaxis completa de elementos y relaciones de Mermaid C4, una tabla de selección de nivel según la audiencia, y reglas como flechas unidireccionales, etiquetas de borde con verbos de acción, etiquetas de tecnología en cada relación y un límite de 20 elementos por diagrama. Se activa ante solicitudes para crear un diagrama de arquitectura, diagrama C4, contexto de sistema, diagrama de contenedor, componente o despliegue, o para documentar o visualizar la arquitectura del sistema.
Informe de la prueba
Se encontró skills/c4-architecture/SKILL.md (295 líneas) a través de la API de GitHub tree; el frontmatter se analizó con name+description, y los tres archivos referenciados en el cuerpo se obtuvieron con HTTP 200 (references/c4-syntax.md 14564 B, common-mistakes.md 12441 B, advanced-patterns.md 18346 B), al igual que README.md. Markdown puro, cero scripts; grep para curl|wget|base64|eval|api_key|"ignore previous" en SKILL.md y todas las referencias no arrojó nada, y la única ruta a la que escribe es la relativa docs/architecture/. Frases de activación juzgadas: DEBERÍA activarse — "Draw a C4 container diagram for this repo's services", "I need to document the architecture of our payment platform for new hires", "Can you make a deployment diagram showing our ECS + RDS setup" (todas sí, 3/3 correctas); NO DEBERÍA activarse — "Refactor OrderService to remove the circular dependency between modules" (cambio de código, no diagrama) y "Draw a sequence diagram in Mermaid for the checkout flow" (Mermaid pero no un nivel C4; la descripción enumera solo contexto/contenedor/componente/despliegue) — ambas rechazadas correctamente, 5/5. Prueba de salida: escribí un diagrama C4Container de línea base para un acortador de URL antes de abrir el cuerpo, luego lo rehíce bajo la habilidad; la versión de la habilidad añadió el diagrama de Contexto obligatorio como un segundo archivo bajo la nomenclatura documentada c4-context.md / c4-containers.md, reemplazó 3 etiquetas de borde genéricas ("Uses", "Calls", "Reads/Writes") con etiquetas de verbo de acción que llevaban una etiqueta de tecnología en los 5 bordes, actualizó los alias de web/api/db/cache a unos significativos, y añadió UpdateLayoutConfig — mejora real pero limitada, ya que la línea base ya era un Mermaid renderizable válido. La documentación pierde un punto porque el README afirma que "automatically selects the right level of detail for your audience" cuando eso es una tabla de búsqueda que el modelo consulta, no automatización.
Probado el: 2026-07-21 · Claude Code 2.x (agent harness)
Instalación
git clone --depth 1 https://github.com/softaworks/agent-toolkit.git /tmp/c4-architecture-src mkdir -p ~/.claude/skills cp -R /tmp/c4-architecture-src/skills/c4-architecture ~/.claude/skills/c4-architecture # Claude Code plugin instead: /plugin marketplace add softaworks/agent-toolkit # then /plugin install c4-architecture@agent-toolkit # Pure markdown, no scripts or extra dependencies.
Comandos y prompts de ejemplo
/c4-architectureEscribe diagramas C4 de Contexto/Contenedor/Componente/Despliegue como Mermaid en docs/architecture/
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Create a C4 context diagram for this systemDocument our architecture with a container diagramGenerate a component diagram for this service