deepwiki-diagrams

DeepWiki Diagrams — Extracted Source

Extracted: 2026-04-20 from https://deepwiki.com/tractorjuice/arc-kit/2-system-architecture (all pages rendered server-side into one HTML bundle, so a single fetch returns every diagram in the wiki).

Extraction method: curl -sL <page> > /tmp/dw.html, then regex r'```mermaid\\n(.*?)```' with unicode_escape decoding.

Contents

• all/ — 826 unique Mermaid diagrams, deduplicated by normalised content. Filenames are the first 8 chars of MD5(normalised).
• candidates/ — 8 curated candidates selected for possible inclusion in docs/book/ARCKIT-BOOK.md.

Staleness warnings

These diagrams were generated by an LLM from the repo state at some earlier date. Known staleness in the extracted set:

• arckit-plugin/ — 94 diagrams reference this old path. Current path is arckit-claude/.
• VERSION (3.1.2) — appears in ~100 diagrams. Current plugin version is 4.7.1.
• .arckit/memory/architecture-principles.md — old path. Current is projects/000-global/ARC-000-PRIN-v*.md.
• Orange Book '4Ts' — any risk diagram citing '4Ts' is wrong; current is 6 treatment options.
• Five Case model labels — verify vocabulary (BAU / Do Minimum / Preferred Way Forward).
• Command counts — any "54 commands" / "57 commands" label is stale; current baseline is 68.

Every candidate must be audited against current code before being embedded in the book.

Curated candidates (with proposed book chapter)

Expanded from 8 to 20 after a second pass over the 826 diagrams looking in the less obvious topic buckets (analyze, service-assessment, release pipeline, document-type registry, stakeholder tiers).

Part I / Part II (governance lifecycle)

File	Topic	Target chapter	Notes
02e59a4b.mmd	Full command ecosystem grouped by phase (Foundation / Discovery / Design / Ops)	Ch 3 The ArcKit Workflow	Complements the existing tier matrix; higher-level phase view.
673bb1ca.mmd	Stakeholder-centred traceability tiers	Ch 4 Foundation	Shows STKE feeding into every downstream tier with (M / R / O) dependency strength.
a8f9c440.mmd	Strategy command decision flow (Wardley? → Tech Radar or Themes)	Ch 6 Strategy and Wardley	Good companion to the fuller stage model in 69a48b55; smaller and more readable.
69a48b55.mmd	Strategy command stage model (Discovery → Loading → Semantics)	Ch 6 Strategy and Wardley	Most detailed; uses old .arckit/memory/ paths — needs rewriting.
97e6b08b.mmd	Roadmap command end-to-end flow with hooks	Ch 6 Strategy and Wardley	Generalisable to show any command's full lifecycle (hooks + artifacts + output).
d4b45c62.mmd	Cloud research agents (Task tool + 3 agents + 3 MCP servers)	Ch 7 Market Research	Already structurally correct; just update arckit-plugin/ → arckit-claude/.
4925347e.mmd	Knowledge compounding: two projects reusing vendor research	Ch 7 Market Research	Concrete example of the cross-project pattern.
8873066a.mmd	Vendor evaluation framework (requirements + SOW → weighted matrix)	Ch 8 Procurement	Covers evaluate; pairs well with the book's existing score-command section.
aeae2806.mmd	Design review phase model (Arch → Design → Ops)	Ch 9 Design Reviews	Book currently has no diagram for Ch 9.
3c6d2d89.mmd	UK Gov compliance framework gates (Service Standard, TCoP, NCSC, AI)	Ch 11 Compliance and QA	Excellent overview; verify all frameworks still apply.
0e0070a8.mmd	Health command 7-rule detection flow	Ch 11 Compliance and QA	Matches the 7 rules book documents; minor audit needed.
75693de3.mmd	Analyze command: hook data tables → findings	Ch 11 Compliance and QA	Shows how hooks feed analyze via pre-computed tables.
07f21ada.mmd	Analyze severity rules (CRITICAL / HIGH / MEDIUM, 30+ rules)	Ch 11 Compliance and QA	Very large (136 lines); may need trimming for print.
bd3d21ea.mmd	Service Standard assessment evidence scan	Ch 11 Compliance and QA	Phase-by-phase evidence gathering.
6864cc2c.mmd	NCSC CAF 14 principles hierarchy	Ch 11 Compliance and QA	Clean reference for the secure command output.
9a4f4e4e.mmd	Traceability DAG (Foundation → Research → Design → Delivery)	Ch 11 Compliance and QA	Strong candidate; no current equivalent in book.

Part III (internals)

