@namch/agent-assistant 1.3.1 → 1.3.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.
Files changed (81) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +3 -4
  3. package/code-assistants/codex-assistant/CODEX.md +1 -2
  4. package/commands/ask/hard.md +1 -1
  5. package/commands/brainstorm/hard.md +1 -1
  6. package/commands/code/hard.md +1 -1
  7. package/commands/code.md +2 -7
  8. package/commands/cook/hard.md +1 -1
  9. package/commands/cook.md +1 -6
  10. package/commands/debug/hard.md +1 -1
  11. package/commands/debug.md +1 -6
  12. package/commands/design/hard.md +1 -1
  13. package/commands/design.md +1 -6
  14. package/commands/fix/hard.md +1 -1
  15. package/commands/fix.md +1 -6
  16. package/commands/plan/hard.md +1 -1
  17. package/commands/plan.md +1 -6
  18. package/commands/report/fast.md +2 -2
  19. package/commands/report/hard.md +1 -1
  20. package/commands/report.md +2 -7
  21. package/commands/review/hard.md +1 -1
  22. package/commands/test/hard.md +1 -1
  23. package/commands/test.md +1 -6
  24. package/documents/HSOL-ASSESSMENT.md +6 -6
  25. package/documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md +1 -1
  26. package/documents/business/business-features/01-feature-inventory.md +5 -5
  27. package/documents/business/business-features/03-feature-specifications.md +7 -8
  28. package/documents/business/business-features/04-dependencies-and-release-sequencing.md +3 -3
  29. package/documents/business/business-features/05-success-metrics.md +2 -2
  30. package/documents/business/business-prd/03-stakeholders-and-requirements.md +1 -1
  31. package/documents/business/business-workflows/02-workflow-catalog.md +2 -2
  32. package/documents/business/business-workflows/03-detailed-workflows.md +5 -5
  33. package/documents/business/business-workflows/04-decision-rules-and-exceptions.md +2 -2
  34. package/documents/business/business-workflows/05-sla-and-handoffs.md +1 -1
  35. package/documents/knowledge-architecture/00-index.md +2 -2
  36. package/documents/knowledge-architecture/01-system-overview.md +2 -2
  37. package/documents/knowledge-architecture/02-components.md +8 -8
  38. package/documents/knowledge-architecture/03-data-flow.md +1 -2
  39. package/documents/knowledge-architecture/04-design-patterns.md +1 -2
  40. package/documents/knowledge-architecture/05-decisions.md +3 -3
  41. package/documents/knowledge-domain/00-index.md +1 -1
  42. package/documents/knowledge-domain/01-entities.md +9 -10
  43. package/documents/knowledge-domain/03-api-contracts.md +17 -19
  44. package/documents/knowledge-domain/04-business-rules.md +0 -1
  45. package/documents/knowledge-overview/00-index.md +1 -1
  46. package/documents/knowledge-overview/01-project-identity.md +1 -1
  47. package/documents/knowledge-overview/03-features.md +2 -3
  48. package/documents/knowledge-source-base/01-directory-structure.md +9 -9
  49. package/documents/knowledge-source-base/03-key-modules.md +11 -12
  50. package/documents/knowledge-source-base/04-configuration.md +1 -1
  51. package/documents/knowledge-standards/02-conventions.md +0 -1
  52. package/matrix-skills/_index.yaml +1 -1
  53. package/package.json +1 -1
  54. package/rules/AGENTS.md +1 -1
  55. package/rules/REFERENCE.md +8 -8
  56. package/rules/SKILLS.md +1 -1
  57. package/rules/TEAMS.md +1 -2
  58. package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/SKILL.md +0 -18
  59. package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/agents/openai.yaml +0 -4
  60. package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/SKILL.md +0 -18
  61. package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/agents/openai.yaml +0 -4
  62. package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/SKILL.md +0 -18
  63. package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/agents/openai.yaml +0 -4
  64. package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/SKILL.md +0 -18
  65. package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/agents/openai.yaml +0 -4
  66. package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/SKILL.md +0 -18
  67. package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/agents/openai.yaml +0 -4
  68. package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/SKILL.md +0 -18
  69. package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/agents/openai.yaml +0 -4
  70. package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/SKILL.md +0 -18
  71. package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/agents/openai.yaml +0 -4
  72. package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/SKILL.md +0 -18
  73. package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/agents/openai.yaml +0 -4
  74. package/commands/code/focus.md +0 -297
  75. package/commands/cook/focus.md +0 -209
  76. package/commands/debug/focus.md +0 -103
  77. package/commands/design/focus.md +0 -229
  78. package/commands/fix/focus.md +0 -145
  79. package/commands/plan/focus.md +0 -140
  80. package/commands/report/focus.md +0 -107
  81. package/commands/test/focus.md +0 -123
@@ -125,7 +125,7 @@
125
125
  | Req ID | Requirement | Priority | INVEST Score | Stakeholders | Goals |
126
126
  |--------|-------------|----------|-------------|--------------|-------|
127
127
  | BR-006 | 14 structured commands available (`/cook`, `/fix`, `/plan`, `/debug`, `/test`, `/review`, `/docs`, `/design`, `/deploy`, `/report`, `/brainstorm`, `/ask`, `/code`, `/auto`) | Must | 25/30 | S1 | BG-006 |
128
- | BR-007 | 4 variant strategies per command: `fast`, `hard`, `focus`, `team` | Should | 26/30 | S1 | BG-006 |
128
+ | BR-007 | 4 variant strategies per command: `fast`, `hard`, `team` | Should | 26/30 | S1 | BG-006 |
129
129
  | BR-015 | Natural language command detection maps free-text to structured commands | Must | 27/30 | S1 | BG-006 |
130
130
  | BR-016 | Plan-already-provided short-circuit skips planning when user supplies a plan | Should | 28/30 | S1 | BG-003, BG-005 |
131
131
  | BR-017 | Documentation generation via `/docs` creates knowledge, business, and audit docs | Should | 23/30 | S1, S6 | BG-010 |
@@ -109,7 +109,7 @@ All 12 workflows are classified by complexity (Low / Medium / High) and frequenc
109
109
  | **ID** | BW-006 |
