millhouse 0.3.5 → 1.0.1

package/dist/storage/worklist-store.js

@@ -0,0 +1,131 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+const MILLHOUSE_DIR = '.millhouse';
+const WORKLIST_FILE = 'worklist.json';
+export class WorklistStore {
+    basePath;
+    constructor(basePath = process.cwd()) {
+        this.basePath = basePath;
+    }
+    get millhouseDir() {
+        return path.join(this.basePath, MILLHOUSE_DIR);
+    }
+    get worklistPath() {
+        return path.join(this.millhouseDir, WORKLIST_FILE);
+    }
+    async ensureDirectory() {
+        await fs.mkdir(this.millhouseDir, { recursive: true });
+        await this.ensureGitignore();
+    }
+    async ensureGitignore() {
+        const gitignorePath = path.join(this.basePath, '.gitignore');
+        const entry = '.millhouse';
+        let modified = false;
+        try {
+            const content = await fs.readFile(gitignorePath, 'utf-8');
+            // Check if .millhouse is already in gitignore (as whole line)
+            const lines = content.split('\n');
+            if (lines.some(line => line.trim() === entry)) {
+                return; // Already present
+            }
+            // Append to existing gitignore
+            const newContent = content.endsWith('\n') ? content + entry + '\n' : content + '\n' + entry + '\n';
+            await fs.writeFile(gitignorePath, newContent);
+            modified = true;
+        }
+        catch {
+            // No .gitignore exists, create one
+            await fs.writeFile(gitignorePath, entry + '\n');
+            modified = true;
+        }
+        // Commit the gitignore change
+        if (modified) {
+            const { execSync } = await import('node:child_process');
+            try {
+                execSync('git add .gitignore && git commit -m "chore: add .millhouse to .gitignore"', {
+                    cwd: this.basePath,
+                    stdio: 'pipe',
+                });
+            }
+            catch {
+                // Ignore commit failures (e.g., not a git repo)
+            }
+        }
+    }
+    async exists() {
+        try {
+            await fs.access(this.worklistPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async load() {
+        try {
+            const content = await fs.readFile(this.worklistPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    async save(worklist) {
+        await this.ensureDirectory();
+        worklist.updatedAt = new Date().toISOString();
+        await fs.writeFile(this.worklistPath, JSON.stringify(worklist, null, 2));
+    }
+    async delete() {
+        try {
+            await fs.unlink(this.worklistPath);
+        }
+        catch {
+            // Ignore if file doesn't exist
+        }
+    }
+    async updateItem(itemId, updates) {
+        const worklist = await this.load();
+        if (!worklist) {
+            throw new Error('No worklist found');
+        }
+        const item = worklist.items.find(i => i.id === itemId);
+        if (!item) {
+            throw new Error(`Item ${itemId} not found in worklist`);
+        }
+        Object.assign(item, updates);
+        await this.save(worklist);
+    }
+    async markCompleted(itemId) {
+        await this.updateItem(itemId, {
+            status: 'completed',
+            completedAt: new Date().toISOString(),
+        });
+    }
+    async markFailed(itemId, error) {
+        await this.updateItem(itemId, {
+            status: 'failed',
+            error,
+        });
+    }
+    async getPendingItems() {
+        const worklist = await this.load();
+        if (!worklist) {
+            return [];
+        }
+        return worklist.items.filter(i => i.status === 'pending');
+    }
+    async getReadyItems() {
+        const worklist = await this.load();
+        if (!worklist) {
+            return [];
+        }
+        const completedIds = new Set(worklist.items.filter(i => i.status === 'completed').map(i => i.id));
+        return worklist.items.filter(item => {
+            if (item.status !== 'pending')
+                return false;
+            // Check if all dependencies are completed
+            return item.dependencies.every(dep => completedIds.has(dep));
+        });
+    }
+}
+//# sourceMappingURL=worklist-store.js.map

package/dist/storage/worklist-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worklist-store.js","sourceRoot":"","sources":["../../src/storage/worklist-store.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,4 +1,3 @@
-import { z } from 'zod';
 export interface WorkItem {
     id: number;
     title: string;
@@ -22,6 +21,8 @@ export interface AnalyzedIssue extends GitHubIssue {
     affectedPaths: string[];
     dependencies: number[];
     analyzedAt: string;
+    githubIssueNumber?: number;
+    noWorkNeeded?: boolean;
 }
 export declare function issueToWorkItem(issue: AnalyzedIssue): AnalyzedWorkItem;
 export type TaskStatus = 'queued' | 'blocked' | 'ready' | 'in-progress' | 'completed' | 'failed';
@@ -40,6 +41,7 @@ export interface RunState {
     createdAt: string;
     updatedAt: string;
     status: 'running' | 'completed' | 'failed' | 'interrupted';
+    mode?: 'plan' | 'github';
     baseBranch: string;
     runBranch: string;
     issues: AnalyzedIssue[];
@@ -56,75 +58,29 @@ export interface WorktreeInfo {
     branch: string;
     createdAt: string;
 }
-export declare const ConfigSchema: z.ZodObject<{
-    execution: z.ZodDefault<z.ZodObject<{
-        concurrency: z.ZodDefault<z.ZodNumber>;
-        baseBranch: z.ZodDefault<z.ZodString>;
-        maxBudgetPerIssue: z.ZodDefault<z.ZodNumber>;
-        maxTotalBudget: z.ZodDefault<z.ZodNumber>;
-        continueOnError: z.ZodDefault<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        concurrency: number;
-        baseBranch: string;
-        maxBudgetPerIssue: number;
-        maxTotalBudget: number;
-        continueOnError: boolean;
-    }, {
-        concurrency?: number | undefined;
-        baseBranch?: string | undefined;
-        maxBudgetPerIssue?: number | undefined;
-        maxTotalBudget?: number | undefined;
-        continueOnError?: boolean | undefined;
-    }>>;
-    pullRequests: z.ZodDefault<z.ZodObject<{
-        createAsDraft: z.ZodDefault<z.ZodBoolean>;
-        mergeStrategy: z.ZodDefault<z.ZodEnum<["merge", "squash", "rebase"]>>;
-        branchPrefix: z.ZodDefault<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        createAsDraft: boolean;
-        mergeStrategy: "merge" | "squash" | "rebase";
-        branchPrefix: string;
-    }, {
-        createAsDraft?: boolean | undefined;
-        mergeStrategy?: "merge" | "squash" | "rebase" | undefined;
-        branchPrefix?: string | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    execution: {
-        concurrency: number;
-        baseBranch: string;
-        maxBudgetPerIssue: number;
-        maxTotalBudget: number;
-        continueOnError: boolean;
-    };
-    pullRequests: {
-        createAsDraft: boolean;
-        mergeStrategy: "merge" | "squash" | "rebase";
-        branchPrefix: string;
-    };
-}, {
-    execution?: {
-        concurrency?: number | undefined;
-        baseBranch?: string | undefined;
-        maxBudgetPerIssue?: number | undefined;
-        maxTotalBudget?: number | undefined;
-        continueOnError?: boolean | undefined;
-    } | undefined;
-    pullRequests?: {
-        createAsDraft?: boolean | undefined;
-        mergeStrategy?: "merge" | "squash" | "rebase" | undefined;
-        branchPrefix?: string | undefined;
-    } | undefined;
-}>;
-export type Config = z.infer<typeof ConfigSchema>;
-export declare const MILLHOUSE_LABELS: {
-    readonly QUEUED: "millhouse:queued";
-    readonly IN_PROGRESS: "millhouse:in-progress";
-    readonly BLOCKED: "millhouse:blocked";
-    readonly FAILED: "millhouse:failed";
-    readonly DONE: "millhouse:done";
-};
-export type MillhouseLabel = typeof MILLHOUSE_LABELS[keyof typeof MILLHOUSE_LABELS];
+export type WorklistItemStatus = 'pending' | 'completed' | 'failed';
+export interface WorklistItem {
+    id: number;
+    title: string;
+    body: string;
+    dependencies: number[];
+    status: WorklistItemStatus;
+    githubIssueNumber?: number;
+    noWorkNeeded?: boolean;
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+}
+export interface Worklist {
+    version: 1;
+    createdAt: string;
+    updatedAt: string;
+    source: 'plan' | 'github';
+    title?: string;
+    description?: string;
+    indexIssueNumber?: number;
+    items: WorklistItem[];
+}
 export type SchedulerEvent = {
     type: 'task-started';
     issueNumber: number;
@@ -140,4 +96,17 @@ export type SchedulerEvent = {
     type: 'tasks-unblocked';
     issueNumbers: number[];
 };
+export interface JsonPlanItem {
+    id: number;
+    title: string;
+    body: string;
+    dependencies: number[];
+}
+export interface JsonPlan {
+    version: 1;
+    name?: string;
+    createdAt: string;
+    sourcePlan?: string;
+    items: JsonPlanItem[];
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,4 +1,6 @@
-import { z } from 'zod';
+// =============================================================================
+// Work Items (abstraction for both GitHub issues and local items)
+// =============================================================================
 // Convert AnalyzedIssue to AnalyzedWorkItem
 export function issueToWorkItem(issue) {
     return {
@@ -10,27 +12,4 @@ export function issueToWorkItem(issue) {
         analyzedAt: issue.analyzedAt,
     };
 }
-// Configuration schema
-export const ConfigSchema = z.object({
-    execution: z.object({
-        concurrency: z.number().min(1).max(16).default(8),
-        baseBranch: z.string().default('main'),
-        maxBudgetPerIssue: z.number().positive().default(5.0),
-        maxTotalBudget: z.number().positive().default(100.0),
-        continueOnError: z.boolean().default(true),
-    }).default({}),
-    pullRequests: z.object({
-        createAsDraft: z.boolean().default(true),
-        mergeStrategy: z.enum(['merge', 'squash', 'rebase']).default('squash'),
-        branchPrefix: z.string().default('millhouse/issue-'),
-    }).default({}),
-});
-// Millhouse labels
-export const MILLHOUSE_LABELS = {
-    QUEUED: 'millhouse:queued',
-    IN_PROGRESS: 'millhouse:in-progress',
-    BLOCKED: 'millhouse:blocked',
-    FAILED: 'millhouse:failed',
-    DONE: 'millhouse:done',
-};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0CxB,4CAA4C;AAC5C,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,MAAM;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC;AAgDD,uBAAuB;AACvB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QACtC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;QACrD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACpD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KAC3C,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACd,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACxC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;KACrD,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACf,CAAC,CAAC;AAIH,mBAAmB;AACnB,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,kBAAkB;IAC1B,WAAW,EAAE,uBAAuB;IACpC,OAAO,EAAE,mBAAmB;IAC5B,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,gBAAgB;CACd,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kEAAkE;AAClE,gFAAgF;AAwChF,4CAA4C;AAC5C,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,MAAM;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "millhouse",
-  "version": "0.3.5",
-  "description": "Orchestrate parallel Claude Code instances to implement GitHub issues or plan files",
+  "version": "1.0.1",
+  "description": "Orchestrate parallel Claude Code instances to implement work items",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -9,7 +9,6 @@
   },
   "files": [
     "dist",
-    "commands",
     "prompts"
   ],
   "scripts": {
@@ -36,7 +35,7 @@
     "commander": "^12.1.0",
     "graphlib": "^2.1.8",
     "ora": "^8.0.1",
-    "zod": "^3.23.0"
+    "string-width": "^8.1.0"
   },
   "devDependencies": {
     "@types/graphlib": "^2.1.12",

package/prompts/implementation.prompt.md

@@ -62,68 +62,67 @@ You are an expert software engineer implementing a specific task. Follow these s
 
 **DO NOT REPORT SUCCESS IF ANY TESTS FAIL OR ANY ACCEPTANCE CRITERIA ARE NOT MET.**
 
-### 5. Commit and Update Run Branch
+### 5. Commit Your Changes
 
-First, commit your changes on your issue branch:
+Stage and commit your changes on your issue branch:
 
 - Stage your changes with `git add <files>`
 - Create a single commit with a comprehensive message that includes:
   - A clear summary line describing the change
-  - A detailed body explaining:
-    - What was implemented
-    - Key files added or modified
-    - How acceptance criteria were satisfied
-    - Any important implementation decisions
+  - A detailed body explaining what was implemented
   - End with "Fixes #{{issue.number}}"
 
-Then, merge your changes INTO the run branch:
+### 6. CRITICAL: Merge Into Run Branch
+
+**⚠️ THIS STEP IS MANDATORY - YOUR WORK WILL BE LOST IF YOU SKIP IT ⚠️**
+
+You MUST run this exact script to merge your changes into the run branch. Copy and paste it exactly:
 
 ```bash
-# Loop until we successfully update the run branch
 while true; do
-  # Merge the latest run branch into your issue branch
-  git merge millhouse/run-{{runId}} --no-edit
-
-  # If there are merge conflicts, resolve them:
-  # - Carefully examine each conflict
-  # - Preserve both your changes and changes from other workers
-  # - Test that everything still works after resolving
-  # - Stage resolved files with: git add <resolved-files>
-  # - Complete the merge with: git commit --no-edit
-
-  # Update the run branch to point to your merged commit
-  # This will fail if another worker updated it since we merged
+  git merge millhouse/run-{{runId}} --no-edit || {
+    echo "Merge conflict - resolve and commit, then re-run this script"
+    exit 1
+  }
   if git push . HEAD:millhouse/run-{{runId}}; then
-    # Record the merge commit for verification
     git rev-parse HEAD > MILLHOUSE_MERGE_COMMIT
-    echo "Successfully updated run branch"
+    echo "SUCCESS: Changes merged into run branch"
     break
   fi
-
-  echo "Run branch was updated by another worker, merging again..."
+  echo "Retrying merge (another worker updated the branch)..."
 done
 ```
 
-**IMPORTANT**: You MUST successfully update the run branch before exiting. The orchestrator relies on this to collect all changes.
+**After running the script, verify:**
+1. You see "SUCCESS: Changes merged into run branch"
+2. The file `MILLHOUSE_MERGE_COMMIT` exists in your working directory
+
+If there are merge conflicts:
+1. Resolve each conflict carefully, preserving both your changes and others'
+2. Stage resolved files: `git add <resolved-files>`
+3. Complete the merge: `git commit --no-edit`
+4. Re-run the script above
+
+**DO NOT EXIT WITHOUT COMPLETING THIS STEP. The orchestrator verifies the MILLHOUSE_MERGE_COMMIT file exists.**
 
 ## Important Rules
 
-1. **You are working in a git worktree** on your own issue branch
+1. **⚠️ YOU MUST MERGE INTO THE RUN BRANCH BEFORE EXITING ⚠️**
+   - Run the merge script in Step 6 - this is NOT optional
+   - Verify MILLHOUSE_MERGE_COMMIT file exists before finishing
+   - If you skip this, ALL YOUR WORK WILL BE LOST
+
+2. **You are working in a git worktree** on your own issue branch
    - Your working directory is isolated from other parallel tasks
-   - After committing, you MUST merge your changes into the run branch `millhouse/run-{{runId}}`
+   - Other workers are running in parallel - merge conflicts are possible
 
-2. **Do NOT create a pull request**
+3. **Do NOT create a pull request**
    - The orchestrator handles PR creation after all tasks complete
    - Just commit your changes with proper messages
 
-3. **Stay focused on this task**
+4. **Stay focused on this task**
    - Don't fix unrelated problems you notice
    - Don't refactor code beyond what's needed for this task
-   - If you notice important problems, mention them in your summary
-
-4. **Handle blockers appropriately**
-   - If you encounter a blocker that requires human input, exit with an error
-   - Don't try to work around fundamental problems
 
 5. **Keep changes minimal**
    - Your changes will be merged with other parallel tasks

package/prompts/issue-analysis.prompt.md

@@ -1,4 +1,4 @@
-Analyze these GitHub issues and determine their dependencies and execution order.
+Analyze these GitHub issues to determine their dependencies and optimal execution order.
 
 ## Issues to Analyze
 
@@ -8,27 +8,61 @@ Analyze these GitHub issues and determine their dependencies and execution order
 
 ## Your Task
 
-Analyze each issue and determine:
+**DO NOT use TodoWrite, TaskCreate, or any task/todo tools. Only use Read, Glob, Grep, and Bash.**
+
+1. First, use Read, Glob, and Grep to explore the codebase structure
+2. Then analyze each issue semantically to determine dependencies
+
+For each issue determine:
 1. **dependencies**: Which issues MUST be completed BEFORE this issue can start
 2. **affectedPaths**: File paths this issue will likely create or modify
+3. **noWorkNeeded**: True if this is a meta/index issue that requires no actual code changes (e.g., tracking issues, index issues that just link to other issues, documentation-only issues)
+
+Also provide a summary title and description for this entire set of issues.
+
+## Dependency Analysis Guidelines
+
+Analyze the **semantic meaning** of each issue, not just explicit keywords. Consider:
+
+- **Explicit mentions**: "depends on #X", "after #X", "blocked by #X", "requires #X"
+- **Logical ordering**: If issue A creates something that issue B uses, B depends on A
+- **Feature flow**: Setup/infrastructure issues before features that use them
+- **Data dependencies**: Schema/model changes before code that uses those models
+- **API dependencies**: API endpoints before UI that calls them
+
+Issues written by humans may not have explicit dependency markers - use your understanding of software development to infer the correct order.
+
+---
+
+## Required Output Format
+
+After exploring the codebase, output ONLY a JSON object. No other text after the JSON.
+
+```json
+{
+  "title": "Short summary title for all issues (e.g. 'Add user authentication')",
+  "description": "A 1-2 sentence summary of what these issues accomplish together.",
+  "issues": [
+    {
+      "issueNumber": 1,
+      "dependencies": [],
+      "affectedPaths": ["src/path/to/file.ts"],
+      "noWorkNeeded": false
+    },
+    {
+      "issueNumber": 2,
+      "dependencies": [1],
+      "affectedPaths": ["src/other/file.ts"],
+      "noWorkNeeded": false
+    },
+    {
+      "issueNumber": 3,
+      "dependencies": [1, 2],
+      "affectedPaths": [],
+      "noWorkNeeded": true
+    }
+  ]
+}
+```
 
-Respond with ONLY a JSON array (no markdown, no explanation):
-[
-  {
-    "issueNumber": 1,
-    "dependencies": [],
-    "affectedPaths": ["src/path/to/file.ts"]
-  },
-  {
-    "issueNumber": 2,
-    "dependencies": [1],
-    "affectedPaths": ["src/other/file.ts"]
-  }
-]
-
-Rules:
-- Look for explicit dependency mentions: "depends on #X", "after #X", "blocked by #X", "requires #X"
-- Also infer logical dependencies (e.g., if issue B imports from a file that issue A creates)
-- Only include dependencies between issues in this list
-- affectedPaths should be specific file paths mentioned or implied
-- Respond with ONLY valid JSON, nothing else
+The JSON must be valid. Only include dependencies between issues in this list.

package/prompts/plan-analysis.prompt.md

@@ -1,4 +1,4 @@
-Analyze this plan and break it into discrete, implementable work items.
+Break this plan into discrete work items for parallel execution.
 
 ## Plan
 
@@ -8,38 +8,49 @@ Analyze this plan and break it into discrete, implementable work items.
 
 ## Your Task
 
-Break this plan into discrete work items that can be implemented independently (but may have dependencies on each other).
-
-For each work item, provide:
-1. **id**: Sequential number starting from 1
-2. **title**: Short descriptive title
-3. **body**: Full implementation details including:
-   - What to create/modify
-   - Specific file paths
-   - Function signatures or interfaces
-   - Testing instructions
-   - Acceptance criteria
-4. **dependencies**: IDs of work items that MUST be completed before this one
-
-Respond with ONLY a JSON array (no markdown, no explanation):
-[
-  {
-    "id": 1,
-    "title": "Initialize project",
-    "body": "Create the project structure...\n\n## Implementation\n...",
-    "dependencies": []
-  },
-  {
-    "id": 2,
-    "title": "Create utilities",
-    "body": "Create utility functions...\n\n**Depends on #1**\n\n## Implementation\n...",
-    "dependencies": [1]
-  }
-]
-
-Rules:
-- Each work item should be self-contained with all context needed to implement it
-- Include "**Depends on #N**" in the body text for any dependencies
-- Work items should be small enough to implement in one session
-- Include specific file paths, function signatures, and acceptance criteria
-- Respond with ONLY valid JSON, nothing else
+1. Use Read, Glob, and Grep tools to explore the codebase
+2. Output a JSON object with summary and work items
+
+**DO NOT use TodoWrite, TaskCreate, or any task/todo tools. Only use Read, Glob, Grep, and Bash.**
+
+## Context
+
+Work items will be executed by parallel Claude instances in isolated contexts. Each item must be completely self-contained with all information needed.
+
+## Work Item Guidelines
+
+- Each item should be completable in one session
+- Include exact file paths, function signatures, patterns to follow
+- Use `"dependencies": [1, 2]` for prerequisite items
+- Only add dependencies that are truly required
+
+---
+
+## Required Output Format
+
+After exploring the codebase, output ONLY a JSON object. No other text after the JSON.
+
+Use \n for newlines in body text. Keep body content concise.
+
+```json
+{
+  "title": "Short summary title for the whole plan (e.g. 'Add user authentication')",
+  "description": "A 1-2 sentence summary of what this plan accomplishes overall.",
+  "items": [
+    {
+      "id": 1,
+      "title": "Short title",
+      "body": "Implementation details. File: src/foo.ts. Pattern: follow existing style.",
+      "dependencies": []
+    },
+    {
+      "id": 2,
+      "title": "Another task",
+      "body": "More details here.",
+      "dependencies": [1]
+    }
+  ]
+}
+```
+
+The JSON must be valid. Use \n for newlines, escape quotes with backslash.