@crouton-kit/crouter 0.3.3 → 0.3.11

package/dist/core/subagents.js

@@ -0,0 +1,163 @@
+// Subagent discovery + resolution.
+//
+// Subagents are markdown files with YAML frontmatter, modeled on the pi
+// subagent extension but surfaced through the crtr `agent` CLI. Each file
+// declares a name/description (+ optional tools/model) in frontmatter; its
+// markdown body becomes the spawned agent's appended system prompt.
+//
+// Layout mirrors skills, one level shallower (flat files, not nested dirs):
+//   <scope-root>/agents/<name>.md        — scope-root agents (user/project)
+//   <plugin-root>/agents/<name>.md       — plugin-provided agents
+//
+// Resolution precedence matches skills: project before user before builtin;
+// scope-root agents before plugin agents within a scope.
+import { join, basename } from 'node:path';
+import { readdirSync } from 'node:fs';
+import { AGENTS_DIR, SCOPE_SKILL_PLUGIN } from '../types.js';
+import { listAllPlugins, listInstalledPlugins } from './resolver.js';
+import { parseFrontmatterGeneric } from './frontmatter.js';
+import { pathExists, readText } from './fs-utils.js';
+import { projectScopeRoot, scopeRoot } from './scope.js';
+import { ambiguous, notFound } from './errors.js';
+/** `<scope-root>/agents` for a given scope, or null when the scope has no root. */
+export function scopeAgentsDir(scope) {
+    const root = scopeRoot(scope);
+    return root ? join(root, AGENTS_DIR) : null;
+}
+function coerceTools(value) {
+    if (Array.isArray(value)) {
+        const arr = value.map((v) => String(v).trim()).filter(Boolean);
+        return arr.length > 0 ? arr : undefined;
+    }
+    if (typeof value === 'string') {
+        const arr = value
+            .split(',')
+            .map((t) => t.trim())
+            .filter(Boolean);
+        return arr.length > 0 ? arr : undefined;
+    }
+    return undefined;
+}
+function parseSubagentFile(filePath, scope, plugin) {
+    let source;
+    try {
+        source = readText(filePath);
+    }
+    catch {
+        return null;
+    }
+    const { data, body } = parseFrontmatterGeneric(source);
+    if (data === null)
+        return null;
+    // Name defaults to the filename stem when frontmatter omits it. A description
+    // is required for the agent to be useful in listings; skip files without one.
+    const fileStem = basename(filePath).replace(/\.md$/i, '');
+    const name = typeof data.name === 'string' && data.name.trim() !== ''
+        ? data.name.trim()
+        : fileStem;
+    if (typeof data.description !== 'string' || data.description.trim() === '') {
+        return null;
+    }
+    const fm = {
+        name,
+        description: data.description.trim(),
+        tools: coerceTools(data.tools),
+        model: typeof data.model === 'string' && data.model.trim() !== '' ? data.model.trim() : undefined,
+    };
+    return {
+        name,
+        plugin,
+        scope,
+        path: filePath,
+        frontmatter: fm,
+        systemPrompt: body,
+    };
+}
+function listAgentsInDir(dir, scope, plugin) {
+    if (!pathExists(dir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        if (!e.name.toLowerCase().endsWith('.md'))
+            continue;
+        if (!e.isFile() && !e.isSymbolicLink())
+            continue;
+        const parsed = parseSubagentFile(join(dir, e.name), scope, plugin);
+        if (parsed !== null)
+            out.push(parsed);
+    }
+    return out;
+}
+/** Scope-root agents under `<scope-root>/agents/*.md`. */
+export function listScopeRootSubagents(scope) {
+    if (scope === 'builtin')
+        return [];
+    const dir = scopeAgentsDir(scope);
+    if (!dir)
+        return [];
+    return listAgentsInDir(dir, scope, SCOPE_SKILL_PLUGIN);
+}
+/** All subagents: scope-root agents (project, user) plus enabled plugins. */
+export function listSubagents(scopeFilter) {
+    const scopes = scopeFilter
+        ? [scopeFilter]
+        : [projectScopeRoot() ? 'project' : null, 'user'].filter(Boolean);
+    const fromScopeRoots = scopes.flatMap((s) => listScopeRootSubagents(s));
+    const plugins = scopeFilter ? listInstalledPlugins(scopeFilter) : listAllPlugins();
+    const fromPlugins = plugins
+        .filter((p) => p.enabled)
+        .flatMap((p) => listAgentsInDir(join(p.root, AGENTS_DIR), p.scope, p.name));
+    return [...fromScopeRoots, ...fromPlugins].sort((a, b) => a.name.localeCompare(b.name));
+}
+/** Canonical, unambiguous identifier: `<plugin>/<name>`, or bare `<name>` for
+ *  scope-root agents. */
+export function subagentId(a) {
+    return a.plugin === SCOPE_SKILL_PLUGIN ? a.name : `${a.plugin}/${a.name}`;
+}
+/** Resolve a subagent by name. Accepts a bare `<name>` or a `<plugin>/<name>`
+ *  qualifier. Project precedes user precedes builtin; scope-root precedes
+ *  plugin. Throws notFound / ambiguous as the skill resolver does. */
+export function resolveSubagent(rawName, opts = {}) {
+    const slash = rawName.indexOf('/');
+    const pluginQualifier = opts.plugin ?? (slash !== -1 ? rawName.slice(0, slash) : undefined);
+    const name = slash !== -1 && opts.plugin === undefined ? rawName.slice(slash + 1) : rawName;
+    const all = listSubagents(opts.scope);
+    let matches = all.filter((a) => a.name === name);
+    if (pluginQualifier !== undefined) {
+        matches = matches.filter((a) => a.plugin === pluginQualifier ||
+            (pluginQualifier === SCOPE_SKILL_PLUGIN && a.plugin === SCOPE_SKILL_PLUGIN));
+    }
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length === 0) {
+        const known = all.map(subagentId).slice(0, 8).join(', ');
+        throw notFound(`subagent not found: ${rawName}`, {
+            subagent: name,
+            plugin: pluginQualifier,
+            next: known !== ''
+                ? `Known subagents: ${known}. Run \`crtr agent subagent list\` for the full set.`
+                : 'No subagents defined. Run `crtr agent subagent author -h` to scaffold one.',
+        });
+    }
+    // Multiple matches: prefer the highest-precedence scope/source deterministically.
+    const score = (a) => {
+        const scopeScore = a.scope === 'project' ? 0 : a.scope === 'user' ? 1 : 2;
+        const sourceScore = a.plugin === SCOPE_SKILL_PLUGIN ? 0 : 1;
+        return scopeScore * 2 + sourceScore;
+    };
+    const sorted = [...matches].sort((a, b) => score(a) - score(b));
+    if (score(sorted[0]) !== score(sorted[1]))
+        return sorted[0];
+    throw ambiguous(`ambiguous subagent: ${rawName}`, {
+        subagent: name,
+        candidates: matches.map((m) => ({ id: subagentId(m), scope: m.scope, path: m.path })),
+        next: 'Qualify with `<plugin>/<name>` or pass --scope to disambiguate.',
+    });
+}

