c4-doc-writer

Update Structurizr DSL workspaces from validated PRDs and ADRs.

5|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/russosalv/NONoise --skill c4-doc-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: c4-doc-writer
Source: https://github.com/russosalv/NONoise/tree/main/packages/skills/c4-doc-writer
Command: npx skills add https://github.com/russosalv/NONoise --skill c4-doc-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

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.

Frequently Asked Questions about c4-doc-writer

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

FAQPage Schema
How do I keep C4 architecture diagrams in sync with validated decisions?

To keep C4 architecture diagrams in sync, use a Structurizr DSL workspace as a living source of truth. This approach regenerates Context, Container, and Component views from validated PRDs while preserving manual edits.

How do I update my Structurizr DSL workspace from ADRs and PRDs?

To update your Structurizr DSL workspace, run an interactive discovery flow against validated PRDs and ADRs. It proposes an atomic diff for the workspace.dsl file and waits for confirmation before writing changes.

Can I preserve manual edits when regenerating Structurizr DSL views?

Yes, you can preserve manual edits when regenerating Structurizr DSL views. The regeneration process applies an atomic diff to the workspace.dsl file that specifically protects and retains your existing hand-edited changes.

What is the best way to make architecture diagrams diff-able and reproducible?

The best way to make architecture diagrams diff-able and reproducible is maintaining a single Structurizr DSL workspace. This model-first method eliminates manual redraws and ensures view updates are reviewable.

Does generating Structurizr DSL automatically execute CLI commands?

Generating Structurizr DSL does not execute CLI commands. It performs syntactic validation, writes the workspace.dsl file atomically, and only prints the exact Structurizr CLI or Docker commands for you to run manually.