kyro-ai 3.2.2 → 3.3.0

package/fixtures/artifact-integrity/active-sprint-missing/.agents/kyro/scopes/demo/index.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "roadmapSummary": "Demo roadmap",
+  "activeSprintSummary": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json",
+  "openDebtCount": 1,
+  "nextTask": "T1.2",
+  "relevantArtifactPaths": {
+    "roadmap": ".agents/kyro/scopes/demo/ROADMAP.md",
+    "roadmapSummary": ".agents/kyro/scopes/demo/ROADMAP.summary.json",
+    "sprints": ".agents/kyro/scopes/demo/phases",
+    "reentry": ".agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md"
+  },
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/active-sprint-missing/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.md

@@ -0,0 +1,8 @@
+# Sprint 1 Demo
+
+- [x] T1.1 Completed task
+- [ ] T1.2 Pending task
+
+## Debt
+| ID | Item | Status | Priority |
+| D1 | Demo debt | open | critical |

package/fixtures/artifact-integrity/active-sprint-missing/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "sprint": "SPRINT-001-demo",
+  "status": "active",
+  "completedTasks": 1,
+  "blockedTasks": 0,
+  "carryOverTasks": 0,
+  "nextRecommendedAction": "execute_task",
+  "nextTask": "T1.2",
+  "openDecisions": [],
+  "filesTouched": [],
+  "debtDeltas": [],
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/active-sprint-missing/.agents/kyro/scopes/demo/state.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "active",
+  "activeSprint": "SPRINT-999-missing",
+  "currentPhase": "sprint",
+  "nextAction": "execute_task",
+  "roadmapPath": ".agents/kyro/scopes/demo/ROADMAP.md",
+  "sprintsPath": ".agents/kyro/scopes/demo/phases",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/invalid-state/.agents/kyro/kyro.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "artifactRoot": ".agents/kyro/scopes",
+  "scopes": [
+    "demo"
+  ],
+  "activeScope": "demo",
+  "runtimeVersion": "3.2.3",
+  "runtimePath": "~/.agents/kyro/current",
+  "installedAdapters": []
+}

package/fixtures/artifact-integrity/invalid-state/.agents/kyro/scopes/demo/DEBT.summary.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "open": 1,
+  "inProgress": 0,
+  "resolved": 0,
+  "deferred": 0,
+  "critical": 1,
+  "oldestOpenItem": "| D1 | Demo debt | open | critical |",
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/invalid-state/.agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md

@@ -0,0 +1 @@
+# Re-entry

package/fixtures/artifact-integrity/invalid-state/.agents/kyro/scopes/demo/ROADMAP.md

@@ -0,0 +1,4 @@
+# Demo roadmap
+
+## Sprint 1
+- Focus: demo

package/fixtures/artifact-integrity/invalid-state/.agents/kyro/scopes/demo/ROADMAP.summary.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "planned",
+  "summary": "Demo roadmap",
+  "plannedSprintCount": 1,
+  "completedSprintCount": 0,
+  "adaptationCount": 0,
+  "nextRecommendedAction": "execute_task",
+  "openDecisions": [],
+  "relevantArtifactPaths": [
+    ".agents/kyro/scopes/demo/ROADMAP.md"
+  ],
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/invalid-state/.agents/kyro/scopes/demo/index.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "roadmapSummary": "Demo roadmap",
+  "activeSprintSummary": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json",
+  "openDebtCount": 1,
+  "nextTask": "T1.2",
+  "relevantArtifactPaths": {
+    "roadmap": ".agents/kyro/scopes/demo/ROADMAP.md",
+    "roadmapSummary": ".agents/kyro/scopes/demo/ROADMAP.summary.json",
+    "sprints": ".agents/kyro/scopes/demo/phases",
+    "reentry": ".agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md"
+  },
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/invalid-state/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.md

@@ -0,0 +1,8 @@
+# Sprint 1 Demo
+
+- [x] T1.1 Completed task
+- [ ] T1.2 Pending task
+
+## Debt
+| ID | Item | Status | Priority |
+| D1 | Demo debt | open | critical |

package/fixtures/artifact-integrity/invalid-state/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "sprint": "SPRINT-001-demo",
+  "status": "active",
+  "completedTasks": 1,
+  "blockedTasks": 0,
+  "carryOverTasks": 0,
+  "nextRecommendedAction": "execute_task",
+  "nextTask": "T1.2",
+  "openDecisions": [],
+  "filesTouched": [],
+  "debtDeltas": [],
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/invalid-state/.agents/kyro/scopes/demo/state.json

