@@ -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)
2434Quick 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)
3243You 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)
3952Quick 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)
4255Quick 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)
5367Quick 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)
6278Quick 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
122155If a task fails during execution:
0 commit comments