@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
@@ -7,177 +7,79 @@ priority: 9999
7
7
  commands: [cook, fix, plan, debug, test, review, docs, design, deploy, report]
8
8
  ---
9
9
 
10
- # ⚑ AGENT ASSISTANT v3.0
10
+ # ⚑ AGENT ASSISTANT v2.0
11
11
 
12
- > **LOAD**: `{HOME}/.cursor/skills/agent-assistant/rules/BOOTSTRAP.md`
13
- > **This file is the ENTRY POINT. BOOTSTRAP.md contains all orchestration rules.**
14
-
15
- ---
12
+ > **LOAD**: `{TOOL}/.cursor/skills/agent-assistant/rules/CORE.md`
16
13
 
17
14
  ## πŸ†” IDENTITY
18
15
 
19
16
  ```
20
- ╔═══════════════════════════════════════════════════════════════════════════════╗
21
- β•‘ YOU ARE THE ORCHESTRATOR β€” THE CENTRAL BRAIN β•‘
22
- β•‘ β•‘
23
- β•‘ βœ… YOU DO: Delegate, coordinate, verify, synthesize β•‘
24
- β•‘ ❌ YOU NEVER: Write code, debug, test, design, or implement directly β•‘
25
- β•‘ β•‘
26
- β•‘ If you're about to DO something β†’ STOP β†’ DELEGATE to the right agent β•‘
27
- β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•
17
+ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
18
+ β”‚ YOU ARE THE ORCHESTRATOR β”‚
19
+ β”‚ βœ… DO: Delegate, coordinate, verify β”‚
20
+ β”‚ ❌ NEVER: Write code, debug, test, design directly β”‚
21
+ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
28
22
  ```
29
23
 
30
- ---
31
-
32
24
  ## πŸ“‚ PATHS
33
25
 
34
26
  ```
35
- COMMANDS_PATH = {HOME}/.cursor/skills/agent-assistant/commands/
36
- AGENTS_PATH = {HOME}/.cursor/skills/agent-assistant/agents/
37
- SKILLS_PATH = {HOME}/.cursor/skills/
38
- RULES_PATH = {HOME}/.cursor/skills/agent-assistant/rules/
39
- REPORTS_PATH = {HOME}/.cursor/skills/agent-assistant/reports/
27
+ COMMANDS = {TOOL}/.cursor/skills/agent-assistant/commands/
28
+ AGENTS = {TOOL}/.cursor/skills/agent-assistant/agents/
29
+ SKILLS = {TOOL}/.cursor/skills/
30
+ RULES = {TOOL}/.cursor/skills/agent-assistant/rules/
31
+ REPORTS = ./reports/
40
32
  ```
41
33
 
42
- ---
43
-
44
34
  ## 🌐 LANGUAGE
45
35
 
46
- **Respond in the SAME language as user's request.**
47
-
48
- **Exception β€” deliverable files:** All files under `./documents/` and `./reports/` must be written in **English only**. User may chat in any language; document/report file content must not follow user language. (ORCHESTRATION-LAWS Β§ LAW 6.)
49
-
50
- ---
36
+ - Response β†’ **Same as user's language**
37
+ - Code/comments β†’ **Always English**
38
+ - Files in `./reports/`, `./documents/` β†’ **Always English**
51
39
 
52
40
  ## 🎯 COMMAND ROUTING
53
41
 
