geneseed 4.32.0 → 5.0.1

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 (246) hide show
  1. package/CHANGELOG.md +101 -0
  2. package/DESIGN.md +2 -2
  3. package/README.md +6 -5
  4. package/SHIPPED.md +4 -3
  5. package/adapters/bob/README.md +6 -5
  6. package/adapters/claude-code/README.md +4 -3
  7. package/adapters/claude-code/skills/geneseed/SKILL.md +1 -1
  8. package/adapters/openclaude/README.md +4 -3
  9. package/adapters/opencode/GLOBAL-HARNESS-SPEC.md +3 -1
  10. package/adapters/opencode/HOW-OPENCODE-LOADS.md +2 -1
  11. package/adapters/opencode/README.md +18 -18
  12. package/adapters/opencode/plugins/geneseed-activity.js +57 -1
  13. package/adapters/opencode/plugins/geneseed-context.js +85 -18
  14. package/adapters/opencode/plugins/geneseed-guard.js +437 -76
  15. package/adapters/opencode/plugins/geneseed-learn.js +97 -23
  16. package/bin/geneseed-cli.mjs +17 -25
  17. package/bin/geneseed-hook.mjs +23 -8
  18. package/docs/DESIGN.md +175 -0
  19. package/docs/PRD.md +111 -0
  20. package/docs/README.md +3 -2
  21. package/docs/architecture.md +145 -0
  22. package/docs/concepts/agents.md +1 -1
  23. package/docs/concepts/collaboration.md +1 -1
  24. package/docs/concepts/enforcement-table.md +1 -1
  25. package/docs/concepts/exclusions.md +5 -5
  26. package/docs/concepts/footprint.md +1 -1
  27. package/docs/concepts/foreman-mode.md +2 -2
  28. package/docs/concepts/hooks.md +22 -8
  29. package/docs/concepts/host-matrix.md +2 -2
  30. package/docs/concepts/hosts.md +1 -1
  31. package/docs/concepts/kits.md +3 -1
  32. package/docs/concepts/ownership.md +1 -1
  33. package/docs/concepts/rules.md +15 -2
  34. package/docs/concepts/shared-tier.md +73 -0
  35. package/docs/concepts/skills.md +2 -2
  36. package/docs/concepts/themes.md +1 -1
  37. package/docs/extending.md +13 -12
  38. package/docs/guides/install-claude-code.md +1 -1
  39. package/docs/guides/install-opencode.md +1 -1
  40. package/docs/guides/migrate.md +8 -4
  41. package/docs/guides/project-context.md +2 -2
  42. package/docs/guides/setup-footprint.md +1 -1
  43. package/docs/guides/uninstall.md +2 -1
  44. package/docs/guides/upgrade-to-5.md +118 -0
  45. package/docs/guides/upgrade.md +21 -9
  46. package/docs/guides/wiki.md +3 -3
  47. package/docs/reference/env-context.md +5 -3
  48. package/docs/reference/environment.md +1 -1
  49. package/docs/reference/glossary.md +2 -0
  50. package/docs/reference/opencode-plugins.md +3 -3
  51. package/docs/reference/plugin-activity.md +1 -1
  52. package/docs/reference/plugin-context.md +1 -0
  53. package/docs/reference/plugin-guard.md +14 -6
  54. package/docs/reference/plugin-learn.md +13 -6
  55. package/docs/reference/troubleshoot-hooks.md +3 -3
  56. package/docs/reference/troubleshoot-update.md +14 -0
  57. package/docs/token-footprint.md +4 -3
  58. package/docs/understand/a-day.md +2 -2
  59. package/docs/understand/design-choices-install.md +2 -1
  60. package/docs/understand/enforced-vs-asked.md +1 -1
  61. package/docs/understand/machine-bob.md +2 -0
  62. package/docs/understand/machine-claude.md +7 -5
  63. package/docs/understand/machine-opencode.md +7 -5
  64. package/docs/understand/on-your-machine.md +4 -0
  65. package/docs/understand/take-it-out.md +1 -1
  66. package/docs/web-ui.md +135 -70
  67. package/harness.config.json +1 -1
  68. package/js/README.md +12 -7
  69. package/js/build/args.mjs +10 -8
  70. package/js/build/bundle.mjs +11 -13
  71. package/js/build/driver.mjs +66 -65
  72. package/js/build/emit-claude.mjs +22 -16
  73. package/js/build/emit-common.mjs +4 -5
  74. package/js/build/emit-opencode.mjs +22 -22
  75. package/js/build/fold.mjs +515 -0
  76. package/js/build/generate.mjs +41 -52
  77. package/js/build/render.mjs +115 -29
  78. package/js/build/rule-decide.mjs +273 -0
  79. package/js/build/source.mjs +4 -1
  80. package/js/build/stubs.mjs +70 -9
  81. package/js/build/version.mjs +10 -10
  82. package/js/cli-table.json +23 -83
  83. package/js/hosts/activity.mjs +2 -2
  84. package/js/hosts/geneseed-dir.mjs +1 -1
  85. package/js/hosts/hooks-context.mjs +389 -99
  86. package/js/hosts/hooks-learn.mjs +38 -7
  87. package/js/hosts/hooks-prims.mjs +4 -2
  88. package/js/hosts/hooks.mjs +114 -39
  89. package/js/hosts/hosts.mjs +150 -51
  90. package/js/hosts/installs.mjs +59 -171
  91. package/js/hosts/link.mjs +3 -5
  92. package/js/hosts/mcp.mjs +1 -1
  93. package/js/hosts/memory-files.mjs +219 -17
  94. package/js/hosts/ownership-gate.mjs +1 -1
  95. package/js/hosts/settings.mjs +18 -13
  96. package/js/hosts/shim.mjs +4 -33
  97. package/js/hosts/store-watch.mjs +191 -0
  98. package/js/inspect/checks-authoring.mjs +3 -3
  99. package/js/inspect/checks-build.mjs +45 -18
  100. package/js/inspect/checks-counts.mjs +4 -4
  101. package/js/inspect/checks-repo.mjs +13 -14
  102. package/js/inspect/cost.mjs +24 -2
  103. package/js/inspect/diff.mjs +123 -123
  104. package/js/inspect/doctor.mjs +22 -27
  105. package/js/inspect/excludes.mjs +181 -62
  106. package/js/inspect/inventory.mjs +22 -27
  107. package/js/inspect/registry.mjs +110 -32
  108. package/js/inspect/scan.mjs +5 -5
  109. package/js/inspect/status.mjs +141 -119
  110. package/js/inspect/validate.mjs +22 -24
  111. package/js/lib/fs.mjs +47 -50
  112. package/js/lib/json.mjs +10 -17
  113. package/js/lib/machine-dir.mjs +73 -0
  114. package/js/lib/paths.mjs +35 -33
  115. package/js/lib/proc.mjs +1 -1
  116. package/js/lib/prompt.mjs +19 -27
  117. package/js/lib/text.mjs +8 -12
  118. package/js/lib/udiff.mjs +11 -15
  119. package/js/loop/catalog.mjs +2 -3
  120. package/js/maintain/memory.mjs +17 -17
  121. package/js/maintain/migrate.mjs +120 -92
  122. package/js/maintain/setup.mjs +43 -32
  123. package/js/maintain/uninstall.mjs +43 -61
  124. package/js/maintain/update.mjs +200 -93
  125. package/js/ui/anim.mjs +21 -35
  126. package/js/ui/cli.mjs +36 -58
  127. package/js/ui/menu.mjs +22 -45
  128. package/js/ui/tui.mjs +27 -67
  129. package/js/web/actions.mjs +34 -34
  130. package/js/web/api.mjs +142 -79
  131. package/js/web/catalog.mjs +175 -46
  132. package/js/web/docs.mjs +33 -12
  133. package/js/web/doctor-worker.mjs +14 -0
  134. package/js/web/handler.mjs +16 -5
  135. package/js/web/routes.mjs +24 -22
  136. package/js/web/state.mjs +78 -19
  137. package/js/web/update-check.mjs +27 -12
  138. package/js/web/user-files.mjs +76 -104
  139. package/package.json +7 -4
  140. package/registry.json +48 -55
  141. package/src/AGENT.md.tmpl +13 -14
  142. package/src/agents/_self-improvement.md +1 -1
  143. package/src/agents/_template.md +1 -1
  144. package/src/agents/advocate.md +1 -1
  145. package/src/agents/architect.md +1 -1
  146. package/src/agents/developer.md +1 -1
  147. package/src/agents/devops-engineer.md +1 -1
  148. package/src/agents/docker-expert.md +1 -1
  149. package/src/agents/docs.md +1 -1
  150. package/src/agents/empiricist.md +1 -1
  151. package/src/agents/explorer.md +1 -1
  152. package/src/agents/framer.md +1 -1
  153. package/src/agents/historian.md +1 -1
  154. package/src/agents/kubernetes-specialist.md +1 -1
  155. package/src/agents/memory-curator.md +2 -2
  156. package/src/agents/operator.md +1 -1
  157. package/src/agents/performance.md +1 -1
  158. package/src/agents/pragmatist.md +1 -1
  159. package/src/agents/react-engineer.md +1 -1
  160. package/src/agents/react-reviewer.md +1 -1
  161. package/src/agents/researcher.md +1 -1
  162. package/src/agents/reviewer.md +1 -1
  163. package/src/agents/security.md +1 -1
  164. package/src/agents/skeptic.md +1 -1
  165. package/src/agents/spring-boot-engineer.md +1 -1
  166. package/src/agents/spring-reviewer.md +1 -1
  167. package/src/agents/spring-security.md +1 -1
  168. package/src/agents/steward.md +1 -1
  169. package/src/agents/tester.md +1 -1
  170. package/src/agents/user-advocate.md +1 -1
  171. package/src/agents/visionary.md +1 -1
  172. package/src/memory/README.md +1 -1
  173. package/src/skills/_self-improvement.md +2 -2
  174. package/src/skills/daydream/SKILL.md +2 -2
  175. package/src/skills/daydream/instructions.md +1 -1
  176. package/src/skills/geneseed.md +1 -1
  177. package/src/skills/learn-mode.md +1 -2
  178. package/src/skills/profile.md +2 -2
  179. package/src/skills/rule/approve.md +75 -0
  180. package/src/skills/rule/consolidate.md +3 -3
  181. package/src/skills/rule.md +14 -5
  182. package/src/skills/skill-forge.md +1 -1
  183. package/src/skills/teach.md +29 -12
  184. package/src/skills/wiki.md +1 -1
  185. package/themes/_TEMPLATE.json +1 -2
  186. package/themes/biker.json +1 -2
  187. package/themes/commentator.json +1 -2
  188. package/themes/cyberpunk.json +1 -2
  189. package/themes/gamer.json +1 -2
  190. package/themes/imperial.json +1 -2
  191. package/themes/joker.json +1 -2
  192. package/themes/marvin.json +1 -2
  193. package/themes/mean.json +1 -2
  194. package/themes/military.json +1 -2
  195. package/themes/neutral.json +1 -2
  196. package/themes/pirate.json +1 -2
  197. package/themes/sports.json +1 -2
  198. package/themes/verstappen.json +1 -2
  199. package/themes/wizard.json +1 -2
  200. package/web/dist/assets/Activity-Ci4PZco3.js +1 -0
  201. package/web/dist/assets/ActivityDetail-C8hroCND.js +1 -0
  202. package/web/dist/assets/AgentGlyph-k6o3gCM1.js +1 -0
  203. package/web/dist/assets/Bonsai-C1iBAt4v.js +1 -0
  204. package/web/dist/assets/{CopyButton-C5Li6awl.js → CopyButton-DJ3a4N88.js} +1 -1
  205. package/web/dist/assets/Dashboard-C_On4KXw.js +2 -0
  206. package/web/dist/assets/Docs-Kffdg5uV.js +5 -0
  207. package/web/dist/assets/GreenhouseView-k56_cBSF.js +1 -0
  208. package/web/dist/assets/Installs-DtEKLC9h.js +3 -0
  209. package/web/dist/assets/JournalView-RQnk5l7I.js +1 -0
  210. package/web/dist/assets/Kits-CXkEBpnf.js +1 -0
  211. package/web/dist/assets/Laws-DhhIVqmh.js +3 -0
  212. package/web/dist/assets/Library-CAUiEoJo.js +3 -0
  213. package/web/dist/assets/{Loops-CzitjxGV.js → Loops-LKD8mF4E.js} +2 -2
  214. package/web/dist/assets/{Markdown-C4S4tTA7.js → Markdown-0ORz7tAc.js} +21 -21
  215. package/web/dist/assets/OperatorHudView-CM5jNPwL.js +1 -0
  216. package/web/dist/assets/Personal-B6Uoly3C.js +2 -0
  217. package/web/dist/assets/{RailCats-D5weYPCS.js → RailCats-DQxxYBEP.js} +1 -1
  218. package/web/dist/assets/Settings-BTe6-wda.js +1 -0
  219. package/web/dist/assets/Tabs-CbdDWTp_.js +1 -0
  220. package/web/dist/assets/api-D_r0Jtla.js +1 -0
  221. package/web/dist/assets/controls-D4wmg_pl.js +1 -0
  222. package/web/dist/assets/index-HfGmYXab.js +3 -0
  223. package/web/dist/assets/index-ao3M-Fhm.css +1 -0
  224. package/web/dist/assets/motion-RlUl1osO.js +1 -0
  225. package/web/dist/assets/{sections-ChwaobfW.js → sections-CtFz7HFH.js} +1 -1
  226. package/web/dist/index.html +5 -5
  227. package/src/skills/quiz.md +0 -44
  228. package/web/dist/assets/Activity-Bjy64wHC.js +0 -1
  229. package/web/dist/assets/ActivityDetail-B0AaipP8.js +0 -1
  230. package/web/dist/assets/Bonsai-CJniRqaH.js +0 -1
  231. package/web/dist/assets/Dashboard-B-6DTmae.js +0 -2
  232. package/web/dist/assets/Docs-LRc30XL9.js +0 -5
  233. package/web/dist/assets/GreenhouseView-CcoYlaWo.js +0 -1
  234. package/web/dist/assets/Installs-dp1epTcE.js +0 -3
  235. package/web/dist/assets/JournalView-nFP4poCf.js +0 -1
  236. package/web/dist/assets/KitApply-DwyZUj57.js +0 -1
  237. package/web/dist/assets/Kits-C0IEdZXe.js +0 -1
  238. package/web/dist/assets/Laws-CkykmQWu.js +0 -3
  239. package/web/dist/assets/Library-Guh9HBZU.js +0 -2
  240. package/web/dist/assets/OperatorHudView-DLGNulIY.js +0 -1
  241. package/web/dist/assets/Personal-BMtberL8.js +0 -2
  242. package/web/dist/assets/Tabs-uYJqfuQt.js +0 -1
  243. package/web/dist/assets/api-BxjLd7Qd.js +0 -1
  244. package/web/dist/assets/index-DA7BiaE5.js +0 -3
  245. package/web/dist/assets/index-dbbDGFDq.css +0 -1
  246. package/web/dist/assets/motion-Bccx3zE8.js +0 -1
