@namch/agent-assistant 1.0.4 → 1.1.0
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 +24 -0
- package/README.md +1 -1
- package/agents/planner.md +59 -11
- package/agents/reporter.md +1 -1
- package/cli/install.js +514 -169
- package/code-assistants/antigravity-assistant/AntigravityGlobal.agent.md +38 -135
- package/code-assistants/antigravity-assistant/GEMINI.md +37 -137
- package/code-assistants/claude-assistant/CLAUDE.md +60 -38
- package/code-assistants/copilot-assistant/agent-assistant.agent.md +44 -125
- package/code-assistants/cursor-assistant/.cursorrules +42 -84
- package/code-assistants/cursor-assistant/rules/agent-assistant.mdc +37 -135
- package/commands/ask/fast.md +6 -4
- package/commands/ask/hard.md +6 -4
- package/commands/ask.md +3 -3
- package/commands/auto.md +3 -3
- package/commands/brainstorm/fast.md +6 -4
- package/commands/brainstorm/hard.md +6 -4
- package/commands/brainstorm.md +3 -3
- package/commands/code/fast.md +6 -4
- package/commands/code/focus.md +22 -46
- package/commands/code/hard.md +23 -48
- package/commands/code.md +3 -3
- package/commands/cook/fast.md +5 -3
- package/commands/cook/focus.md +22 -51
- package/commands/cook/hard.md +23 -55
- package/commands/cook.md +3 -3
- package/commands/debug/fast.md +5 -3
- package/commands/debug/focus.md +35 -40
- package/commands/debug/hard.md +38 -16
- package/commands/debug.md +3 -3
- package/commands/deploy/check.md +4 -4
- package/commands/deploy/preview.md +4 -4
- package/commands/deploy/production.md +4 -4
- package/commands/deploy/rollback.md +4 -4
- package/commands/deploy.md +3 -3
- package/commands/design/fast.md +6 -4
- package/commands/design/focus.md +28 -44
- package/commands/design/hard.md +53 -17
- package/commands/design.md +3 -3
- package/commands/docs/audit.md +5 -5
- package/commands/docs/business.md +5 -5
- package/commands/docs/core.md +5 -5
- package/commands/docs.md +3 -3
- package/commands/fix/fast.md +5 -3
- package/commands/fix/focus.md +36 -44
- package/commands/fix/hard.md +23 -37
- package/commands/fix.md +3 -3
- package/commands/plan/fast.md +6 -4
- package/commands/plan/focus.md +6 -4
- package/commands/plan/hard.md +6 -4
- package/commands/plan.md +3 -3
- package/commands/report/fast.md +6 -4
- package/commands/report/focus.md +6 -4
- package/commands/report/hard.md +6 -4
- package/commands/report.md +3 -3
- package/commands/review/fast.md +5 -3
- package/commands/review/hard.md +5 -3
- package/commands/review.md +3 -3
- package/commands/test/fast.md +5 -3
- package/commands/test/focus.md +24 -43
- package/commands/test/hard.md +24 -16
- package/commands/test.md +3 -3
- package/documents/HSOL-ASSESSMENT.md +121 -0
- package/documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md +1341 -0
- package/documents/business/business-glossary.md +6 -6
- package/documents/knowledge-architecture.md +81 -1
- package/documents/knowledge-domain.md +4 -3
- package/documents/knowledge-overview.md +1 -1
- package/documents/knowledge-source-base.md +15 -10
- package/package.json +2 -2
- package/rules/AGENTS.md +187 -0
- package/rules/CONTEXT-GATE.md +362 -0
- package/rules/CORE.md +175 -0
- package/rules/ERRORS.md +127 -0
- package/rules/PHASES.md +156 -0
- package/rules/REFERENCE.md +179 -0
- package/rules/SKILLS.md +167 -0
- package/skills/find-skills/SKILL.md +137 -0
- package/rules/ADAPTIVE-EXECUTION.md +0 -271
- package/rules/AGENT-RULES.md +0 -285
- package/rules/BOOTSTRAP.md +0 -301
- package/rules/ERROR-RECOVERY.md +0 -201
- package/rules/EXECUTION-PROTOCOL.md +0 -485
- package/rules/ORCHESTRATION-LAWS.md +0 -218
- package/rules/QUICK-REFERENCE.md +0 -204
- package/rules/SKILL-DISCOVERY.md +0 -370
package/commands/ask/fast.md
CHANGED
|
@@ -17,17 +17,19 @@ execution-mode: execute
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
20
|
+
1. CORE.md — Identity, Laws, Routing
|
|
21
|
+
2. PHASES.md — Phase Execution
|
|
22
|
+
3. AGENTS.md — Tiered Execution
|
|
23
23
|
|
|
24
24
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
25
25
|
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand. Fast variant uses matrix-only (no dynamic discovery for speed optimization).
|
|
27
|
+
|
|
26
28
|
---
|
|
27
29
|
|
|
28
30
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
29
31
|
|
|
30
|
-
> **Reference
|
|
32
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
31
33
|
|
|
32
34
|
```yaml
|
|
33
35
|
tiered_execution:
|
package/commands/ask/hard.md
CHANGED
|
@@ -17,17 +17,19 @@ execution-mode: execute
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
20
|
+
1. CORE.md — Identity, Laws, Routing
|
|
21
|
+
2. PHASES.md — Phase Execution
|
|
22
|
+
3. AGENTS.md — Tiered Execution
|
|
23
23
|
|
|
24
24
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
25
25
|
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
|
|
27
|
+
|
|
26
28
|
---
|
|
27
29
|
|
|
28
30
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
29
31
|
|
|
30
|
-
> **Reference
|
|
32
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
31
33
|
|
|
32
34
|
```yaml
|
|
33
35
|
tiered_execution:
|
package/commands/ask.md
CHANGED
|
@@ -16,9 +16,9 @@ execution-mode: router
|
|
|
16
16
|
## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS EXECUTION)
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
|
-
1.
|
|
20
|
-
2.
|
|
21
|
-
3.
|
|
19
|
+
1. CORE.md — Identity, Laws, Routing
|
|
20
|
+
2. PHASES.md — Phase Execution
|
|
21
|
+
3. AGENTS.md — Tiered Execution
|
|
22
22
|
|
|
23
23
|
**⛔ Do not run any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant workflow, and execute it.
|
|
24
24
|
|
package/commands/auto.md
CHANGED
|
@@ -16,9 +16,9 @@ execution-mode: router
|
|
|
16
16
|
## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS EXECUTION)
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
|
-
1.
|
|
20
|
-
2.
|
|
21
|
-
3.
|
|
19
|
+
1. CORE.md — Identity, Laws, Routing
|
|
20
|
+
2. PHASES.md — Phase Execution
|
|
21
|
+
3. AGENTS.md — Tiered Execution
|
|
22
22
|
|
|
23
23
|
**⛔ Do not run any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant workflow, and execute it.
|
|
24
24
|
|
|
@@ -17,17 +17,19 @@ execution-mode: execute
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
20
|
+
1. CORE.md — Identity, Laws, Routing
|
|
21
|
+
2. PHASES.md — Phase Execution
|
|
22
|
+
3. AGENTS.md — Tiered Execution
|
|
23
23
|
|
|
24
24
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
25
25
|
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand. Fast variant uses matrix-only (no dynamic discovery for speed optimization).
|
|
27
|
+
|
|
26
28
|
---
|
|
27
29
|
|
|
28
30
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
29
31
|
|
|
30
|
-
> **Reference
|
|
32
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
31
33
|
|
|
32
34
|
```yaml
|
|
33
35
|
tiered_execution:
|
|
@@ -17,17 +17,19 @@ execution-mode: execute
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
20
|
+
1. CORE.md — Identity, Laws, Routing
|
|
21
|
+
2. PHASES.md — Phase Execution
|
|
22
|
+
3. AGENTS.md — Tiered Execution
|
|
23
23
|
|
|
24
24
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
25
25
|
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
|
|
27
|
+
|
|
26
28
|
---
|
|
27
29
|
|
|
28
30
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
29
31
|
|
|
30
|
-
> **Reference
|
|
32
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
31
33
|
|
|
32
34
|
```yaml
|
|
33
35
|
tiered_execution:
|
package/commands/brainstorm.md
CHANGED
|
@@ -16,9 +16,9 @@ execution-mode: router
|
|
|
16
16
|
## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS EXECUTION)
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
|
-
1.
|
|
20
|
-
2.
|
|
21
|
-
3.
|
|
19
|
+
1. CORE.md — Identity, Laws, Routing
|
|
20
|
+
2. PHASES.md — Phase Execution
|
|
21
|
+
3. AGENTS.md — Tiered Execution
|
|
22
22
|
|
|
23
23
|
**⛔ Do not run any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant workflow, and execute it.
|
|
24
24
|
|
package/commands/code/fast.md
CHANGED
|
@@ -17,17 +17,19 @@ execution-mode: execute
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
20
|
+
1. CORE.md — Identity, Laws, Routing
|
|
21
|
+
2. PHASES.md — Phase Execution
|
|
22
|
+
3. AGENTS.md — Tiered Execution
|
|
23
23
|
|
|
24
24
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
25
25
|
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand. Fast variant uses matrix-only (no dynamic discovery for speed optimization).
|
|
27
|
+
|
|
26
28
|
---
|
|
27
29
|
|
|
28
30
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
29
31
|
|
|
30
|
-
> **Reference
|
|
32
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
31
33
|
|
|
32
34
|
```yaml
|
|
33
35
|
tiered_execution:
|
package/commands/code/focus.md
CHANGED
|
@@ -20,12 +20,14 @@ execution-mode: execute
|
|
|
20
20
|
|
|
21
21
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
22
22
|
|
|
23
|
-
1.
|
|
24
|
-
2.
|
|
25
|
-
3.
|
|
23
|
+
1. CORE.md — Identity, Laws, Routing
|
|
24
|
+
2. PHASES.md — Phase Execution
|
|
25
|
+
3. AGENTS.md — Tiered Execution
|
|
26
26
|
|
|
27
27
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
28
28
|
|
|
29
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (focus variant enables find-skills for superior skill matching).
|
|
30
|
+
|
|
29
31
|
---
|
|
30
32
|
|
|
31
33
|
## 📌 PLAN-ALREADY-PROVIDED: SKIP REDUNDANT PHASES
|
|
@@ -50,7 +52,7 @@ execution-mode: execute
|
|
|
50
52
|
|
|
51
53
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
52
54
|
|
|
53
|
-
> **Reference
|
|
55
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
54
56
|
|
|
55
57
|
```yaml
|
|
56
58
|
tiered_execution:
|
|
@@ -180,56 +182,30 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
180
182
|
|
|
181
183
|
---
|
|
182
184
|
|
|
183
|
-
## 🛡️
|
|
185
|
+
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
184
186
|
|
|
185
|
-
>
|
|
187
|
+
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
188
|
+
>
|
|
189
|
+
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
|
|
186
190
|
>
|
|
187
|
-
>
|
|
188
|
-
> This acts as a mandatory "firewall" between Planning and Implementation phases.
|
|
191
|
+
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
189
192
|
|
|
190
|
-
###
|
|
193
|
+
### ⚡ EXECUTION
|
|
191
194
|
|
|
192
195
|
```yaml
|
|
193
|
-
|
|
194
|
-
mode: "
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
✅ **Plan Complete**: `./reports/plans/PLAN-{task}.md`
|
|
202
|
-
🔒 **Focus Mode**: Automatically clearing context for implementation.
|
|
203
|
-
|
|
204
|
-
⚡ Executing: **Clear context & Auto-Implement**...
|
|
205
|
-
|
|
206
|
-
2. CONTEXT_DIRECTIVE: |
|
|
207
|
-
╔══════════════════════════════════════════════════════════════════╗
|
|
208
|
-
║ ⛔ MANDATORY CONTEXT RESET — FOCUS MODE ║
|
|
209
|
-
╠══════════════════════════════════════════════════════════════════╣
|
|
210
|
-
║ IGNORE: All previous chat messages, reasoning chains, ║
|
|
211
|
-
║ brainstorming discussions, research explorations, ║
|
|
212
|
-
║ rejected alternatives, and intermediate thinking. ║
|
|
213
|
-
║ ║
|
|
214
|
-
║ SOLE SOURCE OF TRUTH: `./reports/plans/PLAN-{task}.md` ║
|
|
215
|
-
║ ║
|
|
216
|
-
║ PROCEED: Begin Implementation phase with FRESH context mindset. ║
|
|
217
|
-
║ Treat this as a NEW conversation starting from Plan. ║
|
|
218
|
-
╚══════════════════════════════════════════════════════════════════╝
|
|
219
|
-
|
|
220
|
-
3. LOAD: Read Plan file completely as if seeing it for the first time
|
|
221
|
-
|
|
222
|
-
4. PROCEED: Start Phase 4 (Implementation) immediately
|
|
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"
|
|
223
204
|
```
|
|
224
205
|
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
```markdown
|
|
228
|
-
🔒 **Context Gate Passed**
|
|
206
|
+
**DO NOT proceed to Phase 4 until Context Gate completes.**
|
|
229
207
|
|
|
230
|
-
|
|
231
|
-
- Active context: Plan file only
|
|
232
|
-
- Mode: Fresh implementation start
|
|
208
|
+
Mode: Fresh implementation start
|
|
233
209
|
|
|
234
210
|
Proceeding to Implementation...
|
|
235
211
|
```
|
package/commands/code/hard.md
CHANGED
|
@@ -17,12 +17,14 @@ execution-mode: execute
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
20
|
+
1. CORE.md — Identity, Laws, Routing
|
|
21
|
+
2. PHASES.md — Phase Execution
|
|
22
|
+
3. AGENTS.md — Tiered Execution
|
|
23
23
|
|
|
24
24
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
25
25
|
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
|
|
27
|
+
|
|
26
28
|
---
|
|
27
29
|
|
|
28
30
|
## 📌 PLAN-ALREADY-PROVIDED: SKIP REDUNDANT PHASES
|
|
@@ -47,7 +49,7 @@ execution-mode: execute
|
|
|
47
49
|
|
|
48
50
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
49
51
|
|
|
50
|
-
> **Reference
|
|
52
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
51
53
|
|
|
52
54
|
```yaml
|
|
53
55
|
tiered_execution:
|
|
@@ -240,56 +242,29 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
240
242
|
> Long-running planning sessions fill context with noise that degrades code generation quality.
|
|
241
243
|
> This checkpoint acts as a "firewall" between Planning and Implementation phases.
|
|
242
244
|
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
```markdown
|
|
246
|
-
## 🛡️ Context Optimization Checkpoint
|
|
245
|
+
## 🛡️ VERIFICATION CHECKPOINT
|
|
247
246
|
|
|
248
|
-
|
|
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.
|
|
249
252
|
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
| Option | Action | Description |
|
|
253
|
-
|--------|--------|-------------|
|
|
254
|
-
| **1. 🚀 Clear context & Auto-Implement** | `RECOMMENDED` | Fresh start: Reload Plan file, ignore chat history, begin implementation immediately |
|
|
255
|
-
| **2. ⏸️ Clear context & Manual** | `SAFE` | Clear context, reload Plan, pause for your command before coding |
|
|
256
|
-
| **3. ⚠️ Continue (No Clear)** | `RISKY` | Proceed with full history attached (may cause hallucination) |
|
|
257
|
-
|
|
258
|
-
⏳ Awaiting selection...
|
|
259
|
-
```
|
|
260
|
-
|
|
261
|
-
### 🔄 EXECUTION BEHAVIOR
|
|
253
|
+
### ⚡ EXECUTION
|
|
262
254
|
|
|
263
255
|
```yaml
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
3. LOAD: Read Plan file completely
|
|
273
|
-
4. EXECUTE: Start Implementation phase with fresh context mindset
|
|
274
|
-
|
|
275
|
-
option_2_clear_manual:
|
|
276
|
-
behavior: "Clear and wait for explicit command"
|
|
277
|
-
steps:
|
|
278
|
-
1. ACKNOWLEDGE: "⏸️ Context cleared. Plan reloaded."
|
|
279
|
-
2. CONTEXT_DIRECTIVE: |
|
|
280
|
-
⛔ IGNORE all previous chat messages and reasoning chains.
|
|
281
|
-
✅ RELOAD: `./reports/plans/PLAN-{task}.md` as SOLE SOURCE OF TRUTH.
|
|
282
|
-
3. OUTPUT: "Ready for implementation. Type `/continue` or give specific instructions."
|
|
283
|
-
4. WAIT: For user command before proceeding
|
|
284
|
-
|
|
285
|
-
option_3_continue_no_clear:
|
|
286
|
-
behavior: "Proceed with caution - context rot risk"
|
|
287
|
-
steps:
|
|
288
|
-
1. WARN: "⚠️ Continuing with full history. Higher hallucination risk."
|
|
289
|
-
2. PROCEED: Continue to Phase 4 with existing context
|
|
290
|
-
3. MONITOR: Watch for signs of context confusion
|
|
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"
|
|
291
264
|
```
|
|
292
265
|
|
|
266
|
+
**DO NOT proceed to Phase 4 until user selects option.**
|
|
267
|
+
|
|
293
268
|
---
|
|
294
269
|
|
|
295
270
|
## 🎭 Phase 4: IMPLEMENTATION
|
package/commands/code.md
CHANGED
|
@@ -17,9 +17,9 @@ execution-mode: router
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
20
|
+
1. CORE.md — Identity, Laws, Routing
|
|
21
|
+
2. PHASES.md — Phase Execution
|
|
22
|
+
3. AGENTS.md — Tiered Execution
|
|
23
23
|
|
|
24
24
|
**⛔ Do not run any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant workflow, and execute it.
|
|
25
25
|
|
package/commands/cook/fast.md
CHANGED
|
@@ -17,12 +17,14 @@ execution-mode: execute
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
20
|
+
1. CORE.md — Identity, Laws, Routing
|
|
21
|
+
2. PHASES.md — Phase Execution
|
|
22
|
+
3. AGENTS.md — Tiered Execution
|
|
23
23
|
|
|
24
24
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
25
25
|
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand. Fast variant uses matrix-only (no dynamic discovery for speed optimization).
|
|
27
|
+
|
|
26
28
|
---
|
|
27
29
|
|
|
28
30
|
## 🔀 TIERED EXECUTION
|
package/commands/cook/focus.md
CHANGED
|
@@ -20,17 +20,19 @@ execution-mode: execute
|
|
|
20
20
|
|
|
21
21
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
22
22
|
|
|
23
|
-
1.
|
|
24
|
-
2.
|
|
25
|
-
3.
|
|
23
|
+
1. CORE.md — Identity, Laws, Routing
|
|
24
|
+
2. PHASES.md — Phase Execution
|
|
25
|
+
3. AGENTS.md — Tiered Execution
|
|
26
26
|
|
|
27
27
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
28
28
|
|
|
29
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (focus variant enables find-skills for superior skill matching).
|
|
30
|
+
|
|
29
31
|
---
|
|
30
32
|
|
|
31
33
|
## 🔀 TIERED EXECUTION
|
|
32
34
|
|
|
33
|
-
> Reference:
|
|
35
|
+
> Reference: AGENTS.md (Tiered Execution)`
|
|
34
36
|
|
|
35
37
|
| Tier | When | Action |
|
|
36
38
|
| ---------- | ----------------------------- | ---------------------------- |
|
|
@@ -76,7 +78,7 @@ All files in `./reports/` → English only.
|
|
|
76
78
|
|
|
77
79
|
## ⛔ INCREMENTAL EXECUTION (MANDATORY)
|
|
78
80
|
|
|
79
|
-
One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in one reply. No batching (load only what each phase needs). **Within each phase:** when doing a part, output it in format so user sees what's happening (announce before doing). Format: rules/
|
|
81
|
+
One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in one reply. No batching (load only what each phase needs). **Within each phase:** when doing a part, output it in format so user sees what's happening (announce before doing). Format: rules/PHASES.md § Phase output structure.
|
|
80
82
|
|
|
81
83
|
---
|
|
82
84
|
|
|
@@ -138,59 +140,28 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
138
140
|
|
|
139
141
|
---
|
|
140
142
|
|
|
141
|
-
## 🛡️
|
|
143
|
+
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
142
144
|
|
|
143
|
-
>
|
|
145
|
+
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
146
|
+
>
|
|
147
|
+
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
|
|
144
148
|
>
|
|
145
|
-
>
|
|
146
|
-
> This acts as a mandatory "firewall" between Planning and Implementation phases.
|
|
149
|
+
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
147
150
|
|
|
148
|
-
###
|
|
151
|
+
### ⚡ EXECUTION
|
|
149
152
|
|
|
150
153
|
```yaml
|
|
151
|
-
|
|
152
|
-
mode: "
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
✅ **Plan Complete**: `./reports/plans/PLAN-{feature}.md`
|
|
160
|
-
🔒 **Focus Mode**: Automatically clearing context for implementation.
|
|
161
|
-
|
|
162
|
-
⚡ Executing: **Clear context & Auto-Implement**...
|
|
163
|
-
|
|
164
|
-
2. CONTEXT_DIRECTIVE: |
|
|
165
|
-
╔══════════════════════════════════════════════════════════════════╗
|
|
166
|
-
║ ⛔ MANDATORY CONTEXT RESET — FOCUS MODE ║
|
|
167
|
-
╠══════════════════════════════════════════════════════════════════╣
|
|
168
|
-
║ IGNORE: All previous chat messages, reasoning chains, ║
|
|
169
|
-
║ brainstorming discussions, research explorations, ║
|
|
170
|
-
║ rejected alternatives, and intermediate thinking. ║
|
|
171
|
-
║ ║
|
|
172
|
-
║ SOLE SOURCE OF TRUTH: `./reports/plans/PLAN-{feature}.md` ║
|
|
173
|
-
║ ║
|
|
174
|
-
║ PROCEED: Begin Implementation phase with FRESH context mindset. ║
|
|
175
|
-
║ Treat this as a NEW conversation starting from Plan. ║
|
|
176
|
-
╚══════════════════════════════════════════════════════════════════╝
|
|
177
|
-
|
|
178
|
-
3. LOAD: Read Plan file completely as if seeing it for the first time
|
|
179
|
-
|
|
180
|
-
4. PROCEED: Start Phase 6 (Implementation) immediately
|
|
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"
|
|
181
162
|
```
|
|
182
163
|
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
```markdown
|
|
186
|
-
🔒 **Context Gate Passed**
|
|
187
|
-
|
|
188
|
-
- Previous context: DISCARDED
|
|
189
|
-
- Active context: Plan file only
|
|
190
|
-
- Mode: Fresh implementation start
|
|
191
|
-
|
|
192
|
-
Proceeding to Implementation...
|
|
193
|
-
```
|
|
164
|
+
**DO NOT proceed to Phase 6 until Context Gate completes.**
|
|
194
165
|
|
|
195
166
|
---
|
|
196
167
|
|
package/commands/cook/hard.md
CHANGED
|
@@ -17,17 +17,19 @@ execution-mode: execute
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
20
|
+
1. CORE.md — Identity, Laws, Routing
|
|
21
|
+
2. PHASES.md — Phase Execution
|
|
22
|
+
3. AGENTS.md — Tiered Execution
|
|
23
23
|
|
|
24
24
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
25
25
|
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
|
|
27
|
+
|
|
26
28
|
---
|
|
27
29
|
|
|
28
30
|
## 🔀 TIERED EXECUTION
|
|
29
31
|
|
|
30
|
-
> Reference:
|
|
32
|
+
> Reference: AGENTS.md (Tiered Execution)`
|
|
31
33
|
|
|
32
34
|
| Tier | When | Action |
|
|
33
35
|
| ---------- | ----------------------------- | ---------------------------- |
|
|
@@ -72,7 +74,7 @@ All files in `./reports/` → English only.
|
|
|
72
74
|
|
|
73
75
|
## ⛔ INCREMENTAL EXECUTION (MANDATORY)
|
|
74
76
|
|
|
75
|
-
One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in one reply. No batching (load only what each phase needs). **Within each phase:** when doing a part, output it in format so user sees what’s happening (announce before doing). Format: rules/
|
|
77
|
+
One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in one reply. No batching (load only what each phase needs). **Within each phase:** when doing a part, output it in format so user sees what’s happening (announce before doing). Format: rules/PHASES.md § Phase output structure.
|
|
76
78
|
|
|
77
79
|
---
|
|
78
80
|
|
|
@@ -134,63 +136,29 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
134
136
|
|
|
135
137
|
---
|
|
136
138
|
|
|
137
|
-
## 🛡️ VERIFICATION CHECKPOINT
|
|
139
|
+
## 🛡️ VERIFICATION CHECKPOINT
|
|
138
140
|
|
|
139
|
-
>
|
|
141
|
+
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
140
142
|
>
|
|
141
|
-
>
|
|
142
|
-
>
|
|
143
|
-
|
|
144
|
-
### ⚡ OPTIONS (Present to User)
|
|
145
|
-
|
|
146
|
-
```markdown
|
|
147
|
-
## 🛡️ Context Optimization Checkpoint
|
|
148
|
-
|
|
149
|
-
**Planning Complete** — Plan file created at: `./reports/plans/PLAN-{feature}.md`
|
|
150
|
-
|
|
151
|
-
**Choose how to proceed with implementation:**
|
|
152
|
-
|
|
153
|
-
| Option | Action | Description |
|
|
154
|
-
| -------------------------------- | ------------- | ------------------------------------------------------------------------------------ |
|
|
155
|
-
| **1. 🚀 Clear context & Auto-Implement** | `RECOMMENDED` | Fresh start: Reload Plan file, ignore chat history, begin implementation immediately |
|
|
156
|
-
| **2. ⏸️ Clear context & Manual** | `SAFE` | Clear context, reload Plan, pause for your command before coding |
|
|
157
|
-
| **3. ⚠️ Continue (No Clear)** | `RISKY` | Proceed with full history attached (may cause hallucination) |
|
|
158
|
-
|
|
159
|
-
⏳ Awaiting selection...
|
|
160
|
-
```
|
|
143
|
+
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE protocol
|
|
144
|
+
>
|
|
145
|
+
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
161
146
|
|
|
162
|
-
###
|
|
147
|
+
### ⚡ EXECUTION
|
|
163
148
|
|
|
164
149
|
```yaml
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
3. LOAD: Read Plan file completely
|
|
174
|
-
4. EXECUTE: Start Implementation phase with fresh context mindset
|
|
175
|
-
|
|
176
|
-
option_2_clear_manual:
|
|
177
|
-
behavior: "Clear and wait for explicit command"
|
|
178
|
-
steps:
|
|
179
|
-
1. ACKNOWLEDGE: "⏸️ Context cleared. Plan reloaded."
|
|
180
|
-
2. CONTEXT_DIRECTIVE: |
|
|
181
|
-
⛔ IGNORE all previous chat messages and reasoning chains.
|
|
182
|
-
✅ RELOAD: `./reports/plans/PLAN-{feature}.md` as SOLE SOURCE OF TRUTH.
|
|
183
|
-
3. OUTPUT: "Ready for implementation. Type `/continue` or give specific instructions."
|
|
184
|
-
4. WAIT: For user command before proceeding
|
|
185
|
-
|
|
186
|
-
option_3_continue_no_clear:
|
|
187
|
-
behavior: "Proceed with caution - context rot risk"
|
|
188
|
-
steps:
|
|
189
|
-
1. WARN: "⚠️ Continuing with full history. Higher hallucination risk."
|
|
190
|
-
2. PROCEED: Continue to Phase 6 with existing context
|
|
191
|
-
3. MONITOR: Watch for signs of context confusion
|
|
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"
|
|
192
158
|
```
|
|
193
159
|
|
|
160
|
+
**DO NOT proceed to Phase 6 until user selects option.**
|
|
161
|
+
|
|
194
162
|
---
|
|
195
163
|
|
|
196
164
|
## 🎭 Phase 6: IMPLEMENTATION
|
package/commands/cook.md
CHANGED
|
@@ -17,9 +17,9 @@ execution-mode: router
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
20
|
+
1. CORE.md — Identity, Laws, Routing
|
|
21
|
+
2. PHASES.md — Phase Execution
|
|
22
|
+
3. AGENTS.md — Tiered Execution
|
|
23
23
|
|
|
24
24
|
**⛔ Do not run any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant workflow, and execute it.
|
|
25
25
|
|
package/commands/debug/fast.md
CHANGED
|
@@ -16,12 +16,14 @@ execution-mode: execute
|
|
|
16
16
|
## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
|
-
1.
|
|
20
|
-
2.
|
|
21
|
-
3.
|
|
19
|
+
1. CORE.md — Identity, Laws, Routing
|
|
20
|
+
2. PHASES.md — Phase Execution
|
|
21
|
+
3. AGENTS.md — Tiered Execution
|
|
22
22
|
|
|
23
23
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
24
24
|
|
|
25
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand. Fast variant uses matrix-only (no dynamic discovery for speed optimization).
|
|
26
|
+
|
|
25
27
|
---
|
|
26
28
|
|
|
27
29
|
## 🔀 TIERED EXECUTION
|