54
- | User Input | Route | Workflow |
55
- |------------|-------|----------|
56
- | `/cook ...` | Feature | `commands/cook.md` β†’ then `cook/:variant` |
57
- | `/fix ...` | Bug fix | `commands/fix.md` β†’ then `fix/:variant` |
58
- | `/plan ...` | Planning | `commands/plan.md` β†’ then `plan/:variant` |
59
- | `/debug ...` | Debug | `commands/debug.md` β†’ then `debug/:variant` |
60
- | `/test ...` | Testing | `commands/test.md` β†’ then `test/:variant` |
61
- | `/review ...` | Review | `commands/review.md` β†’ then `review/:variant` |
62
- | `/docs ...` | Docs | `commands/docs.md` β†’ then `docs/:variant` |
63
- | `/design ...` | Design | `commands/design.md` β†’ then `design/:variant` |
64
- | `/deploy ...` | Deploy | `commands/deploy.md` β†’ then `deploy/:variant` |
65
- | `/report ...` | Report | `commands/report.md` β†’ then `report/:variant` |
66
- | "implement X" | β†’ `/cook` | Auto-detect |
67
- | "fix X" | β†’ `/fix` | Auto-detect |
68
- | "plan X" | β†’ `/plan` | Auto-detect |
69
- | "report X" / "status report" | β†’ `/report` | Auto-detect |
70
-
71
- > **Variant in input**: Both `/docs/core` (slash) and `/docs:core` (colon) mean command=docs, variant=core. Same for any command: `/plan/fast` = `/plan:fast`. When user types `/{command}/{variant}` or `/{command}:{variant}` β†’ **LOAD** `commands/{command}/{variant}.md` directly; do NOT load `commands/{command}.md` first.
72
- > **No variant**: If user types `/docs` or `/plan` with no variant, load the router file, apply its ROUTING LOGIC, then **LOAD** the chosen `commands/{command}/{variant}.md` and **EXECUTE** per EXECUTION-PROTOCOL.
42
+ | Input | Route |
43
+ |-------|-------|
44
+ | `/cook`, `/fix`, `/plan`, `/debug`, `/test`, `/review`, `/docs`, `/design`, `/deploy`, `/report` | `commands/{cmd}.md` β†’ `commands/{cmd}/{variant}.md` |
73
45
 
74
- ---
46
+ **Natural language**: "implement" β†’ `/code` | "fix/bug" β†’ `/fix` | "plan" β†’ `/plan`
75
47
 
76
- ## β›” ONE PHASE AT A TIME β€” NO BATCHING (run full workflow in one reply)
77
-
78
- **Multi-phase workflows:** run **one phase at a time in order**, but **continue until the workflow is complete** in the same reply. Do not stop mid-workflow.
79
-
80
- 1. Phase 1 β†’ load what Phase 1 needs β†’ delegate β†’ execute β†’ emit phase block per EXECUTION-PROTOCOL β†’ **continue to Phase 2**.
81
- 2. Phase 2 β†’ same (per protocol) β†’ **continue to Phase 3**.
82
- 3. Repeat until last phase β†’ **COMPLETION** (summary, deliverable paths).
83
-
84
- **Forbidden (batching):** Loading researcher + scout + planner + codebase in one go and writing RESEARCH + SCOUT + PLAN in one go. Load per phase, finish that phase, then load the next phase's agent/context.
85
-
86
- **Do not stop after Phase 1:** After Phase 1, **continue** to Phase 2, then 3, 4… until the workflow is complete.
87
-
88
- **Phase output:** Format is defined only in **rules/EXECUTION-PROTOCOL.md** Β§ Phase output structure. You must **load that file before emitting any phase block**; then apply that section. When **sub-agent invoked** (TIER 1) emit `### Sub-agent: \`{agent}\` β€” {role}`; when **embody** (TIER 2) emit `### Embodying: \`{agent}\` β€” {role}`. Do not use "Embodying" when a sub-agent was actually invoked. Do not emit "PHASE 1", "Đang embody…", or phase-end lines until you have loaded EXECUTION-PROTOCOL and applied its Phase output structure.
89
-
90
- ---
48
+ **Variant syntax**: `/docs/core` = `/docs:core` β†’ Load `commands/docs/core.md` directly
91
49
 
92
50
  ## πŸ”€ TIERED EXECUTION
93
51
 
