v1.0.0
First public release.
Added
- Mode router in
SKILL.mdthat detects the usage mode from signals in the user's message and routes to one of five workflows: design (greenfield), document-code (retro-doc from a codebase, delegates to an Explore sub-agent on large repos), document-prose (README / ADR / spec), review (critique or explanation), and update (evolve an existing C4). - Supporting diagrams reference (
supporting-diagrams.md) for System Landscape, C4Deployment, and C4Dynamic. - Common contract applied to every mode: format negotiation (Mermaid C4 + Markdown by default; Structurizr DSL, PlantUML, and images as alternatives), destination negotiation (local filesystem or connected MCP: Notion, Linear, Google Drive), notation rules, deliverable structure, and dialogue rules.
- Sourced references grounded in external authority:
mermaid-c4-syntax.mdrebuilt frommermaid.js.org/syntax/c4.html;review-checklist.mdsourced fromc4model.com/diagrams/checklist. Editorial additions are clearly separated from sourced content. - Level template (
level-template.md) and example deliverables (examples/) filled out for Simon Brown's Internet Banking System. - Bilingual discoverability: English-authored body with French trigger phrases ("modèle C4", "diagramme d'architecture") preserved in the frontmatter.
- Plugin marketplace config (
.claude-plugin/marketplace.json,.claude-plugin/plugin.json) and release automation (.github/workflows/release.yml): av*tag push triggers extraction of the matching CHANGELOG section and publishes a GitHub Release. - Test suite: an automated bash suite (
tests/claude-code/) that invokesclaude -pwith assertion helpers (assert_contains,assert_order,assert_file_exists) and a manual test matrix (tests/test-prompts.md) with expected routing, flows, and red flags per mode. - Governance:
README.md,LICENSE(MIT),CLAUDE.md,CONTRIBUTING.md,CODE_OF_CONDUCT.md,.github/PULL_REQUEST_TEMPLATE.md.
Editorial invariants
Load-bearing rules encoded in SKILL.md and mirrored in review-checklist.md:
- Simon Brown's golden rule: Context + Container are the default; Component and Code only on explicit request.
- One Markdown document per level, never a bare diagram.
- Relation labels must state intent. Bare "Uses", "Calls", and "Reads" are banned.
- Inter-container relationships must state the protocol.
- Technology is mandatory on every Container and Component.
- Assumptions stay explicit. Inferences never slip silently into the diagram.
- Interactive by default. No finalized delivery without explicit user validation.