package/dist/prompts/agent.d.ts

@@ -2,9 +2,9 @@
  * First user message for a spec → plan handoff.
  *
  * Thin prompt: the worker discovers the full planning workflow by running
- * `crtr flow plan new -h`, then saves the plan via `crtr flow plan new`. This avoids
- * embedding the planPrompt() blob here and keeps the prompt in sync with the
- * live CLI without any coupling.
+ * `crtr mode plan new -h`, then saves the plan via `crtr mode plan new`. This
+ * avoids embedding the planPrompt() blob here and keeps the prompt in sync
+ * with the live CLI without any coupling.
  */
 export declare function planHandoffPrompt(specPath: string, jobId: string): string;
 /**
@@ -16,3 +16,12 @@ export declare function implementHandoffPrompt(planPath: string, jobId: string):
  * The reviewer submits via `crtr job submit` rather than `crtr agent submit`.
  */
 export declare function reviewerHandoffPrompt(artifactPath: string, artifactKind: 'plan' | 'spec', specPath: string | null, jobId: string): string;
+/**
+ * First user message for a general `agent new` worker.
+ *
+ * The worker runs as an interactive agent in a tmux pane (not print mode), so
+ * its stdout is NOT captured as the result — it must deliver its answer via
+ * `crtr job submit`, exactly like the mode-handoff workers. The original task
+ * is sent verbatim; the submit contract is appended after a separator.
+ */
+export declare function agentNewPrompt(task: string, jobId: string): string;

package/dist/prompts/agent.js

