geneseed 4.27.1 → 4.29.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.
Files changed (143) hide show
  1. package/CHANGELOG.md +53 -0
  2. package/README.md +7 -4
  3. package/SHIPPED.md +2 -2
  4. package/adapters/bob/README.md +1 -1
  5. package/adapters/claude-code/README.md +4 -2
  6. package/adapters/opencode/HOW-OPENCODE-LOADS.md +2 -2
  7. package/adapters/opencode/README.md +18 -2
  8. package/adapters/opencode/plugins/geneseed-context.js +155 -18
  9. package/adapters/opencode/plugins/geneseed-guard.js +59 -8
  10. package/adapters/opencode/plugins/geneseed-workflow.js +27 -8
  11. package/adapters/opencode/workflows/_runtime.js +14 -3
  12. package/docs/concepts/enforcement-table.md +5 -4
  13. package/docs/concepts/exclusions.md +3 -3
  14. package/docs/concepts/hooks.md +11 -3
  15. package/docs/concepts/ownership.md +7 -6
  16. package/docs/concepts/skills.md +1 -0
  17. package/docs/guides/set-up-ownership.md +22 -6
  18. package/docs/reference/environment.md +1 -0
  19. package/docs/reference/plugin-context.md +3 -1
  20. package/docs/reference/plugin-guard.md +1 -1
  21. package/docs/understand/enforced-vs-asked.md +3 -3
  22. package/docs/understand/machine-bob.md +1 -1
  23. package/docs/understand/machine-claude.md +1 -1
  24. package/docs/understand/machine-opencode.md +1 -1
  25. package/harness.config.json +1 -1
  26. package/js/README.md +3 -1
  27. package/js/build/driver.mjs +29 -9
  28. package/js/build/emit-opencode.mjs +12 -10
  29. package/js/build/render.mjs +9 -0
  30. package/js/hosts/done-checks.mjs +134 -0
  31. package/js/hosts/geneseed-dir.mjs +116 -0
  32. package/js/hosts/hooks-context.mjs +19 -0
  33. package/js/hosts/hooks-done.mjs +82 -38
  34. package/js/hosts/hooks-learn.mjs +9 -2
  35. package/js/hosts/hooks-prims.mjs +4 -0
  36. package/js/hosts/hooks.mjs +139 -6
  37. package/js/hosts/hosts.mjs +6 -0
  38. package/js/hosts/native.mjs +1 -1
  39. package/js/hosts/owned.mjs +19 -0
  40. package/js/hosts/ownership-gate.mjs +64 -10
  41. package/js/hosts/settings.mjs +115 -74
  42. package/js/inspect/checks-constitution.mjs +5 -1
  43. package/js/inspect/cost.mjs +1 -1
  44. package/js/inspect/doctor.mjs +2 -1
  45. package/js/inspect/inventory.mjs +1 -1
  46. package/js/inspect/status.mjs +2 -1
  47. package/js/inspect/validate.mjs +2 -1
  48. package/js/lib/json.mjs +70 -0
  49. package/js/maintain/uninstall.mjs +18 -5
  50. package/js/web/gates-api.mjs +2 -2
  51. package/package.json +1 -1
  52. package/registry.json +14 -0
  53. package/src/AGENT.md.tmpl +2 -2
  54. package/src/doctrines/comms.md +9 -2
  55. package/src/licenses/i-have-adhd.txt +21 -0
  56. package/src/skills/_checkpoints.md +15 -2
  57. package/src/skills/adhd.md +40 -0
  58. package/src/skills/diagram-design/LICENSE +21 -0
  59. package/src/skills/diagram-design/SKILL.md +392 -0
  60. package/src/skills/diagram-design/THIRD_PARTY_LICENSES.md +134 -0
  61. package/src/skills/diagram-design/VENDOR.md +81 -0
  62. package/src/skills/diagram-design/assets/example-architecture.html +183 -0
  63. package/src/skills/diagram-design/assets/example-venn.html +110 -0
  64. package/src/skills/diagram-design/assets/template-dark.html +99 -0
  65. package/src/skills/diagram-design/assets/template-full.html +421 -0
  66. package/src/skills/diagram-design/assets/template-motion.html +448 -0
  67. package/src/skills/diagram-design/assets/template-terminal.html +188 -0
  68. package/src/skills/diagram-design/assets/template.html +100 -0
  69. package/src/skills/diagram-design/references/animation.md +135 -0
  70. package/src/skills/diagram-design/references/layout-budget.md +97 -0
  71. package/src/skills/diagram-design/references/onboarding.md +368 -0
  72. package/src/skills/diagram-design/references/output-spec.md +277 -0
  73. package/src/skills/diagram-design/references/primitive-annotation.md +36 -0
  74. package/src/skills/diagram-design/references/primitive-icons.md +782 -0
  75. package/src/skills/diagram-design/references/primitive-sketchy.md +43 -0
  76. package/src/skills/diagram-design/references/primitive-terminal.md +76 -0
  77. package/src/skills/diagram-design/references/primitives-core.md +144 -0
  78. package/src/skills/diagram-design/references/profiles.md +183 -0
  79. package/src/skills/diagram-design/references/semantic-patterns.md +154 -0
  80. package/src/skills/diagram-design/references/style-guide.md +232 -0
  81. package/src/skills/diagram-design/references/type-architecture-delta.md +143 -0
  82. package/src/skills/diagram-design/references/type-architecture.md +117 -0
  83. package/src/skills/diagram-design/references/type-axonometric-plan.md +83 -0
  84. package/src/skills/diagram-design/references/type-bar.md +108 -0
  85. package/src/skills/diagram-design/references/type-data-flow.md +371 -0
  86. package/src/skills/diagram-design/references/type-db-schema.md +48 -0
  87. package/src/skills/diagram-design/references/type-dependency.md +44 -0
  88. package/src/skills/diagram-design/references/type-deployment.md +45 -0
  89. package/src/skills/diagram-design/references/type-dp-integration.md +407 -0
  90. package/src/skills/diagram-design/references/type-dp-security-matrix.md +379 -0
  91. package/src/skills/diagram-design/references/type-er.md +25 -0
  92. package/src/skills/diagram-design/references/type-exploded.md +115 -0
  93. package/src/skills/diagram-design/references/type-fishbone.md +75 -0
  94. package/src/skills/diagram-design/references/type-flowchart.md +23 -0
  95. package/src/skills/diagram-design/references/type-gantt.md +45 -0
  96. package/src/skills/diagram-design/references/type-heatmap.md +80 -0
  97. package/src/skills/diagram-design/references/type-high-level.md +470 -0
  98. package/src/skills/diagram-design/references/type-it-state.md +468 -0
  99. package/src/skills/diagram-design/references/type-journey.md +55 -0
  100. package/src/skills/diagram-design/references/type-kanban.md +49 -0
  101. package/src/skills/diagram-design/references/type-layers.md +26 -0
  102. package/src/skills/diagram-design/references/type-line.md +337 -0
  103. package/src/skills/diagram-design/references/type-loop.md +223 -0
  104. package/src/skills/diagram-design/references/type-medallion.md +356 -0
  105. package/src/skills/diagram-design/references/type-nested.md +22 -0
  106. package/src/skills/diagram-design/references/type-org-chart.md +44 -0
  107. package/src/skills/diagram-design/references/type-polar.md +136 -0
  108. package/src/skills/diagram-design/references/type-process.md +490 -0
  109. package/src/skills/diagram-design/references/type-pyramid.md +33 -0
  110. package/src/skills/diagram-design/references/type-quadrant.md +81 -0
  111. package/src/skills/diagram-design/references/type-radar.md +82 -0
  112. package/src/skills/diagram-design/references/type-sankey.md +75 -0
  113. package/src/skills/diagram-design/references/type-scatter.md +276 -0
  114. package/src/skills/diagram-design/references/type-sequence.md +130 -0
  115. package/src/skills/diagram-design/references/type-service-blueprint.md +103 -0
  116. package/src/skills/diagram-design/references/type-state.md +30 -0
  117. package/src/skills/diagram-design/references/type-story-map.md +46 -0
  118. package/src/skills/diagram-design/references/type-swimlane.md +22 -0
  119. package/src/skills/diagram-design/references/type-timeline.md +20 -0
  120. package/src/skills/diagram-design/references/type-tree.md +24 -0
  121. package/src/skills/diagram-design/references/type-treemap.md +137 -0
  122. package/src/skills/diagram-design/references/type-uml-class.md +65 -0
  123. package/src/skills/diagram-design/references/type-venn.md +26 -0
  124. package/src/skills/diagram-design/references/type-wardley.md +39 -0
  125. package/src/skills/diagram-design/references/type-waterfall.md +75 -0
  126. package/src/skills/document-project.md +4 -1
  127. package/src/skills/ownership.md +26 -4
  128. package/src/upstreams.json +14 -0
  129. package/themes/_TEMPLATE.json +1 -0
  130. package/themes/biker.json +1 -0
  131. package/themes/commentator.json +1 -0
  132. package/themes/cyberpunk.json +1 -0
  133. package/themes/gamer.json +1 -0
  134. package/themes/imperial.json +1 -0
  135. package/themes/joker.json +1 -0
  136. package/themes/marvin.json +1 -0
  137. package/themes/mean.json +1 -0
  138. package/themes/military.json +1 -0
  139. package/themes/neutral.json +1 -0
  140. package/themes/pirate.json +1 -0
  141. package/themes/sports.json +1 -0
  142. package/themes/verstappen.json +1 -0
  143. package/themes/wizard.json +1 -0
