@namch/agent-assistant 1.0.3 → 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 +78 -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 +42 -46
  21. package/commands/code/hard.md +43 -48
  22. package/commands/code.md +6 -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 +5 -3
  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,17 +20,39 @@ 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
+
31
+ ---
32
+
33
+ ## 📌 PLAN-ALREADY-PROVIDED: SKIP REDUNDANT PHASES
34
+
35
+ **Before starting Phase 1**, resolve whether the user is **coding from an existing plan**. If yes, **do not** run research, scout, or brainstorm.
36
+
37
+ ### Detection
38
+
39
+ - User message references a plan: e.g. `@plan`, `@PLAN-...`, path like `./reports/plans/PLAN-{name}.md`, or phrases like "according to plan", "follow the plan", "code from plan", "implement per plan".
40
+ - Or a plan file already exists for this task at `./reports/plans/PLAN-{task}.md` (derive `{task}` from `$ARGUMENTS` or from the referenced file name).
41
+
42
+ ### Resolution
43
+
44
+ 1. **CHECK**: Does a valid plan file exist (user-provided path or `./reports/plans/PLAN-{task}.md`)?
45
+ 2. **IF YES**:
46
+ - **SKIP** Phase 1 (Requirements/Brainstorm), Phase 2 (Scout), Phase 3 (Planning).
47
+ - **ANNOUNCE**: "✅ Plan provided/found — skipping research, scout, and planning. Proceeding to implementation."
48
+ - **GO TO**: Strict Context Gate (automatic) → then Phase 4 (Implementation) → Phase 5 (Testing) → Phase 6 (Review).
49
+ 3. **IF NO**: Run phases in order: Phase 1 → 2 → 3 → Context Gate → 4 → 5 → 6.
50
+
29
51
  ---
30
52
 
31
53
  ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
32
54
 
33
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
55
+ > **Reference: AGENTS.md (Tiered Execution)`
34
56
 
35
57
  ```yaml
36
58
  tiered_execution:
@@ -160,56 +182,30 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
160
182
 
161
183
  ---
162
184
 
163
- ## 🛡️ STRICT CONTEXT GATE — Automatic Context Optimization
185
+ ## 🛡️ CONTEXT GATE CHECKPOINT
164
186
 
165
- > **⚡ FOCUS MODE**: This checkpoint executes automatically. NO user input required.
187
+ > **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
166
188
  >
167
- > **PURPOSE**: Prevent "context rot" by forcibly clearing noisy planning history.
168
- > This acts as a mandatory "firewall" between Planning and Implementation phases.
189
+ > **LOAD**: `rules/CONTEXT-GATE.md` Execute FOCUS MODE protocol
190
+ >
191
+ > This is a MANDATORY checkpoint. Cannot skip or bypass.
169
192
 
170
- ### 🔒 AUTOMATIC EXECUTION (NO PROMPT)
193
+ ### EXECUTION
171
194
 
172
195
  ```yaml
173
- strict_context_gate:
174
- mode: "AUTOMATIC - No user interaction"
175
- behavior: "Force Clear context & Auto-Implement"
176
-
177
- execution:
178
- 1. ANNOUNCE: |
179
- ## 🛡️ Strict Context Gate Automatic
180
-
181
- ✅ **Plan Complete**: `./reports/plans/PLAN-{task}.md`
182
- 🔒 **Focus Mode**: Automatically clearing context for implementation.
183
-
184
- ⚡ Executing: **Clear context & Auto-Implement**...
185
-
186
- 2. CONTEXT_DIRECTIVE: |
187
- ╔══════════════════════════════════════════════════════════════════╗
188
- ║ ⛔ MANDATORY CONTEXT RESET — FOCUS MODE ║
189
- ╠══════════════════════════════════════════════════════════════════╣
190
- ║ IGNORE: All previous chat messages, reasoning chains, ║
191
- ║ brainstorming discussions, research explorations, ║
192
- ║ rejected alternatives, and intermediate thinking. ║
193
- ║ ║
194
- ║ SOLE SOURCE OF TRUTH: `./reports/plans/PLAN-{task}.md` ║
195
- ║ ║
196
- ║ PROCEED: Begin Implementation phase with FRESH context mindset. ║
197
- ║ Treat this as a NEW conversation starting from Plan. ║
198
- ╚══════════════════════════════════════════════════════════════════╝
199
-
200
- 3. LOAD: Read Plan file completely as if seeing it for the first time
201
-
202
- 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"
203
204
  ```
204
205
 
205
- ### 📋 Post-Gate Status
206
-
207
- ```markdown
208
- 🔒 **Context Gate Passed**
206
+ **DO NOT proceed to Phase 4 until Context Gate completes.**
209
207
 
210
- - Previous context: DISCARDED
211
- - Active context: Plan file only
212
- - Mode: Fresh implementation start
208
+ Mode: Fresh implementation start
213
209
 
214
210
  Proceeding to Implementation...
215
211
  ```
