Habilidades C4 Context Level: System Context
📦

C4 Context Level: System Context

Seguro

Crear documentación de arquitectura de contexto del sistema C4

Los equipos de software tienen dificultades para crear documentación de arquitectura clara y accesible para las partes interesadas que comunique los límites del sistema y las dependencias externas. Esta skill genera documentación completa de nivel Contexto C4 que incluye personas, viajes de usuario, características del sistema y diagramas Mermaid.

Soporta: Claude Codex Code(CC)
🥉 73 Bronce
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "C4 Context Level: System Context". Create C4 Context documentation for an e-commerce platform

Resultado esperado:

La documentación de Contexto del sistema incluye: Persona Cliente browsando productos y completando compras, Persona Administrador gestionando inventario y pedidos, Sistema externo Pasarela de Pago para procesamiento de transacciones, Sistema de Gestión de Inventario para seguimiento de stock, y Servicio de Email para notificaciones. El diagrama Mermaid muestra el límite del sistema con todas las interacciones de usuarios y conexiones de API externas claramente etiquetadas.

Usando "C4 Context Level: System Context". Document user journeys for a healthcare patient portal

Resultado esperado:

Viaje del Paciente: Iniciar sesión con credenciales, ver calendario de citas, solicitar nueva cita, recibir notificación de confirmación. Viaje del Proveedor: Acceder a registros de pacientes, actualizar historial médico, prescribir medicamentos, presentar reclamaciones de seguros. Cada viaje incluye puntos de decisión, criterios de éxito y rutas de recuperación de errores.

Auditoría de seguridad

Seguro
v1 • 2/25/2026

Static analysis scanned 0 files with 0 lines of executable code. This is a prompt-only documentation skill containing templates and instructions for creating C4 system context diagrams. No security risks detected: no executable code, network calls, filesystem operations, or external command execution. Safe for publication.

0
Archivos escaneados
0
Líneas analizadas
0
hallazgos
1
Auditorías totales
No se encontraron problemas de seguridad
Auditado por: claude

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
87
Contenido
50
Comunidad
100
Seguridad
83
Cumplimiento de la especificación

Lo que puedes crear

Documentación de nuevo sistema

Crear documentación completa de Contexto C4 para un sistema recién diseñado para compartir con partes interesadas y equipos de desarrollo.

Análisis de sistema heredado

Generar documentación de contexto del sistema para un código base existente para mejorar la comprensión del equipo y la incorporación.

Comunicación con partes interesadas

Producir documentación de arquitectura accesible para partes interesadas para audiencias no técnicas, incluidos líderes de negocio.

Prueba estos prompts

Contexto básico del sistema
Crear documentación de nivel Contexto C4 para un [tipo de sistema] que [propósito principal]. Incluir las principales personas de usuario y listar las 3 principales dependencias de sistemas externos.
Documentación de contexto completa
Generar documentación completa de Contexto C4 que incluya: descripciones cortas y largas del sistema, todas las personas (humanas y programáticas), lista completa de características, mapas de viaje de usuario para cada característica clave, dependencias de sistemas externos, y un diagrama C4Context en Mermaid.
Enfoque en viaje de usuario
Para un [nombre del sistema] con [número] características clave, crear mapas detallados de viaje de usuario para cada persona. Mostrar paso a paso cómo cada persona interactúa con el sistema para lograr sus objetivos. Incluir rutas de manejo de errores.
Análisis de dependencias externas
Analizar las dependencias externas de este sistema y crear documentación completa. Para cada sistema externo, documentar: tipo (base de datos/API/servicio), método de integración, dirección del flujo de datos, requisitos de autenticación, e impacto de falla. Generar un diagrama en Mermaid que muestre todas las interacciones externas.

Mejores prácticas

  • Enfocarse en personas y sistemas de software en lugar de tecnologías y protocolos en diagramas de Contexto
  • Incluir tanto usuarios humanos como programáticos en la documentación de personas para una visión completa del sistema
  • Mantener los diagramas C4 Contexto accesibles para partes interesadas evitando detalles técnicos de implementación

Evitar

  • Mostrar tecnologías, protocolos o detalles de infraestructura en diagramas de nivel Contexto
  • Omitir usuarios programáticos y sistemas externos que interactúan con el sistema
  • Mezclar niveles C4 al incluir detalles de componentes o contenedores en la documentación de Contexto

Preguntas frecuentes

¿Qué es el modelo C4 y por qué usarlo?
El modelo C4 es un enfoque jerárquico para diagramas de arquitectura de software con cuatro niveles: Contexto, Contenedor, Componente y Código. Ayuda a los equipos a comunicar la arquitectura en diferentes niveles de detalle a diferentes audiencias.
¿Qué es un diagrama de Contexto del sistema?
Un diagrama de Contexto del sistema muestra su sistema como una caja en el centro, rodeado por sus usuarios y los otros sistemas con los que interactúa. Se enfoca en personas y sistemas de software en lugar de detalles técnicos de implementación.
¿Quién debería usar la documentación C4 Contexto?
La documentación de Contexto del sistema es ideal para partes interesadas, gerentes de producto, nuevos miembros del equipo, y cualquiera que necesite una comprensión de alto nivel de lo que hace el sistema y cómo se ajusta al ecosistema más amplio.
¿Cuál es la diferencia entre C4 Contexto y C4 Container?
C4 Contexto muestra el sistema como una sola caja con usuarios y sistemas externos. C4 Container hace zoom hacia adentro para mostrar los bloques de construcción técnicos de alto nivel como aplicaciones web, bases de datos y microservicios.
¿Puede esta skill generar diagramas Mermaid?
Sí, esta skill genera diagramas C4Context en Mermaid usando la sintaxis correcta del modelo C4 que incluye elementos Person, System, System_Ext, SystemDb y relaciones Rel.
¿Qué entrada necesita esta skill para generar documentación?
Proporcionar información básica del sistema incluyendo propósito, usuarios objetivo, características clave y dependencias externas conocidas. Una entrada más detallada produce una documentación de salida más completa.

Detalles del desarrollador

Estructura de archivos

📄 SKILL.md