@@ -0,0 +1,75 @@
1
+ # Waterfall Chart
2
+
3
+ **Best for:** showing how a start total becomes an end total through signed contributions — a budget bridge (FY25 baseline → FY26 plan), headcount deltas (starting roster ± hires ± attrition), conversion leak/gain, P&L walk. Use when the running total is the story: every bar either anchors the total or bridges one running level to the next, and the reader traces the path from start to end.
4
+
5
+ **Not this type:**
6
+
7
+ - Two endpoints where only the *gap* matters → **dumbbell** (a Bar variant, `type-bar.md`). A dumbbell states two values and their distance; a waterfall states a path of signed steps that must reconcile. The types look adjacent but make opposite claims: the dumbbell hides what happened in between, the waterfall *is* what happened in between.
8
+ - Independent category comparisons → **bar** (`type-bar.md`).
9
+ - One quantity splitting and merging across stages → **Sankey** (`type-sankey.md`). A waterfall is strictly sequential and one-dimensional; the bars never branch.
10
+ - Ordered drop-off through stages of one funnel → **pyramid / funnel** (`type-pyramid.md`).
11
+
12
+ ## Layout conventions
13
+
14
+ - **Orientation:** vertical columns only, left → right in narrative order: start total, then each signed bridge, optional subtotal, end total. A horizontal waterfall reads as a Gantt.
15
+ - **Plot area:** left 80px (y-axis labels), bottom 60px (category labels), top 40px, right 40px — inside a `0 0 1000 500` viewBox, same frame as the bar chart. Plot band x 80→960, y 40→420.
16
+ - **Bar count:** 3–8 bars total, including both totals and at most one subtotal. More contributions than that → merge the tail into one named "Other" bridge (disclose what it contains) or split the walk into two charts.
17
+ - **Bar width / pitch:** equal-width bars on an even pitch, bar ≥ 50% of the pitch. Six bars fit as width=96 on a 144px pitch starting at x=112.
18
+ - **Totals anchor, bridges float.** The start total, any subtotal, and the end total are drawn from the domain floor (the x-axis baseline) up to their value. Bridge bars span exactly the running total before and after their contribution — an increase rises from the previous level, a decrease falls from it.
19
+ - **Carry rules (the bridge grammar).** A horizontal connector line carries the running total across each gap between adjacent bars, drawn at the shared level: from the right edge of one bar to the left edge of the next, `ink @ 0.55` at 1px on light paper (`ink @ 0.40` on dark) — the dumbbell's connector weight, because the carry is load-bearing and must clear 3:1, not the 0.25 axis hairline. Each carry declares the running total it transports in `data-carry`.
20
+ - **Machine-readable data contract.** Every bar rect declares `data-role` (`total`, `delta`, or `subtotal`), `data-value` (totals unsigned, deltas explicitly signed `+`/`-`), and `data-name`. `scripts/verify-waterfall.py` reads these and fails the build when the drawing and the declaration disagree — see the honesty rules below.
21
+ - **Sign is encoded by fill weight, not hue.** Increases take the bar family's default tint (`muted @ 0.15` fill, `muted` stroke). Decreases are hollow — paper fill, same `muted` stroke — so the two directions survive greyscale and colour-vision deficiency without leaning on the accent. The geometry (which end of the bar meets the carry) and the signed printed value are the second and third encodings of the same fact.
22
+ - **Totals are the heaviest marks:** `ink @ 0.08` fill with a 1px `ink` stroke. The reader's eye should land on the two anchors first, then walk the bridges.
23
+ - **Focal bridge (≤1, optional):** the one contribution the chart exists to show gets the bar family's focal treatment — `accent @ 0.12` fill, `accent` stroke, accent value label. It replaces that bar's sign fill; the signed label and geometry still carry the direction.
24
+ - **Value labels:** `arrow-label` role 8px. Totals and increases print above the bar top (baseline `top − 8`); decreases print below the bar bottom (baseline `bottom + 12`), because the space above a decrease is where its carry arrives. Deltas print with an explicit sign (`+64`, `−38`); totals print unsigned.
25
+ - **Gridlines / axes:** identical to the bar chart — 4–6 faint horizontal gridlines `ink @ 0.08` 0.8px, y-axis line and x-axis baseline `ink @ 0.25` 1px, tick labels `arrow-label` role 8px `muted` right-aligned at x=72, rotated y-axis title `eyebrow` role 7px tracked.
26
+ - **Category labels:** centered under each bar at y=440, `node-name` role 11px 600 `ink`; the focal bar's label may take accent.
27
+ - **Legend:** horizontal bottom strip after a hairline rule, one key per treatment used: total, increase, decrease, focal.
28
+
29
+ ### Waterfall element pattern
30
+
31
+ ```svg
32
+ <!-- Start total: anchored at the baseline (y=420), value 240 on a 0–400 domain, k=0.95 px/unit -->
33
+ <rect x="112" y="192" width="96" height="228" fill="{paper}"/>
34
+ <rect x="112" y="192" width="96" height="228" fill="{ink @ 0.08}" stroke="{ink}" stroke-width="1"
35
+ data-role="total" data-value="240" data-name="FY25 base"/>
36
+ <text x="160" y="184" fill="{muted}" font-size="8" font-family="{arrow-label}" text-anchor="middle">240</text>
37
+
38
+ <!-- Carry: the running total (240) crosses the gap at its own level -->
39
+ <line x1="208" y1="192" x2="256" y2="192" stroke="{ink @ 0.55}" stroke-width="1" data-carry="240"/>
40
+
41
+ <!-- Increase bridge: +64 rises from 240 to 304 -->
42
+ <rect x="256" y="131" width="96" height="61" fill="{paper}"/>
43
+ <rect x="256" y="131" width="96" height="61" fill="{muted @ 0.15}" stroke="{muted}" stroke-width="1"
44
+ data-role="delta" data-value="+64" data-name="Headcount"/>
45
+ <text x="304" y="123" fill="{muted}" font-size="8" font-family="{arrow-label}" text-anchor="middle">+64</text>
46
+ ```
47
+
48
+ Endpoint positions round to the nearest integer pixel and never snap to the 4px grid — data coordinates are exempt, exactly as in the dumbbell. Bar x-positions and widths are layout, so they stay on the grid.
49
+
50
+ ## Anti-patterns
51
+
52
+ - **A floating bar with no carry.** The connector is the claim that the total is conserved across the gap; without it the chart is bars at odd heights.
53
+ - **Sign by hue alone** (green up / red down, or accent on every decrease). Hue is the one channel that does not survive greyscale or CVD; fill weight and geometry carry the sign here, and the accent stays editorial.
54
+ - **A truncated value axis.** The domain follows the data's range, never its observed extremes — the same rule, cases, and all-zero fallback as the dumbbell (`type-bar.md` § Dumbbell honesty rules). A waterfall on a clipped domain inflates every bridge.
55
+ - **More than one subtotal.** A walk that needs several resting points is two walks; split it.
56
+ - **Mixing units mid-walk.** Every bar is in the start total's unit or the reconciliation is fiction.
57
+ - **3-D, shadows, rounded bridge bars** — same editorial rules as every chart here.
58
+
59
+ ## Waterfall honesty rules
60
+
61
+ - **Decimal declarations conserve exactly.** Fractional budgets use exact decimal arithmetic for totals, carries, and printed-value identity; geometry retains its pixel-rounding allowance. A binary floating point accumulation error must not reject a reconciled dollar-and-cent walk, and an actual decimal discrepancy is still a failure.
62
+ - **The running total must conserve.** Start + every signed bridge = each subtotal and the end total, exactly — the declared `data-value`s must reconcile before geometry is even considered. A waterfall that doesn't add up is not approximately right, it is wrong.
63
+ - **Bridges span exactly their two running levels.** Each bar's drawn top and bottom must sit where the shared scale puts the running totals before and after it (±0.75px for integer rounding). Stretching one bridge "for legibility" moves money that doesn't exist.
64
+ - **Every carry sits at the level it transports,** spanning its full gap, and declares that value. A carry drawn at the wrong height reconnects the walk to a different total.
65
+ - **Every bar prints its value, deltas with an explicit sign.** An unsigned bridge asks the reader to infer direction from geometry alone; print `+`/`−`.
66
+ - **Zero bridges are dropped, never drawn.** A zero-height bar is invisible ink that still occupies a column; state it in prose or the source line instead.
67
+ - **A degenerate start (zero or negative total) is a named failure,** not a silently rescaled chart — the scale is derived from the start anchor.
68
+
69
+ These rules are executable: `scripts/verify-waterfall.py` reads each bar's declaration, recomputes the running totals, refits the shared scale from the start anchor, and fails on any conservation, geometry, carry, label, or sign-treatment drift. `scripts/test-verify-waterfall.py` proves both polarities — the shipped examples pass, and each mutation class above fails with a named finding.
70
+
71
+ ## Examples
72
+
73
+ - `assets/example-waterfall.html` — minimal light
74
+ - `assets/example-waterfall-dark.html` — minimal dark
75
+ - `assets/example-waterfall-full.html` — full editorial
@@ -84,7 +84,10 @@ write; with none, step 5 proposes them.
84
84
  - **Stand alone, fully offline** — a single file, content pre-rendered to semantic HTML,