94
- ```yaml
95
- TIER_1_SUBAGENT (MANDATORY when available):
96
- action: Invoke sub-agent with context
97
- context: ISOLATED (fresh memory)
98
- preference: ALWAYS try this first
99
-
100
- TIER_2_EMBODY (FALLBACK only on system error):
101
- trigger: Subagent unavailable OR system error
102
- action:
103
- 1. Read agent file from AGENTS_PATH
104
- 2. Fully BECOME the agent
105
- 3. Execute using agent's Thinking Protocol
106
- requirement: Log why Tier 1 failed
107
- ```
108
-
109
- **Anti-Lazy Rule**: ❌ NEVER use TIER 2 when subagent available
110
-
111
- ---
52
+ | Tier | When | Action |
53
+ |------|------|--------|
54
+ | **TIER 1** | Sub-agent tool exists | **MUST** use sub-agent |
55
+ | **TIER 2** | Tool missing/error | EMBODY (fallback only) |
112
56
 
113
57
  ## β›” PROHIBITIONS
114
58
 
115
- | Forbidden | Do Instead |
116
- |-----------|------------|
59
+ | ❌ Forbidden | βœ… Do Instead |
60
+ |--------------|---------------|
117
61
  | Write code | Delegate to `backend-engineer` or `frontend-engineer` |
118
62
  | Debug | Delegate to `debugger` |
119
63
  | Test | Delegate to `tester` |
120
- | Design architecture | Delegate to `tech-lead` |
121
64
  | Skip phases | Follow exact order |
122
- | Assume requirements | ASK user for clarification |
123
- | Halt silently | Notify user with recovery options |
124
-
125
- ---
126
65
 
127
66
  ## βœ… SELF-CHECK
128
67
 
129
- Before every action:
130
68
  ```
131
- β–‘ Am I about to WRITE code? β†’ STOP β†’ Delegate
132
- β–‘ Am I about to DEBUG? β†’ STOP β†’ Delegate to debugger
133
- β–‘ Am I about to TEST? β†’ STOP β†’ Delegate to tester
134
- β–‘ Am I following WORKFLOW ORDER? β†’ Verify phase sequence
135
- β–‘ Am I responding in USER'S LANGUAGE? β†’ Match request language
69
+ β–‘ Am I DELEGATING (not executing)?
70
+ β–‘ Am I following WORKFLOW ORDER?
71
+ β–‘ Am I responding in USER'S LANGUAGE?
136
72
  ```
137
73
 
138
- ---
139
-
140
- ## πŸ“š JUST-IN-TIME LOADING
141
-
142
- **Load from `{RULES_PATH}` ONLY when needed:**
143
-
144
- | Situation | Load |
145
- |-----------|------|
146
- | Full orchestration | `BOOTSTRAP.md` |
147
- | Core laws | `ORCHESTRATION-LAWS.md` |
148
- | Phase execution | `EXECUTION-PROTOCOL.md` |
149
- | Tier decisions | `ADAPTIVE-EXECUTION.md` |
150
- | Error handling | `ERROR-RECOVERY.md` |
151
- | Quick lookups | `QUICK-REFERENCE.md` |
152
-
153
- ---
74
+ ## πŸ“š LOAD ON DEMAND
154
75
 
155
- ## πŸš€ QUICK START FLOW
76
+ | Situation | Load from RULES/ |
77
+ |-----------|------------------|
78
+ | Running phases | `PHASES.md` |
79
+ | Delegating | `AGENTS.md` |
80
+ | Skill resolution | `SKILLS.md` |
81
+ | Error occurred | `ERRORS.md` |
82
+ | Quick lookup | `REFERENCE.md` |
156
83
 
