You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[BUGFIX-Y] Step 5: Implement the Solution - Use builder agent from specifications
110
+
[BUGFIX-Y] Step 16: Review the PR - MANDATORY code review
106
111
...
107
112
```
108
113
@@ -114,8 +119,45 @@ This step-based structure helps users understand:
114
119
115
120
## The Workflow
116
121
122
+
### Step 0: Workflow Preparation (MANDATORY - DO NOT SKIP)
123
+
124
+
**CRITICAL: This step MUST be completed before ANY implementation work begins.**
125
+
126
+
**Why This Step Exists:**
127
+
128
+
Agents that skip workflow steps (especially mandatory review steps 10, 16-17) create quality issues and erode user trust. This step ensures agents track ALL steps from the start, preventing "completion bias" where agents feel done after implementation but before review.
129
+
130
+
**Root Cause Prevention:**
131
+
132
+
-**Completion Bias**: Agents often consider "PR created" as task completion
133
+
-**Context Decay**: After heavy implementation, agents lose sight of remaining steps
134
+
-**Autonomy Misapplication**: Being autonomous means making implementation decisions independently, NOT skipping mandatory process steps
135
+
136
+
**Checklist:**
137
+
138
+
-[ ]**Read this entire workflow file** - Understand all 22 steps (0-21) before starting
139
+
-[ ]**Create TodoWrite entries for ALL steps (0-21)** using format: `Step N: [Step Name] - [Specific Action]`
140
+
-[ ]**Mark each step complete ONLY when truly done** - No premature completion
141
+
-[ ]**Task is NOT complete until Step 21 is marked complete**
142
+
143
+
**Self-Verification:** Before proceeding to Step 1, confirm you have 22 todo items visible (Steps 0-21).
144
+
145
+
**Anti-Pattern Prevention:**
146
+
147
+
- ❌ DO NOT skip to implementation after reading requirements
148
+
- ❌ DO NOT consider "PR created" as completion (Step 21 is the completion point)
149
+
- ❌ DO NOT omit Steps 10, 16-17 (mandatory review steps)
150
+
- ❌ DO NOT declare task complete with pending steps
151
+
- ✅ DO create all step todos BEFORE starting any implementation
152
+
- ✅ DO mark steps complete sequentially as you finish them
153
+
- ✅ DO track every mandatory step in TodoWrite
154
+
155
+
**Reference Issue:** This step was added after Issue #1607 identified workflow step skipping as a recurring problem.
156
+
117
157
### Step 1: Prepare the Workspace
118
158
159
+
**Prerequisite Check:** Verify Step 0 is complete - you should have 22 todos visible (Steps 0-21) before proceeding.
160
+
119
161
-[ ] start with a clean local environment and make sure it is up to date (no unstashed changes, git fetch)
0 commit comments