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.
- package/CHANGELOG.md +101 -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 +85 -18
- package/adapters/opencode/plugins/geneseed-guard.js +437 -76
- 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 +5 -5
- package/docs/concepts/footprint.md +1 -1
- package/docs/concepts/foreman-mode.md +2 -2
- package/docs/concepts/hooks.md +22 -8
- package/docs/concepts/host-matrix.md +2 -2
- package/docs/concepts/hosts.md +1 -1
- package/docs/concepts/kits.md +3 -1
- package/docs/concepts/ownership.md +1 -1
- 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 +8 -4
- package/docs/guides/project-context.md +2 -2
- package/docs/guides/setup-footprint.md +1 -1
- package/docs/guides/uninstall.md +2 -1
- package/docs/guides/upgrade-to-5.md +118 -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/opencode-plugins.md +3 -3
- package/docs/reference/plugin-activity.md +1 -1
- package/docs/reference/plugin-context.md +1 -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 +1 -1
- package/docs/understand/machine-bob.md +2 -0
- 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 +135 -70
- package/harness.config.json +1 -1
- package/js/README.md +12 -7
- 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/rule-decide.mjs +273 -0
- 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 +389 -99
- package/js/hosts/hooks-learn.mjs +38 -7
- package/js/hosts/hooks-prims.mjs +4 -2
- package/js/hosts/hooks.mjs +114 -39
- package/js/hosts/hosts.mjs +150 -51
- package/js/hosts/installs.mjs +59 -171
- 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 +191 -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 +110 -32
- 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 +35 -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/maintain/memory.mjs +17 -17
- package/js/maintain/migrate.mjs +120 -92
- 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 +34 -34
- package/js/web/api.mjs +142 -79
- 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 +16 -5
- package/js/web/routes.mjs +24 -22
- package/js/web/state.mjs +78 -19
- package/js/web/update-check.mjs +27 -12
- package/js/web/user-files.mjs +76 -104
- 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 +1 -1
- package/src/agents/advocate.md +1 -1
- package/src/agents/architect.md +1 -1
- package/src/agents/developer.md +1 -1
- 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 +1 -1
- package/src/agents/user-advocate.md +1 -1
- package/src/agents/visionary.md +1 -1
- 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/profile.md +2 -2
- package/src/skills/rule/approve.md +75 -0
- package/src/skills/rule/consolidate.md +3 -3
- package/src/skills/rule.md +14 -5
- 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-Ci4PZco3.js +1 -0
- package/web/dist/assets/ActivityDetail-C8hroCND.js +1 -0
- package/web/dist/assets/AgentGlyph-k6o3gCM1.js +1 -0
- package/web/dist/assets/Bonsai-C1iBAt4v.js +1 -0
- package/web/dist/assets/{CopyButton-C5Li6awl.js → CopyButton-DJ3a4N88.js} +1 -1
- package/web/dist/assets/Dashboard-C_On4KXw.js +2 -0
- package/web/dist/assets/Docs-Kffdg5uV.js +5 -0
- package/web/dist/assets/GreenhouseView-k56_cBSF.js +1 -0
- package/web/dist/assets/Installs-DtEKLC9h.js +3 -0
- package/web/dist/assets/JournalView-RQnk5l7I.js +1 -0
- package/web/dist/assets/Kits-CXkEBpnf.js +1 -0
- package/web/dist/assets/Laws-DhhIVqmh.js +3 -0
- package/web/dist/assets/Library-CAUiEoJo.js +3 -0
- package/web/dist/assets/{Loops-CzitjxGV.js → Loops-LKD8mF4E.js} +2 -2
- package/web/dist/assets/{Markdown-C4S4tTA7.js → Markdown-0ORz7tAc.js} +21 -21
- package/web/dist/assets/OperatorHudView-CM5jNPwL.js +1 -0
- package/web/dist/assets/Personal-B6Uoly3C.js +2 -0
- package/web/dist/assets/{RailCats-D5weYPCS.js → RailCats-DQxxYBEP.js} +1 -1
- package/web/dist/assets/Settings-BTe6-wda.js +1 -0
- package/web/dist/assets/Tabs-CbdDWTp_.js +1 -0
- package/web/dist/assets/api-D_r0Jtla.js +1 -0
- package/web/dist/assets/controls-D4wmg_pl.js +1 -0
- package/web/dist/assets/index-HfGmYXab.js +3 -0
- package/web/dist/assets/index-ao3M-Fhm.css +1 -0
- package/web/dist/assets/motion-RlUl1osO.js +1 -0
- package/web/dist/assets/{sections-ChwaobfW.js → sections-CtFz7HFH.js} +1 -1
- package/web/dist/index.html +5 -5
- package/src/skills/quiz.md +0 -44
- package/web/dist/assets/Activity-Bjy64wHC.js +0 -1
- package/web/dist/assets/ActivityDetail-B0AaipP8.js +0 -1
- package/web/dist/assets/Bonsai-CJniRqaH.js +0 -1
- package/web/dist/assets/Dashboard-B-6DTmae.js +0 -2
- package/web/dist/assets/Docs-LRc30XL9.js +0 -5
- package/web/dist/assets/GreenhouseView-CcoYlaWo.js +0 -1
- package/web/dist/assets/Installs-dp1epTcE.js +0 -3
- package/web/dist/assets/JournalView-nFP4poCf.js +0 -1
- package/web/dist/assets/KitApply-DwyZUj57.js +0 -1
- package/web/dist/assets/Kits-C0IEdZXe.js +0 -1
- package/web/dist/assets/Laws-CkykmQWu.js +0 -3
- package/web/dist/assets/Library-Guh9HBZU.js +0 -2
- package/web/dist/assets/OperatorHudView-DLGNulIY.js +0 -1
- package/web/dist/assets/Personal-BMtberL8.js +0 -2
- package/web/dist/assets/Tabs-uYJqfuQt.js +0 -1
- package/web/dist/assets/api-BxjLd7Qd.js +0 -1
- package/web/dist/assets/index-DA7BiaE5.js +0 -3
- package/web/dist/assets/index-dbbDGFDq.css +0 -1
- 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
|
-
`{{
|
|
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,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 `{{
|
|
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
|
|
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
|
|
@@ -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}}).
|
package/src/agents/reviewer.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. 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.
|
package/src/agents/security.md
CHANGED
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
<!-- bash: allow -->
|
|
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. 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.
|
package/src/agents/skeptic.md
CHANGED
|
@@ -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 `{{
|
|
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 `{{
|
|
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 `{{
|
|
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 `{{
|
|
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.
|
package/src/agents/steward.md
CHANGED
|
@@ -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 `{{
|
|
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.
|
package/src/agents/tester.md
CHANGED
|
@@ -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 `{{
|
|
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 `{{
|
|
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.
|
package/src/agents/visionary.md
CHANGED
|
@@ -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 `{{
|
|
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.
|
package/src/memory/README.md
CHANGED
|
@@ -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 `{{
|
|
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 `{{
|
|
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
|
|
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
|
|
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?"
|
package/src/skills/geneseed.md
CHANGED
|
@@ -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
|
|
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
|
|
package/src/skills/learn-mode.md
CHANGED
|
@@ -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)
|
|
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.
|
package/src/skills/profile.md
CHANGED
|
@@ -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
|
|
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
|
-
`
|
|
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
|