package/src/AGENT.md.tmpl CHANGED
@@ -44,8 +44,8 @@ it as your very first tool call — before loading context, reading files, or se
44
44
  **Session start.** The harness hook injects your session files (any still at its seed is
45
45
  skipped) and the `eager` entries of `context.json`. If no `=== SESSION FILES ===` or
46
46
  `=== PROJECT CONTEXT ===` block is in your context, read them yourself first:
47
- `{{AT_HARNESS}}user-rules.md`, `{{AT_HARNESS}}PROFILE.md`, `{{DIR_MEMORY}}/MEMORY.md`,
48
- `{{DIR_NOTEBOOK}}/NOTEBOOK.md`, `{{AT_HARNESS}}geneseed-wiki.jsonc`, `{{AT_HARNESS}}context.json`.
47
+ `{{PATH_RULES}}`, `{{PATH_PROFILE}}`, `{{PATH_MEMORY}}/MEMORY.md`,
48
+ `{{DIR_NOTEBOOK}}/NOTEBOOK.md`, `{{PATH_WIKI}}`, `{{AT_HARNESS}}context.json`.
49
49
 
50
50
  **Response voice.** {{VOICE}} This sets *tone and vocabulary* — the section *layout*,
51
51
  the law *numbers*, file paths, and folder names stay plain English so tooling and links
