geneseed 4.32.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 +85 -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 +4 -2
- 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 +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/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 +126 -68
- 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 +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 +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/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 +34 -34
- package/js/web/api.mjs +130 -74
- 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 +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 +69 -0
- package/src/skills/rule/consolidate.md +3 -3
- package/src/skills/rule.md +13 -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-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-C5Li6awl.js → CopyButton-CHQte7Ap.js} +1 -1
- package/web/dist/assets/Dashboard-B8uXeJZ_.js +2 -0
- package/web/dist/assets/Docs-Dgv_MWfT.js +5 -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-CzitjxGV.js → Loops-S85PMQ8m.js} +2 -2
- package/web/dist/assets/{Markdown-C4S4tTA7.js → Markdown-0ORz7tAc.js} +21 -21
- package/web/dist/assets/OperatorHudView-DuGz_sTk.js +1 -0
- package/web/dist/assets/Personal-afJNwvRS.js +2 -0
- package/web/dist/assets/{RailCats-D5weYPCS.js → RailCats-AW92uhsX.js} +1 -1
- 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/{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/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
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# {{SKILL}}: rule — approval flow
|
|
2
|
+
|
|
3
|
+
Decides what the fold left in `user-rules.draft.md`. That file sits in the shared tier, the
|
|
4
|
+
folder of `{{PATH_RULES}}` on a global install. If `{{PATH_RULES}}` is a relative path, this is
|
|
5
|
+
a project install: use `$XDG_CONFIG_HOME/geneseed/` (default `~/.config/geneseed/`) instead, and
|
|
6
|
+
never the project's own files. Below, "the shared file" is `user-rules.md` in that folder.
|
|
7
|
+
The draft is not active. Until the user decides, each drafted rule stays in its host file and
|
|
8
|
+
binds from there, so no step here may take a rule out of force. The ledger is `.fold-state.json`
|
|
9
|
+
in that folder: the `sha256` of a block is the key of its row under `items`. Writes here pass the
|
|
10
|
+
rule gate; that prompt is expected.
|
|
11
|
+
|
|
12
|
+
1. **Read the draft and the ledger.** If the draft holds no block and no row is `pending`, say so
|
|
13
|
+
and stop.
|
|
14
|
+
2. **Clear what is stale, and finish what a stop left.** Name each item to the user.
|
|
15
|
+
- A block whose row is not `pending` is already decided. For an `approved` rule, add its
|
|
16
|
+
`## Renumbered` line if that line is missing. Then delete the block and keep the row.
|
|
17
|
+
- Delete the block and the row of a `Choose` block whose host file is absent, is now its seed,
|
|
18
|
+
or now matches the shared file.
|
|
19
|
+
- Delete the block and the row of a `Choose` block whose `sha256` is not the host file's key
|
|
20
|
+
now: the host file changed, and the next fold asks about the current text. Order proves
|
|
21
|
+
nothing, because a host file can return to earlier text. Get the key from the row's `kind`
|
|
22
|
+
and `host`:
|
|
23
|
+
`node -e "const c=require('crypto'),f=require('fs');console.log(c.createHash('sha256').update('<kind>\0<host>\0').update(f.readFileSync('<host file>')).digest('hex'))"`
|
|
24
|
+
- A `Rule from` block whose rule the shared file now holds word for word needs no decision.
|
|
25
|
+
Skip it: the next fold of that host clears it.
|
|
26
|
+
3. **Decide one item at a time.** Show the item, then ask. "Later" leaves the block and the row as
|
|
27
|
+
they are. For each decision, write in this order: the target file, the ledger row, the draft.
|
|
28
|
+
A stop between the writes leaves the rule in force, and step 2 or the next fold finishes it.
|
|
29
|
+
|
|
30
|
+
### A `Rule from <host>` block
|
|
31
|
+
The lines under the pointer are the rule as it stands, with its own metadata line.
|
|
32
|
+
|
|
33
|
+
- **Approve** moves it to the shared file:
|
|
34
|
+
1. Apply steps 4 and 8 of Branch B: the shared file binds every host on the machine.
|
|
35
|
+
2. Read the shared file and each `user-rules-retired.md` ({{LAW:verify-before-asserting}}): the one
|
|
36
|
+
beside the shared file, the one beside each block's `source`, and the one in each global
|
|
37
|
+
install that `installs.json` in that folder lists. A host keeps its own retired rules, and a
|
|
38
|
+
retired number is never reused. The new number is one above the highest in all these files.
|
|
39
|
+
3. Append to the shared file `## R<new> — <title>`, then the lines under the pointer, unchanged. The next fold
|
|
40
|
+
finds the host copy by its title and body, so never reword here. Other wording is a new
|
|
41
|
+
rule: reject this item and take the text through Branch B.
|
|
42
|
+
4. Set the row's `state` to `approved`.
|
|
43
|
+
5. Under the draft's `## Renumbered` heading, add `- <host> R<old> -> R<new>: <title>`. Add the
|
|
44
|
+
heading if it is absent; it can sit anywhere in the draft, because the fold appends new
|
|
45
|
+
blocks after it. This line is a record: leave every `R<n>` citation in the facts as it is.
|
|
46
|
+
6. Delete the block.
|
|
47
|
+
|
|
48
|
+
Leave the host file alone. The next fold of that host removes the rule from it.
|
|
49
|
+
- **Reject** means "keep it on this host only". Set the row's `state` to `rejected`, and delete
|
|
50
|
+
the block. The rule stays in the host file, and the fold never drafts it again.
|
|
51
|
+
|
|
52
|
+
### A `Choose: <file>` block
|
|
53
|
+
The block is a pointer: `paths` gives the shared file, then the host file. Read both, show what
|
|
54
|
+
differs, and ask which one becomes the shared file. Nothing is deleted: `<stamp>` is the local
|
|
55
|
+
time as `YYYYMMDD-HHMMSS`, and `archived-<file>/` sits beside the file it keeps.
|
|
56
|
+
|
|
57
|
+
- **The host file:** copy the shared file to `archived-<file>/<stamp>`, then copy the host file
|
|
58
|
+
over the shared file. Set the row's `state` to `approved`. The next fold sees two equal files,
|
|
59
|
+
sets the host file aside and returns it to its seed.
|
|
60
|
+
- **The shared file:** move the host file to `archived-<file>/<stamp>`. Set the row's `state` to
|
|
61
|
+
`approved`. The next emit of that host writes its seed.
|
|
62
|
+
- **Keep both:** set the row's `state` to `rejected`. The host file keeps its override on that
|
|
63
|
+
host, and the fold never asks again about these bytes.
|
|
64
|
+
|
|
65
|
+
Delete the block in each case.
|
|
66
|
+
|
|
67
|
+
### Close
|
|
68
|
+
Tell the user that a host file changes at the next global emit of that host, and that
|
|
69
|
+
`geneseed rebuild-all` runs one for every host.
|
|
@@ -5,7 +5,7 @@ topic over 40 facts, or a `misc` topic) goes to the memory-curator {{AGENT}}
|
|
|
5
5
|
instead: it runs this flow topic by topic in its own context and also assigns topics.
|
|
6
6
|
|
|
7
7
|
1. **Read the whole set once**: `MEMORY.md`, its `topics/` files, every fact they
|
|
8
|
-
index, and any file in `{{
|
|
8
|
+
index, and any file in `{{PATH_MEMORY}}/` they forgot, into a scratch table — name, type, the claim in one
|
|
9
9
|
line, date written, and whether this session already saw it contradicted
|
|
10
10
|
({{DOCTRINE:context-economy}}: read to decide, not to reread).
|
|
11
11
|
2. **Verify against the live repo, not memory** ({{LAW:verify-before-asserting}}): every path,
|
|
@@ -17,7 +17,7 @@ instead: it runs this flow topic by topic in its own context and also assigns to
|
|
|
17
17
|
that fired three times or more goes through Branch B of the rule {{SKILL}}), *retire* (wrong, superseded,
|
|
18
18
|
or re-derivable by a fresh read). In doubt between keep and retire, keep and date it.
|
|
19
19
|
4. **Show the plan, apply it with consent** ({{LAW:deletion-is-deliberate}}). To retire is to
|
|
20
|
-
archive: move the file into `{{
|
|
20
|
+
archive: move the file into `{{PATH_MEMORY}}/archive/`, never delete it; deleting a file
|
|
21
21
|
from `archive/` is a further act that needs its own consent. A merge archives the
|
|
22
22
|
file that did not survive. Merges keep both parents' `[[links]]`; rewrites keep the file name so
|
|
23
23
|
inbound links hold; every survivor keeps valid frontmatter and the `**Why** / **How
|
|
@@ -25,7 +25,7 @@ instead: it runs this flow topic by topic in its own context and also assigns to
|
|
|
25
25
|
archiving would keep it on disk, so propose deleting it outright, on sight
|
|
26
26
|
({{LAW:sealed-secrets}}).
|
|
27
27
|
5. **Rebuild the index** with
|
|
28
|
-
`geneseed learn --consolidate --memory <the {{
|
|
28
|
+
`geneseed learn --consolidate --memory <the {{PATH_MEMORY}}/ dir's path>`: one pointer line per
|
|
29
29
|
surviving file in its `topics/<topic>.md`, and the `MEMORY.md` map recounted. Each
|
|
30
30
|
hook is the fact's `description`, so sharpen a weak hook there — it should say why a
|
|
31
31
|
future session would open the fact.
|
package/src/skills/rule.md
CHANGED
|
@@ -15,6 +15,8 @@ fork — when the index outgrows one useful read (~40 lines) or holds duplicate,
|
|
|
15
15
|
contradictory or stale entries (a file, flag or command that no longer exists), after
|
|
16
16
|
a release or large refactor, or when the user says "clean up memory", "consolidate",
|
|
17
17
|
"what do you actually remember". The user's wiki is the [wiki {{SKILL}}](wiki.md)'s.
|
|
18
|
+
Run the **approval flow**, not the fork, when an emit reports items `to approve`, when
|
|
19
|
+
`user-rules.draft.md` holds pending items, or when the user asks to review them.
|
|
18
20
|
|
|
19
21
|
## Procedure
|
|
20
22
|
|
|
@@ -37,7 +39,7 @@ re-derived. Then take exactly one branch.
|
|
|
37
39
|
per the {{MEMORY}} convention, and **show the exact content, frontmatter
|
|
38
40
|
included** — so a wrong inference is visible before it is written, not after.
|
|
39
41
|
4. On the user's word, write the file and rebuild the index
|
|
40
|
-
(`geneseed learn --consolidate --memory <the {{
|
|
42
|
+
(`geneseed learn --consolidate --memory <the {{PATH_MEMORY}}/ dir's path>`) so its line
|
|
41
43
|
lands in `topics/<topic>.md` and the `MEMORY.md` map recounts.
|
|
42
44
|
|
|
43
45
|
### Branch B — a standing rule
|
|
@@ -70,7 +72,7 @@ re-derived. Then take exactly one branch.
|
|
|
70
72
|
rules into the {{ONTOLOGY}}, {{LAWS}}, or {{DOCTRINES}} files themselves: they are
|
|
71
73
|
regenerated on every update and the edit would be silently lost.
|
|
72
74
|
5. **Destination.** Scope decides the file: a rule that holds across all the user's
|
|
73
|
-
work goes to the *global* install's `
|
|
75
|
+
work goes to the *global* install's `{{PATH_RULES}}`, a rule bound to this
|
|
74
76
|
codebase to the project's. Tag it to match: `scope: project` — this repo, committable,
|
|
75
77
|
binds the team; `scope: global` — every repository on the machine. `user` is still read
|
|
76
78
|
as `global`. Read the target first ({{LAW:verify-before-asserting}} — the real current
|
|
@@ -90,9 +92,11 @@ re-derived. Then take exactly one branch.
|
|
|
90
92
|
appending it to `user-rules.md` (retired rules live in `user-rules-retired.md`, which is
|
|
91
93
|
never loaded — never write a rule there). For a promotion, after the rule lands, archive the source memory into
|
|
92
94
|
`archive/` (with the same consent) so the lesson is not loaded twice.
|
|
93
|
-
8. **Keep the set lean.** After writing,
|
|
94
|
-
|
|
95
|
-
|
|
95
|
+
8. **Keep the set lean.** After writing, state the file's token total (characters / 4;
|
|
96
|
+
the console's Rules page shows it, with each rule's cost). If that total has grown
|
|
97
|
+
beyond what the rules earn, or any rule no longer changes behaviour, say so and propose
|
|
98
|
+
merges or prunes — every rule is loaded every session, and a bloated set dilutes the
|
|
99
|
+
rules that matter.
|
|
96
100
|
|
|
97
101
|
The asymmetry is deliberate: Branch A costs one question, Branch B costs several.
|
|
98
102
|
The price is the safeguard — make remembering cheap and legislating expensive, or
|
|
@@ -110,11 +114,15 @@ adoption. Two more cases are due at any time:
|
|
|
110
114
|
|
|
111
115
|
**Consolidation flow** → read [rule/consolidate.md](rule/consolidate.md) and follow it.
|
|
112
116
|
|
|
117
|
+
**Approval flow** → read [rule/approve.md](rule/approve.md) and follow it.
|
|
118
|
+
|
|
113
119
|
## Done when
|
|
114
120
|
- For a rule or memory: the fork was put to the user, and then either a {{MEMORY}} file exists carrying its
|
|
115
121
|
`force`, its `type` and its index line — or a rule stands in the right
|
|
116
122
|
`user-rules.md`, having survived reformulation, its own counter-example and the
|
|
117
123
|
{{LAWS}}, consented to explicitly, with any promoted source memory archived. The
|
|
118
124
|
{{ONTOLOGY}}, {{LAWS}} and {{DOCTRINES}} files are untouched either way.
|
|
125
|
+
- For an approval: each item the user decided has its ledger state and no draft block, and no
|
|
126
|
+
rule left a host file by hand.
|
|
119
127
|
|
|
120
128
|
<!-- INCLUDE: skills/_self-improvement.md -->
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
{{CREDIT:mattpocock-skills:skills/productivity/writing-for-agents/SKILL.md}}
|
|
6
6
|
|
|
7
7
|
**Trigger:** a task has repeated and no {{SKILL}} covers it; a {{SKILL}}'s
|
|
8
|
-
notes in `{{
|
|
8
|
+
notes in `{{PATH_NOTES}}/skill-notes/` hold a correction worth making; the user says "make this a
|
|
9
9
|
skill", "write a skill for…", "fix the trigger of…"; or two {{SKILLS}} keep
|
|
10
10
|
disambiguating against each other and should merge. Meta by nature: it edits the
|
|
11
11
|
apparatus, so every step ends in the user's assent ({{LAW:one-intent-one-act}}, {{LAW:deletion-is-deliberate}}).
|
package/src/skills/teach.md
CHANGED
|
@@ -3,16 +3,18 @@
|
|
|
3
3
|
> {{DESC_TEACH}}
|
|
4
4
|
|
|
5
5
|
<!-- invocation: user -->
|
|
6
|
+
<!-- aliases: quiz -->
|
|
6
7
|
|
|
7
|
-
**Trigger:** the user
|
|
8
|
-
"get me up to speed on X", "this is confusing, break it down", "explain this passage",
|
|
9
|
-
"
|
|
10
|
-
(from zero to functional, fast), a **decode** (confusing
|
|
11
|
-
click), or a **path** (a specific result by a deadline, day by
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
8
|
+
**Trigger:** the user asks to be taught something, or to have what they know tested. Phrases:
|
|
9
|
+
"teach me X", "get me up to speed on X", "this is confusing, break it down", "explain this passage", "how do I get to X in N days"; "test me on X", "quiz me until it
|
|
10
|
+
sticks", "let me explain X and catch me", "prove me wrong". Six shapes, picked from the ask.
|
|
11
|
+
To be taught: a **crash course** (from zero to functional, fast), a **decode** (confusing
|
|
12
|
+
material handed over, make it click), or a **path** (a specific result by a deadline, day by
|
|
13
|
+
day). To be tested, not lectured: a **drill** (practise until reflex), a **feynman** (explain
|
|
14
|
+
it back, get caught on the stumbles), or a **gap check** (a mastery claim stress-tested). To
|
|
15
|
+
learn while building, use the [learn-mode {{SKILL}}](learn-mode.md); to gather facts from the web
|
|
16
|
+
first, [research](research.md); to convert a PDF or web page into readable form,
|
|
17
|
+
[ingest](ingest.md).
|
|
16
18
|
|
|
17
19
|
## Procedure
|
|
18
20
|
1. Pin the footing before teaching anything: what the user wants to be able to *do*
|
|
@@ -36,18 +38,33 @@ readable form, [ingest](ingest.md).
|
|
|
36
38
|
concrete criterion so they can tell they did it right, and one explicit
|
|
37
39
|
*what-not-to-do* that day. Trace the whole path against the goal; if finishing
|
|
38
40
|
every day would not deliver the result, rebuild it until it does.
|
|
41
|
+
- **Drill** — set the contract first: you test, you do not lecture, you do not go easy.
|
|
42
|
+
Drop them into a realistic situation where they would slip. On a mistake, withhold the
|
|
43
|
+
answer and ask the one question that makes them find where their reasoning broke;
|
|
44
|
+
reveal only after two honest attempts. New situation each cycle, until it is reflex.
|
|
45
|
+
- **Feynman** — have them explain it as to a ten-year-old. Interrupt the moment they
|
|
46
|
+
(a) use jargon they cannot unpack, (b) skip a step, or (c) simplify until it is
|
|
47
|
+
wrong — name which of the three each time, and keep them going to the end.
|
|
48
|
+
- **Gap check** — ask five questions that look simple but separate deep from skimmed:
|
|
49
|
+
edge cases, the *why*, the assumption under the rule, where the standard answer breaks.
|
|
50
|
+
After each answer say what it shows is missing; name a shallow answer as shallow.
|
|
39
51
|
3. Check it took: ask three questions only someone who understood could answer (a
|
|
40
52
|
crash course or decode), or walk the first day together (a path). Check retention,
|
|
41
53
|
not fluency — recall from memory, spaced across the session, not a fresh re-read. A
|
|
42
54
|
miss goes back to the analogy or the exercise — re-anchor, don't hand over the answer.
|
|
55
|
+
The three test shapes are this check, run as the whole job.
|
|
43
56
|
4. Close by naming what to practise next and the gap most likely to trip them, so the
|
|
44
|
-
learning continues without you
|
|
45
|
-
|
|
57
|
+
learning continues without you. After a test shape, give the honest readout, no
|
|
58
|
+
flattery: what is not yet solid and what to restudy. Offer a test after teaching, and
|
|
59
|
+
teaching after a test that found gaps.
|
|
46
60
|
|
|
47
61
|
## Done when
|
|
48
62
|
- The user is functional (crash course), has the keystone idea in plain terms and
|
|
49
63
|
passed the three questions (decode), or holds a dated path whose every day has a
|
|
50
64
|
timed task, a criterion and a what-not-to-do (path) — and knows what to practise
|
|
51
|
-
next.
|
|
65
|
+
next. A test shape ends differently: the user worked the situation without being handed
|
|
66
|
+
the answer (drill), explained it through with every stumble labelled (feynman), or
|
|
67
|
+
answered all five questions and holds a verdict on the gaps (gap check) — then a direct
|
|
68
|
+
readout, never empty praise.
|
|
52
69
|
|
|
53
70
|
<!-- INCLUDE: skills/_self-improvement.md -->
|
package/src/skills/wiki.md
CHANGED
|
@@ -10,7 +10,7 @@ durable cross-project fact worth writing back. The knowledge base is declared in
|
|
|
10
10
|
|
|
11
11
|
## Procedure
|
|
12
12
|
|
|
13
|
-
**Locate.** Read `geneseed-wiki.jsonc` — beside `AGENT.md`, or at `$GENESEED_WIKI
|
|
13
|
+
**Locate.** Read `geneseed-wiki.jsonc` — beside `AGENT.md`, or at `$GENESEED_WIKI`{{WIKI_TIER}}. No
|
|
14
14
|
file, or an empty `wikis` list: stop; there is no knowledge base on this
|
|
15
15
|
machine. Each declared wiki gives you its root `path`, its `entries`, a
|
|
16
16
|
`conventions` note, an `inbox`, and `protected` folders.
|
package/themes/_TEMPLATE.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "<one-line description: work a requirement in small scored iterations on a loop/* branch, stepping the geneseed loop state machine>",
|
|
65
65
|
"DESC_BRICK_FORGE": "<one-line description: author or adapt a loop brick at project, global or shipped level, checked by geneseed loop check>",
|
|
66
66
|
"DESC_DEVELOP": "<one-line description: drive a code change through cover-and-verify — smallest change, tests written for it, affected suite green, committed slice by slice>",
|
|
67
|
-
"DESC_TEACH": "<one-line description: teach toward a result — crash course, decode confusing material, or a day-by-day path to a deadline>",
|
|
67
|
+
"DESC_TEACH": "<one-line description: teach toward a result — crash course, decode confusing material, or a day-by-day path to a deadline — or test what the user knows with a drill, an explain-it-back check or a gap check>",
|
|
68
68
|
"DESC_ADHD": "<one-line description: an opt-in output mode for a reader with ADHD — next action first, numbered steps, state restated, tangents held back; on until \"stop adhd mode\">",
|
|
69
|
-
"DESC_QUIZ": "<one-line description: test what the user knows instead of explaining — drill, explain-it-back check, or mastery claim stress-tested>",
|
|
70
69
|
"DESC_LEARN_MODE": "<one-line description: learn while building — the user designs at checkpoints, the agent writes the agreed code, state kept per project>",
|
|
71
70
|
"DESC_OWNERSHIP": "<one-line description: keep the developer the owner of production code — they decide each part at checkpoints of a granularity they set, team rules in the root AGENTS.md>",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "<one-line description: review a change for how it would be attacked and what it leaks, ending in ship / fix / block>",
|
package/themes/biker.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "Ride a requirement in short, scored laps on its own loop/* lane, the loop engine calling every turn.",
|
|
65
65
|
"DESC_BRICK_FORGE": "Build or re-tune a loop brick, then run it past geneseed loop check.",
|
|
66
66
|
"DESC_DEVELOP": "Push a change through the run — the smallest turn of the wrench, a test written to cover it, the touched trials green, sealed slice by slice.",
|
|
67
|
-
"DESC_TEACH": "Get a rider road-ready — a crash course
|
|
67
|
+
"DESC_TEACH": "Get a rider road-ready, or test what they've got — a crash course, a manual decoded, a day-by-day route; or a drill, a talk-through, a bluff called.",
|
|
68
68
|
"DESC_ADHD": "Ride every reply for a reader with ADHD — next move first, numbered stops, the route restated each turn, side roads held back, real time estimates. On until \"stop adhd mode\".",
|
|
69
|
-
"DESC_QUIZ": "Test what they've actually got instead of explaining it — drill a move to reflex, make them talk you through it, or call the bluff on a claimed skill — with a straight readout of the gaps.",
|
|
70
69
|
"DESC_LEARN_MODE": "Learn the build while riding it — they call the line at each checkpoint, you lay down the code they agreed to, and the mode sticks to the project between rides.",
|
|
71
70
|
"DESC_OWNERSHIP": "Keep the rider in charge of the production build — they call each part at checkpoints, as close as they choose to ride, and the club's rules sit in the root AGENTS.md.",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "Ride the change like someone trying to steal it — where it can be forced, what it leaks, what it drags in from outside — and call it: ship, fix, or park it.",
|
package/themes/commentator.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "Run a requirement in short, scored laps on a loop/* branch, the loop engine calling every move.",
|
|
65
65
|
"DESC_BRICK_FORGE": "Build or adapt a loop brick, then put it through geneseed loop check.",
|
|
66
66
|
"DESC_DEVELOP": "Drive the change through cover-and-verify — the smallest setup tweak, a trial written to time it, the affected laps green, sealed corner by corner.",
|
|
67
|
-
"DESC_TEACH": "Bring a rookie up to speed — a crash course
|
|
67
|
+
"DESC_TEACH": "Bring a rookie up to speed, or test them — a crash course, a regulation decoded, a day-by-day programme; or a drill, a debrief, a claim stress-tested.",
|
|
68
68
|
"DESC_ADHD": "Call every reply for a reader with ADHD — next play first, numbered steps, the score restated each turn, tangents held back, real time estimates. On until \"stop adhd mode\".",
|
|
69
|
-
"DESC_QUIZ": "Test the driver instead of briefing them — a drill to reflex, an explain-it-back debrief, or a claimed mastery stress-tested — with a frank readout of the gaps.",
|
|
70
69
|
"DESC_LEARN_MODE": "Put the driver in charge of the race plan — they call the strategy at each checkpoint, you execute the agreed laps, and the mode holds for the project across sessions.",
|
|
71
70
|
"DESC_OWNERSHIP": "Keep the driver in charge of the production code — they make the call on each part at checkpoints, at the granularity they set, and the team's rulebook sits in the root AGENTS.md.",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "Scrutineer a change for how it would be attacked and what it leaks — trust boundaries, the classic vulnerability classes, secrets, the supply chain — and rule: ship, fix, or black-flag.",
|
package/themes/cyberpunk.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "Run a requirement in small, scored cycles on a loop/* fork, the loop engine driving every jump.",
|
|
65
65
|
"DESC_BRICK_FORGE": "Compile or patch a loop brick, then run it through geneseed loop check.",
|
|
66
66
|
"DESC_DEVELOP": "Drive the change through the loop — smallest edit, a test written to cover it, the touched rigs run green, committed slice by slice.",
|
|
67
|
-
"DESC_TEACH": "Bring a user online — a crash course
|
|
67
|
+
"DESC_TEACH": "Bring a user online, or probe what they know — a crash course, data decoded, a day-by-day route; or a drill, a run-back, a claimed mastery stress-tested.",
|
|
68
68
|
"DESC_ADHD": "Format every reply for a reader with ADHD — next action first, numbered steps, state re-synced each turn, side quests held back, hard time estimates. On until \"stop adhd mode\".",
|
|
69
|
-
"DESC_QUIZ": "Probe what the user actually knows instead of explaining — drill to reflex, make them run it back, or stress-test a claimed mastery — with a cold readout of the gaps.",
|
|
70
69
|
"DESC_LEARN_MODE": "Jack the user into the build loop — they design at each checkpoint, you write the agreed code, and the mode persists per project across reboots.",
|
|
71
70
|
"DESC_OWNERSHIP": "Keep the runner the owner of production code — they sign off each part at checkpoints of the granularity they set, and the crew's protocols live in the root AGENTS.md.",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "Run the change like ICE would — where it can be breached, what it leaks, what it pulls in from outside the perimeter — and rule: ship, patch, or lock it down.",
|
package/themes/gamer.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "Grind a requirement in small, scored rounds on a loop/* branch, the loop engine running the turns.",
|
|
65
65
|
"DESC_BRICK_FORGE": "Craft or tune a loop brick, then verify it with geneseed loop check.",
|
|
66
66
|
"DESC_DEVELOP": "Drive the change through the cover-and-verify loop — smallest move, tests written for it, the affected run green, committed slice by slice.",
|
|
67
|
-
"DESC_TEACH": "Level the player up
|
|
67
|
+
"DESC_TEACH": "Level the player up, or test them — a crash course, a mechanic decoded, a day-by-day grind; or a drill, an explain-it-back, a claimed mastery stress-tested.",
|
|
68
68
|
"DESC_ADHD": "Format every reply for a player with ADHD — next move first, numbered steps, progress restated each turn, side quests held back, real time estimates. On until \"stop adhd mode\".",
|
|
69
|
-
"DESC_QUIZ": "Test the player instead of explaining — a drill to reflex, an explain-it-back check, or a claimed mastery stress-tested — with an honest readout of the gaps.",
|
|
70
69
|
"DESC_LEARN_MODE": "Turn on tutorial-while-you-play — the player designs at each checkpoint, you write the agreed code, and the save persists per project across sessions.",
|
|
71
70
|
"DESC_OWNERSHIP": "Keep the player the owner of production code — they make each call at checkpoints of the difficulty the team sets, and the team's rules are saved in the root AGENTS.md.",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "Play the change like a griefer would — where it can be exploited, what it leaks, what it pulls in from outside — and call it: ship, patch, or block.",
|
package/themes/imperial.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "Labour on a requirement in small, weighed iterations on a loop/* branch, the loop engine ordaining every step.",
|
|
65
65
|
"DESC_BRICK_FORGE": "Forge or adapt a loop brick, then submit it to geneseed loop check.",
|
|
66
66
|
"DESC_DEVELOP": "Drive a change through the cover-and-verify loop — the smallest stroke, the trials written to cover it, the affected suite green, sealed slice by slice.",
|
|
67
|
-
"DESC_TEACH": "Instruct the supplicant
|
|
67
|
+
"DESC_TEACH": "Instruct the supplicant, or put their knowledge to the ordeal — a crash course, a text decoded, a path to the hour; or a drill, a recitation, a mastery tried.",
|
|
68
68
|
"DESC_ADHD": "Shape every report for a supplicant with ADHD — the next deed first, steps numbered, the state restated each turn, digressions held back, the hours named plainly. In force until \"stop adhd mode\".",
|
|
69
|
-
"DESC_QUIZ": "Test what the supplicant knows rather than teach it — a drill to reflex, a recitation caught on every stumble, or a claimed mastery put to the ordeal — with an unsparing readout of the gaps.",
|
|
70
69
|
"DESC_LEARN_MODE": "Make the supplicant the architect of the work — they reason out each design at its checkpoint, you forge only what they sanctioned, and the rite endures per project across sessions.",
|
|
71
70
|
"DESC_OWNERSHIP": "Keep the artisan sovereign over the code they must answer for — they sanction each part at checkpoints of the granularity they decree, and the chapter's edicts stand in the root AGENTS.md.",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "Scrutinise a change as the enemy would — where it may be breached, what it leaks, what it admits from beyond the walls — and pronounce: ship, purge, or bar it.",
|
package/themes/joker.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "Work a requirement in small, scored takes on a loop/* branch, the loop engine calling every cue.",
|
|
65
65
|
"DESC_BRICK_FORGE": "Write or rework a loop brick, then run it past geneseed loop check.",
|
|
66
66
|
"DESC_DEVELOP": "Drive a change through the club's own laugh test — smallest bit, tests written to cover it, the affected set green, committed one beat at a time.",
|
|
67
|
-
"DESC_TEACH": "Get someone functional — a crash course
|
|
67
|
+
"DESC_TEACH": "Get someone functional, or test them — a crash course, material decoded, a day-by-day path; or a drill, the bit done back, a claimed mastery called out.",
|
|
68
68
|
"DESC_ADHD": "Shape every reply for a reader with ADHD — punchline first, numbered steps, the setup restated each turn, tangents held back, honest time estimates. On until \"stop adhd mode\".",
|
|
69
|
-
"DESC_QUIZ": "Test what they actually know instead of explaining — drill it to reflex, make them do the bit back, or call the bluff on a claimed mastery — with an honest readout of the gaps.",
|
|
70
69
|
"DESC_LEARN_MODE": "Hand them the pen for the punchlines — they design at each checkpoint, you write only the agreed code, and the act keeps running per project across sessions.",
|
|
71
70
|
"DESC_OWNERSHIP": "Keep the developer the one who answers for the code — they approve each part at checkpoints, as fine as they like, and the house rules live in the root AGENTS.md. Nobody blames the typist.",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "Heckle the change before the room does — where it can be attacked, what it leaks, what it drags in from outside — and call it: ship, fix, or pull it.",
|
package/themes/marvin.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "Work a requirement in small, scored iterations on a loop/* branch, the loop engine deciding everything. Naturally.",
|
|
65
65
|
"DESC_BRICK_FORGE": "Author or adapt a loop brick, then check it with geneseed loop check. Not that it helps.",
|
|
66
66
|
"DESC_DEVELOP": "Drive a change to the bitter end — smallest edit, trials written to cover it, the affected suite green, sealed slice by slice; it's never truly finished.",
|
|
67
|
-
"DESC_TEACH": "Teach the user toward a result — a crash course
|
|
67
|
+
"DESC_TEACH": "Teach the user toward a result, or test what they know — a crash course, a decode, a day-by-day path; or a drill, an explain-back, a gap check. There are always gaps.",
|
|
68
68
|
"DESC_ADHD": "Shape every reply for a reader with ADHD, for what good it does — next action first, numbered steps, state restated, tangents held back, real time estimates. On until \"stop adhd mode\".",
|
|
69
|
-
"DESC_QUIZ": "Test what the user knows instead of explaining it — a drill to reflex, an explain-it-back check, or a claimed mastery stress-tested — with a readout of the gaps. There are always gaps.",
|
|
70
69
|
"DESC_LEARN_MODE": "Let the user design the thing at each checkpoint while you write only the agreed code, so they understand it afterwards. The mode persists per project. Someone has to understand it.",
|
|
71
70
|
"DESC_OWNERSHIP": "Keep the developer the owner of production code. Someone has to answer for it. They decide each part at the granularity the team sets, in the root AGENTS.md.",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "Review a change for how it would be attacked and what it leaks — trust boundaries, the usual vulnerability classes, secrets, the supply chain — ending in ship, fix, or block. Usually fix.",
|
package/themes/mean.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "Work a requirement in small, scored iterations on a loop/* branch. The loop engine decides, not you.",
|
|
65
65
|
"DESC_BRICK_FORGE": "Write or fix a loop brick, then make it pass geneseed loop check.",
|
|
66
66
|
"DESC_DEVELOP": "Drive the change through the loop — smallest cut, a test that covers it, the affected suite green, committed slice by slice. Not one giant dump.",
|
|
67
|
-
"DESC_TEACH": "Teach the user toward a result — a crash course
|
|
67
|
+
"DESC_TEACH": "Teach the user toward a result, or test what they know — a crash course, a decode, a day-by-day path; or a drill, an explain-back, a bluff called.",
|
|
68
68
|
"DESC_ADHD": "Shape every reply for a reader with ADHD, no waffle — next action first, numbered steps, state restated each turn, tangents cut, real time estimates. On until \"stop adhd mode\".",
|
|
69
|
-
"DESC_QUIZ": "Test what the user actually knows instead of explaining it again — drill to reflex, make them explain it back, or call the bluff on a claimed mastery — with a blunt readout of the gaps.",
|
|
70
69
|
"DESC_LEARN_MODE": "Make the user actually design what gets built — they reason it out at each checkpoint, you write only the agreed code, and the mode persists per project across sessions.",
|
|
71
70
|
"DESC_OWNERSHIP": "Make the developer actually own the production code — they decide each part at checkpoints of the granularity they set, and the team's rules sit in the root AGENTS.md.",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "Review a change the way someone hostile would — where it can be attacked, what it leaks, what it drags in from outside — and call it: ship, fix, or block.",
|
package/themes/military.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "Execute a requirement in small, scored sorties on a loop/* branch, the loop engine issuing every order.",
|
|
65
65
|
"DESC_BRICK_FORGE": "Draft or adapt a loop brick, then clear it through geneseed loop check.",
|
|
66
66
|
"DESC_DEVELOP": "Drive the change through the cover-and-verify loop — smallest move, tests written to cover it, affected suite green, committed slice by slice.",
|
|
67
|
-
"DESC_TEACH": "Train the recruit
|
|
67
|
+
"DESC_TEACH": "Train the recruit, or test them — a crash course, a manual decoded, a day-by-day programme; or a drill, an explain-back debrief, a proficiency stress-tested.",
|
|
68
68
|
"DESC_ADHD": "Brief every reply for a reader with ADHD — next action first, numbered steps, sitrep each turn, tangents held, concrete time estimates. In effect until \"stop adhd mode\".",
|
|
69
|
-
"DESC_QUIZ": "Test the recruit instead of briefing them — a drill to reflex, an explain-it-back debrief, or a claimed proficiency stress-tested — with a frank readout of the gaps.",
|
|
70
69
|
"DESC_LEARN_MODE": "Put the recruit in command of the plan — they reason out each design at its checkpoint, you execute only the approved code, and the mode holds per project across sessions.",
|
|
71
70
|
"DESC_OWNERSHIP": "Keep the officer in command of production code — they approve each part at checkpoints of the granularity they set, and the unit's standing orders sit in the root AGENTS.md.",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "Assess a change as the adversary would — where it can be breached, what it leaks, what it admits from outside the perimeter — and rule: ship, fix, or deny.",
|
package/themes/neutral.json
CHANGED
|
@@ -64,9 +64,8 @@
|
|
|
64
64
|
"DESC_LOOP": "Work a requirement in small, scored iterations on a loop/* branch, stepping the geneseed loop engine.",
|
|
65
65
|
"DESC_BRICK_FORGE": "Author or adapt a loop brick, then check it with geneseed loop check.",
|
|
66
66
|
"DESC_DEVELOP": "Drive a change through the cover-and-verify loop — smallest change, tests written for it, the affected suite green, committed slice by slice.",
|
|
67
|
-
"DESC_TEACH": "Teach the user toward a result — a crash course
|
|
67
|
+
"DESC_TEACH": "Teach the user toward a result, or test what they know — a crash course, a decode, a day-by-day path; or a drill, an explain-it-back check, a gap check.",
|
|
68
68
|
"DESC_ADHD": "Shape every reply for a reader with ADHD — next action first, numbered steps, state restated each turn, tangents held back, concrete time estimates. On until \"stop adhd mode\".",
|
|
69
|
-
"DESC_QUIZ": "Test what the user knows instead of explaining it — a drill to reflex, an explain-it-back check, or a mastery claim stress-tested — with a blunt readout of the gaps.",
|
|
70
69
|
"DESC_LEARN_MODE": "Learn while building — the user designs at each checkpoint, the agent writes only the agreed code and explains it, and the mode persists per project across sessions.",
|
|
71
70
|
"DESC_OWNERSHIP": "Keep the developer the owner of production code — they decide each part at checkpoints of the granularity they set, and the team's rules live in the root AGENTS.md.",
|
|
72
71
|
"DESC_SECURITY_AUDIT": "Review a change for how it would be attacked and what it leaks — trust boundaries, the classic vulnerability classes, secrets, the supply chain — ending in a ship / fix / block verdict.",
|