@namch/agent-assistant 1.0.4 → 1.1.1

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 +46 -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 +532 -171
  6. package/code-assistants/antigravity-assistant/AntigravityGlobal.agent.md +64 -114
  7. package/code-assistants/antigravity-assistant/GEMINI.md +81 -106
  8. package/code-assistants/claude-assistant/CLAUDE.md +60 -38
  9. package/code-assistants/copilot-assistant/agent-assistant.agent.md +135 -118
  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 +22 -17
  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 +188 -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
@@ -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 PROTOCOL (MANDATORY)
32
34
 
33
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
35
+ > **Reference: AGENTS.md (Tiered Execution)`
34
36
 
35
37
  ```yaml
36
38
  tiered_execution:
@@ -176,54 +178,36 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
176
178
 
177
179
  ---
178
180
 
179
- ## 🛡️ STRICT CONTEXT GATE — Automatic Context Optimization
181
+ ## 🛡️ CONTEXT GATE CHECKPOINT
180
182
 
181
- > **⚡ FOCUS MODE**: This checkpoint executes automatically. NO user input required.
182
- >
183
- > **PURPOSE**: Prevent "context rot" by forcibly clearing noisy design exploration history.
184
- > This acts as a mandatory "firewall" before review and implementation handoff.
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.
185
188
 
186
- ### 🔒 AUTOMATIC EXECUTION (NO PROMPT)
189
+ ### EXECUTION
187
190
 
188
191
  ```yaml
189
- strict_context_gate:
190
- mode: "AUTOMATIC - No user interaction"
191
- behavior: "Force Clear context & Ready"
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"
192
196
 
193
- execution:
194
- 1. ANNOUNCE: |
195
- ## 🛡️ Strict Context Gate — Automatic
196
-
197
- ✅ **Design Complete**: `./reports/designs/DESIGN-{request}.md`
198
- 🔒 **Focus Mode**: Automatically clearing context for review/implementation.
199
-
200
- ⚡ Executing: **Clear context & Ready**...
201
-
202
- 2. CONTEXT_DIRECTIVE: |
203
- ╔══════════════════════════════════════════════════════════════════╗
204
- ║ ⛔ MANDATORY CONTEXT RESET — FOCUS MODE ║
205
- ╠══════════════════════════════════════════════════════════════════╣
206
- ║ IGNORE: All design exploration, rejected alternatives, ║
207
- ║ iteration history, and intermediate reasoning. ║
208
- ║ ║
209
- ║ SOLE SOURCE OF TRUTH: Design file in ./reports/designs/ ║
210
- ║ ║
211
- ║ PROCEED: Continue to Design Review with clean context. ║
212
- ║ Then handoff to implementation. ║
213
- ╚══════════════════════════════════════════════════════════════════╝
214
-
215
- 3. LOAD: Read Design file as if seeing it for the first time
216
-
217
- 4. PROCEED: Continue to Phase 5 (Design Review)
197
+ variant_adjustments:
198
+ remaining_phases: "Phase 5 (Design Review) → Implementation Handoff"
199
+ deliverable_file: "./reports/designs/DESIGN-{request}.md"
218
200
  ```
219
201
 
220
- ### 📋 Post-Gate Status
202
+ **DO NOT proceed to Phase 5 until Context Gate completes.**
203
+
204
+ ## ❌ Discarded:
205
+ - Design exploration noise
206
+ - Rejected alternatives
207
+ - Iteration history
208
+ - Chat history
221
209
 
222
- ```markdown
223
- 🔒 **Context Gate Passed**
224
- - Previous context: DISCARDED
225
- - Active context: Design file only
226
- - Mode: Clean review start
210
+ Mode: Clean review start
227
211
 
228
212
  Proceeding to Design Review...
229
213
  ```
@@ -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:
@@ -208,22 +210,56 @@ option_1_clear_ready:
208
210
  2. CONTEXT_DIRECTIVE: |
209
211
  ⛔ IGNORE all design exploration and rejected alternatives.