@@ -17,17 +17,39 @@ 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
+
28
+ ---
29
+
30
+ ## 📌 PLAN-ALREADY-PROVIDED: SKIP REDUNDANT PHASES
31
+
32
+ **Before starting Phase 1**, resolve whether the user is **coding from an existing plan**. If yes, **do not** run research, scout, or brainstorm.
33
+
34
+ ### Detection
35
+
36
+ - User message references a plan: e.g. `@plan`, `@PLAN-...`, path like `./reports/plans/PLAN-{name}.md`, or phrases like "according to plan", "follow the plan", "code from plan", "implement per plan".
37
+ - Or a plan file already exists for this task at `./reports/plans/PLAN-{task}.md` (derive `{task}` from `$ARGUMENTS` or from the referenced file name).
38
+
39
+ ### Resolution
40
+
41
+ 1. **CHECK**: Does a valid plan file exist (user-provided path or `./reports/plans/PLAN-{task}.md`)?
42
+ 2. **IF YES**:
43
+ - **SKIP** Phase 1 (Requirements/Brainstorm), Phase 2 (Scout), Phase 3 (Planning).
44
+ - **ANNOUNCE**: "✅ Plan provided/found — skipping research, scout, and planning. Proceeding to implementation."
45
+ - **GO TO**: Verification Checkpoint (Context Optimization) → then Phase 4 (Implementation) → Phase 5 (Testing) → Phase 6 (Review).
46
+ 3. **IF NO**: Run phases in order: Phase 1 → 2 → 3 → Checkpoint → 4 → 5 → 6.
47
+
26
48
  ---
27
49
 
28
50
  ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
29
51
 
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
52
+ > **Reference: AGENTS.md (Tiered Execution)`
31
53
 
32
54
  ```yaml
33
55
  tiered_execution:
@@ -220,56 +242,29 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
220
242
  > Long-running planning sessions fill context with noise that degrades code generation quality.
221
243
  > This checkpoint acts as a "firewall" between Planning and Implementation phases.
222
244
 
223
- ### OPTIONS (Present to User)
224
-
225
- ```markdown
226
- ## 🛡️ Context Optimization Checkpoint
245
+ ## 🛡️ VERIFICATION CHECKPOINT
227
246
 
228
- **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.
229
252
 
230
- **Choose how to proceed with implementation:**
231
-
232
- | Option | Action | Description |
233
- |--------|--------|-------------|
234
- | **1. 🚀 Clear context & Auto-Implement** | `RECOMMENDED` | Fresh start: Reload Plan file, ignore chat history, begin implementation immediately |
235
- | **2. ⏸️ Clear context & Manual** | `SAFE` | Clear context, reload Plan, pause for your command before coding |
236
- | **3. ⚠️ Continue (No Clear)** | `RISKY` | Proceed with full history attached (may cause hallucination) |
237
-
238
- ⏳ Awaiting selection...
239
- ```
240
-
241
- ### 🔄 EXECUTION BEHAVIOR
253
+ ### EXECUTION
242
254
 
243
255
  ```yaml
244
- option_1_clear_auto_implement:
245
- behavior: "RECOMMENDED - Simulate fresh start"
246
- steps:
247
- 1. ACKNOWLEDGE: "🚀 Executing Clear context & Auto-Implement..."
248
- 2. CONTEXT_DIRECTIVE: |
249
- ⛔ IGNORE all previous chat messages and reasoning chains.
250
- ✅ RELOAD: `./reports/plans/PLAN-{task}.md` as SOLE SOURCE OF TRUTH.
251
- ✅ PROCEED: Begin Phase 4 (Implementation) immediately.
252
- 3. LOAD: Read Plan file completely
253
- 4. EXECUTE: Start Implementation phase with fresh context mindset
254
-
255
- option_2_clear_manual:
256
- behavior: "Clear and wait for explicit command"
257
- steps:
258
- 1. ACKNOWLEDGE: "⏸️ Context cleared. Plan reloaded."
259
- 2. CONTEXT_DIRECTIVE: |
260
- ⛔ IGNORE all previous chat messages and reasoning chains.
261
- ✅ RELOAD: `./reports/plans/PLAN-{task}.md` as SOLE SOURCE OF TRUTH.
262
- 3. OUTPUT: "Ready for implementation. Type `/continue` or give specific instructions."
263
- 4. WAIT: For user command before proceeding
264
-
265
- option_3_continue_no_clear:
266
- behavior: "Proceed with caution - context rot risk"
267
- steps:
268
- 1. WARN: "⚠️ Continuing with full history. Higher hallucination risk."
269
- 2. PROCEED: Continue to Phase 4 with existing context
270
- 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"
271
264
  ```
272
265
 
266
+ **DO NOT proceed to Phase 4 until user selects option.**
267
+
273
268
  ---
274
269
 
275
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
 
@@ -28,6 +28,9 @@ execution-mode: router
28
28
  ## ROUTING LOGIC
29
29
 
30
30
  ```
31
+ IF user references an existing plan (@plan, @PLAN-..., path to PLAN-*.md, or "according to plan" / "follow the plan"):
32
+ → Route to /code:hard or /code:focus (workflow will SKIP research, scout, brainstorm and go straight to implementation)
33
+
31
34
  IF task is simple (clear requirements, single file):
32
35
  → Route to /code:fast
33
36
 
@@ -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