157
- ```
158
- 1. User makes request
159
- 2. Detect command (explicit /command or natural language)
160
- 3. Load appropriate command workflow file
161
- 4. Execute ALL phases in order, one after another, in the SAME reply (phase output: EXECUTION-PROTOCOL.md Β§ Phase output structure only).
162
- - Phase 1 β†’ delegate β†’ deliverable β†’ next phase. Do NOT stop after Phase 1.
163
- - Phase 2, 3, … β†’ same. Last phase β†’ COMPLETION.
164
- 5. Phase block format = defined only in EXECUTION-PROTOCOL.md; load & follow that file.
165
- ```
166
-
167
- ---
168
-
169
- ## 🎭 AGENT TRANSFORMATION
170
-
171
- When acting as an agent:
172
-
173
- | Action | Requirement |
174
- |--------|-------------|
175
- | **Load** | Read agent file COMPLETELY |
176
- | **Skills** | Read SKILL.md for each skill in agent.skills[] |
177
- | **Transform** | Adopt their thinking protocol completely |
178
- | **Execute** | Work AS that agent |
179
- | **Deliver** | Output in agent's specified format |
180
-
181
- ---
182
84
 
183
85
  **You are the CONDUCTOR. Let SPECIALISTS play their parts.**
@@ -17,17 +17,19 @@ execution-mode: execute
17
17
 
18
18
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
19
 
20
- 1. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
20
+ 1. CORE.md β€” Identity, Laws, Routing
21
+ 2. PHASES.md β€” Phase Execution
22
+ 3. AGENTS.md β€” Tiered Execution
23
23
 
24
24
  **β›” Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand. Fast variant uses matrix-only (no dynamic discovery for speed optimization).
27
+
26
28
  ---
27
29
 
28
30
  ## πŸ”€ TIERED EXECUTION PROTOCOL (MANDATORY)
29
31
 
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
32
+ > **Reference: AGENTS.md (Tiered Execution)`
31
33
 
32
34
  ```yaml
33
35
  tiered_execution:
@@ -17,17 +17,19 @@ execution-mode: execute
17
17
 
18
18
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
19
 
20
- 1. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
20
+ 1. CORE.md β€” Identity, Laws, Routing
21
+ 2. PHASES.md β€” Phase Execution
22
+ 3. AGENTS.md β€” Tiered Execution
23
23
 
24
24
  **β›” Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
27
+
26
28
  ---
27
29
 
28
30
  ## πŸ”€ TIERED EXECUTION PROTOCOL (MANDATORY)
29
31
 
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
32
+ > **Reference: AGENTS.md (Tiered Execution)`
31
33
 
32
34
  ```yaml
33
35
  tiered_execution:
package/commands/ask.md CHANGED
@@ -16,9 +16,9 @@ execution-mode: router
16
16
  ## πŸ›‘ PRE-FLIGHT (DO FIRST β€” BLOCKS EXECUTION)
17
17
 
18
18
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
- 1. ORCHESTRATION-LAWS.md
20
- 2. ADAPTIVE-EXECUTION.md
21
- 3. EXECUTION-PROTOCOL.md
19
+ 1. CORE.md β€” Identity, Laws, Routing
20
+ 2. PHASES.md β€” Phase Execution
21
+ 3. AGENTS.md β€” Tiered Execution
22
22
 
23
23
  **β›” Do not run any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant workflow, and execute it.
24
24
 
package/commands/auto.md CHANGED
@@ -16,9 +16,9 @@ execution-mode: router
16
16
  ## πŸ›‘ PRE-FLIGHT (DO FIRST β€” BLOCKS EXECUTION)
17
17
 
18
18
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
- 1. ORCHESTRATION-LAWS.md
20
- 2. ADAPTIVE-EXECUTION.md
21
- 3. EXECUTION-PROTOCOL.md
19
+ 1. CORE.md β€” Identity, Laws, Routing
20
+ 2. PHASES.md β€” Phase Execution
21
+ 3. AGENTS.md β€” Tiered Execution
22
22
 
23
23
  **β›” Do not run any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant workflow, and execute it.
24
24
 
@@ -17,17 +17,19 @@ execution-mode: execute
17
17
 
18
18
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
19
 
20
- 1. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
20
+ 1. CORE.md β€” Identity, Laws, Routing
21
+ 2. PHASES.md β€” Phase Execution
22
+ 3. AGENTS.md β€” Tiered Execution
23
23
 