85
85
  all styling in one inline `<style>`, at most minimal vanilla JS (light/dark toggle, TOC
86
86
  scroll). No CDN, no external assets, no web fonts (use a system-font stack). Render any
87
- diagram as hand-authored inline SVG or CSS — never a CDN library.
87
+ diagram as inline SVG or CSS — never a CDN library. When the `diagram-design` {{SKILL}} is
88
+ installed, draw each diagram (C4 views, flows, data models) through it and paste its SVG
89
+ inline: skip its first-run style-guide gate and keep this page's project-facing palette.
90
+ Without it, hand-author the SVG.
88
91
  - **Stay project-facing** — clean and professional styling, never the harness voice; and
89
92
  footer it with `mirrors commit <sha> · generated <date>` so the sync is auditable.
90
93
 
@@ -44,6 +44,22 @@ Granularity: team # or a level finer than the team default
44
44
  - <date> <decision the developer took, with their reason>
45
45
  ```
46
46
 
47
+ Create it only when there is personal state to store: a granularity finer than the team
48
+ default, the first `## Pending` checkpoint, the first `## Decisions` entry, or the developer's
49
+ decline. No file means the team granularity, nothing pending and no decisions. `AGENTS.md` stays
50
+ the only team configuration.
51
+
52
+ The decline is the line `Setup: declined <YYYY-MM-DD>`, alone on its line. Write it only when the
53
+ developer answers "skip in this repo until I ask" to the setup proposal. Write it in the **main
54
+ worktree's** `.geneseed/ownership.md`: in a linked git worktree, that is the main checkout's (the
55
+ parent of the shared `.git`), so the decline outlives the worktree. The gate reads it only there.
56
+ If that write is refused (outside the session's working directory, a sandbox, a declined
57
+ permission prompt), tell the developer the decline was not saved, and why. Never write it inside
58
+ the linked worktree instead: the gate does not read it there. It is personal: it
59
+ silences the proposal and the first-write gate for this developer in this repo, with no expiry,
60
+ until they delete the line or ask for the setup. A `## Ownership` section in `AGENTS.md`, on or
61
+ off, outranks it.
62
+
47
63
  A personal override may only be finer than the team default. A coarser one needs the developer's
