@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.
Files changed (86) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/README.md +1 -1
  3. package/agents/planner.md +59 -11
  4. package/agents/reporter.md +1 -1
  5. package/cli/install.js +514 -169
  6. package/code-assistants/antigravity-assistant/AntigravityGlobal.agent.md +38 -135
  7. package/code-assistants/antigravity-assistant/GEMINI.md +37 -137
  8. package/code-assistants/claude-assistant/CLAUDE.md +60 -38
  9. package/code-assistants/copilot-assistant/agent-assistant.agent.md +44 -125
  10. package/code-assistants/cursor-assistant/.cursorrules +42 -84
  11. package/code-assistants/cursor-assistant/rules/agent-assistant.mdc +37 -135
  12. package/commands/ask/fast.md +6 -4
  13. package/commands/ask/hard.md +6 -4
  14. package/commands/ask.md +3 -3
  15. package/commands/auto.md +3 -3
  16. package/commands/brainstorm/fast.md +6 -4
  17. package/commands/brainstorm/hard.md +6 -4
  18. package/commands/brainstorm.md +3 -3
  19. package/commands/code/fast.md +6 -4
  20. package/commands/code/focus.md +22 -46
  21. package/commands/code/hard.md +23 -48
  22. package/commands/code.md +3 -3
  23. package/commands/cook/fast.md +5 -3
  24. package/commands/cook/focus.md +22 -51
  25. package/commands/cook/hard.md +23 -55
  26. package/commands/cook.md +3 -3
  27. package/commands/debug/fast.md +5 -3
  28. package/commands/debug/focus.md +35 -40
  29. package/commands/debug/hard.md +38 -16
  30. package/commands/debug.md +3 -3
  31. package/commands/deploy/check.md +4 -4
  32. package/commands/deploy/preview.md +4 -4
  33. package/commands/deploy/production.md +4 -4
  34. package/commands/deploy/rollback.md +4 -4
  35. package/commands/deploy.md +3 -3
  36. package/commands/design/fast.md +6 -4
  37. package/commands/design/focus.md +28 -44
  38. package/commands/design/hard.md +53 -17
  39. package/commands/design.md +3 -3
  40. package/commands/docs/audit.md +5 -5
  41. package/commands/docs/business.md +5 -5
  42. package/commands/docs/core.md +5 -5
  43. package/commands/docs.md +3 -3
  44. package/commands/fix/fast.md +5 -3
  45. package/commands/fix/focus.md +36 -44
  46. package/commands/fix/hard.md +23 -37
  47. package/commands/fix.md +3 -3
  48. package/commands/plan/fast.md +6 -4
  49. package/commands/plan/focus.md +6 -4
  50. package/commands/plan/hard.md +6 -4
  51. package/commands/plan.md +3 -3
  52. package/commands/report/fast.md +6 -4
  53. package/commands/report/focus.md +6 -4
  54. package/commands/report/hard.md +6 -4
  55. package/commands/report.md +3 -3
  56. package/commands/review/fast.md +5 -3
  57. package/commands/review/hard.md +5 -3
  58. package/commands/review.md +3 -3
  59. package/commands/test/fast.md +5 -3
  60. package/commands/test/focus.md +24 -43
  61. package/commands/test/hard.md +24 -16
  62. package/commands/test.md +3 -3
  63. package/documents/HSOL-ASSESSMENT.md +121 -0
  64. package/documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md +1341 -0
  65. package/documents/business/business-glossary.md +6 -6
  66. package/documents/knowledge-architecture.md +81 -1
  67. package/documents/knowledge-domain.md +4 -3
  68. package/documents/knowledge-overview.md +1 -1
  69. package/documents/knowledge-source-base.md +15 -10
  70. package/package.json +2 -2
  71. package/rules/AGENTS.md +187 -0
  72. package/rules/CONTEXT-GATE.md +362 -0
  73. package/rules/CORE.md +175 -0
  74. package/rules/ERRORS.md +127 -0
  75. package/rules/PHASES.md +156 -0
  76. package/rules/REFERENCE.md +179 -0
  77. package/rules/SKILLS.md +167 -0
  78. package/skills/find-skills/SKILL.md +137 -0
  79. package/rules/ADAPTIVE-EXECUTION.md +0 -271
  80. package/rules/AGENT-RULES.md +0 -285
  81. package/rules/BOOTSTRAP.md +0 -301
  82. package/rules/ERROR-RECOVERY.md +0 -201
  83. package/rules/EXECUTION-PROTOCOL.md +0 -485
  84. package/rules/ORCHESTRATION-LAWS.md +0 -218
  85. package/rules/QUICK-REFERENCE.md +0 -204
  86. package/rules/SKILL-DISCOVERY.md +0 -370
@@ -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. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
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**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
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. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
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**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
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. ORCHESTRATION-LAWS.md
20
- 2. ADAPTIVE-EXECUTION.md
21
- 3. EXECUTION-PROTOCOL.md
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. ORCHESTRATION-LAWS.md
20
- 2. ADAPTIVE-EXECUTION.md
21
- 3. EXECUTION-PROTOCOL.md
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. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
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**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
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. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
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**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
32
+ > **Reference: AGENTS.md (Tiered Execution)`
31
33
 
32
34
  ```yaml
33
35
  tiered_execution:
