@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
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
@@ -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
@@ -90,45 +92,28 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
90
92
 
91
93
  ---
92
94
 
93
- ## 🛡️ STRICT CONTEXT GATE — Automatic Context Optimization
95
+ ## 🛡️ CONTEXT GATE CHECKPOINT
94
96
 
95
- > **⚡ FOCUS MODE**: This checkpoint executes automatically. NO user input required.
97
+ > **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
98
+ >
99
+ > **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE (Debug variant)
96
100
  >
97
- > **PURPOSE**: Prevent "context rot" by forcibly clearing noisy debugging history.
98
- > This acts as a mandatory "firewall" before handoff to fix workflows.
101
+ > This is a MANDATORY checkpoint. Cannot skip or bypass.
99
102
 
100
- ### 🔒 AUTOMATIC EXECUTION (NO PROMPT)
103
+ ### EXECUTION
101
104
 
102
105
  ```yaml
103
- strict_context_gate:
104
- mode: "AUTOMATIC - No user interaction"
105
- behavior: "Force Clear context & Fix"
106
-
107
- execution:
108
- 1. ANNOUNCE: |
109
- ## 🛡️ Strict Context Gate — Automatic
110
-
111
- ✅ **Debug Complete**: Root cause identified, fix strategy designed.
112
- 🔒 **Focus Mode**: Automatically clearing context for fix handoff.
113
-
114
- ⚡ Executing: **Clear context & Fix**...
115
-
116
- 2. CONTEXT_DIRECTIVE: |
117
- ╔══════════════════════════════════════════════════════════════════╗
118
- ║ ⛔ MANDATORY CONTEXT RESET — FOCUS MODE ║
119
- ╠══════════════════════════════════════════════════════════════════╣
120
- ║ IGNORE: All debugging hypotheses, failed investigation paths, ║
121
- ║ rejected theories, and intermediate reasoning. ║
122
- ║ ║
123
- ║ SOLE SOURCE OF TRUTH: Root cause + Fix strategy. ║
124
- ║ ║
125
- ║ HANDOFF: Ready for `/fix:focus` implementation. ║
126
- ║ Fix should treat root cause as fresh context. ║
127
- ╚══════════════════════════════════════════════════════════════════╝
128
-
129
- 3. OUTPUT: Root cause + Fix strategy summary
130
-
131
- 4. PROCEED: To COMPLETION
106
+ context_gate_execution:
107
+ mode: "FOCUS (Automatic)"
108
+ trigger: "After Phase 4 (Solution Design) completes"
109
+ protocol: "Follow rules/CONTEXT-GATE.md § FOCUS MODE § debug_focus_variant"
110
+
111
+ variant_adjustments:
112
+ reload_type: "OUTPUT_ESSENTIAL_CONTEXT"
113
+ handoff_to: "/fix:focus"
114
+ ```
115
+
116
+ **Note**: Debug outputs context for fix handoff, doesn't implement directly.
132
117
  ```
133
118
 
134
119
  ### 📋 Post-Gate Status
@@ -136,9 +121,19 @@ strict_context_gate:
136
121
  ```markdown
137
122
  🔒 **Context Gate Passed**
138
123
 
139
- - Previous context: DISCARDED
140
- - Active context: Root cause + Fix strategy only
141
- - Mode: Clean handoff ready
124
+ ## Output for Handoff:
125
+ - User request (original issue verbatim)
126
+ - Root cause summary with evidence
127
+ - Fix strategy with rollback
128
+ - Acceptance criteria for fix verification
129
+
130
+ ## ❌ Discarded:
131
+ - Failed investigation hypotheses
132
+ - Rejected theories
133
+ - Debugging noise
134
+ - Chat history
135
+
136
+ Mode: Clean handoff ready
142
137
 
143
138
  Ready for fix implementation...
