Skip to content

docs: add ch-05 Fractal mental-model chapter (ZH + EN)#2

Merged
PanQiWei merged 8 commits intomainfrom
mental-models/ch-05
Apr 8, 2026
Merged

docs: add ch-05 Fractal mental-model chapter (ZH + EN)#2
PanQiWei merged 8 commits intomainfrom
mental-models/ch-05

Conversation

@PanQiWei
Copy link
Copy Markdown
Owner

@PanQiWei PanQiWei commented Apr 8, 2026

Summary

  • Ch-05 Fractal: 6 articles (ZH + EN, natively written) tracing self-similarity from Buddhist philosophy through mathematics to agentic engineering
  • Wiki knowledge base: 9 concept pages, 5 entity pages, 5 source pages for ch-05 references
  • 14 infographic cards: TL;DR visual for every article + chapter overview, independently designed per language
  • Housekeeping: stop tracking generated docs/zh/wiki/, decouple wiki skills from INTERNAL_REFERENCES.md, register ch-04/ch-05 in stale nav indexes, fix Chinese anchor in wiki page

Article arc

# Article Core idea
01 Sumeru in a Mustard Seed Structural echo between part and whole — Indra's Net to Mandelbrot
02 The Generator Simple rule + iteration = self-similar structure (math, biology, computation)
03 Worlds Within Worlds Each level is a complete world, not just a resemblance
04 From Transistor to Agent Engineering's self-similar evolution — same pattern reinvented at each abstraction
05 Where the Fractal Breaks Latency, cost, coordination, fault tolerance — runtime physics differs per level
06 The Dao of Fractals Cross-layer principle transfer, recursive base case, inter-layer decoupling

Test plan

  • ruff check — all checks passed
  • ruff format --check — 4 files already formatted
  • pytest -v -m "not requires_api_key" — 17 passed
  • build_docs — wiki + patterns sync OK
  • mkdocs build --strict -f mkdocs.en.yml — 0 warnings
  • mkdocs build --strict -f mkdocs.zh.yml — 0 warnings (anchor INFO fixed)

🤖 Generated with Claude Code

PanQiWei and others added 8 commits April 8, 2026 17:59
…eak point discussion

The text claimed "five pillars" but only listed four (memory, scheduling,
trust boundaries, cooperation protocols). Also added the missing discussion
paragraph for the "determinism" break point in both ZH and EN versions of
06-where-the-analogy-breaks.md, so all six table rows now have corresponding
explanations.

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

- ZH: remove AI triple-patterns, tighten wording, add first-person voice to tagline
- EN: sync tagline to first-person, add wiki Chinese-only note, emphasize mental models first
- Both: reading order now explicitly requires mental models as prerequisite

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs/zh/wiki/ is generated by build_docs.py (copy_wiki_docs) from
wikis/ — it should never be committed. Added to .gitignore and
removed 197 tracked files from the index.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
clip and ingest skills no longer read or write INTERNAL_REFERENCES.md;
source tracking is handled entirely within wikis/log.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
New concept pages: fractal-architecture, fractal-dimension,
near-decomposability, hierarchical-systems, coastline-paradox,
indra-net, statistical-self-similarity, sumeru-mustard-seed,
richardson-effect.

New entity pages: benoit-mandelbrot, lewis-fry-richardson,
herbert-simon, avatamsaka-sutra, cycle-js.

New source pages: simon-architecture-of-complexity,
fractal-architecture-cyclejs, coastline-paradox,
sumeru-mustard-seed-buddhist, fractal-buddhism-avatamsaka-sutra.

Updated: wikis/index.md, wikis/log.md, and minor edits to
existing concept pages (agent-skills, harness-engineering,
implicit-loop-architecture).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Six articles tracing self-similarity from Buddhist intuition through
mathematical principle to engineering lineage:

01 须弥芥子 — structural echo between part and whole
02 递归生成器 — three evidence lines converge (math, biology, computation)
03 世界中的世界 — each level is a complete world, not just a resemblance
04 从晶体管到 Agent — engineering's self-similar evolution
05 分形的边界 — latency, cost, coordination, fault tolerance
06 分形之道 — cross-layer transfer, base case, inter-layer decoupling

Each article includes a TL;DR infographic card (toggle view).
Chapter index includes an overview infographic.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
English versions natively written (not translated from Chinese).
Same six-article arc with independently designed infographic cards.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Both ZH and EN mental-models/index.md were stale (only ch-01~03).
Added ch-04 Operating System and ch-05 Fractal entries.
Added ch-05-fractal to .pages navigation for both languages.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@PanQiWei PanQiWei merged commit 666ab48 into main Apr 8, 2026
3 checks passed
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