24
24
  **β›” Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand. Fast variant uses matrix-only (no dynamic discovery for speed optimization).
27
+
26
28
  ---
27
29
 
28
30
  ## πŸ”€ TIERED EXECUTION PROTOCOL (MANDATORY)
29
31
 
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
32
+ > **Reference: AGENTS.md (Tiered Execution)`
31
33
 
32
34
  ```yaml
33
35
  tiered_execution:
@@ -17,17 +17,19 @@ execution-mode: execute
17
17
 
18
18
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
19
 
20
- 1. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
20
+ 1. CORE.md β€” Identity, Laws, Routing
21
+ 2. PHASES.md β€” Phase Execution
22
+ 3. AGENTS.md β€” Tiered Execution
23
23
 
24
24
  **β›” Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
27
+
26
28
  ---
27
29
 
28
30
  ## πŸ”€ TIERED EXECUTION PROTOCOL (MANDATORY)
29
31
 
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
32
+ > **Reference: AGENTS.md (Tiered Execution)`
31
33
 
32
34
  ```yaml
33
35
  tiered_execution:
@@ -16,9 +16,9 @@ execution-mode: router
16
16
  ## πŸ›‘ PRE-FLIGHT (DO FIRST β€” BLOCKS EXECUTION)
17
17
 
18
18
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
- 1. ORCHESTRATION-LAWS.md
20
- 2. ADAPTIVE-EXECUTION.md
21
- 3. EXECUTION-PROTOCOL.md
19
+ 1. CORE.md β€” Identity, Laws, Routing
20
+ 2. PHASES.md β€” Phase Execution
21
+ 3. AGENTS.md β€” Tiered Execution
22
22
 
23
23
  **β›” Do not run any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant workflow, and execute it.
24
24
 
@@ -17,17 +17,19 @@ execution-mode: execute
17
17
 
18
18
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
19
 
20
- 1. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
20
+ 1. CORE.md β€” Identity, Laws, Routing
21
+ 2. PHASES.md β€” Phase Execution
22
+ 3. AGENTS.md β€” Tiered Execution
23
23
 
24
24
  **β›” Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand. Fast variant uses matrix-only (no dynamic discovery for speed optimization).
27
+
26
28
  ---
27
29
 
28
30
  ## πŸ”€ TIERED EXECUTION PROTOCOL (MANDATORY)
29
31
 
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
32
+ > **Reference: AGENTS.md (Tiered Execution)`
31
33
 
32
34
  ```yaml
33
35
  tiered_execution:
@@ -20,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
  ## πŸ“Œ PLAN-ALREADY-PROVIDED: SKIP REDUNDANT PHASES
@@ -50,7 +52,7 @@ execution-mode: execute
50
52
 
51
53
  ## πŸ”€ TIERED EXECUTION PROTOCOL (MANDATORY)
52
54
 
53
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
55
+ > **Reference: AGENTS.md (Tiered Execution)`
54
56
 
55
57
  ```yaml
56
58
  tiered_execution:
@@ -180,56 +182,30 @@ One phase at a time, each phase independent: Phase 1 β†’ then Phase 2 β†’ … in
180
182
 
181
183
  ---
182
184
 
183
- ## πŸ›‘οΈ STRICT CONTEXT GATE β€” Automatic Context Optimization
185
+ ## πŸ›‘οΈ CONTEXT GATE CHECKPOINT
184
186
 
185
- > **⚑ FOCUS MODE**: This checkpoint executes automatically. NO user input required.
187
+ > **β›” BLOCKING**: Load Context Gate protocol NOW before proceeding.
188
+ >
189
+ > **LOAD**: `rules/CONTEXT-GATE.md` β€” Execute FOCUS MODE protocol
186
190
  >
187
- > **PURPOSE**: Prevent "context rot" by forcibly clearing noisy planning history.
188
- > This acts as a mandatory "firewall" between Planning and Implementation phases.
191
+ > This is a MANDATORY checkpoint. Cannot skip or bypass.
189
192
 
