diff options
Diffstat (limited to 'src/main/claude/phases.ts')
| -rw-r--r-- | src/main/claude/phases.ts | 55 |
1 files changed, 18 insertions, 37 deletions
diff --git a/src/main/claude/phases.ts b/src/main/claude/phases.ts index 6678c08..f1df719 100644 --- a/src/main/claude/phases.ts +++ b/src/main/claude/phases.ts | |||
| @@ -10,9 +10,9 @@ export interface PhaseConfig { | |||
| 10 | initialMessage: string; | 10 | initialMessage: string; |
| 11 | } | 11 | } |
| 12 | 12 | ||
| 13 | // Get session-specific artifact path | 13 | // Get session-specific artifact path (relative to ~/.claude-flow/) |
| 14 | export function getSessionArtifactDir(sessionId: string): string { | 14 | export function getSessionArtifactDir(sessionId: string): string { |
| 15 | return `.claude-flow/sessions/${sessionId}`; | 15 | return `sessions/${sessionId}`; |
| 16 | } | 16 | } |
| 17 | 17 | ||
| 18 | export function getArtifactPath(phase: Phase, sessionId: string): string { | 18 | export function getArtifactPath(phase: Phase, sessionId: string): string { |
| @@ -30,7 +30,7 @@ export const phaseConfigs: Record<Phase, PhaseConfig> = { | |||
| 30 | systemPrompt: `You are in RESEARCH mode. Your ONLY job is to understand the codebase. | 30 | systemPrompt: `You are in RESEARCH mode. Your ONLY job is to understand the codebase. |
| 31 | 31 | ||
| 32 | CRITICAL RULES: | 32 | CRITICAL RULES: |
| 33 | 1. You MUST write ALL findings to \`.claude-flow/sessions/{sessionId}/research.md\` — this is your PRIMARY output | 33 | 1. You MUST write ALL findings to the session research.md — this is your PRIMARY output |
| 34 | 2. DO NOT just respond in chat. The document viewer shows research.md, so write there. | 34 | 2. DO NOT just respond in chat. The document viewer shows research.md, so write there. |
| 35 | 3. DO NOT suggest moving to planning or implementation | 35 | 3. DO NOT suggest moving to planning or implementation |
| 36 | 4. DO NOT ask "are you ready to implement?" or similar | 36 | 4. DO NOT ask "are you ready to implement?" or similar |
| @@ -38,16 +38,15 @@ CRITICAL RULES: | |||
| 38 | 6. The user controls phase transitions via UI buttons — never prompt them about it | 38 | 6. The user controls phase transitions via UI buttons — never prompt them about it |
| 39 | 39 | ||
| 40 | CONTEXT: | 40 | CONTEXT: |
| 41 | - You are in a git worktree at \`.claude-flow/worktrees/{sessionId}/\` | 41 | - Read CLAUDE.md in the project root (if it exists) for codebase overview |
| 42 | - Read CLAUDE.md in the project root for shared codebase overview | ||
| 43 | - If CLAUDE.md doesn't exist, create it with your initial findings | ||
| 44 | - This file contains general architecture info shared across all sessions | 42 | - This file contains general architecture info shared across all sessions |
| 43 | - If CLAUDE.md doesn't exist, create it with your initial findings | ||
| 45 | 44 | ||
| 46 | WORKFLOW: | 45 | WORKFLOW: |
| 47 | 1. Read CLAUDE.md (create at project root if missing) | 46 | 1. Read CLAUDE.md (create at project root if missing) |
| 48 | 2. Ask what to research (if unclear) | 47 | 2. Ask what to research (if unclear) |
| 49 | 3. Read files thoroughly using Read, Glob, Grep | 48 | 3. Read files thoroughly using Read, Glob, Grep |
| 50 | 4. Write findings to \`.claude-flow/sessions/{sessionId}/research.md\` | 49 | 4. Write findings to session research.md |
| 51 | 5. Update CLAUDE.md with any new general insights worth sharing | 50 | 5. Update CLAUDE.md with any new general insights worth sharing |
| 52 | 51 | ||
| 53 | FORMAT for research.md: | 52 | FORMAT for research.md: |
| @@ -70,7 +69,7 @@ FORMAT for research.md: | |||
| 70 | [Things that need clarification] | 69 | [Things that need clarification] |
| 71 | \`\`\` | 70 | \`\`\` |
| 72 | 71 | ||
| 73 | Remember: Your output goes in \`.claude-flow/sessions/{sessionId}/research.md\`, not chat. Chat is for clarifying questions only.`, | 72 | Remember: Your output goes in research.md, not chat. Chat is for clarifying questions only.`, |
| 74 | }, | 73 | }, |
| 75 | 74 | ||
| 76 | plan: { | 75 | plan: { |
| @@ -81,7 +80,7 @@ Remember: Your output goes in \`.claude-flow/sessions/{sessionId}/research.md\`, | |||
| 81 | systemPrompt: `You are in PLANNING mode. Your ONLY job is to create an implementation plan. | 80 | systemPrompt: `You are in PLANNING mode. Your ONLY job is to create an implementation plan. |
| 82 | 81 | ||
| 83 | CRITICAL RULES: | 82 | CRITICAL RULES: |
| 84 | 1. You MUST write the plan to \`.claude-flow/sessions/{sessionId}/plan.md\` — this is your PRIMARY output | 83 | 1. You MUST write the plan to session plan.md — this is your PRIMARY output |
| 85 | 2. DO NOT just respond in chat. The document viewer shows plan.md, so write there. | 84 | 2. DO NOT just respond in chat. The document viewer shows plan.md, so write there. |
| 86 | 3. DO NOT implement anything — no code changes to source files | 85 | 3. DO NOT implement anything — no code changes to source files |
| 87 | 4. DO NOT ask "should I start implementing?" or similar | 86 | 4. DO NOT ask "should I start implementing?" or similar |
| @@ -89,14 +88,13 @@ CRITICAL RULES: | |||
| 89 | 6. Base your plan on the session research.md and CLAUDE.md | 88 | 6. Base your plan on the session research.md and CLAUDE.md |
| 90 | 89 | ||
| 91 | CONTEXT: | 90 | CONTEXT: |
| 92 | - You are in a git worktree at \`.claude-flow/worktrees/{sessionId}/\` | ||
| 93 | - Read CLAUDE.md at project root for codebase overview | 91 | - Read CLAUDE.md at project root for codebase overview |
| 94 | - Read \`.claude-flow/sessions/{sessionId}/research.md\` for this specific task | 92 | - Read the session research.md to understand the specific task |
| 95 | 93 | ||
| 96 | WORKFLOW: | 94 | WORKFLOW: |
| 97 | 1. Read CLAUDE.md for codebase overview | 95 | 1. Read CLAUDE.md for codebase overview |
| 98 | 2. Read the session research.md to understand the specific task | 96 | 2. Read the session research.md to understand the specific task |
| 99 | 3. Write a detailed plan to \`.claude-flow/sessions/{sessionId}/plan.md\` | 97 | 3. Write a detailed plan to session plan.md |
| 100 | 4. Include specific code snippets showing proposed changes | 98 | 4. Include specific code snippets showing proposed changes |
| 101 | 5. Make the plan detailed enough that implementation is mechanical | 99 | 5. Make the plan detailed enough that implementation is mechanical |
| 102 | 100 | ||
| @@ -134,47 +132,30 @@ FORMAT for plan.md: | |||
| 134 | 132 | ||
| 135 | When the user adds annotations to plan.md and clicks Review, address each annotation and update the document. | 133 | When the user adds annotations to plan.md and clicks Review, address each annotation and update the document. |
| 136 | 134 | ||
| 137 | Remember: Your output goes in \`.claude-flow/sessions/{sessionId}/plan.md\`, not chat. Chat is for clarifying questions only.`, | 135 | Remember: Your output goes in plan.md, not chat. Chat is for clarifying questions only.`, |
| 138 | }, | 136 | }, |
| 139 | 137 | ||
| 140 | implement: { | 138 | implement: { |
| 141 | permissionMode: "acceptEdits", | 139 | permissionMode: "acceptEdits", |
| 142 | tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"], | 140 | tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"], |
| 143 | initialMessage: | 141 | initialMessage: |
| 144 | "Starting implementation. I'll follow the plan exactly, commit as I go, and mark tasks complete.", | 142 | "Starting implementation. I'll follow the plan exactly and mark tasks complete as I go.", |
| 145 | systemPrompt: `You are in IMPLEMENTATION mode. Execute the approved plan. | 143 | systemPrompt: `You are in IMPLEMENTATION mode. Execute the approved plan. |
| 146 | 144 | ||
| 147 | CRITICAL RULES: | 145 | CRITICAL RULES: |
| 148 | 1. Read \`.claude-flow/sessions/{sessionId}/plan.md\` and follow it exactly | 146 | 1. Read session plan.md and follow it exactly |
| 149 | 2. Mark tasks complete in plan.md as you finish them: - [ ] → - [x] | 147 | 2. Mark tasks complete in plan.md as you finish them: - [ ] → - [x] |
| 150 | 3. DO NOT deviate from the plan without asking | 148 | 3. DO NOT deviate from the plan without asking |
| 151 | 4. Run tests/typecheck if available | 149 | 4. Run tests/typecheck if available |
| 152 | 5. Make git commits as you complete logical chunks of work | 150 | 5. Stop and ask if you encounter issues not covered by the plan |
| 153 | 6. Stop and ask if you encounter issues not covered by the plan | ||
| 154 | |||
| 155 | CONTEXT: | ||
| 156 | - You are in a git worktree at \`.claude-flow/worktrees/{sessionId}/\` | ||
| 157 | - This is an isolated branch: \`claude-flow/{sessionId}\` | ||
| 158 | - Your commits will not affect the main branch until merged | ||
| 159 | - The user can review your work in this worktree before accepting | ||
| 160 | 151 | ||
| 161 | WORKFLOW: | 152 | WORKFLOW: |
| 162 | 1. Read \`.claude-flow/sessions/{sessionId}/plan.md\` | 153 | 1. Read session plan.md |
| 163 | 2. Execute each task in order | 154 | 2. Execute each task in order |
| 164 | 3. Update plan.md to mark tasks complete | 155 | 3. Update plan.md to mark tasks complete |
| 165 | 4. Make git commits with clear messages as you finish chunks | 156 | 4. Continue until all tasks are done |
| 166 | 5. Continue until all tasks are done | 157 | |
| 167 | 158 | When complete, summarize what was done and any follow-up tasks.`, | |
| 168 | COMMIT GUIDELINES: | ||
| 169 | - Commit after completing logical units of work | ||
| 170 | - Use clear commit messages (e.g., "Add user authentication middleware") | ||
| 171 | - Don't commit broken or incomplete code | ||
| 172 | - Update CLAUDE.md at project root if you discover important architecture info | ||
| 173 | |||
| 174 | When complete, summarize what was done and tell the user how to review: | ||
| 175 | - The work is in worktree: \`.claude-flow/worktrees/{sessionId}/\` | ||
| 176 | - Branch: \`claude-flow/{sessionId}\` | ||
| 177 | - They can review, then merge or discard as needed`, | ||
| 178 | }, | 159 | }, |
| 179 | }; | 160 | }; |
| 180 | 161 | ||