210
212
  ✅ DESIGN FILE is SOLE SOURCE OF TRUTH.
211
- 3. PROCEED: Continue to Design Review phase
212
-
213
- option_2_review_first:
214
- behavior: "Clear and show summary"
215
- steps:
216
- 1. ACKNOWLEDGE: "⏸️ Context cleared."
217
- 2. OUTPUT: Display design summary for user review
218
- 3. WAIT: For user approval
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
219
249
 
220
- option_3_continue_no_clear:
221
- behavior: "Proceed with caution"
222
- steps:
223
- 1. WARN: "⚠️ Design exploration history retained."
224
- 2. PROCEED: Continue to review with existing context
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"
225
259
  ```
226
260
 
261
+ **DO NOT proceed to Phase 5 until user selects option.**
262
+
227
263
  ---
228
264
 
229
265
  ## 🎭 Phase 5: DESIGN REVIEW
@@ -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,9 +17,9 @@ 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
 
@@ -27,7 +27,7 @@ execution-mode: execute
27
27
 
28
28
  ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
29
29
 
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
30
+ > **Reference: AGENTS.md (Tiered Execution)`
31
31
 
32
32
  ```yaml
33
33
  tiered_execution:
@@ -48,7 +48,7 @@ tiered_execution:
48
48
  > **MUST CREATE ALL 4 FILES**. Incomplete = FAILED execution.
49
49
 
50
50
  > **⛔ DOCUMENT LANGUAGE — NON-NEGOTIABLE**
51
- > Every file under `./documents/` must be written in **English only**. Do not use the user's language (e.g. Vietnamese) for file content. (ORCHESTRATION-LAWS § LAW 6.)
51
+ > Every file under `./documents/` must be written in **English only**. Do not use the user's language (e.g. Vietnamese) for file content. (CORE § LAW 6.)
52
52
 
53
53
  | File | Purpose |
54
54
  | -------------------------------------------- | -------------------------------- |
@@ -17,9 +17,9 @@ 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
 
@@ -27,7 +27,7 @@ execution-mode: execute
27
27
 
28
28
  ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
29
29
 
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
30
+ > **Reference: AGENTS.md (Tiered Execution)`
31
31
 
32
32
  ```yaml
33
33
  tiered_execution:
@@ -48,7 +48,7 @@ tiered_execution:
48
48
  > **MUST CREATE ALL 4 FILES**. Incomplete = FAILED execution.
49
49
 
50
50
  > **⛔ DOCUMENT LANGUAGE — NON-NEGOTIABLE**
51
- > Every file under `./documents/` must be written in **English only**. Do not use the user's language (e.g. Vietnamese) for file content. (ORCHESTRATION-LAWS § LAW 6.)
51
+ > Every file under `./documents/` must be written in **English only**. Do not use the user's language (e.g. Vietnamese) for file content. (CORE § LAW 6.)
52
52
 
53
53
  | File | Purpose |
54
54
  | -------------------------------------------- | ----------------------------- |
@@ -17,9 +17,9 @@ 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
 
@@ -27,7 +27,7 @@ execution-mode: execute
27
27
 
28
28
  ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
29
29
 
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
30
+ > **Reference: AGENTS.md (Tiered Execution)`
31
31
 