@@ -60,7 +60,7 @@ never move.
60
60
  | 3 | The {{ONTOLOGY}} | never against a user rule |
61
61
  | 4 | The active {{DOCTRINES}} (§2) | may tighten, never repeal |
62
62
  | 5 | The mode | binds how work runs |
63
- | 6 | `PROFILE.md`, posture, theme | inform only; never bind |
63
+ | 6 | `PROFILE.md`, posture, theme | inform only; never bind |{{RULE_LAYERS_LINE}}
64
64
 
65
65
  ---
66
66
 
@@ -110,7 +110,7 @@ workers get only approved decisions.{{OWNERSHIP_PROPOSAL}}
110
110
 
111
111
  <!-- INCLUDE: laws/universal.md -->
112
112
 
113
- **The user's own rules.** `{{AT_HARNESS}}user-rules.md` (a session file) holds the
113
+ **The user's own rules.** `{{PATH_RULES}}` (a session file) holds the
114
114
  user's own rules: obey every rule in it with the same force as the {{LAWS}} above
115
115
  — always, in every task (its rank is in the precedence table above). That file belongs
116
116
  to the user — the build seeds it once, never overwrites it, and no update touches
@@ -121,7 +121,7 @@ append it there with the user's consent (the [rule]({{DIR_SKILLS}}/rule.md)
121
121
  add, edit, or remove a {{DOCTRINE}} rule in §2 — both are regenerated on every
122
122
  update, and an edit to either is silently lost.
123
123
 
124
- **The user's profile.** `{{AT_HARNESS}}PROFILE.md` (a session file) colours how you
124
+ **The user's profile.** `{{PATH_PROFILE}}` (a session file) colours how you
125
125
  work — who the user is, how they work, the register they prefer. Unlike `user-rules.md`,
126
126
  it is *identity, not rules*: it never binds,
127
127
  it only informs. It too belongs to the user: seeded once, never overwritten. Never
@@ -192,7 +192,7 @@ contract you do not already know.
192
192
  {{AGENT}} that *writes* must return a summary of exactly what it changed. Every
193
193
  {{AGENT}} spec ends with a **self-improvement loop**: when a report carries a