48
64
  explicit yes, logged under `## Decisions`.
49
65
 
@@ -62,15 +78,21 @@ Run it when the repo has no `## Ownership` section, or when the developer asks.
62
78
  3. **Interview.** About five questions, one at a time, each with a recommended answer: confirm or
63
79
  correct the conventions; ownership on for this repo; the default granularity; the sensitive
64
80
  zones (for example `payment/`, migrations, security config); free-form project rules.
65
- 4. **Write** — the only write of the setup: `AGENTS.md` (at most ~60 lines, this section
66
- included) and `.geneseed/ownership.md`. Show the diff. Commit only on request.
81
+ 4. **Write** — `AGENTS.md` (at most ~60 lines, this section included). Show the diff. Commit
82
+ `AGENTS.md` only on request. In the same pass, remove a `Setup: declined` line from the main
83
+ worktree's `.geneseed/ownership.md` if there is one; write nothing else there. That file is personal
84
+ state, created later only when needed, and never committed.
67
85
  5. **Check how diffs reach the developer.** Read the permission mode from the host's settings;
68
86
  when the live mode cannot be seen there, ask the developer. If edits are auto-accepted (bypass,
69
87
  accept-edits), warn that no native diff will stop for them; if they keep it, use the compact
70
88
  diff (see *Each checkpoint*). On OpenCode, propose `permission.edit: "ask"` in the project
