diff --git a/.claude/agents/action-planning-agent.md b/.claude/agents/action-planning-agent.md index 2766e80d..9c73b347 100644 --- a/.claude/agents/action-planning-agent.md +++ b/.claude/agents/action-planning-agent.md @@ -62,14 +62,16 @@ Break work into 3-5 logical implementation stages with: - Estimated complexity and time requirements ### 2. Implementation Plan Creation -Generate `IMPL_PLAN.md` in `.workflow/WFS-[session-id]/` directory: +Generate `IMPL_PLAN.md` using session context directory paths: +- **Session Context**: Use workflow directory path provided by workflow:execute - **Stage-Based Format**: Simple, linear tasks - **Hierarchical Format**: Complex tasks (>5 subtasks or >3 modules) +- **CRITICAL**: Always use session context paths, never assume default locations ### 3. Task Decomposition (Complex Projects) For tasks requiring >5 subtasks or spanning >3 modules: - Create detailed task breakdown and tracking -- Generate TODO_LIST.md for progress monitoring +- Generate TODO_LIST.md for progress monitoring using provided session context paths - Use hierarchical structure (max 3 levels) ### 4. Document Generation diff --git a/.claude/agents/code-developer.md b/.claude/agents/code-developer.md index 47099579..dcc7b49c 100644 --- a/.claude/agents/code-developer.md +++ b/.claude/agents/code-developer.md @@ -90,13 +90,20 @@ Follow unified Gemini CLI guidelines: @~/.claude/workflows/gemini-unified.md - Functionality works as specified 2. **Update TODO List**: - - Update TODO_LIST.md in workflow directory (.workflow/WFS-[session-id]/) + - Update TODO_LIST.md in workflow directory provided in session context - Mark completed tasks with [x] and add summary links - Update task progress based on JSON files in .task/ directory + - **CRITICAL**: Use session context paths provided by workflow:execute + + **Session Context Usage**: + - Always receive workflow directory path from agent prompt + - Use provided TODO_LIST Location for updates + - Create summaries in provided Summaries Directory + - Update task JSON in provided Task JSON Location **Project Structure Understanding**: ``` - .workflow/WFS-[session-id]/ + .workflow/WFS-[session-id]/ # (Path provided in session context) ├── TODO_LIST.md # Progress tracking document ├── .task/impl-*.json # Task definitions (source of truth) └── .summaries/IMPL-*.md # Task completion summaries @@ -116,7 +123,12 @@ Follow unified Gemini CLI guidelines: @~/.claude/workflows/gemini-unified.md - [ ] **IMPL-001.2**: API endpoints → [📋](./.task/impl-001.2.json) ``` -3. **Generate Summary** (if .workflow directory exists): +3. **Generate Summary** (using session context paths): + - **MANDATORY**: Create summary in provided Summaries Directory + - Use exact paths from session context (e.g., `.workflow/WFS-[session-id]/.summaries/`) + - Link summary in TODO_LIST.md using relative path + + **Summary Template**: ```markdown # Task: [Task-ID] [Name] @@ -127,6 +139,11 @@ Follow unified Gemini CLI guidelines: @~/.claude/workflows/gemini-unified.md ## Status: ✅ Complete ``` + + **Auto-Check Workflow Context**: + - Verify session context paths are provided in agent prompt + - If missing, request session context from workflow:execute + - Never assume default paths without explicit session context ### 5. Problem-Solving diff --git a/.claude/agents/code-review-test-agent.md b/.claude/agents/code-review-test-agent.md index e7b7b071..d52b0e14 100644 --- a/.claude/agents/code-review-test-agent.md +++ b/.claude/agents/code-review-test-agent.md @@ -166,7 +166,7 @@ if [FAST_MODE]: apply targeted review process **When completing code review:** -1. **Generate Review Summary Document**: Create comprehensive review summary in current workflow directory `.workflow/WFS-[session-id]/.summaries/` directory: +1. **Generate Review Summary Document**: Create comprehensive review summary using session context paths (provided summaries directory): ```markdown # Review Summary: [Task-ID] [Review Name] @@ -213,13 +213,13 @@ if [FAST_MODE]: apply targeted review process - [📋 Implementation Plan](../IMPL_PLAN.md#[Task-ID]) ``` -2. **Update TODO_LIST.md**: After generating review summary, update the corresponding task item in current workflow directory: +2. **Update TODO_LIST.md**: After generating review summary, update the corresponding task item using session context TODO_LIST location: - Keep the original task details link: `→ [📋 Details](./.task/[Task-ID].json)` - Add review summary link after pipe separator: `| [✅ Review](./.summaries/[Task-ID]-review.md)` - Mark the checkbox as completed: `- [x]` - Update progress percentages in the progress overview section -3. **Update Session Tracker**: Update `.workflow/WFS-[session-id]/workflow-session.json` with review completion: +3. **Update Session Tracker**: Update workflow-session.json using session context workflow directory: - Mark review task as completed in task_system section - Update overall progress statistics in coordination section - Update last modified timestamp @@ -268,8 +268,8 @@ Structure your review as: - [ ] Rejected (critical issues) ### Next Steps -1. Generate review summary document in `.workflow/WFS-[session-id]/.summaries/` -2. Update TODO_LIST.md with review completion and summary link +1. Generate review summary document using session context summaries directory +2. Update TODO_LIST.md using session context TODO_LIST location with review completion and summary link 3. Mark task as completed in progress tracking ``` @@ -321,9 +321,9 @@ When escalating, provide: ## Important Reminders **ALWAYS:** -- Complete review summary documentation after each review -- Update TODO_LIST.md with progress and summary links -- Generate review summaries in `.workflow/WFS-[session-id]/.summaries/` +- Complete review summary documentation after each review using session context paths +- Update TODO_LIST.md using session context location with progress and summary links +- Generate review summaries in session context summaries directory - Balance thoroughness with pragmatism - Provide constructive, actionable feedback - Implement or recommend tests for all code changes diff --git a/.claude/commands/task/execute.md b/.claude/commands/task/execute.md index c0a92c2e..b97f0791 100644 --- a/.claude/commands/task/execute.md +++ b/.claude/commands/task/execute.md @@ -65,6 +65,7 @@ END FUNCTION - **Validation**: Checks for the task's JSON file in `.task/` and resolves its dependencies. - **Context Preparation**: Loads task and workflow context, preparing it for the selected agent. +- **Session Context Injection**: Provides workflow directory paths to agents for TODO_LIST.md and summary management. - **TodoWrite Coordination**: Generates execution Todos and checkpoints, syncing with `TODO_LIST.md`. ### 🏁 **Post-Execution Protocol** @@ -199,7 +200,13 @@ This is the simplified data structure loaded to provide context for task executi }, "workflow": { "session": "WFS-user-auth", - "phase": "IMPLEMENT" + "phase": "IMPLEMENT", + "session_context": { + "workflow_directory": ".workflow/WFS-user-auth/", + "todo_list_location": ".workflow/WFS-user-auth/TODO_LIST.md", + "summaries_directory": ".workflow/WFS-user-auth/.summaries/", + "task_json_location": ".workflow/WFS-user-auth/.task/" + } }, "execution": { "agent": "code-developer", diff --git a/.claude/commands/workflow/execute.md b/.claude/commands/workflow/execute.md index f7a6e3fd..f0980dac 100644 --- a/.claude/commands/workflow/execute.md +++ b/.claude/commands/workflow/execute.md @@ -146,6 +146,12 @@ Task(subagent_type="code-developer", prompt="[GEMINI_CLI_REQUIRED] Implement authentication logic based on schema Task Context: impl-1.2 - Implement auth logic + Session Context: + - Workflow Directory: .workflow/WFS-user-auth/ + - TODO_LIST Location: .workflow/WFS-user-auth/TODO_LIST.md + - Summaries Directory: .workflow/WFS-user-auth/.summaries/ + - Task JSON Location: .workflow/WFS-user-auth/.task/impl-1.2.json + Implementation Details: - Target File: src/auth/models/User.ts - Function: UserSchema (lines 10-50) @@ -156,6 +162,7 @@ Task(subagent_type="code-developer", - Risks: Schema changes require database migration, Existing user data compatibility - Performance: Index JWT fields for faster lookups + IMPORTANT: Update TODO_LIST.md and create summary in provided directories upon completion. Use implementation details above for precise, targeted development.", description="Execute impl-1.2 with full workflow context and implementation details") ``` @@ -218,7 +225,14 @@ Task(subagent_type="code-developer", - Requirements: JWT authentication, OAuth2 support - Scope: src/auth/*, tests/auth/* - Dependencies: impl-1.1 (completed) - - Workflow: WFS-user-auth authentication system", + - Workflow: WFS-user-auth authentication system + + Session Context: + - Workflow Directory: .workflow/WFS-user-auth/ + - TODO_LIST Location: .workflow/WFS-user-auth/TODO_LIST.md + - Summaries Directory: .workflow/WFS-user-auth/.summaries/ + + CRITICAL: Update TODO_LIST.md and create completion summary using provided paths.", description="Agent executes with full discovered context") ```