@@ -3,30 +3,30 @@ import { planReviewPrompt, specReviewPrompt } from './review.js';
  * First user message for a spec → plan handoff.
  *
  * Thin prompt: the worker discovers the full planning workflow by running
- * `crtr flow plan new -h`, then saves the plan via `crtr flow plan new`. This avoids
- * embedding the planPrompt() blob here and keeps the prompt in sync with the
- * live CLI without any coupling.
+ * `crtr mode plan new -h`, then saves the plan via `crtr mode plan new`. This
+ * avoids embedding the planPrompt() blob here and keeps the prompt in sync
+ * with the live CLI without any coupling.
  */
 export function planHandoffPrompt(specPath, jobId) {
     return `You were launched in a new tmux pane to turn an approved spec into a plan.
 
 **Spec:** ${specPath}
 
-1. Run \`crtr flow plan new -h\` to load the planning workflow and output schema.
+1. Run \`crtr mode plan new -h\` to load the planning workflow and output schema.
 2. Read the spec end-to-end.
-3. Follow the workflow from step 1 and save the plan by passing the plan markdown to \`crtr flow plan new\` on stdin.
-4. When done, submit your result:
+3. Follow the workflow from step 1 and save the plan by passing the plan markdown to \`crtr mode plan new\` on stdin.
+4. When done, submit a short markdown report on stdin:
 
 \`\`\`bash
-echo '{"status":"done","plan_saved":true}' > /tmp/crtr-result-${jobId}.json
-crtr job submit ${jobId} --context-file /tmp/crtr-result-${jobId}.json
+crtr job submit ${jobId} <<'MD'
+Plan saved at <path>. <one-line summary of the plan's shape>.
+MD
 \`\`\`
 
-If you cannot complete the plan, still submit:
+If you cannot complete the plan, submit a failure with a reason:
 
 \`\`\`bash
-echo '{"status":"failed","reason":"<why>"}' > /tmp/crtr-result-${jobId}.json
-crtr job submit ${jobId} --context-file /tmp/crtr-result-${jobId}.json
+crtr job submit ${jobId} --status failed --reason "<why>"
 \`\`\`
 
 Begin now.`;
@@ -111,17 +111,19 @@ would be slower.
 
 ## Phase 6: Report and submit
 
-When all tasks complete and verification passes, submit your result:
+When all tasks complete and verification passes, submit a markdown report on stdin:
 
 \`\`\`bash
-echo '{"status":"done","summary":"<one-line summary of files touched>"}' > /tmp/crtr-result-${jobId}.json
-crtr job submit ${jobId} --context-file /tmp/crtr-result-${jobId}.json
+crtr job submit ${jobId} <<'MD'
+**Summary:** <one-line summary of files touched>
+
+<optional further notes — verification output, surprises, callouts>
+MD
 \`\`\`
 
-If implementation fails, still submit:
+If implementation fails, submit a failure with a reason:
 \`\`\`bash
-echo '{"status":"failed","reason":"<why>"}' > /tmp/crtr-result-${jobId}.json
-crtr job submit ${jobId} --context-file /tmp/crtr-result-${jobId}.json
+crtr job submit ${jobId} --status failed --reason "<why>"
 \`\`\`
 
 ## Guardrails (apply to you AND your subagents)
@@ -144,8 +146,39 @@ export function reviewerHandoffPrompt(artifactPath, artifactKind, specPath, jobI
     const reviewBody = artifactKind === 'spec'
         ? specReviewPrompt(artifactPath)
         : planReviewPrompt(artifactPath, specPath);
-    const patched = reviewBody.replace('__CRTR_SUBMIT_INSTRUCTION__', `the submit command injected below. The \`--kill-pane\` flag closes this reviewer pane after submission — keep it, do not drop it.\n\n\`\`\`bash\ncat > /tmp/crtr-result-${jobId}.json <<'JSON'\n{"status":"done","review":"<your full review markdown>"}\nJSON\ncrtr job submit ${jobId} --context-file /tmp/crtr-result-${jobId}.json --kill-pane\n\`\`\``);
+    const patched = reviewBody.replace('__CRTR_SUBMIT_INSTRUCTION__', `the submit command injected below. Pipe your full review markdown on stdin. The \`--kill-pane\` flag closes this reviewer pane after submission — keep it, do not drop it.\n\n\`\`\`bash\ncrtr job submit ${jobId} --kill-pane <<'MD'\n<your full review markdown — the same Status/Issues/Recommendations block you composed above>\nMD\n\`\`\`\n\nIf the artifact is too malformed to review, submit a failure instead:\n\n\`\`\`bash\ncrtr job submit ${jobId} --status failed --reason "<why>" --kill-pane\n\`\`\``);
     return `${patched}
 
 After calling \`crtr job submit\`, your turn ends and the pane closes itself. Do NOT chat or summarize after submission.`;
 }
