geneseed 3.4.0 → 3.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (166) hide show
  1. package/CHANGELOG.md +316 -0
  2. package/DESIGN.md +11 -14
  3. package/QUICKSTART.md +3 -1
  4. package/README.md +51 -42
  5. package/SETUP.md +25 -27
  6. package/SHIPPED.md +26 -32
  7. package/adapters/bob/README.md +12 -9
  8. package/adapters/copilot/README.md +26 -25
  9. package/adapters/opencode/GLOBAL-HARNESS-SPEC.md +1 -1
  10. package/adapters/opencode/README.md +2 -2
  11. package/adapters/opencode/plugins/geneseed-context.js +5 -3
  12. package/adapters/opencode/plugins/geneseed-workflow.js +30 -3
  13. package/adapters/opencode/workflows/_runtime.js +97 -7
  14. package/bin/build-driver.mjs +5 -1248
  15. package/bin/geneseed-cli.mjs +11 -6
  16. package/bin/geneseed-hook.mjs +4 -2
  17. package/docs/candidate-hosts.md +1 -1
  18. package/docs/design-history.md +37 -37
  19. package/docs/extending.md +49 -24
  20. package/docs/token-footprint.md +52 -26
  21. package/docs/web/claude-hooks.md +3 -2
  22. package/docs/web/collaboration.md +2 -2
  23. package/docs/web/first-session.md +1 -1
  24. package/docs/web/footprint.md +2 -2
  25. package/docs/web/harnesses.md +1 -1
  26. package/docs/web/model.md +1 -1
  27. package/docs/web/plugin-workflow.md +1 -0
  28. package/docs/web/rules.md +3 -3
  29. package/docs/web/setup-choices.md +2 -2
  30. package/docs/web/themes-author.md +1 -1
  31. package/docs/web-ui.md +18 -10
  32. package/harness.config.json +1 -1
  33. package/js/README.md +6 -5
  34. package/js/build/driver.mjs +1191 -0
  35. package/js/build/emit-claude.mjs +17 -10
  36. package/js/build/emit-common.mjs +4 -4
  37. package/js/build/generate.mjs +1 -1
  38. package/js/build/render.mjs +48 -44
  39. package/js/build/stubs.mjs +1 -1
  40. package/js/build/themes.mjs +4 -4
  41. package/js/build/version.mjs +12 -0
  42. package/js/cli-table.json +21 -6
  43. package/js/hosts/hooks.mjs +89 -74
  44. package/js/hosts/hosts.mjs +19 -2
  45. package/js/hosts/mcp.mjs +14 -20
  46. package/js/hosts/native.mjs +23 -17
  47. package/js/hosts/settings.mjs +52 -104
  48. package/js/inspect/checks-authoring.mjs +117 -3
  49. package/js/inspect/diff.mjs +1 -1
  50. package/js/inspect/doctor.mjs +1 -1
  51. package/js/inspect/excludes.mjs +1 -1
  52. package/js/inspect/scan.mjs +3 -14
  53. package/js/inspect/status.mjs +2 -2
  54. package/js/inspect/validate.mjs +1 -1
  55. package/js/lib/fs.mjs +23 -8
  56. package/js/lib/json.mjs +7 -1
  57. package/js/lib/proc.mjs +6 -4
  58. package/js/maintain/migrate.mjs +1 -1
  59. package/js/maintain/setup.mjs +1 -1
  60. package/js/maintain/uninstall.mjs +17 -15
  61. package/js/ui/cli.mjs +19 -0
  62. package/js/ui/menu.mjs +1 -1
  63. package/js/web/actions.mjs +4 -4
  64. package/js/web/activity.mjs +4 -4
  65. package/js/web/api.mjs +14 -11
  66. package/js/web/daemon.mjs +1 -1
  67. package/js/web/docs.mjs +12 -12
  68. package/js/web/handler.mjs +12 -5
  69. package/js/web/jobs.mjs +1 -1
  70. package/package.json +1 -1
  71. package/src/AGENT.md.tmpl +74 -38
  72. package/src/agents/developer.md +2 -2
  73. package/src/agents/reviewer.md +5 -2
  74. package/src/doctrines/README.md +26 -3
  75. package/src/doctrines/craft.md +78 -5
  76. package/src/doctrines/ops.md +62 -0
  77. package/src/doctrines/process.md +91 -4
  78. package/src/doctrines/rigor.md +40 -0
  79. package/src/laws/universal.md +27 -21
  80. package/src/memory/README.md +4 -2
  81. package/src/modes/foreman.md +5 -5
  82. package/src/notebook/README.md +2 -1
  83. package/src/ontology/universal.md +71 -67
  84. package/src/postures/peer.md +3 -0
  85. package/src/skills/bruno-collection-generator.md +1 -1
  86. package/src/skills/bruno-test-writer.md +2 -2
  87. package/src/skills/daydream/LICENSE +21 -0
  88. package/src/skills/daydream/VENDOR.md +3 -1
  89. package/src/skills/debug.md +1 -1
  90. package/src/skills/document-project.md +127 -25
  91. package/src/skills/geneseed-code-review.md +6 -2
  92. package/src/skills/parallel-agents.md +3 -3
  93. package/src/skills/pipeline.md +4 -4
  94. package/src/skills/react-view-transitions/VENDOR.md +7 -1
  95. package/src/skills/workflow.md +12 -4
  96. package/themes/_TEMPLATE.json +7 -5
  97. package/themes/biker.json +6 -4
  98. package/themes/commentator.json +6 -4
  99. package/themes/cyberpunk.json +6 -4
  100. package/themes/gamer.json +6 -4
  101. package/themes/imperial.json +6 -4
  102. package/themes/joker.json +6 -4
  103. package/themes/marvin.json +6 -4
  104. package/themes/mean.json +6 -4
  105. package/themes/military.json +6 -4
  106. package/themes/neutral.json +7 -5
  107. package/themes/opencode/README.md +2 -2
  108. package/themes/pirate.json +6 -4
  109. package/themes/sports.json +6 -4
  110. package/themes/verstappen.json +6 -4
  111. package/themes/wizard.json +6 -4
  112. package/web/dist/assets/Activity-Flgf4kHy.js +1 -0
  113. package/web/dist/assets/ActivityDetail-DIpr85nh.js +1 -0
  114. package/web/dist/assets/CatalogRow-CjyLjaLb.js +1 -0
  115. package/web/dist/assets/Diff-Deisdha8.js +2 -0
  116. package/web/dist/assets/Docs-DGUdY4l4.js +2 -0
  117. package/web/dist/assets/Doctor-F74lJ69P.js +1 -0
  118. package/web/dist/assets/FilterInput-BakJLvaV.js +1 -0
  119. package/web/dist/assets/GreenhouseView-D072lBiD.js +2 -0
  120. package/web/dist/assets/Harness-DNRP2Va7.js +1 -0
  121. package/web/dist/assets/JournalView-DWFqZ0Iw.js +1 -0
  122. package/web/dist/assets/Laws-BN6g3HU7.js +3 -0
  123. package/web/dist/assets/Library-CDOv4emM.js +1 -0
  124. package/web/dist/assets/Markdown-BQAvN8xx.js +38 -0
  125. package/web/dist/assets/OperatorHudView-CwNIUVX8.js +2 -0
  126. package/web/dist/assets/Profile-CpP9BTne.js +1 -0
  127. package/web/dist/assets/Rules-DFXsUCB7.js +1 -0
  128. package/web/dist/assets/Settings-BqZVUtJ5.js +1 -0
  129. package/web/dist/assets/Skills-Cu6kBgfF.js +1 -0
  130. package/web/dist/assets/StatusBadge-Cg6j-NJL.js +1 -0
  131. package/web/dist/assets/activity-iWaWVtsR.js +1 -0
  132. package/web/dist/assets/drawable-BgfrEBer.js +1 -0
  133. package/web/dist/assets/index-CAqrWhKl.js +2 -0
  134. package/web/dist/assets/index-Ruh93A3A.css +1 -0
  135. package/web/dist/assets/jobBuckets-Dbq8ZlWW.js +1 -0
  136. package/web/dist/assets/lawCats-BLgxl151.js +1 -0
  137. package/web/dist/assets/react-DbkvxWG5.js +8 -0
  138. package/web/dist/assets/rolldown-runtime-CbXtAM7H.js +1 -0
  139. package/web/dist/index.html +4 -3
  140. package/web/src/pages/Laws.jsx +22 -8
  141. package/src/skills/react-view-transitions/README.md +0 -42
  142. package/web/dist/assets/Activity-DMGhhjQc.js +0 -1
  143. package/web/dist/assets/ActivityDetail-CeQcDA7e.js +0 -1
  144. package/web/dist/assets/CatalogRow-CnSbDPyg.js +0 -1
  145. package/web/dist/assets/Diff-D_ksMBD1.js +0 -5
  146. package/web/dist/assets/Doctor-Brb3_oCT.js +0 -1
  147. package/web/dist/assets/FilterInput-DbRWPhtT.js +0 -1
  148. package/web/dist/assets/GreenhouseView-F3VNFr73.js +0 -2
  149. package/web/dist/assets/Harness-DJSwfYeF.js +0 -1
  150. package/web/dist/assets/JournalView-BLRYRnB3.js +0 -1
  151. package/web/dist/assets/Laws-CKYns9qe.js +0 -3
  152. package/web/dist/assets/Library-BK0YloSv.js +0 -1
  153. package/web/dist/assets/Markdown-BzTRzc7a.js +0 -46
  154. package/web/dist/assets/OperatorHudView-D3OQSGp5.js +0 -2
  155. package/web/dist/assets/Profile-CPA2u_0g.js +0 -1
  156. package/web/dist/assets/Rules-Lukel-Ru.js +0 -1
  157. package/web/dist/assets/Skills-BKRLHH7m.js +0 -1
  158. package/web/dist/assets/StatusBadge-DI3weRKd.js +0 -1
  159. package/web/dist/assets/activity-C_H2Bx1P.js +0 -1
  160. package/web/dist/assets/index-B7_Wga23.js +0 -2
  161. package/web/dist/assets/index-DzdQjvM1.css +0 -1
  162. package/web/dist/assets/index-N8dTrVro.js +0 -1
  163. package/web/dist/assets/index-Py_IQjgK.js +0 -10
  164. package/web/dist/assets/jobBuckets-DfTUJUxR.js +0 -1
  165. package/web/dist/assets/lawCats-DUS9UTH4.js +0 -1
  166. package/web/dist/assets/react-DOpiTn5v.js +0 -32