@@ -0,0 +1,10 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "active",
+  "currentPhase": "sprint",
+  "nextAction": "execute_task",
+  "roadmapPath": ".agents/kyro/scopes/demo/ROADMAP.md",
+  "sprintsPath": ".agents/kyro/scopes/demo/phases",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/missing-summary/.agents/kyro/kyro.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "artifactRoot": ".agents/kyro/scopes",
+  "scopes": [
+    "demo"
+  ],
+  "activeScope": "demo",
+  "runtimeVersion": "3.2.3",
+  "runtimePath": "~/.agents/kyro/current",
+  "installedAdapters": []
+}

package/fixtures/artifact-integrity/missing-summary/.agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md

@@ -0,0 +1 @@
+# Re-entry

package/fixtures/artifact-integrity/missing-summary/.agents/kyro/scopes/demo/ROADMAP.md

@@ -0,0 +1,4 @@
+# Demo roadmap
+
+## Sprint 1
+- Focus: demo

package/fixtures/artifact-integrity/missing-summary/.agents/kyro/scopes/demo/index.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "roadmapSummary": "Demo roadmap",
+  "activeSprintSummary": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json",
+  "openDebtCount": 1,
+  "nextTask": "T1.2",
+  "relevantArtifactPaths": {
+    "roadmap": ".agents/kyro/scopes/demo/ROADMAP.md",
+    "roadmapSummary": ".agents/kyro/scopes/demo/ROADMAP.summary.json",
+    "sprints": ".agents/kyro/scopes/demo/phases",
+    "reentry": ".agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md"
+  },
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/missing-summary/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.md

@@ -0,0 +1,8 @@
+# Sprint 1 Demo
+
+- [x] T1.1 Completed task
+- [ ] T1.2 Pending task
+
+## Debt
+| ID | Item | Status | Priority |
+| D1 | Demo debt | open | critical |

package/fixtures/artifact-integrity/missing-summary/.agents/kyro/scopes/demo/state.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "active",
+  "activeSprint": "SPRINT-001-demo",
+  "currentPhase": "sprint",
+  "nextAction": "execute_task",
+  "roadmapPath": ".agents/kyro/scopes/demo/ROADMAP.md",
+  "sprintsPath": ".agents/kyro/scopes/demo/phases",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/kyro.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "artifactRoot": ".agents/kyro/scopes",
+  "scopes": [
+    "demo"
+  ],
+  "activeScope": "demo",
+  "runtimeVersion": "3.2.3",
+  "runtimePath": "~/.agents/kyro/current",
+  "installedAdapters": []
+}

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/DEBT.summary.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "open": 1,
+  "inProgress": 0,
+  "resolved": 0,
+  "deferred": 0,
+  "critical": 1,
+  "oldestOpenItem": "| D1 | Demo debt | open | critical |",
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md

@@ -0,0 +1 @@
+# Re-entry

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/ROADMAP.md

@@ -0,0 +1,4 @@
+# Demo roadmap
+
+## Sprint 1
+- Focus: demo

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/ROADMAP.summary.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "planned",
+  "summary": "Demo roadmap",
+  "plannedSprintCount": 1,
+  "completedSprintCount": 0,
+  "adaptationCount": 0,
+  "nextRecommendedAction": "execute_task",
+  "openDecisions": [],
+  "relevantArtifactPaths": [
+    ".agents/kyro/scopes/demo/ROADMAP.md"
+  ],
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/index.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "roadmapSummary": "Demo roadmap",
+  "activeSprintSummary": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json",
+  "openDebtCount": 1,
+  "nextTask": "T1.2",
+  "relevantArtifactPaths": {
+    "roadmap": ".agents/kyro/scopes/demo/ROADMAP.md",
+    "roadmapSummary": ".agents/kyro/scopes/demo/ROADMAP.summary.json",
+    "sprints": ".agents/kyro/scopes/demo/phases",
+    "reentry": ".agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md"
+  },
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.md

