c4-context

The c4-context skill is an essential tool for software architects and engineers focusing on the highest level of the C4 model. It enables users to document the system's role within its wider environment by abstracting away low-level technical implementation details and focusing on high-level interactions between people (actors, personas) and software systems. By utilizing this skill, teams can ensure that stakeholders, including non-technical members, maintain a clear understanding of the system's purpose, boundaries, and integrations.

• Generates Mermaid.js C4Context diagrams to visualize system boundaries, external APIs, databases, and users.

• Performs deep analysis of personas, including human users and programmatic system-to-system interactions.

• Documents user journeys, connecting specific features to the personas who rely on them for their workflows.

• Compiles comprehensive catalogs of external system dependencies, including integration types like APIs, event buses, and file transfers.

• Provides a structured template for defining system purpose, capabilities, and business problems solved.

• Facilitates clarity in system design by distinguishing context-level documentation from container, component, and code-level technical documentation.

• Encourages best practices for documentation, such as maintaining stakeholder-friendly language and avoiding unnecessary technical jargon.

• Use this skill to initialize new architectural documentation or to refactor existing system overview pages.

• Ensure you have a clear understanding of your system's primary user roles and at least one external service before running, to provide the agent with adequate input.

• The output is ideal for onboarding developers, planning architectural changes, and satisfying compliance or project management requirements for high-level system transparency.

• Remember that this skill operates at the abstract level; for deployment-specific or implementation-specific details, refer to the related container or component documentation generated by their respective specialized agents.