docs: update workflow plan to enhance automation and clarify quality gate process

This commit is contained in:
catlog22
2025-10-24 11:14:34 +08:00
parent 57fa379e45
commit 1f070638b4

View File

@@ -13,20 +13,19 @@ allowed-tools: SlashCommand(*), TodoWrite(*), Read(*), Bash(*)
**Execution Model - Auto-Continue Workflow with Quality Gate**: **Execution Model - Auto-Continue Workflow with Quality Gate**:
This workflow runs **mostly autonomously** once triggered, with one interactive quality gate (Phase 3.5). Phase 3 (conflict resolution) and Phase 4 (task generation) are delegated to specialized agents. This workflow runs **fully autonomously** once triggered. Phase 3 (conflict resolution) and Phase 4 (task generation) are delegated to specialized agents.
1. **User triggers**: `/workflow:plan "task"` 1. **User triggers**: `/workflow:plan "task"`
2. **Phase 1 executes** → Session discovery → Auto-continues 2. **Phase 1 executes** → Session discovery → Auto-continues
3. **Phase 2 executes** → Context gathering → Auto-continues 3. **Phase 2 executes** → Context gathering → Auto-continues
4. **Phase 3 executes** (optional, if conflict_risk ≥ medium) → Conflict resolution → Auto-continues 4. **Phase 3 executes** (optional, if conflict_risk ≥ medium) → Conflict resolution → Auto-continues
5. **Phase 3.5 executes** **Pauses for user Q&A** → User answers clarification questions → Auto-continues 5. **Phase 4 executes** (task-generate-agent if --agent) → Task generation → Reports final summary
6. **Phase 4 executes** (task-generate-agent if --agent) → Task generation → Reports final summary
**Auto-Continue Mechanism**: **Auto-Continue Mechanism**:
- TodoList tracks current phase status - TodoList tracks current phase status
- After each phase completion, automatically executes next pending phase - After each phase completion, automatically executes next pending phase
- **Phase 3.5 requires user interaction** - answers clarification questions (up to 5) - All phases run autonomously without user interaction (clarification handled in brainstorm phase)
- If no ambiguities found, Phase 3.5 auto-skips and continues to Phase 4
- Progress updates shown at each phase for visibility - Progress updates shown at each phase for visibility
**Execution Modes**: **Execution Modes**:
@@ -132,35 +131,22 @@ CONTEXT: Existing user database schema, REST API endpoints
--- ---
### Phase 3.5: Concept Clarification (Quality Gate) ### Phase 3.5: Pre-Task Generation Validation (Optional Quality Gate)
**Command**: `SlashCommand(command="/workflow:concept-clarify --session [sessionId]")` **Purpose**: Optional quality gate before task generation - primarily handled by brainstorm synthesis phase
**Purpose**: Quality gate to verify and clarify analysis results before task generation **Note**: Concept enhancement and clarification are now handled in `/workflow:brainstorm:synthesis` Phase 2.5 during brainstorming. This phase is reserved for future validation extensions.
**Input**: `sessionId` from Phase 1 **Current Behavior**: Auto-skip to Phase 4 (Task Generation)
**Behavior**: **Future Enhancement**: Could add additional validation steps like:
- Auto-detects plan mode (ANALYSIS_RESULTS.md exists if Phase 3 executed) - Cross-reference checks between conflict resolution and brainstorm analyses
- Interactively asks up to 5 targeted questions to resolve ambiguities - Final sanity checks before task generation
- Updates ANALYSIS_RESULTS.md with clarifications (if file exists from Phase 3) - User confirmation prompt for proceeding
- Pauses workflow for user input (breaks auto-continue temporarily)
**Parse Output**: **TodoWrite**: Mark phase 3.5 completed (auto-skip), phase 4 in_progress
- Verify clarifications added to ANALYSIS_RESULTS.md (if Phase 3 executed)
- Check recommendation: "PROCEED" or "ADDRESS_OUTSTANDING"
**Validation**: **After Phase 3.5**: Auto-continue to Phase 4 immediately
- If Phase 3 executed: ANALYSIS_RESULTS.md updated with `## Clarifications` section
- All critical ambiguities resolved or documented as outstanding
**TodoWrite**: Mark phase 3.5 completed, phase 4 in_progress
**After Phase 3.5**: Return to user showing clarification summary, then auto-continue to Phase 4
**Skip Conditions**:
- If `/workflow:concept-clarify` reports "No critical ambiguities detected", automatically proceed to Phase 4
- User can skip by responding "skip" or "proceed" immediately
--- ---
@@ -219,12 +205,11 @@ Plan: .workflow/[sessionId]/IMPL_PLAN.md
```javascript ```javascript
// Initialize (before Phase 1) // Initialize (before Phase 1)
// Note: Phase 3 todo only included when conflict_risk ≥ medium (determined after Phase 2) // Note: Phase 3 todo only added dynamically after Phase 2 if conflict_risk ≥ medium
TodoWrite({todos: [ TodoWrite({todos: [
{"content": "Execute session discovery", "status": "in_progress", "activeForm": "Executing session discovery"}, {"content": "Execute session discovery", "status": "in_progress", "activeForm": "Executing session discovery"},
{"content": "Execute context gathering", "status": "pending", "activeForm": "Executing context gathering"}, {"content": "Execute context gathering", "status": "pending", "activeForm": "Executing context gathering"},
// Phase 3 todo added dynamically after Phase 2 if conflict_risk ≥ medium // Phase 3 todo added dynamically after Phase 2 if conflict_risk ≥ medium
{"content": "Execute concept clarification", "status": "pending", "activeForm": "Executing concept clarification"},
{"content": "Execute task generation", "status": "pending", "activeForm": "Executing task generation"} {"content": "Execute task generation", "status": "pending", "activeForm": "Executing task generation"}
]}) ]})
@@ -233,19 +218,23 @@ TodoWrite({todos: [
{"content": "Execute session discovery", "status": "completed", "activeForm": "Executing session discovery"}, {"content": "Execute session discovery", "status": "completed", "activeForm": "Executing session discovery"},
{"content": "Execute context gathering", "status": "completed", "activeForm": "Executing context gathering"}, {"content": "Execute context gathering", "status": "completed", "activeForm": "Executing context gathering"},
{"content": "Execute conflict resolution", "status": "in_progress", "activeForm": "Executing conflict resolution"}, {"content": "Execute conflict resolution", "status": "in_progress", "activeForm": "Executing conflict resolution"},
{"content": "Execute concept clarification", "status": "pending", "activeForm": "Executing concept clarification"},
{"content": "Execute task generation", "status": "pending", "activeForm": "Executing task generation"} {"content": "Execute task generation", "status": "pending", "activeForm": "Executing task generation"}
]}) ]})
// After Phase 2 (if conflict_risk is none/low, skip Phase 3) // After Phase 2 (if conflict_risk is none/low, skip Phase 3, go directly to Phase 4)
TodoWrite({todos: [ TodoWrite({todos: [
{"content": "Execute session discovery", "status": "completed", "activeForm": "Executing session discovery"}, {"content": "Execute session discovery", "status": "completed", "activeForm": "Executing session discovery"},
{"content": "Execute context gathering", "status": "completed", "activeForm": "Executing context gathering"}, {"content": "Execute context gathering", "status": "completed", "activeForm": "Executing context gathering"},
{"content": "Execute concept clarification", "status": "in_progress", "activeForm": "Executing concept clarification"}, {"content": "Execute task generation", "status": "in_progress", "activeForm": "Executing task generation"}
{"content": "Execute task generation", "status": "pending", "activeForm": "Executing task generation"}
]}) ]})
// Continue pattern for Phase 3 (if executed), 3.5, 4... // After Phase 3 (if executed), continue to Phase 4
TodoWrite({todos: [
{"content": "Execute session discovery", "status": "completed", "activeForm": "Executing session discovery"},
{"content": "Execute context gathering", "status": "completed", "activeForm": "Executing context gathering"},
{"content": "Execute conflict resolution", "status": "completed", "activeForm": "Executing conflict resolution"},
{"content": "Execute task generation", "status": "in_progress", "activeForm": "Executing task generation"}
]})
``` ```
## Input Processing ## Input Processing
@@ -300,12 +289,7 @@ Phase 3: conflict-resolution [AUTO-TRIGGERED if conflict_risk ≥ medium]
↓ Input: sessionId + contextPath + conflict_risk ↓ Input: sessionId + contextPath + conflict_risk
↓ CLI-powered conflict detection and resolution strategy generation ↓ CLI-powered conflict detection and resolution strategy generation
↓ Output: CONFLICT_RESOLUTION.md (if conflict_risk ≥ medium) ↓ Output: CONFLICT_RESOLUTION.md (if conflict_risk ≥ medium)
↓ Skip if conflict_risk is none/low ↓ Skip if conflict_risk is none/low → proceed directly to Phase 4
Phase 3.5: concept-clarify --session sessionId (Quality Gate)
↓ Input: sessionId + CONFLICT_RESOLUTION.md (if Phase 3 executed)
↓ Interactive: User answers clarification questions
↓ Output: Updated clarifications
Phase 4: task-generate[--agent] --session sessionId Phase 4: task-generate[--agent] --session sessionId
↓ Input: sessionId + conflict resolution decisions (if exists) + session memory ↓ Input: sessionId + conflict resolution decisions (if exists) + session memory
@@ -344,11 +328,7 @@ Return summary to user
✅ **Extract conflict_risk from context-package.json**: Determine Phase 3 execution ✅ **Extract conflict_risk from context-package.json**: Determine Phase 3 execution
✅ **If conflict_risk ≥ medium**: Launch Phase 3 conflict-resolution with sessionId and contextPath ✅ **If conflict_risk ≥ medium**: Launch Phase 3 conflict-resolution with sessionId and contextPath
✅ Wait for Phase 3 completion (if executed), verify CONFLICT_RESOLUTION.md created ✅ Wait for Phase 3 completion (if executed), verify CONFLICT_RESOLUTION.md created
✅ **If conflict_risk is none/low**: Skip Phase 3, proceed directly to Phase 3.5 ✅ **If conflict_risk is none/low**: Skip Phase 3, proceed directly to Phase 4
✅ **Execute Phase 3.5**: Pass session ID to `/workflow:concept-clarify`
✅ Wait for user interaction (clarification Q&A)
✅ Verify clarifications completed
✅ Check recommendation: proceed if "PROCEED", otherwise alert user
✅ **Build Phase 4 command** based on flags: ✅ **Build Phase 4 command** based on flags:
- Base command: `/workflow:tools:task-generate` (or `-agent` if `--agent` flag) - Base command: `/workflow:tools:task-generate` (or `-agent` if `--agent` flag)
- Add `--session [sessionId]` - Add `--session [sessionId]`