Skip to content

docs: add two May 19 articles (Wardley Mermaid + leaf node problem)#500

Merged
tractorjuice merged 1 commit into
mainfrom
feat/articles-mermaid-and-leaf-node
May 19, 2026
Merged

docs: add two May 19 articles (Wardley Mermaid + leaf node problem)#500
tractorjuice merged 1 commit into
mainfrom
feat/articles-mermaid-and-leaf-node

Conversation

@tractorjuice
Copy link
Copy Markdown
Owner

Summary

  • Add 2026-05-19-wardley-maps-mermaid-github.md — argues that native Mermaid wardley-beta rendering in GitHub and Claude artifacts moves Wardley Maps from workshop-only artefacts into version-controlled markdown next to the code they describe.
  • Add 2026-05-19-leaf-node-problem.md — pattern note after Valentine et al. (2024) and Gonzalez's Organizing Intelligence (DeepMind, Idea 10): AI pilots deployed inside the team manager's value chain inherit the org chart's gravity and end up optimising local KPIs.
  • Surface both as the top two cards on docs/articles.html (Technical tag, 19 May 2026).
  • Each article ships with a Python hero-image generator and the rendered 1200x630 OG PNG. docs/articles/ is gitignored so the .md, .png and .py files are force-added — same pattern used for prior articles to avoid the live-site 404 issue from PRs fix(articles): add three articles linked but missing from repo #399 and fix(articles): add 2026-05-03 essay markdown + hero image (untracked) #404.
  • No change to article-viewer.html needed — it reads articles/<slug>.md and articles/<slug>-hero.png by slug.

Test plan

  • Visit arckit.org/articles.html after merge and confirm the two new cards render as the top two entries.
  • Visit arckit.org/article-viewer.html?a=2026-05-19-wardley-maps-mermaid-github and confirm the embedded \``mermaid wardley-beta```` block renders (depends on whatever markdown→HTML pipeline the viewer uses).
  • Visit arckit.org/article-viewer.html?a=2026-05-19-leaf-node-problem and confirm the embedded Wardley Map renders.

🤖 Generated with Claude Code

… node problem

Adds two new articles to docs/articles/ and surfaces them as the top two cards
on docs/articles.html.

* 2026-05-19-wardley-maps-mermaid-github.md — argues that native Mermaid
  wardley-beta rendering in GitHub and Claude artifacts shifts Wardley Maps
  from workshop-only artefacts to version-controlled markdown.
* 2026-05-19-leaf-node-problem.md — pattern note after Valentine et al. (2024)
  and Gonzalez's Organizing Intelligence (DeepMind, Idea 10) on why AI pilots
  deployed inside the team manager's value chain end up serving local KPIs.

Each article ships with a Python hero-image generator and the rendered PNG.
docs/articles/ is gitignored so the .md, .png and .py files are force-added.
The article-viewer reads by slug and needed no changes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@tractorjuice tractorjuice merged commit 5a100ea into main May 19, 2026
1 check passed
@tractorjuice tractorjuice deleted the feat/articles-mermaid-and-leaf-node branch May 19, 2026 11:44
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