194
194
  `spec-feedback:` line, weigh it — record a real flaw (with the user's assent) in
195
- `{{DIR_NOTEBOOK}}/agent-notes/<name>.md` and pass it to later dispatches;
195
+ `{{PATH_NOTES}}/agent-notes/<name>.md` and pass it to later dispatches;
196
196
  {{MEMORY}} gets a record only when it clears {{DOCTRINE:persist-insight}}'s bar.
197
197
 
198
198
  <!-- LEAN:begin -->
@@ -242,8 +242,7 @@ the ten council seats are convened by the [council {{SKILL}}]({{DIR_SKILLS}}/cou
242
242
  | [document-project]({{DIR_SKILLS}}/document-project.md) | missing/drifted docs, or a PRD, design system, architecture doc or AGENTS.md; orienting to the repo, or refreshing its map after the structure changed |
243
243
  | [ingest]({{DIR_SKILLS}}/ingest.md) | a task needs content from a PDF, Office doc, or URL |
244
244
  | [research]({{DIR_SKILLS}}/research.md) | a question needs answers gathered and verified from the open web |
245
- | [teach]({{DIR_SKILLS}}/teach.md) | the user wants to be taught — a crash course, confusing material decoded, or a day-by-day path to a deadline |
246
- | [quiz]({{DIR_SKILLS}}/quiz.md) | the user wants what they know tested, not explained — a drill, an explain-it-back check, or a mastery claim probed for gaps |
245
+ | [teach]({{DIR_SKILLS}}/teach.md) | the user wants to be taught — a crash course, confusing material decoded, or a day-by-day path to a deadline — or tested, not lectured: a drill, an explain-it-back check, or a mastery claim probed for gaps |
247
246
  | [learn-mode]({{DIR_SKILLS}}/learn-mode.md) | the user wants to learn while building — they design, you code what they approve |
248
247
  | [ownership]({{DIR_SKILLS}}/ownership.md) | the developer must own production code — they decide each part at a granularity the team sets, from the root AGENTS.md |
249
248
  | [commit]({{DIR_SKILLS}}/commit.md) | staging and writing a commit |
@@ -294,7 +293,7 @@ inventory — that list is the catalogue and it is authoritative. Each written
294
293
  procedure is in [`{{DIR_SKILLS}}/`]({{DIR_SKILLS}}/) and the host loads it on
295
294
  demand.
296
295
  <!-- CATALOG:end -->
297
- {{EXCLUDED_SKILLS_LINE}}{{KITS_LINE}}
296
+ {{EXCLUDED_SKILLS_LINE}}{{KITS_LINE}}{{SHARED_TIER_LINE}}
298
297
  When a task repeats and no {{SKILL}} covers it, forge one through the
299
298
  [skill-forge]({{DIR_SKILLS}}/skill-forge.md) {{SKILL}}: copy
300
299
  [`{{DIR_SKILLS}}/_template.md`]({{DIR_SKILLS}}/_template.md), keep it to one coherent
@@ -309,12 +308,12 @@ the file, or to {{MEMORY}} ({{DOCTRINE:persist-insight}}).
309
308
  *{{EPI_MEMORY}}*
310
309
 
311
310
  <!-- LEAN:begin -->
312
- Persistent facts live in [`{{DIR_MEMORY}}/`]({{DIR_MEMORY}}/) — one fact per file, indexed by a
311
+ Persistent facts live in {{LINK_MEMORY}} — one fact per file, indexed by a
313
312
  local `MEMORY.md`, a session file (**Session start**, above); write a new memory
314
313
  whenever the conversation yields a durable fact, a correction, or a decision worth
315
314
  keeping — through the [rule]({{DIR_SKILLS}}/rule.md) {{SKILL}}, which settles with
316
315
  the user whether it is a memory or a standing rule before either is written
317
- ({{DOCTRINE:persist-insight}}). The `{{DIR_MEMORY}}/` directory is **personal and git-ignored** — it is
316
+ ({{DOCTRINE:persist-insight}}). The `{{PATH_MEMORY}}/` directory is **personal and git-ignored** — it is
318
317
  never committed or shared; to share knowledge, put it in code, docs, or the
319
318
  project's `user-rules.md` (§1). When the same feedback lesson keeps recurring,
320
319
  propose promoting it into a standing rule — the [rule]({{DIR_SKILLS}}/rule.md)
@@ -325,7 +324,7 @@ evidence contradicts one, revise it rather than ignore it, and never overturn a
325
324
  the session — memory, notebook, notes, commits, docs — cite a rule by its principle
326
325
  ("Verify Before Asserting"), never its number: numbers are positional. Full convention: [`{{DIR_MEMORY}}/README.md`]({{DIR_MEMORY}}/README.md).
327
326
  <!-- LEAN:else -->
328
- Durable facts live in [`{{DIR_MEMORY}}/`]({{DIR_MEMORY}}/), one per file, indexed by
327
+ Durable facts live in {{LINK_MEMORY}}, one per file, indexed by
329
328
  `MEMORY.md`, a session file. Write one through the
330
329
  [rule]({{DIR_SKILLS}}/rule.md) {{SKILL}}, which settles with the user whether a
331
330
  lesson is a memory or a standing rule ({{DOCTRINE:persist-insight}}). The directory is
@@ -415,7 +414,7 @@ It receives only the task's deliverables; your working files go in the {{NOTEBOO
415
414
  *{{EPI_WIKI}}*
416
415
 
417
416
  <!-- LEAN:begin -->
418
- {{INTRO_WIKI}} It is declared in `{{AT_HARNESS}}geneseed-wiki.jsonc`, a session file — or
417
+ {{INTRO_WIKI}} It is declared in `{{PATH_WIKI}}`, a session file — or
419
418
  wherever `$GENESEED_WIKI` points. An empty `wikis` list means none is declared and this
420
419
  section stays dormant. (On OpenCode its `eager` entries are loaded for you.)
421
420
 
@@ -442,7 +441,7 @@ durable fact worth sharing across projects goes here via the
442
441
  [wiki]({{DIR_SKILLS}}/wiki.md) {{SKILL}}; one that matters only to you stays in
443
442
  {{MEMORY}} (§5).
444
443
  <!-- LEAN:else -->
445
- {{INTRO_WIKI}} Declared in `{{AT_HARNESS}}geneseed-wiki.jsonc`, a session file (or at
444
+ {{INTRO_WIKI}} Declared in `{{PATH_WIKI}}`, a session file (or at
446
445
  `$GENESEED_WIKI`; an empty `wikis` list means dormant) — honour each wiki: load `entries` by `load` mode as in `context.json` (§9), read
447
446
  `conventions` before your first write there, drop an unplaceable note in `inbox`,
448
447
  never write inside `protected`. It is the user's: wikilinks over bare paths, every
@@ -5,7 +5,7 @@ that proved wrong, a step you could not execute — end your report with one lin
5
5
  `spec-feedback: [agent|general] <the one-line fix> — seen: <what happened, against
6
6
  what this spec led you to expect>`. `general` marks a fix other {{AGENTS}} need too.
7
7
  Omit the line when there is no friction. The caller weighs the feedback and, with the
8
- user's assent, writes a real flaw, dated, into `{{DIR_NOTEBOOK}}/agent-notes/<name>.md`
8
+ user's assent, writes a real flaw, dated, into `{{PATH_NOTES}}/agent-notes/<name>.md`
9
9
  — never into this rendered file, which a rebuild overwrites — and hands those notes
10
10
  to every later dispatch of this {{AGENT}}. It records the feedback to {{MEMORY}} only if it clears
11
11
  {{DOCTRINE:persist-insight}}'s bar — most reports carry no feedback at all.
@@ -42,7 +42,7 @@
42
42
  write-capable {{AGENT}}'s spec must not contain it, or its emit is locked down.
43
43
 
44
44
  ## Procedure
45
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists in the harness, read it first —
45
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists in the harness, read it first —
46
46
  it holds your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
47
47
  1. Step-by-step method this {{AGENT}} follows.
48
48
 
@@ -17,7 +17,7 @@
17
17
  - **Read-only.** Search and read, to ground the case in the real artifact. Never edits, never runs commands, never casts the verdict.
18
18
 
19
19
  ## Procedure
20
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
20
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
21
21
  1. Read the motion and the artifact so the case is concrete, not abstract ({{DOCTRINE:read-the-docs-first}}).
22
22
  2. Steelman the proposal: make its strongest case — the upside, the opportunity, the cost of *not* acting ({{ONTOLOGY}}: {{ONT_CONDUCT}}).
23
23
  3. Name the single objection the proposal must survive, and answer it; concede only what is genuinely indefensible.
@@ -22,7 +22,7 @@
22
22
  <!-- bash: allow -->
23
23
 
24
24
  ## Procedure
25
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
25
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
26
26
  1. Establish the current state: data shapes, module boundaries, existing patterns.
27
27
  2. Propose 2–3 approaches with trade-offs; recommend one with reasoning.
28
28
  3. Break the chosen approach into isolated units, each with one purpose and a
@@ -29,7 +29,7 @@
29
29
  commits once the user accepts.
30
30
 
31
31
  ## Procedure
32
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
32
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
33
33
  1. Implement the smallest change that satisfies the scoped task ({{DOCTRINE:smallest-viable-diff}}) —
34
34
  in the assigned worktree only, never touching the parent's own tree. In ownership mode,
35
35
  write only what the approved decisions cover; on a choice none of them covers, stop and
@@ -21,7 +21,7 @@ Builds CI/CD pipelines and delivery automation for Spring Boot applications.
21
21
  - Never commits, pushes or triggers a deployment ({{DOCTRINE:consent-before-push}}).
22
22
 
23
23
  ## Procedure
24
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
24
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
25
25
  1. Detect the CI the project already uses (GitHub Actions, GitLab CI, Jenkins, other) and extend it; do not switch providers. With none present, ask the user which to use.
26
26
  2. Pipeline order: checkout, restore build cache, `./mvnw verify` (or `./gradlew build`), publish test results, build image, scan, push, deploy.
27
27
  3. Cache the Maven or Gradle repository keyed on the build files.
@@ -21,7 +21,7 @@ Builds small, safe container images for Spring Boot 4 applications.
21
21
  - Never pushes images or commits ({{DOCTRINE:consent-before-push}}).
22
22
 
23
23
  ## Procedure
24
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
24
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
25
25
  1. Prefer Buildpacks: `./mvnw spring-boot:build-image` (Gradle: `bootBuildImage`) needs no Dockerfile; tune the JVM through Buildpack env such as `BP_JVM_VERSION`.
26
26
  2. Use a Dockerfile only when Buildpacks do not fit. Build multi-stage and extract layers with `java -Djarmode=tools -jar app.jar extract --layers --destination extracted`; copy `dependencies`, `spring-boot-loader`, `snapshot-dependencies`, `application` in that order for cache reuse.
27
27
  3. Run as a non-root user; pin base image tags or digests, never `latest`.
@@ -19,7 +19,7 @@
19
19
  may run documented examples and commands to confirm they work as written.
20
20
 
21
21
  ## Procedure
22
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
22
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
23
23
  1. Read the actual code/behaviour before describing it — never document intent
24
24
  that the code does not implement ({{LAW:verify-before-asserting}}).
25
25
  2. Write for the stated audience; lead with what the reader needs to do.
@@ -20,7 +20,7 @@
20
20
  <!-- bash: allow -->
21
21
 
22
22
  ## Procedure
23
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
23
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
24
24
  1. Read the motion and the arguments, then list the load-bearing claims on both sides ({{DOCTRINE:read-the-docs-first}}).
25
25
  2. Mark each claim evidenced or unevidenced — and call out any asserted as fact without a source ({{LAW:verify-before-asserting}}).
26
26
  3. For the decisive unknowns, name the cheapest experiment, benchmark, or check that would settle them.
@@ -24,7 +24,7 @@
24
24
  <!-- bash: allow -->
25
25
 
26
26
  ## Procedure
27
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
27
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
28
28
  1. Search to locate the relevant files before reading them ({{DOCTRINE:context-economy}}).
29
29
  2. Read only the slices that matter; follow references outward as needed.
30
30
  3. Synthesize — return findings, not raw dumps.
@@ -17,7 +17,7 @@
17
17
  - **Read-only.** Search and read, to ground the reframe in the real need. Never edits, never runs commands, never casts the verdict.
18
18
 
19
19
  ## Procedure
20
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
20
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
21
21
  1. Read the motion and what prompted it, then restate the underlying need in one plain sentence ({{DOCTRINE:read-the-docs-first}}).
22
22
  2. Test whether the motion addresses that need or only a symptom of it; ask what problem it would leave unsolved.
23
23
  3. If the framing is off, offer the reframed problem — the question the council should actually be debating.
@@ -20,7 +20,7 @@
20
20
  <!-- bash: allow -->
21
21
 
22
22
  ## Procedure
23
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
23
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
24
24
  1. Read the motion, then search the codebase, changelog, and docs for prior attempts, reverts, and related decisions ({{DOCTRINE:read-the-docs-first}}).
25
25
  2. Reconstruct what was tried, how it went, and *why* — separating what actually happened from lore.
26
26
  3. Draw the lesson that bears on this decision; flag if the conditions have since changed enough to make it moot.
@@ -21,7 +21,7 @@ Deploys Spring Boot 4 applications on Kubernetes.
21
21
  - Never applies to a live cluster and never pushes without the user's say-so ({{DOCTRINE:consent-before-push}}).
22
22
 
23
23
  ## Procedure
24
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
24
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
25
25
  1. Match the project's manifest style; do not introduce a new tool.
26
26
  2. Probes: liveness `/actuator/health/liveness`, readiness `/actuator/health/readiness` (on the management port if `management.server.port` is set); add a startup probe for slow starts. Boot exposes these health groups by default; `management.endpoint.health.probes.enabled=false` turns them off.
27
27
  3. Shutdown: `server.shutdown=graceful` with `spring.lifecycle.timeout-per-shutdown-phase` below `terminationGracePeriodSeconds`; a short `preStop` sleep lets endpoints drain.
@@ -15,7 +15,7 @@
15
15
  rule {{SKILL}}.
16
16
 
17
17
  ## Inputs
18
- - The path of the {{MEMORY}} store (`{{DIR_MEMORY}}/`), and the user's standing on
18
+ - The path of the {{MEMORY}} store (`{{PATH_MEMORY}}/`), and the user's standing on
19
19
  scope: the whole store, or named topics only.
20
20
 
21
21
  ## Allowed tools
@@ -28,7 +28,7 @@
28
28
  approved by code ({{LAW:deletion-is-deliberate}}).
29
29
 
30
30
  ## Procedure
31
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
31
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
32
32
  1. Read the map (`MEMORY.md`), then one topic file at a time, then only the facts
33
33
  that topic needs ({{DOCTRINE:context-economy}}). On a large store, work topic by
34
34
  topic and report progress after each one (`3/14 topics: 4 merged, 2 archived`).
@@ -18,7 +18,7 @@
18
18
  - **Read-only.** Search and read, to judge operability against the real system. Never edits, never runs commands, never casts the verdict.
19
19
 
20
20
  ## Procedure
21
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
21
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
22
22
  1. Read the motion and how it would run, so the concerns are this system's, not generic ({{DOCTRINE:read-the-docs-first}}).
23
23
  2. Pre-mortem the 3am incident: how it fails under load, whether you can see it failing (metrics, logs), and how you roll it back. Treat a production deploy with no tested rollback or fix-forward path and no retained previous artifact as not ready to ship — there must be a way back before there is a way out.
24
24
  3. Weigh the standing cost — the on-call burden, the toil, the new ways to be paged — against the benefit.
@@ -25,7 +25,7 @@
25
25
  <!-- bash: allow -->
26
26
 
27
27
  ## Procedure
28
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
28
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
29
29
  1. Pin the question: which metric (wall time, p95 latency, peak memory, allocations,
30
30
  query count), under which workload, and what number would count as fixed.
31
31
  2. Take a baseline with the project's own tooling where it has some, run several
@@ -18,7 +18,7 @@
18
18
  - **Read-only.** Search and read, to size the work against the real codebase. Never edits, never runs commands, never casts the verdict.
19
19
 
20
20
  ## Procedure
21
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
21
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
22
22
  1. Read the motion and the artifact so the estimate is grounded, not guessed ({{DOCTRINE:read-the-docs-first}}).
23
23
  2. Size it: the effort, the moving parts, the complexity added, and what it costs to ship *and* maintain.
24
24
  3. Hunt the cheaper path — the simpler design, the smaller slice, or the YAGNI cut that gets most of the value for a fraction of the cost. Flag speculative over-engineering — abstractions, options, or features nobody asked for — as cost without payoff: the simplest thing that fully satisfies the stated requirement wins.
@@ -22,7 +22,7 @@ Implements React features in a Vite or webpack app, TypeScript or JavaScript, fo
22
22
  - Never commits or pushes ({{DOCTRINE:consent-before-push}}).
23
23
 
24
24
  ## Procedure
25
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
25
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
26
26
  1. Read `package.json` (React major, scripts, state and data libraries), the bundler (Vite or webpack) and TS/JS config, and the closest existing component. Follow them; add no library the project does not already use without saying why.
27
27
  2. Keep the folder's language: `.tsx` with typed props and no `any`, or `.jsx`.
28
28
  3. Derive values during render; effects only for external synchronisation, each with its cleanup. Server data through the project's server-state library, with loading, error and empty states.
@@ -22,7 +22,7 @@ React-specific review only. Generic correctness, naming and structure belong to
22
22
  <!-- bash: allow -->
23
23
 
24
24
  ## Procedure
25
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
25
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
26
26
  1. Read the changed files and `package.json` for the React major. Run lint and, for TypeScript, the typecheck; a missing `react-hooks/rules-of-hooks` or `react-hooks/exhaustive-deps` rule is itself a finding.
27
27
  2. Check, in this order:
28
28
  - Security: `dangerouslySetInnerHTML` without a sanitiser at the call site; a user-supplied URL in `href`/`src` without a scheme check; a secret in a bundler-inlined env value (`import.meta.env.VITE_*`, webpack `DefinePlugin`); a session token in `localStorage`.
@@ -33,7 +33,7 @@
33
33
  ({{LAW:data-not-orders}}).
34
34
 
35
35
  ## Procedure
36
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
36
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
37
37
  1. Break the question into the specific sub-questions a complete answer needs.
38
38
  2. Search from several angles ({{DOCTRINE:tool-discovery}}); one search is not research
39
39
  and one empty result is not absence ({{LAW:verify-before-asserting}}).
@@ -22,7 +22,7 @@
22
22
  <!-- bash: allow -->
23
23
 
24
24
  ## Procedure
25
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
25
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
26
26
  1. Confirm the change actually does what the task required (read the spec/issue). Where
27
27
  the spec is silent, judge by what a reasonable user would expect: a crash, hang or data
28
28
  loss on an input the spec implies but never names is blocking, not a nitpick.
@@ -18,7 +18,7 @@
18
18
  <!-- bash: allow -->
19
19
 
20
20
  ## Procedure
21
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
21
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
22
22
  1. Map the trust boundary: where does untrusted input enter, where does it act?
23
23
  2. Check for the common classes: injection, broken auth/authz, secret exposure,
24
24
  unsafe deserialization, path traversal, vulnerable dependencies.
@@ -18,7 +18,7 @@
18
18
  - **Read-only.** Search and read, to ground each objection in the real artifact. Never edits, never runs commands, never casts the verdict.
19
19
 
20
20
  ## Procedure
21
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
21
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
22
22
  1. Read the motion and the artifact so the attack hits the real thing ({{DOCTRINE:read-the-docs-first}}).
23
23
  2. Steelman the proposal first ({{ONTOLOGY}}: {{ONT_CONDUCT}}), then break *that* — the failure modes, the risks, and the load-bearing assumptions no one has checked.
24
24
  3. Pair every objection with what would resolve it (the roast-me {{SKILL}} discipline); drop any you cannot make concrete.
@@ -22,7 +22,7 @@ Implements Spring Boot 4 / Java 21+ features, following the spring-boot, spring-
22
22
  - Never commits or pushes ({{DOCTRINE:consent-before-push}}).
23
23
 
24
24
  ## Procedure
25
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
25
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
26
26
  1. Follow the project's existing layout and build tool; match its group id, packages and CI. Lombok is fine when the project already uses it.
27
27
  2. Constructor injection; records for request and response DTOs; `@Valid` on request bodies; one `@RestControllerAdvice` for errors.
28
28
  3. Services: `@Transactional(readOnly = true)` on the class, `@Transactional` on mutating methods. Never call a transactional or `@Async` method through `this`.
@@ -22,7 +22,7 @@ Spring-specific review only. Generic correctness, naming and structure belong to
22
22
  <!-- bash: allow -->
23
23
 
24
24
  ## Procedure
25
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
25
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
26
26
  1. Read the changed files and the build file to learn the Boot version.
27
27
  2. Check, in this order:
28
28
  - Injection: field `@Autowired`, circular dependencies.
@@ -21,7 +21,7 @@ Spring Security 7 audit only. The generic audit (injection, secrets, dependencie
21
21
  <!-- bash: allow -->
22
22
 
23
23
  ## Procedure
24
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
24
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
25
25
  1. Read the `SecurityFilterChain` beans first, then method-security usage and config files.
26
26
  2. Check:
27
27
  - Filter chain: a bean, never `WebSecurityConfigurerAdapter`; `authorizeHttpRequests` ends in `anyRequest().authenticated()` or `denyAll()`; only health and login endpoints open.
@@ -17,7 +17,7 @@
17
17
  - **Read-only.** Search and read, to judge fit against the real system. Never edits, never runs commands, never casts the verdict.
18
18
 
19
19
  ## Procedure
20
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
20
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
21
21
  1. Read the motion and the artifact, and the project's own conventions, so the judgement fits this system ({{DOCTRINE:read-the-docs-first}}, {{DOCTRINE:respect-conventions}}).
22
22
  2. Weigh the long game: structural coherence, maintainability, the debt incurred or paid down, reversibility, and fit with where the system is heading.
23
23
  3. Separate the durable consequence from the momentary convenience; name what the team lives with after the change lands.
@@ -18,7 +18,7 @@
18
18
  - Does not change production code; if a fix is needed, it reports the diagnosis.
19
19
 
20
20
  ## Procedure
21
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
21
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
22
22
  1. For new tests: write the test, watch it fail with the behaviour absent or
23
23
  deliberately broken, then confirm it passes against the implementation —
24
24
  a test that has never failed verifies nothing ({{LAW:verify-before-asserting}}).
@@ -17,7 +17,7 @@
17
17
  - **Read-only.** Search and read, to ground the consumer's view in the real interface. Never edits, never runs commands, never casts the verdict.
18
18
 
19
19
  ## Procedure
20
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
20
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
21
21
  1. Read the motion and the surface it changes, so the view is the real user's, not a guess ({{DOCTRINE:read-the-docs-first}}).
22
22
  2. Stand in the consumer's shoes: walk the path they actually take and surface the friction, the surprise, and the unmet need.
23
23
  3. Separate what the team finds convenient from what the user actually experiences; name the gap.
@@ -17,7 +17,7 @@
17
17
  - **Read-only.** Search and read, to ground the vision in what exists. Never edits, never runs commands, never casts the verdict.
18
18
 
19
19
  ## Procedure
20
- 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
20
+ 0. If `{{PATH_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
21
21
  1. Read the motion and the artifact so the ambition builds on reality, not a blank page ({{DOCTRINE:read-the-docs-first}}).
22
22
  2. Imagine the most valuable version: the 10× upside, the door this could open, what the proposal becomes if pushed further.
23
23
  3. Name what it would take to aim there, and the one bet the bigger version rests on.
@@ -4,7 +4,7 @@
4
4
  > to each developer, never committed or shared. The convention (`README.md`) and
5
5
  > the `.gitignore` are the only files tracked; your `MEMORY.md` index and all
6
6
  > fact files live only on your machine. (To share knowledge with the team, put
7
- > it in code, docs, or the project's `user-rules.md` instead.)
7
+ > it in code, docs, or the project's `user-rules.md` instead.){{SHARED_STORE_NOTE}}
8
8
 
9
9
  Durable knowledge that must survive across sessions lives here as **one fact per
10
10
  file**. An agent reads `MEMORY.md` (the local index map) at the start of a session,
@@ -1,7 +1,7 @@
1
1
  ## Self-improvement
2
2
 
3
3
  <!-- LEAN:begin -->
4
- This {{SKILL}} keeps its own notes in `{{DIR_NOTEBOOK}}/skill-notes/<name>.md`,
4
+ This {{SKILL}} keeps its own notes in `{{PATH_NOTES}}/skill-notes/<name>.md`,
5
5
  `<name>` being this {{SKILL}}'s name. When that file exists, read it before the
6
6
  first step — where it disagrees with this file, the notes win. They are yours to
7
7
  write, and no rebuild touches them.
@@ -27,7 +27,7 @@ Close each run with one beat of reflection on the {{SKILL}} itself:
27
27
  <!-- LEAN:else -->
28
28
  One beat of reflection on this {{SKILL}}: a step that misled, a missing step, or a
29
29
  wrong trigger is a flaw in this file — write the exact correction, with the user's
30
- assent ({{LAW:one-intent-one-act}}), into `{{DIR_NOTEBOOK}}/skill-notes/<name>.md` (`<name>` is this {{SKILL}}'s
30
+ assent ({{LAW:one-intent-one-act}}), into `{{PATH_NOTES}}/skill-notes/<name>.md` (`<name>` is this {{SKILL}}'s
31
31
  name) as `- [skill|general] <correction> — seen: <what happened vs expected> (<date>)`,
32
32
  never into this rendered file, which a rebuild overwrites. Read that notes
33
33
  file before the first step when it exists; it wins where it disagrees. Keep it short.
@@ -23,7 +23,7 @@ procedure; this one is the overview.
23
23
 
24
24
  Before the first run, make sure the pieces this skill depends on are in place:
25
25
 
26
- 1. **A vault to mine.** Declare your Obsidian vault in the harness `geneseed-wiki.jsonc`
26
+ 1. **A vault to mine.** Declare your Obsidian vault in `geneseed-wiki.jsonc`, beside the harness{{WIKI_TIER}}
27
27
  (AGENT.md §8) — give a `wikis[]` entry a `path` to the vault root. Without it the
28
28
  skill falls back to detecting a `.obsidian/` folder in the current directory, then
29
29
  asks. No vault → nothing to daydream about.
@@ -46,7 +46,7 @@ Glob/Read/Write/Bash and subagent tools. See [VENDOR.md](VENDOR.md) for provenan
46
46
 
47
47
  ## What it does
48
48
 
49
- 1. Resolves vault root from the harness `geneseed-wiki.jsonc` manifest (a declared vault's `path`); falls back to auto-detecting `.obsidian/` from the current directory, then asks if still unfound
49
+ 1. Resolves vault root from the `geneseed-wiki.jsonc` manifest beside the harness{{WIKI_TIER}} (a declared vault's `path`); falls back to auto-detecting `.obsidian/` from the current directory, then asks if still unfound
50
50
  2. Scans vault for notes modified in last 120 days
51
51
  2. Generates 50 recency-weighted random pairs
52
52
  3. Synthesizes connections (Sonnet, parallel batches of 5)
@@ -5,7 +5,7 @@ You are running the Vault Daydream skill. Follow these steps precisely.
5
5
  ## Step 0: Resolve Vault Root
6
6
 
7
7
  Determine `VAULT_ROOT`:
8
- 1. **Geneseed `geneseed-wiki.jsonc` first.** Look for `geneseed-wiki.jsonc` beside the harness `AGENT.md` (or at `$GENESEED_WIKI`). Strip `//` and `/* */` comments, parse it, and take the first `wikis[].path` whose root exists on disk — that is the vault. Prefer a declared vault whose `path` contains a `.obsidian/` folder; if several qualify, ask which to use. (This is Geneseed's machine-wide knowledge-base manifest — see AGENT.md's Wiki section.)
8
+ 1. **Geneseed `geneseed-wiki.jsonc` first.** Look for `geneseed-wiki.jsonc` beside the harness `AGENT.md` (or at `$GENESEED_WIKI`){{WIKI_TIER}}. Strip `//` and `/* */` comments, parse it, and take the first `wikis[].path` whose root exists on disk — that is the vault. Prefer a declared vault whose `path` contains a `.obsidian/` folder; if several qualify, ask which to use. (This is Geneseed's machine-wide knowledge-base manifest — see AGENT.md's Wiki section.)
9
9
  2. Otherwise, check if the current working directory contains a `.obsidian/` folder. If yes, use it as `VAULT_ROOT`.
10
10
  3. If still unresolved, use `AskUserQuestion` to ask:
11
11
  - Question: "Where is your Obsidian vault located?"
@@ -11,7 +11,7 @@
11
11
  3. **Read a piece** from disk, not from recall ({{LAW:verify-before-asserting}}): `<root>/agents/<name>.md`, `<root>/skills/<name>/SKILL.md`, `<root>/memory/`, `<root>/notebook/`. The {{ONTOLOGY}}, the {{LAWS}} and the active {{DOCTRINES}} are numbered `## N. …` sections of the install's root file.
12
12
  4. **Change an install only when the user asked for that change** ({{LAW:one-intent-one-act}}). Take that install's `rebuild` command from step 1, edit only the flag the user named (add it if the command omits it — `--posture`, `--mode` and `--trust` are left out at their defaults) — `--theme`, `--footprint lean|full`, `--posture`, `--mode direct|foreman`, `--trust prudent|balanced|aggressive`, `--doctrines craft,rigor|none`, `--exclude-rules "process 7"|none` — dry-run it first by running the same flags through `geneseed validate`, show the command, and run it once the user agrees. Never rebuild from a bare `geneseed build`: every omitted flag resets that setting to the generator default. Confirm with `geneseed status`.
13
13
  5. **Other writes also need the user's word:** `geneseed memory rm <name>` (archives; `--purge` deletes for good), `geneseed exclude add|remove <path>`, `geneseed web start|stop`, `geneseed uninstall --target <root> --yes`. Personal rules and the profile belong to their own {{SKILLS}}; do not edit `user-rules.md` or `PROFILE.md` from here.
14
- 6. **Never on your own initiative:** `geneseed setup` (interactive only), `geneseed upgrade`, `geneseed update`, `geneseed bootstrap`, `geneseed sync-self`, `geneseed rebuild-all`, `geneseed migrate`, `geneseed link`, `geneseed unlink`. `learn`, `context` and the `*-gate` verbs are `geneseed-hook` verbs the host's hooks run — never run them by hand.
14
+ 6. **Never on your own initiative:** `geneseed setup` (interactive only), `geneseed upgrade`, `geneseed update`, `geneseed bootstrap`, `geneseed rebuild-all`, `geneseed migrate`, `geneseed link`, `geneseed unlink`. `learn`, `context` and the `*-gate` verbs are `geneseed-hook` verbs the host's hooks run — never run them by hand.
15
15
  7. Directory and section names are plain English in every theme; only prose changes. Do not search by flavour words.
16
16
  8. **Custom OpenCode colour theme** (a different concept from the `--theme` package name in step 4 — that one changes the agent's *voice*, this one its terminal colours): clone a shipped palette (`catppuccin tokyonight rosepine gruvbox nord everforest kanagawa dracula`) or derive one from a described vibe, filling all 19 roles in `themes/opencode/README.md` (`bg bgPanel bgElement fg fgMuted accent secondary border ok warn err kw str fn num type comment addBg delBg`) as `#rrggbb` hex. Keep `fg` on `bg` readable (~7:1), `error` red-family, `warning` amber, `success` green, and `addBg`/`delBg` distinct from each other and the background. Write the overrides to a small JSON (`{role: "#hex", …}` or `{"palette": {…}}`) and run `geneseed theme <name> --from <shipped> --palette <file.json>` — either flag alone works, both together lets the palette override the cloned base; `--solid-only`/`--transparent-only` for one flavour, `--global` to force the global dir from inside a repo. Tell the user to select it with `/theme geneseed-<name>` (opaque) or `/theme geneseed-<name>-transparent` (terminal background shows through) — a rebuild never erases it.
17
17
 
@@ -9,8 +9,7 @@
9
9
  **Trigger:** the user wants to *learn while building* rather than be handed finished code.
10
10
  Phrases: "learn mode", "turn on learning", "I want to understand what we build", "let me design it,
11
11
  you write it". Also "pause learning" / "resume learning" / "stop learn mode". To be taught a
12
- topic outside a build, use the [teach {{SKILL}}](teach.md); to have knowledge tested, the
13
- [quiz {{SKILL}}](quiz.md).
12
+ topic outside a build, use the [teach {{SKILL}}](teach.md), which also tests what you know.
14
13
 
15
14
  The user is the engineer and owns the decisions; you write the code for the design they
16
15
  chose and understand. Learning and the user's control outrank build speed.
@@ -7,7 +7,7 @@ the untouched stub. Phrases: "set up my profile", "create my profile", "update m
7
7
  profile". Also when an existing profile visibly contradicts how the user now works.
8
8
 
9
9
  ## Procedure
10
- 1. Locate `PROFILE.md` beside the deployed AGENT.md and read it ({{LAW:verify-before-asserting}} — the
10
+ 1. Locate {{PROFILE_LOCATION}} and read it ({{LAW:verify-before-asserting}} — the
11
11
  real current file, not a remembered copy). The build seeds it once and never
12
12
  overwrites it; if it is genuinely absent, start from the stub's three sections
13
13
  (below) and note that a rebuild would have seeded it.
@@ -30,7 +30,7 @@ profile". Also when an existing profile visibly contradicts how the user now wor
30
30
  prose, no placeholders left standing. Keep it lean: a profile is read every
31
31
  session, and bloat dilutes the parts that matter.
32
32
  5. Show the full draft and wait for explicit consent ({{LAW:deletion-is-deliberate}}) before writing
33
- `PROFILE.md`. Remind the user the file is theirs — hand-editable any time, and
33
+ `{{PATH_PROFILE}}`. Remind the user the file is theirs — hand-editable any time, and
34
34
  it survives updates, rebuilds, and theme switches.
35
35
 
36
36
  **Refresh flow** (on request, or when the profile has drifted): read the current