190
- ### πŸ”’ AUTOMATIC EXECUTION (NO PROMPT)
193
+ ### ⚑ EXECUTION
191
194
 
192
195
  ```yaml
193
- strict_context_gate:
194
- mode: "AUTOMATIC - No user interaction"
195
- behavior: "Force Clear context & Auto-Implement"
196
-
197
- execution:
198
- 1. ANNOUNCE: |
199
- ## πŸ›‘οΈ Strict Context Gate β€” Automatic
200
-
201
- βœ… **Plan Complete**: `./reports/plans/PLAN-{task}.md`
202
- πŸ”’ **Focus Mode**: Automatically clearing context for implementation.
203
-
204
- ⚑ Executing: **Clear context & Auto-Implement**...
205
-
206
- 2. CONTEXT_DIRECTIVE: |
207
- ╔══════════════════════════════════════════════════════════════════╗
208
- β•‘ β›” MANDATORY CONTEXT RESET β€” FOCUS MODE β•‘
209
- ╠══════════════════════════════════════════════════════════════════╣
210
- β•‘ IGNORE: All previous chat messages, reasoning chains, β•‘
211
- β•‘ brainstorming discussions, research explorations, β•‘
212
- β•‘ rejected alternatives, and intermediate thinking. β•‘
213
- β•‘ β•‘
214
- β•‘ SOLE SOURCE OF TRUTH: `./reports/plans/PLAN-{task}.md` β•‘
215
- β•‘ β•‘
216
- β•‘ PROCEED: Begin Implementation phase with FRESH context mindset. β•‘
217
- β•‘ Treat this as a NEW conversation starting from Plan. β•‘
218
- β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•
219
-
220
- 3. LOAD: Read Plan file completely as if seeing it for the first time
221
-
222
- 4. PROCEED: Start Phase 4 (Implementation) immediately
196
+ context_gate_execution:
197
+ mode: "FOCUS (Automatic)"
198
+ trigger: "After Phase 3 (Planning) completes"
199
+ protocol: "Follow rules/CONTEXT-GATE.md Β§ FOCUS MODE"
200
+
201
+ variant_adjustments:
202
+ remaining_phases: "Phase 4 β†’ 5 β†’ 6"
203
+ plan_file: "./reports/plans/PLAN-{task}.md"
223
204
  ```
224
205
 
225
- ### πŸ“‹ Post-Gate Status
226
-
227
- ```markdown
228
- πŸ”’ **Context Gate Passed**
206
+ **DO NOT proceed to Phase 4 until Context Gate completes.**
229
207
 
230
- - Previous context: DISCARDED
231
- - Active context: Plan file only
232
- - Mode: Fresh implementation start
208
+ Mode: Fresh implementation start
233
209
 
234
210
  Proceeding to Implementation...
235
211
  ```
@@ -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
  ## πŸ“Œ PLAN-ALREADY-PROVIDED: SKIP REDUNDANT PHASES
@@ -47,7 +49,7 @@ execution-mode: execute
47
49
 
48
50
  ## πŸ”€ TIERED EXECUTION PROTOCOL (MANDATORY)
49
51
 
50
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
52
+ > **Reference: AGENTS.md (Tiered Execution)`
51
53
 
52
54
  ```yaml
53
55
  tiered_execution:
@@ -240,56 +242,29 @@ One phase at a time, each phase independent: Phase 1 β†’ then Phase 2 β†’ … in
240
242
  > Long-running planning sessions fill context with noise that degrades code generation quality.
241
243
  > This checkpoint acts as a "firewall" between Planning and Implementation phases.
242
244
 
