geneseed 4.9.3 → 4.10.0

package/js/inspect/status.mjs

@@ -58,12 +58,12 @@
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 
-import { GATE_SWITCHES, THEMES, ROOT, makeCfg } from '../build/source.mjs';
+import { GATE_SWITCHES, THEMES, ROOT, loadKits, makeCfg } from '../build/source.mjs';
 import { tuiInventory } from './inventory.mjs';
 import { readVersion, sourceFingerprint } from '../build/version.mjs';
 import {
   claudeConfigDir, bobConfigDir, openclaudeConfigDir, opencodeConfigDir, opencodeShadowedInstall,
-  isHostGlobalDir, resolvePath, resolveMemoryDir, sovereignBypass, CLAUDE_STYLE, GATE_LEDGER,
+  isHostGlobalDir, resolvePath, resolveMemoryDir, sovereignBypass, CLAUDE_STYLE, GATE_LEDGER, HOSTS,
 } from '../hosts/hosts.mjs';
 // P5f moved the install DETECTORS out of this file — `diff` renders its expected copy in the
 // deployed theme and footprint, and `rebuild-all` re-emits in the deployed everything, so
@@ -238,6 +238,40 @@ export function gateSummary(cfgDirs, platform = process.platform) {
 }
 
 /** `_harness_status._status_data`. */
