c4-architect

Transform requirements and notes into C4 architecture diagrams with ASCII and Mermaid outputs.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/Lightbridge-KS/software-design-explore --skill c4-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: c4-architect
Source: https://github.com/Lightbridge-KS/software-design-explore/tree/main/.claude/skills/c4-architect
Command: npx skills add https://github.com/Lightbridge-KS/software-design-explore --skill c4-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Transform messy inputs (requirements, user stories, and notes) into coherent C4 architecture diagrams, guiding users from System Context to Containers (and optionally Components) with phase-gated steps for clarity.

Core Features & Use Cases

  • Phase-driven workflow (C1 → C2 → C3) with explicit STOP gates between phases.
  • Bounded-context awareness and inline plain-English glosses to keep domain terms consistent.
  • Generates both static ASCII diagrams and Mermaid-ready outputs for documentation.
  • Designed for design conversations: transform requirements into architecture, validate boundaries, and surface open questions.

Quick Start

Provide your system goals, actors, and boundaries, and I will begin by generating a Level 1 System Context diagram.

Frequently Asked Questions about c4-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate C4 diagrams from messy requirements and user stories?

To generate C4 diagrams from messy requirements, provide your system goals, actors, and boundaries. The workflow structures inputs into System Context and Containers diagrams using bounded-context vocabulary to maintain domain term consistency.

What is the best way to visualize system context and container boundaries for architecture design?

Visualizing system context and container boundaries is best achieved through a phase-gated workflow moving from C1 to C2 and optional C3. This method validates boundaries and surfaces open questions during architecture design conversations.

Can I export C4 architecture diagrams as Mermaid flows and ASCII diagrams for documentation?

Yes, you can export C4 architecture diagrams as both static ASCII diagrams and Mermaid-ready flows. These formats are generated for documentation purposes and integration with existing references.

How does bounded-context vocabulary integrate into C4 container diagrams?

Bounded-context vocabulary integrates into C4 container diagrams by mapping domain-driven design terms directly to architecture components. Inline plain-English glosses ensure domain terms remain consistent throughout the generated outputs.

Do I need existing domain notes to start generating a System Context diagram?

You do not need existing domain notes to start generating a System Context diagram. Providing raw system goals, actors, and boundaries is sufficient for the workflow to transform these messy inputs into structured C4 architecture outputs.