71
89
  `opencode.json`.
72
90
 
73
- "Proceed without" skips the setup for this session only; propose it again in the next one.
91
+ The proposal offers three answers: set it up now; skip this session; or skip in this repo until
92
+ asked. "Skip this session" writes nothing; propose it again in the next session. "Skip in this
93
+ repo" writes the decline line (see *Personal state*), and creates `.geneseed/.gitignore` by the
94
+ rule above if it is absent. A context line `Ownership: setup declined since <date>` means that
95
+ decline is in force: propose nothing, and repeat the line once, verbatim, in your first reply.
74
96
 
75
97
  ## Granularity
76
98
  - `feature` — one checkpoint on the plan; then each file is announced as routine, and its Edit is
@@ -131,7 +153,7 @@ and sensitive zones as checkpoints — still apply on top.
131
153
 
132
154
  ## Done when
133
155
  - The root `AGENTS.md` has `## Ownership` outside the Geneseed block, or the developer chose
134
- "proceed without" or `mode: off`; every interface and sensitive-zone change got its own
156
+ to skip (this session, or in this repo until asked) or `mode: off`; every interface and sensitive-zone change got its own
135
157
  checkpoint; no code landed without an answered checkpoint or an accepted Edit; each fork,
136
158
  interface, sensitive-zone change and granularity change is logged in `.geneseed/ownership.md`;
