Skip to content

Commit 9acd8eb

Browse files
committed
feat: enforce sequential workflow in Quick extension
Add mandatory enforcement checkpoints to prevent AI from: - Skipping Mission Brief and context collection phases - Reading files without approved context - Auto-proceeding through workflow phases - Defaulting to file analysis mode Changes: implement.md: - Add ENFORCEMENT MODE section with critical rules - Add 7 enforcement checkpoints with mandatory stops - Change directive language from permissive to mandatory - Add STOP_UNTIL markers for user confirmations - Remove auto-proceed behavior throughout workflow - Strengthen language: Ask Questions FIRST → MUST ask questions README.md: - Document enforcement mode feature - Add execution flow with checkpoint breakdown - Explain enforcement guarantees and phase rules This prevents AI from skipping workflow and ensures Quick extension contract is followed correctly.
1 parent b8ea251 commit 9acd8eb

2 files changed

Lines changed: 201 additions & 104 deletions

File tree

extensions/quick/README.md

Lines changed: 47 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,16 @@ Mission Brief → Context Discovery → Plan Generation → Task Breakdown → E
1212

1313
**No file artifacts are created** - everything happens in the conversation with your AI agent.
1414

15+
### Enforcement Mode
16+
17+
Quick uses **strict enforcement checkpoints** to ensure the workflow is followed correctly:
18+
- **7 enforcement checkpoints** (**⚠️**) with mandatory user confirmations
19+
- **Sequential execution only** - No phase can be skipped
20+
- **Stop-and-wait** - AI pauses at each checkpoint for user approval
21+
- **No auto-proceed** - Every phase requires explicit user confirmation
22+
23+
This prevents the AI from skipping phases or defaulting to file analysis mode.
24+
1525
## Quick Start
1626

1727
```bash
@@ -20,25 +30,28 @@ Mission Brief → Context Discovery → Plan Generation → Task Breakdown → E
2030

2131
## How It Works
2232

23-
### Phase 1: Mission Brief
33+
### Phase 1: Mission Brief (⚠️ Enforcement Checkpoint)
2434
Quick asks 2-3 questions to understand what you're doing:
2535
- What needs to be done?
2636
- What defines success?
2737
- Any constraints?
2838

2939
**Approval #1**: You see the Mission Brief and confirm before proceeding.
40+
- **⚠️ Mandatory stop**: AI waits for "yes" confirmation
3041

31-
### Phase 2: Context Discovery
42+
### Phase 2: Context Discovery (⚠️ Enforcement Checkpoint)
3243
You provide any relevant context:
3344
- Project files to examine
3445
- Documentation to reference
3546
- Technical constraints
3647
- Examples to follow
3748

49+
**⚠️ Mandatory stop**: AI waits for context confirmation before reading files.
50+
3851
### Phase 3: Plan Generation (Internal)
3952
Quick mentally plans the approach based on your brief and context. This is AI internal reasoning - not displayed.
4053

41-
### Phase 4: Task Breakdown
54+
### Phase 4: Task Breakdown (⚠️ Enforcement Checkpoint)
4255
Quick generates a concrete task checklist:
4356
```markdown
4457
- [ ] Add error handling to login API
@@ -48,22 +61,27 @@ Quick generates a concrete task checklist:
4861
```
4962

5063
**Approval #2**: You see the full task list and confirm before execution.
64+
- **⚠️ Mandatory stop**: AI waits for "yes" confirmation
5165

52-
### Phase 5: Sequential Execution
66+
### Phase 5: Sequential Execution (⚠️ Enforcement Checkpoint)
5367
Quick executes tasks one at a time:
5468
- Displays task being executed
5569
- Makes necessary code changes
5670
- Shows what was done
5771
- Confirms completion
72+
- **⚠️ Mandatory pause**: Waits for "Next task ready?" confirmation before proceeding
5873

5974
**Stop on error**: If a task fails, Quick stops and asks what to do next.
75+
- **⚠️ Mandatory wait**: Does not auto-retry or auto-skip
6076

61-
### Phase 6: Summary
77+
### Phase 6: Summary (⚠️ Enforcement Checkpoint)
6278
Quick shows completion status:
6379
- All tasks completed ✅
6480
- Files modified
6581
- Next steps (testing, review, etc.)
6682

83+
**⚠️ Final summary**: Only shows completion after all tasks verified.
84+
6785
## When to Use Quick
6886

6987
### Perfect For:
@@ -95,28 +113,43 @@ Quick shows completion status:
95113
| Task Complexity | Simple checklist | Detailed task breakdown with phases |
96114
| Use Case | Ad-hoc, small tasks | Full-featured spec-driven development |
97115

98-
## Execution Flow
116+
## Execution Flow (With Enforcement Checkpoints)
99117

100118
```text
101119
/quick.implement "your task description"
102120
103-
Phase 1: Mission Brief (2-3 questions)
121+
⚠️ CHECKPOINT 1: Mission Brief (2-3 questions)
104122
105-
Approval #1: "Proceed with this brief?"
123+
⚠️ STOP: Approval #1: "Proceed with this brief?"
106124
107-
Phase 2: Context Discovery (user provides context)
125+
⚠️ CHECKPOINT 2: Context Discovery (user provides context)
108126
109-
Phase 3: Plan Generation (AI internal planning)
127+
⚠️ STOP: Approval context received?
110128
111-
Phase 4: Task Breakdown (show checklist)
129+
⚠️ CHECKPOINT 3: Plan Generation (AI internal planning)
112130
113-
Approval #2: "Proceed with these tasks?"
131+
⚠️ CHECKPOINT 4: Task Breakdown (show checklist)
114132
115-
Phase 5: Sequential Execution
133+
⚠️ STOP: Approval #2: "Proceed with these tasks?"
116134
117-
Phase 6: Summary
135+
⚠️ CHECKPOINT 5: Sequential Execution (one task at a time)
136+
137+
⚠️ STOP: "Next task ready?" (per task)
138+
139+
⚠️ CHECKPOINT 6: Summary
140+
141+
⚠️ STOP: Implementation complete
118142
```
119143

144+
### Enforcement Guarantees
145+
146+
- **Phase 1**: Mission Brief must be collected and approved
147+
- **Phase 2**: Context must be collected and confirmed
148+
- **Phase 5**: Each task must complete before next task starts
149+
- **All phases**: Require explicit user "yes" to proceed
150+
- **No skipping**: Phases cannot be bypassed
151+
- **No auto-proceed**: AI never moves forward without confirmation
152+
120153
## Error Handling
121154

122155
If a task fails during execution:

0 commit comments

Comments
 (0)