File	Topic	Target chapter	Notes
7402310c.mmd	Document Type Registry architecture (49 types, single/multi-instance routing)	Ch 16 Templates and Documents	Verify type count is current (49 → 62 if book claims 62 templates).
4787aedc.mmd	Project directory → pages manifest shape	Ch 16 Templates and Documents	Shows how artifacts aggregate into docs/manifest.json.
6ab4b3ba.mmd	Converter pipeline (input → AGENT_CONFIG → outputs)	Ch 17 Multi-AI Distribution	Uses old arckit-plugin/ paths; verify output list matches current 7 formats (Paperclip missing).

Part IV (operations)

File	Topic	Target chapter	Notes
68d7591d.mmd	Release pipeline sequence diagram (Dev → CHANGELOG → bump → converter → GitHub → PyPI)	Ch 19 Development and Operations	Sequence diagram rather than flowchart — adds variety. Update file counts (11 → 15) and paths.

Audit status (2026-04-20)

Trimmed 4 Ch 11 candidates (overload): 07f21ada, 75693de3, bd3d21ea, 6864cc2c. All four were topically interesting but the book's textual tables already cover the same ground.

Added 2 hook-system candidates: 50cd4fe3 (full lifecycle sequence), e3314b7d (filename validator deep dive).

Current set: 18 candidates.

File	Target chapter	Audit status
02e59a4b.mmd	Ch 3 Workflow	Bulk fixes applied; no obvious staleness
673bb1ca.mmd	Ch 4 Foundation	Bulk fixes applied; no obvious staleness
a8f9c440.mmd	Ch 6 Strategy/Wardley	Encoding fixed
69a48b55.mmd	Ch 11 Compliance/QA (re-targeted from Ch 6 — this is /arckit.analyze, not strategy)	Re-labelled. Paths updated from retired .arckit/memory/ to current projects/{pid}/ARC-{PID}-... layout
97e6b08b.mmd	Ch 6 Strategy/Wardley	Bulk fixes applied (arckit-plugin → arckit-claude)
d4b45c62.mmd	Ch 7 Market Research	Bulk fixes applied
4925347e.mmd	Ch 7 Market Research	Bulk fixes applied
8873066a.mmd	Ch 8 Procurement	No staleness
aeae2806.mmd	Ch 9 Design Reviews	No staleness
3c6d2d89.mmd	Ch 11 Compliance/QA	Bulk fixes applied
0e0070a8.mmd	Ch 11 Compliance/QA	No staleness
9a4f4e4e.mmd	Ch 11 Compliance/QA	No staleness
7402310c.mmd	Ch 16 Templates	Deep audit: type count 49 → 73 (current DOC_TYPES entries)
4787aedc.mmd	Ch 16 Templates	Encoding fixed
6ab4b3ba.mmd	Ch 17 Multi-AI	Deep audit: expanded from 3 outputs to 5 (adds Codex Skills, Copilot). Added frontmatter-stripping step.
68d7591d.mmd	Ch 19 Dev/Ops	Bulk fixes applied. Version file count (11 → 15) covered indirectly by participant names; book intro should state 15 explicitly.
50cd4fe3.mmd	Ch 14 Hook System	Fully rewritten against hooks.json. Multiple handlers per event, added StopFailure, update-manifest, per-command prompt hooks. Removed Wardley-specific Stop block (declared in command frontmatter but not wired in hooks.json).
e3314b7d.mmd	Ch 14 Hook System	Fully rewritten. Annotated as PreToolUse entry point with if: Write(/projects/**) matcher.

Fix patterns applied across the set

• Path rewrites: arckit-plugin/ → arckit-claude/ (5 files touched)
• Version bumps: VERSION (3.1.2) → (4.7.2) (book current)
• Encoding corruption: UTF-8 mangled arrows (â variants) restored to →, ←, —, ✓, £, ¢. 3 files touched.
• Retired paths: .arckit/memory/architecture-principles.md → projects/000-global/ARC-000-PRIN-v*.md etc. (1 file touched)
• Outdated counts: DOC_TYPES 49 → 73, converter outputs 3 → 5.

Workflow for integrating a candidate into the book

1. Audit — done.
2. Render with Mermaid to verify syntax: paste into a scratch .md file and open the Markdown preview, or run mmdc -i candidates/<hash>.mmd -o /tmp/<hash>.svg if @mermaid-js/mermaid-cli is installed.
3. Place under the target chapter heading with:
   • A one-sentence caption above (*Figure N: …*).
   • A one-sentence explanatory lead-in that says what the reader should look for.
4. Update the book's Table of Contents / figure list if there is one.
5. Add a page_notes entry in .devin/wiki.json for the matching page, pointing DeepWiki at the same Mermaid source so the wiki and the book stay in sync.