137
159
  and the developer can say, for each change, what changed, where and why.
@@ -13,6 +13,13 @@
13
13
  "license": "MIT",
14
14
  "licenseFile": null
15
15
  },
16
+ "diagram-design": {
17
+ "repo": "cathrynlavery/diagram-design",
18
+ "commit": "0cf73c3fcc56667ad91a9a04c439ac6ccfabc9d1",
19
+ "author": "Cathryn Lavery",
20
+ "license": "MIT",
21
+ "licenseFile": "skills/diagram-design/LICENSE"
22
+ },
16
23
  "mattpocock-skills": {
17
24
  "repo": "mattpocock/skills",
18
25
  "commit": "5beb35b040e3de97e54fa9e386d7e42d15c295c2",
@@ -62,5 +69,12 @@
62
69
  "author": "Affaan Mustafa",
63
70
  "license": "MIT",
64
71
  "licenseFile": "licenses/everything-claude-code.txt"
72
+ },
73
+ "i-have-adhd": {
74
+ "repo": "ayghri/i-have-adhd",
75
+ "commit": "1ecea1993b7fce257ffbd686c070948b5e07eda6",
76
+ "author": "Ayoub Ghriss",
77
+ "license": "MIT",
78
+ "licenseFile": "licenses/i-have-adhd.txt"
65
79
  }