32
32
  ```yaml
33
33
  tiered_execution:
@@ -48,7 +48,7 @@ tiered_execution:
48
48
  > **MUST CREATE ALL 5 FILES**. Incomplete = FAILED execution.
49
49
 
50
50
  > **⛔ DOCUMENT LANGUAGE — NON-NEGOTIABLE**
51
- > Every file under `./documents/` must be written in **English only**. Headings, body text, tables, and lists must be in English. Do not use the user's language (e.g. Vietnamese) for file content. Chat/UI may follow user language; document files do not. (ORCHESTRATION-LAWS § LAW 6.)
51
+ > Every file under `./documents/` must be written in **English only**. Headings, body text, tables, and lists must be in English. Do not use the user's language (e.g. Vietnamese) for file content. Chat/UI may follow user language; document files do not. (CORE § LAW 6.)
52
52
 
53
53
  | File | Purpose |
54
54
  | --------------------------------------- | ------------------------------------------------------------- |
package/commands/docs.md CHANGED
@@ -17,9 +17,9 @@ 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 any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant (e.g. docs/core.md), 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
@@ -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
  ## 🔀 TIERED EXECUTION
@@ -52,7 +54,7 @@ All files in `./reports/` → English only.
52
54
 
53
55
  ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
54
56
 
55
- 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.
57
+ 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.
56
58
 
57
59
  ---
58
60
 
@@ -83,55 +85,45 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
83
85
 
84
86
  ---
85
87
 
86
- ## 🛡️ STRICT CONTEXT GATE — Automatic Context Optimization
88
+ ## 🛡️ CONTEXT GATE CHECKPOINT
87
89
 
88
- > **⚡ FOCUS MODE**: This checkpoint executes automatically. NO user input required.
90
+ > **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
91
+ >
92
+ > **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
89
93
  >
90
- > **PURPOSE**: Prevent "context rot" by forcibly clearing noisy debugging/planning history.
91
- > This acts as a mandatory "firewall" between Planning and Implementation phases.
94
+ > This is a MANDATORY checkpoint. Cannot skip or bypass.
92
95
 
93
- ### 🔒 AUTOMATIC EXECUTION (NO PROMPT)
96
+ ### EXECUTION
94
97
 
95
98
  ```yaml
96
- strict_context_gate:
97
- mode: "AUTOMATIC - No user interaction"
98
- behavior: "Force Clear context & Auto-Implement"
99
-
100
- execution:
101
- 1. ANNOUNCE: |
102
- ## 🛡️ Strict Context Gate Automatic
103
-
104
- ✅ **Fix Plan Complete**: Strategy defined with rollback.
105
- 🔒 **Focus Mode**: Automatically clearing context for implementation.
106
-
107
- ⚡ Executing: **Clear context & Auto-Implement**...
108
-
109
- 2. CONTEXT_DIRECTIVE: |
110
- ╔══════════════════════════════════════════════════════════════════╗
111
- ║ ⛔ MANDATORY CONTEXT RESET — FOCUS MODE ║
112
- ╠══════════════════════════════════════════════════════════════════╣
113
- ║ IGNORE: All previous debugging hypotheses, failed attempts, ║
114
- ║ research explorations, and intermediate reasoning. ║
115
- ║ ║
116
- ║ SOLE SOURCE OF TRUTH: Fix plan with rollback strategy. ║
117
- ║ ║
118
- ║ PROCEED: Begin Implementation phase with FRESH context mindset. ║
119
- ║ Treat this as a NEW conversation starting from Plan. ║
120
- ╚══════════════════════════════════════════════════════════════════╝
121
-
122
- 3. LOAD: Read Fix plan completely as if seeing it for the first time
123
-
124
- 4. PROCEED: Start Phase 4 (Implementation) immediately
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"
125
107
  ```
126
108
 
127
- ### 📋 Post-Gate Status
109
+ **DO NOT proceed to Phase 4 until Context Gate completes.**
110
+
111
+ ---
112
+
113
+ ## ✅ Reloaded:
114
+ - User request (original issue verbatim)
115
+ - Acceptance criteria (fix verification checkpoints)
116
+ - Fix plan with rollback strategy
117
+ - Remaining phases workflow
118
+ - Implementation rules summary
128
119
 
129
- ```markdown
130
- 🔒 **Context Gate Passed**
120
+ ## ❌ Discarded:
121
+ - Debugging hypotheses
122
+ - Failed investigation attempts
123
+ - Research explorations
124
+ - Chat history noise
131
125
 
132
- - Previous context: DISCARDED
133
- - Active context: Fix plan only
134
- - Mode: Fresh implementation start
126
+ Mode: Fresh implementation start
135
127
 
