@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.
- package/CHANGELOG.md +46 -0
- package/README.md +1 -1
- package/agents/planner.md +59 -11
- package/agents/reporter.md +1 -1
- package/cli/install.js +532 -171
- package/code-assistants/antigravity-assistant/AntigravityGlobal.agent.md +64 -114
- package/code-assistants/antigravity-assistant/GEMINI.md +81 -106
- package/code-assistants/claude-assistant/CLAUDE.md +60 -38
- package/code-assistants/copilot-assistant/agent-assistant.agent.md +135 -118
- 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 +22 -46
- package/commands/code/hard.md +23 -48
- package/commands/code.md +3 -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 +22 -17
- package/package.json +2 -2
- package/rules/AGENTS.md +187 -0
- package/rules/CONTEXT-GATE.md +362 -0
- package/rules/CORE.md +188 -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/design/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 PROTOCOL (MANDATORY)
|
|
32
34
|
|
|
33
|
-
> **Reference
|
|
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
|
-
## 🛡️
|
|
181
|
+
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
180
182
|
|
|
181
|
-
>
|
|
182
|
-
>
|
|
183
|
-
> **
|
|
184
|
-
>
|
|
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
|
-
###
|
|
189
|
+
### ⚡ EXECUTION
|
|
187
190
|
|
|
188
191
|
```yaml
|
|
189
|
-
|
|
190
|
-
mode: "
|
|
191
|
-
|
|
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
|
-
|
|
194
|
-
|
|
195
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
```
|
package/commands/design/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:
|
|
@@ -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.
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
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
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
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
|
package/commands/design.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
|
|
package/commands/docs/audit.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.
|
|
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
|
|
|
@@ -27,7 +27,7 @@ execution-mode: execute
|
|
|
27
27
|
|
|
28
28
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
29
29
|
|
|
30
|
-
> **Reference
|
|
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. (
|
|
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.
|
|
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
|
|
|
@@ -27,7 +27,7 @@ execution-mode: execute
|
|
|
27
27
|
|
|
28
28
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
29
29
|
|
|
30
|
-
> **Reference
|
|
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. (
|
|
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
|
| -------------------------------------------- | ----------------------------- |
|
package/commands/docs/core.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.
|
|
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
|
|
|
@@ -27,7 +27,7 @@ execution-mode: execute
|
|
|
27
27
|
|
|
28
28
|
## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
|
|
29
29
|
|
|
30
|
-
> **Reference
|
|
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. (
|
|
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.
|
|
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 (e.g. docs/core.md), and execute it.
|
|
25
25
|
|
package/commands/fix/fast.md
CHANGED
|
@@ -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.
|
|
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 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
|
package/commands/fix/focus.md
CHANGED
|
@@ -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.
|
|
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
|
|
@@ -52,7 +54,7 @@ All files in `./reports/` → English only.
|
|
|
52
54
|
|
|
53
55
|
## ⛔ INCREMENTAL EXECUTION (MANDATORY)
|
|
54
56
|
|
|
55
|
-
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/
|
|
57
|
+
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.
|
|
56
58
|
|
|
57
59
|
---
|
|
58
60
|
|
|
@@ -83,55 +85,45 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
83
85
|
|
|
84
86
|
---
|
|
85
87
|
|
|
86
|
-
## 🛡️
|
|
88
|
+
## 🛡️ CONTEXT GATE CHECKPOINT
|
|
87
89
|
|
|
88
|
-
>
|
|
90
|
+
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
91
|
+
>
|
|
92
|
+
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute FOCUS MODE protocol
|
|
89
93
|
>
|
|
90
|
-
>
|
|
91
|
-
> This acts as a mandatory "firewall" between Planning and Implementation phases.
|
|
94
|
+
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
92
95
|
|
|
93
|
-
###
|
|
96
|
+
### ⚡ EXECUTION
|
|
94
97
|
|
|
95
98
|
```yaml
|
|
96
|
-
|
|
97
|
-
mode: "
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
✅ **Fix Plan Complete**: Strategy defined with rollback.
|
|
105
|
-
🔒 **Focus Mode**: Automatically clearing context for implementation.
|
|
106
|
-
|
|
107
|
-
⚡ Executing: **Clear context & Auto-Implement**...
|
|
108
|
-
|
|
109
|
-
2. CONTEXT_DIRECTIVE: |
|
|
110
|
-
╔══════════════════════════════════════════════════════════════════╗
|
|
111
|
-
║ ⛔ MANDATORY CONTEXT RESET — FOCUS MODE ║
|
|
112
|
-
╠══════════════════════════════════════════════════════════════════╣
|
|
113
|
-
║ IGNORE: All previous debugging hypotheses, failed attempts, ║
|
|
114
|
-
║ research explorations, and intermediate reasoning. ║
|
|
115
|
-
║ ║
|
|
116
|
-
║ SOLE SOURCE OF TRUTH: Fix plan with rollback strategy. ║
|
|
117
|
-
║ ║
|
|
118
|
-
║ PROCEED: Begin Implementation phase with FRESH context mindset. ║
|
|
119
|
-
║ Treat this as a NEW conversation starting from Plan. ║
|
|
120
|
-
╚══════════════════════════════════════════════════════════════════╝
|
|
121
|
-
|
|
122
|
-
3. LOAD: Read Fix plan completely as if seeing it for the first time
|
|
123
|
-
|
|
124
|
-
4. PROCEED: Start Phase 4 (Implementation) immediately
|
|
99
|
+
context_gate_execution:
|
|
100
|
+
mode: "FOCUS (Automatic)"
|
|
101
|
+
trigger: "After Phase 3 (Fix Planning) completes"
|
|
102
|
+
protocol: "Follow rules/CONTEXT-GATE.md § FOCUS MODE"
|
|
103
|
+
|
|
104
|
+
variant_adjustments:
|
|
105
|
+
remaining_phases: "Phase 4 → 5 → 5.5"
|
|
106
|
+
plan_type: "Fix plan with rollback strategy"
|
|
125
107
|
```
|
|
126
108
|
|
|
127
|
-
|
|
109
|
+
**DO NOT proceed to Phase 4 until Context Gate completes.**
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## ✅ Reloaded:
|
|
114
|
+
- User request (original issue verbatim)
|
|
115
|
+
- Acceptance criteria (fix verification checkpoints)
|
|
116
|
+
- Fix plan with rollback strategy
|
|
117
|
+
- Remaining phases workflow
|
|
118
|
+
- Implementation rules summary
|
|
128
119
|
|
|
129
|
-
|
|
130
|
-
|
|
120
|
+
## ❌ Discarded:
|
|
121
|
+
- Debugging hypotheses
|
|
122
|
+
- Failed investigation attempts
|
|
123
|
+
- Research explorations
|
|
124
|
+
- Chat history noise
|
|
131
125
|
|
|
132
|
-
|
|
133
|
-
- Active context: Fix plan only
|
|
134
|
-
- Mode: Fresh implementation start
|
|
126
|
+
Mode: Fresh implementation start
|
|
135
127
|
|
|
136
128
|
Proceeding to Implementation...
|
|
137
129
|
```
|
package/commands/fix/hard.md
CHANGED
|
@@ -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.
|
|
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 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 for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
|
|
26
|
+
|
|
25
27
|
---
|
|
26
28
|
|
|
27
29
|
## 🔀 TIERED EXECUTION
|
|
@@ -48,7 +50,7 @@ All files in `./reports/` → English only.
|
|
|
48
50
|
|
|
49
51
|
## ⛔ INCREMENTAL EXECUTION (MANDATORY)
|
|
50
52
|
|
|
51
|
-
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/
|
|
53
|
+
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.
|
|
52
54
|
|
|
53
55
|
---
|
|
54
56
|
|
|
@@ -95,45 +97,29 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
95
97
|
|
|
96
98
|
**Choose how to proceed with implementation:**
|
|
97
99
|
|
|
98
|
-
|
|
99
|
-
|--------|--------|-------------|
|
|
100
|
-
| **1. 🚀 Clear context & Auto-Implement** | `RECOMMENDED` | Fresh start: Reload Plan, ignore chat history, begin fix immediately |
|
|
101
|
-
| **2. ⏸️ Clear context & Manual** | `SAFE` | Clear context, reload Plan, pause for your command before coding |
|
|
102
|
-
| **3. ⚠️ Continue (No Clear)** | `RISKY` | Proceed with full history attached (may cause hallucination) |
|
|
100
|
+
## 🛡️ VERIFICATION CHECKPOINT
|
|
103
101
|
|
|
104
|
-
|
|
105
|
-
|
|
102
|
+
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
103
|
+
>
|
|
104
|
+
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE protocol
|
|
105
|
+
>
|
|
106
|
+
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
106
107
|
|
|
107
|
-
###
|
|
108
|
+
### ⚡ EXECUTION
|
|
108
109
|
|
|
109
110
|
```yaml
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
3. EXECUTE: Start Implementation phase with fresh context mindset
|
|
119
|
-
|
|
120
|
-
option_2_clear_manual:
|
|
121
|
-
behavior: "Clear and wait for explicit command"
|
|
122
|
-
steps:
|
|
123
|
-
1. ACKNOWLEDGE: "⏸️ Context cleared. Plan reloaded."
|
|
124
|
-
2. CONTEXT_DIRECTIVE: |
|
|
125
|
-
⛔ IGNORE all previous chat messages and reasoning chains.
|
|
126
|
-
✅ RELOAD: Fix plan as SOLE SOURCE OF TRUTH.
|
|
127
|
-
3. OUTPUT: "Ready for fix implementation. Type `/continue` or give specific instructions."
|
|
128
|
-
4. WAIT: For user command before proceeding
|
|
129
|
-
|
|
130
|
-
option_3_continue_no_clear:
|
|
131
|
-
behavior: "Proceed with caution - context rot risk"
|
|
132
|
-
steps:
|
|
133
|
-
1. WARN: "⚠️ Continuing with full history. Higher hallucination risk."
|
|
134
|
-
2. PROCEED: Continue to Phase 4 with existing context
|
|
111
|
+
context_gate_execution:
|
|
112
|
+
mode: "HARD (User Choice)"
|
|
113
|
+
trigger: "After Phase 3 (Fix Planning) completes"
|
|
114
|
+
protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE"
|
|
115
|
+
|
|
116
|
+
variant_adjustments:
|
|
117
|
+
plan_type: "Fix plan with rollback strategy"
|
|
118
|
+
remaining_phases: "Phase 4 → 5 → 5.5"
|
|
135
119
|
```
|
|
136
120
|
|
|
121
|
+
**DO NOT proceed to Phase 4 until user selects option.**
|
|
122
|
+
|
|
137
123
|
---
|
|
138
124
|
|
|
139
125
|
## 🎭 Phase 4: IMPLEMENTATION
|
package/commands/fix.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
|
|
package/commands/plan/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
|
|
@@ -38,7 +40,7 @@ execution-mode: execute
|
|
|
38
40
|
|
|
39
41
|
## ⛔ INCREMENTAL EXECUTION (MANDATORY)
|
|
40
42
|
|
|
41
|
-
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/
|
|
43
|
+
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.
|
|
42
44
|
|
|
43
45
|
---
|
|
44
46
|
|
package/commands/plan/focus.md
CHANGED
|
@@ -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.
|
|
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
|
|
@@ -69,7 +71,7 @@ When the logical plan would have **> 3 phases** or **estimated effort > 3 days**
|
|
|
69
71
|
|
|
70
72
|
## ⛔ INCREMENTAL EXECUTION (MANDATORY)
|
|
71
73
|
|
|
72
|
-
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/
|
|
74
|
+
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.
|
|
73
75
|
|
|
74
76
|
---
|
|
75
77
|
|
package/commands/plan/hard.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 for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
|
|
27
|
+
|
|
26
28
|
---
|
|
27
29
|
|
|
28
30
|
## 🔀 TIERED EXECUTION
|
|
@@ -66,7 +68,7 @@ When the logical plan would have **> 3 phases** or **estimated effort > 3 days**
|
|
|
66
68
|
|
|
67
69
|
## ⛔ INCREMENTAL EXECUTION (MANDATORY)
|
|
68
70
|
|
|
69
|
-
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/
|
|
71
|
+
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.
|
|
70
72
|
|
|
71
73
|
---
|
|
72
74
|
|
package/commands/plan.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 (e.g. plan/hard.md), and execute it.
|
|
25
25
|
|