+/**
+ * First user message for a general `agent new` worker.
+ *
+ * The worker runs as an interactive agent in a tmux pane (not print mode), so
+ * its stdout is NOT captured as the result — it must deliver its answer via
+ * `crtr job submit`, exactly like the mode-handoff workers. The original task
+ * is sent verbatim; the submit contract is appended after a separator.
+ */
+export function agentNewPrompt(task, jobId) {
+    return `${task}
+
+---
+
+When you have finished the task above, deliver your final answer by piping your
+full markdown result to \`crtr job submit\` — this is how the result is returned
+to whoever spawned you:
+
+\`\`\`bash
+crtr job submit ${jobId} <<'MD'
+<your complete answer / findings>
+MD
+\`\`\`
+
+If you cannot complete the task, submit a failure with a reason instead:
+
+\`\`\`bash
+crtr job submit ${jobId} --status failed --reason "<why>"
+\`\`\`
+
+Do your work first; submit exactly once when done. After submitting, your turn ends.`;
+}

package/dist/prompts/debug.js

@@ -19,18 +19,25 @@ Rules — follow exactly:
 
 Submit exactly one of the following via \`crtr job submit\`, then your turn ends — do not chat:
 
-Reproduced:
+Reproduced (markdown body on stdin):
 \`\`\`bash
-cat > /tmp/crtr-result-${jobId}.json <<'JSON'
-{"status":"done","reproduces":true,"test_path":"<path>","test_command":"<exact cmd>","failure_output":"<pasted failing output>"}
-JSON
-crtr job submit ${jobId} --context-file /tmp/crtr-result-${jobId}.json
+crtr job submit ${jobId} <<'MD'
+**Reproduces:** yes
+
+**Test path:** <path>
+
+**Test command:** \`<exact cmd>\`
+
+**Failure output:**
+\`\`\`
+<pasted failing output>
+\`\`\`
+MD
 \`\`\`
 
 Gave up (no faithful repro achievable):
 \`\`\`bash
-echo '{"status":"failed","reproduces":false,"reason":"<why a faithful repro was not achievable>"}' > /tmp/crtr-result-${jobId}.json
-crtr job submit ${jobId} --context-file /tmp/crtr-result-${jobId}.json
+crtr job submit ${jobId} --status failed --reason "<why a faithful repro was not achievable>"
 \`\`\`
 
 Begin now.`;

package/dist/prompts/skill.js

