@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.
- package/CHANGELOG.md +78 -0
- package/README.md +1 -1
- package/agents/planner.md +59 -11
- package/agents/reporter.md +1 -1
- package/cli/install.js +514 -169
- package/code-assistants/antigravity-assistant/AntigravityGlobal.agent.md +38 -135
- package/code-assistants/antigravity-assistant/GEMINI.md +37 -137
- package/code-assistants/claude-assistant/CLAUDE.md +60 -38
- package/code-assistants/copilot-assistant/agent-assistant.agent.md +44 -125
- package/code-assistants/cursor-assistant/.cursorrules +42 -84
- package/code-assistants/cursor-assistant/rules/agent-assistant.mdc +37 -135
- package/commands/ask/fast.md +6 -4
- package/commands/ask/hard.md +6 -4
- package/commands/ask.md +3 -3
- package/commands/auto.md +3 -3
- package/commands/brainstorm/fast.md +6 -4
- package/commands/brainstorm/hard.md +6 -4
- package/commands/brainstorm.md +3 -3
- package/commands/code/fast.md +6 -4
- package/commands/code/focus.md +42 -46
- package/commands/code/hard.md +43 -48
- package/commands/code.md +6 -3
- package/commands/cook/fast.md +5 -3
- package/commands/cook/focus.md +22 -51
- package/commands/cook/hard.md +23 -55
- package/commands/cook.md +3 -3
- package/commands/debug/fast.md +5 -3
- package/commands/debug/focus.md +35 -40
- package/commands/debug/hard.md +38 -16
- package/commands/debug.md +3 -3
- package/commands/deploy/check.md +4 -4
- package/commands/deploy/preview.md +4 -4
- package/commands/deploy/production.md +4 -4
- package/commands/deploy/rollback.md +4 -4
- package/commands/deploy.md +3 -3
- package/commands/design/fast.md +6 -4
- package/commands/design/focus.md +28 -44
- package/commands/design/hard.md +53 -17
- package/commands/design.md +3 -3
- package/commands/docs/audit.md +5 -5
- package/commands/docs/business.md +5 -5
- package/commands/docs/core.md +5 -5
- package/commands/docs.md +3 -3
- package/commands/fix/fast.md +5 -3
- package/commands/fix/focus.md +36 -44
- package/commands/fix/hard.md +23 -37
- package/commands/fix.md +3 -3
- package/commands/plan/fast.md +6 -4
- package/commands/plan/focus.md +6 -4
- package/commands/plan/hard.md +6 -4
- package/commands/plan.md +3 -3
- package/commands/report/fast.md +6 -4
- package/commands/report/focus.md +6 -4
- package/commands/report/hard.md +6 -4
- package/commands/report.md +3 -3
- package/commands/review/fast.md +5 -3
- package/commands/review/hard.md +5 -3
- package/commands/review.md +3 -3
- package/commands/test/fast.md +5 -3
- package/commands/test/focus.md +24 -43
- package/commands/test/hard.md +24 -16
- package/commands/test.md +3 -3
- package/documents/HSOL-ASSESSMENT.md +121 -0
- package/documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md +1341 -0
- package/documents/business/business-glossary.md +6 -6
- package/documents/knowledge-architecture.md +81 -1
- package/documents/knowledge-domain.md +4 -3
- package/documents/knowledge-overview.md +1 -1
- package/documents/knowledge-source-base.md +15 -10
- package/package.json +5 -3
- package/rules/AGENTS.md +187 -0
- package/rules/CONTEXT-GATE.md +362 -0
- package/rules/CORE.md +175 -0
- package/rules/ERRORS.md +127 -0
- package/rules/PHASES.md +156 -0
- package/rules/REFERENCE.md +179 -0
- package/rules/SKILLS.md +167 -0
- package/skills/find-skills/SKILL.md +137 -0
- package/rules/ADAPTIVE-EXECUTION.md +0 -271
- package/rules/AGENT-RULES.md +0 -285
- package/rules/BOOTSTRAP.md +0 -301
- package/rules/ERROR-RECOVERY.md +0 -201
- package/rules/EXECUTION-PROTOCOL.md +0 -485
- package/rules/ORCHESTRATION-LAWS.md +0 -218
- package/rules/QUICK-REFERENCE.md +0 -204
- package/rules/SKILL-DISCOVERY.md +0 -370
package/commands/ask/fast.md
CHANGED
|
@@ -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.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
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
|
|
32
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
31
33
|
|
|
32
34
|
```yaml
|
|
33
35
|
tiered_execution:
|
package/commands/ask/hard.md
CHANGED
|
@@ -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.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
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
|
|
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.
|
|
20
|
-
2.
|
|
21
|
-
3.
|
|
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.
|
|
20
|
-
2.
|
|
21
|
-
3.
|
|
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.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
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
|
|
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.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
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
|
|
32
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
31
33
|
|
|
32
34
|
```yaml
|
|
33
35
|
tiered_execution:
|
package/commands/brainstorm.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.
|
|
20
|
-
2.
|
|
21
|
-
3.
|
|
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/code/fast.md
CHANGED
|
@@ -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.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
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
|
|
32
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
31
33
|
|
|
32
34
|
```yaml
|
|
33
35
|
tiered_execution:
|
package/commands/code/focus.md
CHANGED
|
@@ -20,17 +20,39 @@ execution-mode: execute
|
|
|
20
20
|
|
|
21
21
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
22
22
|
|
|
23
|
-
1.
|
|
24
|
-
2.
|
|
25
|
-
3.
|
|
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
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## 📌 PLAN-ALREADY-PROVIDED: SKIP REDUNDANT PHASES
|
|
34
|
+
|
|
35
|
+
**Before starting Phase 1**, resolve whether the user is **coding from an existing plan**. If yes, **do not** run research, scout, or brainstorm.
|
|
36
|
+
|
|
37
|
+
### Detection
|
|
38
|
+
|
|
39
|
+
- User message references a plan: e.g. `@plan`, `@PLAN-...`, path like `./reports/plans/PLAN-{name}.md`, or phrases like "according to plan", "follow the plan", "code from plan", "implement per plan".
|
|
40
|
+
- Or a plan file already exists for this task at `./reports/plans/PLAN-{task}.md` (derive `{task}` from `$ARGUMENTS` or from the referenced file name).
|
|
41
|
+
|
|
42
|
+
### Resolution
|
|
43
|
+
|
|
44
|
+
1. **CHECK**: Does a valid plan file exist (user-provided path or `./reports/plans/PLAN-{task}.md`)?
|
|
45
|
+
2. **IF YES**:
|
|
46
|
+
- **SKIP** Phase 1 (Requirements/Brainstorm), Phase 2 (Scout), Phase 3 (Planning).
|
|
47
|
+
- **ANNOUNCE**: "✅ Plan provided/found — skipping research, scout, and planning. Proceeding to implementation."
|
|
48
|
+
- **GO TO**: Strict Context Gate (automatic) → then Phase 4 (Implementation) → Phase 5 (Testing) → Phase 6 (Review).
|
|
49
|
+
3. **IF NO**: Run phases in order: Phase 1 → 2 → 3 → Context Gate → 4 → 5 → 6.
|
|
50
|
+
|
|
29
51
|
---
|
|
30
52
|
|
|
31
53
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
32
54
|
|
|
33
|
-
> **Reference
|
|
55
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
34
56
|
|
|
35
57
|
```yaml
|
|
36
58
|
tiered_execution:
|
|
@@ -160,56 +182,30 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
160
182
|
|
|
161
183
|
---
|
|
162
184
|
|
|
163
|
-
## 🛡️
|
|
185
|
+
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
164
186
|
|
|
165
|
-
>
|
|
187
|
+
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
166
188
|
>
|
|
167
|
-
> **
|
|
168
|
-
>
|
|
189
|
+
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
|
|
190
|
+
>
|
|
191
|
+
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
169
192
|
|
|
170
|
-
###
|
|
193
|
+
### ⚡ EXECUTION
|
|
171
194
|
|
|
172
195
|
```yaml
|
|
173
|
-
|
|
174
|
-
mode: "
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
✅ **Plan Complete**: `./reports/plans/PLAN-{task}.md`
|
|
182
|
-
🔒 **Focus Mode**: Automatically clearing context for implementation.
|
|
183
|
-
|
|
184
|
-
⚡ Executing: **Clear context & Auto-Implement**...
|
|
185
|
-
|
|
186
|
-
2. CONTEXT_DIRECTIVE: |
|
|
187
|
-
╔══════════════════════════════════════════════════════════════════╗
|
|
188
|
-
║ ⛔ MANDATORY CONTEXT RESET — FOCUS MODE ║
|
|
189
|
-
╠══════════════════════════════════════════════════════════════════╣
|
|
190
|
-
║ IGNORE: All previous chat messages, reasoning chains, ║
|
|
191
|
-
║ brainstorming discussions, research explorations, ║
|
|
192
|
-
║ rejected alternatives, and intermediate thinking. ║
|
|
193
|
-
║ ║
|
|
194
|
-
║ SOLE SOURCE OF TRUTH: `./reports/plans/PLAN-{task}.md` ║
|
|
195
|
-
║ ║
|
|
196
|
-
║ PROCEED: Begin Implementation phase with FRESH context mindset. ║
|
|
197
|
-
║ Treat this as a NEW conversation starting from Plan. ║
|
|
198
|
-
╚══════════════════════════════════════════════════════════════════╝
|
|
199
|
-
|
|
200
|
-
3. LOAD: Read Plan file completely as if seeing it for the first time
|
|
201
|
-
|
|
202
|
-
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"
|
|
203
204
|
```
|
|
204
205
|
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
```markdown
|
|
208
|
-
🔒 **Context Gate Passed**
|
|
206
|
+
**DO NOT proceed to Phase 4 until Context Gate completes.**
|
|
209
207
|
|
|
210
|
-
|
|
211
|
-
- Active context: Plan file only
|
|
212
|
-
- Mode: Fresh implementation start
|
|
208
|
+
Mode: Fresh implementation start
|
|
213
209
|
|
|
214
210
|
Proceeding to Implementation...
|
|
215
211
|
```
|
package/commands/code/hard.md
CHANGED
|
@@ -17,17 +17,39 @@ execution-mode: execute
|
|
|
17
17
|
|
|
18
18
|
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
19
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
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
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## 📌 PLAN-ALREADY-PROVIDED: SKIP REDUNDANT PHASES
|
|
31
|
+
|
|
32
|
+
**Before starting Phase 1**, resolve whether the user is **coding from an existing plan**. If yes, **do not** run research, scout, or brainstorm.
|
|
33
|
+
|
|
34
|
+
### Detection
|
|
35
|
+
|
|
36
|
+
- User message references a plan: e.g. `@plan`, `@PLAN-...`, path like `./reports/plans/PLAN-{name}.md`, or phrases like "according to plan", "follow the plan", "code from plan", "implement per plan".
|
|
37
|
+
- Or a plan file already exists for this task at `./reports/plans/PLAN-{task}.md` (derive `{task}` from `$ARGUMENTS` or from the referenced file name).
|
|
38
|
+
|
|
39
|
+
### Resolution
|
|
40
|
+
|
|
41
|
+
1. **CHECK**: Does a valid plan file exist (user-provided path or `./reports/plans/PLAN-{task}.md`)?
|
|
42
|
+
2. **IF YES**:
|
|
43
|
+
- **SKIP** Phase 1 (Requirements/Brainstorm), Phase 2 (Scout), Phase 3 (Planning).
|
|
44
|
+
- **ANNOUNCE**: "✅ Plan provided/found — skipping research, scout, and planning. Proceeding to implementation."
|
|
45
|
+
- **GO TO**: Verification Checkpoint (Context Optimization) → then Phase 4 (Implementation) → Phase 5 (Testing) → Phase 6 (Review).
|
|
46
|
+
3. **IF NO**: Run phases in order: Phase 1 → 2 → 3 → Checkpoint → 4 → 5 → 6.
|
|
47
|
+
|
|
26
48
|
---
|
|
27
49
|
|
|
28
50
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
29
51
|
|
|
30
|
-
> **Reference
|
|
52
|
+
> **Reference: AGENTS.md (Tiered Execution)`
|
|
31
53
|
|
|
32
54
|
```yaml
|
|
33
55
|
tiered_execution:
|
|
@@ -220,56 +242,29 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
220
242
|
> Long-running planning sessions fill context with noise that degrades code generation quality.
|
|
221
243
|
> This checkpoint acts as a "firewall" between Planning and Implementation phases.
|
|
222
244
|
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
```markdown
|
|
226
|
-
## 🛡️ Context Optimization Checkpoint
|
|
245
|
+
## 🛡️ VERIFICATION CHECKPOINT
|
|
227
246
|
|
|
228
|
-
|
|
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.
|
|
229
252
|
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
| Option | Action | Description |
|
|
233
|
-
|--------|--------|-------------|
|
|
234
|
-
| **1. 🚀 Clear context & Auto-Implement** | `RECOMMENDED` | Fresh start: Reload Plan file, ignore chat history, begin implementation immediately |
|
|
235
|
-
| **2. ⏸️ Clear context & Manual** | `SAFE` | Clear context, reload Plan, pause for your command before coding |
|
|
236
|
-
| **3. ⚠️ Continue (No Clear)** | `RISKY` | Proceed with full history attached (may cause hallucination) |
|
|
237
|
-
|
|
238
|
-
⏳ Awaiting selection...
|
|
239
|
-
```
|
|
240
|
-
|
|
241
|
-
### 🔄 EXECUTION BEHAVIOR
|
|
253
|
+
### ⚡ EXECUTION
|
|
242
254
|
|
|
243
255
|
```yaml
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
3. LOAD: Read Plan file completely
|
|
253
|
-
4. EXECUTE: Start Implementation phase with fresh context mindset
|
|
254
|
-
|
|
255
|
-
option_2_clear_manual:
|
|
256
|
-
behavior: "Clear and wait for explicit command"
|
|
257
|
-
steps:
|
|
258
|
-
1. ACKNOWLEDGE: "⏸️ Context cleared. Plan reloaded."
|
|
259
|
-
2. CONTEXT_DIRECTIVE: |
|
|
260
|
-
⛔ IGNORE all previous chat messages and reasoning chains.
|
|
261
|
-
✅ RELOAD: `./reports/plans/PLAN-{task}.md` as SOLE SOURCE OF TRUTH.
|
|
262
|
-
3. OUTPUT: "Ready for implementation. Type `/continue` or give specific instructions."
|
|
263
|
-
4. WAIT: For user command before proceeding
|
|
264
|
-
|
|
265
|
-
option_3_continue_no_clear:
|
|
266
|
-
behavior: "Proceed with caution - context rot risk"
|
|
267
|
-
steps:
|
|
268
|
-
1. WARN: "⚠️ Continuing with full history. Higher hallucination risk."
|
|
269
|
-
2. PROCEED: Continue to Phase 4 with existing context
|
|
270
|
-
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"
|
|
271
264
|
```
|
|
272
265
|
|
|
266
|
+
**DO NOT proceed to Phase 4 until user selects option.**
|
|
267
|
+
|
|
273
268
|
---
|
|
274
269
|
|
|
275
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.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
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
|
|
|
@@ -28,6 +28,9 @@ execution-mode: router
|
|
|
28
28
|
## ROUTING LOGIC
|
|
29
29
|
|
|
30
30
|
```
|
|
31
|
+
IF user references an existing plan (@plan, @PLAN-..., path to PLAN-*.md, or "according to plan" / "follow the plan"):
|
|
32
|
+
→ Route to /code:hard or /code:focus (workflow will SKIP research, scout, brainstorm and go straight to implementation)
|
|
33
|
+
|
|
31
34
|
IF task is simple (clear requirements, single file):
|
|
32
35
|
→ Route to /code:fast
|
|
33
36
|
|
package/commands/cook/fast.md
CHANGED
|
@@ -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.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
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
|
package/commands/cook/focus.md
CHANGED
|
@@ -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.
|
|
24
|
-
2.
|
|
25
|
-
3.
|
|
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:
|
|
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/
|
|
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
|
-
## 🛡️
|
|
143
|
+
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
142
144
|
|
|
143
|
-
>
|
|
145
|
+
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
146
|
+
>
|
|
147
|
+
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
|
|
144
148
|
>
|
|
145
|
-
>
|
|
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
|
-
###
|
|
151
|
+
### ⚡ EXECUTION
|
|
149
152
|
|
|
150
153
|
```yaml
|
|
151
|
-
|
|
152
|
-
mode: "
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
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
|
-
|
|
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
|
|