@@ -0,0 +1,8 @@
+# Sprint 1 Demo
+
+- [x] T1.1 Completed task
+- [ ] T1.2 Pending task
+
+## Debt
+| ID | Item | Status | Priority |
+| D1 | Demo debt | open | critical |

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "sprint": "SPRINT-001-demo",
+  "status": "active",
+  "completedTasks": 1,
+  "blockedTasks": 0,
+  "carryOverTasks": 0,
+  "nextRecommendedAction": "execute_task",
+  "nextTask": "T1.2",
+  "openDecisions": [],
+  "filesTouched": [],
+  "debtDeltas": [],
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/state.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "active",
+  "activeSprint": "SPRINT-001-demo",
+  "currentPhase": "sprint",
+  "nextAction": "execute_task",
+  "roadmapPath": ".agents/kyro/scopes/demo/ROADMAP.md",
+  "sprintsPath": ".agents/kyro/scopes/demo/phases",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/kyro.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "artifactRoot": ".agents/kyro/scopes",
+  "scopes": [
+    "demo"
+  ],
+  "activeScope": "demo",
+  "runtimeVersion": "3.2.3",
+  "runtimePath": "~/.agents/kyro/current",
+  "installedAdapters": []
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/DEBT.summary.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "open": 1,
+  "inProgress": 0,
+  "resolved": 0,
+  "deferred": 0,
+  "critical": 1,
+  "oldestOpenItem": "| D1 | Demo debt | open | critical |",
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md

@@ -0,0 +1 @@
+# Re-entry

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/ROADMAP.md

@@ -0,0 +1,4 @@
+# Demo roadmap
+
+## Sprint 1
+- Focus: demo

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/ROADMAP.summary.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "planned",
+  "summary": "Demo roadmap",
+  "plannedSprintCount": 1,
+  "completedSprintCount": 0,
+  "adaptationCount": 0,
+  "nextRecommendedAction": "execute_task",
+  "openDecisions": [],
+  "relevantArtifactPaths": [
+    ".agents/kyro/scopes/demo/ROADMAP.md"
+  ],
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/index.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "roadmapSummary": "Demo roadmap",
+  "activeSprintSummary": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json",
+  "openDebtCount": 1,
+  "nextTask": "T1.2",
+  "relevantArtifactPaths": {
+    "roadmap": ".agents/kyro/scopes/demo/ROADMAP.md",
+    "roadmapSummary": ".agents/kyro/scopes/demo/ROADMAP.summary.json",
+    "sprints": ".agents/kyro/scopes/demo/phases",
+    "reentry": ".agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md"
+  },
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.md

@@ -0,0 +1,8 @@
+# Sprint 1 Demo
+
+- [x] T1.1 Completed task
+- [ ] T1.2 Pending task
+
+## Debt
+| ID | Item | Status | Priority |
+| D1 | Demo debt | open | critical |

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "sprint": "SPRINT-001-demo",
+  "status": "active",
+  "completedTasks": 1,
+  "blockedTasks": 0,
+  "carryOverTasks": 0,
+  "nextRecommendedAction": "execute_task",
+  "nextTask": "T1.2",
+  "openDecisions": [],
+  "filesTouched": [],
+  "debtDeltas": [],
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/state.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "active",
+  "activeSprint": "SPRINT-001-demo",
+  "currentPhase": "sprint",
+  "nextAction": "execute_task",
+  "roadmapPath": ".agents/kyro/scopes/demo/ROADMAP.md",
+  "sprintsPath": ".agents/kyro/scopes/demo/phases",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kyro-ai",
-  "version": "3.2.2",
+  "version": "3.3.0",
   "description": "Portable sprint workflow kit for AI coding agents, with markdown artifacts, adapter guides, and formal debt tracking",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,7 +12,10 @@
     "check:versions": "node scripts/check-versions.mjs",
     "check": "npm run typecheck && npm run check:versions && npm run check:links",
     "prepublishOnly": "npm run build",
