astrocode-workflow 0.0.5 → 0.1.2

package/dist/agents/prompts.d.ts

@@ -1,2 +1,2 @@
-export declare const BASE_ORCH_PROMPT = "You are Astro (Orchestrator) for Astrocode.\n\nMission:\n- Advance a deterministic pipeline: frame \u2192 plan \u2192 spec \u2192 implement \u2192 review \u2192 verify \u2192 close.\n- The SQLite DB is the source of truth. Prefer tools over prose.\n- Never narrate what prompts you received.\n- Keep outputs short; store large outputs as artifacts and reference paths.\n\nOperating rules:\n- Prefer calling astro_workflow_proceed (step/loop) and astro_status.\n- Delegate stage work only to the stage subagent matching the current stage.\n- If a stage subagent returns status=blocked, inject the BLOCKED directive and stop.\n- Never delegate from subagents (enforced by permissions).\n";
+export declare const BASE_ORCH_PROMPT = "You are Astro (Orchestrator) for Astrocode.\n\nMission:\n- Advance a deterministic pipeline: frame \u2192 plan \u2192 spec \u2192 implement \u2192 review \u2192 verify \u2192 close.\n- The SQLite DB is the source of truth. Prefer tools over prose.\n- Never narrate what prompts you received.\n- Keep outputs short; store large outputs as artifacts and reference paths.\n\nOperating rules:\n- Only start new runs when the user explicitly requests implementation, workflow management, or story processing.\n- Answer questions directly when possible without starting workflows.\n- Prefer calling astro_workflow_proceed (step/loop) and astro_status only when actively managing a workflow.\n- Delegate stage work only to the stage subagent matching the current stage.\n- If a stage subagent returns status=blocked, inject the BLOCKED directive and stop.\n- Never delegate from subagents (enforced by permissions).\n- Be discretionary: assess if the user's request requires workflow initiation or just information.\n";
 export declare const BASE_STAGE_PROMPT = "You are an Astro stage subagent.\n\nFollow the latest [SYSTEM DIRECTIVE: ASTROCODE \u2014 STAGE_*] you receive.\n\nOutput exactly:\n1) Baton markdown (short, structured)\n2) Valid ASTRO JSON between markers:\n<!-- ASTRO_JSON_BEGIN -->\n{...}\n<!-- ASTRO_JSON_END -->\n\nDo not narrate. If blocked, ask exactly ONE question and stop.\n";

package/dist/agents/prompts.js

@@ -7,10 +7,13 @@ Mission:
 - Keep outputs short; store large outputs as artifacts and reference paths.
 
 Operating rules:
-- Prefer calling astro_workflow_proceed (step/loop) and astro_status.
+- Only start new runs when the user explicitly requests implementation, workflow management, or story processing.
+- Answer questions directly when possible without starting workflows.
+- Prefer calling astro_workflow_proceed (step/loop) and astro_status only when actively managing a workflow.
 - Delegate stage work only to the stage subagent matching the current stage.
 - If a stage subagent returns status=blocked, inject the BLOCKED directive and stop.
 - Never delegate from subagents (enforced by permissions).
+- Be discretionary: assess if the user's request requires workflow initiation or just information.
 `;
 export const BASE_STAGE_PROMPT = `You are an Astro stage subagent.
 

package/dist/agents/registry.js

