@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
@@ -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:
@@ -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