-    "build:chmod": "node scripts/make-cli-executable.mjs"
+    "build:chmod": "node scripts/make-cli-executable.mjs",
+    "check:tokens": "node dist/cli.js doctor --tokens",
+    "check:artifacts": "node dist/cli.js doctor --artifacts",
+    "check:artifact-fixtures": "node scripts/check-artifact-fixtures.mjs"
   },
   "keywords": [
     "ai-agents",
@@ -61,6 +64,7 @@
     "agents",
     "skills",
     "scripts",
+    "fixtures",
     "docs",
     "rules",
     "contexts",

package/scripts/check-artifact-fixtures.mjs

@@ -0,0 +1,56 @@
+import { cpSync, mkdtempSync, rmSync, utimesSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { spawnSync } from 'node:child_process';
+
+const repo = resolve(new URL('..', import.meta.url).pathname);
+const cli = join(repo, 'dist/cli.js');
+const fixtures = join(repo, 'fixtures/artifact-integrity');
+
+function run(cwd, args) {
+  return spawnSync(process.execPath, [cli, ...args], {
+    cwd,
+    env: { ...process.env, HOME: join(cwd, '.home') },
+    encoding: 'utf-8',
+  });
+}
+
+function assert(condition, message) {
+  if (!condition) throw new Error(message);
+}
+
+function assertDoctor(name, expectedStatus, expectedText) {
+  const result = run(join(fixtures, name), ['doctor', '--artifacts', '--kyro-scope', 'demo']);
+  const output = `${result.stdout}\n${result.stderr}`;
+  assert(result.status === expectedStatus, `${name}: expected exit ${expectedStatus}, got ${result.status}\n${output}`);
+  assert(output.includes(expectedText), `${name}: expected output to include ${expectedText}\n${output}`);
+}
+
+assertDoctor('valid', 0, '[PASS] artifact state.json');
+assertDoctor('missing-summary', 0, '[WARN] artifact ROADMAP.summary.json');
+assertDoctor('invalid-state', 1, '[FAIL] artifact state.json');
+assertDoctor('active-sprint-missing', 1, 'activeSprint not found');
+
+const staleDir = mkdtempSync(join(tmpdir(), 'kyro-stale-'));
+cpSync(join(fixtures, 'stale-summary'), staleDir, { recursive: true });
+const roadmap = join(staleDir, '.agents/kyro/scopes/demo/ROADMAP.md');
+const future = new Date(Date.now() + 5000);
+utimesSync(roadmap, future, future);
+const stale = run(staleDir, ['doctor', '--artifacts', '--kyro-scope', 'demo']);
+const staleOutput = `${stale.stdout}\n${stale.stderr}`;
+assert(stale.status === 0, `stale-summary: expected exit 0\n${staleOutput}`);
+assert(staleOutput.includes('older than ROADMAP.md'), `stale-summary: expected stale warning\n${staleOutput}`);
+rmSync(staleDir, { recursive: true, force: true });
+
+const repairDir = mkdtempSync(join(tmpdir(), 'kyro-repair-'));
+cpSync(join(fixtures, 'missing-summary'), repairDir, { recursive: true });
+const repair = run(repairDir, ['repair', '--kyro-scope', 'demo', '--yes']);
+const repairOutput = `${repair.stdout}\n${repair.stderr}`;
+assert(repair.status === 0, `repair: expected exit 0\n${repairOutput}`);
+const repaired = run(repairDir, ['doctor', '--artifacts', '--kyro-scope', 'demo']);
+const repairedOutput = `${repaired.stdout}\n${repaired.stderr}`;
+assert(repaired.status === 0, `repaired doctor: expected exit 0\n${repairedOutput}`);
+assert(!repairedOutput.includes('missing'), `repaired doctor: expected missing warnings to be gone\n${repairedOutput}`);
+rmSync(repairDir, { recursive: true, force: true });
+
+console.log('Artifact integrity fixtures passed');

package/skills/sprint-forge/SKILL.md

@@ -149,9 +149,9 @@ After detecting the mode, read ONLY the assets listed for that mode. Do NOT read
 
 | Mode | Read These Assets | Do NOT Read |
 |------|-------------------|-------------|
-| **INIT** | `INIT.md`, `analysis-guide.md`, `reentry-generator.md` | SPRINT.md, STATUS.md, sprint-generator.md, debt-tracker.md |
+| **INIT** | `INIT.md`, then one routed `helpers/analysis/{workType}.md` helper | SPRINT.md, STATUS.md, sprint-generator.md, debt-tracker.md, unrelated analysis helpers |
 | **SPRINT** | `SPRINT.md`, then exactly one routed mode: `plan-sprint.md`, `execute-task.md`, `review-task.md`, `close-sprint.md`, or `recover.md` | INIT.md, STATUS.md, unrelated modes/helpers/templates |
-| **STATUS** | `STATUS.md`, `debt-tracker.md` | INIT.md, SPRINT.md, analysis-guide.md, sprint-generator.md, reentry-generator.md, all templates |
+| **STATUS** | `STATUS.md`, `debt-tracker.md` | INIT.md, SPRINT.md, analysis helpers, sprint-generator.md, reentry-generator.md, all templates |
 
 **On-demand assets**: Templates are loaded as each workflow step references them, not upfront.
 

package/skills/sprint-forge/assets/README.md

@@ -6,7 +6,7 @@ Kyro assets are designed for progressive disclosure: load the router first, then
 
 | File | Description |
 |------|-------------|
-| [INIT.md](modes/INIT.md) | Analysis, roadmap, scoped state, summaries, and scaffolding |
+| [INIT.md](modes/INIT.md) | Lean analysis, justified sprint sizing, roadmap, scoped state, and summaries |
 | [SPRINT.md](modes/SPRINT.md) | Lightweight sprint router |
 | [plan-sprint.md](modes/plan-sprint.md) | Generate the next sprint |
 | [execute-task.md](modes/execute-task.md) | Execute active sprint tasks |
@@ -19,7 +19,12 @@ Kyro assets are designed for progressive disclosure: load the router first, then
 
 | File | Description |
 |------|-------------|
-| [analysis-guide.md](helpers/analysis-guide.md) | Analysis strategy per work type |
+| [analysis/feature.md](helpers/analysis/feature.md) | Feature analysis and sizing signals |
+| [analysis/bugfix.md](helpers/analysis/bugfix.md) | Bugfix analysis and sizing signals |
+| [analysis/audit.md](helpers/analysis/audit.md) | Audit analysis and sizing signals |
+| [analysis/refactor.md](helpers/analysis/refactor.md) | Refactor analysis and sizing signals |
+| [analysis/new-project.md](helpers/analysis/new-project.md) | New project analysis and sizing signals |
+| [analysis/tech-debt.md](helpers/analysis/tech-debt.md) | Tech debt analysis and sizing signals |
 | [sprint-generator.md](helpers/sprint-generator.md) | Sprint generation algorithm |
 | [debt-tracker.md](helpers/debt-tracker.md) | Accumulated debt rules |
 | [reentry-generator.md](helpers/reentry-generator.md) | Re-entry prompt updates |
@@ -30,12 +35,18 @@ Kyro assets are designed for progressive disclosure: load the router first, then
 
 | File | Description |
 |------|-------------|
-| [ROADMAP.md](templates/ROADMAP.md) | Human roadmap evidence |
+| [ROADMAP.md](templates/ROADMAP.md) | Human roadmap evidence with sizingDecision |
 | [SPRINT.md](templates/SPRINT.md) | Human sprint evidence |
 | [PROJECT-README.md](templates/PROJECT-README.md) | Scope README |
-| [REENTRY-PROMPTS.md](templates/REENTRY-PROMPTS.md) | Human handoff prompts |
+| [REENTRY-PROMPTS.md](templates/REENTRY-PROMPTS.md) | Summary-first recovery prompts |
 | [state.json](templates/state.json) | Scoped routing state |
 | [index.json](templates/index.json) | Fast agent routing index |
 | [ROADMAP.summary.json](templates/ROADMAP.summary.json) | Roadmap summary cache |
 | [SPRINT.summary.json](templates/SPRINT.summary.json) | Sprint summary cache |
 | [DEBT.summary.json](templates/DEBT.summary.json) | Debt summary cache |
+
+## fixtures/
+
+| File | Description |
+|------|-------------|
+| [subcommands-and-reports.sizingDecision.json](fixtures/subcommands-and-reports.sizingDecision.json) | Regression fixture proving 3 justified sprints can be valid |

package/skills/sprint-forge/assets/fixtures/subcommands-and-reports.sizingDecision.json

@@ -0,0 +1,17 @@
+{
+  "recommendedSprintCount": 3,
+  "riskLevel": "medium",
+  "rationale": "The work has a dependency chain: CLI subcommands first, metadata reading second, removal reporting third.",
+  "splitTriggers": [
+    "public CLI behavior change",
+    "shared metadata reader dependency",
+    "cleanup reporting depends on metadata reading"
+  ],
+  "whyNotFewer": "Combining all changes would mix CLI refactor, metadata parsing, formatting, and reporting behavior in one review unit.",
+  "whyNotMore": "No additional subsystem boundaries or migrations were found.",
+  "sprintProofs": [
+    "Sprint 1 proves CLI subcommand architecture without changing metadata behavior.",
+    "Sprint 2 proves metadata reading and formatting independently.",
+    "Sprint 3 proves cleanup reporting built on metadata reading."
+  ]
+}

package/skills/sprint-forge/assets/helpers/analysis/audit.md

@@ -0,0 +1,18 @@
+# Audit Analysis
+
+Use for broad quality, architecture, security, performance, or maintainability reviews.
+
+## Inspect
+
+1. Map entry points, package metadata, tests, and docs.
+2. Sample each major subsystem enough to identify real patterns.
+3. Let findings emerge from evidence; do not force a fixed checklist.
+4. Group findings by independent remediation area.
+
+## Findings
+
+Each finding needs severity, evidence, affected files, impact, and recommended remediation.
+
+## Sizing signals
+
+Audits commonly produce multiple sprints when findings affect independent subsystems or risk classes. Avoid over-splitting cosmetic issues that can be resolved together.