Concepts¶
Every idea in WUWEI earns its place by preventing a mistake or saving your attention. This map says what each one is, why it is there, and where it lives.
| Concept | Why it is there | Where it lives |
|---|---|---|
| Auditor, not a gate | Process the model cannot see the point of gets routed around; evidence cannot be | the whole design |
| Plan passes and checkpoints | Days change; a plan you can redo any time stays true | /wuwei-run, /wuwei-close, .wuwei/plan.json |
| WSJF and RICE ranking | The most valuable work first, with evidence for every score | wuwei plan add |
| The team and its charters | Independent roles catch what one agent misses | charters/, agents/ |
| Models and effort | Each seat runs on the model and effort its work needs, from one table you can override | charters/planner.md, the Agent call |
| The evidence contract | "Done" means something checkable, the same for every PR | wuwei status, wuwei evidence |
| Attested verdicts | A review counts only if a reviewer wrote it and nobody edited it | SubagentStop, the ledger |
| Breaking changes | Clients you break should hear it from you first, and you decide whether it ships | Announcement:, the breaking: question |
| The doors | Some mistakes cannot be taken back | PreToolUse, harness rules, the code host |
| Enforcement levels | Honesty about what is prevented and what is only detected | wuwei doctor |
| Reversibility and confidence | Ask only when a mistake would be costly and you are unsure | _common.md |
| Owner question classes | Your attention is the scarcest resource | the owner-question door |
| Exceptions that expire | Accepting a gap is a debt, not a pardon | rulings, follow-up items |
| ADRs from one-way answers | Why a hard decision was taken outlives the session | docs/adr/ in each repo |
| Hooks as the sensei | Guidance at the moment beats rules nobody reads | hooks/hooks.json |
| Harness permissions | One place for who may call which tool | .claude/settings.json |
| Andon | Stop one broken stream, not the whole team | wuwei andon |
| The learning loop | Mistakes become standards; useless rules go | steward, .wuwei/standards.md |
| Error budget | Autonomy is earned by results and lost by escapes | evidence tiers |
| Calibration and gate yield | Know which reviews pay and which reviewers are overconfident | the report |
| Skills and memory proposals | Stop re-learning the same repository facts | retro proposals |
| Report, telemetry, DORA | See what happened without asking | wuwei report |
| The ledger | A tamper-evident record of what was decided | .wuwei/ledger/ |
| Replay cases | The auditor itself is held to its past answers | tests/replay/ |
| Many repositories | One process, the shape of each repository | one workspace |
| Running on Codex | One process whichever agent does the work | wuwei init --codex, .codex/ |
| Cloud sessions | A fresh clone starts where the last session stopped | wuwei init --cloud, wuwei sync, the wuwei/state branch |
| Work in progress | Nothing waits on your nudge: PRs and replies keep moving | /wuwei-watch, wuwei owe |