@@ -111,7 +111,7 @@ are for large, complicated, or unintuitive systems only.
 ## 2. Scope + name
 
 - **Scope**: \`project\` by default. \`user\` only if cross-repo.
-- **Name**: kebab-case. Confirm no collision: \`crtr skill read where <name>\` (returns \`.path\`, \`.scope\`, \`.plugin\`).
+- **Name**: kebab-case. Confirm no collision: \`crtr skill read <name> --no-body\` (returns \`.path\`, \`.scope\`, \`.plugin\`).
 
 ## 3. Parallel exploration
 
@@ -178,7 +178,7 @@ Non-obvious coupling. Looks-broken-but-isn't. Past footguns.
 \`\`\`
 
 **No \`## Related\` for within-plugin siblings** — the CLI auto-appends a
-\`## Neighbors\` section on \`crtr skill read show <name>\`. Add a manual \`## Related\`
+\`## Neighbors\` section on \`crtr skill read <name>\`. Add a manual \`## Related\`
 only for cross-plugin or distant refs.
 
 **Density rules:**
@@ -195,8 +195,8 @@ only for cross-plugin or distant refs.
 Output is JSON; \`.content\` has the body, \`.path\` has the location:
 
 \`\`\`
-crtr skill read where <name>
-crtr skill read show <name>
+crtr skill read <name> --no-body
+crtr skill read <name>
 crtr skill find search "<keyword>"    # confirm description triggers discovery
 \`\`\`
 
@@ -246,7 +246,7 @@ PR over many small ones for refactors here, because review churn dominates"*
 
 - **Scope**: \`user\` for cross-project methodology. \`project\` for repo-specific.
 - **Name**: kebab-case, verb-or-noun-phrase. Not "guide-to-X".
-- Check \`crtr skill read where <name>\` (returns \`.path\`, \`.scope\`, \`.plugin\`).
+- Check \`crtr skill read <name> --no-body\` (returns \`.path\`, \`.scope\`, \`.plugin\`).
 
 ## 3. Scaffold
 
@@ -297,7 +297,7 @@ to read the whole thing for value, you've buried the judgment.
 \`\`\`
 
 **No \`## Related\` for within-plugin siblings** — the CLI auto-appends a
-\`## Neighbors\` section on \`crtr skill read show <name>\`. Add a manual \`## Related\`
+\`## Neighbors\` section on \`crtr skill read <name>\`. Add a manual \`## Related\`
 only for cross-plugin or distant refs.
 
 ## 6. Progressive disclosure
@@ -319,8 +319,8 @@ loads supporting files only when needed.
 Output is JSON; \`.content\` has the body, \`.path\` has the location:
 
 \`\`\`
-crtr skill read where <name>
-crtr skill read show <name>
+crtr skill read <name> --no-body
+crtr skill read <name>
 crtr skill find search "<keyword>"
 \`\`\`
 
@@ -410,8 +410,8 @@ Or invent your own. Stay tight — no padding.
 Output is JSON; \`.content\` has the body, \`.path\` has the location:
 
 \`\`\`
-crtr skill read where <name>
-crtr skill read show <name>
+crtr skill read <name> --no-body
+crtr skill read <name>
 crtr skill find search "<keyword>"
 \`\`\`
 
@@ -464,7 +464,7 @@ field/flag/code values** — pull verbatim from source.
 
 - **Scope**: \`user\` for cross-project facts. \`project\` for repo-specific.
 - **Name**: noun-phrase. \`http-status-codes\` not \`learn-http-status\`.
-- Check \`crtr skill read where <name>\` (returns \`.path\`, \`.scope\`, \`.plugin\`).
+- Check \`crtr skill read <name> --no-body\` (returns \`.path\`, \`.scope\`, \`.plugin\`).
 
 ## 3. Scaffold
 
@@ -525,8 +525,8 @@ SKILL.md links to siblings (\`see [full-table.md](full-table.md)\`).
 Output is JSON; \`.content\` has the body, \`.path\` has the location:
 
 \`\`\`
-crtr skill read where <name>
-crtr skill read show <name>
+crtr skill read <name> --no-body
+crtr skill read <name>
 crtr skill find search "<keyword>"
 \`\`\`
 
@@ -577,7 +577,7 @@ push to \\\`main\\\`, wait for green CI, click promote"* is a runbook step.
 
 - **Scope**: \`project\` for repo-specific procedures. \`user\` for cross-project.
 - **Name**: verb-phrase. \`deploy-to-prod\` not \`production-deployment-guide\`.
-- Check \`crtr skill read where <name>\` (returns \`.path\`, \`.scope\`, \`.plugin\`).
+- Check \`crtr skill read <name> --no-body\` (returns \`.path\`, \`.scope\`, \`.plugin\`).
 
 ## 3. Scaffold
 
@@ -632,8 +632,8 @@ crtr skill author scaffold <name> --type runbook --scope <user|project> --descri
 Output is JSON; \`.content\` has the body, \`.path\` has the location:
 
 \`\`\`
-crtr skill read where <name>
-crtr skill read show <name>
+crtr skill read <name> --no-body
+crtr skill read <name>
 crtr skill find search "<keyword>"
 \`\`\`
 

package/dist/types.d.ts

@@ -8,7 +8,7 @@ export declare const ExitCode: {
     readonly NETWORK: 5;
 };
 export type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];
-export declare const SCHEMA_VERSION = 1;
+export declare const SCHEMA_VERSION = 2;
 export interface OwnerRef {
     name?: string;
     email?: string;
@@ -90,6 +90,26 @@ export interface Skill {
     enabled: boolean;
     disabledIn?: Scope;
 }
+export interface SubagentFrontmatter {
+    name: string;
+    description?: string;
+    /** Tool allow-list (pi tool names). Passed through to pi via `--tools`. */
+    tools?: string[];
+    /** Model pattern/id passed to the agent CLI via `--model`. */
+    model?: string;
+}
+export interface Subagent {
+    name: string;
+    /** Plugin the subagent belongs to, or SCOPE_SKILL_PLUGIN ('_') for a
+     *  scope-root agent stored at `<scope-root>/agents/<name>.md`. */
+    plugin: string;
+    scope: Scope;
+    /** Absolute path to the agent's .md file. */
+    path: string;
+    frontmatter: SubagentFrontmatter;
+    /** Markdown body — used as the spawned agent's appended system prompt. */
+    systemPrompt: string;
+}
 export interface InstalledPlugin {
     name: string;
     scope: Scope;
@@ -117,6 +137,7 @@ export declare const CONFIG_FILE = "config.json";
 export declare const STATE_FILE = "state.json";
 export declare const SKILL_ENTRY_FILE = "SKILL.md";
 export declare const SKILLS_DIR = "skills";
+export declare const AGENTS_DIR = "agents";
 export declare const SCOPE_SKILL_PLUGIN = "_";
 export declare const DEFAULT_MAX_PANES_PER_WINDOW = 3;
 export declare function defaultScopeConfig(): ScopeConfig;

package/dist/types.js

@@ -6,7 +6,7 @@ export const ExitCode = {
     AMBIGUOUS: 4,
     NETWORK: 5,
 };
-export const SCHEMA_VERSION = 1;
+export const SCHEMA_VERSION = 2;
 export const SKILL_TYPES = ['playbook', 'primer', 'reference', 'runbook', 'freeform'];
 export function isSkillType(v) {
     return typeof v === 'string' && SKILL_TYPES.includes(v);
@@ -20,6 +20,9 @@ export const CONFIG_FILE = 'config.json';
 export const STATE_FILE = 'state.json';
 export const SKILL_ENTRY_FILE = 'SKILL.md';
 export const SKILLS_DIR = 'skills';
+// Subagent definitions live as flat `<name>.md` files under `<root>/agents/`,
+// for both scope roots and plugins. Mirrors SKILLS_DIR.
+export const AGENTS_DIR = 'agents';
 // Sentinel plugin name for skills that live at a scope root (no plugin wrapper).
 // Stored as `<scope-root>/skills/<name>/SKILL.md`. Shown in listings without the
 // `_/` prefix.
@@ -36,7 +39,7 @@ export function defaultScopeConfig() {
     };
 }
 export function skillConfigKey(plugin, name) {
-    return `${plugin}:${name}`;
+    return `${plugin}/${name}`;
 }
 export function defaultScopeState() {
     return { marketplaces: {}, plugins: {} };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/crouter",
-  "version": "0.3.3",
+  "version": "0.3.11",
   "description": "crtr — fast access to skills, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",
@@ -35,7 +35,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@crouton-kit/humanloop": "^0.3.8",
+    "@crouton-kit/humanloop": "^0.3.12",
     "commander": "^13.0.0"
   },
   "devDependencies": {

package/dist/commands/flow.js

@@ -1,24 +0,0 @@
-// `crtr flow` umbrella — groups the spec → plan → debug development process.
-// registerSpec/registerPlan are unchanged (each still defineBranch{name}); they
-// nest under `flow` here instead of registering at root. registerDebug is a
-// leaf — `crtr flow debug` spawns directly and `-h` prints FLOW_DEBUG_GUIDE.
-import { defineBranch } from '../core/command.js';
-import { registerSpec } from './spec.js';
-import { registerPlan } from './plan.js';
-import { registerDebug } from './debug.js';
-export function registerFlow() {
-    return defineBranch({
-        name: 'flow',
-        help: {
-            name: 'flow',
-            summary: 'the spec → plan → debug development process',
-            model: 'spec captures requirements; plan decomposes them; debug root-causes failures reproduce-first.',
-            children: [
-                { name: 'spec', desc: 'create, read, list specifications', useWhen: 'capturing requirements before planning' },
-                { name: 'plan', desc: 'create, read, list plans', useWhen: 'shaping or inspecting work' },
-                { name: 'debug', desc: 'reproduce-first root-cause workflow', useWhen: 'a bug, test failure, or unexpected behavior needs root-causing' },
-            ],
-        },
-        children: [registerSpec(), registerPlan(), registerDebug()],
-    });
-}