c4-doc-writer

What problem does it solve?

Architects and engineering teams frequently have out-of-date architecture diagrams because manual edits diverge from validated decisions. This Skill produces and maintains a single Structurizr DSL workspace as the living source of truth so diagrams remain reviewable, diff-able, and reproducible without manual redraws.

Core Features & Use Cases

• Model-first C4 maintenance: discover validated PRDs and ADRs, propose model changes, and apply an atomic diff to docs/architecture/c4/workspace.dsl while preserving hand edits.
• Guided Q&A flow: interactive, phase-based discovery and proposal steps that ask one question at a time and wait for confirmation before writing.
• Renderer guidance and changelog: prints exact Structurizr CLI / Docker commands for regenerating views and appends a concise dated changelog entry for each update.
• Use case: after an arch-decision PASS, run this Skill to sync Context and Container views (and optional Component or dynamic views) to reflect the validated architecture.

Quick Start

Update the project's Structurizr DSL workspace from validated PRDs and ADRs and propose the diff to apply to docs/architecture/c4/workspace.dsl.