@namch/agent-assistant 1.2.1 → 1.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/README.md +2 -14
- package/commands/code/focus.md +2 -25
- package/commands/code/hard.md +0 -30
- package/commands/cook/focus.md +0 -25
- package/commands/cook/hard.md +0 -25
- package/commands/cook/team.md +0 -26
- package/commands/debug/focus.md +0 -48
- package/commands/debug/hard.md +0 -71
- package/commands/debug/team.md +0 -36
- package/commands/design/focus.md +0 -23
- package/commands/design/hard.md +0 -85
- package/commands/design/team.md +0 -58
- package/commands/fix/focus.md +0 -23
- package/commands/fix/hard.md +0 -39
- package/commands/fix/team.md +0 -25
- package/commands/plan/focus.md +0 -53
- package/commands/plan/hard.md +0 -56
- package/commands/plan/team.md +0 -22
- package/commands/report/focus.md +0 -52
- package/commands/test/focus.md +0 -23
- package/commands/test/hard.md +0 -57
- package/commands/test/team.md +0 -7
- package/package.json +1 -1
- package/rules/TEAMS.md +1 -1
- package/rules/CONTEXT-GATE.md +0 -362
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [1.2.2] - 2026-03-12
|
|
9
|
+
|
|
10
|
+
### Fixed
|
|
11
|
+
- **Context Gate Enforcement**: Remove context gate because it was causing more issues than it solved (complexity, maintenance, AI bypass). Instead, rely on agent-specific blocking checkpoints within the Golden Triangle protocol for guaranteed input validation and clean execution.
|
|
12
|
+
- Removed `rules/CONTEXT-GATE.md` and all references to it in command files
|
|
13
|
+
- Updated all team command files to rely solely on phase-specific blocking checkpoints (P2–P7) for input validation
|
|
14
|
+
- Updated documentation to reflect removal of context gate and new reliance on phase checkpoints for clean execution
|
|
15
|
+
|
|
8
16
|
## [1.2.1] - 2026-03-12
|
|
9
17
|
|
|
10
18
|
### Fixed
|
package/README.md
CHANGED
|
@@ -140,20 +140,8 @@ Creates `./documents/` files that agents reference. Without docs, agents work ge
|
|
|
140
140
|
| ------- | ---------------- | -------------------------- |
|
|
141
141
|
| `:fast` | Simple tasks | 2-3 agents |
|
|
142
142
|
| `:hard` | Complex features | 5-8 agents + quality gates |
|
|
143
|
-
| `:focus` | Clean execution |
|
|
144
|
-
|
|
145
|
-
### Clear context — stay on your request, avoid history hallucination
|
|
146
|
-
|
|
147
|
-
**`:hard`** and **`:focus`** are designed to reduce **context rot** (the model drifting or "hallucinating" from long chat history):
|
|
148
|
-
|
|
149
|
-
- **Problem**: Long conversations can make the model latch onto old context and drift from your current request.
|
|
150
|
-
- **How we handle it**:
|
|
151
|
-
- **`:hard`**: Structured workflow (phases + deliverables) so each step is grounded in **your input + prior phase output**, not arbitrary chat history.
|
|
152
|
-
- **`:focus`**: **Clear context** before running—execution starts "clean" for your request; phases run in order without pulling in old conversation.
|
|
153
|
-
|
|
154
|
-
Use **`:focus`** when you want execution to **stick strictly to the current request** (e.g. large refactors, tricky bugs, or after a long chat). More stable results, less "history hallucination".
|
|
155
|
-
|
|
156
|
-
---
|
|
143
|
+
| `:focus` | Clean execution | (cook, code, fix, debug, design, plan, test, report) |
|
|
144
|
+
| `:team` | Team workflows | All agents, structured phases |
|
|
157
145
|
|
|
158
146
|
## Commands Reference
|
|
159
147
|
|
package/commands/code/focus.md
CHANGED
|
@@ -45,8 +45,8 @@ execution-mode: execute
|
|
|
45
45
|
2. **IF YES**:
|
|
46
46
|
- **SKIP** Phase 1 (Requirements/Brainstorm), Phase 2 (Scout), Phase 3 (Planning).
|
|
47
47
|
- **ANNOUNCE**: "✅ Plan provided/found — skipping research, scout, and planning. Proceeding to implementation."
|
|
48
|
-
- **GO TO**:
|
|
49
|
-
3. **IF NO**: Run phases in order: Phase 1 → 2 → 3 →
|
|
48
|
+
- **GO TO**: Phase 4 (Implementation) → Phase 5 (Testing) → Phase 6 (Review).
|
|
49
|
+
3. **IF NO**: Run phases in order: Phase 1 → 2 → 3 → 4 → 5 → 6.
|
|
50
50
|
|
|
51
51
|
---
|
|
52
52
|
|
|
@@ -182,29 +182,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
182
182
|
|
|
183
183
|
---
|
|
184
184
|
|
|
185
|
-
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
186
|
-
|
|
187
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
188
|
-
>
|
|
189
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
|
|
190
|
-
>
|
|
191
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
192
|
-
|
|
193
|
-
### ⚡ EXECUTION
|
|
194
|
-
|
|
195
|
-
```yaml
|
|
196
|
-
context_gate_execution:
|
|
197
|
-
mode: "FOCUS (Automatic)"
|
|
198
|
-
trigger: "After Phase 3 (Planning) completes"
|
|
199
|
-
protocol: "Follow rules/CONTEXT-GATE.md § FOCUS MODE"
|
|
200
|
-
|
|
201
|
-
variant_adjustments:
|
|
202
|
-
remaining_phases: "Phase 4 → 5 → 6"
|
|
203
|
-
plan_file: "./reports/plans/PLAN-{task}.md"
|
|
204
|
-
```
|
|
205
|
-
|
|
206
|
-
**DO NOT proceed to Phase 4 until Context Gate completes.**
|
|
207
|
-
|
|
208
185
|
Mode: Fresh implementation start
|
|
209
186
|
|
|
210
187
|
Proceeding to Implementation...
|
package/commands/code/hard.md
CHANGED
|
@@ -235,36 +235,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
235
235
|
|
|
236
236
|
---
|
|
237
237
|
|
|
238
|
-
## 🛡️ VERIFICATION CHECKPOINT — Context Optimization
|
|
239
|
-
|
|
240
|
-
> **PURPOSE**: Prevent "context rot" by clearing noisy planning history before implementation.
|
|
241
|
-
>
|
|
242
|
-
> Long-running planning sessions fill context with noise that degrades code generation quality.
|
|
243
|
-
> This checkpoint acts as a "firewall" between Planning and Implementation phases.
|
|
244
|
-
|
|
245
|
-
## 🛡️ VERIFICATION CHECKPOINT
|
|
246
|
-
|
|
247
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
248
|
-
>
|
|
249
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE protocol
|
|
250
|
-
>
|
|
251
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
252
|
-
|
|
253
|
-
### ⚡ EXECUTION
|
|
254
|
-
|
|
255
|
-
```yaml
|
|
256
|
-
context_gate_execution:
|
|
257
|
-
mode: "HARD (User Choice)"
|
|
258
|
-
trigger: "After Phase 3 (Planning) completes"
|
|
259
|
-
protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE"
|
|
260
|
-
|
|
261
|
-
variant_adjustments:
|
|
262
|
-
plan_file: "./reports/plans/PLAN-{task}.md"
|
|
263
|
-
remaining_phases: "Phase 4 → 5 → 6"
|
|
264
|
-
```
|
|
265
|
-
|
|
266
|
-
**DO NOT proceed to Phase 4 until user selects option.**
|
|
267
|
-
|
|
268
238
|
---
|
|
269
239
|
|
|
270
240
|
## 🎭 Phase 4: IMPLEMENTATION
|
package/commands/cook/focus.md
CHANGED
|
@@ -140,31 +140,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
140
140
|
|
|
141
141
|
---
|
|
142
142
|
|
|
143
|
-
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
144
|
-
|
|
145
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
146
|
-
>
|
|
147
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
|
|
148
|
-
>
|
|
149
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
150
|
-
|
|
151
|
-
### ⚡ EXECUTION
|
|
152
|
-
|
|
153
|
-
```yaml
|
|
154
|
-
context_gate_execution:
|
|
155
|
-
mode: "FOCUS (Automatic)"
|
|
156
|
-
trigger: "After Phase 5 (Planning) completes"
|
|
157
|
-
protocol: "Follow rules/CONTEXT-GATE.md § FOCUS MODE"
|
|
158
|
-
|
|
159
|
-
variant_adjustments:
|
|
160
|
-
remaining_phases: "Phase 6 → 7 → 8"
|
|
161
|
-
plan_file: "./reports/plans/PLAN-{feature}.md"
|
|
162
|
-
```
|
|
163
|
-
|
|
164
|
-
**DO NOT proceed to Phase 6 until Context Gate completes.**
|
|
165
|
-
|
|
166
|
-
---
|
|
167
|
-
|
|
168
143
|
## 🎭 Phase 6: IMPLEMENTATION
|
|
169
144
|
|
|
170
145
|
| Agent | `tech-lead` → routes to specialists |
|
package/commands/cook/hard.md
CHANGED
|
@@ -136,31 +136,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
136
136
|
|
|
137
137
|
---
|
|
138
138
|
|
|
139
|
-
## 🛡️ VERIFICATION CHECKPOINT
|
|
140
|
-
|
|
141
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
142
|
-
>
|
|
143
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE protocol
|
|
144
|
-
>
|
|
145
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
146
|
-
|
|
147
|
-
### ⚡ EXECUTION
|
|
148
|
-
|
|
149
|
-
```yaml
|
|
150
|
-
context_gate_execution:
|
|
151
|
-
mode: "HARD (User Choice)"
|
|
152
|
-
trigger: "After Phase 5 (Planning) completes"
|
|
153
|
-
protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE"
|
|
154
|
-
|
|
155
|
-
variant_adjustments:
|
|
156
|
-
plan_file: "PLAN-{feature}.md"
|
|
157
|
-
remaining_phases: "Phase 6 → 7 → 8"
|
|
158
|
-
```
|
|
159
|
-
|
|
160
|
-
**DO NOT proceed to Phase 6 until user selects option.**
|
|
161
|
-
|
|
162
|
-
---
|
|
163
|
-
|
|
164
139
|
## 🎭 Phase 6: IMPLEMENTATION
|
|
165
140
|
|
|
166
141
|
| Agent | `tech-lead` → routes to specialists |
|
package/commands/cook/team.md
CHANGED
|
@@ -330,32 +330,6 @@ Format: rules/PHASES.md § Phase output structure + rules/TEAMS.md § Golden Tri
|
|
|
330
330
|
|
|
331
331
|
---
|
|
332
332
|
|
|
333
|
-
## 🛡️ VERIFICATION CHECKPOINT
|
|
334
|
-
|
|
335
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
336
|
-
>
|
|
337
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE protocol
|
|
338
|
-
>
|
|
339
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
340
|
-
|
|
341
|
-
### ⚡ EXECUTION
|
|
342
|
-
|
|
343
|
-
```yaml
|
|
344
|
-
context_gate_execution:
|
|
345
|
-
mode: "HARD (User Choice)"
|
|
346
|
-
trigger: "After Phase 5 (Planning) completes"
|
|
347
|
-
protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE"
|
|
348
|
-
|
|
349
|
-
variant_adjustments:
|
|
350
|
-
plan_file: "PLAN-{feature}.md"
|
|
351
|
-
remaining_phases: "Phase 6 → 7"
|
|
352
|
-
mailbox: "MAILBOX-{date}.md contains full debate history"
|
|
353
|
-
```
|
|
354
|
-
|
|
355
|
-
**DO NOT proceed to Phase 6 until user selects option.**
|
|
356
|
-
|
|
357
|
-
---
|
|
358
|
-
|
|
359
333
|
## 🎭 Phase 6: IMPLEMENTATION — 🔺 GOLDEN TRIANGLE
|
|
360
334
|
|
|
361
335
|
> **THIS IS THE MOST CRITICAL PHASE.** Every step is detailed. No shortcuts.
|
package/commands/debug/focus.md
CHANGED
|
@@ -92,54 +92,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
92
92
|
|
|
93
93
|
---
|
|
94
94
|
|
|
95
|
-
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
96
|
-
|
|
97
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
98
|
-
>
|
|
99
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE (Debug variant)
|
|
100
|
-
>
|
|
101
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
102
|
-
|
|
103
|
-
### ⚡ EXECUTION
|
|
104
|
-
|
|
105
|
-
```yaml
|
|
106
|
-
context_gate_execution:
|
|
107
|
-
mode: "FOCUS (Automatic)"
|
|
108
|
-
trigger: "After Phase 4 (Solution Design) completes"
|
|
109
|
-
protocol: "Follow rules/CONTEXT-GATE.md § FOCUS MODE § debug_focus_variant"
|
|
110
|
-
|
|
111
|
-
variant_adjustments:
|
|
112
|
-
reload_type: "OUTPUT_ESSENTIAL_CONTEXT"
|
|
113
|
-
handoff_to: "/fix:focus"
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
**Note**: Debug outputs context for fix handoff, doesn't implement directly.
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
### 📋 Post-Gate Status
|
|
120
|
-
|
|
121
|
-
```markdown
|
|
122
|
-
🔒 **Context Gate Passed**
|
|
123
|
-
|
|
124
|
-
## ✅ Output for Handoff:
|
|
125
|
-
- User request (original issue verbatim)
|
|
126
|
-
- Root cause summary with evidence
|
|
127
|
-
- Fix strategy with rollback
|
|
128
|
-
- Acceptance criteria for fix verification
|
|
129
|
-
|
|
130
|
-
## ❌ Discarded:
|
|
131
|
-
- Failed investigation hypotheses
|
|
132
|
-
- Rejected theories
|
|
133
|
-
- Debugging noise
|
|
134
|
-
- Chat history
|
|
135
|
-
|
|
136
|
-
Mode: Clean handoff ready
|
|
137
|
-
|
|
138
|
-
Ready for fix implementation...
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
---
|
|
142
|
-
|
|
143
95
|
## COMPLETION
|
|
144
96
|
|
|
145
97
|
Present findings with:
|
package/commands/debug/hard.md
CHANGED
|
@@ -89,77 +89,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
## 🛡️ VERIFICATION CHECKPOINT — Context Optimization
|
|
93
|
-
|
|
94
|
-
> **PURPOSE**: Prevent "context rot" by clearing noisy debugging/analysis history before fix implementation.
|
|
95
|
-
>
|
|
96
|
-
> Deep investigation sessions fill context with hypotheses and failed attempts that can confuse implementation.
|
|
97
|
-
> This checkpoint acts as a "firewall" before handing off to fix workflows.
|
|
98
|
-
|
|
99
|
-
### ⚡ OPTIONS (Present to User)
|
|
100
|
-
|
|
101
|
-
```markdown
|
|
102
|
-
## 🛡️ Context Optimization Checkpoint
|
|
103
|
-
|
|
104
|
-
**Debug Analysis Complete** — Root cause identified, fix strategy designed.
|
|
105
|
-
|
|
106
|
-
**Choose how to proceed:**
|
|
107
|
-
|
|
108
|
-
| Option | Action | Description |
|
|
109
|
-
|--------|--------|-------------|
|
|
110
|
-
| **1. 🚀 Clear context & Fix** | `RECOMMENDED` | Fresh start: Ignore debug history, proceed with fix strategy only |
|
|
111
|
-
| **2. ⏸️ Review First** | `SAFE` | Clear context, show fix summary, wait for approval |
|
|
112
|
-
| **3. ⚠️ Continue (No Clear)** | `RISKY` | Keep debug history (may cause fix drift) |
|
|
113
|
-
|
|
114
|
-
⏳ Awaiting selection...
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
### 🔄 EXECUTION BEHAVIOR
|
|
118
|
-
|
|
119
|
-
```yaml
|
|
120
|
-
option_1_clear_fix:
|
|
121
|
-
behavior: "RECOMMENDED - Clean handoff to fix"
|
|
122
|
-
steps:
|
|
123
|
-
1. ACKNOWLEDGE: "🚀 Context optimized. Fix strategy ready."
|
|
124
|
-
2. CONTEXT_DIRECTIVE: |
|
|
125
|
-
⛔ IGNORE all debugging hypotheses and failed investigation paths.
|
|
126
|
-
✅ FIX STRATEGY is SOLE SOURCE OF TRUTH.
|
|
127
|
-
3. OUTPUT_ESSENTIAL_CONTEXT: |
|
|
128
|
-
## 📤 Essential Context for Fix Handoff
|
|
129
|
-
|
|
130
|
-
Summarize these sections for `/fix:hard` to consume:
|
|
131
|
-
|
|
132
|
-
1️⃣ **USER REQUEST (VERBATIM)**:
|
|
133
|
-
- Quote the original issue description exactly as user stated
|
|
134
|
-
- This MUST be preserved for fix verification
|
|
135
|
-
|
|
136
|
-
2️⃣ **ROOT CAUSE SUMMARY**:
|
|
137
|
-
- What is broken and why
|
|
138
|
-
- File(s) and line(s) involved
|
|
139
|
-
- Evidence that confirms root cause
|
|
140
|
-
## 🛡️ VERIFICATION CHECKPOINT
|
|
141
|
-
|
|
142
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
143
|
-
>
|
|
144
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE (Debug variant)
|
|
145
|
-
>
|
|
146
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
147
|
-
|
|
148
|
-
### ⚡ EXECUTION
|
|
149
|
-
|
|
150
|
-
```yaml
|
|
151
|
-
context_gate_execution:
|
|
152
|
-
mode: "HARD (User Choice)"
|
|
153
|
-
trigger: "After Phase 4 (Solution Design) completes"
|
|
154
|
-
protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE § debug_hard_variant"
|
|
155
|
-
|
|
156
|
-
variant_adjustments:
|
|
157
|
-
output_type: "OUTPUT_ESSENTIAL_CONTEXT"
|
|
158
|
-
handoff_to: "/fix:hard"
|
|
159
|
-
```
|
|
160
|
-
|
|
161
|
-
**Note**: Debug outputs context for fix handoff with user choice.
|
|
162
|
-
|
|
163
92
|
---
|
|
164
93
|
|
|
165
94
|
## COMPLETION
|
package/commands/debug/team.md
CHANGED
|
@@ -328,42 +328,6 @@ One phase at a time. Within each phase follow the **Golden Triangle Loop** (per
|
|
|
328
328
|
|
|
329
329
|
---
|
|
330
330
|
|
|
331
|
-
## 🛡️ VERIFICATION CHECKPOINT
|
|
332
|
-
|
|
333
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
334
|
-
>
|
|
335
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE (Debug variant)
|
|
336
|
-
|
|
337
|
-
```yaml
|
|
338
|
-
context_gate_execution:
|
|
339
|
-
mode: "HARD (User Choice)"
|
|
340
|
-
trigger: "After Phase 4 (Root Cause Report) completes"
|
|
341
|
-
protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE § debug_hard_variant"
|
|
342
|
-
variant_adjustments:
|
|
343
|
-
report_file: "DEBUG-REPORT-{issue}.md"
|
|
344
|
-
handoff_to: "/fix:team OR /fix:hard"
|
|
345
|
-
```
|
|
346
|
-
|
|
347
|
-
### ⚡ OPTIONS (Present to User)
|
|
348
|
-
|
|
349
|
-
```markdown
|
|
350
|
-
## 🛡️ Context Optimization Checkpoint
|
|
351
|
-
|
|
352
|
-
**Team Debug Investigation Complete** — Root cause identified, fix approaches recommended.
|
|
353
|
-
|
|
354
|
-
| Option | Action | Description |
|
|
355
|
-
|--------|--------|-------------|
|
|
356
|
-
| **1. 🚀 Clear context & Fix** | `RECOMMENDED` | Fresh start with debug report → `/fix:team` or `/fix:hard` |
|
|
357
|
-
| **2. ⏸️ Review First** | `SAFE` | Show report summary, wait for approval before proceeding |
|
|
358
|
-
| **3. ⚠️ Continue (No Clear)** | `RISKY` | Keep debug history (may cause fix drift from noisy context) |
|
|
359
|
-
|
|
360
|
-
⏳ Awaiting selection...
|
|
361
|
-
```
|
|
362
|
-
|
|
363
|
-
**DO NOT proceed past this checkpoint until user selects option.**
|
|
364
|
-
|
|
365
|
-
---
|
|
366
|
-
|
|
367
331
|
## ✅ COMPLETION
|
|
368
332
|
|
|
369
333
|
Present final investigation report with consensus stamps from ALL phases:
|
package/commands/design/focus.md
CHANGED
|
@@ -178,29 +178,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
178
178
|
|
|
179
179
|
---
|
|
180
180
|
|
|
181
|
-
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
182
|
-
|
|
183
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
184
|
-
>
|
|
185
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE (Design variant)
|
|
186
|
-
>
|
|
187
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
188
|
-
|
|
189
|
-
### ⚡ EXECUTION
|
|
190
|
-
|
|
191
|
-
```yaml
|
|
192
|
-
context_gate_execution:
|
|
193
|
-
mode: "FOCUS (Automatic)"
|
|
194
|
-
trigger: "After Phase 4 (Design Creation) completes"
|
|
195
|
-
protocol: "Follow rules/CONTEXT-GATE.md § FOCUS MODE § design_focus_variant"
|
|
196
|
-
|
|
197
|
-
variant_adjustments:
|
|
198
|
-
remaining_phases: "Phase 5 (Design Review) → Implementation Handoff"
|
|
199
|
-
deliverable_file: "./reports/designs/DESIGN-{request}.md"
|
|
200
|
-
```
|
|
201
|
-
|
|
202
|
-
**DO NOT proceed to Phase 5 until Context Gate completes.**
|
|
203
|
-
|
|
204
181
|
## ❌ Discarded:
|
|
205
182
|
- Design exploration noise
|
|
206
183
|
- Rejected alternatives
|
package/commands/design/hard.md
CHANGED
|
@@ -175,91 +175,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
175
175
|
|
|
176
176
|
---
|
|
177
177
|
|
|
178
|
-
## 🛡️ VERIFICATION CHECKPOINT — Context Optimization
|
|
179
|
-
|
|
180
|
-
> **PURPOSE**: Prevent "context rot" by clearing noisy design exploration history before implementation.
|
|
181
|
-
>
|
|
182
|
-
> Design iterations and rejected alternatives fill context with noise.
|
|
183
|
-
> This checkpoint acts as a "firewall" before handing off to implementation.
|
|
184
|
-
|
|
185
|
-
### ⚡ OPTIONS (Present to User)
|
|
186
|
-
|
|
187
|
-
```markdown
|
|
188
|
-
## 🛡️ Context Optimization Checkpoint
|
|
189
|
-
|
|
190
|
-
**Design Complete** — Design specs created at: `./reports/designs/DESIGN-{request}.md`
|
|
191
|
-
|
|
192
|
-
**Choose how to proceed:**
|
|
193
|
-
|
|
194
|
-
| Option | Action | Description |
|
|
195
|
-
|--------|--------|-------------|
|
|
196
|
-
| **1. 🚀 Clear context & Ready** | `RECOMMENDED` | Fresh start for implementation: Reload Design, ignore exploration history |
|
|
197
|
-
| **2. ⏸️ Review First** | `SAFE` | Clear context, show design summary, wait for approval |
|
|
198
|
-
| **3. ⚠️ Continue (No Clear)** | `RISKY` | Keep design history (may affect review quality) |
|
|
199
|
-
|
|
200
|
-
⏳ Awaiting selection...
|
|
201
|
-
```
|
|
202
|
-
|
|
203
|
-
### 🔄 EXECUTION BEHAVIOR
|
|
204
|
-
|
|
205
|
-
```yaml
|
|
206
|
-
option_1_clear_ready:
|
|
207
|
-
behavior: "RECOMMENDED - Clean handoff"
|
|
208
|
-
steps:
|
|
209
|
-
1. ACKNOWLEDGE: "🚀 Context optimized. Design ready for review/implementation."
|
|
210
|
-
2. CONTEXT_DIRECTIVE: |
|
|
211
|
-
⛔ IGNORE all design exploration and rejected alternatives.
|
|
212
|
-
✅ DESIGN FILE is SOLE SOURCE OF TRUTH.
|
|
213
|
-
3. RELOAD_ESSENTIAL_CONTEXT: |
|
|
214
|
-
## 📥 Essential Context Reload
|
|
215
|
-
|
|
216
|
-
Read Design file and extract these sections for review/handoff context:
|
|
217
|
-
|
|
218
|
-
1️⃣ **USER REQUEST (VERBATIM)**:
|
|
219
|
-
- Extract from Design header: `## 📌 User Request (VERBATIM)`
|
|
220
|
-
- This is the ORIGINAL design request to verify against
|
|
221
|
-
|
|
222
|
-
2️⃣ **ACCEPTANCE CRITERIA**:
|
|
223
|
-
- Extract from Design header: `## 🎯 Acceptance Criteria`
|
|
224
|
-
- These are the checkpoints for design approval
|
|
225
|
-
|
|
226
|
-
3️⃣ **DESIGN DOCUMENT**:
|
|
227
|
-
- Full design content from `./reports/designs/DESIGN-{request}.md`
|
|
228
|
-
- This is the SOLE SOURCE OF TRUTH for design decisions
|
|
229
|
-
|
|
230
|
-
4️⃣ **REMAINING PHASES**: Phase 5 (Design Review) → Implementation Handoff
|
|
231
|
-
|
|
232
|
-
5️⃣ **REVIEW RULES** (Summary):
|
|
233
|
-
- Verify design meets original user request
|
|
234
|
-
- Check all acceptance criteria are addressed
|
|
235
|
-
- Ensure design is implementation-ready
|
|
236
|
-
4. PROCEED: Continue to Design Review phase
|
|
237
|
-
5. POST_STATUS: |
|
|
238
|
-
🔒 **Context Gate Passed**
|
|
239
|
-
|
|
240
|
-
## 🛡️ VERIFICATION CHECKPOINT
|
|
241
|
-
|
|
242
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
243
|
-
>
|
|
244
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE (Design variant)
|
|
245
|
-
>
|
|
246
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
247
|
-
|
|
248
|
-
### ⚡ EXECUTION
|
|
249
|
-
|
|
250
|
-
```yaml
|
|
251
|
-
context_gate_execution:
|
|
252
|
-
mode: "HARD (User Choice)"
|
|
253
|
-
trigger: "After Phase 4 (Design Creation) completes"
|
|
254
|
-
protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE § design_hard_variant"
|
|
255
|
-
|
|
256
|
-
variant_adjustments:
|
|
257
|
-
deliverable_file: "./reports/designs/DESIGN-{request}.md"
|
|
258
|
-
remaining_phases: "Phase 5 (Design Review) → Implementation Handoff"
|
|
259
|
-
```
|
|
260
|
-
|
|
261
|
-
**DO NOT proceed to Phase 5 until user selects option.**
|
|
262
|
-
|
|
263
178
|
---
|
|
264
179
|
|
|
265
180
|
## 🎭 Phase 5: DESIGN REVIEW
|
package/commands/design/team.md
CHANGED
|
@@ -376,64 +376,6 @@ Format: rules/PHASES.md § Phase output structure + rules/TEAMS.md § Golden Tri
|
|
|
376
376
|
|
|
377
377
|
---
|
|
378
378
|
|
|
379
|
-
## 🛡️ VERIFICATION CHECKPOINT
|
|
380
|
-
|
|
381
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
382
|
-
>
|
|
383
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE protocol
|
|
384
|
-
>
|
|
385
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
386
|
-
|
|
387
|
-
### ⚡ OPTIONS (Present to User)
|
|
388
|
-
|
|
389
|
-
```markdown
|
|
390
|
-
## 🛡️ Context Optimization Checkpoint
|
|
391
|
-
|
|
392
|
-
**Design Complete** — Design specs created at: `./reports/designs/DESIGN-{request}.md`
|
|
393
|
-
|
|
394
|
-
**Choose how to proceed:**
|
|
395
|
-
|
|
396
|
-
| Option | Action | Description |
|
|
397
|
-
|--------|--------|-------------|
|
|
398
|
-
| **1. 🚀 Clear context & Proceed to Implementation Spec** | `RECOMMENDED` | Fresh start: Reload Design file, ignore exploration history |
|
|
399
|
-
| **2. ⏸️ Review Design First** | `SAFE` | Clear context, show design summary, wait for approval before proceeding |
|
|
400
|
-
| **3. ⚠️ Continue (No Clear)** | `RISKY` | Keep design history (may affect spec quality) |
|
|
401
|
-
|
|
402
|
-
⏳ Awaiting selection...
|
|
403
|
-
```
|
|
404
|
-
|
|
405
|
-
### 🔄 EXECUTION BEHAVIOR
|
|
406
|
-
|
|
407
|
-
```yaml
|
|
408
|
-
option_1_clear_proceed:
|
|
409
|
-
behavior: "RECOMMENDED - Clean handoff to implementation spec"
|
|
410
|
-
steps:
|
|
411
|
-
1. ACKNOWLEDGE: "🚀 Context optimized. Design ready for implementation spec."
|
|
412
|
-
2. CONTEXT_DIRECTIVE: |
|
|
413
|
-
⛔ IGNORE all design exploration and rejected alternatives.
|
|
414
|
-
✅ DESIGN FILE is SOLE SOURCE OF TRUTH.
|
|
415
|
-
3. RELOAD: Read DESIGN-{request}.md as primary context
|
|
416
|
-
4. PROCEED: Execute Phase 3
|
|
417
|
-
|
|
418
|
-
option_2_review_first:
|
|
419
|
-
behavior: "SAFE - User approves before spec"
|
|
420
|
-
steps:
|
|
421
|
-
1. CLEAR context of exploration noise
|
|
422
|
-
2. DISPLAY: Design summary from DESIGN-{request}.md
|
|
423
|
-
3. WAIT: User approval
|
|
424
|
-
4. PROCEED: Execute Phase 3 on approval
|
|
425
|
-
|
|
426
|
-
option_3_continue:
|
|
427
|
-
behavior: "RISKY - Context may be noisy"
|
|
428
|
-
steps:
|
|
429
|
-
1. WARN: "⚠️ Context contains exploration history. Spec quality may degrade."
|
|
430
|
-
2. PROCEED: Execute Phase 3 immediately
|
|
431
|
-
```
|
|
432
|
-
|
|
433
|
-
**DO NOT proceed to Phase 3 until user selects option.**
|
|
434
|
-
|
|
435
|
-
---
|
|
436
|
-
|
|
437
379
|
## 🎭 Phase 3: IMPLEMENTATION SPEC — 🔺 GOLDEN TRIANGLE
|
|
438
380
|
|
|
439
381
|
| Role | Agent | Mission |
|
package/commands/fix/focus.md
CHANGED
|
@@ -85,29 +85,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
85
85
|
|
|
86
86
|
---
|
|
87
87
|
|
|
88
|
-
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
89
|
-
|
|
90
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
91
|
-
>
|
|
92
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
|
|
93
|
-
>
|
|
94
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
95
|
-
|
|
96
|
-
### ⚡ EXECUTION
|
|
97
|
-
|
|
98
|
-
```yaml
|
|
99
|
-
context_gate_execution:
|
|
100
|
-
mode: "FOCUS (Automatic)"
|
|
101
|
-
trigger: "After Phase 3 (Fix Planning) completes"
|
|
102
|
-
protocol: "Follow rules/CONTEXT-GATE.md § FOCUS MODE"
|
|
103
|
-
|
|
104
|
-
variant_adjustments:
|
|
105
|
-
remaining_phases: "Phase 4 → 5 → 5.5"
|
|
106
|
-
plan_type: "Fix plan with rollback strategy"
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
**DO NOT proceed to Phase 4 until Context Gate completes.**
|
|
110
|
-
|
|
111
88
|
---
|
|
112
89
|
|
|
113
90
|
## ✅ Reloaded:
|
package/commands/fix/hard.md
CHANGED
|
@@ -81,45 +81,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
81
81
|
|
|
82
82
|
---
|
|
83
83
|
|
|
84
|
-
## 🛡️ VERIFICATION CHECKPOINT — Context Optimization
|
|
85
|
-
|
|
86
|
-
> **PURPOSE**: Prevent "context rot" by clearing noisy debugging/planning history before implementation.
|
|
87
|
-
>
|
|
88
|
-
> Long-running analysis sessions fill context with noise that degrades code generation quality.
|
|
89
|
-
> This checkpoint acts as a "firewall" between Planning and Implementation phases.
|
|
90
|
-
|
|
91
|
-
### ⚡ OPTIONS (Present to User)
|
|
92
|
-
|
|
93
|
-
```markdown
|
|
94
|
-
## 🛡️ Context Optimization Checkpoint
|
|
95
|
-
|
|
96
|
-
**Planning Complete** — Fix plan created with rollback strategy.
|
|
97
|
-
|
|
98
|
-
**Choose how to proceed with implementation:**
|
|
99
|
-
|
|
100
|
-
## 🛡️ VERIFICATION CHECKPOINT
|
|
101
|
-
|
|
102
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
103
|
-
>
|
|
104
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE protocol
|
|
105
|
-
>
|
|
106
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
107
|
-
|
|
108
|
-
### ⚡ EXECUTION
|
|
109
|
-
|
|
110
|
-
```yaml
|
|
111
|
-
context_gate_execution:
|
|
112
|
-
mode: "HARD (User Choice)"
|
|
113
|
-
trigger: "After Phase 3 (Fix Planning) completes"
|
|
114
|
-
protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE"
|
|
115
|
-
|
|
116
|
-
variant_adjustments:
|
|
117
|
-
plan_type: "Fix plan with rollback strategy"
|
|
118
|
-
remaining_phases: "Phase 4 → 5 → 5.5"
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
**DO NOT proceed to Phase 4 until user selects option.**
|
|
122
|
-
|
|
123
84
|
---
|
|
124
85
|
|
|
125
86
|
## 🎭 Phase 4: IMPLEMENTATION
|
package/commands/fix/team.md
CHANGED
|
@@ -296,31 +296,6 @@ IF unclear → debugger (Tech Lead) decides based on P1 investigation findings
|
|
|
296
296
|
|
|
297
297
|
---
|
|
298
298
|
|
|
299
|
-
## 🛡️ VERIFICATION CHECKPOINT
|
|
300
|
-
|
|
301
|
-
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
302
|
-
>
|
|
303
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE protocol
|
|
304
|
-
>
|
|
305
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
306
|
-
|
|
307
|
-
### ⚡ EXECUTION
|
|
308
|
-
|
|
309
|
-
```yaml
|
|
310
|
-
context_gate_execution:
|
|
311
|
-
mode: "HARD (User Choice)"
|
|
312
|
-
trigger: "After Phase 3 (Fix Planning) completes"
|
|
313
|
-
protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE"
|
|
314
|
-
|
|
315
|
-
variant_adjustments:
|
|
316
|
-
plan_type: "Fix plan with rollback strategy"
|
|
317
|
-
plan_file: "PLAN-{issue}.md"
|
|
318
|
-
remaining_phases: "Phase 4 → 5"
|
|
319
|
-
mailbox: "MAILBOX-{date}.md contains full debate history"
|
|
320
|
-
```
|
|
321
|
-
|
|
322
|
-
**DO NOT proceed to Phase 4 until user selects option.**
|
|
323
|
-
|
|
324
299
|
---
|
|
325
300
|
|
|
326
301
|
## 🎭 Phase 4: IMPLEMENTATION — 🔺 GOLDEN TRIANGLE
|