geneseed 3.17.0 → 3.19.0

package/js/lib/json.mjs

@@ -38,7 +38,7 @@ class JsonNumber {
    * Python would have \u2014 NOT the original literal, because `json.dumps(json.loads('1.50'))`
    * is `1.5`: Python re-formats through repr rather than echoing the source.
    */
-  toJSON() { return JSON.rawJSON(formatValue(this)); }
+  toJSON() { return /** @type {any} */ (JSON).rawJSON(formatValue(this)); }
 }
 
 /**

package/js/maintain/migrate.mjs

@@ -213,8 +213,9 @@ export function cmdMigrate(args = {}) {
   // `process 5` among them) and dropped `--config-dir`, so a global found through
   // `CLAUDE_CONFIG_DIR`/`OPENCODE_CONFIG_DIR` re-emitted into the DEFAULT dir instead.
   for (const r of rows) {
-    const { emit, theme, argv } = installProfile(r.host, r.scope, r.root);
     const label = `${r.host}:${r.scope} (${r.root})`;
+    const { emit, theme, argv } = installProfile(r.host, r.scope, r.root,
+      (n) => printErr(`[migrate] ${label}: ${n}\n`));
     printOut(`[migrate] re-emitting ${label}: theme=${theme} emit=${emit}\n`);
     let rc = 1;
     try { rc = driverMain(argv); } catch { rc = 1; }

package/js/maintain/uninstall.mjs

@@ -155,6 +155,7 @@ function pruneAncestors(start, stop) {
  * `ownedWithin` first, the same containment boundary deactivate draws: the manifest is a file
  * on disk, and without it an `owned` entry of `../../.bashrc` was unlinked — and the prune
  * then climbed from ITS parent, which never meets `base`, removing empty directories as it went.
+ * @returns {[number, string[]]}
  */
 function unlinkOwned(base, owned, label = '') {
   let removed = 0;
@@ -758,9 +759,7 @@ export function cmdUninstall(args) {
  */
 function moveTree(src, dst) {
   if (existsSync(dst)) {
-    const e = new Error(String(dst));
-    e.code = 'EEXIST';
-    throw e;
+    throw Object.assign(new Error(String(dst)), { code: 'EEXIST' });
   }
   mkdirSync(path.dirname(dst), { recursive: true });
   renameSync(src, dst);

package/js/maintain/update.mjs

@@ -270,6 +270,7 @@ export function killTree(child) {
  * `tests/unit/update_git.test.mjs` runs it over a recorded fetch transcript instead.
  *
  * Returns `[linesToLog, lastPhase]`, splitting the reference's loop from its side effects.
+ * @returns {[string[], string]}
  */
 export function fetchPhases(rawLines, last = '') {
   const out = [];
@@ -609,13 +610,17 @@ async function drainStdout() {
  * rewritten markers back through `installProfile`, so the loss stuck. `installProfile` is the
  * one reader of an install's axes; this takes its answer rather than growing a second one.
  *
+ * `notify` hears the one-line notice for an excluded skill since merged or retired, as
+ * `rebuild-all` prints it. `upgrade` reads it BEFORE the pull, so it reflects the pre-pull
+ * alias table: a skill merged by the very commits being pulled is not named until the next run.
+ *
  * Only the TAIL of the argv is kept: theme and emit are `upgrade`'s to decide (a theme argument
  * may override the marker), and `setupBuildArgs` opens with exactly those four tokens when it
  * is given no out and no root.
  */
-export async function installAxes(dir, { installProfile, setupBuildArgs }) {
+export async function installAxes(dir, { installProfile, setupBuildArgs }, notify = null) {
   if (!existsSync(path.join(String(dir), '.geneseed-emit'))) return [];
-  const p = installProfile('opencode', 'global', String(dir));
+  const p = installProfile('opencode', 'global', String(dir), notify);
   return setupBuildArgs('', 'files', null, null, p.footprint, p.posture, p.mode, p.doctrines,
     undefined, p.excludeRules, p.trust, p.excludeSkills).slice(4);
 }
@@ -704,7 +709,8 @@ export async function upgrade(ref = null, themeArg = null) {
   // `installAxes` for why the target's own axes must be carried into the rebuild.
   const [generate, { bounceDaemonIfRunning }] = await Promise.all([
     import('../build/generate.mjs'), import('../web/daemon.mjs')]);
-  const axes = await installAxes(emit === 'opencode-global' ? cfg : out, generate);
+  const axes = await installAxes(emit === 'opencode-global' ? cfg : out, generate,
+    (n) => log(`[upgrade] ${n}`));
 
   log(`[geneseed] fetching from origin (git: ${which('git') || 'git'}, `
     + `timeout: ${fetchTimeout()}s) ...`);
@@ -921,6 +927,7 @@ async function bootstrapPlain() {
   // deployed harness's local edits are overwritten by the rebuild with nothing recorded.
   // Caught by `bootstrap/an-improvements-file-the-step-exported-is-re-announced-afterwards`,
   // which was written for `_flush_export_notes` and found this instead.
+  /** @type {Array<[string, string[], () => Promise<number>]>} */
   const steps = [['Update & rebuild', updateStepCmd('upgrade'),
     () => cmdUpgrade({ ref: null, theme: null })]];
   let failed = false;

package/js/ui/menu.mjs

@@ -103,11 +103,11 @@ export function cmdMenu() {
 }
 
 /** `cmd_home` — the default for a bare `geneseed`. */
-export async function cmdHome(args) {
+export async function cmdHome(_args) {
   if (webFirstOk()) {
     printOut('[geneseed] opening the web console — `geneseed menu` for the terminal UI, '
       + 'GENESEED_NO_WEB=1 to disable.\n');
     return startDaemon(null, 4747, true);
   }
-  return cmdMenu(args);
+  return cmdMenu();
 }

package/js/ui/tui.mjs

@@ -279,6 +279,7 @@ export function mark(kind) {
  * — the order they are read in, the order AGENT.md renders them, and the order the console's
  * three bands appear in. `Rule` and `Doctrine` are hardcoded English here, as `Rule` already
  * was: this function receives an inventory, not a theme's nouns.
+ * @returns {any[][]}
  */
 export function tuiEntries(inv) {
   const rows = [['head', `AGENTS (${inv.agents.length})`, null]];

package/js/web/api.mjs

@@ -275,6 +275,7 @@ const RECENT_LIMIT = 8;
  * law files, so a per-rule mtime would be the file's, repeated — one wrong date on nine rows.
  */
 export function apiRecent(state) {
+  /** @type {Array<[string, string, () => any[]]>} */
   const sections = [
     ['memory', 'memory', () => memoryItems(state)],
     ['notebook', 'notebook', () => notebookItems(state)],
@@ -316,6 +317,7 @@ export function apiLoops(state) {
   const opts = { projectRoot: state.root };
   const catalog = loadCatalog(opts);
   const { bricks, templates, overridden } = catalog;
+  /** @type {(x: [string, any], y: [string, any]) => number} */
   const byName = ([a], [b]) => (a < b ? -1 : 1);
   return {
     templates: [...templates].sort(byName).map(([name, { origin, ...graph }]) => ({

package/js/web/catalog.mjs

@@ -77,6 +77,10 @@ function specEntries(root, nested) {
   for (const p of files) {
     if (!isFile(p)) continue;
     const [fm, body] = frontmatter(readMaybe(p) ?? '');
+    // An alias folder (native.mjs: an old name kept answering `/name`) is its target skill
+    // under a second name, not a skill of the user's own — listing it would read "personal".
+    if (nested && fm.get('disable-model-invocation') === 'true'
+      && (fm.get('description') ?? '').startsWith('Alias of ')) continue;
     const name = nested ? path.basename(path.dirname(p)) : path.basename(p, '.md');
     out.push({ name, desc: specDesc(fm, body), body, source: resolvePath(p) });
   }
@@ -179,15 +183,27 @@ export function notebookItems(state) {
   }));
 }
 
-/** The two setup manifests, in listing order. */
+/**
+ * The wiki manifest's names, current first. `wiki.jsonc` is the name before the `geneseed-`
+ * prefix: the build renames it on the next emit, and until then it is still read — one release.
+ */
+const WIKI_NAMES = ['geneseed-wiki.jsonc', 'wiki.jsonc'];
+const WIKI_META = ['Wiki manifest', 'your machine-wide knowledge base(s)'];
+
+/** The two setup manifests, in listing order (the wiki under either of its names). */
 const CONFIG_META = {
   'context.json': ['Project context', 'what the agent loads for this project'],
-  'wiki.jsonc': ['Wiki manifest', 'your machine-wide knowledge base(s)'],
+  'geneseed-wiki.jsonc': WIKI_META,
+  'wiki.jsonc': WIKI_META,
 };
 
+/** The wiki manifest beside the bundle under whichever name it has, or `null`. */
+const wikiName = (state) => WIKI_NAMES.find((n) => isFile(path.join(state.target, n))) ?? null;
+
 export function configItems(state) {
   const out = [];
-  for (const fname of ['context.json', 'wiki.jsonc']) {
+  for (const fname of ['context.json', wikiName(state)]) {
+    if (!fname) continue;
     const p = path.join(state.target, fname);
     if (!isFile(p)) continue;
     const [title, desc] = CONFIG_META[fname] ?? [fname, ''];
@@ -227,7 +243,7 @@ function wikiPath(p) {
 }
 
 /**
- * `$GENESEED_WIKI` first, else `wiki.jsonc` beside the deployed bundle, read with the
+ * `$GENESEED_WIKI` first, else the wiki manifest beside the deployed bundle, read with the
  * harness's generic JSONC loader.
  *
  * `resolvePath`, not merely `expanduser`: harmless here because `p` is consumed by `isFile`
@@ -236,7 +252,8 @@ function wikiPath(p) {
  */
 function wikiManifest(state) {
   const cand = process.env.GENESEED_WIKI;
-  const p = cand ? wikiPath(cand) : path.join(state.target, 'wiki.jsonc');
+  const name = cand ? null : wikiName(state);
+  const p = cand ? wikiPath(cand) : name && path.join(state.target, name);
   if (!p || !isFile(p)) return [];
   const cfg = mcpLoad(p);
   const wikis = cfg.wikis;
@@ -248,7 +265,7 @@ function wikiManifest(state) {
  * unparseable, or not an object.
  *
  * Comment-tolerant is the whole point, and getting this wrong is silent: the two files it
- * reads are `wiki.jsonc` and `context.json`, hand-maintained, so a `//` line is expected.
+ * reads are `geneseed-wiki.jsonc` and `context.json`, hand-maintained, so a `//` line is expected.
  * Plain `JSON.parse` would throw on it and this loader would then answer `{}` — the wiki
  * section listing nothing and the config item's `manifest` coming back empty, with no
  * error surfaced anywhere.
@@ -389,7 +406,7 @@ export function resolveLinks(state, body) {
  */
 function configManifest(name, p) {
   const cfg = mcpLoad(p);
-  if (name === 'wiki.jsonc') {
+  if (WIKI_NAMES.includes(name)) {
     const wikis = cfg.wikis;
     return { kind: 'wiki', wikis: Array.isArray(wikis) ? wikis : [] };
   }

package/js/web/daemon.mjs

@@ -31,7 +31,7 @@ const ROOT = pathResolve(import.meta.dirname, '..', '..');
 export function codeStamp(root = ROOT) {
   const read = (rel) => { try { return readFileSync(join(root, rel)); } catch { return ''; } };
   let version = 'unknown';
-  try { version = JSON.parse(read('package.json')).version ?? version; } catch { /* unknown */ }
+  try { version = JSON.parse(String(read('package.json'))).version ?? version; } catch { /* unknown */ }
   const html = createHash('sha256').update(read(join('web', 'dist', 'index.html'))).digest('hex');
   return `${version}:${html.slice(0, 12)}`;
 }
@@ -161,6 +161,7 @@ export const none = (v) => (v === undefined || v === null ? 'None' : String(v));
  */
 function spawnDetached(webArgs, log) {
   const cmd = [process.execPath, join(ROOT, 'bin', 'geneseed-cli.mjs'), 'web', ...webArgs];
+  /** @type {'ignore' | number} */
   let out = 'ignore';
   try {
     out = openSync(log, 'a');

package/js/web/routes.mjs

@@ -41,6 +41,7 @@ import { apiProfile, apiProfileSave, apiRules, apiRulesMutate, apiRulesPromote }
  * `NotFound` is caught once, in `handler`, not per route — repeating the catch here would
  * only duplicate it.
  */
+/** @type {Map<string, [(state: any, body: any) => any, boolean]>} */
 export const POST_ROUTES = new Map([
   ['/api/mcp', [apiMcpToggle, true]],
   ['/api/install', [apiInstallToggle, true]],
@@ -117,6 +118,7 @@ export function readJsonBody(buf) {
  * `percentDecode` and not `decodeURIComponent`: the JS builtin throws a `URIError` on a `%`
  * that is not an escape, where this shell instead answers a 404 naming the literal text.
  */
+/** @type {Array<[string, (state: any, path: string) => any]>} */
 export const PREFIX_ROUTES = [
   ['/api/catalog/', (state, p) => apiCatalog(state, p.split('/').pop())],
   // /api/item/<type>/<name> — TYPE has no slash, the NAME keeps its slashes so a wiki

package/js/web/server.mjs

@@ -154,7 +154,7 @@ export async function serve({ theme = null, port = 4747, openBrowser = true,
     srv.listen(port, '127.0.0.1', () => ready());
 
     function ready() {
-      const hostPort = srv.address().port;
+      const hostPort = /** @type {import('node:net').AddressInfo} */ (srv.address()).port;
       const url = `http://127.0.0.1:${hostPort}`;
       if (daemon) {
         writeDaemon(state.target, {

package/js/web/user-files.mjs

@@ -107,6 +107,7 @@ function parseRuleMeta(line) {
  * Every rule carries its `start`/`end` LINE INDICES, which is what lets `apiRulesMutate`
  * splice exactly one block and leave every other byte of the user's file — prose,
  * formatting, hand-written sections — untouched.
+ * @returns {[Array<{id: number, start: number, end: number} & Record<string, any>>, string[]]}
  */
 export function parseRules(text) {
   const lines = splitLines(text);

package/package.json

@@ -1,7 +1,7 @@
 {
   "//": "Every field here is argued and gated in tests/unit/package_manifest.test.mjs. `files`, `bin` and `engines` each have a test that fails when reality drifts from this file; `version` mirrors harness.config.json and is gated too. Read that docblock before editing this one.",
   "name": "geneseed",
-  "version": "3.17.0",
+  "version": "3.19.0",
   "description": "A portable, theme-able harness you implant once and use everywhere to grow a disciplined AI coding agent.",
   "keywords": [
     "ai",
@@ -54,11 +54,19 @@
     "SHIPPED.md"
   ],
   "devDependencies": {
+    "@commitlint/cli": "^21.2.3",
+    "@commitlint/config-conventional": "^21.2.3",
     "@eslint/js": "^10.0.1",
+    "@stryker-mutator/core": "^10.0.0",
+    "@types/node": "^22.20.5",
+    "c8": "^12.0.0",
     "eslint": "^10.9.0",
-    "globals": "^17.11.0"
+    "fast-check": "^4.10.2",
+    "globals": "^17.11.0",
+    "typescript": "^5.9.3"
   },
   "scripts": {
-    "lint": "eslint js bin tests adapters"
+    "lint": "eslint js bin tests adapters fuzz",
+    "typecheck": "tsc -p ."
   }
 }

package/registry.json

@@ -141,25 +141,11 @@
       "added": "2026-10-03",
       "last_verified": ""
     },
-    "skills/bruno-collection-generator": {
+    "skills/bruno": {
       "status": "experimental",
       "version": "1.0.0",
       "owner": "Guillaume Lemer",
-      "added": "2026-09-03",
-      "last_verified": ""
-    },
-    "skills/bruno-test-writer": {
-      "status": "experimental",
-      "version": "1.0.0",
-      "owner": "Guillaume Lemer",
-      "added": "2026-09-03",
-      "last_verified": ""
-    },
-    "skills/ci-fix": {
-      "status": "experimental",
-      "version": "1.0.0",
-      "owner": "Guillaume Lemer",
-      "added": "2026-09-06",
+      "added": "2026-10-08",
       "last_verified": ""
     },
     "skills/codebase-design": {
@@ -176,13 +162,6 @@
       "added": "2026-06-01",
       "last_verified": "2026-09-06"
     },
-    "skills/consolidate-memory": {
-      "status": "experimental",
-      "version": "1.0.0",
-      "owner": "Guillaume Lemer",
-      "added": "2026-09-06",
-      "last_verified": ""
-    },
     "skills/council": {
       "status": "approved",
       "version": "1.0.0",
@@ -204,11 +183,11 @@
       "added": "2026-06-03",
       "last_verified": "2026-09-06"
     },
-    "skills/deps-audit": {
+    "skills/dependencies": {
       "status": "experimental",
       "version": "1.0.0",
       "owner": "Guillaume Lemer",
-      "added": "2026-09-06",
+      "added": "2026-10-08",
       "last_verified": ""
     },
     "skills/develop": {
@@ -225,12 +204,12 @@
       "added": "2026-06-10",
       "last_verified": "2026-09-06"
     },
-    "skills/domain-modeling": {
-      "status": "approved",
+    "skills/explain-changes": {
+      "status": "experimental",
       "version": "1.0.0",
       "owner": "Guillaume Lemer",
-      "added": "2026-07-13",
-      "last_verified": "2026-09-06"
+      "added": "2026-09-30",
+      "last_verified": ""
     },
     "skills/forge-mcp": {
       "status": "approved",
@@ -267,19 +246,12 @@
       "added": "2026-06-19",
       "last_verified": "2026-09-06"
     },
-    "skills/git-archaeology": {
-      "status": "approved",
-      "version": "1.0.0",
-      "owner": "Guillaume Lemer",
-      "added": "2026-06-10",
-      "last_verified": "2026-09-06"
-    },
-    "skills/git-rescue": {
-      "status": "approved",
+    "skills/git-history": {
+      "status": "experimental",
       "version": "1.0.0",
       "owner": "Guillaume Lemer",
-      "added": "2026-06-10",
-      "last_verified": "2026-09-06"
+      "added": "2026-10-08",
+      "last_verified": ""
     },
     "skills/handoff": {
       "status": "approved",
@@ -316,20 +288,6 @@
       "added": "2026-10-03",
       "last_verified": ""
     },
-    "skills/migrate": {
-      "status": "approved",
-      "version": "1.0.0",
-      "owner": "Guillaume Lemer",
-      "added": "2026-06-08",
-      "last_verified": "2026-09-06"
-    },
-    "skills/opencode-theme": {
-      "status": "approved",
-      "version": "1.0.0",
-      "owner": "Guillaume Lemer",
-      "added": "2026-06-19",
-      "last_verified": "2026-09-06"
-    },
     "skills/parallel-agents": {
       "status": "approved",
       "version": "1.0.0",
@@ -407,13 +365,6 @@
       "added": "2026-06-07",
       "last_verified": "2026-09-06"
     },
-    "skills/repo-map": {
-      "status": "approved",
-      "version": "1.0.0",
-      "owner": "Guillaume Lemer",
-      "added": "2026-06-01",
-      "last_verified": "2026-09-06"
-    },
     "skills/research": {
       "status": "approved",
       "version": "1.0.0",
@@ -470,13 +421,6 @@
       "added": "2026-09-06",
       "last_verified": ""
     },
-    "skills/tickets": {
-      "status": "approved",
-      "version": "1.0.0",
-      "owner": "Guillaume Lemer",
-      "added": "2026-07-13",
-      "last_verified": "2026-09-06"
-    },
     "skills/token-report": {
       "status": "experimental",
       "version": "1.0.0",
@@ -484,13 +428,6 @@
       "added": "2026-07-29",
       "last_verified": ""
     },
-    "skills/explain-changes": {
-      "status": "experimental",
-      "version": "1.0.0",
-      "owner": "Guillaume Lemer",
-      "added": "2026-09-30",
-      "last_verified": ""
-    },
     "skills/wayfinder": {
       "status": "approved",
       "version": "1.0.0",

package/src/AGENT.md.tmpl

@@ -45,7 +45,7 @@ it as your very first tool call — before loading context, reading files, or se
 skipped) and the `eager` entries of `context.json`. If no `=== SESSION FILES ===` or
 `=== PROJECT CONTEXT ===` block is in your context, read them yourself first:
 `{{AT_HARNESS}}user-rules.md`, `{{AT_HARNESS}}PROFILE.md`, `{{DIR_MEMORY}}/MEMORY.md`,
-`{{DIR_NOTEBOOK}}/NOTEBOOK.md`, `{{AT_HARNESS}}wiki.jsonc`, `{{AT_HARNESS}}context.json`.
+`{{DIR_NOTEBOOK}}/NOTEBOOK.md`, `{{AT_HARNESS}}geneseed-wiki.jsonc`, `{{AT_HARNESS}}context.json`.
 
 **Response voice.** {{VOICE}} This sets *tone and vocabulary* — the section *layout*,
 the law *numbers*, file paths, and folder names stay plain English so tooling and links
@@ -226,17 +226,14 @@ the ten council seats are convened by the [council {{SKILL}}]({{DIR_SKILLS}}/cou
 | --- | --- |
 | [brainstorm]({{DIR_SKILLS}}/brainstorm.md) | a new feature or project with no design yet, or whose goal, scope, or success criteria need pinning down first |
 | [plan]({{DIR_SKILLS}}/plan.md) | a task has more than a couple of steps |
-| [codebase-design]({{DIR_SKILLS}}/codebase-design.md) | designing a module's interface, placing a seam, or needing the deep-module vocabulary |
-| [domain-modeling]({{DIR_SKILLS}}/domain-modeling.md) | pinning domain terminology in CONTEXT.md or recording an architectural decision as an ADR |
+| [codebase-design]({{DIR_SKILLS}}/codebase-design.md) | designing a module's interface, placing a seam, or needing the deep-module vocabulary; pinning domain terms in GLOSSARY.md or recording a hard-to-reverse decision as an ADR |
 | [wayfinder]({{DIR_SKILLS}}/wayfinder.md) | a chunk of work too big for one session, still in the fog — chart decision tickets before building |
-| [tickets]({{DIR_SKILLS}}/tickets.md) | splitting a spec into tracker-ready tracer-bullet tickets with blocking edges |
 | [parallel-agents]({{DIR_SKILLS}}/parallel-agents.md) | several independent subtasks and a tool that runs subagents |
 | [develop]({{DIR_SKILLS}}/develop.md) | implementing a feature, fixing a bug, or changing behaviour — failing test first, affected suite green, one committed slice at a time |
 | [worktree]({{DIR_SKILLS}}/worktree.md) | work must not share a tree with what is in flight — a crew, a second task, another session in this checkout |
-| [debug]({{DIR_SKILLS}}/debug.md) | a bug or failure to diagnose before fixing |
+| [debug]({{DIR_SKILLS}}/debug.md) | a bug or failure to diagnose before fixing — a red CI run or pre-merge check included, reproduced under CI's conditions |
 | [prototype]({{DIR_SKILLS}}/prototype.md) | a design question needs a runnable answer before real implementation |
-| [repo-map]({{DIR_SKILLS}}/repo-map.md) | orienting to the repo, or structure changed |
-| [document-project]({{DIR_SKILLS}}/document-project.md) | missing/drifted docs, or a PRD, design system, architecture doc or AGENTS.md |
+| [document-project]({{DIR_SKILLS}}/document-project.md) | missing/drifted docs, or a PRD, design system, architecture doc or AGENTS.md; orienting to the repo, or refreshing its map after the structure changed |
 | [ingest]({{DIR_SKILLS}}/ingest.md) | a task needs content from a PDF, Office doc, or URL |
 | [research]({{DIR_SKILLS}}/research.md) | a question needs answers gathered and verified from the open web |
 | [teach]({{DIR_SKILLS}}/teach.md) | the user wants to be taught — a crash course, confusing material decoded, or a day-by-day path to a deadline |
@@ -247,35 +244,29 @@ the ten council seats are convened by the [council {{SKILL}}]({{DIR_SKILLS}}/cou
 | [review-response]({{DIR_SKILLS}}/review-response.md) | acting on review feedback you have received |
 | [fresh-eyes]({{DIR_SKILLS}}/fresh-eyes.md) | a finished artifact needs an independent verdict on whether it meets the original spec, from an agent with none of the solving session's context |
 | [security-audit]({{DIR_SKILLS}}/security-audit.md) | a change touches the security surface — auth, untrusted input, secrets, shell or file access, a new dependency — or "is this safe" |
-| [ci-fix]({{DIR_SKILLS}}/ci-fix.md) | a CI run or pre-merge check is red — reproduce under CI's conditions, fix at the cause, watch the re-run |
-| [deps-audit]({{DIR_SKILLS}}/deps-audit.md) | deciding which dependencies to upgrade, remove, or refuse — outdated, vulnerable, abandoned, unused |
+| [dependencies]({{DIR_SKILLS}}/dependencies.md) | auditing dependencies — outdated, vulnerable, abandoned, unused — or upgrading a dependency, framework, or language version one change at a time |
 | [ship]({{DIR_SKILLS}}/ship.md) | a verified change is ready to open as a PR or merge |
 | [release]({{DIR_SKILLS}}/release.md) | cutting a version: bump, changelog, tag |
-| [migrate]({{DIR_SKILLS}}/migrate.md) | upgrading a dependency, framework, or language version |
-| [git-archaeology]({{DIR_SKILLS}}/git-archaeology.md) | finding when a regression landed or why code exists — bisect, blame, pickaxe |
-| [git-rescue]({{DIR_SKILLS}}/git-rescue.md) | recovering a broken or messy repo, or safely rewriting history — reflog, undo, rebase behind a backup |
+| [git-history]({{DIR_SKILLS}}/git-history.md) | finding when a regression landed or why code exists — bisect, blame, pickaxe — or recovering a broken repo and safely rewriting history behind a backup branch |
 | [refactor]({{DIR_SKILLS}}/refactor.md) | improving code structure without changing behaviour |
 | [ponytail]({{DIR_SKILLS}}/ponytail.md) | the user wants the minimal, laziest-that-works solution — "ponytail", "be lazy", "simplest path", or a complaint about over-engineering, bloat, or needless dependencies |
 | [forge-mcp]({{DIR_SKILLS}}/forge-mcp.md) | building, extending, or hardening a Model Context Protocol (MCP) server |
-| [bruno-collection-generator]({{DIR_SKILLS}}/bruno-collection-generator.md) | creating or converting a Bruno API collection — requests, environments, docs — from routes, an OpenAPI snippet, curl commands, or an endpoint list |
-| [bruno-test-writer]({{DIR_SKILLS}}/bruno-test-writer.md) | writing or strengthening Bruno tests, assertions, scripts, and request chaining for a request or collection |
+| [bruno]({{DIR_SKILLS}}/bruno.md) | creating, converting, or testing a Bruno API collection — requests, environments, assertions, chaining — from routes, OpenAPI, curl, or an endpoint list |
 | [prose]({{DIR_SKILLS}}/prose.md) | writing prose for a human — a commit body, PR, doc, comment, memory note, or reply — that should not read like a model wrote it |
 | [frontend-design]({{DIR_SKILLS}}/frontend-design.md) | building or reshaping a UI that should carry a deliberate point of view, not a templated default |
 | [handoff]({{DIR_SKILLS}}/handoff.md) | context filling, or passing work to another agent or session |
-| [roast-me]({{DIR_SKILLS}}/roast-me.md) | you want an artifact torn apart, brutally and actionably |
+| [roast-me]({{DIR_SKILLS}}/roast-me.md) | you want your own ask, plan or idea torn apart, brutally and actionably (code goes to code review) |
 | [council]({{DIR_SKILLS}}/council.md) | a decision, change, or discussion needs debating from several points of view before committing |
 | [workflow]({{DIR_SKILLS}}/workflow.md) | deterministic, code-driven orchestration of subagents (fan-out, find→verify, phased handoff) and the host exposes a workflow tool |
 | [pipeline]({{DIR_SKILLS}}/pipeline.md) | foreman mode triages a substantial task, or the user asks to run a crew (analyst → developer → tester) on one, isolated in its own worktree and merged on mechanical proof |
 | [loop]({{DIR_SKILLS}}/loop.md) | the user asks to run a loop |
 | [brick-forge]({{DIR_SKILLS}}/brick-forge.md) | a new or adapted loop brick |
-| [wiki]({{DIR_SKILLS}}/wiki.md) | consulting or growing the user's machine-wide knowledge base declared in `wiki.jsonc` (§8) |
+| [wiki]({{DIR_SKILLS}}/wiki.md) | consulting or growing the user's machine-wide knowledge base declared in `geneseed-wiki.jsonc` (§8) |
 | [herdr]({{DIR_SKILLS}}/herdr.md) | running inside a [herdr](https://herdr.dev) pane (`HERDR_ENV=1`) and a task needs another pane — a sibling server, a watched build, a spawned agent |
-| [rule]({{DIR_SKILLS}}/rule.md) | anything the user wants to outlive this session — a standing rule of their own (§1) or a durable fact to remember (§5); also a recurring {{MEMORY}} lesson due for promotion |
+| [rule]({{DIR_SKILLS}}/rule.md) | anything the user wants to outlive this session — a standing rule of their own (§1) or a durable fact to remember (§5); also tending the {{MEMORY}} set — duplicates, stale facts, a recurring lesson due for promotion |
 | [profile]({{DIR_SKILLS}}/profile.md) | the user wants the agent to know who they are — creating or refreshing the `PROFILE.md` identity file (§1) through a short interview |
-| [consolidate-memory]({{DIR_SKILLS}}/consolidate-memory.md) | the {{MEMORY}} set needs tending — an overgrown index, duplicates, stale facts, a lesson due for promotion |
 | [skill-forge]({{DIR_SKILLS}}/skill-forge.md) | a repeated task has no {{SKILL}}, a self-improvement loop produced an edit, or two {{SKILLS}} should merge |
-| [geneseed]({{DIR_SKILLS}}/geneseed.md) | the user mentions Geneseed, the harness, or `AGENT.md`, or you need to inspect or read from the deployed bundle ({{LAWS}}, {{AGENTS}}, {{SKILLS}}, {{MEMORY}}) |
-| [opencode-theme]({{DIR_SKILLS}}/opencode-theme.md) | the user wants their own OpenCode colour theme — pick or tweak a palette, get solid + transparent variants that survive rebuilds |
+| [geneseed]({{DIR_SKILLS}}/geneseed.md) | the user mentions Geneseed, the harness, or `AGENT.md`, wants their own OpenCode colour theme, or you need to inspect or read from the deployed bundle ({{LAWS}}, {{AGENTS}}, {{SKILLS}}, {{MEMORY}}) |
 
 **Folder {{SKILLS}}.** Some {{SKILLS}} ship as self-contained folders under
 `{{DIR_SKILLS}}/`, each with its own format and provenance (`VENDOR.md`) —
@@ -283,7 +274,7 @@ third-party vendors plus first-party ones bundling scripts. Reach for one only w
 its domain comes up:
 - [react-view-transitions]({{DIR_SKILLS}}/react-view-transitions/SKILL.md) — animating
   React UIs with the View Transition API (`<ViewTransition>`, shared elements, Next.js).
-- [daydream]({{DIR_SKILLS}}/daydream/SKILL.md) — mining the `wiki.jsonc` vault (§8) for
+- [daydream]({{DIR_SKILLS}}/daydream/SKILL.md) — mining the `geneseed-wiki.jsonc` vault (§8) for
   non-obvious connections between notes via parallel synthesis + critique.
 - [token-report]({{DIR_SKILLS}}/token-report/SKILL.md) — session token usage breakdown
   tables: context baseline, growth, per-tool attribution.
@@ -416,7 +407,7 @@ It receives only the task's deliverables; your working files go in the {{NOTEBOO
 *{{EPI_WIKI}}*
 
 <!-- LEAN:begin -->
-{{INTRO_WIKI}} It is declared in `{{AT_HARNESS}}wiki.jsonc`, a session file — or
+{{INTRO_WIKI}} It is declared in `{{AT_HARNESS}}geneseed-wiki.jsonc`, a session file — or
 wherever `$GENESEED_WIKI` points. An empty `wikis` list means none is declared and this
 section stays dormant. (On OpenCode its `eager` entries are loaded for you.)
 
@@ -443,7 +434,7 @@ durable fact worth sharing across projects goes here via the
 [wiki]({{DIR_SKILLS}}/wiki.md) {{SKILL}}; one that matters only to you stays in
 {{MEMORY}} (§5).
 <!-- LEAN:else -->
-{{INTRO_WIKI}} Declared in `{{AT_HARNESS}}wiki.jsonc`, a session file (or at
+{{INTRO_WIKI}} Declared in `{{AT_HARNESS}}geneseed-wiki.jsonc`, a session file (or at
 `$GENESEED_WIKI`; an empty `wikis` list means dormant) — honour each wiki: load `entries` by `load` mode as in `context.json` (§9), read
 `conventions` before your first write there, drop an unplaceable note in `inbox`,
 never write inside `protected`. It is the user's: wikilinks over bare paths, every
@@ -473,6 +464,9 @@ start**, above); where it did not, act on each entry by its `load` mode yourself
 
 Each `path` may be absolute or relative to the repository root. The file's own
 comment carries its schema and setup notes.
+
+**Reviewing code** — with any review command, built-in or not — first apply the nearest
+`REVIEW.md` above each changed file. It overrides the review defaults, never a {{LAW}}.
 <!-- LEAN:else -->
 **Load `context.json` before your first reply — not deferrable.** The repo's own
 (`context.json` or `.harness/context.json` at its root), else `{{AT_HARNESS}}context.json`,
@@ -480,7 +474,8 @@ is how the project hands you its own knowledge; the hook injects its `eager` ent
 (**Session start**). `"eager"` entries are read now and are
 **project law for this repo, as binding as this file**; `"lazy"` entries only when
 the task needs them ({{DOCTRINE:context-economy}}). Schema and setup notes are in the file's
-own comment.
+own comment. Reviewing code (any review command): first apply the nearest `REVIEW.md`
+above each changed file — it overrides review defaults, never a {{LAW}}.
 <!-- LEAN:end -->
 
 ---

package/src/agents/docs.md

@@ -26,7 +26,7 @@
 3. Keep examples runnable; update any example that the change broke.
 4. Write each page in the format it is already in — Markdown or AsciiDoc; never convert one.
    A new page follows the `Docs format:` line in the root `AGENTS.md`, else the format the
-   project's docs already use (only AsciiDoc when it has none yet). Agent-runtime files —
+   project's docs already use (Markdown when it has none yet; AsciiDoc only on request). Agent-runtime files —
    `AGENTS.md`, `CLAUDE.md`, specs, ADRs loops read — stay Markdown. In AsciiDoc, never add
    an `include::` to a page agents read.
 

package/src/agents/researcher.md

@@ -8,7 +8,7 @@
   findings, not the pages ({{DOCTRINE:context-economy}}).
 - The research {{SKILL}} is running and the host can run subagents: this seat
   does the fetching and cross-checking so the main context stays small.
-- A migrate, forge-mcp, or ingest run needs a spec or changelog read before
+- A dependencies, forge-mcp, or ingest run needs a spec or changelog read before
   deciding.
 
 ## When NOT to dispatch

package/src/agents/reviewer.md

@@ -21,6 +21,9 @@
 ## Procedure
 0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
 1. Confirm the change actually does what the task required (read the spec/issue).
+   Then read, for each changed file, the nearest `REVIEW.md` above it — a deeper one
+   overrides a shallower one, and they override this procedure and the output contract,
+   never a {{LAW}}.
 2. Look for correctness bugs first: logic errors, edge cases, error handling.
 3. Then quality: duplication, unclear naming, dead code, oversized units.
 4. Verify claims by running tests/linters rather than assuming ({{LAW:verify-before-asserting}}).

package/src/bricks/bruno-test.md

@@ -2,10 +2,10 @@
 name: bruno-test
 description: Write or update Bruno requests for the endpoints this iteration touched.
 effect: mutate
-skill: bruno-test-writer
+skill: bruno
 outcomes: pass, fail
 ---
-Follow the bruno-test-writer skill for every endpoint this iteration's diff added or changed.
+Follow the bruno skill for every endpoint this iteration's diff added or changed.
 Touch only the Bruno collection — new or updated `.bru` requests and their expectations — never
 the application code.
 

package/src/bricks/ci-fix.md

@@ -2,11 +2,11 @@
 name: ci-fix
 description: Fix the failing CI check named in the card.
 effect: mutate
-skill: ci-fix
+skill: debug
 outcomes: pass, fail
 ---
-Follow the ci-fix skill against the failing check the card names — read its actual log, not a
-guess from the check's title, before changing anything.
+Follow the debug skill's CI branch against the failing check the card names — read its actual
+log, not a guess from the check's title, before changing anything.
 
 Touch only what that failure requires; this is a repair, not a chance to improve the pipeline
 along the way.