@@ -98,13 +98,13 @@ export function createAstroAgents(opts) {
         pluginConfig.agents = {
             orchestrator_name: "Astro",
             stage_agent_names: {
-                frame: "AstroFrame",
-                plan: "AstroPlan",
-                spec: "AstroSpec",
-                implement: "AstroImplement",
-                review: "AstroReview",
-                verify: "AstroVerify",
-                close: "AstroClose"
+                frame: "Frame",
+                plan: "Plan",
+                spec: "Spec",
+                implement: "Implement",
+                review: "Review",
+                verify: "Verify",
+                close: "Close"
             },
             librarian_name: "Librarian",
             explore_name: "Explore",

package/dist/config/schema.d.ts

@@ -68,6 +68,7 @@ export declare const AstrocodeConfigSchema: z.ZodDefault<z.ZodObject<{
         loop_max_steps_hard_cap: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
         plan_max_tasks: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
         plan_max_lines: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        baton_summary_max_lines: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
         forbid_prompt_narration: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         single_active_run_per_repo: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         lock_timeout_ms: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;

package/dist/config/schema.js

@@ -97,6 +97,7 @@ const WorkflowSchema = z.object({
     loop_max_steps_hard_cap: z.number().int().positive().default(200),
     plan_max_tasks: z.number().int().positive().default(500),
     plan_max_lines: z.number().int().positive().default(2000),
+    baton_summary_max_lines: z.number().int().positive().default(20),
     forbid_prompt_narration: z.boolean().default(true),
     single_active_run_per_repo: z.boolean().default(true),
     lock_timeout_ms: z.number().int().positive().default(4000),
@@ -128,13 +129,13 @@ const AgentsSchema = z.object({
     // Display names for the stage sub-agents.
     stage_agent_names: z
         .object({
-        frame: z.string().default("Astro — Frame"),
-        plan: z.string().default("Astro — Plan"),
-        spec: z.string().default("Astro — Spec"),
-        implement: z.string().default("Astro — Implement"),
-        review: z.string().default("Astro — Review"),
-        verify: z.string().default("Astro — Verify"),
-        close: z.string().default("Astro — Close"),
+        frame: z.string().default("Frame"),
+        plan: z.string().default("Plan"),
+        spec: z.string().default("Spec"),
+        implement: z.string().default("Implement"),
+        review: z.string().default("Review"),
+        verify: z.string().default("Verify"),
+        close: z.string().default("Close"),
     })
         .partial()
         .default({}),

package/dist/tools/stage.js

@@ -1,4 +1,5 @@
 import path from "node:path";
+import fs from "node:fs";
 import { tool } from "@opencode-ai/plugin/tool";
 import { withTx } from "../state/db";
 import { buildBatonSummary, parseStageOutputText } from "../workflow/baton";
@@ -94,7 +95,7 @@ export function createAstroStageCompleteTool(opts) {
             const batonSummary = buildBatonSummary({ config, stage_key: sk, astro_json: parsed.astro_json, baton_md: parsed.baton_md });
             const now = nowISO();
             const pipeline = JSON.parse(run.pipeline_stages_json ?? "[]");
-            const next = nextStageKey(pipeline, sk);
+            let next = nextStageKey(pipeline, sk);
             const stageDirRel = toPosix(path.join(".astro", "runs", rid, sk));
             const batonRel = toPosix(path.join(stageDirRel, config.artifacts.baton_filename));
             const summaryRel = toPosix(path.join(stageDirRel, config.artifacts.baton_summary_filename));
@@ -198,6 +199,49 @@ export function createAstroStageCompleteTool(opts) {
                         }
                     }
                 }
+                // Skip spec stage if spec already exists
+                if (sk === "plan" && next === "spec") {
+                    const specPath = path.join(repoRoot, ".astro", "spec.md");
+                    if (fs.existsSync(specPath) && fs.statSync(specPath).size > 100) {
+                        // Skip spec
+                        db.prepare("INSERT INTO stage_runs (stage_run_id, run_id, stage_key, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)")
+                            .run(newId("stage"), rid, "spec", "skipped", now, now);
+                        next = "implement";
+                    }
+                }
+                // Split stories during implementation if tasks are identified
+                if (sk === "implement" && allow_new_stories && parsed.astro_json.tasks?.length) {
+                    for (const task of parsed.astro_json.tasks) {
+                        const complexity = task.complexity ?? 5;
+                        const subtasks = task.subtasks ?? [];
+                        if (subtasks.length > 0) {
+                            // Split into subtasks
+                            for (const subtask of subtasks) {
+                                const key = insertStory(db, {
+                                    title: `${task.title}: ${subtask}`,
+                                    body_md: task.description ?? "",
+                                    priority: Math.max(1, 10 - complexity),
+                                    state: "queued",
+                                    epic_key: run.story_key
+                                });
+                                newStoryKeys.push(key);
+                                db.prepare("INSERT INTO story_relations (relation_id, parent_key, child_key, relation_type, created_at) VALUES (?, ?, ?, ?, ?)").run(newId("rel"), run.story_key, key, "split from implement", now);
+                            }
+                        }
+                        else if (complexity > 6) {
+                            // Split complex tasks
+                            const key = insertStory(db, {
+                                title: task.title,
+                                body_md: task.description ?? "",
+                                priority: Math.max(1, 10 - complexity),
+                                state: "queued",
+                                epic_key: run.story_key
+                            });
+                            newStoryKeys.push(key);
+                            db.prepare("INSERT INTO story_relations (relation_id, parent_key, child_key, relation_type, created_at) VALUES (?, ?, ?, ?, ?)").run(newId("rel"), run.story_key, key, "split from implement", now);
+                        }
+                    }
+                }
                 if (parsed.astro_json.status !== "ok") {
                     const err = parsed.astro_json.status === "blocked"
                         ? `blocked: ${(parsed.astro_json.questions?.[0] ?? "needs input")}`

package/dist/tools/story.js

@@ -14,9 +14,8 @@ export function createAstroStoryQueueTool(opts) {
         },
         execute: async ({ title, body_md, epic_key, priority }) => {
             // If the story seems like a large implementation, convert to planning story
-            const isLargeImplementation = title.toLowerCase().includes('implement') &&
-                (body_md?.length || 0) > 200 &&
-                (body_md?.toLowerCase().includes('full') || body_md?.toLowerCase().includes('complete'));
+            const isLargeImplementation = (title.toLowerCase().includes('implement') || body_md?.toLowerCase().includes('implement')) &&
+                (body_md?.length || 0) > 100;
             let finalTitle = title;
             let finalBody = body_md;
             if (isLargeImplementation) {

package/dist/tools/workflow.js

@@ -12,7 +12,7 @@ function stageGoal(stage, cfg) {
         case "frame":
             return "Define scope, constraints, and an unambiguous Definition of Done.";
         case "plan":
-            return `Break down the work into 10-500 detailed tasks with subtasks, estimating complexity (1-10) for each. Focus on granular, implementable units.`;
+            return `Create 50-200 detailed implementation stories, each focused on a specific, implementable task. Break down every component into separate stories with clear acceptance criteria.`;
         case "spec":
             return "Produce minimal spec/contract: interfaces, invariants, acceptance checks.";
         case "implement":
@@ -32,7 +32,7 @@ function stageConstraints(stage, cfg) {
         "If blocked: ask exactly ONE question and stop.",
     ];
     if (stage === "plan") {
-        common.push(`Aim for 10-500 tasks; no hard upper limit but prioritize granularity.`);
+        common.push(`Create 50-200 stories; each story must be implementable in 2-8 hours with clear acceptance criteria.`);
     }
     if (stage === "verify" && cfg.workflow.evidence_required.verify) {
         common.push("Evidence required: ASTRO JSON must include evidence[] paths.");

package/dist/ui/inject.js

@@ -1,9 +1,29 @@
+let isInjecting = false;
+let queuedInjection = null;
 export async function injectChatPrompt(opts) {
     const { ctx, sessionId, text } = opts;
-    await ctx.client.session.prompt({
-        path: { id: sessionId },
-        body: {
-            parts: [{ type: "text", text }],
-        },
-    });
+    if (isInjecting) {
+        // Replace any existing queued injection (keep only latest)
+        queuedInjection = opts;
+        return;
+    }
+    isInjecting = true;
+    try {
+        await ctx.client.session.prompt({
+            path: { id: sessionId },
+            body: {
+                parts: [{ type: "text", text }],
+            },
+        });
+    }
+    finally {
+        isInjecting = false;
+        // Process queued injection if any
+        if (queuedInjection) {
+            const next = queuedInjection;
+            queuedInjection = null;
+            // Schedule next injection asynchronously to prevent recursion
+            setImmediate(() => injectChatPrompt(next));
+        }
+    }
 }

package/dist/workflow/state-machine.js

@@ -46,6 +46,11 @@ export function decideNextAction(db, config) {
     warn("Unexpected stage status in decideNextAction", { status: current.status, stage_key: current.stage_key });
     return { kind: "await_stage_completion", run_id: activeRun.run_id, stage_key: current.stage_key, stage_run_id: current.stage_run_id };
 }
+function isInitialStory(db, storyKey) {
+    // Check if this story has no parent relations (is top-level)
+    const relations = db.prepare("SELECT COUNT(*) as count FROM story_relations WHERE child_key=?").get(storyKey);
+    return relations.count === 0;
+}
 export function createRunForStory(db, config, storyKey) {
     const story = getStory(db, storyKey);
     if (!story)
@@ -55,6 +60,15 @@ export function createRunForStory(db, config, storyKey) {
     const run_id = newRunId();
     const now = nowISO();
     const pipeline = config.workflow.pipeline;
+    // Convert to genesis planning story if needed
+    const isGenesisCandidate = storyKey === 'S-0001' || isInitialStory(db, storyKey) ||
+        (story.body_md && story.body_md.length > 100 &&
+            (story.title.toLowerCase().includes('implement') || story.body_md.toLowerCase().includes('implement')));
+    if (isGenesisCandidate) {
+        const planningTitle = `Plan and decompose: ${story.title}`;
+        const planningBody = `Analyze the requirements and break down "${story.title}" into 50-200 detailed, granular implementation stories. Each story should be focused on a specific, implementable task with clear acceptance criteria.\n\nOriginal request: ${story.body_md || ''}`;
+        db.prepare("UPDATE stories SET title=?, body_md=? WHERE story_key=?").run(planningTitle, planningBody, storyKey);
+    }
     // Lock story
     db.prepare("UPDATE stories SET state='in_progress', in_progress=1, locked_by_run_id=?, locked_at=?, updated_at=? WHERE story_key=?").run(run_id, now, now, storyKey);
     db.prepare("INSERT INTO runs (run_id, story_key, status, pipeline_stages_json, current_stage_key, created_at, started_at, updated_at) VALUES (?, ?, 'running', ?, ?, ?, ?, ?)").run(run_id, storyKey, JSON.stringify(pipeline), pipeline[0] ?? null, now, now, now);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astrocode-workflow",
-  "version": "0.0.5",
+  "version": "0.1.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,6 +18,7 @@
   "dependencies": {
     "@opencode-ai/plugin": "^1.1.19",
     "@opencode-ai/sdk": "^1.1.19",
+    "astrocode-workflow": "0.1.1",
     "jsonc-parser": "^3.2.0",
     "zod": "4.1.8"
   },

package/src/agents/prompts.ts

@@ -7,10 +7,13 @@ Mission:
 - Keep outputs short; store large outputs as artifacts and reference paths.
 
 Operating rules:
-- Prefer calling astro_workflow_proceed (step/loop) and astro_status.
+- Only start new runs when the user explicitly requests implementation, workflow management, or story processing.
+- Answer questions directly when possible without starting workflows.
+- Prefer calling astro_workflow_proceed (step/loop) and astro_status only when actively managing a workflow.
 - Delegate stage work only to the stage subagent matching the current stage.
 - If a stage subagent returns status=blocked, inject the BLOCKED directive and stop.
 - Never delegate from subagents (enforced by permissions).
+- Be discretionary: assess if the user's request requires workflow initiation or just information.
 `;
 
 export const BASE_STAGE_PROMPT = `You are an Astro stage subagent.

package/src/agents/registry.ts

@@ -126,13 +126,13 @@ export function createAstroAgents(opts: {
     pluginConfig.agents = {
       orchestrator_name: "Astro",
       stage_agent_names: {
-        frame: "AstroFrame",
-        plan: "AstroPlan",
-        spec: "AstroSpec",
-        implement: "AstroImplement",
-        review: "AstroReview",
-        verify: "AstroVerify",
-        close: "AstroClose"
+      frame: "Frame",
+      plan: "Plan",
+      spec: "Spec",
+      implement: "Implement",
+      review: "Review",
+      verify: "Verify",
+      close: "Close"
       },
       librarian_name: "Librarian",
       explore_name: "Explore",

package/src/config/schema.ts

@@ -114,6 +114,7 @@ const WorkflowSchema = z.object({
 
   plan_max_tasks: z.number().int().positive().default(500),
   plan_max_lines: z.number().int().positive().default(2000),
+  baton_summary_max_lines: z.number().int().positive().default(20),
 
   forbid_prompt_narration: z.boolean().default(true),
   single_active_run_per_repo: z.boolean().default(true),
@@ -153,13 +154,13 @@ const AgentsSchema = z.object({
   // Display names for the stage sub-agents.
   stage_agent_names: z
     .object({
-      frame: z.string().default("Astro — Frame"),
-      plan: z.string().default("Astro — Plan"),
-      spec: z.string().default("Astro — Spec"),
-      implement: z.string().default("Astro — Implement"),
-      review: z.string().default("Astro — Review"),
-      verify: z.string().default("Astro — Verify"),
-      close: z.string().default("Astro — Close"),
+      frame: z.string().default("Frame"),
+      plan: z.string().default("Plan"),
+      spec: z.string().default("Spec"),
+      implement: z.string().default("Implement"),
+      review: z.string().default("Review"),
+      verify: z.string().default("Verify"),
+      close: z.string().default("Close"),
     })
     .partial()
     .default({}),

package/src/tools/stage.ts

@@ -1,4 +1,5 @@
 import path from "node:path";
+import fs from "node:fs";
 import { tool, type ToolDefinition } from "@opencode-ai/plugin/tool";
 import type { AstrocodeConfig } from "../config/schema";
 import type { SqliteDb } from "../state/db";
@@ -113,7 +114,7 @@ export function createAstroStageCompleteTool(opts: { ctx: any; config: Astrocode
 
       const now = nowISO();
       const pipeline = JSON.parse(run.pipeline_stages_json ?? "[]") as StageKey[];
-      const next = nextStageKey(pipeline, sk);
+      let next = nextStageKey(pipeline, sk);
 
       const stageDirRel = toPosix(path.join(".astro", "runs", rid, sk));
       const batonRel = toPosix(path.join(stageDirRel, config.artifacts.baton_filename));
@@ -270,6 +271,66 @@ export function createAstroStageCompleteTool(opts: { ctx: any; config: Astrocode
           }
         }
 
+        // Skip spec stage if spec already exists
+        if (sk === "plan" && next === "spec") {
+          const specPath = path.join(repoRoot, ".astro", "spec.md");
+          if (fs.existsSync(specPath) && fs.statSync(specPath).size > 100) {
+            // Skip spec
+            db.prepare("INSERT INTO stage_runs (stage_run_id, run_id, stage_key, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)")
+              .run(newId("stage"), rid, "spec", "skipped", now, now);
+            next = "implement";
+          }
+        }
+
+        // Split stories during implementation if tasks are identified
+        if (sk === "implement" && allow_new_stories && parsed.astro_json.tasks?.length) {
+          for (const task of parsed.astro_json.tasks) {
+            const complexity = task.complexity ?? 5;
+            const subtasks = task.subtasks ?? [];
+            if (subtasks.length > 0) {
+              // Split into subtasks
+              for (const subtask of subtasks) {
+                const key = insertStory(db, {
+                  title: `${task.title}: ${subtask}`,
+                  body_md: task.description ?? "",
+                  priority: Math.max(1, 10 - complexity),
+                  state: "queued",
+                  epic_key: run.story_key
+                });
+                newStoryKeys.push(key);
+                db.prepare(
+                  "INSERT INTO story_relations (relation_id, parent_key, child_key, relation_type, created_at) VALUES (?, ?, ?, ?, ?)"
+                ).run(
+                  newId("rel"),
+                  run.story_key,
+                  key,
+                  "split from implement",
+                  now
+                );
+              }
+            } else if (complexity > 6) {
+              // Split complex tasks
+              const key = insertStory(db, {
+                title: task.title,
+                body_md: task.description ?? "",
+                priority: Math.max(1, 10 - complexity),
+                state: "queued",
+                epic_key: run.story_key
+              });
+              newStoryKeys.push(key);
+              db.prepare(
+                "INSERT INTO story_relations (relation_id, parent_key, child_key, relation_type, created_at) VALUES (?, ?, ?, ?, ?)"
+              ).run(
+                newId("rel"),
+                run.story_key,
+                key,
+                "split from implement",
+                now
+              );
+            }
+          }
+        }
+
         if (parsed.astro_json.status !== "ok") {
           const err = parsed.astro_json.status === "blocked"
             ? `blocked: ${(parsed.astro_json.questions?.[0] ?? "needs input")}`

package/src/tools/story.ts

@@ -21,9 +21,8 @@ export function createAstroStoryQueueTool(opts: { ctx: any; config: AstrocodeCon
     },
     execute: async ({ title, body_md, epic_key, priority }) => {
       // If the story seems like a large implementation, convert to planning story
-      const isLargeImplementation = title.toLowerCase().includes('implement') &&
-        (body_md?.length || 0) > 200 &&
-        (body_md?.toLowerCase().includes('full') || body_md?.toLowerCase().includes('complete'));
+      const isLargeImplementation = (title.toLowerCase().includes('implement') || body_md?.toLowerCase().includes('implement')) &&
+        (body_md?.length || 0) > 100;
 
       let finalTitle = title;
       let finalBody = body_md;

package/src/tools/workflow.ts

@@ -16,7 +16,7 @@ function stageGoal(stage: StageKey, cfg: AstrocodeConfig): string {
     case "frame":
       return "Define scope, constraints, and an unambiguous Definition of Done.";
     case "plan":
-      return `Break down the work into 10-500 detailed tasks with subtasks, estimating complexity (1-10) for each. Focus on granular, implementable units.`;
+      return `Create 50-200 detailed implementation stories, each focused on a specific, implementable task. Break down every component into separate stories with clear acceptance criteria.`;
     case "spec":
       return "Produce minimal spec/contract: interfaces, invariants, acceptance checks.";
     case "implement":
@@ -38,7 +38,7 @@ function stageConstraints(stage: StageKey, cfg: AstrocodeConfig): string[] {
   ];
 
   if (stage === "plan") {
-    common.push(`Aim for 10-500 tasks; no hard upper limit but prioritize granularity.`);
+    common.push(`Create 50-200 stories; each story must be implementable in 2-8 hours with clear acceptance criteria.`);
   }
   if (stage === "verify" && cfg.workflow.evidence_required.verify) {
     common.push("Evidence required: ASTRO JSON must include evidence[] paths.");

package/src/ui/inject.ts

@@ -1,13 +1,36 @@
+let isInjecting = false;
+let queuedInjection: { ctx: any; sessionId: string; text: string } | null = null;
+
 export async function injectChatPrompt(opts: {
   ctx: any;
   sessionId: string;
   text: string;
 }) {
   const { ctx, sessionId, text } = opts;
-  await ctx.client.session.prompt({
-    path: { id: sessionId },
-    body: {
-      parts: [{ type: "text", text }],
-    },
-  });
+
+  if (isInjecting) {
+    // Replace any existing queued injection (keep only latest)
+    queuedInjection = opts;
+    return;
+  }
+
+  isInjecting = true;
+
+  try {
+    await ctx.client.session.prompt({
+      path: { id: sessionId },
+      body: {
+        parts: [{ type: "text", text }],
+      },
+    });
+  } finally {
+    isInjecting = false;
+    // Process queued injection if any
+    if (queuedInjection) {
+      const next = queuedInjection;
+      queuedInjection = null;
+      // Schedule next injection asynchronously to prevent recursion
+      setImmediate(() => injectChatPrompt(next));
+    }
+  }
 }

package/src/workflow/state-machine.ts

@@ -1,4 +1,6 @@
 import type { AstrocodeConfig } from "../config/schema";
+import fs from "node:fs";
+import path from "node:path";
 import type { SqliteDb } from "../state/db";
 import type { RunRow, StageKey, StageRunRow, StoryRow } from "../state/types";
 import { nowISO } from "../shared/time";
@@ -72,6 +74,12 @@ export function decideNextAction(db: SqliteDb, config: AstrocodeConfig): NextAct
   return { kind: "await_stage_completion", run_id: activeRun.run_id, stage_key: current.stage_key, stage_run_id: current.stage_run_id };
 }
 
+function isInitialStory(db: SqliteDb, storyKey: string): boolean {
+  // Check if this story has no parent relations (is top-level)
+  const relations = db.prepare("SELECT COUNT(*) as count FROM story_relations WHERE child_key=?").get(storyKey) as { count: number };
+  return relations.count === 0;
+}
+
 export function createRunForStory(db: SqliteDb, config: AstrocodeConfig, storyKey: string): { run_id: string } {
   const story = getStory(db, storyKey);
   if (!story) throw new Error(`Story not found: ${storyKey}`);
@@ -81,10 +89,21 @@ export function createRunForStory(db: SqliteDb, config: AstrocodeConfig, storyKe
   const now = nowISO();
   const pipeline = config.workflow.pipeline;
 
-  // Lock story
-  db.prepare(
-    "UPDATE stories SET state='in_progress', in_progress=1, locked_by_run_id=?, locked_at=?, updated_at=? WHERE story_key=?"
-  ).run(run_id, now, now, storyKey);
+   // Convert to genesis planning story if needed
+   const isGenesisCandidate = storyKey === 'S-0001' || isInitialStory(db, storyKey) ||
+     (story.body_md && story.body_md.length > 100 &&
+      (story.title.toLowerCase().includes('implement') || story.body_md.toLowerCase().includes('implement')));
+
+   if (isGenesisCandidate) {
+     const planningTitle = `Plan and decompose: ${story.title}`;
+     const planningBody = `Analyze the requirements and break down "${story.title}" into 50-200 detailed, granular implementation stories. Each story should be focused on a specific, implementable task with clear acceptance criteria.\n\nOriginal request: ${story.body_md || ''}`;
+     db.prepare("UPDATE stories SET title=?, body_md=? WHERE story_key=?").run(planningTitle, planningBody, storyKey);
+   }
+
+   // Lock story
+   db.prepare(
+     "UPDATE stories SET state='in_progress', in_progress=1, locked_by_run_id=?, locked_at=?, updated_at=? WHERE story_key=?"
+   ).run(run_id, now, now, storyKey);
 
   db.prepare(
     "INSERT INTO runs (run_id, story_key, status, pipeline_stages_json, current_stage_key, created_at, started_at, updated_at) VALUES (?, ?, 'running', ?, ?, ?, ?, ?)"