110
110
  | **Name** | Dynamic Skill Discovery |
111
111
  | **Actor** | HSOL System |
112
- | **Trigger** | Fitness score < 0.8 for hard/focus command variants |
112
+ | **Trigger** | Fitness score < 0.8 for hard/team command variants |
113
113
  | **Outcome** | `npx skills find` → evaluate candidates → check superiority delta (>0.15) → if low-trust + critical: user confirmation → `npx skills add` → register in `_dynamic.yaml` |
114
114
  | **Exception Handling** | Timeout (5s) → matrix-only fallback; install failure → rollback + offer matrix skills |
115
115
  | **Complexity** | High |
@@ -194,7 +194,7 @@ All 12 workflows are classified by complexity (Low / Medium / High) and frequenc
194
194
  | **ID** | BW-011 |
195
195
  | **Name** | Plan Short-Circuit |
196
196
  | **Actor** | Orchestrator |
197
- | **Trigger** | User references an existing `PLAN-*.md` file in `/code:hard` or `/code:focus` commands |
197
+ | **Trigger** | User references an existing `PLAN-*.md` file in `/code:hard` or `/code:team` commands |
198
198
  | **Outcome** | Detect plan reference → skip research/scout/brainstorm phases → jump to context optimization → implement → test → review |
199
199
  | **Exception Handling** | Plan file must exist and be valid; invalid plan → fall back to standard BW-003 flow |
200
200
  | **Complexity** | Low |
@@ -123,7 +123,7 @@ This is the core workflow of the framework. When a user types a command (explici
123
123
  1. User input received (prompt or natural language)
124
124
  2. **Pre-flight**: Orchestrator validates input is actionable
125
125
  3. **Command Detection**: Match input to command (`/cook`, `/fix`, `/plan`, etc.) or natural language mapping
126
- 4. **Variant Resolution**: Determine variant (`:easy`, `:hard`, `:focus`, `:team`, etc.) — default if unspecified
126
+ 4. **Variant Resolution**: Determine variant (`:easy`, `:hard`, `:team`, etc.) — default if unspecified
127
127
  5. **Workflow File Load**: Read `commands/{cmd}.md` → `commands/{cmd}/{variant}.md`
128
128
  6. **Phase Initialization**: Parse phase sequence from workflow file
129
129
  7. **For each phase (sequential)**:
@@ -562,11 +562,11 @@ flowchart TD
562
562
 
563
563
  ### Narrative
564
564
 
565
- When a user references an existing plan file in a `/code:hard` or `/code:focus` command, the Orchestrator detects this and skips early research phases, jumping directly to implementation.
565
+ When a user references an existing plan file in a `/code:hard` or `/code:team` command, the Orchestrator detects this and skips early research phases, jumping directly to implementation.
566
566
 
567
567
  ### Steps
568
568
 
569
- 1. User invokes `/code:hard` or `/code:focus` referencing `PLAN-*.md`
569
+ 1. User invokes `/code:hard` or `/code:team` referencing `PLAN-*.md`
570
570
  2. Orchestrator detects plan file reference
571
571
  3. Validate that plan file exists and is parseable
572
572
  4. Extract implementation plan from file
@@ -576,7 +576,7 @@ When a user references an existing plan file in a `/code:hard` or `/code:focus`
576
576
 
577
577
  ```mermaid
578
578
  flowchart TD
579
- A[/code:hard or /code:focus with PLAN ref] --> B{PLAN-*.md exists?}
579
+ A[/code:hard or /code:team with PLAN ref] --> B{PLAN-*.md exists?}
580
580
  B -->|No| C[Fall back to standard BW-003]
581
581
  B -->|Yes| D{Plan valid?}
582
582
  D -->|No| C
@@ -638,4 +638,4 @@ flowchart TD
638
638
  - `rules/PHASES.md` — Phase sequencing constraints, exit criteria definitions
639
639
  - `cli/install.js` — Installation and uninstallation implementation details
640
640
  - `commands/*.md` — Command definitions, variant routing rules
641
- - `commands/code/*.md` — Plan short-circuit detection in hard/focus variants
641
+ - `commands/code/*.md` — Plan short-circuit detection in hard/team variants
@@ -61,7 +61,7 @@ The 10 Orchestration Laws define absolute behavioral constraints on the Orchestr
61
61
  | PS-003 | Input immutability | A phase receives prior deliverables as read-only inputs (Law 8) |
62
62
  | PS-004 | Halt on failure | If exit criteria not met and BW-010 cannot recover → halt workflow |
63
63
  | PS-005 | No skip | Phases cannot be skipped except via explicit short-circuit (BW-011) |
64
- | PS-006 | Plan short-circuit | If valid PLAN-*.md referenced in /code:hard or /code:focus → skip research/scout/brainstorm phases |
64
+ | PS-006 | Plan short-circuit | If valid PLAN-*.md referenced in /code:hard or /code:team → skip research/scout/brainstorm phases |
65
65
  | PS-007 | Variant authority | The variant file defines the phase sequence — no deviation |
66
66
 
67
67
  ---
@@ -84,7 +84,7 @@ The 10 Orchestration Laws define absolute behavioral constraints on the Orchestr
84
84
  | HS-005 | Confirmation gate | Low-trust skill + critical task → Framework User confirmation required |
85
85
  | HS-006 | Timeout ceiling | Discovery must complete within 5 seconds; timeout → matrix-only |
86
86
  | HS-007 | Install rollback | Failed installation → rollback + offer matrix alternatives |
87
- | HS-008 | Hard/focus only | Dynamic discovery only triggers for hard and focus command variants |
87
+ | HS-008 | Hard/team only | Dynamic discovery only triggers for hard and team command variants |
88
88
 
89
89
  ### Trust Progression Rules
90
90
 
@@ -33,7 +33,7 @@ These timings depend on the AI model's inference speed and context window. They
33
33
  |----------|-----------|---------------|------------|
34
34
  | BW-003 | Single phase execution | 5s – 60s | Model inference + tool execution |
35
35
  | BW-003 | Full command (simple variant) | 30s – 5min | Phase count × phase time |
36
- | BW-003 | Full command (hard/focus variant) | 2min – 30min | Research + implementation complexity |
36
+ | BW-003 | Full command (hard/team variant) | 2min – 30min | Research + implementation complexity |
37
37
  | BW-004 | Agent delegation (TIER 1) | 5s – 30s per phase | Sub-agent spawn + execution |
38
38
  | BW-004 | Agent delegation (TIER 2) | 3s – 20s per phase | No spawn overhead |
39
39
  | BW-008 | Team collaboration (full cycle) | 5min – 45min | 1–3 debate rounds × 3 agents |
@@ -29,7 +29,7 @@ graph TB
29
29
 
30
30
  subgraph "Command Layer"
31
31
  ROUTER["14 Command Routers"]
32
- VARIANTS["54 Workflow Variants<br/>(fast, hard, focus, team)"]
32
+ VARIANTS["54 Workflow Variants<br/>(fast, hard, team)"]
33
33
  end
34
34
 
35
35
  subgraph "Agent Layer"
@@ -95,7 +95,7 @@ graph TB
95
95
  | Platform Entry Points | 5 (CLAUDE.md, COPILOT.md, CURSOR.md, CODEX.md, GEMINI.md) |
96
96
  | Rule Files | 7 (CORE, PHASES, AGENTS, SKILLS, TEAMS, ERRORS, REFERENCE) |
97
97
  | Command Routers | 14 |
98
- | Workflow Variants | 4 per command (fast, hard, focus, team) |
98
+ | Workflow Variants | 4 per command (fast, hard, team) |
99
99
  | Individual Agents | 21 across 5 categories (meta, execution, validation, research, support) |
100
100
  | Team Configurations | 17 teams × 3 roles = 51 team agents |
101
101
  | Skill Modules | 1,430 matrix + dynamic community skills |
@@ -48,7 +48,7 @@ The framework draws from several patterns without being a pure instance of any:
48
48
  | **Orchestrator/Choreography** | Single orchestrator delegates to specialist agents via tiered execution |
49
49
  | **Plugin Architecture** | 1,430 skill modules are independently discoverable and composable |
50
50
  | **Pipeline** | Commands execute as phase-sequential pipelines with exit criteria |
51
- | **Strategy Pattern** | Command routers select variant workflows (fast/hard/focus/team) at runtime |
51
+ | **Strategy Pattern** | Command routers select variant workflows (fast/hard/team/team) at runtime |
52
52
  | **Actor Model** | Agents communicate through append-only mailbox files, not direct calls |
53
53
 
54
54
  ---
@@ -82,7 +82,7 @@ graph TB
82
82
 
83
83
  subgraph "COMMAND LAYER — Routing"
84
84
  ROUTERS["14 Command Routers<br/>cook · fix · plan · debug<br/>test · review · docs · design<br/>deploy · report · brainstorm<br/>ask · code · auto"]
85
- VARIANTS["Workflow Variants<br/>:fast · :hard · :focus · :team"]
85
+ VARIANTS["Workflow Variants<br/>:fast · :hard · :team"]
86
86
  end
87
87
 
88
88
  subgraph "AGENT LAYER — Execution"
@@ -132,19 +132,19 @@ graph LR
132
132
 
133
133
  | Command | Router File | Variants | Category |
134
134
  |---------|------------|----------|----------|
135
- | `/cook` | `commands/cook.md` | fast, hard, focus, team | Engineering |
136
- | `/fix` | `commands/fix.md` | fast, hard, focus, team | Engineering |
137
- | `/plan` | `commands/plan.md` | fast, hard, focus, team | Planning |
138
- | `/debug` | `commands/debug.md` | fast, hard, focus, team | Validation |
139
- | `/test` | `commands/test.md` | fast, hard, focus, team | Validation |
135
+ | `/cook` | `commands/cook.md` | fast, hard, team | Engineering |
136
+ | `/fix` | `commands/fix.md` | fast, hard, team | Engineering |
137
+ | `/plan` | `commands/plan.md` | fast, hard, team | Planning |
138
+ | `/debug` | `commands/debug.md` | fast, hard, team | Validation |
139
+ | `/test` | `commands/test.md` | fast, hard, team | Validation |
140
140
  | `/review` | `commands/review.md` | fast, hard | Validation |
141
141
  | `/docs` | `commands/docs.md` | core, business, audit | Documentation |
142
- | `/design` | `commands/design.md` | fast, hard, focus, team | Design |
142
+ | `/design` | `commands/design.md` | fast, hard, team | Design |
143
143
  | `/deploy` | `commands/deploy.md` | check, preview, production, rollback | Operations |
144
- | `/report` | `commands/report.md` | fast, hard, focus, team | Reporting |
144
+ | `/report` | `commands/report.md` | fast, hard, team | Reporting |
145
145
  | `/brainstorm` | `commands/brainstorm.md` | fast, hard | Research |
146
146
  | `/ask` | `commands/ask.md` | fast, hard | Research |
147
- | `/code` | `commands/code.md` | fast, hard, focus, team | Engineering |
147
+ | `/code` | `commands/code.md` | fast, hard, team | Engineering |
148
148
  | `/auto` | `commands/auto.md` | — | Meta |
149
149
 
150
150
  ### Router Structure (common pattern from cook.md)
@@ -219,8 +219,7 @@ stateDiagram-v2
219
219
  |---------|-------------------|
220
220
  | `:fast` | Skip — use matrix skills only, no dynamic discovery |
221
221
  | `:hard` | Check matrix fitness; trigger discovery if < 0.8 |
222
- | `:focus` | Check matrix fitness; trigger discovery if < 0.8 |
223
- | `:team` | Same as `:hard`/`:focus` — applies per agent in the triangle |
222
+ | `:team` | Same as `:hard` applies per agent in the triangle |
224
223
 
225
224
  ---
226
225
 
@@ -156,7 +156,6 @@ Each command router selects from up to 4 strategy variants at runtime:
156
156
  |---------|----------|-------------|---------------|
157
157
  | `:fast` | Minimal workflow, skip research | 2–3 phases | Simple, clear specification |
158
158
  | `:hard` | Full workflow with research and planning | 5–7 phases | Complex, multi-component |
159
- | `:focus` | Full workflow with enforced context optimization | 5–7 phases | Complex + context-critical |
160
159
  | `:team` | Golden Triangle adversarial collaboration | 5–7 phases × 3 agents each | Maximum quality required |
161
160
 
162
161
  Special variants exist for some commands:
@@ -167,7 +166,7 @@ Special variants exist for some commands:
167
166
 
168
167
  From `rules/REFERENCE.md`:
169
168
  ```
170
- | `/cook` | cook.md | fast, hard, focus |
169
+ | `/cook` | cook.md | fast, hard, team |
171
170
  | `/deploy` | deploy.md | check, preview, production, rollback |
172
171
  ```
173
172
 
@@ -312,7 +312,7 @@ Matrix skills (1,430 across 19 domains) provide a trusted baseline. Dynamic disc
312
312
  - 0.10 × Freshness — recency
313
313
  - 0.10 × Success Rate — execution history
314
314
  - Trust progression prevents untested skills from affecting critical workflows
315
- - Variant-gated discovery (`:fast` skips, `:hard`/`:focus` may trigger) keeps fast paths fast
315
+ - Variant-gated discovery (`:fast` skips, `:hard`/`:team` may trigger) keeps fast paths fast
316
316
 
317
317
  ### Trade-offs
318
318
 
@@ -322,14 +322,14 @@ Matrix skills (1,430 across 19 domains) provide a trusted baseline. Dynamic disc
322
322
  | Community discovery fills gaps automatically | Dynamic skills start untrusted (0.3) |
323
323
  | 5-factor scoring balances multiple dimensions | Scoring is interpretive (AI evaluates), not deterministic |
324
324
  | Trust progression protects quality | New skills need 10 successful executions to reach VALIDATED |
325
- | Variant gating preserves fast path performance | Discovery only runs for hard/focus variants |
325
+ | Variant gating preserves fast path performance | Discovery only runs for hard/team variants |
326
326
 
327
327
  ### Evidence
328
328
 
329
329
  - `matrix-skills/_index.yaml`: `total_matrix_skills: 1430`, 19 domain files, HSOL config with `async_threshold: 0.8`
330
330
  - `rules/SKILLS.md`: Resolution algorithm (6 steps), fitness formula (5 factors with weights), trust lifecycle (4 stages with criteria)
331
331
  - `matrix-skills/_dynamic.yaml`: Dynamic skill governance fields (owner, checksum, support_state, promotion_state)
332
- - `_index.yaml` discovery config: `apply_for_variants: ["hard", "focus"]` — confirms `:fast` skips discovery
332
+ - `_index.yaml` discovery config: `apply_for_variants: ["hard", "team"]` — confirms `:fast` skips discovery
333
333
 
334
334
  ---
335
335
 
@@ -76,7 +76,7 @@ erDiagram
76
76
  COMMAND_VARIANT {
77
77
  string filename PK "e.g. cook/fast.md"
78
78
  string parent_command FK "cook"
79
- string variant_type "fast, hard, focus, team"
79
+ string variant_type "fast, hard, team"
80
80
  int phase_count "Number of phases"
81
81
  string agents_used "Agent assignments"
82
82
  }
@@ -199,15 +199,15 @@ Each team domain folder contains exactly 3 files:
199
199
 
200
200
  | Command | Slug | Category | Variants |
201
201
  |---------|------|----------|----------|
202
- | /cook | `cook` | engineering | fast, hard, focus, team |
203
- | /code | `code` | engineering | fast, hard, focus, team |
204
- | /fix | `fix` | engineering | fast, hard, focus, team |
205
- | /debug | `debug` | validation | fast, hard, focus, team |
206
- | /test | `test` | validation | fast, hard, focus, team |
207
- | /plan | `plan` | planning | fast, hard, focus, team |
208
- | /design | `design` | design | fast, hard, focus, team |
202
+ | /cook | `cook` | engineering | fast, hard, team |
203
+ | /code | `code` | engineering | fast, hard, team |
204
+ | /fix | `fix` | engineering | fast, hard, team |
205
+ | /debug | `debug` | validation | fast, hard, team |
206
+ | /test | `test` | validation | fast, hard, team |
207
+ | /plan | `plan` | planning | fast, hard, team |
208
+ | /design | `design` | design | fast, hard, team |
209
209
  | /review | `review` | validation | fast, hard, team |
210
- | /report | `report` | support | fast, hard, focus, team |
210
+ | /report | `report` | support | fast, hard, team |
211
211
  | /brainstorm | `brainstorm` | research | fast, hard, team |
212
212
  | /docs | `docs` | support | core, business, audit |
213
213
  | /deploy | `deploy` | devops | check, preview, production, rollback |
@@ -257,7 +257,6 @@ Each variant defines a sequence of phases:
257
257
  |------|-------------|-------------|
258
258
  | `fast` | cook, code, fix, debug, test, plan, design, report, brainstorm, ask | Minimal phases, quick execution, skip discovery |
259
259
  | `hard` | cook, code, fix, debug, test, plan, design, review, report, brainstorm, ask | Full workflow, all phases, full skill resolution |
260
- | `focus` | cook, code, fix, debug, test, plan, design, report | Hard workflow with enforced context optimization |
261
260
  | `team` | cook, code, fix, debug, test, plan, design, review, report, brainstorm | Golden Triangle (3 agents per phase) |
262
261
  | `core` | docs | Core documentation workflow |
263
262
  | `business` | docs | Business documentation workflow |
@@ -528,7 +527,7 @@ All entry points follow the same pattern:
528
527
  | `hsol.discovery.timeout_ms` | integer | `5000` | Discovery timeout in milliseconds |
529
528
  | `hsol.discovery.cache_ttl_seconds` | integer | `3600` | Cache time-to-live |
530
529
  | `hsol.discovery.async_threshold` | float | `0.8` | Matrix fitness above this skips discovery |
531
- | `hsol.discovery.apply_for_variants` | string[] | `[hard, focus]` | Variants that trigger discovery |
530
+ | `hsol.discovery.apply_for_variants` | string[] | `[hard, team]` | Variants that trigger discovery |
532
531
  | `hsol.trust.new_skill` | float | `0.3` | Initial trust for new skills |
533
532
  | `hsol.trust.after_3_executions` | float | `0.5` | Trust after 3 successes |
534
533
  | `hsol.trust.after_10_executions` | float | `0.7` | Trust after 10 successes |
@@ -208,14 +208,13 @@ The Orchestrator also detects commands from natural language:
208
208
  |----------|-------|
209
209
  | Purpose | Implement new features end-to-end |
210
210
  | Input | Feature description |
211
- | Variants | `fast`, `hard`, `focus`, `team` |
212
- | Default routing | Simple spec → fast; Complex → hard; Context-critical → focus; Max quality → team |
211
+ | Variants | `fast`, `hard`, `team` |
212
+ | Default routing | Simple spec → fast; Complex → hard; Max quality → team |
213
213
 
214
214
  | Variant | Phases | Discovery | Team |
215
215
  |---------|--------|-----------|------|
216
216
  | `fast` | Minimal (typically 2-3) | Matrix only, skip dynamic | Single agent per phase |
217
217
  | `hard` | Full (typically 5-7) | Matrix + dynamic discovery | Single agent per phase |
218
- | `focus` | Full with context clearing | Matrix + dynamic discovery | Single agent per phase |
219
218
  | `team` | Full with Golden Triangle | Matrix + dynamic discovery | 3 agents per phase |
220
219
 
221
220
  #### `/code` — Code Generation
@@ -224,7 +223,7 @@ The Orchestrator also detects commands from natural language:
224
223
  |----------|-------|
225
224
  | Purpose | Generate code snippets or modules |
226
225
  | Input | Code specification |
227
- | Variants | `fast`, `hard`, `focus`, `team` |
226
+ | Variants | `fast`, `hard`, `team` |
228
227
  | Default routing | Same as `/cook` |
229
228
 
230
229
  #### `/fix` — Bug Fixing
@@ -233,7 +232,7 @@ The Orchestrator also detects commands from natural language:
233
232
  |----------|-------|
234
233
  | Purpose | Identify and fix bugs |
235
234
  | Input | Bug description or error message |
236
- | Variants | `fast`, `hard`, `focus`, `team` |
235
+ | Variants | `fast`, `hard`, `team` |
237
236
  | Default routing | Clear bug → fast; Complex/multi-component → hard |
238
237
 
239
238
  #### `/debug` — Debugging
@@ -242,7 +241,7 @@ The Orchestrator also detects commands from natural language:
242
241
  |----------|-------|
243
242
  | Purpose | Deep investigation of issues |
244
243
  | Input | Issue description or symptoms |
245
- | Variants | `fast`, `hard`, `focus`, `team` |
244
+ | Variants | `fast`, `hard`, `team` |
246
245
  | Default routing | Quick investigation → fast; Root cause analysis → hard |
247
246
 
248
247
  #### `/test` — Test Generation
@@ -251,7 +250,7 @@ The Orchestrator also detects commands from natural language:
251
250
  |----------|-------|
252
251
  | Purpose | Generate test suites |
253
252
  | Input | Component or feature to test |
254
- | Variants | `fast`, `hard`, `focus`, `team` |
253
+ | Variants | `fast`, `hard`, `team` |
255
254
  | Default routing | Unit tests → fast; Full coverage strategy → hard |
256
255
 
257
256
  #### `/plan` — Planning
@@ -260,7 +259,7 @@ The Orchestrator also detects commands from natural language:
260
259
  |----------|-------|
261
260
  | Purpose | Create implementation plans and task breakdowns |
262
261
  | Input | Feature or project to plan |
263
- | Variants | `fast`, `hard`, `focus`, `team` |
262
+ | Variants | `fast`, `hard`, `team` |
264
263
  | Default routing | Quick plan → fast; Detailed architecture → hard |
265
264
 
266
265
  #### `/design` — UI/UX Design
@@ -269,7 +268,7 @@ The Orchestrator also detects commands from natural language:
269
268
  |----------|-------|
270
269
  | Purpose | Design user interfaces and experiences |
271
270
  | Input | UI/UX requirements |
272
- | Variants | `fast`, `hard`, `focus`, `team` |
271
+ | Variants | `fast`, `hard`, `team` |
273
272
  | Default routing | Simple component → fast; Full design system → hard |
274
273
 
275
274
  #### `/review` — Code Review
@@ -287,7 +286,7 @@ The Orchestrator also detects commands from natural language:
287
286
  |----------|-------|
288
287
  | Purpose | Generate reports and summaries |
289
288
  | Input | Topic or scope for report |
290
- | Variants | `fast`, `hard`, `focus`, `team` |
289
+ | Variants | `fast`, `hard`, `team` |
291
290
  | Default routing | Quick summary → fast; Detailed analysis → hard |
292
291
 
293
292
  #### `/brainstorm` — Ideation
@@ -349,14 +348,14 @@ Execution is blocked until all three are loaded.
349
348
 
350
349
  ### Variant Behavior Matrix
351
350
 
352
- | Behavior | fast | hard | focus | team |
353
- |----------|------|------|-------|------|
354
- | Phase count | Minimal (2-3) | Full (5-7) | Full (5-7) | Full (5-7) |
355
- | Skill discovery | Matrix only | Matrix + dynamic | Matrix + dynamic | Matrix + dynamic |
356
- | Context clearing | No | No | Yes (between phases) | No |
357
- | Agents per phase | 1 | 1 | 1 | 3 (Golden Triangle) |
358
- | Debate rounds | N/A | N/A | N/A | Up to 3 |
359
- | Deliverable review | Exit criteria only | Exit criteria | Exit criteria + context check | Consensus stamp required |
351
+ | Behavior | fast | hard | team |
352
+ |----------|------|------|------|
353
+ | Phase count | Minimal (2-3) | Full (5-7) | Full (5-7) |
354
+ | Skill discovery | Matrix only | Matrix + dynamic | Matrix + dynamic |
355
+ | Context clearing | No | No | No |
356
+ | Agents per phase | 1 | 1 | 3 (Golden Triangle) |
357
+ | Debate rounds | N/A | N/A | Up to 3 |
358
+ | Deliverable review | Exit criteria only | Exit criteria | Consensus stamp required |
360
359
 
361
360
  ---
362
361
 
@@ -444,7 +443,6 @@ The HSOL maps agent profiles to skill domains via the `agent_profiles` section i
444
443
  |---------|-------------------|
445
444
  | `fast` | Skip dynamic discovery entirely — matrix skills only |
446
445
  | `hard` | Full resolution — matrix first, dynamic discovery if fitness < 0.8 |
447
- | `focus` | Same as `hard` — full resolution with dynamic discovery |
448
446
  | `team` | Same as `hard` — full resolution with dynamic discovery |
449
447
  | Other (core, business, audit, check, etc.) | Standard matrix resolution |
450
448
 
@@ -197,7 +197,6 @@ The superiority delta of 0.15 means a dynamic skill must exceed the best matrix
197
197
  |---------|-------------------|
198
198
  | `fast` | Always skipped — matrix only |
199
199
  | `hard` | Enabled — full resolution |
200
- | `focus` | Enabled — full resolution |
201
200
  | `team` | Enabled — full resolution |
202
201
 
203
202
  ### Complexity Gate
@@ -58,7 +58,7 @@ Built with Node.js >=18.0.0 using only built-in modules (fs, path, os, readline)
58
58
  | Specialist Agents | 21 |
59
59
  | Team Configurations | 17 teams (51 team agents) |
60
60
  | Commands | 14 |
61
- | Command Variants | 4 (fast, hard, focus, team) |
61
+ | Command Variants | 4 (fast, hard, team) |
62
62
  | Skill Modules | 1,430+ |
63
63
  | Skill Domains | 19 |
64
64
  | Rules | 7 |
@@ -51,7 +51,7 @@ Agent Assistant solves these by:
51
51
  1. **Global one-time installation** — Markdown and YAML configurations installed into each AI tool's global directory (`~/.cursor/`, `~/.claude/`, `~/.copilot/`, etc.) apply to all projects automatically.
52
52
  2. **Orchestrator pattern** — The AI reads a platform entry file that transforms it into an Orchestrator role. It delegates work to specialist agents rather than attempting everything itself.
53
53
  3. **21 specialist agents** — Each with a defined profile, responsibility scope, and skill set. Examples: `backend-engineer`, `tester`, `security-engineer`, `tech-lead`.
54
- 4. **14 structured commands** — `/cook`, `/code`, `/fix`, `/debug`, `/test`, `/plan`, `/design`, `/review`, `/report`, `/brainstorm`, `/docs`, `/deploy`, `/ask`, `/auto` — each with variant strategies (fast, hard, focus, team).
54
+ 4. **14 structured commands** — `/cook`, `/code`, `/fix`, `/debug`, `/test`, `/plan`, `/design`, `/review`, `/report`, `/brainstorm`, `/docs`, `/deploy`, `/ask`, `/auto` — each with variant strategies (fast, hard, team).
55
55
  5. **Automatic skill injection (HSOL)** — 1,430+ skills across 19 domains resolved by agent profile and request context, with no manual skill selection required.
56
56
  6. **Cross-platform parity** — The same workflows and agent definitions work across all 5 supported AI coding tools.
57
57
 
@@ -71,7 +71,7 @@ The Hybrid Skill Orchestration Layer automatically resolves and injects relevant
71
71
  5. Calculate fitness scores (semantic match 35%, specificity 25%, trust 20%, freshness 10%, success rate 10%)
72
72
  6. Return sorted skill set
73
73
 
74
- **Dynamic discovery**: When matrix fitness score falls below 0.8 for `:hard` or `:focus` variants, the `find-skills` mechanism can discover additional community skills at runtime.
74
+ **Dynamic discovery**: When matrix fitness score falls below 0.8 for `:hard` or `:team` variants, the `find-skills` mechanism can discover additional community skills at runtime.
75
75
 
76
76
  **Evidence**: [../../rules/SKILLS.md](../../rules/SKILLS.md), [../../matrix-skills/_index.yaml](../../matrix-skills/_index.yaml), [../../matrix-skills/](../../matrix-skills/)
77
77
 
@@ -142,7 +142,6 @@ Each command supports up to 4 variants that control scope, agent count, and qual
142
142
  |---------|-------|--------|---------------|----------|
143
143
  | `:fast` | Minimal | 2–3 | Basic | Simple tasks, quick fixes |
144
144
  | `:hard` | Full | 5–8 | Comprehensive (test, review, security) | Complex features, production code |
145
- | `:focus` | Clean | Variable | Targeted | Focused execution with clean output |
146
145
  | `:team` | Adversarial | 3 per team (Golden Triangle) | Debate mechanism | Critical features needing multiple perspectives |
147
146
 
148
147
  **Evidence**: [../../README.md](../../README.md), [../../commands/cook/](../../commands/cook/)
@@ -204,7 +203,7 @@ Classified error recovery system that prevents silent failures:
204
203
  | Specialist Agents | 21 |
205
204
  | Team Configurations | 17 (51 team agents) |
206
205
  | Commands | 14 |
207
- | Variants | 4 (fast, hard, focus, team) |
206
+ | Variants | 4 (fast, hard, team) |
208
207
  | Skill Modules | 1,430+ |
209
208
  | Skill Domains | 19 |
210
209
  | Orchestration Rules | 7 files |
@@ -118,27 +118,27 @@ agent-assistant/ # Project root — npm package @namch/
118
118
  │ ├── brainstorm.md # /brainstorm command router
119
119
  │ ├── brainstorm/ # fast.md, hard.md, team.md (3 variants)
120
120
  │ ├── code.md # /code command router
121
- │ ├── code/ # fast.md, focus.md, hard.md, team.md (4 variants)
121
+ │ ├── code/ # fast.md, hard.md, team.md (4 variants)
122
122
  │ ├── cook.md # /cook command router
123
- │ ├── cook/ # fast.md, focus.md, hard.md, team.md (4 variants)
123
+ │ ├── cook/ # fast.md, hard.md, team.md (4 variants)
124
124
  │ ├── debug.md # /debug command router
125
- │ ├── debug/ # fast.md, focus.md, hard.md, team.md (4 variants)
125
+ │ ├── debug/ # fast.md, hard.md, team.md (4 variants)
126
126
  │ ├── deploy.md # /deploy command router
127
127
  │ ├── deploy/ # check.md, preview.md, production.md, rollback.md (4 variants)
128
128
  │ ├── design.md # /design command router
129
- │ ├── design/ # fast.md, focus.md, hard.md, team.md (4 variants)
129
+ │ ├── design/ # fast.md, hard.md, team.md (4 variants)
130
130
  │ ├── docs.md # /docs command router
131
131
  │ ├── docs/ # audit.md, business.md, core.md (3 variants)
132
132
  │ ├── fix.md # /fix command router
133
- │ ├── fix/ # fast.md, focus.md, hard.md, team.md (4 variants)
133
+ │ ├── fix/ # fast.md, hard.md, team.md (4 variants)
134
134
  │ ├── plan.md # /plan command router
135
- │ ├── plan/ # fast.md, focus.md, hard.md, team.md (4 variants)
135
+ │ ├── plan/ # fast.md, hard.md, team.md (4 variants)
136
136
  │ ├── report.md # /report command router
137
- │ ├── report/ # fast.md, focus.md, hard.md, team.md (4 variants)
137
+ │ ├── report/ # fast.md, hard.md, team.md (4 variants)
138
138
  │ ├── review.md # /review command router
139
139
  │ ├── review/ # fast.md, hard.md, team.md (3 variants)
140
140
  │ ├── test.md # /test command router
141
- │ └── test/ # fast.md, focus.md, hard.md, team.md (4 variants)
141
+ │ └── test/ # fast.md, hard.md, team.md (4 variants)
142
142
 
143
143
  ├── documents/ # Project documentation
144
144
  │ ├── HSOL-ASSESSMENT.md # Assessment of HSOL system
@@ -228,7 +228,7 @@ The only directory containing executable code. Houses `install.js` (~600 lines,
228
228
  Contains 5 subdirectories, one per supported AI coding tool. Each provides platform-specific assets (entry point files, config files, rule files) that are copied during installation. The CLI reads from these directories to customize the installation for each platform's directory structure and file conventions.
229
229
 
230
230
  ### `commands/` — Command Workflows
231
- Contains 14 command router files (`.md`) at the top level and corresponding subdirectories with variant strategies. Standard variants are `fast.md`, `focus.md`, `hard.md`, `team.md`; deploy uses `check.md`, `preview.md`, `production.md`, `rollback.md`; docs uses `audit.md`, `business.md`, `core.md`. The command router file defines the base workflow, and variants modify execution strategy. Total: 61 Markdown files.
231
+ Contains 14 command router files (`.md`) at the top level and corresponding subdirectories with variant strategies. Standard variants are `fast.md`, `hard.md`, `team.md`; deploy uses `check.md`, `preview.md`, `production.md`, `rollback.md`; docs uses `audit.md`, `business.md`, `core.md`. The command router file defines the base workflow, and variants modify execution strategy. Total: 61 Markdown files.
232
232
 
233
233
  ### `documents/` — Project Documentation
234
234
  Stores long-form project documentation including the HSOL design blueprint, HSOL assessment, and the knowledge source base (this folder). Files here are included in the npm package and copied during installation to `~/.{tool}/skills/agent-assistant/documents/`.
@@ -205,24 +205,23 @@ Implements the command routing system — the primary user-facing interface. Use
205
205
  | `ask.md` | `ask/` | `fast`, `hard` |
206
206
  | `auto.md` | — | (no variants) |
207
207
  | `brainstorm.md` | `brainstorm/` | `fast`, `hard`, `team` |
208
- | `code.md` | `code/` | `fast`, `focus`, `hard`, `team` |
209
- | `cook.md` | `cook/` | `fast`, `focus`, `hard`, `team` |
210
- | `debug.md` | `debug/` | `fast`, `focus`, `hard`, `team` |
208
+ | `code.md` | `code/` | `fast`, `hard`, `team` |
209
+ | `cook.md` | `cook/` | `fast`, `hard`, `team` |
210
+ | `debug.md` | `debug/` | `fast`, `hard`, `team` |
211
211
  | `deploy.md` | `deploy/` | `check`, `preview`, `production`, `rollback` |
212
- | `design.md` | `design/` | `fast`, `focus`, `hard`, `team` |
212
+ | `design.md` | `design/` | `fast`, `hard`, `team` |
213
213
  | `docs.md` | `docs/` | `audit`, `business`, `core` |
214
- | `fix.md` | `fix/` | `fast`, `focus`, `hard`, `team` |
215
- | `plan.md` | `plan/` | `fast`, `focus`, `hard`, `team` |
216
- | `report.md` | `report/` | `fast`, `focus`, `hard`, `team` |
214
+ | `fix.md` | `fix/` | `fast`, `hard`, `team` |
215
+ | `plan.md` | `plan/` | `fast`, `hard`, `team` |
216
+ | `report.md` | `report/` | `fast`, `hard`, `team` |
217
217
  | `review.md` | `review/` | `fast`, `hard`, `team` |
218
- | `test.md` | `test/` | `fast`, `focus`, `hard`, `team` |
218
+ | `test.md` | `test/` | `fast`, `hard`, `team` |
219
219
 
220
220
  **Variant Pattern Categories**:
221
221
 
222
222
  | Pattern | Variants | Used By |
223
223
  |---------|----------|---------|
224
- | Standard (4 variants) | `fast`, `focus`, `hard`, `team` | code, cook, debug, design, fix, plan, report, test |
225
- | Standard-3 (no focus) | `fast`, `hard`, `team` | brainstorm, review |
224
+ | Standard-3 | `fast`, `hard`, `team` | code, cook, debug, design, fix, plan, report, test, brainstorm, review |
226
225
  | Minimal (2 variants) | `fast`, `hard` | ask |
227
226
  | Deploy-specific | `check`, `preview`, `production`, `rollback` | deploy |
228
227
  | Docs-specific | `audit`, `business`, `core` | docs |
@@ -310,7 +309,7 @@ HSOL Resolution Flow:
310
309
 
311
310
  | File | Purpose |
312
311
  |------|---------|
313
- | `_index.yaml` | Master HSOL configuration v1.1: enables HSOL, sets discovery parameters, defines `find-skills` integration commands, configures async threshold (0.8), variant applicability (`hard`, `focus` only — `fast` skips discovery) |
312
+ | `_index.yaml` | Master HSOL configuration v1.1: enables HSOL, sets discovery parameters, defines `find-skills` integration commands, configures async threshold (0.8), variant applicability (`hard`, `team` only — `fast` skips discovery) |
314
313
  | `_dynamic.yaml` | Manifest for community-installed skills added via `npx skills add` |
315
314
  | 19 domain `.yaml` files | Pre-curated skill registries mapped to agent profiles |
316
315
 
@@ -345,7 +344,7 @@ HSOL Resolution Flow:
345
344
  | `version` | 1.1 | HSOL protocol version |
346
345
  | `total_matrix_skills` | 1,430 | Total pre-curated skills |
347
346
  | `async_threshold` | 0.8 | Matrix fitness above this skips dynamic discovery |
348
- | `apply_for_variants` | `["hard", "focus"]` | Dynamic discovery only runs for these variants |
347
+ | `apply_for_variants` | `["hard", "team"]` | Dynamic discovery only runs for these variants |
349
348
  | `timeout_ms` | 5,000 | Discovery timeout |
350
349
  | `cache_ttl_seconds` | 3,600 | Discovery cache duration |
351
350
  | `find-skills` CLI commands | `npx skills find`, `npx skills add`, `npx skills check`, `npx skills update` | External skill service integration |
@@ -223,7 +223,7 @@ The central config for the Hybrid Skill Orchestration Layer:
223
223
  | `hsol.discovery.timeout_ms` | `5000` | Discovery request timeout |
224
224
  | `hsol.discovery.cache_ttl_seconds` | `3600` | Cache duration (1 hour) |
225
225
  | `hsol.discovery.async_threshold` | `0.8` | Skip discovery if matrix fitness exceeds this |
226
- | `hsol.discovery.apply_for_variants` | `["hard", "focus"]` | Only run discovery for these variants; `fast` skips it |
226
+ | `hsol.discovery.apply_for_variants` | `["hard", "team"]` | Only run discovery for these variants; `fast` skips it |
227
227
 
228
228
  ### matrix-skills/_dynamic.yaml
229
229
 
@@ -27,7 +27,6 @@ agent-assistant/
27
27
  │ └── cook/ # Variant subdirectory
28
28
  │ ├── fast.md
29
29
  │ ├── hard.md
30
- │ ├── focus.md
31
30
  │ └── team.md
32
31
  ├── documents/ # Project knowledge base
33
32
  │ ├── knowledge-overview/
@@ -56,7 +56,7 @@ hsol:
56
56
  cache_ttl_seconds: 3600
57
57
  async_threshold: 0.8 # Matrix fitness above this skips discovery
58
58
  # Only run dynamic discovery (find-skills) for these variants; "fast" skips discovery so fast stays fast
59
- apply_for_variants: ["hard", "focus"]
59
+ apply_for_variants: ["hard", "team"]
60
60
 
61
61
  # Fitness scoring weights
62
62
  fitness_weights:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@namch/agent-assistant",
3
- "version": "1.3.1",
3
+ "version": "1.3.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/AGENTS.md CHANGED
@@ -142,7 +142,7 @@ result:
142
142
 
143
143
  | When | Use |
144
144
  |------|-----|
145
- | Standard `:fast`, `:hard`, `:focus` variants | Single agent per phase |
145
+ | Standard `:fast`, `:hard` variants | Single agent per phase |
146
146
  | `:team` variant | Golden Triangle per phase |
147
147
  | User explicitly requests team review/collaboration | `:team` variant |
148
148
  | Maximum quality with adversarial debate is priority | `:team` variant |
@@ -8,19 +8,19 @@
8
8
 
9
9
  | Command | Router | Variants |
10
10
  |---------|--------|----------|
11
- | `/cook` | `cook.md` | `fast`, `hard`, `focus` |
12
- | `/fix` | `fix.md` | `fast`, `hard`, `focus` |
13
- | `/plan` | `plan.md` | `fast`, `hard`, `focus` |
14
- | `/debug` | `debug.md` | `fast`, `hard`, `focus` |
15
- | `/test` | `test.md` | `fast`, `hard`, `focus` |
11
+ | `/cook` | `cook.md` | `fast`, `hard`, `team` |
12
+ | `/fix` | `fix.md` | `fast`, `hard`, `team` |
13
+ | `/plan` | `plan.md` | `fast`, `hard`, `team` |
14
+ | `/debug` | `debug.md` | `fast`, `hard`, `team` |
15
+ | `/test` | `test.md` | `fast`, `hard`, `team` |
16
16
  | `/review` | `review.md` | `fast`, `hard` |
17
17
  | `/docs` | `docs.md` | `core`, `business`, `audit` |
18
- | `/design` | `design.md` | `fast`, `hard`, `focus` |
18
+ | `/design` | `design.md` | `fast`, `hard`, `team` |
19
19
  | `/deploy` | `deploy.md` | `check`, `preview`, `production`, `rollback` |
20
- | `/report` | `report.md` | `fast`, `hard`, `focus` |
20
+ | `/report` | `report.md` | `fast`, `hard`, `team` |
21
21
  | `/brainstorm` | `brainstorm.md` | `fast`, `hard` |
22
22
  | `/ask` | `ask.md` | `fast`, `hard` |
23
- | `/code` | `code.md` | `fast`, `hard`, `focus` |
23
+ | `/code` | `code.md` | `fast`, `hard`, `team` |
24
24
 
25
25
  ---
26
26
 
package/rules/SKILLS.md CHANGED
@@ -61,7 +61,7 @@ Dynamic skills: trust = 0.3 - 1.0 (based on history)
61
61
  | Variant | Discovery |
62
62
  |---------|----------|
63
63
  | `fast` | **Skip** — use matrix only |
64
- | `hard`, `focus` | Check matrix fitness, may trigger discovery |
64
+ | `hard`, `team` | Check matrix fitness, may trigger discovery |
65
65
 
66
66
  ### By Matrix Fitness
67
67