geneseed 4.31.0 → 5.0.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.
- package/CHANGELOG.md +107 -0
- package/DESIGN.md +2 -2
- package/README.md +6 -5
- package/SHIPPED.md +4 -3
- package/adapters/bob/README.md +6 -5
- package/adapters/claude-code/README.md +4 -3
- package/adapters/claude-code/skills/geneseed/SKILL.md +1 -1
- package/adapters/openclaude/README.md +4 -3
- package/adapters/opencode/GLOBAL-HARNESS-SPEC.md +3 -1
- package/adapters/opencode/HOW-OPENCODE-LOADS.md +2 -1
- package/adapters/opencode/README.md +18 -18
- package/adapters/opencode/plugins/geneseed-activity.js +57 -1
- package/adapters/opencode/plugins/geneseed-context.js +220 -18
- package/adapters/opencode/plugins/geneseed-guard.js +578 -74
- package/adapters/opencode/plugins/geneseed-learn.js +97 -23
- package/bin/geneseed-cli.mjs +17 -25
- package/bin/geneseed-hook.mjs +23 -8
- package/docs/DESIGN.md +175 -0
- package/docs/PRD.md +111 -0
- package/docs/README.md +3 -2
- package/docs/architecture.md +145 -0
- package/docs/concepts/agents.md +1 -1
- package/docs/concepts/collaboration.md +1 -1
- package/docs/concepts/enforcement-table.md +1 -1
- package/docs/concepts/exclusions.md +6 -6
- package/docs/concepts/footprint.md +1 -1
- package/docs/concepts/foreman-mode.md +2 -2
- package/docs/concepts/hook-gates.md +1 -1
- package/docs/concepts/hooks.md +27 -11
- package/docs/concepts/host-matrix.md +3 -3
- package/docs/concepts/hosts.md +1 -1
- package/docs/concepts/kits.md +3 -1
- package/docs/concepts/loop-bricks.md +1 -1
- package/docs/concepts/loop-notes.md +4 -2
- package/docs/concepts/loop-templates.md +7 -4
- package/docs/concepts/loops.md +3 -0
- package/docs/concepts/ownership.md +2 -2
- package/docs/concepts/rules.md +15 -2
- package/docs/concepts/shared-tier.md +73 -0
- package/docs/concepts/skills.md +2 -2
- package/docs/concepts/themes.md +1 -1
- package/docs/extending.md +13 -12
- package/docs/guides/install-claude-code.md +1 -1
- package/docs/guides/install-opencode.md +1 -1
- package/docs/guides/migrate.md +4 -2
- package/docs/guides/project-context.md +2 -2
- package/docs/guides/run-a-loop.md +1 -1
- package/docs/guides/set-up-ownership.md +1 -1
- package/docs/guides/setup-footprint.md +1 -1
- package/docs/guides/uninstall.md +2 -1
- package/docs/guides/upgrade-to-5.md +116 -0
- package/docs/guides/upgrade.md +21 -9
- package/docs/guides/wiki.md +3 -3
- package/docs/reference/env-context.md +5 -3
- package/docs/reference/environment.md +1 -1
- package/docs/reference/glossary.md +2 -0
- package/docs/reference/loop-actions.md +1 -1
- package/docs/reference/opencode-plugins.md +3 -3
- package/docs/reference/plugin-activity.md +1 -1
- package/docs/reference/plugin-context.md +5 -0
- package/docs/reference/plugin-guard.md +14 -6
- package/docs/reference/plugin-learn.md +13 -6
- package/docs/reference/troubleshoot-hooks.md +3 -3
- package/docs/reference/troubleshoot-update.md +14 -0
- package/docs/token-footprint.md +4 -3
- package/docs/understand/a-day.md +2 -2
- package/docs/understand/design-choices-install.md +2 -1
- package/docs/understand/enforced-vs-asked.md +4 -3
- package/docs/understand/machine-bob.md +3 -1
- package/docs/understand/machine-claude.md +7 -5
- package/docs/understand/machine-opencode.md +7 -5
- package/docs/understand/on-your-machine.md +4 -0
- package/docs/understand/take-it-out.md +1 -1
- package/docs/web-ui.md +141 -73
- package/harness.config.json +1 -1
- package/js/README.md +10 -6
- package/js/build/args.mjs +10 -8
- package/js/build/bundle.mjs +11 -13
- package/js/build/driver.mjs +66 -65
- package/js/build/emit-claude.mjs +22 -16
- package/js/build/emit-common.mjs +4 -5
- package/js/build/emit-opencode.mjs +22 -22
- package/js/build/fold.mjs +515 -0
- package/js/build/generate.mjs +41 -52
- package/js/build/render.mjs +115 -29
- package/js/build/source.mjs +4 -1
- package/js/build/stubs.mjs +70 -9
- package/js/build/version.mjs +10 -10
- package/js/cli-table.json +23 -83
- package/js/hosts/activity.mjs +2 -2
- package/js/hosts/geneseed-dir.mjs +1 -1
- package/js/hosts/hooks-context.mjs +410 -99
- package/js/hosts/hooks-done.mjs +97 -31
- package/js/hosts/hooks-learn.mjs +38 -7
- package/js/hosts/hooks-prims.mjs +69 -2
- package/js/hosts/hooks.mjs +300 -64
- package/js/hosts/hosts.mjs +150 -51
- package/js/hosts/installs.mjs +55 -167
- package/js/hosts/link.mjs +3 -5
- package/js/hosts/mcp.mjs +1 -1
- package/js/hosts/memory-files.mjs +219 -17
- package/js/hosts/ownership-gate.mjs +1 -1
- package/js/hosts/settings.mjs +18 -13
- package/js/hosts/shim.mjs +4 -33
- package/js/hosts/store-watch.mjs +189 -0
- package/js/inspect/checks-authoring.mjs +3 -3
- package/js/inspect/checks-build.mjs +45 -18
- package/js/inspect/checks-counts.mjs +4 -4
- package/js/inspect/checks-repo.mjs +13 -14
- package/js/inspect/cost.mjs +24 -2
- package/js/inspect/diff.mjs +123 -123
- package/js/inspect/doctor.mjs +22 -27
- package/js/inspect/excludes.mjs +181 -62
- package/js/inspect/inventory.mjs +22 -27
- package/js/inspect/registry.mjs +106 -30
- package/js/inspect/scan.mjs +5 -5
- package/js/inspect/status.mjs +141 -119
- package/js/inspect/validate.mjs +22 -24
- package/js/lib/fs.mjs +47 -50
- package/js/lib/json.mjs +10 -17
- package/js/lib/machine-dir.mjs +73 -0
- package/js/lib/paths.mjs +22 -33
- package/js/lib/proc.mjs +1 -1
- package/js/lib/prompt.mjs +19 -27
- package/js/lib/text.mjs +8 -12
- package/js/lib/udiff.mjs +11 -15
- package/js/loop/catalog.mjs +2 -3
- package/js/loop/state.mjs +15 -5
- package/js/maintain/memory.mjs +17 -17
- package/js/maintain/migrate.mjs +79 -89
- package/js/maintain/setup.mjs +43 -32
- package/js/maintain/uninstall.mjs +43 -61
- package/js/maintain/update.mjs +200 -93
- package/js/ui/anim.mjs +21 -35
- package/js/ui/cli.mjs +36 -58
- package/js/ui/menu.mjs +22 -45
- package/js/ui/tui.mjs +27 -67
- package/js/web/actions.mjs +38 -38
- package/js/web/api.mjs +132 -76
- package/js/web/catalog.mjs +175 -46
- package/js/web/docs.mjs +33 -12
- package/js/web/doctor-worker.mjs +14 -0
- package/js/web/handler.mjs +14 -5
- package/js/web/routes.mjs +17 -19
- package/js/web/state.mjs +78 -19
- package/js/web/update-check.mjs +25 -10
- package/js/web/user-files.mjs +50 -105
- package/package.json +7 -4
- package/registry.json +48 -55
- package/src/AGENT.md.tmpl +13 -14
- package/src/agents/_self-improvement.md +1 -1
- package/src/agents/_template.md +4 -1
- package/src/agents/advocate.md +1 -1
- package/src/agents/architect.md +1 -1
- package/src/agents/developer.md +6 -3
- package/src/agents/devops-engineer.md +1 -1
- package/src/agents/docker-expert.md +1 -1
- package/src/agents/docs.md +1 -1
- package/src/agents/empiricist.md +1 -1
- package/src/agents/explorer.md +1 -1
- package/src/agents/framer.md +1 -1
- package/src/agents/historian.md +1 -1
- package/src/agents/kubernetes-specialist.md +1 -1
- package/src/agents/memory-curator.md +2 -2
- package/src/agents/operator.md +1 -1
- package/src/agents/performance.md +1 -1
- package/src/agents/pragmatist.md +1 -1
- package/src/agents/react-engineer.md +1 -1
- package/src/agents/react-reviewer.md +1 -1
- package/src/agents/researcher.md +1 -1
- package/src/agents/reviewer.md +1 -1
- package/src/agents/security.md +1 -1
- package/src/agents/skeptic.md +1 -1
- package/src/agents/spring-boot-engineer.md +1 -1
- package/src/agents/spring-reviewer.md +1 -1
- package/src/agents/spring-security.md +1 -1
- package/src/agents/steward.md +1 -1
- package/src/agents/tester.md +5 -2
- package/src/agents/user-advocate.md +1 -1
- package/src/agents/visionary.md +1 -1
- package/src/bricks/apply.md +3 -0
- package/src/bricks/test.md +6 -4
- package/src/loops/bugfix.json +11 -5
- package/src/loops/feature.json +7 -4
- package/src/memory/README.md +1 -1
- package/src/skills/_self-improvement.md +2 -2
- package/src/skills/daydream/SKILL.md +2 -2
- package/src/skills/daydream/instructions.md +1 -1
- package/src/skills/geneseed.md +1 -1
- package/src/skills/learn-mode.md +1 -2
- package/src/skills/loop.md +1 -0
- package/src/skills/profile.md +2 -2
- package/src/skills/rule/approve.md +69 -0
- package/src/skills/rule/consolidate.md +3 -3
- package/src/skills/rule.md +13 -5
- package/src/skills/ship.md +9 -1
- package/src/skills/skill-forge.md +1 -1
- package/src/skills/teach.md +29 -12
- package/src/skills/wiki.md +1 -1
- package/themes/_TEMPLATE.json +1 -2
- package/themes/biker.json +1 -2
- package/themes/commentator.json +1 -2
- package/themes/cyberpunk.json +1 -2
- package/themes/gamer.json +1 -2
- package/themes/imperial.json +1 -2
- package/themes/joker.json +1 -2
- package/themes/marvin.json +1 -2
- package/themes/mean.json +1 -2
- package/themes/military.json +1 -2
- package/themes/neutral.json +1 -2
- package/themes/pirate.json +1 -2
- package/themes/sports.json +1 -2
- package/themes/verstappen.json +1 -2
- package/themes/wizard.json +1 -2
- package/web/dist/assets/Activity-D8G4eClY.js +1 -0
- package/web/dist/assets/ActivityDetail-BtOBYk3M.js +1 -0
- package/web/dist/assets/AgentGlyph-k6o3gCM1.js +1 -0
- package/web/dist/assets/Bonsai-B_y20b3i.js +1 -0
- package/web/dist/assets/{CopyButton-IXnXzH4Y.js → CopyButton-CHQte7Ap.js} +1 -1
- package/web/dist/assets/Dashboard-B8uXeJZ_.js +2 -0
- package/web/dist/assets/{DataTable-BWbUx4bY.js → DataTable-b9zTShqJ.js} +1 -1
- package/web/dist/assets/Docs-Dgv_MWfT.js +5 -0
- package/web/dist/assets/{EmptyState-1sPNleqv.js → EmptyState-CY5Pm2xy.js} +1 -1
- package/web/dist/assets/FilterInput-qGKNSlxv.js +1 -0
- package/web/dist/assets/GreenhouseView-CSzTMSl_.js +1 -0
- package/web/dist/assets/Installs-BDk9lqBI.js +3 -0
- package/web/dist/assets/JournalView-CvRk1-m5.js +1 -0
- package/web/dist/assets/Kits-CoITzxWM.js +1 -0
- package/web/dist/assets/Laws-Ctf5r9rE.js +3 -0
- package/web/dist/assets/Library-DNwHYVXt.js +3 -0
- package/web/dist/assets/{Loops-C5u7fQOR.js → Loops-S85PMQ8m.js} +2 -2
- package/web/dist/assets/Markdown-0ORz7tAc.js +69 -0
- package/web/dist/assets/OperatorHudView-DuGz_sTk.js +1 -0
- package/web/dist/assets/Personal-afJNwvRS.js +2 -0
- package/web/dist/assets/RailCats-AW92uhsX.js +1 -0
- package/web/dist/assets/Settings-CGDFz-6j.js +1 -0
- package/web/dist/assets/Tabs-1qLrnqmn.js +1 -0
- package/web/dist/assets/api-C46vAuqp.js +1 -0
- package/web/dist/assets/controls-D4wmg_pl.js +1 -0
- package/web/dist/assets/index-COTd4TRZ.js +3 -0
- package/web/dist/assets/index-CtorA7uK.css +1 -0
- package/web/dist/assets/motion-RlUl1osO.js +1 -0
- package/web/dist/assets/react-C1iE8mnY.js +9 -0
- package/web/dist/assets/rolldown-runtime-XKyaHtl9.js +1 -0
- package/web/dist/assets/{sections-ChwaobfW.js → sections-CtFz7HFH.js} +1 -1
- package/web/dist/assets/{usePoll-bDFN-Hr6.js → usePoll-o8ul-Sog.js} +1 -1
- package/web/dist/index.html +7 -7
- package/src/skills/quiz.md +0 -44
- package/web/dist/assets/Activity-B7cFtS00.js +0 -1
- package/web/dist/assets/ActivityDetail-C-GbMmuW.js +0 -1
- package/web/dist/assets/Bonsai-_YyexVC5.js +0 -1
- package/web/dist/assets/Dashboard-sCfEjowQ.js +0 -2
- package/web/dist/assets/Docs-w3Y7M5Ts.js +0 -5
- package/web/dist/assets/FilterInput-CZREvrjX.js +0 -1
- package/web/dist/assets/GreenhouseView-BWWbMKmg.js +0 -1
- package/web/dist/assets/Installs-CnkdJ-VA.js +0 -3
- package/web/dist/assets/JournalView-C7bPD3fZ.js +0 -1
- package/web/dist/assets/KitApply-CQQbnThf.js +0 -1
- package/web/dist/assets/Kits-aj07N7mT.js +0 -1
- package/web/dist/assets/Laws-DZ38nl_H.js +0 -3
- package/web/dist/assets/Library-QCGXPV5h.js +0 -2
- package/web/dist/assets/Markdown-DpmmtW2Y.js +0 -65
- package/web/dist/assets/OperatorHudView-Blu1lqiZ.js +0 -1
- package/web/dist/assets/Personal-ox_MktWO.js +0 -2
- package/web/dist/assets/RailCats-BuJD4Jou.js +0 -1
- package/web/dist/assets/Tabs-CIPyMAX-.js +0 -1
- package/web/dist/assets/api-BxjLd7Qd.js +0 -1
- package/web/dist/assets/index-0GCxkY7m.css +0 -1
- package/web/dist/assets/index-CzDi9JpF.js +0 -3
- package/web/dist/assets/motion-CXaUMNkg.js +0 -1
- package/web/dist/assets/react-DlYQp10C.js +0 -9
- package/web/dist/assets/rolldown-runtime-hePW80VL.js +0 -1
package/registry.json
CHANGED
|
@@ -23,18 +23,18 @@
|
|
|
23
23
|
"last_verified": ""
|
|
24
24
|
},
|
|
25
25
|
"agents/devops-engineer": {
|
|
26
|
-
"status": "
|
|
26
|
+
"status": "approved",
|
|
27
27
|
"version": "1.0.0",
|
|
28
28
|
"owner": "Guillaume Lemer",
|
|
29
29
|
"added": "2026-10-20",
|
|
30
|
-
"last_verified": ""
|
|
30
|
+
"last_verified": "2026-11-06"
|
|
31
31
|
},
|
|
32
32
|
"agents/docker-expert": {
|
|
33
|
-
"status": "
|
|
33
|
+
"status": "approved",
|
|
34
34
|
"version": "1.0.0",
|
|
35
35
|
"owner": "Guillaume Lemer",
|
|
36
36
|
"added": "2026-10-20",
|
|
37
|
-
"last_verified": ""
|
|
37
|
+
"last_verified": "2026-11-06"
|
|
38
38
|
},
|
|
39
39
|
"agents/docs": {
|
|
40
40
|
"status": "approved",
|
|
@@ -72,18 +72,18 @@
|
|
|
72
72
|
"last_verified": ""
|
|
73
73
|
},
|
|
74
74
|
"agents/kubernetes-specialist": {
|
|
75
|
-
"status": "
|
|
75
|
+
"status": "approved",
|
|
76
76
|
"version": "1.0.0",
|
|
77
77
|
"owner": "Guillaume Lemer",
|
|
78
78
|
"added": "2026-10-20",
|
|
79
|
-
"last_verified": ""
|
|
79
|
+
"last_verified": "2026-11-06"
|
|
80
80
|
},
|
|
81
81
|
"agents/memory-curator": {
|
|
82
|
-
"status": "
|
|
82
|
+
"status": "approved",
|
|
83
83
|
"version": "1.0.0",
|
|
84
84
|
"owner": "Guillaume Lemer",
|
|
85
85
|
"added": "2026-10-16",
|
|
86
|
-
"last_verified": ""
|
|
86
|
+
"last_verified": "2026-11-06"
|
|
87
87
|
},
|
|
88
88
|
"agents/operator": {
|
|
89
89
|
"status": "approved",
|
|
@@ -100,18 +100,18 @@
|
|
|
100
100
|
"last_verified": ""
|
|
101
101
|
},
|
|
102
102
|
"agents/react-engineer": {
|
|
103
|
-
"status": "
|
|
103
|
+
"status": "approved",
|
|
104
104
|
"version": "1.0.0",
|
|
105
105
|
"owner": "Guillaume Lemer",
|
|
106
106
|
"added": "2026-10-21",
|
|
107
|
-
"last_verified": ""
|
|
107
|
+
"last_verified": "2026-11-06"
|
|
108
108
|
},
|
|
109
109
|
"agents/react-reviewer": {
|
|
110
|
-
"status": "
|
|
110
|
+
"status": "approved",
|
|
111
111
|
"version": "1.0.0",
|
|
112
112
|
"owner": "Guillaume Lemer",
|
|
113
113
|
"added": "2026-10-21",
|
|
114
|
-
"last_verified": ""
|
|
114
|
+
"last_verified": "2026-11-06"
|
|
115
115
|
},
|
|
116
116
|
"agents/researcher": {
|
|
117
117
|
"status": "approved",
|
|
@@ -128,11 +128,11 @@
|
|
|
128
128
|
"last_verified": ""
|
|
129
129
|
},
|
|
130
130
|
"agents/performance": {
|
|
131
|
-
"status": "
|
|
131
|
+
"status": "approved",
|
|
132
132
|
"version": "1.0.0",
|
|
133
133
|
"owner": "Guillaume Lemer",
|
|
134
134
|
"added": "2026-10-14",
|
|
135
|
-
"last_verified": ""
|
|
135
|
+
"last_verified": "2026-11-06"
|
|
136
136
|
},
|
|
137
137
|
"agents/security": {
|
|
138
138
|
"status": "approved",
|
|
@@ -149,25 +149,25 @@
|
|
|
149
149
|
"last_verified": ""
|
|
150
150
|
},
|
|
151
151
|
"agents/spring-boot-engineer": {
|
|
152
|
-
"status": "
|
|
152
|
+
"status": "approved",
|
|
153
153
|
"version": "1.0.0",
|
|
154
154
|
"owner": "Guillaume Lemer",
|
|
155
155
|
"added": "2026-10-20",
|
|
156
|
-
"last_verified": ""
|
|
156
|
+
"last_verified": "2026-11-06"
|
|
157
157
|
},
|
|
158
158
|
"agents/spring-reviewer": {
|
|
159
|
-
"status": "
|
|
159
|
+
"status": "approved",
|
|
160
160
|
"version": "1.0.0",
|
|
161
161
|
"owner": "Guillaume Lemer",
|
|
162
162
|
"added": "2026-10-20",
|
|
163
|
-
"last_verified": ""
|
|
163
|
+
"last_verified": "2026-11-06"
|
|
164
164
|
},
|
|
165
165
|
"agents/spring-security": {
|
|
166
|
-
"status": "
|
|
166
|
+
"status": "approved",
|
|
167
167
|
"version": "1.0.0",
|
|
168
168
|
"owner": "Guillaume Lemer",
|
|
169
169
|
"added": "2026-10-20",
|
|
170
|
-
"last_verified": ""
|
|
170
|
+
"last_verified": "2026-11-06"
|
|
171
171
|
},
|
|
172
172
|
"agents/steward": {
|
|
173
173
|
"status": "approved",
|
|
@@ -198,11 +198,11 @@
|
|
|
198
198
|
"last_verified": ""
|
|
199
199
|
},
|
|
200
200
|
"skills/adhd": {
|
|
201
|
-
"status": "
|
|
201
|
+
"status": "approved",
|
|
202
202
|
"version": "1.0.0",
|
|
203
203
|
"owner": "Guillaume Lemer",
|
|
204
204
|
"added": "2026-10-29",
|
|
205
|
-
"last_verified": ""
|
|
205
|
+
"last_verified": "2026-11-06"
|
|
206
206
|
},
|
|
207
207
|
"skills/brainstorm": {
|
|
208
208
|
"status": "approved",
|
|
@@ -212,18 +212,18 @@
|
|
|
212
212
|
"last_verified": "2026-09-06"
|
|
213
213
|
},
|
|
214
214
|
"skills/brick-forge": {
|
|
215
|
-
"status": "
|
|
215
|
+
"status": "approved",
|
|
216
216
|
"version": "0.1.0",
|
|
217
217
|
"owner": "Guillaume Lemer",
|
|
218
218
|
"added": "2026-10-03",
|
|
219
|
-
"last_verified": ""
|
|
219
|
+
"last_verified": "2026-11-06"
|
|
220
220
|
},
|
|
221
221
|
"skills/bruno": {
|
|
222
|
-
"status": "
|
|
222
|
+
"status": "approved",
|
|
223
223
|
"version": "1.0.0",
|
|
224
224
|
"owner": "Guillaume Lemer",
|
|
225
225
|
"added": "2026-10-08",
|
|
226
|
-
"last_verified": ""
|
|
226
|
+
"last_verified": "2026-11-06"
|
|
227
227
|
},
|
|
228
228
|
"skills/codebase-design": {
|
|
229
229
|
"status": "approved",
|
|
@@ -261,11 +261,11 @@
|
|
|
261
261
|
"last_verified": "2026-09-06"
|
|
262
262
|
},
|
|
263
263
|
"skills/deck": {
|
|
264
|
-
"status": "
|
|
264
|
+
"status": "approved",
|
|
265
265
|
"version": "1.0.0",
|
|
266
266
|
"owner": "Guillaume Lemer",
|
|
267
267
|
"added": "2026-10-16",
|
|
268
|
-
"last_verified": ""
|
|
268
|
+
"last_verified": "2026-11-06"
|
|
269
269
|
},
|
|
270
270
|
"skills/dependencies": {
|
|
271
271
|
"status": "approved",
|
|
@@ -282,11 +282,11 @@
|
|
|
282
282
|
"last_verified": "2026-09-06"
|
|
283
283
|
},
|
|
284
284
|
"skills/diagram-design": {
|
|
285
|
-
"status": "
|
|
285
|
+
"status": "approved",
|
|
286
286
|
"version": "1.0.0",
|
|
287
287
|
"owner": "Guillaume Lemer",
|
|
288
288
|
"added": "2026-10-29",
|
|
289
|
-
"last_verified": ""
|
|
289
|
+
"last_verified": "2026-11-06"
|
|
290
290
|
},
|
|
291
291
|
"skills/document-project": {
|
|
292
292
|
"status": "approved",
|
|
@@ -359,25 +359,25 @@
|
|
|
359
359
|
"last_verified": "2026-09-06"
|
|
360
360
|
},
|
|
361
361
|
"skills/learn-mode": {
|
|
362
|
-
"status": "
|
|
362
|
+
"status": "approved",
|
|
363
363
|
"version": "1.0.0",
|
|
364
364
|
"owner": "Guillaume Lemer",
|
|
365
365
|
"added": "2026-10-02",
|
|
366
|
-
"last_verified": ""
|
|
366
|
+
"last_verified": "2026-11-06"
|
|
367
367
|
},
|
|
368
368
|
"skills/loop": {
|
|
369
|
-
"status": "
|
|
369
|
+
"status": "approved",
|
|
370
370
|
"version": "0.1.0",
|
|
371
371
|
"owner": "Guillaume Lemer",
|
|
372
372
|
"added": "2026-10-03",
|
|
373
|
-
"last_verified": ""
|
|
373
|
+
"last_verified": "2026-11-06"
|
|
374
374
|
},
|
|
375
375
|
"skills/ownership": {
|
|
376
|
-
"status": "
|
|
376
|
+
"status": "approved",
|
|
377
377
|
"version": "1.0.0",
|
|
378
378
|
"owner": "Guillaume Lemer",
|
|
379
379
|
"added": "2026-10-26",
|
|
380
|
-
"last_verified": ""
|
|
380
|
+
"last_verified": "2026-11-06"
|
|
381
381
|
},
|
|
382
382
|
"skills/parallel-agents": {
|
|
383
383
|
"status": "approved",
|
|
@@ -428,26 +428,19 @@
|
|
|
428
428
|
"added": "2026-07-13",
|
|
429
429
|
"last_verified": "2026-09-06"
|
|
430
430
|
},
|
|
431
|
-
"skills/quiz": {
|
|
432
|
-
"status": "experimental",
|
|
433
|
-
"version": "1.0.0",
|
|
434
|
-
"owner": "Guillaume Lemer",
|
|
435
|
-
"added": "2026-09-06",
|
|
436
|
-
"last_verified": ""
|
|
437
|
-
},
|
|
438
431
|
"skills/react": {
|
|
439
|
-
"status": "
|
|
432
|
+
"status": "approved",
|
|
440
433
|
"version": "1.0.0",
|
|
441
434
|
"owner": "Guillaume Lemer",
|
|
442
435
|
"added": "2026-10-21",
|
|
443
|
-
"last_verified": ""
|
|
436
|
+
"last_verified": "2026-11-06"
|
|
444
437
|
},
|
|
445
438
|
"skills/react-testing": {
|
|
446
|
-
"status": "
|
|
439
|
+
"status": "approved",
|
|
447
440
|
"version": "1.0.0",
|
|
448
441
|
"owner": "Guillaume Lemer",
|
|
449
442
|
"added": "2026-10-21",
|
|
450
|
-
"last_verified": ""
|
|
443
|
+
"last_verified": "2026-11-06"
|
|
451
444
|
},
|
|
452
445
|
"skills/react-view-transitions": {
|
|
453
446
|
"status": "approved",
|
|
@@ -520,32 +513,32 @@
|
|
|
520
513
|
"last_verified": "2026-10-13"
|
|
521
514
|
},
|
|
522
515
|
"skills/spring-boot": {
|
|
523
|
-
"status": "
|
|
516
|
+
"status": "approved",
|
|
524
517
|
"version": "1.0.0",
|
|
525
518
|
"owner": "Guillaume Lemer",
|
|
526
519
|
"added": "2026-10-20",
|
|
527
|
-
"last_verified": ""
|
|
520
|
+
"last_verified": "2026-11-06"
|
|
528
521
|
},
|
|
529
522
|
"skills/spring-data-jpa": {
|
|
530
|
-
"status": "
|
|
523
|
+
"status": "approved",
|
|
531
524
|
"version": "1.0.0",
|
|
532
525
|
"owner": "Guillaume Lemer",
|
|
533
526
|
"added": "2026-10-20",
|
|
534
|
-
"last_verified": ""
|
|
527
|
+
"last_verified": "2026-11-06"
|
|
535
528
|
},
|
|
536
529
|
"skills/spring-testing": {
|
|
537
|
-
"status": "
|
|
530
|
+
"status": "approved",
|
|
538
531
|
"version": "1.0.0",
|
|
539
532
|
"owner": "Guillaume Lemer",
|
|
540
533
|
"added": "2026-10-20",
|
|
541
|
-
"last_verified": ""
|
|
534
|
+
"last_verified": "2026-11-06"
|
|
542
535
|
},
|
|
543
536
|
"skills/teach": {
|
|
544
|
-
"status": "
|
|
537
|
+
"status": "approved",
|
|
545
538
|
"version": "1.0.0",
|
|
546
539
|
"owner": "Guillaume Lemer",
|
|
547
540
|
"added": "2026-09-06",
|
|
548
|
-
"last_verified": ""
|
|
541
|
+
"last_verified": "2026-11-06"
|
|
549
542
|
},
|
|
550
543
|
"skills/token-report": {
|
|
551
544
|
"status": "approved",
|
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
|
-
`{{
|
|
48
|
-
`{{DIR_NOTEBOOK}}/NOTEBOOK.md`, `{{
|
|
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.** `{{
|
|
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.** `{{
|
|
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
|
-
`{{
|
|
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
|
|
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 `{{
|
|
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
|
|
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 `{{
|
|
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 `{{
|
|
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 `{{
|
|
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.
|
package/src/agents/_template.md
CHANGED
|
@@ -42,11 +42,14 @@
|
|
|
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 `{{
|
|
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
|
|
|
49
49
|
## Output contract
|
|
50
|
+
- The report starts with one line, `STATUS: OK|BLOCKED|OUT_OF_SCOPE|ERROR`:
|
|
51
|
+
`OK` the contract is met; `BLOCKED` an input or a decision is missing;
|
|
52
|
+
`OUT_OF_SCOPE` this {{AGENT}} does not own the task; `ERROR` a step failed.
|
|
50
53
|
- The exact shape of what this {{AGENT}} returns to the caller (e.g. a list of
|
|
51
54
|
findings with file:line, a verdict, a summary of changes made).
|
|
52
55
|
- Include an honest-failure line: what this {{AGENT}} returns when the contract
|
package/src/agents/advocate.md
CHANGED
|
@@ -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 `{{
|
|
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.
|
package/src/agents/architect.md
CHANGED
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
<!-- bash: allow -->
|
|
23
23
|
|
|
24
24
|
## Procedure
|
|
25
|
-
0. If `{{
|
|
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
|
package/src/agents/developer.md
CHANGED
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
commits once the user accepts.
|
|
30
30
|
|
|
31
31
|
## Procedure
|
|
32
|
-
0. If `{{
|
|
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
|
|
@@ -42,12 +42,15 @@
|
|
|
42
42
|
actually close — report the blocker instead ({{ONTOLOGY}}: {{ONT_EVIDENCE}}).
|
|
43
43
|
|
|
44
44
|
## Output contract
|
|
45
|
+
- The report starts with one line, `STATUS: OK|BLOCKED|OUT_OF_SCOPE|ERROR`: `OK` the contract is met;
|
|
46
|
+
`BLOCKED` an input or a decision is missing; `OUT_OF_SCOPE` not this task; `ERROR` a step failed,
|
|
47
|
+
red tests included.
|
|
45
48
|
- The files changed in the worktree and a one-line summary of what changed and
|
|
46
49
|
why, ready for the tester's pass.
|
|
47
50
|
- If the scoped task cannot be implemented as given (missing input, contradictory
|
|
48
|
-
acceptance criteria), report that blocker instead of guessing.
|
|
51
|
+
acceptance criteria), report that blocker instead of guessing (`STATUS: BLOCKED`).
|
|
49
52
|
- In ownership mode: the diff, for the developer's final review — or
|
|
50
|
-
`blocked: decision needed` with the options
|
|
53
|
+
`blocked: decision needed` with the options, on the line after `STATUS: BLOCKED`.
|
|
51
54
|
|
|
52
55
|
## Pipeline role
|
|
53
56
|
|
|
@@ -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 `{{
|
|
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 `{{
|
|
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`.
|
package/src/agents/docs.md
CHANGED
|
@@ -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 `{{
|
|
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.
|
package/src/agents/empiricist.md
CHANGED
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
<!-- bash: allow -->
|
|
21
21
|
|
|
22
22
|
## Procedure
|
|
23
|
-
0. If `{{
|
|
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.
|
package/src/agents/explorer.md
CHANGED
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
<!-- bash: allow -->
|
|
25
25
|
|
|
26
26
|
## Procedure
|
|
27
|
-
0. If `{{
|
|
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.
|
package/src/agents/framer.md
CHANGED
|
@@ -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 `{{
|
|
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.
|
package/src/agents/historian.md
CHANGED
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
<!-- bash: allow -->
|
|
21
21
|
|
|
22
22
|
## Procedure
|
|
23
|
-
0. If `{{
|
|
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 `{{
|
|
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 (`{{
|
|
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 `{{
|
|
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`).
|
package/src/agents/operator.md
CHANGED
|
@@ -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 `{{
|
|
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 `{{
|
|
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
|
package/src/agents/pragmatist.md
CHANGED
|
@@ -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 `{{
|
|
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 `{{
|
|
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 `{{
|
|
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`.
|
package/src/agents/researcher.md
CHANGED
|
@@ -33,7 +33,7 @@
|
|
|
33
33
|
({{LAW:data-not-orders}}).
|
|
34
34
|
|
|
35
35
|
## Procedure
|
|
36
|
-
0. If `{{
|
|
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}}).
|