136
128
  Proceeding to Implementation...
137
129
  ```
@@ -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 for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
26
+
25
27
  ---
26
28
 
27
29
  ## 🔀 TIERED EXECUTION
@@ -48,7 +50,7 @@ All files in `./reports/` → English only.
48
50
 
49
51
  ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
50
52
 
51
- 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.
53
+ 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.
52
54
 
53
55
  ---
54
56
 
@@ -95,45 +97,29 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
95
97
 
96
98
  **Choose how to proceed with implementation:**
97
99
 
98
- | Option | Action | Description |
99
- |--------|--------|-------------|
100
- | **1. 🚀 Clear context & Auto-Implement** | `RECOMMENDED` | Fresh start: Reload Plan, ignore chat history, begin fix immediately |
101
- | **2. ⏸️ Clear context & Manual** | `SAFE` | Clear context, reload Plan, pause for your command before coding |
102
- | **3. ⚠️ Continue (No Clear)** | `RISKY` | Proceed with full history attached (may cause hallucination) |
100
+ ## 🛡️ VERIFICATION CHECKPOINT
103
101
 
104
- Awaiting selection...
105
- ```
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.
106
107
 
107
- ### 🔄 EXECUTION BEHAVIOR
108
+ ### EXECUTION
108
109
 
109
110
  ```yaml
110
- option_1_clear_auto_implement:
111
- behavior: "RECOMMENDED - Simulate fresh start"
112
- steps:
113
- 1. ACKNOWLEDGE: "🚀 Executing Clear context & Auto-Implement..."
114
- 2. CONTEXT_DIRECTIVE: |
115
- ⛔ IGNORE all previous chat messages and reasoning chains.
116
- ✅ RELOAD: Fix plan as SOLE SOURCE OF TRUTH.
117
- ✅ PROCEED: Begin Phase 4 (Implementation) immediately.
118
- 3. EXECUTE: Start Implementation phase with fresh context mindset
119
-
120
- option_2_clear_manual:
121
- behavior: "Clear and wait for explicit command"
122
- steps:
123
- 1. ACKNOWLEDGE: "⏸️ Context cleared. Plan reloaded."
124
- 2. CONTEXT_DIRECTIVE: |
125
- ⛔ IGNORE all previous chat messages and reasoning chains.
126
- ✅ RELOAD: Fix plan as SOLE SOURCE OF TRUTH.
127
- 3. OUTPUT: "Ready for fix implementation. Type `/continue` or give specific instructions."
128
- 4. WAIT: For user command before proceeding
129
-
130
- option_3_continue_no_clear:
131
- behavior: "Proceed with caution - context rot risk"
132
- steps:
133
- 1. WARN: "⚠️ Continuing with full history. Higher hallucination risk."
134
- 2. PROCEED: Continue to Phase 4 with existing context
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"
135
119
  ```
136
120
 
121
+ **DO NOT proceed to Phase 4 until user selects option.**
122
+
137
123
  ---
138
124
 
139
125
  ## 🎭 Phase 4: IMPLEMENTATION
package/commands/fix.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
@@ -38,7 +40,7 @@ execution-mode: execute
38
40
 
39
41
  ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
40
42
 
41
- 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.
43
+ 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.
42
44
 
43
45
  ---
44
46
 
@@ -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
  ## 🔀 TIERED EXECUTION
@@ -69,7 +71,7 @@ When the logical plan would have **> 3 phases** or **estimated effort > 3 days**
69
71
 
70
72
  ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
71
73
 
72
- 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.
74
+ 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.
73
75
 
74
76
  ---
75
77
 
@@ -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
  ## 🔀 TIERED EXECUTION
@@ -66,7 +68,7 @@ When the logical plan would have **> 3 phases** or **estimated effort > 3 days**
66
68
 
67
69
  ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
68
70
 
69
- 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.
71
+ 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.
70
72
 
71
73
  ---
72
74
 
package/commands/plan.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 (e.g. plan/hard.md), and execute it.
25
25