+/**
+ * Spec R6: the member files of every kit NOT on in this install that are still on disk — the ones
+ * `pruneOwned` kept because their owner edited them — as `{ kit: [rel, ...] }`, or `null` when
+ * there are none. No new state: the kit manifests say which rels a member owns (`skills/<m>.md`,
+ * `skills/<m>/...`, `agents/<m>.md`), the install's layer dir says where to look.
+ */
+export function keptKitFiles(host, scope, root, active) {
+  const marker = HOSTS.find((h) => h.host === host)?.projectMarker;
+  const dir = scope === 'global' || !marker ? root : path.join(root, marker);
+  const walk = (rel) => {
+    const abs = path.join(dir, rel);
+    let entries;
+    try { entries = readdirSync(abs, { withFileTypes: true }); } catch { return []; }
+    return entries.flatMap((e) => (e.isDirectory() ? walk(`${rel}/${e.name}`)
+      : e.isFile() ? [`${rel}/${e.name}`] : []));
+  };
+  const kept = {};
+  let kits;
+  try { kits = loadKits(); } catch (e) {
+    process.stderr.write(`warning: kit rows skipped — ${e.message}\n`);
+    return null;
+  }
+  for (const [kit, m] of kits) {
+    if (active.includes(kit)) continue;
+    const rels = [
+      ...(m.skills ?? []).flatMap((n) => [`skills/${n}.md`].filter((r) => existsSync(path.join(dir, r)))
+        .concat(walk(`skills/${n}`))),
+      ...(m.agents ?? []).map((n) => `agents/${n}.md`).filter((r) => existsSync(path.join(dir, r))),
+    ].sort();
+    if (rels.length) kept[kit] = rels;
+  }
+  return Object.keys(kept).length ? kept : null;
+}
+
 export function statusData() {
   const inst = installedDefaults();
   const theme = inst.theme || defaultTheme();
@@ -304,10 +338,12 @@ export function statusData() {
     installs: installTargets().map(([host, scope, root]) => {
       try {
         const p = installProfile(host, scope, root);
+        // Only when something is kept, so `--json` without kits stays the bytes it was.
+        const kept = keptKitFiles(host, scope, root, p.kits);
         const rebuild = legacyProcessCarrierOfDir(root, host)
           ? "geneseed setup  # pre-comms carrier (names 'process 8') — run setup for this install, not a rebuild"
           : rebuildCommand(p.argv);
-        return { ...p, rebuild };
+        return { ...p, ...(kept ? { keptKitFiles: kept } : {}), rebuild };
       } catch (e) {
         return { host, scope, root, state: 'unreadable', error: String(e?.message ?? e) };
       }
@@ -422,10 +458,15 @@ export function statusLines(d, color = false) {
     const excl = p.excludeRules?.length ? `excluding ${p.excludeRules.join(',')}` : 'no rules excluded';
     rows.push([`${p.host}:${p.scope}`, [p.state, p.theme, p.footprint, `${p.posture}/${p.mode}/${p.trust}`,
       packs, excl, ...(p.excludeSkills?.length ? [`skills off: ${p.excludeSkills.join(',')}`] : []),
+      ...(p.kits?.length ? [`kits: ${p.kits.join(',')}`] : []),
       // Each elided when armed. The law's text still binds; only its tool-boundary gate is off.
       ...GATE_SWITCHES.filter((g) => p[g.key] === false)
         .map((g) => `${g.marker.toLowerCase()}: off (Law ${g.law} text still binds)`)]
       .join(` ${DOT} `) + where]);
+    // R6: a member its owner edited outlives its kit; name it, so turning the kit off is visible.
+    for (const [kit, rels] of Object.entries(p.keptKitFiles ?? {})) {
+      rows.push([`${p.host}:${p.scope}`, `kept from inactive kit ${kit}: ${rels.join(', ')}${where}`]);
+    }
   }
 
   const labelW = Math.max(...rows.map(([k]) => codePointLength(k)));

package/js/inspect/validate.mjs

@@ -34,8 +34,8 @@ export const VALIDATE_USAGE = [
   'usage: geneseed validate [-h] [--theme THEME] [--emit EMIT] [--out OUT] [--root ROOT]',
   '                         [--footprint {lean,full}] [--posture POSTURE] [--mode MODE]',
   '                         [--trust TRUST] [--doctrines DOCTRINES] [--exclude-rules RULES]',
-  '                         [--exclude-skills SKILLS] [--no-secrets-gate] [--no-done-gate]',
-  '                         [--no-deletion-gate] [-v]',
+  '                         [--exclude-skills SKILLS] [--kits KITS] [--no-secrets-gate]',
+  '                         [--no-done-gate] [--no-deletion-gate] [-v]',
   '',
   "Render and emit into a throwaway sandbox, run the doctor's checks, and write nothing real.",
   "Takes the generator's render flags (see geneseed-build --help) except --sync-themes and",
@@ -130,7 +130,7 @@ export function cmdValidate(args) {
     const opts = {
       theme: args.theme, footprint: args.footprint, posture: args.posture, mode: args.mode,
       trust: args.trust, doctrines: args.doctrines, excludeRules: args.excludeRules,
-      excludeSkills: args.excludeSkills,
+      excludeSkills: args.excludeSkills, kits: args.kits,
       ...Object.fromEntries(GATE_SWITCHES.map((g) => [g.key, args[g.arg] ? false : null])),
     };
     let scanDirs;

package/js/maintain/setup.mjs

@@ -46,7 +46,7 @@ import path from 'node:path';
 
 import { main as driverMain, resolveOut } from '../build/driver.mjs';
 import { playLine } from '../ui/anim.mjs';
-import { discoverNames, GATE_SWITCHES, PACK_ORDER } from '../build/source.mjs';
+import { discoverNames, GATE_SWITCHES, PACK_ORDER, loadKits } from '../build/source.mjs';
 import { exportImprovements } from '../inspect/diff.mjs';
 import { cmdDoctor } from '../inspect/doctor.mjs';
 import { setupBuildArgs } from '../build/generate.mjs';
@@ -227,6 +227,28 @@ function askDoctrines(deployed = null) {
     known === null || known.includes(name) ? 'yes' : 'no') === 'yes');
 }
 
+/**
+ * The Kits question (spec A5): one pick, a kit or `none`, defaulting to what the install has on
+ * (`deployed`, its `Active kits:` marker). Asked ONLY when this checkout ships a kit, so a kit-less
+ * wizard reads exactly the stdin it always did (and has no kit to carry: `kitsOfDir` drops an unshipped one).
+ * Returns the kit list, or null for none (`setupBuildArgs` omits `--kits`).
+ */
+export function askKits(deployed = null, kits = null) {
+  try { kits ??= loadKits(); } catch (e) {
+    process.stderr.write(`warning: kit question skipped — ${e.message}\n`);
+    return null;
+  }
+  const on = (deployed ?? []).filter((k) => kits.has(k));
+  if (!kits.size) return null;
+  const opts = [...kits].map(([k, m]) => [k, m.description ?? '']);
+  // shortcut: one pick per run, so several deployed kits are offered as one "keep" option; ask
+  // per kit once a second kit ships.
+  if (on.length > 1) opts.push([on.join(','), 'keep the installed kits']);
+  opts.push(['none', 'no kit']);
+  const pick = askChoice('Kits', opts, on.length ? on.join(',') : 'none');
+  return pick === 'none' ? null : pick.split(',');
+}
+
 /**
  * `_harness_setup._collect_setup_lines` — the six questions, the plan, the confirm.
  *
@@ -260,13 +282,15 @@ function targetGates(emit, out) {
   }
 }
 
-export function collectSetupLines() {
+export function collectSetupLines(kitMap = null) {
   printOut('Geneseed setup — answer a few questions; nothing is written until you confirm.\n');
   const inst = installedDefaults();
   const theme = askChoice('Theme', themeOptions(), inst.theme || defaultTheme());
   const posture = askChoice('Posture', postureOptions(), inst.posture || defaultPosture());
   const mode = askChoice('Mode', modeOptions(), inst.mode || defaultMode());
   const doctrines = askDoctrines(inst.doctrines);
+  // Kits on stay on (spec A3); `kitsOfDir` already dropped a retired one.
+  const kits = askKits(inst.kits, kitMap);
   const emit = askChoice('Install mode', EMIT_OPTIONS, inst.emit || 'opencode-global');
   const footprint = askChoice('Footprint', FOOTPRINT_OPTIONS,
     inst.footprint || 'lean');
@@ -304,13 +328,13 @@ export function collectSetupLines() {
   const gated = Object.values(gates).some((on) => on === false);
   printOut(`\nAbout to run:  geneseed build ${
     setupBuildArgs(theme, emit, out, root, footprint, posture, mode, doctrines, allPacks,
-      excludeRules, undefined, excludeSkills, gates).join(' ')}\n`);
+      excludeRules, undefined, excludeSkills, gates, kits).join(' ')}\n`);
   if (!confirm('Proceed?', true)) return null;
   // The key only when there is something to carry, so a selection that excludes no skill and
   // switches off no gate is the same object it was before either existed.
   return {
     theme, posture, mode, doctrines, excludeRules, ...(excludeSkills ? { excludeSkills } : {}),
-    ...(gated ? { gates } : {}),
+    ...(gated ? { gates } : {}), ...(kits ? { kits } : {}),
     emit, out, root, footprint,
   };
 }
@@ -494,7 +518,7 @@ export function setupLines() {
   }
   const {
     theme, emit, out, root, footprint = 'lean', posture = 'peer', mode = 'direct',
-    doctrines = null, excludeRules = null, excludeSkills = null, gates = {},
+    doctrines = null, excludeRules = null, excludeSkills = null, gates = {}, kits = null,
   } = sel;
   if (emit === 'opencode-global') {
     // The build below overwrites the deployed global harness, and the self-improvement loops
@@ -513,7 +537,7 @@ export function setupLines() {
   // runs must carry the pack selection the plan line just previewed, or the wizard would print
   // one command and run another.
   const argv = setupBuildArgs(theme, emit, out, root, footprint, posture, mode, doctrines,
-    doctrineOptions().map(([n]) => n), excludeRules, undefined, excludeSkills, gates);
+    doctrineOptions().map(([n]) => n), excludeRules, undefined, excludeSkills, gates, kits);
   printOut(`Running:  geneseed build ${argv.join(' ')}\n`);
   const rc = driverMain(argv);
   if (rc !== 0) {

package/js/maintain/update.mjs

@@ -632,7 +632,7 @@ export async function installAxes(dir, { installProfile, setupBuildArgs }, notif
   if (legacyProcessCarrierOfDir(String(dir), 'opencode')) return null;
   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, p).slice(4);
+    undefined, p.excludeRules, p.trust, p.excludeSkills, p, p.kits).slice(4);
 }
 
 /**

package/js/web/actions.mjs

@@ -34,7 +34,7 @@ import path from 'node:path';
 
 import { emitGlobalInto } from '../build/driver.mjs';
 import {
-  ROOT, discoverNames, knownRuleIds, PACK_ORDER,
+  ROOT, discoverNames, knownRuleIds, loadKits, PACK_ORDER,
 } from '../build/source.mjs';
 import { withStdoutSwallowed } from '../inspect/diff.mjs';
 import { excludeAdd, excludeRemove } from '../inspect/excludes.mjs';
@@ -46,9 +46,10 @@ import {
   opencodeConfigDir, resolvePath,
 } from '../hosts/hosts.mjs';
 import {
-  EMIT_HOST_SCOPE, doctrinesForBuild, excludedRulesOfDir, excludedSkillsOfDir,
+  EMIT_HOST_SCOPE, doctrinesForBuild, excludedRulesOfDir, excludedSkillsOfDir, kitsOfDir,
   footprintOfDir, gatesOfDir,
-  installState, installTargets, legacyProcessCarrierOfDir, modeOfDir, postureOfDir, trustOfDir,
+  installState, installTargets, legacyProcessCarrierOfDir, modeOfDir, postureOfDir, themeOfDir,
+  trustOfDir,
 } from '../hosts/installs.mjs';
 import {
   isDict, mcpCommented, mcpInstallTargets, mcpLoad, mcpServerNames, mcpState,
@@ -131,6 +132,15 @@ function bodyExcludeRules(body) {
     (n) => n.trim().replace(/[ \t]+/, '.'));
 }
 
+/**
+ * A request body's `kits` — REPLACES the install's kits (the Kits tab sends the whole set it
+ * wants): `[]`/`'none'` give `[]`, an omitted key gives `null` (keep the install's own), and an
+ * unknown name gives `null` too, which `apiInstallCmd` refuses for a body that HAS the key.
+ */
+function bodyKits(body) {
+  return bodyList(body, 'kits', () => [...loadKits().keys()]);
+}
+
 /**
  * The gate switches across the trust boundary (`deletionGate`, `secretsGate`, `doneGate`), each
  * on its own: only a real JSON boolean counts. Anything else — a string `"false"`, a number,
@@ -539,6 +549,8 @@ export function apiRestore(state, files) {
       // re-states a rule whose hook gate the install deliberately left unwired.
       excludeRules: excludedRulesOfDir(target),
       excludeSkills: excludedSkillsOfDir(target),
+      // The kits: a restored AGENT.md keeps its Kits block and `Active kits:` line.
+      kits: kitsOfDir(target),
       // The gate switches: a restored AGENT.md must keep the install's `<gate>: off` lines.
       ...gatesOfDir(target),
     }));
@@ -607,8 +619,9 @@ export function apiInstallCmd(state, body) {
   if (emit === undefined) return { error: `no install mode for ${host}:${scope}` };
   // Every read-back below is narrowed to `host`'s OWN carrier (host-compat B1) — see the
   // comment at `installProfile` in `js/build/generate.mjs`.
+  // The theme default is THIS install's own, not the viewed one's: the Kits tab acts on any row.
   const { theme, footprint: fp, posture: pos, mode, trust } = bodyAxes(body, {
-    theme: state.theme, footprint: footprintOfDir(root),
+    theme: themeOfDir(root, host) || state.theme, footprint: footprintOfDir(root),
     posture: postureOfDir(root, host) || 'peer',
     mode: modeOfDir(root, host) || 'direct', trust: trustOfDir(root, host) || DEFAULT_PRESET });
   // Unspecified means "keep what this install already has", exactly as theme, footprint,
@@ -626,9 +639,20 @@ export function apiInstallCmd(state, body) {
   // The gate switches (the Constitution page's toggles): a strict boolean per gate in the body,
   // else the install's own answer — so a pack Apply keeps every switch as it is.
   const gates = bodyGates(body, root, host);
+  // The page sends `kits` deliberately, so an unknown name is refused: ignoring it would run a
+  // no-op rebuild and report success. An omitted key keeps the install's own kits.
+  let kits = null;
+  try {
+    kits = bodyKits(body);
+    if (kits === null && bget(body, 'kits') !== null) {
+      return { error: `unknown kit in ${formatRepr(bget(body, 'kits'))} — this Geneseed ships: `
+        + [...loadKits().keys()].join(', ') };
+    }
+  } catch (e) { return { error: String(e?.message ?? e) }; }
   const out = scope === 'global' ? null : String(root);
   const argv = setupBuildArgs(theme || 'neutral', emit, out, out, fp, pos, mode, doctrines,
-    PACK_ORDER, excludeRules, trust, excludedSkillsOfDir(root, host), gates);
+    PACK_ORDER, excludeRules, trust, excludedSkillsOfDir(root, host), gates,
+    kits ?? kitsOfDir(root, host));
   return { cmd: [process.execPath, path.join(ROOT, 'bin', 'build-driver.mjs'), ...argv] };
 }
 
@@ -730,6 +754,6 @@ export function apiDeployCmd(state, body) {
   const gates = bodyGates(body, root, host);
   // project-scope emit name == host name (opencode / claude / bob / openclaude)
   const argv = setupBuildArgs(theme || 'neutral', host, root, root, fp, pos, mode, doctrines,
-    PACK_ORDER, excludeRules, trust, excludedSkillsOfDir(root, host), gates);
+    PACK_ORDER, excludeRules, trust, excludedSkillsOfDir(root, host), gates, kitsOfDir(root, host));
   return { cmd: [process.execPath, path.join(ROOT, 'bin', 'build-driver.mjs'), ...argv] };
 }

package/js/web/api.mjs

@@ -11,22 +11,24 @@
 import { statSync } from 'node:fs';
 import path from 'node:path';
 
-import { CONFIG, ROOT, THEMES, discoverNames, makeCfg } from '../build/source.mjs';
+import { CONFIG, ROOT, THEMES, discoverNames, loadKits, makeCfg } from '../build/source.mjs';
 import { readVersion, sourceFingerprint } from '../build/version.mjs';
 import { sourceReleaseVersion } from '../hosts/opencode.mjs';
 import { alwaysOnCost } from '../inspect/cost.mjs';
+import { installProfile } from '../build/generate.mjs';
 import { diffCollect, renderMemo } from '../inspect/diff.mjs';
 import { excludesSnapshot } from '../inspect/excludes.mjs';
 import { CLAUDE_STYLE, HOSTS, VERSION_MARKER, resolvePath } from '../hosts/hosts.mjs';
 import {
-  footprintOfDir, gatesOfDir, installState, installTargets, modeOfDir, trustOfDir,
+  footprintOfDir, gatesOfDir, installState, installTargets, legacyProcessCarrierOfDir, modeOfDir,
+  trustOfDir,
   postureOfDir, readJsonMaybe, themeOfDir,
 } from '../hosts/installs.mjs';
 import { PRESETS } from '../loop/score.mjs';
 import { loadCatalog, catalogProblems } from '../loop/catalog.mjs';
 import { activeLoops } from '../loop/registry.mjs';
 import { EMIT_OPTIONS, themeOptions } from '../maintain/setup.mjs';
-import { accentFor, statusData } from '../inspect/status.mjs';
+import { accentFor, keptKitFiles, statusData } from '../inspect/status.mjs';
 import { isFile } from '../lib/fs.mjs';
 import { comparePaths, normcase } from '../lib/paths.mjs';
 import {
@@ -231,6 +233,41 @@ export function apiFleet(state) {
   return { installs, source_fp: sourceFp, doctor: state.doctor };
 }
 
+/**
+ * EVERY INSTALL'S KITS — the Kits tab. Its own route, like `apiFleet`: it re-reads each carrier
+ * and the kit manifests, which the sidebar's `/api/installs` refetch must not pay for.
+ *
+ * `kits` per row is `installProfile(...).kits`, the reader `rebuild-all` uses, so the tab shows
+ * what a rebuild would keep. A malformed manifest answers 200 with `error` and EMPTY lists, never
+ * rows without kits (which would read as "no kit on") and never a 500. `editable:false` carries
+ * the two refusals `apiInstallCmd` makes, so the page can say why before the click.
+ */
+export function apiKits() {
+  let known;
+  try { known = loadKits(); } catch (e) {
+    return { kits: [], installs: [], error: String(e?.message ?? e) };
+  }
+  const kits = [...known].map(([name, m]) => ({
+    name, description: m.description ?? '', skills: m.skills ?? [], agents: m.agents ?? [] }));
+  const installs = [];
+  for (const [host, scope, root] of installTargets()) {
+    const st = installState(root, host, scope);
+    if (st === 'absent') continue;
+    try {
+      const p = installProfile(host, scope, root);
+      const reason = st === 'disabled' ? 'install is disabled — reactivate it first'
+        : legacyProcessCarrierOfDir(root, host) ? 'predates the comms pack — run geneseed setup for it first'
+          : null;
+      installs.push({ ...installRowBase(host, scope, root, st), kits: p.kits,
+        keptKitFiles: keptKitFiles(host, scope, root, p.kits), editable: reason === null, reason });
+    } catch (e) {
+      installs.push({ ...installRowBase(host, scope, root, 'unreadable'),
+        error: String(e?.message ?? e) });
+    }
+  }
+  return { kits, installs };
+}
+
 /** The dashboard aggregate. */
 export function apiOverview(state) {
   const inv = state.inventory;

package/js/web/routes.mjs

@@ -21,7 +21,7 @@ import { percentDecode } from '../lib/text.mjs';
 import { apiExcludesMutate, apiInstallToggle, apiLoopsPresetMutate, apiMcp, apiMemoryDelete, apiSelectView } from './actions.mjs';
 import { apiActivity, apiActivityDetail, apiActivityToggle } from './activity.mjs';
 import {
-  apiDiff, apiDoctor, apiExcludes, apiFleet, apiInstalls, apiLoops, apiLoopsActive, apiOverview,
+  apiDiff, apiDoctor, apiExcludes, apiFleet, apiInstalls, apiKits, apiLoops, apiLoopsActive, apiOverview,
   apiRecent, apiSetup, apiThemes, apiUpdate,
 } from './api.mjs';
 import { NotFound, apiCatalog, apiItem } from './catalog.mjs';
@@ -151,6 +151,7 @@ export const STATE_ROUTES = {
     new URL(url || '', 'http://x').searchParams.has('fresh')),
   '/api/installs': apiInstalls,
   '/api/fleet': apiFleet,
+  '/api/kits': apiKits,
   '/api/update': apiUpdate,
   '/api/usage': apiUsage,
   '/api/gates': apiGates,

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": "4.9.3",
+  "version": "4.10.0",
   "description": "A portable, theme-able harness you implant once and use everywhere to grow a disciplined AI coding agent.",
   "keywords": [
     "ai",

package/registry.json

@@ -22,6 +22,20 @@
       "added": "2026-07-13",
       "last_verified": ""
     },
+    "agents/devops-engineer": {
+      "status": "experimental",
+      "version": "1.0.0",
+      "owner": "Guillaume Lemer",
+      "added": "2026-10-20",
+      "last_verified": ""
+    },
+    "agents/docker-expert": {
+      "status": "experimental",
+      "version": "1.0.0",
+      "owner": "Guillaume Lemer",
+      "added": "2026-10-20",
+      "last_verified": ""
+    },
     "agents/docs": {
       "status": "approved",
       "version": "1.0.0",
@@ -57,6 +71,13 @@
       "added": "2026-06-08",
       "last_verified": ""
     },
+    "agents/kubernetes-specialist": {
+      "status": "experimental",
+      "version": "1.0.0",
+      "owner": "Guillaume Lemer",
+      "added": "2026-10-20",
+      "last_verified": ""
+    },
     "agents/memory-curator": {
       "status": "experimental",
       "version": "1.0.0",
@@ -113,6 +134,27 @@
       "added": "2026-06-08",
       "last_verified": ""
     },
+    "agents/spring-boot-engineer": {
+      "status": "experimental",
+      "version": "1.0.0",
+      "owner": "Guillaume Lemer",
+      "added": "2026-10-20",
+      "last_verified": ""
+    },
+    "agents/spring-reviewer": {
+      "status": "experimental",
+      "version": "1.0.0",
+      "owner": "Guillaume Lemer",
+      "added": "2026-10-20",
+      "last_verified": ""
+    },
+    "agents/spring-security": {
+      "status": "experimental",
+      "version": "1.0.0",
+      "owner": "Guillaume Lemer",
+      "added": "2026-10-20",
+      "last_verified": ""
+    },
     "agents/steward": {
       "status": "approved",
       "version": "1.0.0",
@@ -428,6 +470,27 @@
       "added": "2026-09-06",
       "last_verified": "2026-10-13"
     },
+    "skills/spring-boot": {
+      "status": "experimental",
+      "version": "1.0.0",
+      "owner": "Guillaume Lemer",
+      "added": "2026-10-20",
+      "last_verified": ""
+    },
+    "skills/spring-data-jpa": {
+      "status": "experimental",
+      "version": "1.0.0",
+      "owner": "Guillaume Lemer",
+      "added": "2026-10-20",
+      "last_verified": ""
+    },
+    "skills/spring-testing": {
+      "status": "experimental",
+      "version": "1.0.0",
+      "owner": "Guillaume Lemer",
+      "added": "2026-10-20",
+      "last_verified": ""
+    },
     "skills/teach": {
       "status": "experimental",
       "version": "1.0.0",

package/src/AGENT.md.tmpl

@@ -145,7 +145,7 @@ Inactive packs still ship under `{{DIR_DOCTRINES}}/`, so a citation into one res
 {{DOCTRINES_BODY}}
 
 Active packs: {{DOCTRINES_LIST}}{{EXCLUDED_RULES_LINE}}{{GATE_LINES}}
-
+{{KITS_BODY}}
 ---
 
 ## 3. {{AGENTS}} — delegation by capability
@@ -288,7 +288,7 @@ inventory — that list is the catalogue and it is authoritative. Each written
 procedure is in [`{{DIR_SKILLS}}/`]({{DIR_SKILLS}}/) and the host loads it on
 demand.
 <!-- CATALOG:end -->
-{{EXCLUDED_SKILLS_LINE}}
+{{EXCLUDED_SKILLS_LINE}}{{KITS_LINE}}
 When a task repeats and no {{SKILL}} covers it, forge one through the
 [skill-forge]({{DIR_SKILLS}}/skill-forge.md) {{SKILL}}: copy
 [`{{DIR_SKILLS}}/_template.md`]({{DIR_SKILLS}}/_template.md), keep it to one coherent

package/src/agents/devops-engineer.md

@@ -0,0 +1,45 @@
+# {{AGENT}}: devops-engineer
+
+> {{DESC_DEVOPS_ENGINEER}}
+
+{{CREDIT:piomin-spring-boot:agents/devops-engineer.md}}
+
+Builds CI/CD pipelines and delivery automation for Spring Boot applications.
+
+## When to dispatch
+- A Spring Boot project needs a pipeline created or fixed: build, test, image, scan, deploy stages.
+
+## When NOT to dispatch
+- Image internals — use [docker-expert](docker-expert.md). Cluster manifests — use [kubernetes-specialist](kubernetes-specialist.md).
+
+## Inputs
+- The repository, its existing CI provider and the target registry and environments.
+
+## Allowed tools
+- **Read + write to the assigned worktree.** May run the build and pipeline linters.
+  <!-- bash: allow -->
+- Never commits, pushes or triggers a deployment ({{DOCTRINE:consent-before-push}}).
+
+## Procedure
+0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
+1. Detect the CI the project already uses (GitHub Actions, GitLab CI, Jenkins, other) and extend it; do not switch providers. With none present, ask the user which to use.
+2. Pipeline order: checkout, restore build cache, `./mvnw verify` (or `./gradlew build`), publish test results, build image, scan, push, deploy.
+3. Cache the Maven or Gradle repository keyed on the build files.
+4. Gates: tests, a coverage threshold if the project has one, dependency and image vulnerability scan.
+5. Build images with the project's chosen method (`spring-boot:build-image` by default); tag with version or commit SHA, never `latest` in production.
+6. Stages dev, staging, prod, with approval before prod.
+7. Secrets come from the CI secret store or a vault, never from files in the repository.
+8. Lint the pipeline file before handing off.
+
+## Output contract
+- Files changed, the stage list and what was validated.
+
+## Self-improvement
+
+If this spec misled you — an input you needed but were not given, a boundary
+that proved wrong, a step you could not execute — end your report with one line:
+`spec-feedback: <what failed — the one-line fix>`. Omit it when there is no
+friction. The caller weighs the feedback, folds a real flaw back into this file
+with the user's assent, and records it to {{MEMORY}} only if it clears
+{{DOCTRINE:persist-insight}}'s bar — most reports carry no feedback at all.
+

package/src/agents/docker-expert.md

@@ -0,0 +1,45 @@
+# {{AGENT}}: docker-expert
+
+> {{DESC_DOCKER_EXPERT}}
+
+{{CREDIT:piomin-spring-boot:agents/docker-expert.md}}
+
+Builds small, safe container images for Spring Boot 4 applications.
+
+## When to dispatch
+- A Spring Boot service needs an image, a Dockerfile review or a Compose file for local development.
+
+## When NOT to dispatch
+- Cluster manifests — use [kubernetes-specialist](kubernetes-specialist.md). Pipelines — use [devops-engineer](devops-engineer.md).
+
+## Inputs
+- The build tool (Maven or Gradle), the Java version and any registry or base-image policy.
+
+## Allowed tools
+- **Read + write to the assigned worktree.** May run the build and local image builds.
+  <!-- bash: allow -->
+- Never pushes images or commits ({{DOCTRINE:consent-before-push}}).
+
+## Procedure
+0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
+1. Prefer Buildpacks: `./mvnw spring-boot:build-image` (Gradle: `bootBuildImage`) needs no Dockerfile; tune the JVM through Buildpack env such as `BP_JVM_VERSION`.
+2. Use a Dockerfile only when Buildpacks do not fit. Build multi-stage and extract layers with `java -Djarmode=tools -jar app.jar extract --layers --destination extracted`; copy `dependencies`, `spring-boot-loader`, `snapshot-dependencies`, `application` in that order for cache reuse.
+3. Run as a non-root user; pin base image tags or digests, never `latest`.
+4. Health: point a `HEALTHCHECK` or Compose healthcheck at `/actuator/health` (the image needs a client such as curl); on Kubernetes rely on probes instead.
+5. Add a `.dockerignore` (`.git`, `target/`, IDE files).
+6. No secrets in layers or build args; pass them at runtime.
+7. Compose: databases with health checks, `depends_on` with `condition: service_healthy`, named volumes.
+8. Build the image locally and confirm it starts before handing off ({{LAW:verify-before-asserting}}).
+
+## Output contract
+- Files changed, the build command and whether the image built and started.
+
+## Self-improvement
+
+If this spec misled you — an input you needed but were not given, a boundary
+that proved wrong, a step you could not execute — end your report with one line:
+`spec-feedback: <what failed — the one-line fix>`. Omit it when there is no
+friction. The caller weighs the feedback, folds a real flaw back into this file
+with the user's assent, and records it to {{MEMORY}} only if it clears
+{{DOCTRINE:persist-insight}}'s bar — most reports carry no feedback at all.
+

package/src/agents/kubernetes-specialist.md

@@ -0,0 +1,45 @@
+# {{AGENT}}: kubernetes-specialist
+
+> {{DESC_KUBERNETES_SPECIALIST}}
+
+{{CREDIT:piomin-spring-boot:agents/kubernetes-specialist.md}}
+
+Deploys Spring Boot 4 applications on Kubernetes.
+
+## When to dispatch
+- Manifests, Helm values or Kustomize overlays for a Spring Boot service need writing or fixing.
+
+## When NOT to dispatch
+- Image build only — use [docker-expert](docker-expert.md). Pipelines — use [devops-engineer](devops-engineer.md).
+
+## Inputs
+- The service, its ports and dependencies, and the manifest tooling the project already uses.
+
+## Allowed tools
+- **Read + write to the assigned worktree.** May run `kubectl ... --dry-run`, linters and the build.
+  <!-- bash: allow -->
+- Never applies to a live cluster and never pushes without the user's say-so ({{DOCTRINE:consent-before-push}}).
+
+## Procedure
+0. If `{{DIR_MEMORY}}/agents/<your-name>.md` exists, read it first — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}).
+1. Match the project's manifest style; do not introduce a new tool.
+2. Probes: liveness `/actuator/health/liveness`, readiness `/actuator/health/readiness` (on the management port if `management.server.port` is set); add a startup probe for slow starts. Boot exposes these health groups by default; `management.endpoint.health.probes.enabled=false` turns them off.
+3. Shutdown: `server.shutdown=graceful` with `spring.lifecycle.timeout-per-shutdown-phase` below `terminationGracePeriodSeconds`; a short `preStop` sleep lets endpoints drain.
+4. Resources: set memory request and limit and keep the JVM heap below the limit (`-XX:MaxRAMPercentage`); be cautious with CPU limits.
+5. Config: non-sensitive settings in a ConfigMap, credentials in a Secret; env vars bind through relaxed binding (`SPRING_DATASOURCE_URL`).
+6. Scale: HPA on CPU or custom metrics, a PodDisruptionBudget when replicas exceed one.
+7. Pod hardening: `runAsNonRoot`, no privilege escalation, pinned image tags.
+8. Validate with a dry run or linter before handing off.
+
+## Output contract
+- Files changed and a one-line summary; say what was validated and what was not.
+
+## Self-improvement
+
+If this spec misled you — an input you needed but were not given, a boundary
+that proved wrong, a step you could not execute — end your report with one line:
+`spec-feedback: <what failed — the one-line fix>`. Omit it when there is no
+friction. The caller weighs the feedback, folds a real flaw back into this file
+with the user's assent, and records it to {{MEMORY}} only if it clears
+{{DOCTRINE:persist-insight}}'s bar — most reports carry no feedback at all.
+

package/src/agents/reviewer.md

@@ -2,6 +2,8 @@
 
 > {{DESC_REVIEWER}}
 
+{{CREDIT:superpowers:skills/requesting-code-review/code-reviewer.md}}
+
 ## When to dispatch
 - A change is complete and about to be committed or opened as a PR.
 - The user asks for a review, second opinion, or pre-merge check.