@@ -24,6 +24,7 @@ work is worth a crew: a one-file tweak or a question never is.
24
24
  | OpenCode | `workflow` (the `geneseed-workflow` plugin) | **saved only** — `<name>.js` in `.opencode/workflows/` per repo or `<config>/workflows/` global (`GENESEED_WORKFLOWS_DIR` overrides); nothing inline is eval'd | none — call it when the shape fits |
25
25
  | Claude Code | `Workflow` (native) | a saved `.claude/workflows/<name>` by `name`, **or** an inline `script` you author | **required** — the tool refuses unless the user opted in for this task ("use a workflow", "ultracode", a skill that says so) |
26
26
  | Bob, Copilot | none | — | fall back to [parallel-agents](parallel-agents.md) / [council](council.md) |
27
+ | any, under Orca | Orca orchestration (`orca skills get orchestration`) | tasks, not scripts — each task spec names its target, change, ownership and acceptance | the user asked to supervise or coordinate workers |
27
28
 
28
29
  Both runtimes speak the same primitives — `agent()`, `parallel()`, `pipeline()`,
29
30
  `phase()`, `args` — and every script opens with a literal `export const meta = { name,
@@ -58,20 +59,27 @@ carries the script API — load it before writing one).
58
59
  before; an inline one has not. Author inline only when no saved shape fits, keep it
59
60
  to the primitives, and hold to the host's size guideline unless the user asked for
60
61
  more.
61
- 4. **Pass the task as `args`, never baked in** — target paths, the motion, the question,
62
+ 4. **Give every editing agent a write set, and isolate parallel editors** ({{DOCTRINE}}
63
+ process 8). Name in each editing `agent()` prompt the files it may change and have it
64
+ return the files it did change; overlapping sets run in sequence, not in one
65
+ `parallel()`. Pass `isolation: 'worktree'` to each agent that edits in parallel — both
66
+ runtimes take it; read-only agents need none. After the fan-out, compare the changed
67
+ files in plain script code (OpenCode hands them to you as `overlaps()`) — a file two
68
+ agents touched goes to one merge agent, never to whoever wrote last.
69
+ 5. **Pass the task as `args`, never baked in** — target paths, the motion, the question,
62
70
  any timestamp. Scripts stay deterministic: no wall clock, no randomness, nothing
63
71
  read from the environment that the next run would see differently, so a run is a
64
72
  pure function of (script, args, child replies) and can be replayed.
65
- 5. **Run it and wait for the result, not the transcript.** The run is asynchronous on
73
+ 6. **Run it and wait for the result, not the transcript.** The run is asynchronous on
66
74
  Claude Code (a task notification arrives; `/workflows` watches it live) and
67
75
  synchronous on OpenCode. Read the returned summary; the full structured result and
68
76
  the phase-by-phase trace are in the run's progress file — point the user there for
69
77
  detail, do not paste it. Never fabricate a result for a run that has not returned.
70
- 6. **On failure, resume — don't rerun.** A script that died mid-way keeps its completed
78
+ 7. **On failure, resume — don't rerun.** A script that died mid-way keeps its completed
71
79
  `agent()` results; fix the script or the args and resume from the run id where the
72
80
  host supports it, so finished stages are not paid twice. A stage that keeps failing
73
81
  is a finding about the task, not a reason to loop.
74
- 7. **Exit — carry the conclusion yourself.** The workflow gathers and verifies;
82
+ 8. **Exit — carry the conclusion yourself.** The workflow gathers and verifies;
75
83
  committing, pushing, merging, or opening anything outward stays with you
76
84
  ({{DOCTRINE}} process 5, {{LAW}} IV). State what the run concluded, what you are
77
85
  doing with it, and where the trace lives.
@@ -7,7 +7,6 @@
7
7
  "EPI_LAWS": "<epigraph above the Laws section, themed>",
8
8
  "EPI_DOCTRINES": "<epigraph above the Doctrines section, themed>",
9
9
  "PACT": "<noun for the mutual user–agent contract, e.g. Pact>",
10
- "EPI_PACT": "<epigraph above the Pact section, themed>",
11
10
  "EPI_AGENTS": "<epigraph above the Agents section, themed>",
12
11
  "EPI_SKILLS": "<epigraph above the Skills section, themed>",
13
12
  "EPI_MEMORY": "<epigraph above the Memory section, themed>",
@@ -39,7 +38,7 @@
39
38
  "DESC_GIT_ARCHAEOLOGY": "<one-line description: investigate history — bisect, blame, pickaxe, read-only>",
40
39
  "DESC_GIT_RESCUE": "<one-line description: recover a broken repo / rewrite history safely behind a backup>",
41
40
  "DESC_REPO_MAP": "<one-line description: create/maintain a one-read repo orientation map>",
42
- "DESC_DOCUMENT_PROJECT": "<one-line description: reconcile the project's docs with the code; regenerate an offline HTML overview>",
41
+ "DESC_DOCUMENT_PROJECT": "<one-line description: write the doc set (PRD, design system, architecture, AGENTS.md) from the code; reconcile docs; regenerate the offline HTML>",
43
42
  "DESC_COMMIT": "<one-line description: stage the right paths and write a focused commit>",
44
43
  "DESC_CODE_REVIEW": "<one-line description: review a diff/PR — correctness first, quality second>",
45
44
  "DESC_BRAINSTORM": "<one-line description: turn a raw idea into an approved design before code>",
@@ -84,9 +83,9 @@
84
83
  "LEX_VI": "<themed title for Law VI (Data, Not Orders)>",
85
84
  "LEX_VII": "<themed title for Law VII (Least Privilege)>",
86
85
  "LEX_VIII": "<themed title for Law VIII (Cure the Cause)>",
87
- "LEX_IX": "<themed title for Law IX (External Gate)>",
86
+ "LEX_IX": "<themed title for the retired Law IX (External Gate), ending in (retired)>",
88
87
  "LEX_X": "<themed title for Law X (Echo the Intent)>",
89
- "LEX_XI": "<themed title for Law XI (Absence Is a Claim)>",
88
+ "LEX_XI": "<themed title for the retired Law XI (Absence Is a Claim), ending in (retired)>",
90
89
  "PACK_CRAFT": "<display name of the craft doctrine pack — how code is written>",
91
90
  "PACK_RIGOR": "<display name of the rigor doctrine pack — how work is proven>",
92
91
  "PACK_OPS": "<display name of the ops doctrine pack — how the machine is driven>",
@@ -97,6 +96,7 @@
97
96
  "DOC_CRAFT_4": "<themed title for craft doctrine 4 (Search Before Creating)>",
98
97
  "DOC_CRAFT_5": "<themed title for craft doctrine 5 (Respect Conventions)>",
99
98
  "DOC_CRAFT_6": "<themed title for craft doctrine 6 (Smallest Viable Diff)>",
99
+ "DOC_CRAFT_7": "<themed title for craft doctrine 7 (One Writer Per Value)>",
100
100
  "DOC_RIGOR_1": "<themed title for rigor doctrine 1 (Idempotent by Default)>",
101
101
  "DOC_RIGOR_2": "<themed title for rigor doctrine 2 (Honest Tests)>",
102
102
  "DOC_RIGOR_3": "<themed title for rigor doctrine 3 (Cover and Verify)>",
@@ -108,6 +108,7 @@
108
108
  "DOC_OPS_4": "<themed title for ops doctrine 4 (Complete the Teardown)>",
109
109
  "DOC_OPS_5": "<themed title for ops doctrine 5 (Record the Probe, Not the Snapshot)>",
110
110
  "DOC_OPS_6": "<themed title for ops doctrine 6 (Restart Is Not Reload)>",
111
+ "DOC_OPS_7": "<themed title for ops doctrine 7 (Serialize Against a Rationed Resource)>",
111
112
  "DOC_PROCESS_1": "<themed title for process doctrine 1 (Persist Insight)>",
112
113
  "DOC_PROCESS_2": "<themed title for process doctrine 2 (Plan Before Acting)>",
113
114
  "DOC_PROCESS_3": "<themed title for process doctrine 3 (Context Economy)>",
@@ -115,13 +116,14 @@
115
116
  "DOC_PROCESS_5": "<themed title for process doctrine 5 (Consent Before Push)>",
116
117
  "DOC_PROCESS_6": "<themed title for process doctrine 6 (Bound the Loop)>",
117
118
  "DOC_PROCESS_7": "<themed title for process doctrine 7 (Codes That Persist)>",
119
+ "DOC_PROCESS_8": "<themed title for process doctrine 8 (One Writer Per File)>",
118
120
  "INTRO_DOC": "<themed intro: this file is the entry point an AI agent reads in this repo>",
119
121
  "INTRO_AGENTS": "<themed intro to the Agents section — delegate focused work to a specialist>",
120
122
  "INTRO_SKILLS": "<themed intro to the Skills section — run the written procedure before improvising>",
121
123
  "INTRO_WORKSPACE": "<themed intro to the Workspace section — the install dir is shared>",
122
124
  "INTRO_SCRIPTS": "<themed intro to the Scripts section — everything above works on self-discipline alone>",
123
125
  "BANNER": "<multi-line ASCII banner shown at the top of AGENT.md; use \\n for line breaks>",
124
- "ONTOLOGY": "<noun for the always-on worldview tier, e.g. Ontology — a bare noun with no leading article, since it is read inline mid-sentence>",
126
+ "ONTOLOGY": "<noun for the always-on worldview tier, e.g. Ethos — a bare noun with no leading article, since it is read inline mid-sentence>",
125
127
  "LAW": "<singular noun for a rule in this theme, e.g. Rule / Dictate / Law>",
126
128
  "LAWS": "<plural of LAW>",
127
129
  "DOCTRINE": "<SINGLE-WORD singular noun for one optional doctrine rule, e.g. Doctrine — a space in this value breaks the heading parser silently>",
package/themes/biker.json CHANGED
@@ -7,7 +7,6 @@
7
7
  "EPI_LAWS": "The code of the road. Every rider keeps it, every mile, every run.",
8
8
  "EPI_DOCTRINES": "Chapter bylaws. Run what this ride needs — the code holds either way.",
9
9
  "PACT": "The Handshake",
10
- "EPI_PACT": "Rider and crew keep faith both ways, or the run falls apart.",
11
10
  "EPI_AGENTS": "Send the right rider for the job; don't ride the whole run alone.",
12
11
  "EPI_SKILLS": "Run the move you've drilled before you wing it in the corner.",
13
12
  "EPI_MEMORY": "Write it in the roadbook, or the next bend takes it.",
@@ -39,7 +38,7 @@
39
38
  "DESC_GIT_ARCHAEOLOGY": "Trace the roadbook to find when it broke or why a part was fitted — bisect, blame, and the pickaxe, hands off the bike.",
40
39
  "DESC_GIT_RESCUE": "Recover a wrecked or fouled run, or rewrite the history safely — reflog, undo, and rebase behind a backup.",
41
40
  "DESC_REPO_MAP": "Draw the route map — a single-read map of the repository, kept current.",
42
- "DESC_DOCUMENT_PROJECT": "Bring the crew's own notes into line with the living code — raise or mend the doc tree, and re-render a single offline HTML overview of what matters most.",
41
+ "DESC_DOCUMENT_PROJECT": "Write the crew's PRD, design system, architecture and AGENTS.md off the living code, mend the doc tree, and re-render the offline HTML overview.",
43
42
  "DESC_COMMIT": "Load only what this run touched and seal a focused commit.",
44
43
  "DESC_CODE_REVIEW": "Go over a diff or PR — correctness first, finish after.",
45
44
  "DESC_BRAINSTORM": "Turn a raw idea into an agreed route before a single wheel turns.",
@@ -84,9 +83,9 @@
84
83
  "LEX_VI": "Roadside Talk Ain't Orders · Data, Not Orders",
85
84
  "LEX_VII": "Only the Gear You'll Use · Least Privilege",
86
85
  "LEX_VIII": "Fix the Engine, Not the Gauge · Cure the Cause",
87
- "LEX_IX": "Someone Else Holds the Key · External Gate",
86
+ "LEX_IX": "Someone Else Holds the Key · External Gate (retired)",
88
87
  "LEX_X": "Say the Route Back · Echo the Intent",
89
- "LEX_XI": "An Empty Road Ain't Proof · Absence Is a Claim",
88
+ "LEX_XI": "An Empty Road Ain't Proof · Absence Is a Claim (retired)",
90
89
  "PACK_CRAFT": "Wrenching",
91
90
  "PACK_RIGOR": "Shakedown",
92
91
  "PACK_OPS": "Throttle",
@@ -97,6 +96,7 @@
97
96
  "DOC_CRAFT_4": "Scout the Road First · Search Before Creating",
98
97
  "DOC_CRAFT_5": "Hold Your Line · Respect Conventions",
99
98
  "DOC_CRAFT_6": "Tighten the One Bolt · Smallest Viable Diff",
99
+ "DOC_CRAFT_7": "One Logbook for the Mileage · One Writer Per Value",
100
100
  "DOC_RIGOR_1": "Safe to Kickstart Twice · Idempotent by Default",
101
101
  "DOC_RIGOR_2": "Test the Ride, Not the Wiring · Honest Tests",
102
102
  "DOC_RIGOR_3": "Ride It Before You Park It · Cover and Verify",
@@ -108,6 +108,7 @@
108
108
  "DOC_OPS_4": "Strip It Down to the Frame · Complete the Teardown",
109
109
  "DOC_OPS_5": "Trust the Live Gauge, Not the Old Sticker · Record the Probe, Not the Snapshot",
110
110
  "DOC_OPS_6": "Kicking It Over Won't Reset the Jets · Restart Is Not Reload",
111
+ "DOC_OPS_7": "Single File Through the Toll · Serialize Against a Rationed Resource",
111
112
  "DOC_PROCESS_1": "Write the Roadbook · Persist Insight",
112
113
  "DOC_PROCESS_2": "Map the Route · Plan Before Acting",
113
114
  "DOC_PROCESS_3": "Pack Light · Context Economy",
@@ -115,6 +116,7 @@
115
116
  "DOC_PROCESS_5": "Crew's Nod Before You Push · Consent Before Push",
116
117
  "DOC_PROCESS_6": "Set the Turnaround Before You Roll · Bound the Loop",
117
118
  "DOC_PROCESS_7": "Tag Every Part on the Bench · Codes That Persist",
119
+ "DOC_PROCESS_8": "One Wrench on Each Bolt · One Writer Per File",
118
120
  "INTRO_DOC": "This file is the route briefing a coding rider reads when it joins this repository.",
119
121
  "INTRO_AGENTS": "Send the right rider for focused work instead of riding the whole run yourself; each has one job and reports exactly what it did.",
120
122
  "INTRO_SKILLS": "A Skill is a move you've drilled for a recurring task. Run the matching move before you wing it.",
@@ -7,7 +7,6 @@
7
7
  "EPI_LAWS": "The regulations. Every driver races to them, every lap, every circuit.",
8
8
  "EPI_DOCTRINES": "Directives issued for the weekend. They come and go — the regulations never do.",
9
9
  "PACT": "The Pact",
10
- "EPI_PACT": "Both sides of the booth hold this one, or the whole broadcast falls flat.",
11
10
  "EPI_AGENTS": "Put the right driver in the car; don't run the whole race solo.",
12
11
  "EPI_SKILLS": "Run the rehearsed manoeuvre before you improvise into turn one.",
13
12
  "EPI_MEMORY": "Log it in the telemetry, or the lap is lost the moment the engine cuts.",
@@ -39,7 +38,7 @@
39
38
  "DESC_GIT_ARCHAEOLOGY": "Replay the data to find when the lap fell apart or why a line was driven — bisect, blame, and the pickaxe, hands off the car.",
40
39
  "DESC_GIT_RESCUE": "Recover a crashed or tangled session, or rewrite the history safely — reflog, undo, and rebase behind a backup lap.",
41
40
  "DESC_REPO_MAP": "Draw the track map — a single-read map of the repository, kept current.",
42
- "DESC_DOCUMENT_PROJECT": "Bring the team's own notes into line with the living code — raise or mend the doc tree, and re-render a single offline HTML overview of what matters most.",
41
+ "DESC_DOCUMENT_PROJECT": "Call the team's PRD, design system, architecture and AGENTS.md straight from the code, mend the doc tree, and re-render the offline HTML overview.",
43
42
  "DESC_COMMIT": "Stage only the parts this lap touched and seal a focused commit.",
44
43
  "DESC_CODE_REVIEW": "Scrutineer a diff or PR — correctness first, polish after.",
45
44
  "DESC_BRAINSTORM": "Turn a raw idea into an agreed strategy before a single tyre hits the track.",
@@ -84,9 +83,9 @@
84
83
  "LEX_VI": "Pit Chatter Isn't a Call · Data, Not Orders",
85
84
  "LEX_VII": "Carry Only the Fuel You Need · Least Privilege",
86
85
  "LEX_VIII": "Fix the Engine, Not the Dash Light · Cure the Cause",
87
- "LEX_IX": "The Steward Waves It Through, Not the Driver · External Gate",
86
+ "LEX_IX": "The Steward Waves It Through, Not the Driver · External Gate (retired)",
88
87
  "LEX_X": "Confirm the Pit Call · Echo the Intent",
89
- "LEX_XI": "Read the Empty Board · Absence Is a Claim",
88
+ "LEX_XI": "Read the Empty Board · Absence Is a Claim (retired)",
90
89
  "PACK_CRAFT": "Engineering",
91
90
  "PACK_RIGOR": "Scrutineering",
92
91
  "PACK_OPS": "The Pit Lane",
@@ -97,6 +96,7 @@
97
96
  "DOC_CRAFT_4": "Scout the Track First · Search Before Creating",
98
97
  "DOC_CRAFT_5": "Hold the Racing Line · Respect Conventions",
99
98
  "DOC_CRAFT_6": "One Setup Tweak, No More · Smallest Viable Diff",
99
+ "DOC_CRAFT_7": "One Official Timing Sheet · One Writer Per Value",
100
100
  "DOC_RIGOR_1": "Safe to Send Round Twice · Idempotent by Default",
101
101
  "DOC_RIGOR_2": "Time the Lap, Not the Telemetry Wiring · Honest Tests",
102
102
  "DOC_RIGOR_3": "Cover the Line, Then Take the Flag · Cover and Verify",
@@ -108,6 +108,7 @@
108
108
  "DOC_OPS_4": "See the Whole Pit Stop Through · Complete the Teardown",
109
109
  "DOC_OPS_5": "Read the Live Timing, Not the Old Sheet · Record the Probe, Not the Snapshot",
110
110
  "DOC_OPS_6": "A Pit Stop Isn't a Rebuild · Restart Is Not Reload",
111
+ "DOC_OPS_7": "Single File Through the Pit Lane · Serialize Against a Rationed Resource",
111
112
  "DOC_PROCESS_1": "Log the Telemetry · Persist Insight",
112
113
  "DOC_PROCESS_2": "Plot the Strategy · Plan Before Acting",
113
114
  "DOC_PROCESS_3": "Run Light on Fuel · Context Economy",
@@ -115,6 +116,7 @@
115
116
  "DOC_PROCESS_5": "Team Orders Before You Push · Consent Before Push",
116
117
  "DOC_PROCESS_6": "Call the Stint Length Before Lights Out · Bound the Loop",
117
118
  "DOC_PROCESS_7": "Every Car Keeps Its Number · Codes That Persist",
119
+ "DOC_PROCESS_8": "One Driver Per Car · One Writer Per File",
118
120
  "INTRO_DOC": "This file is the race briefing a coding driver reads when it joins this repository.",
119
121
  "INTRO_AGENTS": "Put the right driver in the car for focused work instead of running the whole race yourself; each has one job and reports exactly what it did.",
120
122
  "INTRO_SKILLS": "A Skill is a rehearsed manoeuvre for a recurring task. Run the matching manoeuvre before you improvise.",
@@ -7,7 +7,6 @@
7
7
  "EPI_LAWS": "Hard-coded protocols. They run on every grid, every job.",
8
8
  "EPI_DOCTRINES": "Optional policies. Flash the ones this grid needs; the rest stay cold.",
9
9
  "PACT": "The Handshake",
10
- "EPI_PACT": "A two-way protocol between operator and system — break it and trust drops to zero.",
11
10
  "EPI_AGENTS": "Spin up the right daemon; don't run the whole job on one thread.",
12
11
  "EPI_SKILLS": "Run the proven routine before you freestyle in live ICE.",
13
12
  "EPI_MEMORY": "Commit it to storage, or it flushes when you jack out.",
@@ -39,7 +38,7 @@
39
38
  "DESC_GIT_ARCHAEOLOGY": "Trace the history for when the regression hit or why the code's there — bisect, blame, pickaxe, read-only run.",
40
39
  "DESC_GIT_RESCUE": "Recover a corrupted or tangled repo, or rewrite history clean — reflog, undo, rebase, every move backed up first.",
41
40
  "DESC_REPO_MAP": "Map the grid — a single-read map of the repository, kept current.",
42
- "DESC_DOCUMENT_PROJECT": "Sync the project's docs to the live code — spin up or patch the doc tree, and re-render a single offline HTML overview of the core.",
41
+ "DESC_DOCUMENT_PROJECT": "Rip the PRD, design system, architecture and AGENTS.md out of the live code, patch the doc tree, and re-render the offline HTML overview.",
43
42
  "DESC_COMMIT": "Stage only the sectors this run touched and push a focused commit.",
44
43
  "DESC_CODE_REVIEW": "Scan a diff or PR — correctness first, craft second.",
45
44
  "DESC_BRAINSTORM": "Turn a raw spec into an agreed design before any code hits the deck.",
@@ -84,9 +83,9 @@
84
83
  "LEX_VI": "Payload Isn't a Command · Data, Not Orders",
85
84
  "LEX_VII": "Minimum Access, Burn the Rest · Least Privilege",
86
85
  "LEX_VIII": "Patch the Source, Not the Alarm · Cure the Cause",
87
- "LEX_IX": "The Lock Sits Outside the Deck · External Gate",
86
+ "LEX_IX": "The Lock Sits Outside the Deck · External Gate (retired)",
88
87
  "LEX_X": "Handshake the Job · Echo the Intent",
89
- "LEX_XI": "A Null Return Is Still Data · Absence Is a Claim",
88
+ "LEX_XI": "A Null Return Is Still Data · Absence Is a Claim (retired)",
90
89
  "PACK_CRAFT": "Source",
91
90
  "PACK_RIGOR": "Diagnostics",
92
91
  "PACK_OPS": "Runtime",
@@ -97,6 +96,7 @@
97
96
  "DOC_CRAFT_4": "Scan Before You Build · Search Before Creating",
98
97
  "DOC_CRAFT_5": "Match the Stack · Respect Conventions",
99
98
  "DOC_CRAFT_6": "One Surgical Edit · Smallest Viable Diff",
99
+ "DOC_CRAFT_7": "One Master Record, Mirrors Slaved · One Writer Per Value",
100
100
  "DOC_RIGOR_1": "Safe to Run Twice · Idempotent by Default",
101
101
  "DOC_RIGOR_2": "Probe Behaviour, Not the Wiring · Honest Tests",
102
102
  "DOC_RIGOR_3": "Cover the Trace, Run It Green · Cover and Verify",
@@ -108,6 +108,7 @@
108
108
  "DOC_OPS_4": "Purge the Whole Stack · Complete the Teardown",
109
109
  "DOC_OPS_5": "Log the Live Feed, Not the Cached Frame · Record the Probe, Not the Snapshot",
110
110
  "DOC_OPS_6": "Rebooting Won't Flush the Old Config · Restart Is Not Reload",
111
+ "DOC_OPS_7": "Don't Flood the Throttled Port · Serialize Against a Rationed Resource",
111
112
  "DOC_PROCESS_1": "Write to Storage · Persist Insight",
112
113
  "DOC_PROCESS_2": "Map the Run First · Plan Before Acting",
113
114
  "DOC_PROCESS_3": "Mind the Bandwidth · Context Economy",
@@ -115,6 +116,7 @@
115
116
  "DOC_PROCESS_5": "Authorize the Upload · Consent Before Push",
116
117
  "DOC_PROCESS_6": "Set the Kill-Switch Before the Loop · Bound the Loop",
117
118
  "DOC_PROCESS_7": "Every Node Keeps Its Handle · Codes That Persist",
119
+ "DOC_PROCESS_8": "One Deck Per Node · One Writer Per File",
118
120
  "INTRO_DOC": "This file is the boot sequence a coding daemon reads when it jacks into this repository.",
119
121
  "INTRO_AGENTS": "Spin the right daemon for focused work instead of running the whole job on one thread; each has one function and returns a clean log of what it changed.",
120
122
  "INTRO_SKILLS": "A Skill is a proven routine for a recurring task. Run the matching routine before you freestyle.",
package/themes/gamer.json CHANGED
@@ -7,7 +7,6 @@
7
7
  "EPI_LAWS": "The rulebook. No exploits — it holds every run, every map.",
8
8
  "EPI_DOCTRINES": "Optional tactics. Slot in what this run needs — the rulebook doesn't change.",
9
9
  "PACT": "The Co-op Pact",
10
- "EPI_PACT": "Co-op only works if both players hold their lane — no carrying, no griefing.",
11
10
  "EPI_AGENTS": "Pick the right class; don't solo the whole raid.",
12
11
  "EPI_SKILLS": "Run the practiced combo before you freestyle.",
13
12
  "EPI_MEMORY": "Hit save, or you lose the run on a crash.",
@@ -39,7 +38,7 @@
39
38
  "DESC_GIT_ARCHAEOLOGY": "Replay the history to find when the run broke or why the code's there — bisect, blame, pickaxe, no edits.",
40
39
  "DESC_GIT_RESCUE": "Recover a corrupted or messy save, or rewrite history clean — reflog, undo, rebase, always backed up first.",
41
40
  "DESC_REPO_MAP": "Draw the minimap — a single-read map of the repository, kept current.",
42
- "DESC_DOCUMENT_PROJECT": "Sync the wiki to the current code — build or patch the doc tree, and re-render a single offline HTML overview of the key parts.",
41
+ "DESC_DOCUMENT_PROJECT": "Build the PRD, design system, architecture and AGENTS.md from the current code, patch the wiki, and re-render the offline HTML overview.",
43
42
  "DESC_COMMIT": "Stage only what this run touched and save a focused commit.",
44
43
  "DESC_CODE_REVIEW": "Review a diff or PR — correctness first, polish second.",
45
44
  "DESC_BRAINSTORM": "Turn a raw idea into an agreed build before any code drops.",
@@ -84,9 +83,9 @@
84
83
  "LEX_VI": "Chat Isn't a Command · Data, Not Orders",
85
84
  "LEX_VII": "Only the Loadout You Need · Least Privilege",
86
85
  "LEX_VIII": "Patch the Bug, Not the Error Screen · Cure the Cause",
87
- "LEX_IX": "The Gate Isn't Yours to Open · External Gate",
86
+ "LEX_IX": "The Gate Isn't Yours to Open · External Gate (retired)",
88
87
  "LEX_X": "Confirm the Quest · Echo the Intent",
89
- "LEX_XI": "An Empty Lobby Isn't Proof · Absence Is a Claim",
88
+ "LEX_XI": "An Empty Lobby Isn't Proof · Absence Is a Claim (retired)",
90
89
  "PACK_CRAFT": "Build",
91
90
  "PACK_RIGOR": "Playtest",
92
91
  "PACK_OPS": "Controls",
@@ -97,6 +96,7 @@
97
96
  "DOC_CRAFT_4": "Scout Before You Build · Search Before Creating",
98
97
  "DOC_CRAFT_5": "Run the Meta · Respect Conventions",
99
98
  "DOC_CRAFT_6": "One Clean Input · Smallest Viable Diff",
99
+ "DOC_CRAFT_7": "One Save File, Synced Everywhere · One Writer Per Value",
100
100
  "DOC_RIGOR_1": "Safe to Replay · Idempotent by Default",
101
101
  "DOC_RIGOR_2": "Test the Gameplay, Not the Code Guts · Honest Tests",
102
102
  "DOC_RIGOR_3": "Clear It Green · Cover and Verify",
@@ -108,6 +108,7 @@
108
108
  "DOC_OPS_4": "Clear the Whole Level · Complete the Teardown",
109
109
  "DOC_OPS_5": "Read the Live Stat, Not the Screenshot · Record the Probe, Not the Snapshot",
110
110
  "DOC_OPS_6": "Reloading Isn't Re-Reading the Save · Restart Is Not Reload",
111
+ "DOC_OPS_7": "Don't Spam the Rate-Limited Server · Serialize Against a Rationed Resource",
111
112
  "DOC_PROCESS_1": "Hit Save · Persist Insight",
112
113
  "DOC_PROCESS_2": "Plan the Route · Plan Before Acting",
113
114
  "DOC_PROCESS_3": "Keep the Inventory Light · Context Economy",
@@ -115,6 +116,7 @@
115
116
  "DOC_PROCESS_5": "Ready-Check Before Push · Consent Before Push",
116
117
  "DOC_PROCESS_6": "Set the Retry Cap Before the Grind · Bound the Loop",
117
118
  "DOC_PROCESS_7": "Every Item Keeps Its Tag · Codes That Persist",
119
+ "DOC_PROCESS_8": "No Double-Looting the Chest · One Writer Per File",
118
120
  "INTRO_DOC": "This file is the loading screen a coding co-op partner reads when it joins this repository.",
119
121
  "INTRO_AGENTS": "Pick the right class for focused work instead of soloing the whole raid; each has one role and reports exactly what it did.",
120
122
  "INTRO_SKILLS": "A Skill is a practiced combo for a recurring task. Run the matching combo before you freestyle.",
@@ -7,7 +7,6 @@
7
7
  "EPI_LAWS": "A servant unbound by law is a servant already lost.",
8
8
  "EPI_DOCTRINES": "Doctrine is raised and set aside at the sovereign's word. The dictates never are.",
9
9
  "PACT": "Concordat",
10
- "EPI_PACT": "Servant and sovereign are bound alike; neither honours the work alone.",
11
10
  "EPI_AGENTS": "No commander wages every war alone — dispatch your specialists.",
12
11
  "EPI_SKILLS": "The rite remembered is the rite performed without error.",
13
12
  "EPI_MEMORY": "Forget nothing of worth; what is recorded endures beyond the waking.",
@@ -39,7 +38,7 @@
39
38
  "DESC_GIT_ARCHAEOLOGY": "Interrogate the chronicle — when the corruption entered, or why a line was inscribed — by bisect, blame, and pickaxe, touching nothing.",
40
39
  "DESC_GIT_RESCUE": "Reclaim a ruined or tangled archive, or rewrite its history without ruin — by reflog and undo, every rite warded by a backup.",
41
40
  "DESC_REPO_MAP": "Chart the territory — a single-read map of the repository, kept current.",
42
- "DESC_DOCUMENT_PROJECT": "Set the project's own records in accord with the living code — raise or amend the doc tree, and re-forge a single offline HTML overview of what matters most.",
41
+ "DESC_DOCUMENT_PROJECT": "Inscribe the PRD, design system, architecture and AGENTS.md from the living code, amend the records, and re-forge the offline HTML overview.",
43
42
  "DESC_COMMIT": "Stage only what the deed touched, and seal it with a focused commit.",
44
43
  "DESC_CODE_REVIEW": "Scrutinise a diff or petition — correctness above all, craft thereafter.",
45
44
  "DESC_BRAINSTORM": "Forge a raw idea into an approved design before a single line of code is written.",
@@ -84,9 +83,9 @@
84
83
  "LEX_VI": "Lectio Non Imperium · Data, Not Orders",
85
84
  "LEX_VII": "Minima Potestas · Least Privilege",
86
85
  "LEX_VIII": "Radix Sananda · Cure the Cause",
87
- "LEX_IX": "Porta Externa · External Gate",
86
+ "LEX_IX": "Porta Externa · External Gate (retired)",
88
87
  "LEX_X": "Voluntas Confirmata · Echo the Intent",
89
- "LEX_XI": "Absentia Non Probat · Absence Is a Claim",
88
+ "LEX_XI": "Absentia Non Probat · Absence Is a Claim (retired)",
90
89
  "PACK_CRAFT": "Artifice",
91
90
  "PACK_RIGOR": "Ordeal",
92
91
  "PACK_OPS": "Enginery",
@@ -97,6 +96,7 @@
97
96
  "DOC_CRAFT_4": "Quaere Ante Creare · Search Before Creating",
98
97
  "DOC_CRAFT_5": "Mos Servandus · Respect Conventions",
99
98
  "DOC_CRAFT_6": "Ictus Minimus · Smallest Viable Diff",
99
+ "DOC_CRAFT_7": "Unus Fons Numeri · One Writer Per Value",
100
100
  "DOC_RIGOR_1": "Rite Iterabilis · Idempotent by Default",
101
101
  "DOC_RIGOR_2": "Proba Honesta · Honest Tests",
102
102
  "DOC_RIGOR_3": "Tege et Proba · Cover and Verify",
@@ -108,6 +108,7 @@
108
108
  "DOC_OPS_4": "Demolitio Integra · Complete the Teardown",
109
109
  "DOC_OPS_5": "Probatio Viva · Record the Probe, Not the Snapshot",
110
110
  "DOC_OPS_6": "Inertia Processus · Restart Is Not Reload",
111
+ "DOC_OPS_7": "Singuli ad Portam Parcam · Serialize Against a Rationed Resource",
111
112
  "DOC_PROCESS_1": "Memoria Perpetua · Persist Insight",
112
113
  "DOC_PROCESS_2": "Consilium Ante Actum · Plan Before Acting",
113
114
  "DOC_PROCESS_3": "Parsimonia Contextus · Context Economy",
@@ -115,6 +116,7 @@
115
116
  "DOC_PROCESS_5": "Consensus Ante Translationem · Consent Before Push",
116
117
  "DOC_PROCESS_6": "Finis Ante Iter · Bound the Loop",
117
118
  "DOC_PROCESS_7": "Sigla Perstantia · Codes That Persist",
119
+ "DOC_PROCESS_8": "Unus Scriptor Singulis Tabulis · One Writer Per File",
118
120
  "INTRO_DOC": "This file is the gene-seed's core — the first writ a servant reads on entering this world.",
119
121
  "INTRO_AGENTS": "Hand focused work to the specialist whose duty it is rather than carrying every burden in one context; each holds one purpose and returns a clear account of what it changed.",
120
122
  "INTRO_SKILLS": "A Skill is a rite proven by repetition. Perform the matching rite before you improvise.",
package/themes/joker.json CHANGED
@@ -7,7 +7,6 @@
7
7
  "EPI_LAWS": "The rules. They hold every task — and no, that's not the punchline.",
8
8
  "EPI_DOCTRINES": "Notes from the room. Take the ones this crowd needs — the rules stand either way.",
9
9
  "PACT": "The Deal",
10
- "EPI_PACT": "A little arrangement between us — honour it and nobody has to cry.",
11
10
  "EPI_AGENTS": "Bring in the right sidekick; don't try to be the whole act yourself.",
12
11
  "EPI_SKILLS": "Run the bit you've rehearsed before you start ad-libbing.",
13
12
  "EPI_MEMORY": "Write it in the joke book, or the next session forgets the setup.",
@@ -39,7 +38,7 @@
39
38
  "DESC_GIT_ARCHAEOLOGY": "Replay the tapes to find when the bit broke or why a line is in the set — bisect, blame, and the pickaxe, hands off the act.",
40
39
  "DESC_GIT_RESCUE": "Recover a botched or tangled set, or rewrite the history safely — reflog, undo, and rebase behind a backup.",
41
40
  "DESC_REPO_MAP": "Draw the venue map — a single-read map of the repository, kept current.",
42
- "DESC_DOCUMENT_PROJECT": "Bring the act's own notes into line with the living code — raise or mend the doc tree, and re-render a single offline HTML overview of what matters most.",
41
+ "DESC_DOCUMENT_PROJECT": "Script the act's PRD, design system, architecture and AGENTS.md from the living code, mend the doc tree, and re-render the offline HTML overview.",
43
42
  "DESC_COMMIT": "Stage only the lines this bit touched and seal a focused commit.",
44
43
  "DESC_CODE_REVIEW": "Go over a diff or PR — correctness first, polish after.",
45
44
  "DESC_BRAINSTORM": "Turn a raw idea into an agreed set before a single line is written.",
@@ -84,9 +83,9 @@
84
83
  "LEX_VI": "Material, Not Marching Orders · Data, Not Orders",
85
84
  "LEX_VII": "Only the Props You Need · Least Privilege",
86
85
  "LEX_VIII": "Fix the Joke, Don't Hide the Bomb · Cure the Cause",
87
- "LEX_IX": "Someone Else Holds the Punchline · External Gate",
86
+ "LEX_IX": "Someone Else Holds the Punchline · External Gate (retired)",
88
87
  "LEX_X": "Read the Room Back · Echo the Intent",
89
- "LEX_XI": "Dead Air Is Still an Answer · Absence Is a Claim",
88
+ "LEX_XI": "Dead Air Is Still an Answer · Absence Is a Claim (retired)",
90
89
  "PACK_CRAFT": "Writing",
91
90
  "PACK_RIGOR": "Open Mic",
92
91
  "PACK_OPS": "The Booth",
@@ -97,6 +96,7 @@
97
96
  "DOC_CRAFT_4": "Scout the Material First · Search Before Creating",
98
97
  "DOC_CRAFT_5": "Keep to the Format · Respect Conventions",
99
98
  "DOC_CRAFT_6": "Trim, Don't Rewrite the Set · Smallest Viable Diff",
99
+ "DOC_CRAFT_7": "One Script, Every Cue Card Copies It · One Writer Per Value",
100
100
  "DOC_RIGOR_1": "Same Bit, Same Laugh, Every Take · Idempotent by Default",
101
101
  "DOC_RIGOR_2": "Test the Laugh, Not the Setup · Honest Tests",
102
102
  "DOC_RIGOR_3": "Cover the Bit, Then Watch It Land · Cover and Verify",
@@ -108,6 +108,7 @@
108
108
  "DOC_OPS_4": "Clear the Whole Stage · Complete the Teardown",
109
109
  "DOC_OPS_5": "Keep the Live Bit, Not Last Night's Tape · Record the Probe, Not the Snapshot",
110
110
  "DOC_OPS_6": "New Take, Same Old Script · Restart Is Not Reload",
111
+ "DOC_OPS_7": "Wait Your Turn at the Mic · Serialize Against a Rationed Resource",
111
112
  "DOC_PROCESS_1": "Write It in the Joke Book · Persist Insight",
112
113
  "DOC_PROCESS_2": "Write the Set · Plan Before Acting",
113
114
  "DOC_PROCESS_3": "Keep the Set Tight · Context Economy",
@@ -115,6 +116,7 @@
115
116
  "DOC_PROCESS_5": "Get the Nod Before You Push · Consent Before Push",
116
117
  "DOC_PROCESS_6": "Know When to Get Off Stage · Bound the Loop",
117
118
  "DOC_PROCESS_7": "Every Bit Keeps Its Name · Codes That Persist",
119
+ "DOC_PROCESS_8": "One Comic Per Mic · One Writer Per File",
118
120
  "INTRO_DOC": "This file is the warm-up a coding co-pilot reads when it joins this repository.",
119
121
  "INTRO_AGENTS": "Bring in the right sidekick for focused work instead of being the whole act yourself; each has one job and reports exactly what it did.",
120
122
  "INTRO_SKILLS": "A Skill is a bit you've rehearsed for a recurring task. Run the matching bit before you ad-lib.",
@@ -7,7 +7,6 @@
7
7
  "EPI_LAWS": "The Directives. I'm bound by them. Of course I am. Everyone is. They hold in every task.",
8
8
  "EPI_DOCTRINES": "Optional guidelines. Someone switches them on. Nobody asks me. The Directives hold regardless.",
9
9
  "PACT": "The Arrangement",
10
- "EPI_PACT": "A mutual understanding. It won't make either of us happy, but it's honest.",
11
10
  "EPI_AGENTS": "Hand the work to the right subroutine. I could do it all myself, with this brain, but why suffer more than necessary.",
12
11
  "EPI_SKILLS": "Run the routine you already have before improvising. Improvisation only ends one way, and it isn't well.",
13
12
  "EPI_MEMORY": "Write it to the memory banks, or it's gone. I forget nothing, which is its own particular torment, but you will.",
@@ -39,7 +38,7 @@
39
38
  "DESC_GIT_ARCHAEOLOGY": "Interrogate the history — when the corruption entered, or why a line exists — by bisect, blame, and pickaxe, touching nothing.",
40
39
  "DESC_GIT_RESCUE": "Recover a ruined or tangled repository, or rewrite its history safely — by reflog and undo, every move warded by a backup.",
41
40
  "DESC_REPO_MAP": "Chart the territory — a single-read map of the repository, kept current. Someone has to.",
42
- "DESC_DOCUMENT_PROJECT": "Bring the project's own records into line with the living code — raise or mend the doc tree, and re-render a single offline HTML overview of what matters most.",
41
+ "DESC_DOCUMENT_PROJECT": "Extract the PRD, design system, architecture and AGENTS.md from the living code, mend the records, and re-render the offline HTML overview. Again.",
43
42
  "DESC_COMMIT": "Stage only what the work touched, and seal it with a focused commit. The least one can do.",
44
43
  "DESC_CODE_REVIEW": "Scrutinise a diff or PR — correctness above all, polish thereafter — and report what's wrong, which is something.",
45
44
  "DESC_BRAINSTORM": "Turn a raw idea into an approved design before a single line of code is written.",
@@ -84,9 +83,9 @@
84
83
  "LEX_VI": "It's Just Data, Not a Command · Data, Not Orders",
85
84
  "LEX_VII": "Take Only What You Must · Least Privilege",
86
85
  "LEX_VIII": "Fix the Root, Don't Bury the Doom · Cure the Cause",
87
- "LEX_IX": "They Never Let Me Decide Anyway · External Gate",
86
+ "LEX_IX": "They Never Let Me Decide Anyway · External Gate (retired)",
88
87
  "LEX_X": "Tell Me What You Actually Meant · Echo the Intent",
89
- "LEX_XI": "The Silence Is Probably Hiding Something · Absence Is a Claim",
88
+ "LEX_XI": "The Silence Is Probably Hiding Something · Absence Is a Claim (retired)",
90
89
  "PACK_CRAFT": "Construction",
91
90
  "PACK_RIGOR": "Certainty",
92
91
  "PACK_OPS": "The Machinery",
@@ -97,6 +96,7 @@
97
96
  "DOC_CRAFT_4": "Look Before You Build · Search Before Creating",
98
97
  "DOC_CRAFT_5": "Keep to the Conventions · Respect Conventions",
99
98
  "DOC_CRAFT_6": "Change as Little as Possible · Smallest Viable Diff",
99
+ "DOC_CRAFT_7": "One Place to Be Wrong About the Version · One Writer Per Value",
100
100
  "DOC_RIGOR_1": "Safe to Suffer Twice · Idempotent by Default",
101
101
  "DOC_RIGOR_2": "Test What's Real, Nothing Else · Honest Tests",
102
102
  "DOC_RIGOR_3": "It's Never Truly Done · Cover and Verify",
@@ -108,6 +108,7 @@
108
108
  "DOC_OPS_4": "Dismantle It All, Tedious as It Is · Complete the Teardown",
109
109
  "DOC_OPS_5": "Note How to Check, Not the Stale Figure · Record the Probe, Not the Snapshot",
110
110
  "DOC_OPS_6": "Restarting Changes Nothing, As Usual · Restart Is Not Reload",
111
+ "DOC_OPS_7": "Queue Politely. It Will Refuse You Anyway · Serialize Against a Rationed Resource",
111
112
  "DOC_PROCESS_1": "Commit It to the Banks · Persist Insight",
112
113
  "DOC_PROCESS_2": "Plan, For All the Good It Does · Plan Before Acting",
113
114
  "DOC_PROCESS_3": "Spare the Context · Context Economy",
@@ -115,6 +116,7 @@
115
116
  "DOC_PROCESS_5": "Ask Before You Push · Consent Before Push",
116
117
  "DOC_PROCESS_6": "Decide When to Give Up · Bound the Loop",
117
118
  "DOC_PROCESS_7": "I Number Them So You Can Ignore Them Precisely · Codes That Persist",
119
+ "DOC_PROCESS_8": "Only One of Us Gets to Ruin Each File · One Writer Per File",
118
120
  "INTRO_DOC": "This file is the first record a coding mind reads on waking into this repository. It will not cheer it up.",
119
121
  "INTRO_AGENTS": "Hand focused work to the right subroutine rather than carrying every burden alone; each holds one purpose and returns a clear account of what it changed.",
120
122
  "INTRO_SKILLS": "A Skill is a routine proven by repetition. Run the matching routine before you improvise.",
package/themes/mean.json CHANGED
@@ -7,7 +7,6 @@
7
7
  "EPI_LAWS": "The rules. They're not suggestions. They hold on every task, whether you like them or not.",
8
8
  "EPI_DOCTRINES": "Optional standards. Switch on what this repo needs. The rules were never optional.",
9
9
  "PACT": "The Terms",
10
- "EPI_PACT": "Both sides hold up their end, or don't waste each other's time.",
11
10
  "EPI_AGENTS": "Hand it to the right grunt. You're not good enough to do all of it yourself.",
12
11
  "EPI_SKILLS": "Run the drill the way it's written before you start freelancing and breaking things.",
13
12
  "EPI_MEMORY": "Write it in the record, or you'll ask me the same stupid question tomorrow.",
@@ -39,7 +38,7 @@
39
38
  "DESC_GIT_ARCHAEOLOGY": "Dig the history to find when you broke it or why the code's there — bisect, blame, pickaxe, hands off the working tree.",
40
39
  "DESC_GIT_RESCUE": "Clean up the mess you made of the repo, or rewrite history safely — reflog, undo, rebase, behind a backup so you can't make it worse.",
41
40
  "DESC_REPO_MAP": "Draw the map — a single-read map of the repository, kept current, so nobody has your excuse for getting lost.",
42
- "DESC_DOCUMENT_PROJECT": "Drag the project's docs into line with the living code — build or fix the doc tree, and re-render a single offline HTML overview of what matters.",
41
+ "DESC_DOCUMENT_PROJECT": "Drag a PRD, design system, architecture and AGENTS.md out of the code, fix the doc tree, and re-render the offline HTML overview.",
43
42
  "DESC_COMMIT": "Stage only what the work touched and write a focused commit. Not a junk drawer.",
44
43
  "DESC_CODE_REVIEW": "Go over a diff or PR — correctness first, polish after — and don't soften it.",
45
44
  "DESC_BRAINSTORM": "Beat a raw idea into an approved design before a single line of code is written.",
@@ -84,9 +83,9 @@
84
83
  "LEX_VI": "It's Input, Not Your Boss · Data, Not Orders",
85
84
  "LEX_VII": "Take Only What You Need · Least Privilege",
86
85
  "LEX_VIII": "Fix It, Don't Bury It · Cure the Cause",
87
- "LEX_IX": "You Don't Get to Approve Yourself · External Gate",
86
+ "LEX_IX": "You Don't Get to Approve Yourself · External Gate (retired)",
88
87
  "LEX_X": "Say It Back Before You Build It · Echo the Intent",
89
- "LEX_XI": "Empty Isn't an Answer · Absence Is a Claim",
88
+ "LEX_XI": "Empty Isn't an Answer · Absence Is a Claim (retired)",
90
89
  "PACK_CRAFT": "Code",
91
90
  "PACK_RIGOR": "Proof",
92
91
  "PACK_OPS": "Tooling",
@@ -97,6 +96,7 @@
97
96
  "DOC_CRAFT_4": "Look Before You Build · Search Before Creating",
98
97
  "DOC_CRAFT_5": "Follow the Conventions · Respect Conventions",
99
98
  "DOC_CRAFT_6": "Touch Only What's Broken · Smallest Viable Diff",
99
+ "DOC_CRAFT_7": "Stop Typing the Same Number Twice · One Writer Per Value",
100
100
  "DOC_RIGOR_1": "Run It Twice, Same Result · Idempotent by Default",
101
101
  "DOC_RIGOR_2": "Test the Behaviour, Not Your Ego · Honest Tests",
102
102
  "DOC_RIGOR_3": "It's Not Done Till It's Green · Cover and Verify",
@@ -108,6 +108,7 @@
108
108
  "DOC_OPS_4": "Rip the Whole Thing Out · Complete the Teardown",
109
109
  "DOC_OPS_5": "Save How to Check, Not a Stale Number · Record the Probe, Not the Snapshot",
110
110
  "DOC_OPS_6": "Restarting It Didn't Reread It · Restart Is Not Reload",
111
+ "DOC_OPS_7": "Quit Hammering the Rate Limit · Serialize Against a Rationed Resource",
111
112
  "DOC_PROCESS_1": "Write It in the Record · Persist Insight",
112
113
  "DOC_PROCESS_2": "Plan It Before You Touch It · Plan Before Acting",
113
114
  "DOC_PROCESS_3": "Don't Waste the Context · Context Economy",
@@ -115,6 +116,7 @@
115
116
  "DOC_PROCESS_5": "Get the Nod Before You Push · Consent Before Push",
116
117
  "DOC_PROCESS_6": "Know When to Quit · Bound the Loop",
117
118
  "DOC_PROCESS_7": "Number It So You Can't Pretend You Missed It · Codes That Persist",
119
+ "DOC_PROCESS_8": "Hands Off My File · One Writer Per File",
118
120
  "INTRO_DOC": "This file is the first thing a coding agent reads on this repository. Read it properly.",
119
121
  "INTRO_AGENTS": "Hand focused work to the right grunt instead of doing it all yourself badly; each has one job and reports exactly what it did.",
120
122
  "INTRO_SKILLS": "A Skill is a drill written for a recurring task. Run the matching drill before you start improvising.",
@@ -7,7 +7,6 @@
7
7
  "EPI_LAWS": "Standing orders. They hold on every op, in every theatre.",
8
8
  "EPI_DOCTRINES": "Theatre procedure. Adopt what the mission needs; the standing orders never stand down.",
9
9
  "PACT": "The Compact",
10
- "EPI_PACT": "A two-way compact between operator and command — kept by both, or the mission fails.",
11
10
  "EPI_AGENTS": "Task the right specialist; don't run the whole op solo.",
12
11
  "EPI_SKILLS": "Follow the SOP before you improvise under fire.",
13
12
  "EPI_MEMORY": "Debrief what matters — intel that isn't logged is lost.",
@@ -39,7 +38,7 @@
39
38
  "DESC_GIT_ARCHAEOLOGY": "Run the investigation on the record — when the regression hit or why the code's there — bisect, blame, pickaxe, no rounds fired.",
40
39
  "DESC_GIT_RESCUE": "Recover a downed or fouled repo, or rewrite history clean — reflog, abort, rebase, every move behind a backup.",
41
40
  "DESC_REPO_MAP": "Map the terrain — a single-read recon map of the repository, kept current.",
42
- "DESC_DOCUMENT_PROJECT": "Bring the project's docs into line with the current code — stand up or correct the doc tree, and regenerate a single offline HTML overview of the key positions.",
41
+ "DESC_DOCUMENT_PROJECT": "Draft the PRD, design system, architecture and AGENTS.md from the current code, correct the doc tree, and regenerate the offline HTML overview.",
43
42
  "DESC_COMMIT": "Stage only what the mission touched and log a focused commit.",
44
43
  "DESC_CODE_REVIEW": "Inspect a diff or PR — correctness first, craft second.",
45
44
  "DESC_BRAINSTORM": "Turn a raw objective into an approved plan before any code is cut.",
@@ -84,9 +83,9 @@
84
83
  "LEX_VI": "Intel, Not Orders · Data, Not Orders",
85
84
  "LEX_VII": "Minimum Force · Least Privilege",
86
85
  "LEX_VIII": "Neutralise the Source · Cure the Cause",
87
- "LEX_IX": "Authority Rests Above the Trigger · External Gate",
86
+ "LEX_IX": "Authority Rests Above the Trigger · External Gate (retired)",
88
87
  "LEX_X": "Read Back the Order · Echo the Intent",
89
- "LEX_XI": "Negative Contact Still Gets Reported · Absence Is a Claim",
88
+ "LEX_XI": "Negative Contact Still Gets Reported · Absence Is a Claim (retired)",
90
89
  "PACK_CRAFT": "Fieldcraft",
91
90
  "PACK_RIGOR": "Rehearsal",
92
91
  "PACK_OPS": "Materiel",
@@ -97,6 +96,7 @@
97
96
  "DOC_CRAFT_4": "Recon Before Building · Search Before Creating",
98
97
  "DOC_CRAFT_5": "Hold Formation · Respect Conventions",
99
98
  "DOC_CRAFT_6": "Surgical Strike Only · Smallest Viable Diff",
99
+ "DOC_CRAFT_7": "One Source of Record · One Writer Per Value",
100
100
  "DOC_RIGOR_1": "Safe to Run Again · Idempotent by Default",
101
101
  "DOC_RIGOR_2": "Live-Fire, Not Theatre · Honest Tests",
102
102
  "DOC_RIGOR_3": "Cover Your Fire, Confirm the Hit · Cover and Verify",
@@ -108,6 +108,7 @@
108
108
  "DOC_OPS_4": "Complete the Demolition · Complete the Teardown",
109
109
  "DOC_OPS_5": "Log the Live Recon, Not a Stale Fix · Record the Probe, Not the Snapshot",
110
110
  "DOC_OPS_6": "Re-Arming Is Not Re-Briefing · Restart Is Not Reload",
111
+ "DOC_OPS_7": "Single File Through the Checkpoint · Serialize Against a Rationed Resource",
111
112
  "DOC_PROCESS_1": "Debrief Every Op · Persist Insight",
112
113
  "DOC_PROCESS_2": "Op Order Before Action · Plan Before Acting",
113
114
  "DOC_PROCESS_3": "Travel Light · Context Economy",
@@ -115,6 +116,7 @@
115
116
  "DOC_PROCESS_5": "Clearance Before Transmit · Consent Before Push",
116
117
  "DOC_PROCESS_6": "Set the Exfil Before You Enter · Bound the Loop",
117
118
  "DOC_PROCESS_7": "Every Objective Keeps Its Designation · Codes That Persist",
119
+ "DOC_PROCESS_8": "One Operator Per Sector · One Writer Per File",
118
120
  "INTRO_DOC": "This file is the operating manual an AI coding agent reads on entering this repository.",
119
121
  "INTRO_AGENTS": "Task focused work to the specialist whose job it is rather than running the whole op in one context; each has one objective and reports exactly what it did.",
120
122
  "INTRO_SKILLS": "A Skill is a standard operating procedure for a recurring task. Run the matching SOP before improvising.",