feat: Wardley Mapping suite — 4 new commands, enriched references by tractorjuice · Pull Request #178 · tractorjuice/arc-kit

tractorjuice · 2026-03-16T12:03:15Z

Summary

Expands ArcKit's Wardley Mapping from a single /arckit.wardley command into a composable suite of 5 commands, backed by massively enriched reference files distilled from 3 Wardley Mapping books.

4 new commands: wardley.value-chain, wardley.doctrine, wardley.gameplay, wardley.climate
6 reference files enriched: doctrine (120→439 lines, 40+ principles), gameplays (171→588 lines, 60+ plays), climatic patterns (273→504 lines, 32 patterns), evolution stages, mapping examples, mathematical models
4 new document types: WVCH, WDOC, WGAM, WCLM — all in wardley-maps/ subdirectory
4 new templates with full Document Control standard
4 new usage guides + existing wardley guide updated with suite overview
Composable handoffs: every command works standalone, gets richer with siblings
All 5 AI platforms: converter output regenerated (320 files, 64 per target)
Command count: 60 → 64

New Commands

Command	Purpose	Doc Code
`/arckit.wardley.value-chain`	Decompose user needs into value chains (pre-step to mapping)	WVCH
`/arckit.wardley.doctrine`	Assess organizational doctrine maturity (4 phases, 6 categories, 40+ principles)	WDOC
`/arckit.wardley.gameplay`	Analyze strategic plays from 60+ patterns with D&D alignment classification	WGAM
`/arckit.wardley.climate`	Assess 32 climatic patterns across 6 categories with prediction horizons	WCLM

Workflow

wardley.value-chain → wardley → wardley.doctrine
                               → wardley.climate
                               → wardley.gameplay
                               → roadmap / strategy

Also Fixed

Converter regexes updated for dot-namespaced commands (3 regexes in rewrite_codex_skills())
Pre-existing wardley.md hook bug: python3 validate-wardley-math.py → node validate-wardley-math.mjs

Content Sources

Introduction to Wardley Mapping Doctrine (~283K)
Introduction to Wardley Mapping Gameplays (~484K)
Introduction to Wardley Mapping Climatic Patterns (~357K)
melodic-software/claude-code-plugins wardley-mapping skill (patterns validated)

Test plan

Run converter: python scripts/converter.py — verify 320 files, 64 per target
Verify dot-namespaced cross-references in Codex skills
Verify doc ID generation: bash scripts/bash/generate-document-id.sh 001 WGAM 1.0 --filename --next-num /tmp
Verify hook validates WVCH: node arckit-claude/hooks/validate-wardley-math.mjs
Test each new command in a test repo with the plugin enabled
Verify all 4 new templates in arckit-claude/templates/ and .arckit/templates/

🤖 Generated with Claude Code

Design for expanding ArcKit's Wardley Mapping from a single command into a composable suite of 5 commands with enriched reference files. Covers new commands (value-chain, doctrine, gameplay, climate), reference file expansion from 3 books, templates, doc types, handoffs, converter impact, and documentation updates. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

- Fix hook filename: validate-wardley-math.py -> .mjs - Fix reference file line counts (off by 1) - Add converter regex fix as critical required change - Add explicit SUBDIR_MAP entries to registration checklist - Add argument-hints and hooks spec for new commands - Add template naming convention note - Add re-assessment support for wardley.doctrine - Resolve all open questions into design decisions - Document dot-namespacing as first-of-kind pattern Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