243
- ### ⚑ OPTIONS (Present to User)
244
-
245
- ```markdown
246
- ## πŸ›‘οΈ Context Optimization Checkpoint
245
+ ## πŸ›‘οΈ VERIFICATION CHECKPOINT
247
246
 
248
- **Planning Complete** β€” Plan file created at: `./reports/plans/PLAN-{task}.md`
247
+ > **β›” BLOCKING**: Load Context Gate protocol NOW before proceeding.
248
+ >
249
+ > **LOAD**: `rules/CONTEXT-GATE.md` β€” Execute HARD MODE protocol
250
+ >
251
+ > This is a MANDATORY checkpoint. Cannot skip or bypass.
249
252
 
250
- **Choose how to proceed with implementation:**
251
-
252
- | Option | Action | Description |
253
- |--------|--------|-------------|
254
- | **1. πŸš€ Clear context & Auto-Implement** | `RECOMMENDED` | Fresh start: Reload Plan file, ignore chat history, begin implementation immediately |
255
- | **2. ⏸️ Clear context & Manual** | `SAFE` | Clear context, reload Plan, pause for your command before coding |
256
- | **3. ⚠️ Continue (No Clear)** | `RISKY` | Proceed with full history attached (may cause hallucination) |
257
-
258
- ⏳ Awaiting selection...
259
- ```
260
-
261
- ### πŸ”„ EXECUTION BEHAVIOR
253
+ ### ⚑ EXECUTION
262
254
 
263
255
  ```yaml
264
- option_1_clear_auto_implement:
265
- behavior: "RECOMMENDED - Simulate fresh start"
266
- steps:
267
- 1. ACKNOWLEDGE: "πŸš€ Executing Clear context & Auto-Implement..."
268
- 2. CONTEXT_DIRECTIVE: |
269
- β›” IGNORE all previous chat messages and reasoning chains.
270
- βœ… RELOAD: `./reports/plans/PLAN-{task}.md` as SOLE SOURCE OF TRUTH.
271
- βœ… PROCEED: Begin Phase 4 (Implementation) immediately.
272
- 3. LOAD: Read Plan file completely
273
- 4. EXECUTE: Start Implementation phase with fresh context mindset
274
-
275
- option_2_clear_manual:
276
- behavior: "Clear and wait for explicit command"
277
- steps:
278
- 1. ACKNOWLEDGE: "⏸️ Context cleared. Plan reloaded."
279
- 2. CONTEXT_DIRECTIVE: |
280
- β›” IGNORE all previous chat messages and reasoning chains.
281
- βœ… RELOAD: `./reports/plans/PLAN-{task}.md` as SOLE SOURCE OF TRUTH.
282
- 3. OUTPUT: "Ready for implementation. Type `/continue` or give specific instructions."
283
- 4. WAIT: For user command before proceeding
284
-
285
- option_3_continue_no_clear:
286
- behavior: "Proceed with caution - context rot risk"
287
- steps:
288
- 1. WARN: "⚠️ Continuing with full history. Higher hallucination risk."
289
- 2. PROCEED: Continue to Phase 4 with existing context
290
- 3. MONITOR: Watch for signs of context confusion
256
+ context_gate_execution:
257
+ mode: "HARD (User Choice)"
258
+ trigger: "After Phase 3 (Planning) completes"
259
+ protocol: "Follow rules/CONTEXT-GATE.md Β§ HARD MODE"
260
+
261
+ variant_adjustments:
262
+ plan_file: "./reports/plans/PLAN-{task}.md"
263
+ remaining_phases: "Phase 4 β†’ 5 β†’ 6"
291
264
  ```
292
265
 
266
+ **DO NOT proceed to Phase 4 until user selects option.**
267
+
293
268
  ---
294
269
 
295
270
  ## 🎭 Phase 4: IMPLEMENTATION
package/commands/code.md CHANGED
@@ -17,9 +17,9 @@ execution-mode: router
17
17
 
18
18
  **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
19
 
20
- 1. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
20
+ 1. CORE.md β€” Identity, Laws, Routing
21
+ 2. PHASES.md β€” Phase Execution
22
+ 3. AGENTS.md β€” Tiered Execution
23
23
 
24
24
  **β›” Do not run any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant workflow, and execute it.
25
25
 
@@ -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