docs: rename the five legs to Shape/Build/Watch/Check/Learn#269
Merged
Conversation
tieubao
force-pushed
the
docs/rename-five-legs
branch
2 times, most recently
from
July 18, 2026 12:50
603c311 to
d548105
Compare
Applies the plain-words rule (CONTRIBUTING.md, docs/research/2026-07-16-plain-words-inventory.md) to ADR-0034's loop taxonomy: Specify/Execute/Observe/Govern -> Shape/Build/Watch/Check (Learn kept), and the container word leg -> stage. Amends ADR-0034 per its own lock (a new "## Amendment" section, decision 3's as-decided historical table left unrewritten). Sweeps the machine registry (lib/config/module-registry.md, old names parenthetical for one release), README's "The five stages" section and mermaid diagram, docs/architecture.md, docs/data-flow.md's prose and ascii diagrams, docs/MANUAL.md's command index, docs/kit-contract.md, commands/onboard.md's welcome tour, and the per-module docs that reference the loop (lib/sync, lib/learn, lib/gate, lib/cosmetic, lib/session/audit). Updates the registry-lint assertions in tests/test-meta.sh and tests/test-config-registry.sh to the new section headers. Leaves historical records (CHANGELOG, shipped specs, archived implementation notes/proof docs) and the unrelated "leg" senses in board-mirror/board-writeback/significance-classify untouched.
Repairs the feedback-loop.md ascii diagram's left/right rails (a floating disconnected column, a one-char right-rail kink), rewords the ADR-0034 amendment's alias sentence to stop overclaiming parenthetical aliases in files that are actually a clean cutover, and updates CHANGELOG.md's live Unreleased section (a stale leg-vocabulary mention, plus a new entry documenting the ID-292 rename).
tieubao
force-pushed
the
docs/rename-five-legs
branch
from
July 18, 2026 13:49
d548105 to
7d3c385
Compare
3 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/research/2026-07-16-plain-words-inventory.md):Specify -> Shape,Execute -> Build,Observe -> Watch,Govern -> Check(Learnkept), and the container wordleg -> stage.docs/decisions/0034-harness-loop-taxonomy.mdper the ADR's own lock (a new## Amendmentsection; decision 3's as-decided historical table is left unrewritten, matching the0029amendment precedent).lib/config/module-registry.md(old names parenthetical for one release),README.md("The five stages" section + mermaid diagram),docs/architecture.md,docs/data-flow.md(prose + two ascii diagrams),docs/MANUAL.md(command index),docs/kit-contract.md,commands/onboard.md(welcome tour),CONTRIBUTING.md(precedent list), and the per-module docs that reference the loop directly (lib/sync,lib/learn,lib/gate,lib/cosmetic,lib/session/audit).tests/test-meta.shandtests/test-config-registry.shto the new section headers.lib/board/board-mirror.sh/board-writeback.sh/significance-classify.share untouched.Backlog:
_meta/BACKLOG.mdID-292.Test plan
bash tests/test-meta.sh-- 698/698bash tests/test-config-registry.sh-- 19/19bash tests/test-hooks.sh-- 480/480bash tests/test-kit-contract.sh-- 25/25kit:advisor(fable) critique dispatched on the diffdocs/verification/rename-five-legs.md