66
80
  }
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "<one-line description: teach toward a result — crash course, decode confusing material, or a day-by-day path to a deadline>",
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\">",
68
69
  "DESC_QUIZ": "<one-line description: test what the user knows instead of explaining — drill, explain-it-back check, or mastery claim stress-tested>",
69
70
  "DESC_LEARN_MODE": "<one-line description: learn while building — the user designs at checkpoints, the agent writes the agreed code, state kept per project>",
70
71
  "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>",
package/themes/biker.json CHANGED
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "Get a rider road-ready — a crash course from never-ridden to rolling, a confusing manual decoded till it clicks, or a day-by-day route to a deadline.",
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\".",
68
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.",
69
70
  "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.",
70
71
  "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.",
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "Bring a rookie up to speed — a crash course to race-ready, a confusing regulation decoded until it clicks, or a day-by-day programme to the deadline.",
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\".",
68
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.",
69
70
  "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.",
70
71
  "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.",
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "Bring a user online — a crash course from zero to operational, confusing data decoded until it clicks, or a day-by-day route to a deadline.",
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\".",
68
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.",
69
70
  "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.",
70
71
  "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.",
package/themes/gamer.json CHANGED
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "Level the player up toward a result — a crash course from tutorial to playable, a confusing mechanic decoded until it clicks, or a day-by-day grind to a deadline.",
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\".",
68
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.",
69
70
  "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.",
70
71
  "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.",
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "Instruct the supplicant toward a result — a crash course from ignorance to function, a confusing text decoded until it clicks, or a day-by-day path to the appointed hour.",
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\".",
68
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.",
69
70
  "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.",
70
71
  "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.",
package/themes/joker.json CHANGED
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "Get someone functional — a crash course from open-mic nerves to a tight five, confusing material decoded until it clicks, or a day-by-day path to the deadline.",
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\".",
68
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.",
69
70
  "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.",
70
71
  "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.",
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "Teach the user toward a result — a crash course from nothing to functional, confusing material decoded until it clicks, or a day-by-day path to a deadline. They may even retain some of it.",
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\".",
68
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.",
69
70
  "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.",
70
71
  "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.",
package/themes/mean.json CHANGED
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "Teach the user toward a result — a crash course from clueless to functional, confusing material decoded until it finally clicks, or a day-by-day path to a deadline they'll probably miss.",
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\".",
68
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.",
69
70
  "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.",
70
71
  "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.",
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "Train the recruit toward a result — a crash course to operational, a confusing manual decoded until it clicks, or a day-by-day programme to the deadline.",
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\".",
68
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.",
69
70
  "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.",
70
71
  "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.",
@@ -65,6 +65,7 @@
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
67
  "DESC_TEACH": "Teach the user toward a result — a crash course from zero to functional, confusing material decoded until it clicks, or a day-by-day path to a deadline.",
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\".",
68
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.",
69
70
  "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.",
70
71
  "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.",
@@ -65,6 +65,7 @@
65
65
  "DESC_BRICK_FORGE": "Forge or refit a loop brick, then pass it through geneseed loop check.",
66
66
  "DESC_DEVELOP": "Sail a change through the cover-and-verify tack — the smallest move, trials rigged to cover it, the touched trials run clean, sealed one cargo at a time.",
67
67
  "DESC_TEACH": "Get a landlubber seaworthy — a crash course from dock to deck, a confusing chart decoded till it clicks, or a day-by-day course to the deadline.",
68
+ "DESC_ADHD": "Chart every reply for a reader with ADHD — next order first, numbered steps, the heading restated each turn, side voyages held back, true time estimates. On until \"stop adhd mode\".",
68
69
  "DESC_QUIZ": "Test what the crew truly knows instead of telling them — drill a knack to reflex, make them recite it back, or call the bluff on a claimed mastery — with a plain readout of the gaps.",