- Narrow hook filter to WVCH only (matches Design Decision #2) - List all 3 broken regexes in rewrite_codex_skills() - Add hooks: frontmatter block for wardley.value-chain command - Note pre-existing wardley.md hook bug (python3 .py -> node .mjs) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

28 tasks across 6 chunks: infrastructure, reference files, templates, commands, converter verification, documentation. Follows spec at docs/superpowers/specs/2026-03-16-wardley-suite-enhancement-design.md. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

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

Rewrote doctrine.md from ~120 to 439 lines, adding: Strategy Cycle overview, canonical Phase/Category matrix (Figure 2), detailed descriptions for all 40+ principles organised by phase, six category implementation journeys, a full YAML assessment template covering all principles, and an evidence-gathering checklist. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…model

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

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

- Add handoffs to wardley.doctrine, wardley.gameplay, wardley.climate - Add WVCH to recommended prerequisites - Add WDOC, WCLM, WGAM to optional prerequisites Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

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

4 new commands (wardley.value-chain, wardley.doctrine, wardley.gameplay, wardley.climate) generated across all 5 AI targets (64 per target). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

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

- Add trigger phrases for value chain, doctrine, gameplay, climate - Update reference descriptions to reflect enriched content - List all 5 wardley suite commands in ArcKit Integration section Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add detailed table of success, capital, political, skills, supplier, and consumer inertia types with indicators and mitigation strategies. Closes gap vs melodic-software wardley-mapping skill. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

- Split Capital (physical assets) from Financial (risk aversion, sunk cost psychology, market pressures) as distinct inertia types - Add 8-item Inertia Diagnostic Checklist with severity scoring - Content distilled from 'Navigating Inertia' research book Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…des to docs - Auto-fix MD032/MD031/MD040 lint violations across all wardley files - Update command count from 60 to 64 in all source files, HTML pages, and extension READMEs - Add 4 wardley suite commands to commands.html table and dependency matrix - Add 5 wardley guides to guides.html in new Wardley Mapping category - Update guide count from 79 to 88 - Regenerate extension formats via converter Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

tractorjuice and others added 30 commits March 16, 2026 11:09

feat: register WDOC, WGAM, WCLM, WVCH document types

d910f81

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

feat: add WGAM, WCLM, WVCH to multi-instance types

f3eae4a

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

feat: extend wardley math hook to validate WVCH documents

f94f456

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

fix: correct wardley.md hook from python3 .py to node .mjs

7622498

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

fix: update converter regexes to handle dot-namespaced commands

0de1e7f

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

feat: enhance evolution stages with transition heuristics and talent …

288b23a

…model

feat: add TechnoGadget, value chain, and case study examples

2999041

feat: add play-position scoring and climate impact weighting

b6aeec2

feat: expand climatic patterns to 32 patterns across 6 categories

aa001d3

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

feat: expand gameplay patterns to 60+ plays across 11 categories

70e6aec

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

feat: add wardley value chain template

70b18d5

feat: add wardley doctrine assessment template

16d4e49

feat: add wardley gameplay analysis template

45476e8

feat: add wardley climate assessment template

e580e8d

feat: add wardley.value-chain command for value chain decomposition

60ceb50

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

feat: add wardley.doctrine command for doctrine maturity assessment

cb6cbb8

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

feat: add wardley.gameplay command for strategic play analysis

9eea4f9

feat: add wardley.climate command for climatic pattern assessment

2e63340

chore: regenerate extension formats with wardley suite commands

6e5208b

4 new commands (wardley.value-chain, wardley.doctrine, wardley.gameplay, wardley.climate) generated across all 5 AI targets (64 per target). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

docs: add guides for wardley suite commands

9af7320

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

docs: add wardley suite commands to README

fbac441

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

docs: add wardley suite commands to GitHub Pages index

72fae9e

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

docs: add wardley suite to dependency matrix

cf8532b

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

docs: add wardley suite workflow diagram

58069c8

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

tractorjuice and others added 7 commits March 16, 2026 11:59

docs: add wardley suite to documentation index

8acdb75

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

docs: update changelogs with wardley suite additions

f8728f6

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

chore: add research/ to gitignore

0bca124

tractorjuice merged commit 9598586 into main Mar 16, 2026
1 check passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Wardley Mapping suite — 4 new commands, enriched references#178

feat: Wardley Mapping suite — 4 new commands, enriched references#178
tractorjuice merged 37 commits intomainfrom
feat/wardley-suite-enhancement

tractorjuice commented Mar 16, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

tractorjuice commented Mar 16, 2026

Summary

New Commands

Workflow

Also Fixed

Content Sources

Test plan

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant