@namch/agent-assistant 1.2.1 β 1.2.2
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 +8 -0
- package/README.md +2 -14
- package/commands/code/focus.md +2 -25
- package/commands/code/hard.md +0 -30
- package/commands/cook/focus.md +0 -25
- package/commands/cook/hard.md +0 -25
- package/commands/cook/team.md +0 -26
- package/commands/debug/focus.md +0 -48
- package/commands/debug/hard.md +0 -71
- package/commands/debug/team.md +0 -36
- package/commands/design/focus.md +0 -23
- package/commands/design/hard.md +0 -85
- package/commands/design/team.md +0 -58
- package/commands/fix/focus.md +0 -23
- package/commands/fix/hard.md +0 -39
- package/commands/fix/team.md +0 -25
- package/commands/plan/focus.md +0 -53
- package/commands/plan/hard.md +0 -56
- package/commands/plan/team.md +0 -22
- package/commands/report/focus.md +0 -52
- package/commands/test/focus.md +0 -23
- package/commands/test/hard.md +0 -57
- package/commands/test/team.md +0 -7
- package/package.json +1 -1
- package/rules/TEAMS.md +1 -1
- package/rules/CONTEXT-GATE.md +0 -362
package/commands/plan/focus.md
CHANGED
|
@@ -128,59 +128,6 @@ Plan(s) MUST reference prior phases:
|
|
|
128
128
|
|
|
129
129
|
---
|
|
130
130
|
|
|
131
|
-
## π‘οΈ STRICT CONTEXT GATE β Automatic Context Optimization
|
|
132
|
-
|
|
133
|
-
> **β‘ FOCUS MODE**: This checkpoint executes automatically. NO user input required.
|
|
134
|
-
>
|
|
135
|
-
> **PURPOSE**: Prevent "context rot" by forcibly clearing noisy research/planning history.
|
|
136
|
-
> This acts as a mandatory "firewall" before handoff to implementation workflows.
|
|
137
|
-
|
|
138
|
-
### π AUTOMATIC EXECUTION (NO PROMPT)
|
|
139
|
-
|
|
140
|
-
```yaml
|
|
141
|
-
strict_context_gate:
|
|
142
|
-
mode: "AUTOMATIC - No user interaction"
|
|
143
|
-
behavior: "Force Clear context & Ready"
|
|
144
|
-
|
|
145
|
-
execution:
|
|
146
|
-
1. ANNOUNCE: |
|
|
147
|
-
## π‘οΈ Strict Context Gate β Automatic
|
|
148
|
-
|
|
149
|
-
β
**Plan Complete**: Plan file(s) created.
|
|
150
|
-
π **Focus Mode**: Automatically clearing context for implementation handoff.
|
|
151
|
-
|
|
152
|
-
β‘ Executing: **Clear context & Ready**...
|
|
153
|
-
|
|
154
|
-
2. CONTEXT_DIRECTIVE: |
|
|
155
|
-
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
156
|
-
β β MANDATORY CONTEXT RESET β FOCUS MODE β
|
|
157
|
-
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ£
|
|
158
|
-
β IGNORE: All previous research discussions, exploration paths, β
|
|
159
|
-
β rejected alternatives, and intermediate reasoning. β
|
|
160
|
-
β β
|
|
161
|
-
β SOLE SOURCE OF TRUTH: Plan file(s) in ./reports/plans/ β
|
|
162
|
-
β β
|
|
163
|
-
β HANDOFF: Plan is ready for `/code:focus` implementation. β
|
|
164
|
-
β Implementation should treat Plan as fresh context. β
|
|
165
|
-
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
166
|
-
|
|
167
|
-
3. OUTPUT: Plan summary for user
|
|
168
|
-
|
|
169
|
-
4. PROCEED: To COMPLETION
|
|
170
|
-
```
|
|
171
|
-
|
|
172
|
-
### π Post-Gate Status
|
|
173
|
-
|
|
174
|
-
```markdown
|
|
175
|
-
π **Context Gate Passed**
|
|
176
|
-
|
|
177
|
-
- Previous context: DISCARDED
|
|
178
|
-
- Active context: Plan file(s) only
|
|
179
|
-
- Mode: Clean handoff ready
|
|
180
|
-
|
|
181
|
-
Plan ready for implementation...
|
|
182
|
-
```
|
|
183
|
-
|
|
184
131
|
---
|
|
185
132
|
|
|
186
133
|
## COMPLETION
|
package/commands/plan/hard.md
CHANGED
|
@@ -125,62 +125,6 @@ Plan(s) MUST reference prior phases:
|
|
|
125
125
|
|
|
126
126
|
---
|
|
127
127
|
|
|
128
|
-
## π‘οΈ VERIFICATION CHECKPOINT β Context Optimization
|
|
129
|
-
|
|
130
|
-
> **PURPOSE**: Prevent "context rot" by clearing noisy research/planning history before implementation.
|
|
131
|
-
>
|
|
132
|
-
> Long-running planning sessions fill context with noise that degrades implementation quality.
|
|
133
|
-
> This checkpoint acts as a "firewall" before handing off to implementation workflows.
|
|
134
|
-
|
|
135
|
-
### β‘ OPTIONS (Present to User)
|
|
136
|
-
|
|
137
|
-
```markdown
|
|
138
|
-
## π‘οΈ Context Optimization Checkpoint
|
|
139
|
-
|
|
140
|
-
**Planning Complete** β Plan file(s) created.
|
|
141
|
-
|
|
142
|
-
**Choose how to proceed:**
|
|
143
|
-
|
|
144
|
-
| Option | Action | Description |
|
|
145
|
-
|--------|--------|-------------|
|
|
146
|
-
| **1. π Clear context & Ready** | `RECOMMENDED` | Fresh start for implementation: Reload Plan, ignore planning history |
|
|
147
|
-
| **2. βΈοΈ Review First** | `SAFE` | Clear context, show plan summary, wait for approval |
|
|
148
|
-
| **3. β οΈ Continue (No Clear)** | `RISKY` | Keep full history (may affect `/cook:hard` quality) |
|
|
149
|
-
|
|
150
|
-
β³ Awaiting selection...
|
|
151
|
-
```
|
|
152
|
-
|
|
153
|
-
### π EXECUTION BEHAVIOR
|
|
154
|
-
|
|
155
|
-
```yaml
|
|
156
|
-
option_1_clear_ready:
|
|
157
|
-
behavior: "RECOMMENDED - Prepare clean handoff"
|
|
158
|
-
steps:
|
|
159
|
-
1. ACKNOWLEDGE: "π Context optimized. Plan ready for implementation."
|
|
160
|
-
2. CONTEXT_DIRECTIVE: |
|
|
161
|
-
β IGNORE all previous research/planning reasoning chains.
|
|
162
|
-
β
PLAN FILE is SOLE SOURCE OF TRUTH for implementation.
|
|
163
|
-
3. OUTPUT: "Run `/code:focus` to implement with clean context."
|
|
164
|
-
|
|
165
|
-
option_2_review_first:
|
|
166
|
-
behavior: "Clear and show summary"
|
|
167
|
-
steps:
|
|
168
|
-
1. ACKNOWLEDGE: "βΈοΈ Context cleared."
|
|
169
|
-
2. CONTEXT_DIRECTIVE: |
|
|
170
|
-
β IGNORE all previous research/planning reasoning chains.
|
|
171
|
-
β
PLAN FILE is SOLE SOURCE OF TRUTH.
|
|
172
|
-
3. OUTPUT: Display plan summary for user review
|
|
173
|
-
4. WAIT: For user approval before proceeding
|
|
174
|
-
|
|
175
|
-
option_3_continue_no_clear:
|
|
176
|
-
behavior: "Proceed with caution - context rot risk"
|
|
177
|
-
steps:
|
|
178
|
-
1. WARN: "β οΈ Continuing with full history. May affect implementation quality."
|
|
179
|
-
2. PROCEED: Complete workflow with existing context
|
|
180
|
-
```
|
|
181
|
-
|
|
182
|
-
---
|
|
183
|
-
|
|
184
128
|
## COMPLETION
|
|
185
129
|
|
|
186
130
|
Present plan with:
|
package/commands/plan/team.md
CHANGED
|
@@ -308,28 +308,6 @@ FOR EACH requirement in BRAINSTORM-{task}.md:
|
|
|
308
308
|
|
|
309
309
|
---
|
|
310
310
|
|
|
311
|
-
## π‘οΈ VERIFICATION CHECKPOINT
|
|
312
|
-
|
|
313
|
-
> **β BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
314
|
-
>
|
|
315
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` β Execute HARD MODE protocol
|
|
316
|
-
|
|
317
|
-
```yaml
|
|
318
|
-
context_gate_execution:
|
|
319
|
-
mode: "HARD (User Choice)"
|
|
320
|
-
trigger: "After Phase 4 completes with PASS"
|
|
321
|
-
protocol: "Follow rules/CONTEXT-GATE.md Β§ HARD MODE"
|
|
322
|
-
variant_adjustments:
|
|
323
|
-
plan_file: "PLAN-{task}.md"
|
|
324
|
-
qa_report: "QA-PLAN-{task}.md"
|
|
325
|
-
mailbox: "MAILBOX-{date}.md contains full debate history"
|
|
326
|
-
remaining_action: "Hand off to implementation workflow"
|
|
327
|
-
```
|
|
328
|
-
|
|
329
|
-
**DO NOT present completion until user selects option.**
|
|
330
|
-
|
|
331
|
-
---
|
|
332
|
-
|
|
333
311
|
## β
COMPLETION
|
|
334
312
|
|
|
335
313
|
```markdown
|
package/commands/report/focus.md
CHANGED
|
@@ -65,58 +65,6 @@ One phase at a time, each phase independent: Phase 1 β then Phase 2 β β¦ in
|
|
|
65
65
|
|
|
66
66
|
---
|
|
67
67
|
|
|
68
|
-
## π‘οΈ FOCUS CONTEXT GATE β Automatic Context Optimization
|
|
69
|
-
|
|
70
|
-
> **β‘ FOCUS MODE**: This checkpoint executes automatically. NO user input required.
|
|
71
|
-
>
|
|
72
|
-
> **PURPOSE**: Ensure report is based ONLY on facts, not conversation hallucinations.
|
|
73
|
-
> This acts as a mandatory "firewall" before analysis begins.
|
|
74
|
-
|
|
75
|
-
### π AUTOMATIC EXECUTION (NO PROMPT)
|
|
76
|
-
|
|
77
|
-
```yaml
|
|
78
|
-
focus_context_gate:
|
|
79
|
-
mode: "AUTOMATIC - No user interaction"
|
|
80
|
-
behavior: "Force Clear context & Analyze"
|
|
81
|
-
|
|
82
|
-
execution:
|
|
83
|
-
1. ANNOUNCE: |
|
|
84
|
-
## π‘οΈ Focus Context Gate β Automatic
|
|
85
|
-
|
|
86
|
-
β
**Target Defined**: Analysis target identified.
|
|
87
|
-
π **Focus Mode**: Automatically clearing context for objective analysis.
|
|
88
|
-
|
|
89
|
-
β‘ Executing: **Clear context & Analyze**...
|
|
90
|
-
|
|
91
|
-
2. CONTEXT_DIRECTIVE: |
|
|
92
|
-
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
93
|
-
β β MANDATORY CONTEXT RESET β FOCUS MODE β
|
|
94
|
-
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ£
|
|
95
|
-
β IGNORE: All previous chat assumptions, unverified claims, β
|
|
96
|
-
β and subjective contextual bias. β
|
|
97
|
-
β β
|
|
98
|
-
β SOLE SOURCE OF TRUTH: The actual Codebase and Documentation. β
|
|
99
|
-
β β
|
|
100
|
-
β PROCEED: Begin Analysis phase with FRESH, OBJECTIVE mindset. β
|
|
101
|
-
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
102
|
-
|
|
103
|
-
3. LOAD: Read specified target files as if seeing them for the first time
|
|
104
|
-
|
|
105
|
-
4. PROCEED: Start Phase 1 (Objective Analysis) immediately
|
|
106
|
-
```
|
|
107
|
-
|
|
108
|
-
### π Post-Gate Status
|
|
109
|
-
|
|
110
|
-
```markdown
|
|
111
|
-
π **Context Gate Passed**
|
|
112
|
-
|
|
113
|
-
- Previous context: DISCARDED
|
|
114
|
-
- Active context: Target files / codebase only
|
|
115
|
-
- Mode: Fresh objective analysis
|
|
116
|
-
|
|
117
|
-
Proceeding to Phase 1...
|
|
118
|
-
```
|
|
119
|
-
|
|
120
68
|
---
|
|
121
69
|
|
|
122
70
|
## π Phase 1: RESEARCH (AUDIT CRITERIA)
|
package/commands/test/focus.md
CHANGED
|
@@ -65,29 +65,6 @@ One phase at a time, each phase independent: Phase 1 β then Phase 2 β β¦ in
|
|
|
65
65
|
| Exit | Strategy defined, test types identified |
|
|
66
66
|
|
|
67
67
|
---
|
|
68
|
-
|
|
69
|
-
## π‘οΈ CONTEXT GATE CHECKPOINT
|
|
70
|
-
|
|
71
|
-
> **β BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
72
|
-
>
|
|
73
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` β Execute FOCUS MODE (Test variant)
|
|
74
|
-
>
|
|
75
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
76
|
-
|
|
77
|
-
### β‘ EXECUTION
|
|
78
|
-
|
|
79
|
-
```yaml
|
|
80
|
-
context_gate_execution:
|
|
81
|
-
mode: "FOCUS (Automatic)"
|
|
82
|
-
trigger: "After Phase 1 (Test Strategy) completes"
|
|
83
|
-
protocol: "Follow rules/CONTEXT-GATE.md Β§ FOCUS MODE Β§ test_focus_variant"
|
|
84
|
-
|
|
85
|
-
variant_adjustments:
|
|
86
|
-
plan_source: "Finalized test strategy from Phase 1"
|
|
87
|
-
remaining_phases: "Phase 2 β 3 β 4 β 5"
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
**DO NOT proceed to Phase 2 until Context Gate completes.**
|
|
91
68
|
- Rejected approaches
|
|
92
69
|
- Planning noise
|
|
93
70
|
- Chat history
|
package/commands/test/hard.md
CHANGED
|
@@ -63,63 +63,6 @@ One phase at a time, each phase independent: Phase 1 β then Phase 2 β β¦ in
|
|
|
63
63
|
|
|
64
64
|
---
|
|
65
65
|
|
|
66
|
-
## π‘οΈ VERIFICATION CHECKPOINT β Context Optimization
|
|
67
|
-
|
|
68
|
-
> **PURPOSE**: Prevent "context rot" by clearing strategy discussion before test execution.
|
|
69
|
-
>
|
|
70
|
-
> Test strategy discussions may include rejected approaches that can confuse execution.
|
|
71
|
-
> This checkpoint ensures clean handoff to test execution phases.
|
|
72
|
-
|
|
73
|
-
### β‘ OPTIONS (Present to User)
|
|
74
|
-
|
|
75
|
-
```markdown
|
|
76
|
-
## π‘οΈ Context Optimization Checkpoint
|
|
77
|
-
|
|
78
|
-
**Test Strategy Complete** β Strategy defined, ready for execution.
|
|
79
|
-
|
|
80
|
-
**Choose how to proceed:**
|
|
81
|
-
|
|
82
|
-
| Option | Action | Description |
|
|
83
|
-
|--------|--------|-------------|
|
|
84
|
-
| **1. π Clear context & Execute** | `RECOMMENDED` | Fresh start: Focus on strategy, ignore discussion history |
|
|
85
|
-
| **2. βΈοΈ Review Strategy** | `SAFE` | Clear context, show strategy summary, wait for approval |
|
|
86
|
-
| **3. β οΈ Continue (No Clear)** | `RISKY` | Keep full history (may affect test focus) |
|
|
87
|
-
|
|
88
|
-
β³ Awaiting selection...
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
### π EXECUTION BEHAVIOR
|
|
92
|
-
|
|
93
|
-
```yaml
|
|
94
|
-
option_1_clear_execute:
|
|
95
|
-
behavior: "RECOMMENDED - Clean execution"
|
|
96
|
-
steps:
|
|
97
|
-
1. ACKNOWLEDGE: "π Context optimized. Executing test strategy."
|
|
98
|
-
2. CONTEXT_DIRECTIVE: |
|
|
99
|
-
β IGNORE strategy discussion and rejected approaches.
|
|
100
|
-
## π‘οΈ VERIFICATION CHECKPOINT
|
|
101
|
-
|
|
102
|
-
> **β BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
103
|
-
>
|
|
104
|
-
> **LOAD**: `rules/CONTEXT-GATE.md` β Execute HARD MODE (Test variant)
|
|
105
|
-
>
|
|
106
|
-
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
107
|
-
|
|
108
|
-
### β‘ EXECUTION
|
|
109
|
-
|
|
110
|
-
```yaml
|
|
111
|
-
context_gate_execution:
|
|
112
|
-
mode: "HARD (User Choice)"
|
|
113
|
-
trigger: "After Phase 1 (Test Strategy) completes"
|
|
114
|
-
protocol: "Follow rules/CONTEXT-GATE.md Β§ HARD MODE Β§ test_hard_variant"
|
|
115
|
-
|
|
116
|
-
variant_adjustments:
|
|
117
|
-
plan_source: "Finalized test strategy from Phase 1"
|
|
118
|
-
remaining_phases: "Phase 2 β 3 β 4 β 5"
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
**DO NOT proceed to Phase 2 until user selects option.**
|
|
122
|
-
|
|
123
66
|
---
|
|
124
67
|
|
|
125
68
|
## π Phase 2: DEPENDENCY MAPPING
|
package/commands/test/team.md
CHANGED
|
@@ -148,13 +148,6 @@ Format: rules/PHASES.md Β§ Phase output + rules/TEAMS.md Β§ Golden Triangle Phas
|
|
|
148
148
|
|
|
149
149
|
---
|
|
150
150
|
|
|
151
|
-
## π‘οΈ VERIFICATION CHECKPOINT
|
|
152
|
-
|
|
153
|
-
> **β BLOCKING**: `rules/CONTEXT-GATE.md` β HARD MODE. Prevents context rot between planning and implementation.
|
|
154
|
-
> Trigger: After Phase 2 completes. Plan file: `TEST-PLAN-{scope}.md`. Remaining: Phase 3 β 4.
|
|
155
|
-
|
|
156
|
-
**DO NOT proceed to Phase 3 until user selects option.**
|
|
157
|
-
|
|
158
151
|
---
|
|
159
152
|
|
|
160
153
|
## π Phase 3: TEST IMPLEMENTATION β πΊ GOLDEN TRIANGLE (CRITICAL)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@namch/agent-assistant",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.2",
|
|
4
4
|
"description": "Multi-agent orchestration framework for AI coding assistants (Cursor, Copilot, Antigravity, Claude Code, Codex) with Hybrid Skill Orchestration Layer (HSOL).",
|
|
5
5
|
"main": "cli/install.js",
|
|
6
6
|
"bin": {
|
package/rules/TEAMS.md
CHANGED
|
@@ -417,7 +417,7 @@ IS task complex with multiple concerns (security + performance + correctness)?
|
|
|
417
417
|
|---------|----------------|--------|------|
|
|
418
418
|
| `:fast` | Single agent | 1 | Speed priority, simple tasks |
|
|
419
419
|
| `:hard` | Single agent | 1 | Standard quality, focused tasks |
|
|
420
|
-
| `:focus` | Single agent
|
|
420
|
+
| `:focus` | Single agent | 1 | Clean execution, noise reduction |
|
|
421
421
|
| `:team` | Golden Triangle | 3 | Maximum quality, adversarial review, complex tasks |
|
|
422
422
|
|
|
423
423
|
**β Do NOT use `:team` for**:
|