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