144
139
  ```
@@ -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
@@ -122,22 +124,42 @@ option_1_clear_fix:
122
124
  2. CONTEXT_DIRECTIVE: |
123
125
  ⛔ IGNORE all debugging hypotheses and failed investigation paths.
124
126
  ✅ FIX STRATEGY is SOLE SOURCE OF TRUTH.
125
- 3. OUTPUT: "Run `/fix:focus` to implement with clean context."
126
-
127
- option_2_review_first:
128
- behavior: "Clear and show summary"
129
- steps:
130
- 1. ACKNOWLEDGE: "⏸️ Context cleared."
131
- 2. OUTPUT: Display root cause + fix strategy summary
132
- 3. WAIT: For user approval
127
+ 3. OUTPUT_ESSENTIAL_CONTEXT: |
128
+ ## 📤 Essential Context for Fix Handoff
129
+
130
+ Summarize these sections for `/fix:hard` to consume:
131
+
132
+ 1️⃣ **USER REQUEST (VERBATIM)**:
133
+ - Quote the original issue description exactly as user stated
134
+ - This MUST be preserved for fix verification
135
+
136
+ 2️⃣ **ROOT CAUSE SUMMARY**:
137
+ - What is broken and why
138
+ - File(s) and line(s) involved
139
+ - Evidence that confirms root cause
140
+ ## 🛡️ VERIFICATION CHECKPOINT
141
+
142
+ > **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
143
+ >
144
+ > **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE (Debug variant)
145
+ >
146
+ > This is a MANDATORY checkpoint. Cannot skip or bypass.
147
+
148
+ ### ⚡ EXECUTION
133
149
 
134
- option_3_continue_no_clear:
135
- behavior: "Proceed with caution"
136
- steps:
137
- 1. WARN: "⚠️ Debug history retained. Watch for hypothesis drift."
138
- 2. PROCEED: Complete workflow with existing context
150
+ ```yaml
151
+ context_gate_execution:
152
+ mode: "HARD (User Choice)"
153
+ trigger: "After Phase 4 (Solution Design) completes"
154
+ protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE § debug_hard_variant"
155
+
156
+ variant_adjustments:
157
+ output_type: "OUTPUT_ESSENTIAL_CONTEXT"
158
+ handoff_to: "/fix:hard"
139
159
  ```
140
160
 
161
+ **Note**: Debug outputs context for fix handoff with user choice.
162
+
141
163
  ---
142
164
 
143
165
  ## COMPLETION
package/commands/debug.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
 
@@ -14,9 +14,9 @@ execution-mode: execute
14
14
  ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
15
15
 
16
16
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
17
- 1. ORCHESTRATION-LAWS.md
18
- 2. ADAPTIVE-EXECUTION.md
19
- 3. EXECUTION-PROTOCOL.md
17
+ 1. CORE.md — Identity, Laws, Routing
18
+ 2. PHASES.md — Phase Execution
19
+ 3. AGENTS.md — Tiered Execution
20
20
 
21
21
  **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
22
22
 
@@ -24,7 +24,7 @@ execution-mode: execute
24
24
 
25
25
  ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
26
26
 
27
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
27
+ > **Reference: AGENTS.md (Tiered Execution)`
28
28
 
29
29
  ```yaml
30
30
  tiered_execution:
@@ -14,9 +14,9 @@ execution-mode: execute
14
14
  ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
15
15
 
16
16
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
17
- 1. ORCHESTRATION-LAWS.md
18
- 2. ADAPTIVE-EXECUTION.md
19
- 3. EXECUTION-PROTOCOL.md
17
+ 1. CORE.md — Identity, Laws, Routing
18
+ 2. PHASES.md — Phase Execution
19
+ 3. AGENTS.md — Tiered Execution
20
20
 
21
21
  **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
22
22
 
@@ -24,7 +24,7 @@ execution-mode: execute
24
24
 
25
25
  ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
26
26
 
27
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
27
+ > **Reference: AGENTS.md (Tiered Execution)`
28
28
 
29
29
  ```yaml
30
30
  tiered_execution:
@@ -14,9 +14,9 @@ execution-mode: execute
14
14
  ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
15
15
 
16
16
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
17
- 1. ORCHESTRATION-LAWS.md
18
- 2. ADAPTIVE-EXECUTION.md
19
- 3. EXECUTION-PROTOCOL.md
17
+ 1. CORE.md — Identity, Laws, Routing
18
+ 2. PHASES.md — Phase Execution
19
+ 3. AGENTS.md — Tiered Execution
20
20
 
21
21
  **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
22
22
 
@@ -24,7 +24,7 @@ execution-mode: execute
24
24
 
25
25
  ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
26
26
 
27
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
27
+ > **Reference: AGENTS.md (Tiered Execution)`
28
28
 
29
29
  ```yaml
30
30
  tiered_execution:
@@ -14,9 +14,9 @@ execution-mode: execute
14
14
  ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
15
15
 
16
16
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
17
- 1. ORCHESTRATION-LAWS.md
18
- 2. ADAPTIVE-EXECUTION.md
19
- 3. EXECUTION-PROTOCOL.md
17
+ 1. CORE.md — Identity, Laws, Routing
18
+ 2. PHASES.md — Phase Execution
19
+ 3. AGENTS.md — Tiered Execution
20
20
 
21
21
  **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
22
22
 
@@ -24,7 +24,7 @@ execution-mode: execute
24
24
 
25
25
  ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
26
26
 
27
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
27
+ > **Reference: AGENTS.md (Tiered Execution)`
28
28
 
29
29
  ```yaml
30
30
  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: