@windyroad/wardley
Wardley Map generation for Claude Code. Analyses your codebase and generates a value chain evolution map. Maturity: Experimental.
Part of Windy Road Agent Plugins.
What It Does
A Wardley Map visualises your system's components along two axes: value chain (visibility to the user) and evolution (genesis to commodity). This plugin generates one from your source code.
It produces:
- OWM source file -- editable source in Online Wardley Maps format
- SVG and PNG -- rendered diagram images
- Markdown analysis -- written interpretation of the map's strategic implications
Install
npx @windyroad/wardleyRestart Claude Code after installing.
Usage
Generate or update the Wardley Map:
/wr-wardley:generateAnalyses your codebase to identify components, their relationships, and their evolutionary stage, then produces the map and analysis.
Jobs to be Done
This plugin serves the Jobs to be Done below. Per ADR-051, the persona-grouped JTBD anchor is the canonical source of truth for the README's value framing.
Tech lead / consultant
- JTBD-202 Run Pre-Flight Governance Checks Before Release or Handover — a fresh Wardley Map is a strategic-readiness signal attachable to a release note or handover doc; the analysis surfaces commodity-vs-genesis components and their evolutionary stage.
Plugin developer
- JTBD-101 Extend the Suite with New Plugins — generated Wardley Maps give contributors a value-chain mental model of the suite without reverse-engineering from source.
Plugin user
- JTBD-302 Trust That the README Describes the Plugin I Just Installed — this README is anchored on current JTBD job IDs; drift between prose and shipped behaviour is detectable at retro time per ADR-051.
Updating and Uninstalling
npx @windyroad/wardley --update
npx @windyroad/wardley --uninstall