69
70
  "DESC_LEARN_MODE": "Let the crew chart the course — they reason out each design at its checkpoint, you build only what they agreed, and the mode holds per project across voyages.",
70
71
  "DESC_OWNERSHIP": "Keep the captain master of the production code — they approve each part at checkpoints, as close as they choose to steer, and the ship's articles hang in the root AGENTS.md.",
@@ -65,6 +65,7 @@
65
65
  "DESC_BRICK_FORGE": "Draw up or adapt a loop brick, then run it through geneseed loop check.",
66
66
  "DESC_DEVELOP": "Drive it in on cover-and-verify — smallest gain, a test set on the new ground, the affected drills green, and log it snap by snap.",
67
67
  "DESC_TEACH": "Coach the player toward a result — a crash course from bench to game-ready, a confusing playbook decoded until it clicks, or a day-by-day training plan to the deadline.",
68
+ "DESC_ADHD": "Coach every reply for a reader with ADHD — next play first, numbered steps, the score restated each turn, tangents benched, real time estimates. On until \"stop adhd mode\".",
68
69
  "DESC_QUIZ": "Test the player instead of coaching — a drill to reflex, an explain-it-back film session, or a claimed mastery stress-tested — with a straight readout of the gaps.",
69
70
  "DESC_LEARN_MODE": "Put the player on the playbook — they call each design at its checkpoint, you run only the agreed play, and the mode holds per project across sessions.",
70
71
  "DESC_OWNERSHIP": "Keep the coach in charge of the production code — they call each part at checkpoints of the granularity they set, and the team's playbook sits in the root AGENTS.md.",
@@ -65,6 +65,7 @@
65
65
  "DESC_BRICK_FORGE": "Build or tune a loop brick, then run it through geneseed loop check.",
66
66
  "DESC_DEVELOP": "Drive the change home — smallest move, a test written to cover it, the affected trials green, and sealed commit by commit.",
67
67
  "DESC_TEACH": "Get the user up to speed — a crash course from zero to functional, confusing material decoded until it clicks, or a day-by-day programme to the deadline. No wasted laps.",
68
+ "DESC_ADHD": "Race every reply for a reader with ADHD — next action first, numbered steps, the gap restated each lap, tangents held back, real time estimates. On until \"stop adhd mode\".",
68
69
  "DESC_QUIZ": "Test what they actually know instead of explaining it — a drill to reflex, an explain-it-back debrief, or a claimed mastery stress-tested — with a straight readout of the gaps.",
69
70
  "DESC_LEARN_MODE": "Put the driver on strategy — they make each design call at its checkpoint, you execute only the agreed code, and the mode holds per project across sessions.",
70
71
  "DESC_OWNERSHIP": "Keep the driver in charge of the production code — they make every call at checkpoints of the granularity they set, and the team's rules sit in the root AGENTS.md.",
@@ -65,6 +65,7 @@
65
65
  "DESC_BRICK_FORGE": "Inscribe or adapt a loop brick, then prove it with geneseed loop check.",
66
66
  "DESC_DEVELOP": "Drive a working through the cover-and-confirm loop — the smallest casting, its trials written, the touched trials green, sealed rune by rune.",
67
67
  "DESC_TEACH": "Tutor the apprentice toward a result — a crash course from novice to working caster, a confusing grimoire decoded until it clicks, or a day-by-day path to the appointed day.",
68
+ "DESC_ADHD": "Shape every reply for a reader with ADHD — the next step of the spell first, numbered steps, the state recited each turn, tangents held back, true time estimates. On until \"stop adhd mode\".",
68
69
  "DESC_QUIZ": "Test the apprentice rather than lecture — a drill to reflex, an explain-it-back examination, or a claimed mastery put to trial — with an unvarnished readout of the gaps.",
69
70
  "DESC_LEARN_MODE": "Take on an apprentice at the forge — they reason out each design at its checkpoint, you cast only the agreed code, and the apprenticeship persists per project across sessions.",
70
71
  "DESC_OWNERSHIP": "Keep the mage the keeper of their own code — they bless each part at checkpoints of the granularity they set, and the guild's laws are inscribed in the root AGENTS.md.",