@@ -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. ORCHESTRATION-LAWS.md
20
- 2. ADAPTIVE-EXECUTION.md
21
- 3. EXECUTION-PROTOCOL.md
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. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
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**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
32
+ > **Reference: AGENTS.md (Tiered Execution)`
31
33
 
32
34
  ```yaml
33
35
  tiered_execution:
@@ -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. ORCHESTRATION-LAWS.md
24
- 2. ADAPTIVE-EXECUTION.md
25
- 3. EXECUTION-PROTOCOL.md
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**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
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
- ## 🛡️ STRICT CONTEXT GATE — Automatic Context Optimization
185
+ ## 🛡️ CONTEXT GATE CHECKPOINT
184
186
 
185
- > **⚡ FOCUS MODE**: This checkpoint executes automatically. NO user input required.
187
+ > **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
188
+ >
189
+ > **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
186
190
  >
187
- > **PURPOSE**: Prevent "context rot" by forcibly clearing noisy planning history.
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
- ### 🔒 AUTOMATIC EXECUTION (NO PROMPT)
193
+ ### EXECUTION
191
194
 
192
195
  ```yaml
193
- strict_context_gate:
194
- mode: "AUTOMATIC - No user interaction"
195
- behavior: "Force Clear context & Auto-Implement"
196
-
197
- execution:
198
- 1. ANNOUNCE: |
199
- ## 🛡️ Strict Context Gate Automatic
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
- ### 📋 Post-Gate Status
226
-
227
- ```markdown
228
- 🔒 **Context Gate Passed**
206
+ **DO NOT proceed to Phase 4 until Context Gate completes.**
229
207
 
230
- - Previous context: DISCARDED
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
  ```
@@ -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. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
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**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
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
- ### OPTIONS (Present to User)
244
-
245
- ```markdown
246
- ## 🛡️ Context Optimization Checkpoint
245
+ ## 🛡️ VERIFICATION CHECKPOINT
247
246
 
248
- **Planning Complete** Plan file created at: `./reports/plans/PLAN-{task}.md`
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
- **Choose how to proceed with implementation:**
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
- option_1_clear_auto_implement:
265
- behavior: "RECOMMENDED - Simulate fresh start"
266
- steps:
267
- 1. ACKNOWLEDGE: "🚀 Executing Clear context & Auto-Implement..."
268
- 2. CONTEXT_DIRECTIVE: |
269
- ⛔ IGNORE all previous chat messages and reasoning chains.
270
- ✅ RELOAD: `./reports/plans/PLAN-{task}.md` as SOLE SOURCE OF TRUTH.
271
- ✅ PROCEED: Begin Phase 4 (Implementation) immediately.
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. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
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
 
@@ -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. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
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
@@ -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. ORCHESTRATION-LAWS.md
24
- 2. ADAPTIVE-EXECUTION.md
25
- 3. EXECUTION-PROTOCOL.md
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: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
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/EXECUTION-PROTOCOL.md § Phase output structure.
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
- ## 🛡️ STRICT CONTEXT GATE — Automatic Context Optimization
143
+ ## 🛡️ CONTEXT GATE CHECKPOINT
142
144
 
143
- > **⚡ FOCUS MODE**: This checkpoint executes automatically. NO user input required.
145
+ > **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
146
+ >
147
+ > **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
144
148
  >
145
- > **PURPOSE**: Prevent "context rot" by forcibly clearing noisy planning history.
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
- ### 🔒 AUTOMATIC EXECUTION (NO PROMPT)
151
+ ### EXECUTION
149
152
 
150
153
  ```yaml
151
- strict_context_gate:
152
- mode: "AUTOMATIC - No user interaction"
153
- behavior: "Force Clear context & Auto-Implement"
154
-
155
- execution:
156
- 1. ANNOUNCE: |
157
- ## 🛡️ Strict Context Gate Automatic
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
- ### 📋 Post-Gate Status
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
 
@@ -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. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
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: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
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/EXECUTION-PROTOCOL.md § Phase output structure.
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 — Context Optimization
139
+ ## 🛡️ VERIFICATION CHECKPOINT
138
140
 
139
- > **PURPOSE**: Prevent "context rot" by clearing noisy planning history before implementation.
141
+ > **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
140
142
  >
141
- > Long-running planning sessions fill context with noise that degrades code generation quality.
142
- > This checkpoint acts as a "firewall" between Planning and Implementation phases.
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
- ### 🔄 EXECUTION BEHAVIOR
147
+ ### EXECUTION
163
148
 
164
149
  ```yaml
165
- option_1_clear_auto_implement:
166
- behavior: "RECOMMENDED - Simulate fresh start"
167
- steps:
168
- 1. ACKNOWLEDGE: "🚀 Executing Clear context & Auto-Implement..."
169
- 2. CONTEXT_DIRECTIVE: |
170
- ⛔ IGNORE all previous chat messages and reasoning chains.
171
- ✅ RELOAD: `./reports/plans/PLAN-{feature}.md` as SOLE SOURCE OF TRUTH.
172
- ✅ PROCEED: Begin Phase 6 (Implementation) immediately.
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. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
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
 
@@ -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. ORCHESTRATION-LAWS.md
20
- 2. ADAPTIVE-EXECUTION.md
21
- 3. EXECUTION-PROTOCOL.md
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