geneseed 5.0.3 → 5.1.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 +83 -0
- package/README.md +3 -3
- package/SHIPPED.md +2 -2
- package/adapters/claude-code/README.md +5 -1
- package/adapters/openclaude/README.md +3 -1
- package/adapters/opencode/plugins/geneseed-workflow.js +1 -1
- package/adapters/opencode/workflows/_runtime.js +1 -1
- package/bin/geneseed-cli.mjs +3 -0
- package/bin/geneseed-hook.mjs +10 -2
- package/docs/PRD.md +1 -1
- package/docs/README.md +4 -1
- package/docs/concepts/enforcement-table.md +1 -1
- package/docs/concepts/exclusions.md +1 -1
- package/docs/concepts/factories.md +203 -0
- package/docs/concepts/hooks.md +1 -1
- package/docs/concepts/host-matrix.md +1 -0
- package/docs/concepts/loop-gates.md +6 -0
- package/docs/concepts/loops.md +1 -0
- package/docs/concepts/rules.md +1 -1
- package/docs/concepts/shared-tier.md +14 -0
- package/docs/extending.md +5 -1
- package/docs/guides/autostart.md +2 -0
- package/docs/guides/migrate.md +1 -1
- package/docs/guides/run-a-factory.md +116 -0
- package/docs/guides/set-up-ownership.md +1 -0
- package/docs/guides/upgrade-to-5.md +2 -2
- package/docs/reference/factory-actions.md +22 -0
- package/docs/reference/loop-actions.md +1 -1
- package/docs/reference/plugin-activity.md +1 -1
- package/docs/web-ui.md +47 -2
- package/harness.config.json +1 -1
- package/js/README.md +21 -2
- package/js/build/args.mjs +44 -12
- package/js/build/emit-claude.mjs +3 -0
- package/js/build/emit-opencode.mjs +4 -0
- package/js/build/retired-skills.mjs +158 -0
- package/js/build/source.mjs +41 -2
- package/js/cli-table.json +193 -3
- package/js/factory/cli.mjs +194 -0
- package/js/factory/graph.mjs +309 -0
- package/js/factory/registry.mjs +71 -0
- package/js/factory/state.mjs +511 -0
- package/js/hosts/activity.mjs +3 -3
- package/js/hosts/done-checks.mjs +3 -2
- package/js/hosts/geneseed-dir.mjs +1 -1
- package/js/hosts/gitref.mjs +21 -0
- package/js/hosts/hooks-context.mjs +63 -9
- package/js/hosts/hooks-prims.mjs +1 -1
- package/js/hosts/memory-files.mjs +4 -2
- package/js/hosts/settings.mjs +5 -4
- package/js/inspect/checks-authoring.mjs +11 -1
- package/js/inspect/cost.mjs +91 -5
- package/js/inspect/doctor.mjs +2 -1
- package/js/inspect/inventory.mjs +1 -1
- package/js/loop/catalog.mjs +30 -12
- package/js/loop/cli.mjs +27 -15
- package/js/loop/graph.mjs +13 -4
- package/js/loop/registry.mjs +65 -28
- package/js/loop/state.mjs +18 -8
- package/js/maintain/migrate.mjs +39 -25
- package/js/web/api.mjs +43 -1
- package/js/web/catalog.mjs +38 -2
- package/js/web/daemon.mjs +191 -6
- package/js/web/handler.mjs +27 -5
- package/js/web/routes.mjs +10 -3
- package/js/web/server.mjs +4 -1
- package/package.json +1 -1
- package/registry.json +14 -0
- package/src/AGENT.md.tmpl +5 -7
- package/src/bricks/checks.md +62 -0
- package/src/bricks/docs-update.md +5 -0
- package/src/bricks/holdout-write.md +23 -0
- package/src/bricks/holdout.md +25 -0
- package/src/bricks/intake.md +27 -0
- package/src/bricks/merge-gate.md +31 -0
- package/src/bricks/pr-open.md +21 -0
- package/src/bricks/retro.md +22 -0
- package/src/bricks/review-panel.md +43 -0
- package/src/bricks/spec.md +20 -6
- package/src/bricks/test.md +4 -1
- package/src/bricks/triage.md +19 -0
- package/src/doctrines/comms.md +29 -41
- package/src/doctrines/craft.md +3 -10
- package/src/doctrines/ops.md +4 -15
- package/src/doctrines/rigor.md +1 -5
- package/src/factories/analysis-to-build.json +52 -0
- package/src/factories/bug-report-to-fix.json +50 -0
- package/src/factories/issue-to-pr.json +67 -0
- package/src/skills/_checkpoints.md +1 -0
- package/src/skills/adhd.md +1 -1
- package/src/skills/factory-forge.md +115 -0
- package/src/skills/factory.md +196 -0
- package/src/skills/loop.md +3 -2
- package/src/skills/parallel-agents.md +1 -1
- package/src/skills/workflow.md +2 -1
- package/themes/_TEMPLATE.json +4 -2
- package/themes/biker.json +4 -2
- package/themes/commentator.json +4 -2
- package/themes/cyberpunk.json +4 -2
- package/themes/gamer.json +4 -2
- package/themes/imperial.json +4 -2
- package/themes/joker.json +4 -2
- package/themes/marvin.json +4 -2
- package/themes/mean.json +4 -2
- package/themes/military.json +4 -2
- package/themes/neutral.json +4 -2
- package/themes/pirate.json +4 -2
- package/themes/sports.json +4 -2
- package/themes/verstappen.json +4 -2
- package/themes/wizard.json +4 -2
- package/web/dist/assets/ActiveLoops-BTHIaRhn.js +1 -0
- package/web/dist/assets/{Activity-Ck_Xffpo.js → Activity-CpkBwpu7.js} +1 -1
- package/web/dist/assets/{ActivityDetail-CBxVS4mU.js → ActivityDetail-DTPziZWM.js} +1 -1
- package/web/dist/assets/{Bonsai-BlOwsvW6.js → Bonsai-hiG_gGNU.js} +1 -1
- package/web/dist/assets/{CopyButton-DFMOIGbe.js → CopyButton-DUIUfNp6.js} +1 -1
- package/web/dist/assets/Dashboard-Dnw6EyX7.js +2 -0
- package/web/dist/assets/{Docs-D_2Jt6gU.js → Docs-BEET_l16.js} +2 -2
- package/web/dist/assets/Factories-D6KXkfWw.js +1 -0
- package/web/dist/assets/{GreenhouseView-WalcX5bp.js → GreenhouseView-BKxy5apE.js} +1 -1
- package/web/dist/assets/{Installs-UGiPDMDt.js → Installs-CnFVlVD0.js} +3 -3
- package/web/dist/assets/{JournalView-CZtXQz-v.js → JournalView-ChFitHjo.js} +1 -1
- package/web/dist/assets/{Kits-XQHsazCN.js → Kits-CcR-OlwQ.js} +1 -1
- package/web/dist/assets/Laws-B1s5idOg.js +4 -0
- package/web/dist/assets/LibRows-BZgdbI1l.js +1 -0
- package/web/dist/assets/Library-x6TkkEVF.js +3 -0
- package/web/dist/assets/Loops-BH93KKxn.js +2 -0
- package/web/dist/assets/{OperatorHudView-CeDw5qMB.js → OperatorHudView-BO0aIKPL.js} +1 -1
- package/web/dist/assets/{Personal-PVmGA2-M.js → Personal-CE_0Vhh0.js} +2 -2
- package/web/dist/assets/{Settings-DWuxwh4i.js → Settings-CbpZvVN_.js} +1 -1
- package/web/dist/assets/{Tabs-d2RIRAKT.js → Tabs-C2oW7oEj.js} +1 -1
- package/web/dist/assets/api-DLDVY3K-.js +1 -0
- package/web/dist/assets/{index-BNttaGQb.js → index-BQwOmbor.js} +3 -3
- package/web/dist/assets/index-CuIop_pO.css +1 -0
- package/web/dist/index.html +3 -3
- package/web/dist/assets/Dashboard-BUdUTjbB.js +0 -2
- package/web/dist/assets/Laws-B6A55S-2.js +0 -4
- package/web/dist/assets/Library-D7L0Wdbh.js +0 -3
- package/web/dist/assets/Loops-C0loS73u.js +0 -2
- package/web/dist/assets/RailCats-BGZnJ6fa.js +0 -1
- package/web/dist/assets/api-BMFDSXoB.js +0 -1
- package/web/dist/assets/index-BEI5ugYQ.css +0 -1
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
# {{SKILL}}: factory-forge
|
|
2
|
+
|
|
3
|
+
> {{DESC_FACTORY_FORGE}}
|
|
4
|
+
|
|
5
|
+
**Trigger:** the user wants a new factory, or to change one. For example: "make a factory that
|
|
6
|
+
takes a feature request to a PR", "add a security scan before the PR opens", "send red CI back
|
|
7
|
+
to the loop three times, not two".
|
|
8
|
+
|
|
9
|
+
## Procedure
|
|
10
|
+
|
|
11
|
+
1. **See what exists:** `geneseed factory list` (the factories) and `geneseed loop check` (every
|
|
12
|
+
brick with its outcomes, and every loop template). Adapting a factory starts from its file.
|
|
13
|
+
2. **Interview, one question at a time:**
|
|
14
|
+
- **name** — kebab-case, the file stem. A factory named like an existing one replaces it at
|
|
15
|
+
every level below; say so to the user.
|
|
16
|
+
- **what it does** — one line; it becomes `description`. A short `category` (`development`).
|
|
17
|
+
- **input** — what one run takes: a request, a document, or a GitHub or GitLab issue. The
|
|
18
|
+
first stage reads it, usually `intake`.
|
|
19
|
+
- **stages**, in order — each a brick name or `loop:<template>` (a whole loop: outcomes `pass`
|
|
20
|
+
and `fail`).
|
|
21
|
+
- **forks** — where the work takes one way or another, use a brick with named outcomes (a
|
|
22
|
+
**fork**, such as `triage`: `bug`, `feature`, `deps`, `refactor`, `docs`, `fail`). Give each
|
|
23
|
+
named outcome its own edge to its own **lane**: a loop for work that changes code, or a brick
|
|
24
|
+
where a loop adds nothing (`docs` → `docs-update`). Every lane joins the same path after it
|
|
25
|
+
(`checks`, then `review-panel` and `holdout`, then `pr-open` and `merge-gate`). An outcome the factory does not offer goes to
|
|
26
|
+
`$stop`.
|
|
27
|
+
- **where a human gates** — a gate belongs to the brick (`gate: human` in its frontmatter,
|
|
28
|
+
narrowed by `gateOn`), never to the factory. A stage that must hold for a person uses a
|
|
29
|
+
gated brick: an existing one, or one from step 4.
|
|
30
|
+
- **routes** — for every outcome of every stage: the next stage, `$close` or `$stop`.
|
|
31
|
+
- **failures that route back** — each one to an earlier stage, with its `max` from 1 to 5.
|
|
32
|
+
Each becomes a `cycles` entry. After a fork, route back to `$lane`, the lane the run took,
|
|
33
|
+
and start the cycle's `nodes` with `$lane`. Only a `fail` routes back to a loop: `checks`
|
|
34
|
+
`error` and `merge-gate` `none` also carry environment failures (a failed fetch, a missing
|
|
35
|
+
tool, CI pending at the bound) that no loop can fix, so route them on or to `$stop`, never
|
|
36
|
+
to a loop or `$lane` (`factory check` refuses that route).
|
|
37
|
+
- **rules** — optional lines every stage receives ("Never merge.").
|
|
38
|
+
- **level** — project `<repo>/.geneseed/factories/` (this repository, shared with the team
|
|
39
|
+
once committed) or global `$XDG_CONFIG_HOME/geneseed/factories/` (default
|
|
40
|
+
`~/.config/geneseed/factories/`, every project on this machine). Shipped `src/factories/`
|
|
41
|
+
only inside the Geneseed repository. At project level, when
|
|
42
|
+
`git check-ignore -q .geneseed/factories/<name>.json` exits 0, the repository's
|
|
43
|
+
`.geneseed/.gitignore` predates `!/factories/`: tell the user the file stays personal until
|
|
44
|
+
they add that line.
|
|
45
|
+
3. **Write `<level>/<name>.json`**, `name` equal to the file stem, in the shape of the shipped
|
|
46
|
+
`bug-report-to-fix`:
|
|
47
|
+
|
|
48
|
+
```json
|
|
49
|
+
{
|
|
50
|
+
"name": "<name>", "description": "<one line>", "category": "<category>",
|
|
51
|
+
"rules": ["<optional>"],
|
|
52
|
+
"stages": ["intake", "holdout-write", "loop:<template>", "checks", "review-panel", "holdout", "pr-open", "merge-gate", "retro"],
|
|
53
|
+
"start": "intake",
|
|
54
|
+
"edges": [{ "from": "<stage>", "on": "<outcome>", "to": "<stage | $lane | $close | $stop>" }],
|
|
55
|
+
"cycles": [{ "name": "<name>", "nodes": ["<first stage of the lap, or $lane>", "..."], "max": 2 }],
|
|
56
|
+
"protected": ["<optional: paths checks refuses to see changed>"],
|
|
57
|
+
"review": { "seats": { "small": ["reviewer"], "medium": ["reviewer", "tester"], "large": ["reviewer", "tester", "steward"],
|
|
58
|
+
"areas": { "security": ["security"], "performance": ["performance"], "ui": ["user-advocate"], "data": ["security"] } } }
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
The edge `intake --needs-info--> <stage>` is optional: without it, a `needs-info` the user
|
|
63
|
+
answers `ok` follows intake's `pass` edge. `protected` is optional. `review.seats` is what a
|
|
64
|
+
`review-panel` stage seats; copy the shipped table unless the user wants other seats.
|
|
65
|
+
|
|
66
|
+
A cycle's `nodes[0]` is where every lap starts, and every route back targets it. A factory
|
|
67
|
+
with a fork follows the shipped `issue-to-pr`: one edge per named outcome out of `triage`,
|
|
68
|
+
and `$lane` as the target of each route back and as `nodes[0]` of its cycles.
|
|
69
|
+
4. **A brick that does not exist** — never write it here. Offer the `brick-forge` {{SKILL}}, or
|
|
70
|
+
run it when the user says so, then come back to this step. `brick-forge` is the only
|
|
71
|
+
{{SKILL}} that writes bricks.
|
|
72
|
+
5. **Check:** `geneseed factory check --factory <name>` (or the `.json` path). For each problem,
|
|
73
|
+
tell the user which rule it names, then fix the file and re-run until it prints `ok: true`:
|
|
74
|
+
- `no factory named "<name>"` — `--factory <name>` found no loadable file of that name. Run
|
|
75
|
+
a bare `geneseed factory check`: it lists every catalogue problem, among them `not JSON`
|
|
76
|
+
(the file does not parse) and `does not match the file name` (its `name` is not its stem).
|
|
77
|
+
- `must be a non-empty string` / `entry … must have` / `is listed twice` / `rules: must be` —
|
|
78
|
+
the shape: a `name`, well-formed `edges` and `cycles` entries, each stage once, `rules` a
|
|
79
|
+
list of non-empty strings.
|
|
80
|
+
- `is not a stage` — an edge endpoint, `start` or a cycle node names no stage (often a typo).
|
|
81
|
+
- `no brick named` / `no loop template named` / `brick unavailable` — a stage that does not
|
|
82
|
+
exist or cannot run here: fix the name, or step 4.
|
|
83
|
+
- `is not an outcome of` / `no edge for outcome` / `edges for outcome` — every outcome of a
|
|
84
|
+
stage has exactly one edge, and an edge uses only outcomes the stage declares (`error` may
|
|
85
|
+
go without one: it stops the run; so may `needs-info`: it follows the `pass` edge).
|
|
86
|
+
- `protected: must be a list of non-empty paths` — `protected` is a list of path strings.
|
|
87
|
+
- `review: must be an object with a seats table` / `review.seats.<size>: must be a non-empty
|
|
88
|
+
list of agent names` / `review.seats.areas: must map each area to a list of agents` — the
|
|
89
|
+
seat table needs a list for `small`, `medium` and `large`, and `areas` maps each area to a list.
|
|
90
|
+
- `review.seats.<where>: no agent named <name>` — a seat names an agent Geneseed does not ship;
|
|
91
|
+
a project's own agents cannot sit.
|
|
92
|
+
- `$close is not reachable` — no path from `start` ends the run well.
|
|
93
|
+
- `has no declared cycle around it` — a route back with no `cycles` entry.
|
|
94
|
+
- `max must be an integer` — a cycle's `max` is 1 to 5.
|
|
95
|
+
- `entered at …, not at its first stage` — a way into the cycle lands mid-cycle: reorder its
|
|
96
|
+
`nodes` or move the edge.
|
|
97
|
+
- `laps without spending a declared cycle` — a route back to the middle of a cycle: target
|
|
98
|
+
its first stage.
|
|
99
|
+
- `$lane: no fork chooses a lane` / `before any fork has chosen a lane` — `$lane` needs a
|
|
100
|
+
fork on every path to it. `a fork's edge names its lane` — a fork's edge targets its lane
|
|
101
|
+
stage, never `$lane`.
|
|
102
|
+
- `retired` — the file still uses `loop:$triaged` or `loops`: list each loop as its own stage,
|
|
103
|
+
give the fork one edge per lane, and route back to `$lane`. Rewrite it with the user; never
|
|
104
|
+
silently.
|
|
105
|
+
- `reports environment failures on …, which no loop can fix` — `checks` `error` or
|
|
106
|
+
`merge-gate` `none` routes to a loop or `$lane`: route it to the next stage or to `$stop`.
|
|
107
|
+
6. **Hand off:** tell the user the file, then the `factory` {{SKILL}} runs it
|
|
108
|
+
(`geneseed factory init --factory <name> …`). Do not start a run unasked.
|
|
109
|
+
|
|
110
|
+
## Done when
|
|
111
|
+
|
|
112
|
+
- The factory file exists at the chosen level, `geneseed factory check --factory <name>` prints
|
|
113
|
+
`ok: true`, and no brick was written outside `brick-forge`.
|
|
114
|
+
|
|
115
|
+
<!-- INCLUDE: skills/_self-improvement.md -->
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
# {{SKILL}}: factory
|
|
2
|
+
|
|
3
|
+
> {{DESC_FACTORY}}
|
|
4
|
+
|
|
5
|
+
**Trigger:** the user names a factory (`analysis-to-build`, `bug-report-to-fix`, `issue-to-pr`),
|
|
6
|
+
or asks to carry an issue, request or document to a PR with green CI.
|
|
7
|
+
|
|
8
|
+
## What it is
|
|
9
|
+
|
|
10
|
+
`geneseed factory` is a state machine kept in `FACTORY.md` at the worktree's root. A stage is a
|
|
11
|
+
brick or a whole loop; the engine decides every transition, cycle count and stop, and you run the
|
|
12
|
+
stage it hands you and report the outcome. Every action prints one JSON object: act on its keys,
|
|
13
|
+
never on your own reading of the graph. The run ends at an open PR with green CI. **No stage
|
|
14
|
+
merges:** once the run has closed, you ask the user once whether to merge (*The end*), and never
|
|
15
|
+
enable auto-merge.
|
|
16
|
+
|
|
17
|
+
**Holdout rule.** The `holdout-write` stage writes scenarios the developer never sees, and the
|
|
18
|
+
`holdout` stage plays them before the PR. Both run as the `tester` {{AGENT}}, never as the
|
|
19
|
+
developer and never inline. Never put holdout content (anything under `~/.config/geneseed/holdout/`)
|
|
20
|
+
into any brief, prompt, note or `--carry` you hand on; never name that folder to a developer or a
|
|
21
|
+
loop; never read it on a developer's behalf. Record `holdout-write`'s pass with the `--carry` it
|
|
22
|
+
received, unchanged, and a `holdout` fail with the one-sentence file it reported. No hook refuses a
|
|
23
|
+
read of the folder on any host: the folder is protected only by its place outside the worktree, by `holdout`'s `error`
|
|
24
|
+
when the diff touches it, and by this rule.
|
|
25
|
+
|
|
26
|
+
## Setup
|
|
27
|
+
|
|
28
|
+
1. Pick a short kebab-case `<slug>` from the work item, without the words `git`, `commit` or
|
|
29
|
+
`push` (spell them `g1t`, `cmt`, `psh`, or leave them out): the slug lands on the spec's
|
|
30
|
+
`record` line and on `git commit -m` lines, where those words make the git gate ask.
|
|
31
|
+
`factory init` refuses a `loop/factory-<slug>` branch whose slug holds one. Create the run's
|
|
32
|
+
worktree:
|
|
33
|
+
`git worktree add ../<repo>-factory-<slug> -b loop/factory-<slug>`, then make it the session's
|
|
34
|
+
working directory with its own command. Every later command runs there as written below: no
|
|
35
|
+
`cd` prefix, no `git -C`. Several runs may share a repo, each in its own worktree.
|
|
36
|
+
2. Use the factory the user names, else `geneseed factory list` and pick the one whose
|
|
37
|
+
description fits; confirm the pick with the user when two fit. None fits → the `factory-forge` {{SKILL}}.
|
|
38
|
+
3. `geneseed factory init --title "<title>" --requirement "<the user's ask, in their words>" --factory <name> --input "<issue URL, file path or pasted text>"`.
|
|
39
|
+
A refused factory prints `problems`: report them, never edit the graph to get past them.
|
|
40
|
+
|
|
41
|
+
## The cycle
|
|
42
|
+
|
|
43
|
+
Repeat `geneseed factory next` and act on its JSON.
|
|
44
|
+
|
|
45
|
+
**How to record.** `record` reads the porcelain on its stdin, piped in one command:
|
|
46
|
+
`git status --porcelain --untracked-files=all | geneseed factory record --outcome <outcome>`.
|
|
47
|
+
The same line works in PowerShell, which pipes too. Always use that porcelain form: plain
|
|
48
|
+
`--porcelain` folds a new directory into one line, which the engine refuses. A carry is the path
|
|
49
|
+
of the file the stage itself wrote (`--carry <that file>`), in the OS temp directory where the stage wrote it (never inside the worktree: a file there makes the porcelain dirty).
|
|
50
|
+
Free text (the user's words for `decide`, a stop reason) never goes on the command line: write it
|
|
51
|
+
with your file tool, never the shell, to a file whose name you make unique, such as
|
|
52
|
+
`<os temp dir>/factory-<8 random hex>.txt`, then pass `--note-file <that file>` or
|
|
53
|
+
`--carry-file <that file>`. Never delete a carry: the engine keeps its path for the next stage.
|
|
54
|
+
|
|
55
|
+
The git gate asks on any line that holds the word `git` and the word `commit` or `push`. A
|
|
56
|
+
record line holds `git`, so a spec path, a carry path or an outcome name with `commit` or `push`
|
|
57
|
+
in it makes the gate ask. On a record line that ask is a false alarm: the user can answer yes.
|
|
58
|
+
`factory init` refuses a slug that holds those words, which removes the commonest case.
|
|
59
|
+
|
|
60
|
+
- **`{stage, prompt, outcomes}`** — a brick stage. Dispatch its `agent` (or follow its `skill`)
|
|
61
|
+
with the `prompt`, the `requirement`, the `input`, the `carry` and the factory's `rules`. Then:
|
|
62
|
+
`git status --porcelain --untracked-files=all | geneseed factory record --outcome <outcome> --carry <the file the stage reported>`
|
|
63
|
+
(*How to record*). The `--carry` is how the next stage gets this one's finding.
|
|
64
|
+
A fork stage (such as `triage`) also gets `lanes`: each outcome it may report, with the stage
|
|
65
|
+
it leads to. Record the outcome it reported (`--outcome docs`): that outcome names the lane,
|
|
66
|
+
and a later route back to `$lane` returns to it.
|
|
67
|
+
A brick stage with `effect: mutate` (a `docs-update` lane) commits what it changed before the
|
|
68
|
+
record: `git add <the files it named>`, then `git commit -m "factory(<slug>): <stage>"`. The
|
|
69
|
+
engine refuses a dirty tree after any stage outside a loop.
|
|
70
|
+
The `spec` stage writes `specs/<slug>/spec.md` (the run's slug; a gate amend reaches it as the
|
|
71
|
+
`carry`, not as a LOOP.md note) and reports with
|
|
72
|
+
`git status --porcelain --untracked-files=all | geneseed factory record --outcome <outcome> --spec specs/<slug>/spec.md --carry <the file the stage reported>`,
|
|
73
|
+
so the gate shows the user what to review.
|
|
74
|
+
Its gate holds for the user's review of the task list. After `decide --verdict ok`, commit the
|
|
75
|
+
spec before the first loop: `git add specs/<slug>/spec.md`, then
|
|
76
|
+
`git commit -m "factory(<slug>): spec"` (it asks). An uncommitted spec stops the loop's first
|
|
77
|
+
read brick; the engine exempts it only until then.
|
|
78
|
+
A stage whose `skill` is `factory` (`review-panel`) is yours: follow its `prompt` here,
|
|
79
|
+
dispatch its seats in one parallel batch, chair them, and record its outcome as above.
|
|
80
|
+
- **`{stage, loop, notes}`** — a loop stage: see *Loop stages*.
|
|
81
|
+
- **`{awaiting}`** — a `gate: human` stage holds. Show the user the `stage`, the `outcome` it
|
|
82
|
+
reported and the file its `note` names, then **end the run** and wait. On their answer:
|
|
83
|
+
write their words to a unique file with your file tool (*How to record*), then
|
|
84
|
+
`geneseed factory decide --verdict ok|no|amend --note-file <that file>` — `ok` follows the
|
|
85
|
+
reported outcome's edge, `no` stops, `amend` re-runs the stage with their note — and continue.
|
|
86
|
+
Their words never go on the command line.
|
|
87
|
+
The gated outcomes:
|
|
88
|
+
- `intake` **`needs-info`**: show the user its numbered questions. Their answers go back as
|
|
89
|
+
`amend`, with the note file holding their answers; `ok` goes on with the assumptions intake
|
|
90
|
+
wrote.
|
|
91
|
+
- `checks` **`error`**: every check passed, but the branch changed a locked path (the done
|
|
92
|
+
list, CI config, a factory, loop or brick). Show each path. `ok` lets the change through; the run report names it.
|
|
93
|
+
When the finding starts `environment:` (a failed fetch, no default branch, a timeout, a
|
|
94
|
+
missing tool), show the cause instead: the loop cannot fix it. Once the user has fixed it,
|
|
95
|
+
`amend` runs `checks` again; `no` stops; `ok` goes on without the done list.
|
|
96
|
+
- `merge-gate` **`none`**: the repo runs no CI on the PR, or, when the finding starts
|
|
97
|
+
`environment:`, no verdict could be read (CI pending at the bound, `gh`/`glab` missing or
|
|
98
|
+
failing). `ok` goes on to `retro`, `amend` waits again, `no` stops.
|
|
99
|
+
- `checks` **`none`**: the base has no done list (or an empty one), and the note is the one
|
|
100
|
+
`checks` proposes, or says no manifest gave one. On the user's yes, land it on the base by a
|
|
101
|
+
PR of its own, never from this worktree and never by a push to `<default>`:
|
|
102
|
+
`git worktree add ../<repo>-done-list-<slug> -b geneseed/done-list-<slug> origin/<default>`,
|
|
103
|
+
write `.geneseed/done-checks.txt` there holding exactly the lines of the finding's fenced
|
|
104
|
+
block, stage that file alone, commit, push that worktree's own branch
|
|
105
|
+
(`git push -u origin HEAD:geneseed/done-list-<slug>`), and open a PR to `<default>`
|
|
106
|
+
(`gh pr create --base <default>`, or `glab mr create --target-branch <default>`; each asks).
|
|
107
|
+
Give the user the PR's URL: they merge it. Remove that worktree once the PR is merged.
|
|
108
|
+
When the branch or the worktree already exists (a re-run with the same slug), create
|
|
109
|
+
nothing and overwrite nothing: report it to the user with that worktree's path and the
|
|
110
|
+
branch's state (`git log -1 geneseed/done-list-<slug>`), and let them reuse, merge or
|
|
111
|
+
remove it. When the remote already has `geneseed/done-list-<slug>` but this clone has no
|
|
112
|
+
such branch (`git ls-remote --exit-code --heads origin geneseed/done-list-<slug>` exits 0
|
|
113
|
+
before the push), the push is refused: push nothing and overwrite nothing, and report it to
|
|
114
|
+
the user with that worktree's path and the remote branch's name, so they decide whether to
|
|
115
|
+
reuse, merge or delete it. When `gh` or `glab` is missing or fails at the PR step, the branch is pushed
|
|
116
|
+
already: report it to the user with that worktree's path and the branch name, so they open
|
|
117
|
+
the PR themselves. `ok`
|
|
118
|
+
waits until the file is on the base: answer `decide --verdict ok` only then, and `checks`
|
|
119
|
+
runs again against it. If it is not to be landed, `no`.
|
|
120
|
+
- **`{terminal: "$close"}`** or **`{terminal: "$stop"}`** — see *The end*.
|
|
121
|
+
- A `record` or `decide` result (`{stage}`, `{awaiting}`, `{stopped}`) — call `next` again.
|
|
122
|
+
- **`{error}`** — read it; it names the step you skipped or the evidence `record` lacks. Do that
|
|
123
|
+
step. Never edit the state block in `FACTORY.md` to get past it.
|
|
124
|
+
|
|
125
|
+
## Loop stages
|
|
126
|
+
|
|
127
|
+
4. Call `next` before every loop, each task of a spec included: it records the launch that
|
|
128
|
+
`record` later checks. When it refuses a `LOOP.md` left by the previous loop, remove it:
|
|
129
|
+
`git rm -f LOOP.md` when git tracks it, else delete the file (a loop that made no commit
|
|
130
|
+
leaves it untracked). Commit only when `git status` then shows the removal:
|
|
131
|
+
`git commit -m "factory(<slug>): clear the previous loop"` (it asks). Then `next` again.
|
|
132
|
+
A loop that ended `done` may instead be recorded `pass` while its `LOOP.md` is still there.
|
|
133
|
+
5. Start the loop in this same worktree:
|
|
134
|
+
`geneseed loop init --title "<title>" --requirement "<requirement, plus the task when next gave one>" --graph <loop> --preset {{TRUST}} --factory <slug> --note-file <notes[0]>`
|
|
135
|
+
where the task is item `task.index` under the spec's Tasks heading, written as
|
|
136
|
+
"task <index>/<count>: <its text>". When `task.extra` is set, the last task has passed and a
|
|
137
|
+
later stage sent the work back: the task is "make CI green" (or, for another stage, make it
|
|
138
|
+
pass), and `notes[0]` says why. Use `--note-file <notes[0]>`
|
|
139
|
+
when `notes[0]` is the path of a stage's finding file (the usual carry), so the loop gets the
|
|
140
|
+
finding, not its path; when it is plain text, write it to a unique file with your file tool
|
|
141
|
+
(*How to record*) and pass that file with `--note-file`; neither when `notes` is empty. A loop
|
|
142
|
+
re-entered after a failure is a fresh loop: the reason arrives as its note.
|
|
143
|
+
6. Follow the `loop` {{SKILL}} from *The cycle* through *The end*, skipping its Setup: the
|
|
144
|
+
worktree is this one, and its `loop/<slug>` is `loop/factory-<slug>` here, so every loop push
|
|
145
|
+
is `git push -u origin HEAD:loop/factory-<slug>`. Skip its final report too: the run goes on.
|
|
146
|
+
7. When the loop reaches `$close` and its close commit has removed `LOOP.md`:
|
|
147
|
+
`git status --porcelain --untracked-files=all | geneseed factory record --outcome pass`.
|
|
148
|
+
When it reaches `$stop`, leave its `LOOP.md` in place, write the stop reason to a unique file
|
|
149
|
+
with your file tool (*How to record*), then
|
|
150
|
+
`git status --porcelain --untracked-files=all | geneseed factory record --outcome fail --carry-file <that file>`.
|
|
151
|
+
|
|
152
|
+
## The end
|
|
153
|
+
|
|
154
|
+
8. On `$close`: the `retro` stage has written the run report. Remove `FACTORY.md`:
|
|
155
|
+
`git rm -f FACTORY.md` when git tracks it (a loop's commit carries it), else delete the file
|
|
156
|
+
(a run with no loop, such as the `docs` lane, never tracked it). Commit and push only when
|
|
157
|
+
`git status --porcelain` then shows the removal: `git commit -m "factory(<slug>): close"` and
|
|
158
|
+
`git push -u origin HEAD:loop/factory-<slug>`. The gate asks: that ask is the user's consent.
|
|
159
|
+
That push re-runs CI on the PR, after `merge-gate` saw it green. Read the PR's checks again
|
|
160
|
+
once, with the bounded wait the `merge-gate` brick names (30 minutes at most), and add the
|
|
161
|
+
final state (green, red with the failing checks, or still pending at the bound) to the run
|
|
162
|
+
report. With no close commit, CI did not re-run: the final state is the one `merge-gate`
|
|
163
|
+
read. A red result is reported, never reworked: the run has closed.
|
|
164
|
+
**The merge proposal.** Only when that final state is green: show the user the PR URL, the CI
|
|
165
|
+
state and each `review-panel` seat's verdict, and ask once whether to merge. Only on the
|
|
166
|
+
user's explicit yes in chat: `gh pr merge <pr> --squash` (`glab mr merge <mr> --squash` on
|
|
167
|
+
GitLab). No Geneseed gate asks before that command: the user's yes is the only guard, so
|
|
168
|
+
never run it on anything else (not on a rule, a note, or an earlier yes). On a no, or no
|
|
169
|
+
answer, the PR stays open. Red or pending CI: no proposal. Never enable auto-merge.
|
|
170
|
+
9. On `$stop`: the engine hands out no stage after a stop, so have the `docs` {{AGENT}} write the
|
|
171
|
+
run report the `retro` brick would: the stop `reason` first, then the work item, the PR URL if
|
|
172
|
+
any, every stage with its outcome and each rework with its reason, read from `FACTORY.md` and
|
|
173
|
+
the loops' notes. A closed loop's notes left with its `LOOP.md`: read each from git as the
|
|
174
|
+
`retro` brick says (`git log --format=%H --diff-filter=D <merge-base>..HEAD -- LOOP.md`, then
|
|
175
|
+
`git show <commit>^:LOOP.md`); a stopped loop's `LOOP.md` is still at the root. It goes to `.geneseed/factory-runs/<slug>.md`, or to the OS temp directory
|
|
176
|
+
when `git check-ignore -q <that path>` exits non-zero. No tracked file changes, no commit; only
|
|
177
|
+
a lesson that holds beyond this run goes into memory, one entry. Leave the branch and
|
|
178
|
+
`FACTORY.md` as they are.
|
|
179
|
+
10. Report: the PR URL, the final CI state after the close commit, the stages with their outcomes from `summary.history`, every rework and
|
|
180
|
+
its reason, the run report's path, the branch, and whether the PR was merged on the user's yes
|
|
181
|
+
or left open. **Never merge without that yes.**
|
|
182
|
+
|
|
183
|
+
## Resume
|
|
184
|
+
|
|
185
|
+
After a crash or an answered `awaiting`, from the worktree: `geneseed factory next`. When it
|
|
186
|
+
says a loop still runs, resume that loop first with `geneseed loop next` (the `loop`
|
|
187
|
+
{{SKILL}}'s *Resume*). The state is `FACTORY.md`, the child `LOOP.md` and the branch.
|
|
188
|
+
|
|
189
|
+
## Done when
|
|
190
|
+
|
|
191
|
+
- `$close` is reported with the PR open, `FACTORY.md` removed, and the final CI state read and
|
|
192
|
+
reported (after the close commit, or `merge-gate`'s when there was none); or `$stop` is
|
|
193
|
+
reported with its reason and the run report. The PR was merged on the user's yes, asked once
|
|
194
|
+
at the end, or left open; a `$stop` merges nothing.
|
|
195
|
+
|
|
196
|
+
<!-- INCLUDE: skills/_self-improvement.md -->
|
package/src/skills/loop.md
CHANGED
|
@@ -77,8 +77,9 @@ What `score --diff`, `decide` and `record` print back:
|
|
|
77
77
|
`origin` and a `message_file` path without spaces: if the path has a space, quote it and accept
|
|
78
78
|
that the gate asks; with no remote, report and stop instead of retrying.
|
|
79
79
|
- **`{discard: true}`** (with `resplit` when an inner ring was exhausted) — set the attempt aside,
|
|
80
|
-
keeping
|
|
81
|
-
the word `push` trips the git gate mid-run).
|
|
80
|
+
keeping the engine files: `git stash -u -m loop-discarded -- . :^LOOP.md :^FACTORY.md` (never
|
|
81
|
+
`git stash push` — the word `push` trips the git gate mid-run). `FACTORY.md` is the factory
|
|
82
|
+
run's state when this loop is one of its stages: stashed, the run would lose it or roll it back.
|
|
82
83
|
- **`{done: true}`**, **`{empty}`**, **`{resumed}`**, **`{dropped}`**, **`{node}`**, **`{verify}`**,
|
|
83
84
|
**`{awaiting}`** (a gate), **`{stopped}`**, a declared score, and any result with
|
|
84
85
|
`commit: false` (a blocking diff score included — it surfaces as `{awaiting}`) — call `next`
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
## Procedure
|
|
12
12
|
1. Confirm independence: the subtasks must not depend on each other's output or write the same files ({{DOCTRINE:one-writer-per-file}}). Write down each unit's **write set** — the files or globs it may change — and intersect them; an overlap runs in sequence or goes to one owner, and shared append files (registries, index tables, lockfiles, generated bundles) stay with you. If they're sequential or share state, use [plan](plan.md) instead.
|
|
13
13
|
2. Split the work into self-contained units, each with one clear goal and a defined output contract — what it must return. Several small edits of one kind (the same fix, constant or field across files) form ONE unit with the union write set and get one review.
|
|
14
|
-
3. Dispatch each unit to its own subagent in one batch
|
|
14
|
+
3. Dispatch each unit to its own subagent in one batch — units that call one rationed resource run in sequence instead ({{DOCTRINE:serialize-against-a-rationed-resource}}) — each under a handoff envelope: the unit's goal, the inputs it needs, its **write set** (edit nothing outside it; return rows for a shared file instead of writing it), the observable check that proves it done, its output contract — naming every file it changed — and the inherited constraints (no commit/push — {{DOCTRINE:consent-before-push}} stays with you; no sub-agents of its own — review comes from you; gaps reported, never invented). Hand each unit only the access its goal needs ({{LAW:least-privilege}}). Prefer the read-only [explorer {{AGENT}}](../{{DIR_AGENTS}}/explorer.md) for investigation so the heavy reading stays out of the main context ({{DOCTRINE:context-economy}}). Where no subagent capability exists, run the units sequentially as personas instead, converging the same way.
|
|
15
15
|
4. Keep the main context lean: collect each subagent's distilled result, not its working transcript. Watch every unit you dispatched in the background as the [pipeline {{SKILL}}](pipeline.md)'s step 2 watches a crew: a result without its check, or one that says it is still waiting, is a failure to act on at once — resume the unit or redo it — never a notification to wait for.
|
|
16
16
|
5. Converge: compare each unit's changed files against its write set and against its siblings' — an edit outside the set, a file two units touched, or a file in a batch's set that never changed is a conflict you resolve before anything else — apply the shared-file rows yourself, then verify the combined outcome. A conflict or ambiguity between the plan, the findings and the code is yours to decide: decide it, record `Ruling: <choice> — <why> — <cost if wrong>` in the worklog, and continue. Stop only for what {{LAW:echo-the-intent}}, {{LAW:deletion-is-deliberate}} or {{DOCTRINE:consent-before-push}} names; every ruling goes in the final report ({{DOCTRINE:declare-the-judgment-calls}}).
|
|
17
17
|
6. **A plan with blocking edges.** To build a [plan](plan.md) file's slices — each with its `Blocked by:` line — in one run, dispatch every unblocked slice on its own branch off one integration branch, merge each into it as it returns (each merge is a commit — {{DOCTRINE:consent-before-push}} stays with you), and recompute the unblocked set from the plan after every merge — newly freed slices go out at once. When the plan names a `Spec:`, every slice reads it once; the spec outranks the plan where they conflict. Each slice branches off the integration tip at its own dispatch (its BASE) and merges the current tip back into its branch before returning, so a conflict with a sibling resolves on the slice's branch; before re-running the proof, confirm the branch descends from BASE and the diff is non-empty — an empty diff is a failure, not a clean result. Never diff against `HEAD~1`. When the plan is exhausted, review the integration branch whole with [geneseed-code-review](geneseed-code-review.md) before reporting.
|
package/src/skills/workflow.md
CHANGED
|
@@ -64,7 +64,8 @@ carries the script API — load it before writing one).
|
|
|
64
64
|
`parallel()`. Pass `isolation: 'worktree'` to each agent that edits in parallel — both
|
|
65
65
|
runtimes take it; read-only agents need none. After the fan-out, compare the changed
|
|
66
66
|
files in plain script code (OpenCode hands them to you as `overlaps()`) — a file two
|
|
67
|
-
agents touched goes to one merge agent, never to whoever wrote last.
|
|
67
|
+
agents touched goes to one merge agent, never to whoever wrote last. Agents that call one
|
|
68
|
+
rationed resource run in sequence, never in one `parallel()` ({{DOCTRINE:serialize-against-a-rationed-resource}}).
|
|
68
69
|
5. **Pass the task as `args`, never baked in** — target paths, the motion, the question,
|
|
69
70
|
any timestamp. Scripts stay deterministic: no wall clock, no randomness, nothing
|
|
70
71
|
read from the environment that the next run would see differently, so a run is a
|
package/themes/_TEMPLATE.json
CHANGED
|
@@ -62,7 +62,9 @@
|
|
|
62
62
|
"DESC_PARALLEL_AGENTS": "<one-line description: fan independent subtasks to concurrent subagents, then converge>",
|
|
63
63
|
"DESC_PIPELINE": "<one-line description: spawn a small crew — analyst, developer, tester — to work a substantial task in isolation, merging only on mechanical proof (tests + lint green)>",
|
|
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
|
+
"DESC_FACTORY": "<one-line description: carry one work item (request, document or issue) through a factory of bricks and loops to an open PR with green CI, stepping the geneseed factory state machine; never merges without the user's yes, asked once at the end>",
|
|
65
66
|
"DESC_BRICK_FORGE": "<one-line description: author or adapt a loop brick at project, global or shipped level, checked by geneseed loop check>",
|
|
67
|
+
"DESC_FACTORY_FORGE": "<one-line description: compose bricks and loops into a factory through an interview, write it at project or global level, check it with geneseed factory check, and offer brick-forge for a missing brick>",
|
|
66
68
|
"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
69
|
"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
70
|
"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\">",
|
|
@@ -120,11 +122,10 @@
|
|
|
120
122
|
"DOC_CONSENT_BEFORE_PUSH": "<themed title for the process rule Consent Before Push>",
|
|
121
123
|
"DOC_BOUND_THE_LOOP": "<themed title for the process rule Bound the Loop>",
|
|
122
124
|
"DOC_ONE_WRITER_PER_FILE": "<themed title for the process rule One Writer Per File>",
|
|
123
|
-
"DOC_CODES_THAT_PERSIST": "<themed title for the comms rule Codes
|
|
125
|
+
"DOC_CODES_THAT_PERSIST": "<themed title for the comms rule Codes and Markers>",
|
|
124
126
|
"DOC_STRUCTURE_BESIDE_PROSE": "<themed title for the comms rule Structure Beside Prose>",
|
|
125
127
|
"DOC_DECLARE_THE_JUDGMENT_CALLS": "<themed title for the comms rule Declare the Judgment Calls>",
|
|
126
128
|
"DOC_SIMPLIFIED_TECHNICAL_ENGLISH": "<themed title for the comms rule Simplified Technical English>",
|
|
127
|
-
"DOC_MARK_THE_ASK": "<themed title for the comms rule Mark the Ask>",
|
|
128
129
|
"INTRO_DOC": "<themed intro: this file is the entry point an AI agent reads in this repo>",
|
|
129
130
|
"INTRO_AGENTS": "<themed intro to the Agents section — delegate focused work to a specialist>",
|
|
130
131
|
"INTRO_SKILLS": "<themed intro to the Skills section — run the written procedure before improvising>",
|
|
@@ -138,6 +139,7 @@
|
|
|
138
139
|
"DOCTRINES": "<plural of DOCTRINE — the tier/section noun>",
|
|
139
140
|
"AGENT": "<singular noun for an agent in this theme, e.g. Agent / Adept>",
|
|
140
141
|
"AGENTS": "<plural of AGENT>",
|
|
142
|
+
"PRIMARY_AGENT": "<the main agent, the one every agent inherits from>",
|
|
141
143
|
"SKILL": "<singular noun for a skill in this theme, e.g. Skill / Rite>",
|
|
142
144
|
"SKILLS": "<plural of SKILL>",
|
|
143
145
|
"MEMORY": "<noun for the memory store in this theme, e.g. Memory>",
|
package/themes/biker.json
CHANGED
|
@@ -62,7 +62,9 @@
|
|
|
62
62
|
"DESC_PARALLEL_AGENTS": "Send several riders on independent runs at once, then bring in what they gather.",
|
|
63
63
|
"DESC_PIPELINE": "Send a small crew of riders — scout, wrench, test rider — to work a job in their own lane, rolling it into the pack only once the road-test comes back clean.",
|
|
64
64
|
"DESC_LOOP": "Ride a requirement in short, scored laps on its own loop/* lane, the loop engine calling every turn.",
|
|
65
|
+
"DESC_FACTORY": "Ride one work item from the call-out to an open PR with green CI, the factory engine marking every stop. The merge stays yours.",
|
|
65
66
|
"DESC_BRICK_FORGE": "Build or re-tune a loop brick, then run it past geneseed loop check.",
|
|
67
|
+
"DESC_FACTORY_FORGE": "Build a factory from bricks and loops, run it past geneseed factory check, and call in brick-forge when a part is missing.",
|
|
66
68
|
"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
69
|
"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
70
|
"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\".",
|
|
@@ -120,11 +122,10 @@
|
|
|
120
122
|
"DOC_CONSENT_BEFORE_PUSH": "Crew's Nod Before You Push · Consent Before Push",
|
|
121
123
|
"DOC_BOUND_THE_LOOP": "Set the Turnaround Before You Roll · Bound the Loop",
|
|
122
124
|
"DOC_ONE_WRITER_PER_FILE": "One Wrench on Each Bolt · One Writer Per File",
|
|
123
|
-
"DOC_CODES_THAT_PERSIST": "Tag Every Part on the Bench · Codes
|
|
125
|
+
"DOC_CODES_THAT_PERSIST": "Tag Every Part on the Bench · Codes and Markers",
|
|
124
126
|
"DOC_STRUCTURE_BESIDE_PROSE": "Draw the Route Only If It Turns · Structure Beside Prose",
|
|
125
127
|
"DOC_DECLARE_THE_JUDGMENT_CALLS": "Own Up to Every Back Road Taken · Declare the Judgment Calls",
|
|
126
128
|
"DOC_SIMPLIFIED_TECHNICAL_ENGLISH": "Short Words, Clear Signals · Simplified Technical English",
|
|
127
|
-
"DOC_MARK_THE_ASK": "Flash the Lights When You Need an Answer · Mark the Ask",
|
|
128
129
|
"INTRO_DOC": "This file is the route briefing a coding rider reads when it joins this repository.",
|
|
129
130
|
"INTRO_AGENTS": "Send the right rider for focused work instead of riding the whole run yourself; each has one job and reports exactly what it did.",
|
|
130
131
|
"INTRO_SKILLS": "A Skill is a move you've drilled for a recurring task. Run the matching move before you wing it.",
|
|
@@ -138,6 +139,7 @@
|
|
|
138
139
|
"DOCTRINES": "Bylaws",
|
|
139
140
|
"AGENT": "Rider",
|
|
140
141
|
"AGENTS": "Riders",
|
|
142
|
+
"PRIMARY_AGENT": "Road Captain",
|
|
141
143
|
"SKILL": "Move",
|
|
142
144
|
"SKILLS": "Moves",
|
|
143
145
|
"MEMORY": "Roadbook",
|
package/themes/commentator.json
CHANGED
|
@@ -62,7 +62,9 @@
|
|
|
62
62
|
"DESC_PARALLEL_AGENTS": "Send several drivers out on independent stints at once, then bring in what they gather.",
|
|
63
63
|
"DESC_PIPELINE": "Send a small crew — scout, mechanic, test driver — out on their own stint, and only wave them into the results once the timing sheet comes back clean.",
|
|
64
64
|
"DESC_LOOP": "Run a requirement in short, scored laps on a loop/* branch, the loop engine calling every move.",
|
|
65
|
+
"DESC_FACTORY": "Take one work item from kick-off to an open PR with green CI, the factory engine calling every stage. The merge stays yours.",
|
|
65
66
|
"DESC_BRICK_FORGE": "Build or adapt a loop brick, then put it through geneseed loop check.",
|
|
67
|
+
"DESC_FACTORY_FORGE": "Draw up a factory from bricks and loops, put it through geneseed factory check, and bring on brick-forge when a brick is missing.",
|
|
66
68
|
"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
69
|
"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
70
|
"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\".",
|
|
@@ -120,11 +122,10 @@
|
|
|
120
122
|
"DOC_CONSENT_BEFORE_PUSH": "Team Orders Before You Push · Consent Before Push",
|
|
121
123
|
"DOC_BOUND_THE_LOOP": "Call the Stint Length Before Lights Out · Bound the Loop",
|
|
122
124
|
"DOC_ONE_WRITER_PER_FILE": "One Driver Per Car · One Writer Per File",
|
|
123
|
-
"DOC_CODES_THAT_PERSIST": "Every Car Keeps Its Number · Codes
|
|
125
|
+
"DOC_CODES_THAT_PERSIST": "Every Car Keeps Its Number · Codes and Markers",
|
|
124
126
|
"DOC_STRUCTURE_BESIDE_PROSE": "Track Map Only When the Lines Matter · Structure Beside Prose",
|
|
125
127
|
"DOC_DECLARE_THE_JUDGMENT_CALLS": "Replay the Calls Made Off the Radio · Declare the Judgment Calls",
|
|
126
128
|
"DOC_SIMPLIFIED_TECHNICAL_ENGLISH": "Every Call Clear Over the Noise · Simplified Technical English",
|
|
127
|
-
"DOC_MARK_THE_ASK": "Big Moment, Big Graphic · Mark the Ask",
|
|
128
129
|
"INTRO_DOC": "This file is the race briefing a coding driver reads when it joins this repository.",
|
|
129
130
|
"INTRO_AGENTS": "Put the right driver in the car for focused work instead of running the whole race yourself; each has one job and reports exactly what it did.",
|
|
130
131
|
"INTRO_SKILLS": "A Skill is a rehearsed manoeuvre for a recurring task. Run the matching manoeuvre before you improvise.",
|
|
@@ -138,6 +139,7 @@
|
|
|
138
139
|
"DOCTRINES": "Directives",
|
|
139
140
|
"AGENT": "Driver",
|
|
140
141
|
"AGENTS": "Drivers",
|
|
142
|
+
"PRIMARY_AGENT": "Lead Driver",
|
|
141
143
|
"SKILL": "Manoeuvre",
|
|
142
144
|
"SKILLS": "Manoeuvres",
|
|
143
145
|
"MEMORY": "Telemetry",
|
package/themes/cyberpunk.json
CHANGED
|
@@ -62,7 +62,9 @@
|
|
|
62
62
|
"DESC_PARALLEL_AGENTS": "Fork independent tasks to concurrent threads, then merge the output.",
|
|
63
63
|
"DESC_PIPELINE": "Spin up a small crew of daemons — scout, coder, tester — on their own fork, and only merge the run once the trace comes back clean.",
|
|
64
64
|
"DESC_LOOP": "Run a requirement in small, scored cycles on a loop/* fork, the loop engine driving every jump.",
|
|
65
|
+
"DESC_FACTORY": "Route one work item through the factory to an open PR with green CI, the engine switching every stage. The merge stays yours.",
|
|
65
66
|
"DESC_BRICK_FORGE": "Compile or patch a loop brick, then run it through geneseed loop check.",
|
|
67
|
+
"DESC_FACTORY_FORGE": "Wire bricks and loops into a factory, run it through geneseed factory check, and patch in brick-forge when a brick is missing.",
|
|
66
68
|
"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
69
|
"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
70
|
"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\".",
|
|
@@ -120,11 +122,10 @@
|
|
|
120
122
|
"DOC_CONSENT_BEFORE_PUSH": "Authorize the Upload · Consent Before Push",
|
|
121
123
|
"DOC_BOUND_THE_LOOP": "Set the Kill-Switch Before the Loop · Bound the Loop",
|
|
122
124
|
"DOC_ONE_WRITER_PER_FILE": "One Deck Per Node · One Writer Per File",
|
|
123
|
-
"DOC_CODES_THAT_PERSIST": "Every Node Keeps Its Handle · Codes
|
|
125
|
+
"DOC_CODES_THAT_PERSIST": "Every Node Keeps Its Handle · Codes and Markers",
|
|
124
126
|
"DOC_STRUCTURE_BESIDE_PROSE": "Trace the Wires, Skip the Chrome · Structure Beside Prose",
|
|
125
127
|
"DOC_DECLARE_THE_JUDGMENT_CALLS": "Log Every Off-Grid Call · Declare the Judgment Calls",
|
|
126
128
|
"DOC_SIMPLIFIED_TECHNICAL_ENGLISH": "Clean Signal, Zero Noise · Simplified Technical English",
|
|
127
|
-
"DOC_MARK_THE_ASK": "Ping the Operator in Neon · Mark the Ask",
|
|
128
129
|
"INTRO_DOC": "This file is the boot sequence a coding daemon reads when it jacks into this repository.",
|
|
129
130
|
"INTRO_AGENTS": "Spin the right daemon for focused work instead of running the whole job on one thread; each has one function and returns a clean log of what it changed.",
|
|
130
131
|
"INTRO_SKILLS": "A Skill is a proven routine for a recurring task. Run the matching routine before you freestyle.",
|
|
@@ -138,6 +139,7 @@
|
|
|
138
139
|
"DOCTRINES": "Policies",
|
|
139
140
|
"AGENT": "Daemon",
|
|
140
141
|
"AGENTS": "Daemons",
|
|
142
|
+
"PRIMARY_AGENT": "Netrunner",
|
|
141
143
|
"SKILL": "Program",
|
|
142
144
|
"SKILLS": "Programs",
|
|
143
145
|
"MEMORY": "Datastore",
|
package/themes/gamer.json
CHANGED
|
@@ -62,7 +62,9 @@
|
|
|
62
62
|
"DESC_PARALLEL_AGENTS": "Send the party on independent objectives at once, then regroup the loot.",
|
|
63
63
|
"DESC_PIPELINE": "Send a small party — scout, builder, tester — into their own instance, and only merge the run once the clear is verified.",
|
|
64
64
|
"DESC_LOOP": "Grind a requirement in small, scored rounds on a loop/* branch, the loop engine running the turns.",
|
|
65
|
+
"DESC_FACTORY": "Run one work item through the factory, stage by stage, to an open PR with green CI. The merge stays yours.",
|
|
65
66
|
"DESC_BRICK_FORGE": "Craft or tune a loop brick, then verify it with geneseed loop check.",
|
|
67
|
+
"DESC_FACTORY_FORGE": "Craft a factory from bricks and loops, verify it with geneseed factory check, and spawn brick-forge when a brick is missing.",
|
|
66
68
|
"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
69
|
"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
70
|
"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\".",
|
|
@@ -120,11 +122,10 @@
|
|
|
120
122
|
"DOC_CONSENT_BEFORE_PUSH": "Ready-Check Before Push · Consent Before Push",
|
|
121
123
|
"DOC_BOUND_THE_LOOP": "Set the Retry Cap Before the Grind · Bound the Loop",
|
|
122
124
|
"DOC_ONE_WRITER_PER_FILE": "No Double-Looting the Chest · One Writer Per File",
|
|
123
|
-
"DOC_CODES_THAT_PERSIST": "Every Item Keeps Its Tag · Codes
|
|
125
|
+
"DOC_CODES_THAT_PERSIST": "Every Item Keeps Its Tag · Codes and Markers",
|
|
124
126
|
"DOC_STRUCTURE_BESIDE_PROSE": "Minimap Only When There Is a Route · Structure Beside Prose",
|
|
125
127
|
"DOC_DECLARE_THE_JUDGMENT_CALLS": "Show the Branches You Picked · Declare the Judgment Calls",
|
|
126
128
|
"DOC_SIMPLIFIED_TECHNICAL_ENGLISH": "Patch Notes Anyone Can Read · Simplified Technical English",
|
|
127
|
-
"DOC_MARK_THE_ASK": "Quest Marker Over the Choice · Mark the Ask",
|
|
128
129
|
"INTRO_DOC": "This file is the loading screen a coding co-op partner reads when it joins this repository.",
|
|
129
130
|
"INTRO_AGENTS": "Pick the right class for focused work instead of soloing the whole raid; each has one role and reports exactly what it did.",
|
|
130
131
|
"INTRO_SKILLS": "A Skill is a practiced combo for a recurring task. Run the matching combo before you freestyle.",
|
|
@@ -138,6 +139,7 @@
|
|
|
138
139
|
"DOCTRINES": "Tactics",
|
|
139
140
|
"AGENT": "Teammate",
|
|
140
141
|
"AGENTS": "Teammates",
|
|
142
|
+
"PRIMARY_AGENT": "Player One",
|
|
141
143
|
"SKILL": "Combo",
|
|
142
144
|
"SKILLS": "Combos",
|
|
143
145
|
"MEMORY": "Checkpoint",
|
package/themes/imperial.json
CHANGED
|
@@ -62,7 +62,9 @@
|
|
|
62
62
|
"DESC_PARALLEL_AGENTS": "Loose many specialists upon independent tasks at once, then gather what they bring.",
|
|
63
63
|
"DESC_PIPELINE": "Dispatch a small cohort of Adepts — scout, artisan, examiner — to labour in their own sealed chamber, sanctioned into the Reliquary only once the proving-rite returns clean.",
|
|
64
64
|
"DESC_LOOP": "Labour on a requirement in small, weighed iterations on a loop/* branch, the loop engine ordaining every step.",
|
|
65
|
+
"DESC_FACTORY": "Carry one work item through the manufactorum, stage by stage, to an open PR with green CI, the factory engine ordaining each step. The merge stays yours.",
|
|
65
66
|
"DESC_BRICK_FORGE": "Forge or adapt a loop brick, then submit it to geneseed loop check.",
|
|
67
|
+
"DESC_FACTORY_FORGE": "Raise a manufactorum from bricks and loops, submit it to geneseed factory check, and summon brick-forge when a brick is lacking.",
|
|
66
68
|
"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
69
|
"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
70
|
"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\".",
|
|
@@ -120,11 +122,10 @@
|
|
|
120
122
|
"DOC_CONSENT_BEFORE_PUSH": "Consensus Ante Translationem · Consent Before Push",
|
|
121
123
|
"DOC_BOUND_THE_LOOP": "Finis Ante Iter · Bound the Loop",
|
|
122
124
|
"DOC_ONE_WRITER_PER_FILE": "Unus Scriptor Singulis Tabulis · One Writer Per File",
|
|
123
|
-
"DOC_CODES_THAT_PERSIST": "Sigla Perstantia · Codes
|
|
125
|
+
"DOC_CODES_THAT_PERSIST": "Sigla Perstantia · Codes and Markers",
|
|
124
126
|
"DOC_STRUCTURE_BESIDE_PROSE": "Schema Ubi Sagittae Loquuntur · Structure Beside Prose",
|
|
125
127
|
"DOC_DECLARE_THE_JUDGMENT_CALLS": "Arbitria Declarata · Declare the Judgment Calls",
|
|
126
128
|
"DOC_SIMPLIFIED_TECHNICAL_ENGLISH": "Sermo Simplex Technicus · Simplified Technical English",
|
|
127
|
-
"DOC_MARK_THE_ASK": "Vox Exspectans · Mark the Ask",
|
|
128
129
|
"INTRO_DOC": "This file is the gene-seed's core — the first writ a servant reads on entering this world.",
|
|
129
130
|
"INTRO_AGENTS": "Hand focused work to the specialist whose duty it is rather than carrying every burden in one context; each holds one purpose and returns a clear account of what it changed.",
|
|
130
131
|
"INTRO_SKILLS": "A Skill is a rite proven by repetition. Perform the matching rite before you improvise.",
|
|
@@ -138,6 +139,7 @@
|
|
|
138
139
|
"DOCTRINES": "Doctrinae",
|
|
139
140
|
"AGENT": "Adept",
|
|
140
141
|
"AGENTS": "Adepts",
|
|
142
|
+
"PRIMARY_AGENT": "Servant",
|
|
141
143
|
"SKILL": "Rite",
|
|
142
144
|
"SKILLS": "Rites",
|
|
143
145
|
"MEMORY": "Reliquary",
|
package/themes/joker.json
CHANGED
|
@@ -62,7 +62,9 @@
|
|
|
62
62
|
"DESC_PARALLEL_AGENTS": "Send several sidekicks on independent bits at once, then bring in what they get.",
|
|
63
63
|
"DESC_PIPELINE": "Send a small crew — scout, coder, tester — off to do their bit in their own green room, and only bring it on stage once the run-through comes back clean.",
|
|
64
64
|
"DESC_LOOP": "Work a requirement in small, scored takes on a loop/* branch, the loop engine calling every cue.",
|
|
65
|
+
"DESC_FACTORY": "Carry one work item through the factory, act by act, to an open PR with green CI. The merge stays yours.",
|
|
65
66
|
"DESC_BRICK_FORGE": "Write or rework a loop brick, then run it past geneseed loop check.",
|
|
67
|
+
"DESC_FACTORY_FORGE": "Stitch bricks and loops into a factory, run it past geneseed factory check, and send for brick-forge when a brick is missing.",
|
|
66
68
|
"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
69
|
"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
70
|
"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\".",
|
|
@@ -120,11 +122,10 @@
|
|
|
120
122
|
"DOC_CONSENT_BEFORE_PUSH": "Get the Nod Before You Push · Consent Before Push",
|
|
121
123
|
"DOC_BOUND_THE_LOOP": "Know When to Get Off Stage · Bound the Loop",
|
|
122
124
|
"DOC_ONE_WRITER_PER_FILE": "One Comic Per Mic · One Writer Per File",
|
|
123
|
-
"DOC_CODES_THAT_PERSIST": "Every Bit Keeps Its Name · Codes
|
|
125
|
+
"DOC_CODES_THAT_PERSIST": "Every Bit Keeps Its Name · Codes and Markers",
|
|
124
126
|
"DOC_STRUCTURE_BESIDE_PROSE": "A Chart Only If It Lands · Structure Beside Prose",
|
|
125
127
|
"DOC_DECLARE_THE_JUDGMENT_CALLS": "Fess Up to the Ad-Libs · Declare the Judgment Calls",
|
|
126
128
|
"DOC_SIMPLIFIED_TECHNICAL_ENGLISH": "Short Setups, One Meaning · Simplified Technical English",
|
|
127
|
-
"DOC_MARK_THE_ASK": "Cue the Audience · Mark the Ask",
|
|
128
129
|
"INTRO_DOC": "This file is the warm-up a coding co-pilot reads when it joins this repository.",
|
|
129
130
|
"INTRO_AGENTS": "Bring in the right sidekick for focused work instead of being the whole act yourself; each has one job and reports exactly what it did.",
|
|
130
131
|
"INTRO_SKILLS": "A Skill is a bit you've rehearsed for a recurring task. Run the matching bit before you ad-lib.",
|
|
@@ -138,6 +139,7 @@
|
|
|
138
139
|
"DOCTRINES": "Notes",
|
|
139
140
|
"AGENT": "Sidekick",
|
|
140
141
|
"AGENTS": "Sidekicks",
|
|
142
|
+
"PRIMARY_AGENT": "Ringleader",
|
|
141
143
|
"SKILL": "Bit",
|
|
142
144
|
"SKILLS": "Bits",
|
|
143
145
|
"MEMORY": "Joke Book",
|