Skip to content

feat: add Mermaid wardley-beta dual output to Wardley map artifacts#181

Open
tractorjuice wants to merge 14 commits intomainfrom
feat/mermaid-wardley-dual-output
Open

feat: add Mermaid wardley-beta dual output to Wardley map artifacts#181
tractorjuice wants to merge 14 commits intomainfrom
feat/mermaid-wardley-dual-output

Conversation

@tractorjuice
Copy link
Owner

Summary

  • Adds Mermaid wardley-beta as a secondary output format alongside existing OnlineWardleyMaps (OWM) syntax in Wardley map artifacts
  • Mermaid blocks appear in collapsible <details> elements below the primary OWM blocks
  • The wardley command generates enhanced Mermaid with sourcing decorators (build/buy/outsource/inertia) derived from build vs buy analysis
  • The wardley.value-chain command generates plain Mermaid (no decorators — build/buy analysis not yet performed)
  • Pipelines translated to Mermaid's named-child format
  • All 4 extension formats (Codex, OpenCode, Gemini, Copilot) propagated via converter

Files changed (9 source + extensions)

  • Templates (4): wardley-map-template.md + value-chain-template.md (plugin + CLI mirrors)
  • Commands (2): wardley.md + wardley.value-chain.md — Mermaid syntax reference, decorator mapping rules, example
  • Guides (2): wardley.md + wardley-value-chain.md — viewing guidance for both formats
  • References (1): mapping-examples.md — Mermaid examples with decorators

Context

Mermaid.js merged Wardley Map support (PR #7147) into develop. The wardley-beta syntax is nearly identical to OWM — same coordinate system, same concepts — but adds visual sourcing decorators and named pipelines. Once shipped in a stable Mermaid release, maps will render inline in GitHub, VS Code, and other Mermaid-enabled viewers.

Test plan

  • Run /arckit.wardley in a test repo — verify OWM block appears first, Mermaid <details> block appears below
  • Verify Mermaid block includes (build)/(buy) decorators matching the build vs buy analysis
  • Run /arckit.wardley.value-chain — verify Mermaid block has no decorators
  • Verify validate-wardley-math.mjs hook still validates OWM correctly (unchanged)
  • Verify doctrine/climate/gameplay commands are unaffected
  • Check extension propagation: grep wardley-beta arckit-gemini/commands/arckit/wardley.toml

🤖 Generated with Claude Code

tractorjuice and others added 14 commits March 16, 2026 20:49
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Address spec review feedback: fix function references to match actual
converter.py code, add worked example, clarify description sources,
document model rationale, expand testing plan.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Spec for adding Mermaid wardley-beta output alongside OnlineWardleyMaps
syntax in wardley and wardley.value-chain commands, using sourcing
decorators (build/buy/outsource/inertia) and named pipelines.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Fixes duplicate anchor/component declaration in Mermaid examples
(both spec and plan). 11 tasks covering templates, commands, guides,
reference examples, and converter propagation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…mand

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… command

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
… example

Benefits Eligibility Guidance was referenced in dependency arrows and as
a pipeline parent but never declared as a component with coordinates.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant