@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.
- package/CHANGELOG.md +13 -0
- package/README.md +3 -4
- package/code-assistants/codex-assistant/CODEX.md +1 -2
- package/commands/ask/hard.md +1 -1
- package/commands/brainstorm/hard.md +1 -1
- package/commands/code/hard.md +1 -1
- package/commands/code.md +2 -7
- package/commands/cook/hard.md +1 -1
- package/commands/cook.md +1 -6
- package/commands/debug/hard.md +1 -1
- package/commands/debug.md +1 -6
- package/commands/design/hard.md +1 -1
- package/commands/design.md +1 -6
- package/commands/fix/hard.md +1 -1
- package/commands/fix.md +1 -6
- package/commands/plan/hard.md +1 -1
- package/commands/plan.md +1 -6
- package/commands/report/fast.md +2 -2
- package/commands/report/hard.md +1 -1
- package/commands/report.md +2 -7
- package/commands/review/hard.md +1 -1
- package/commands/test/hard.md +1 -1
- package/commands/test.md +1 -6
- package/documents/HSOL-ASSESSMENT.md +6 -6
- package/documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md +1 -1
- package/documents/business/business-features/01-feature-inventory.md +5 -5
- package/documents/business/business-features/03-feature-specifications.md +7 -8
- package/documents/business/business-features/04-dependencies-and-release-sequencing.md +3 -3
- package/documents/business/business-features/05-success-metrics.md +2 -2
- package/documents/business/business-prd/03-stakeholders-and-requirements.md +1 -1
- package/documents/business/business-workflows/02-workflow-catalog.md +2 -2
- package/documents/business/business-workflows/03-detailed-workflows.md +5 -5
- package/documents/business/business-workflows/04-decision-rules-and-exceptions.md +2 -2
- package/documents/business/business-workflows/05-sla-and-handoffs.md +1 -1
- package/documents/knowledge-architecture/00-index.md +2 -2
- package/documents/knowledge-architecture/01-system-overview.md +2 -2
- package/documents/knowledge-architecture/02-components.md +8 -8
- package/documents/knowledge-architecture/03-data-flow.md +1 -2
- package/documents/knowledge-architecture/04-design-patterns.md +1 -2
- package/documents/knowledge-architecture/05-decisions.md +3 -3
- package/documents/knowledge-domain/00-index.md +1 -1
- package/documents/knowledge-domain/01-entities.md +9 -10
- package/documents/knowledge-domain/03-api-contracts.md +17 -19
- package/documents/knowledge-domain/04-business-rules.md +0 -1
- package/documents/knowledge-overview/00-index.md +1 -1
- package/documents/knowledge-overview/01-project-identity.md +1 -1
- package/documents/knowledge-overview/03-features.md +2 -3
- package/documents/knowledge-source-base/01-directory-structure.md +9 -9
- package/documents/knowledge-source-base/03-key-modules.md +11 -12
- package/documents/knowledge-source-base/04-configuration.md +1 -1
- package/documents/knowledge-standards/02-conventions.md +0 -1
- package/matrix-skills/_index.yaml +1 -1
- package/package.json +1 -1
- package/rules/AGENTS.md +1 -1
- package/rules/REFERENCE.md +8 -8
- package/rules/SKILLS.md +1 -1
- package/rules/TEAMS.md +1 -2
- package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/agents/openai.yaml +0 -4
- package/commands/code/focus.md +0 -297
- package/commands/cook/focus.md +0 -209
- package/commands/debug/focus.md +0 -103
- package/commands/design/focus.md +0 -229
- package/commands/fix/focus.md +0 -145
- package/commands/plan/focus.md +0 -140
- package/commands/report/focus.md +0 -107
- package/commands/test/focus.md +0 -123
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [1.3.2] - 2026-03-30
|
|
9
|
+
|
|
10
|
+
### Removed
|
|
11
|
+
- **Focus workflow variant deprecation (complete)**:
|
|
12
|
+
- Removed remaining focus workflow files and command-level focus routing references.
|
|
13
|
+
- Removed focus variant mentions from active command metadata and workflow documentation.
|
|
14
|
+
- Removed stale focus references from business analysis docs that still listed `fast/hard/focus/team`.
|
|
15
|
+
|
|
16
|
+
### Changed
|
|
17
|
+
- **Changelog and docs normalization after focus cleanup**:
|
|
18
|
+
- Updated changelog wording to avoid legacy focus workflow terminology in active release notes.
|
|
19
|
+
- Kept accessibility/UI focus semantics (e.g., `:focus`, `:focus-visible`) untouched where they are unrelated to command variants.
|
|
20
|
+
|
|
8
21
|
## [1.3.1] - 2026-03-26
|
|
9
22
|
|
|
10
23
|
### Changed
|
package/README.md
CHANGED
|
@@ -22,7 +22,7 @@ Transform one AI into a coordinated team of 21 specialist agents with structured
|
|
|
22
22
|
| **One-Time Setup, Forever Use** | Configure once at global level (`~/.cursor/`, `~/.claude/`, etc.) and it auto-applies to ALL your projects. No more repetitive config for every new repo. |
|
|
23
23
|
| **Sub-Agent Orchestration** | When supported (Claude Code, Cursor Max mode), the main agent spawns specialized sub-agents to handle tasks **in parallel** — backend, frontend, testing, security all working simultaneously. |
|
|
24
24
|
| **Multi-Platform Support** | Works seamlessly across **Cursor**, **GitHub Copilot**, **Claude Code**, **Codex**, and **Antigravity/Gemini**. Same workflows, any tool. |
|
|
25
|
-
| **Matrix Skill Discovery (HSOL)** | Injects the right skills by profile and request; optional dynamic discovery (find-skills) for `hard`/`
|
|
25
|
+
| **Matrix Skill Discovery (HSOL)** | Injects the right skills by profile and request; optional dynamic discovery (find-skills) for `hard`/`team` when matrix fitness < 0.8. 1400+ matrix skills, zero manual config. |
|
|
26
26
|
|
|
27
27
|
### The Goal
|
|
28
28
|
|
|
@@ -140,7 +140,6 @@ Creates `./documents/` files that agents reference. Without docs, agents work ge
|
|
|
140
140
|
| ------- | ---------------- | -------------------------- |
|
|
141
141
|
| `:fast` | Simple tasks | 2-3 agents |
|
|
142
142
|
| `:hard` | Complex features | 5-8 agents + quality gates |
|
|
143
|
-
| `:focus` | Clean execution | (cook, code, fix, debug, design, plan, test, report) |
|
|
144
143
|
| `:team` | Team workflows | All agents, structured phases |
|
|
145
144
|
|
|
146
145
|
## Commands Reference
|
|
@@ -151,7 +150,7 @@ Creates `./documents/` files that agents reference. Without docs, agents work ge
|
|
|
151
150
|
| **Quality** | `/test`, `/review`, `/debug` |
|
|
152
151
|
| **Plan** | `/plan`, `/brainstorm`, `/design` |
|
|
153
152
|
| **Docs** | `/docs:core`, `/docs:business`, `/docs:audit` |
|
|
154
|
-
| **Report** | `/report:fast`, `/report:hard`, `/report:
|
|
153
|
+
| **Report** | `/report:fast`, `/report:hard`, `/report:team` |
|
|
155
154
|
| **Deploy** | `/deploy:check`, `/deploy:preview`, `/deploy:production` |
|
|
156
155
|
|
|
157
156
|
---
|
|
@@ -188,7 +187,7 @@ profile: "backend:execution"
|
|
|
188
187
|
```
|
|
189
188
|
agent-assistant/
|
|
190
189
|
├── agents/ # 21 specialist agents
|
|
191
|
-
├── commands/ # 50+ workflow commands (routers + variants: fast, hard,
|
|
190
|
+
├── commands/ # 50+ workflow commands (routers + variants: fast, hard, team)
|
|
192
191
|
├── rules/ # 8 orchestration rules
|
|
193
192
|
├── matrix-skills/ # 19 domain skill registries
|
|
194
193
|
├── skills/ # 1400+ domain skills
|
|
@@ -133,9 +133,8 @@ Append `:variant` to any command for specialized workflows:
|
|
|
133
133
|
| `:hard` | `commands/{cmd}/hard.md` | Complex/deep variant |
|
|
134
134
|
| `:fast` | `commands/{cmd}/fast.md` | Quick/lightweight variant |
|
|
135
135
|
| `:team` | `commands/{cmd}/team.md` | Parallel multi-agent team |
|
|
136
|
-
| `:focus` | `commands/{cmd}/focus.md` | Focused single-concern variant |
|
|
137
136
|
|
|
138
|
-
**Examples**: `/cook:hard`, `/fix:fast`, `/review:team`, `/plan:
|
|
137
|
+
**Examples**: `/cook:hard`, `/fix:fast`, `/review:team`, `/plan:team`
|
|
139
138
|
|
|
140
139
|
**Team variant baseline**: `:team` is supported only where `commands/{cmd}/team.md` exists. Deploy uses specialized variants (`check`, `preview`, `production`, `rollback`).
|
|
141
140
|
|
package/commands/ask/hard.md
CHANGED
|
@@ -23,7 +23,7 @@ execution-mode: execute
|
|
|
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/
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
@@ -23,7 +23,7 @@ execution-mode: execute
|
|
|
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/
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
package/commands/code/hard.md
CHANGED
|
@@ -23,7 +23,7 @@ execution-mode: execute
|
|
|
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/
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
package/commands/code.md
CHANGED
|
@@ -29,7 +29,7 @@ execution-mode: router
|
|
|
29
29
|
|
|
30
30
|
```
|
|
31
31
|
IF user references an existing plan (@plan, @PLAN-..., path to PLAN-*.md, or "according to plan" / "follow the plan"):
|
|
32
|
-
→ Route to /code:hard
|
|
32
|
+
→ Route to /code:hard (workflow will SKIP research, scout, brainstorm and go straight to implementation)
|
|
33
33
|
|
|
34
34
|
IF task is simple (clear requirements, single file):
|
|
35
35
|
→ Route to /code:fast
|
|
@@ -37,9 +37,6 @@ IF task is simple (clear requirements, single file):
|
|
|
37
37
|
IF task is complex (multi-file, research needed):
|
|
38
38
|
→ Route to /code:hard
|
|
39
39
|
|
|
40
|
-
IF task is complex AND context optimization is critical:
|
|
41
|
-
→ Route to /code:focus
|
|
42
|
-
|
|
43
40
|
IF task is complex AND maximum quality with team collaboration needed:
|
|
44
41
|
→ Route to /code:team
|
|
45
42
|
|
|
@@ -55,7 +52,6 @@ IF unsure:
|
|
|
55
52
|
| ------------- | ------------------------------------------------------- |
|
|
56
53
|
| `/code:fast` | Quick implementation, clear requirements |
|
|
57
54
|
| `/code:hard` | Complex features, multi-file changes |
|
|
58
|
-
| `/code:focus` | Complex features with **enforced context optimization** |
|
|
59
55
|
| `/code:team` | Maximum quality with parallel agent team collaboration |
|
|
60
56
|
|
|
61
57
|
---
|
|
@@ -71,8 +67,7 @@ IF unsure:
|
|
|
71
67
|
|
|
72
68
|
1. ⚡ **Fast** → `/code:fast` — Quick implementation
|
|
73
69
|
2. ⚡⚡⚡ **Hard** → `/code:hard` — Full development cycle
|
|
74
|
-
3.
|
|
75
|
-
4. 👥 **Team** → `/code:team` — Full team collaboration (parallel agents, maximum quality)
|
|
70
|
+
3. 👥 **Team** → `/code:team` — Full team collaboration (parallel agents, maximum quality)
|
|
76
71
|
|
|
77
72
|
⏳ Awaiting selection...
|
|
78
73
|
```
|
package/commands/cook/hard.md
CHANGED
|
@@ -23,7 +23,7 @@ execution-mode: execute
|
|
|
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/
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
package/commands/cook.md
CHANGED
|
@@ -34,9 +34,6 @@ IF feature is simple (clear spec, low complexity):
|
|
|
34
34
|
IF feature is complex (multi-component, research needed):
|
|
35
35
|
→ Route to /cook:hard
|
|
36
36
|
|
|
37
|
-
IF feature is complex AND context optimization is critical:
|
|
38
|
-
→ Route to /cook:focus
|
|
39
|
-
|
|
40
37
|
IF feature is complex AND maximum quality with team collaboration needed:
|
|
41
38
|
→ Route to /cook:team
|
|
42
39
|
|
|
@@ -52,7 +49,6 @@ IF unsure:
|
|
|
52
49
|
| ------------- | ------------------------------------------------------- |
|
|
53
50
|
| `/cook:fast` | Quick features, clear specifications |
|
|
54
51
|
| `/cook:hard` | Complex features, full workflow |
|
|
55
|
-
| `/cook:focus` | Complex features with **enforced context optimization** |
|
|
56
52
|
| `/cook:team` | Maximum quality with parallel agent team collaboration |
|
|
57
53
|
|
|
58
54
|
---
|
|
@@ -68,8 +64,7 @@ IF unsure:
|
|
|
68
64
|
|
|
69
65
|
1. ⚡ **Fast** → `/cook:fast` — Quick implementation
|
|
70
66
|
2. ⚡⚡⚡ **Hard** → `/cook:hard` — Full feature development
|
|
71
|
-
3.
|
|
72
|
-
4. 👥 **Team** → `/cook:team` — Full team collaboration (parallel agents, maximum quality)
|
|
67
|
+
3. 👥 **Team** → `/cook:team` — Full team collaboration (parallel agents, maximum quality)
|
|
73
68
|
|
|
74
69
|
⏳ Awaiting selection...
|
|
75
70
|
```
|
package/commands/debug/hard.md
CHANGED
|
@@ -23,7 +23,7 @@ execution-mode: execute
|
|
|
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/
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
package/commands/debug.md
CHANGED
|
@@ -33,9 +33,6 @@ IF issue is simple (clear error, reproducible):
|
|
|
33
33
|
IF issue is complex (intermittent, unclear cause):
|
|
34
34
|
→ Route to /debug:hard
|
|
35
35
|
|
|
36
|
-
IF issue is complex AND clean fix handoff is critical:
|
|
37
|
-
→ Route to /debug:focus
|
|
38
|
-
|
|
39
36
|
IF issue is complex AND maximum quality with team collaboration needed:
|
|
40
37
|
→ Route to /debug:team
|
|
41
38
|
|
|
@@ -51,7 +48,6 @@ IF unsure:
|
|
|
51
48
|
| --------------- | ---------------------------------------------------- |
|
|
52
49
|
| `/debug:fast` | Quick diagnosis for simple bugs |
|
|
53
50
|
| `/debug:hard` | Deep investigation for complex issues |
|
|
54
|
-
| `/debug:focus` | Deep investigation with **enforced context optimization** |
|
|
55
51
|
| `/debug:team` | Maximum quality with parallel agent team collaboration |
|
|
56
52
|
|
|
57
53
|
---
|
|
@@ -67,8 +63,7 @@ IF unsure:
|
|
|
67
63
|
|
|
68
64
|
1. ⚡ **Fast** → `/debug:fast` — Quick diagnosis
|
|
69
65
|
2. ⚡⚡⚡ **Hard** → `/debug:hard` — Deep investigation
|
|
70
|
-
3.
|
|
71
|
-
4. 👥 **Team** → `/debug:team` — Full team collaboration (parallel agents, maximum quality)
|
|
66
|
+
3. 👥 **Team** → `/debug:team` — Full team collaboration (parallel agents, maximum quality)
|
|
72
67
|
|
|
73
68
|
⏳ Awaiting selection...
|
|
74
69
|
```
|
package/commands/design/hard.md
CHANGED
|
@@ -23,7 +23,7 @@ execution-mode: execute
|
|
|
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/
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
package/commands/design.md
CHANGED
|
@@ -34,9 +34,6 @@ IF design is simple (component, quick mockup):
|
|
|
34
34
|
IF design is complex (full feature, system):
|
|
35
35
|
→ Route to /design:hard
|
|
36
36
|
|
|
37
|
-
IF design is complex AND clean implementation handoff is critical:
|
|
38
|
-
→ Route to /design:focus
|
|
39
|
-
|
|
40
37
|
IF design is complex AND maximum quality with team collaboration needed:
|
|
41
38
|
→ Route to /design:team
|
|
42
39
|
|
|
@@ -52,7 +49,6 @@ IF unsure:
|
|
|
52
49
|
| --------------- | -------------------------------------------------- |
|
|
53
50
|
| `/design:fast` | Quick component design, simple UI |
|
|
54
51
|
| `/design:hard` | Full feature design, system design |
|
|
55
|
-
| `/design:focus` | Full design with **enforced context optimization** |
|
|
56
52
|
| `/design:team` | Maximum quality with parallel agent team collaboration |
|
|
57
53
|
|
|
58
54
|
---
|
|
@@ -68,8 +64,7 @@ IF unsure:
|
|
|
68
64
|
|
|
69
65
|
1. ⚡ **Fast** → `/design:fast` — Quick design
|
|
70
66
|
2. ⚡⚡⚡ **Hard** → `/design:hard` — Full design process
|
|
71
|
-
3.
|
|
72
|
-
4. 👥 **Team** → `/design:team` — Full team collaboration (parallel agents, maximum quality)
|
|
67
|
+
3. 👥 **Team** → `/design:team` — Full team collaboration (parallel agents, maximum quality)
|
|
73
68
|
|
|
74
69
|
⏳ Awaiting selection...
|
|
75
70
|
```
|
package/commands/fix/hard.md
CHANGED
|
@@ -22,7 +22,7 @@ execution-mode: execute
|
|
|
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/
|
|
25
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
26
26
|
|
|
27
27
|
---
|
|
28
28
|
|
package/commands/fix.md
CHANGED
|
@@ -34,9 +34,6 @@ IF issue is simple (clear cause, quick fix):
|
|
|
34
34
|
IF issue is complex (research needed, multi-file):
|
|
35
35
|
→ Route to /fix:hard
|
|
36
36
|
|
|
37
|
-
IF issue is complex AND context optimization is critical:
|
|
38
|
-
→ Route to /fix:focus
|
|
39
|
-
|
|
40
37
|
IF issue is complex AND maximum quality with team collaboration needed:
|
|
41
38
|
→ Route to /fix:team
|
|
42
39
|
|
|
@@ -52,7 +49,6 @@ IF unsure:
|
|
|
52
49
|
| ------------ | ----------------------------------------------------- |
|
|
53
50
|
| `/fix:fast` | Quick fixes, clear issues |
|
|
54
51
|
| `/fix:hard` | Complex issues, research needed |
|
|
55
|
-
| `/fix:focus` | Complex issues with **enforced context optimization** |
|
|
56
52
|
| `/fix:team` | Maximum quality with parallel agent team collaboration |
|
|
57
53
|
|
|
58
54
|
---
|
|
@@ -68,8 +64,7 @@ IF unsure:
|
|
|
68
64
|
|
|
69
65
|
1. ⚡ **Fast** → `/fix:fast` — Quick fix
|
|
70
66
|
2. ⚡⚡⚡ **Hard** → `/fix:hard` — Full resolution
|
|
71
|
-
3.
|
|
72
|
-
4. 👥 **Team** → `/fix:team` — Full team collaboration (parallel agents, maximum quality)
|
|
67
|
+
3. 👥 **Team** → `/fix:team` — Full team collaboration (parallel agents, maximum quality)
|
|
73
68
|
|
|
74
69
|
⏳ Awaiting selection...
|
|
75
70
|
```
|
package/commands/plan/hard.md
CHANGED
|
@@ -23,7 +23,7 @@ execution-mode: execute
|
|
|
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/
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
package/commands/plan.md
CHANGED
|
@@ -34,9 +34,6 @@ IF task is clear (known approach, codebase-only):
|
|
|
34
34
|
IF task is complex (research needed, architectural):
|
|
35
35
|
→ Route to /plan:hard
|
|
36
36
|
|
|
37
|
-
IF task is complex AND clean implementation handoff is critical:
|
|
38
|
-
→ Route to /plan:focus
|
|
39
|
-
|
|
40
37
|
IF task is complex AND maximum quality with team collaboration needed:
|
|
41
38
|
→ Route to /plan:team
|
|
42
39
|
|
|
@@ -52,7 +49,6 @@ IF unsure:
|
|
|
52
49
|
| ------------- | ---------------------------------------------------- |
|
|
53
50
|
| `/plan:fast` | Quick planning without research |
|
|
54
51
|
| `/plan:hard` | Full planning with research |
|
|
55
|
-
| `/plan:focus` | Full planning with **enforced context optimization** |
|
|
56
52
|
| `/plan:team` | Maximum quality with parallel agent team collaboration |
|
|
57
53
|
|
|
58
54
|
---
|
|
@@ -68,8 +64,7 @@ IF unsure:
|
|
|
68
64
|
|
|
69
65
|
1. ⚡ **Fast** → `/plan:fast` — Quick plan
|
|
70
66
|
2. ⚡⚡⚡ **Hard** → `/plan:hard` — Full research-backed plan
|
|
71
|
-
3.
|
|
72
|
-
4. 👥 **Team** → `/plan:team` — Full team collaboration (parallel agents, maximum quality)
|
|
67
|
+
3. 👥 **Team** → `/plan:team` — Full team collaboration (parallel agents, maximum quality)
|
|
73
68
|
|
|
74
69
|
⏳ Awaiting selection...
|
|
75
70
|
```
|
package/commands/report/fast.md
CHANGED
|
@@ -10,7 +10,7 @@ execution-mode: execute
|
|
|
10
10
|
> **MISSION**: Generate concise, actionable status reports and summaries.
|
|
11
11
|
>
|
|
12
12
|
> Use for daily standups, progress checks, and high-level overviews.
|
|
13
|
-
> For **update existing files** or **generate from template**, use `/report:hard` or `/report:
|
|
13
|
+
> For **update existing files** or **generate from template**, use `/report:hard` or `/report:team`.
|
|
14
14
|
|
|
15
15
|
<task>$ARGUMENTS</task>
|
|
16
16
|
|
|
@@ -61,7 +61,7 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
61
61
|
| Agent | `reporter` |
|
|
62
62
|
| ----- | -------------------------------------------------------------------------- |
|
|
63
63
|
| Goal | Infer intent; if **create report** → generate concise status report |
|
|
64
|
-
| Exit | Report with Summary, Key Changes, Next Steps — or recommend `/report:hard`/`/report:
|
|
64
|
+
| Exit | Report with Summary, Key Changes, Next Steps — or recommend `/report:hard`/`/report:team` if user intent is update/template |
|
|
65
65
|
|
|
66
66
|
---
|
|
67
67
|
|
package/commands/report/hard.md
CHANGED
|
@@ -25,7 +25,7 @@ execution-mode: execute
|
|
|
25
25
|
|
|
26
26
|
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
27
27
|
|
|
28
|
-
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/
|
|
28
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
29
29
|
|
|
30
30
|
---
|
|
31
31
|
|
package/commands/report.md
CHANGED
|
@@ -50,11 +50,8 @@ IF task is simple status update OR summary:
|
|
|
50
50
|
IF task is comprehensive analysis OR deep dive OR any non-trivial topic (infer from request):
|
|
51
51
|
→ Route to /report:hard
|
|
52
52
|
|
|
53
|
-
IF task requires absolute context clarity OR "clean slate" analysis:
|
|
54
|
-
→ Route to /report:focus
|
|
55
|
-
|
|
56
53
|
IF user explicitly asks to UPDATE existing files (not create report):
|
|
57
|
-
→
|
|
54
|
+
→ Use /report:hard or /report:team; reporter OUTPUT MODE = update existing files
|
|
58
55
|
|
|
59
56
|
IF task is complex AND maximum quality with team collaboration needed:
|
|
60
57
|
→ Route to /report:team
|
|
@@ -71,7 +68,6 @@ IF unsure:
|
|
|
71
68
|
| --------------- | --------------------------------------------------------------------------- |
|
|
72
69
|
| `/report:fast` | Quick status updates, daily summaries |
|
|
73
70
|
| `/report:hard` | Detailed analysis, any topic (algorithms, docs, changes), template-based |
|
|
74
|
-
| `/report:focus` | Deep analysis with **enforced context optimization**; update or create |
|
|
75
71
|
| `/report:team` | Maximum quality with parallel agent team collaboration |
|
|
76
72
|
|
|
77
73
|
---
|
|
@@ -87,8 +83,7 @@ IF unsure:
|
|
|
87
83
|
|
|
88
84
|
1. ⚡ **Fast** → `/report:fast` — Quick summary
|
|
89
85
|
2. ⚡⚡⚡ **Hard** → `/report:hard` — Full analysis, any topic; create report **or** update existing files / use template
|
|
90
|
-
3.
|
|
91
|
-
4. 👥 **Team** → `/report:team` — Full team collaboration (parallel agents, maximum quality)
|
|
86
|
+
3. 👥 **Team** → `/report:team` — Full team collaboration (parallel agents, maximum quality)
|
|
92
87
|
|
|
93
88
|
⏳ Awaiting selection...
|
|
94
89
|
```
|
package/commands/review/hard.md
CHANGED
|
@@ -22,7 +22,7 @@ execution-mode: execute
|
|
|
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/
|
|
25
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
26
26
|
|
|
27
27
|
---
|
|
28
28
|
|
package/commands/test/hard.md
CHANGED
|
@@ -23,7 +23,7 @@ execution-mode: execute
|
|
|
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/
|
|
26
|
+
**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
package/commands/test.md
CHANGED
|
@@ -33,9 +33,6 @@ IF scope is limited (unit tests, quick check):
|
|
|
33
33
|
IF scope is comprehensive (full suite, E2E):
|
|
34
34
|
→ Route to /test:hard
|
|
35
35
|
|
|
36
|
-
IF scope is comprehensive AND clean execution focus is critical:
|
|
37
|
-
→ Route to /test:focus
|
|
38
|
-
|
|
39
36
|
IF scope is comprehensive AND maximum quality with team collaboration needed:
|
|
40
37
|
→ Route to /test:team
|
|
41
38
|
|
|
@@ -51,7 +48,6 @@ IF unsure:
|
|
|
51
48
|
| -------------- | -------------------------------------------------- |
|
|
52
49
|
| `/test:fast` | Quick tests, unit tests |
|
|
53
50
|
| `/test:hard` | Full test suite, E2E |
|
|
54
|
-
| `/test:focus` | Full testing with **enforced context optimization** |
|
|
55
51
|
| `/test:team` | Maximum quality with parallel agent team collaboration |
|
|
56
52
|
|
|
57
53
|
---
|
|
@@ -67,8 +63,7 @@ IF unsure:
|
|
|
67
63
|
|
|
68
64
|
1. ⚡ **Fast** → `/test:fast` — Quick tests
|
|
69
65
|
2. ⚡⚡⚡ **Hard** → `/test:hard` — Comprehensive testing
|
|
70
|
-
3.
|
|
71
|
-
4. 👥 **Team** → `/test:team` — Full team collaboration (parallel agents, maximum quality)
|
|
66
|
+
3. 👥 **Team** → `/test:team` — Full team collaboration (parallel agents, maximum quality)
|
|
72
67
|
|
|
73
68
|
⏳ Awaiting selection...
|
|
74
69
|
```
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
| Dimension | Rating | Notes |
|
|
12
12
|
|-----------|--------|--------|
|
|
13
13
|
| **Completeness** | Strong | Resolution algorithm, decision gate, blocking/async, variant/fitness, trust, conflict, edge cases are defined. |
|
|
14
|
-
| **Consistency** | Strong | Thresholds (0.75, 0.8), variant (fast/hard/
|
|
14
|
+
| **Consistency** | Strong | Thresholds (0.75, 0.8), variant (fast/hard/team), and flow align across Discovery, Orchestration, _index.yaml, Blueprint. |
|
|
15
15
|
| **Production readiness** | Good | Clear rules for tool scope, install commands, fallbacks; a few operational gaps (see below). |
|
|
16
16
|
| **Agent intelligence** | Strong | Matrix-first + dynamic enhancement, blocking when matrix insufficient so current task uses new skill; async when matrix adequate. |
|
|
17
17
|
|
|
@@ -28,9 +28,9 @@
|
|
|
28
28
|
|
|
29
29
|
2. **Variant + fitness logic**
|
|
30
30
|
- Fast → no discovery (keeps fast path low-latency).
|
|
31
|
-
- Hard/
|
|
32
|
-
- Hard/
|
|
33
|
-
- Hard/
|
|
31
|
+
- Hard/Team + fitness ≥ 0.8 → skip discovery.
|
|
32
|
+
- Hard/Team + 0.75 ≤ fitness < 0.8 → async (recommend for next time).
|
|
33
|
+
- Hard/Team + fitness < 0.75 → blocking (current task uses new skill). Aligns with “skill for current work” goal.
|
|
34
34
|
|
|
35
35
|
3. **Tool-scoped behavior**
|
|
36
36
|
- All install/verify actions are for the **current tool only**; `-g -y` and no cross-tool install unless user asks. Reduces confusion and errors.
|
|
@@ -78,7 +78,7 @@
|
|
|
78
78
|
|
|
79
79
|
### 5. Default variant (optional)
|
|
80
80
|
|
|
81
|
-
**Issue**: When user says `/cook` without `:fast` or `:hard`, the router picks a default. Discovery runs only for hard/
|
|
81
|
+
**Issue**: When user says `/cook` without `:fast` or `:hard`, the router picks a default. Discovery runs only for hard/team. If the default is “hard”, discovery applies; if “fast”, it does not. Not ambiguous but could be explicit.
|
|
82
82
|
|
|
83
83
|
**Suggestion**: In SKILL-DISCOVERY or SKILL-ORCHESTRATION, one line: “When command has no variant, use the router’s default (e.g. hard for full workflows); discovery eligibility follows that variant.” Optional.
|
|
84
84
|
|
|
@@ -96,7 +96,7 @@
|
|
|
96
96
|
- **Install flow**: Commands, scope (current tool), and confirm rules are clear.
|
|
97
97
|
- **Fallbacks**: Timeout, no skills, install failure are handled.
|
|
98
98
|
- **Config**: _index.yaml has discovery on/off, thresholds, variants, promotion; per-agent overrides exist.
|
|
99
|
-
- **Cross-doc alignment**: Thresholds (0.75, 0.8), variant list (hard,
|
|
99
|
+
- **Cross-doc alignment**: Thresholds (0.75, 0.8), variant list (hard, team), and flow (blocking vs async) match across docs and config.
|
|
100
100
|
|
|
101
101
|
---
|
|
102
102
|
|
|
@@ -263,7 +263,7 @@ ROOT CAUSE: No automated feedback loop between:
|
|
|
263
263
|
> **Blocking** (matrix fitness < 0.75): Wait for discovery → install → re-inject → **then** execute. Purpose: new skill is **used for the current task** — best completion for this request. **Async** (fitness 0.75–0.8): Do not wait; execute with matrix; when discovery returns only surface recommendation for **next time**. Async does not improve accuracy for the current task.
|
|
264
264
|
|
|
265
265
|
**Principle 2b: Conditional Discovery (Variant + Fitness)**
|
|
266
|
-
> Dynamic discovery (find-skills, steps 8–10) runs **only** when: (1) command variant is **`hard`** or **`
|
|
266
|
+
> Dynamic discovery (find-skills, steps 8–10) runs **only** when: (1) command variant is **`hard`** or **`team`** — **`fast`** skips discovery so fast stays fast; (2) best matrix fitness **< 0.8** — if matrix already has a highly suitable skill (e.g. 9–10), skip discovery. So: fast flow → steps 1–7 + execute; hard/team + matrix sufficient → same; hard/team + matrix < 0.8 → full flow including discovery.
|
|
267
267
|
|
|
268
268
|
**Principle 3: Graduated Trust**
|
|
269
269
|
> Newly discovered skills start in "evaluation mode" with limited scope. Trust increases with successful executions.
|
|
@@ -82,15 +82,15 @@
|
|
|
82
82
|
|
|
83
83
|
---
|
|
84
84
|
|
|
85
|
-
### BF-006 —
|
|
85
|
+
### BF-006 — 3 Variant Strategies
|
|
86
86
|
|
|
87
|
-
**Description**: Each command supports up to
|
|
87
|
+
**Description**: Each command supports up to 3 variants controlling scope and rigor: `:fast` (2–3 agents, basic gates), `:hard` (5–8 agents, comprehensive gates including test/review/security), `:team` (adversarial Golden Triangle with debate mechanism).
|
|
88
88
|
|
|
89
89
|
**Business Value**: Right-sized workflows for every task. Simple fixes use `:fast` (seconds), production features use `:hard` (thorough), critical systems use `:team` (adversarial review). Token cost scales with complexity.
|
|
90
90
|
|
|
91
91
|
**Goal Mapping**: BG-003 (Speed), BG-006 (Structured workflows)
|
|
92
92
|
|
|
93
|
-
**Key Files**: `commands/cook/fast.md`, `commands/cook/hard.md`, `commands/cook/
|
|
93
|
+
**Key Files**: `commands/cook/fast.md`, `commands/cook/hard.md`, `commands/cook/team.md`, `commands/cook/team.md` (pattern repeated per command)
|
|
94
94
|
|
|
95
95
|
---
|
|
96
96
|
|
|
@@ -170,7 +170,7 @@
|
|
|
170
170
|
|
|
171
171
|
### BF-013 — Dynamic Skill Discovery
|
|
172
172
|
|
|
173
|
-
**Description**: When the matrix fitness score falls below 0.8 for `:hard` or `:
|
|
173
|
+
**Description**: When the matrix fitness score falls below 0.8 for `:hard` or `:team` variants, the `find-skills` mechanism can discover additional community skills at runtime. Discovered skills are registered in `matrix-skills/_dynamic.yaml`.
|
|
174
174
|
|
|
175
175
|
**Business Value**: Extends the framework's knowledge beyond the bundled 1,430 skills. Community contributions supplement gaps in niche or emerging domains without requiring a framework release.
|
|
176
176
|
|
|
@@ -286,7 +286,7 @@
|
|
|
286
286
|
|
|
287
287
|
**Goal Mapping**: BG-003 (Speed)
|
|
288
288
|
|
|
289
|
-
**Key Files**: `commands/code.md` (routing), `commands/code/hard.md`, `commands/code/
|
|
289
|
+
**Key Files**: `commands/code.md` (routing), `commands/code/hard.md`, `commands/code/team.md` (skip logic)
|
|
290
290
|
|
|
291
291
|
---
|
|
292
292
|
|
|
@@ -124,9 +124,9 @@ Each feature specification includes:
|
|
|
124
124
|
|
|
125
125
|
---
|
|
126
126
|
|
|
127
|
-
### BF-006 —
|
|
127
|
+
### BF-006 — 3 Variant Strategies
|
|
128
128
|
|
|
129
|
-
**Description**: `:fast` (2–3 agents), `:hard` (5–8 agents + gates), `:
|
|
129
|
+
**Description**: `:fast` (2–3 agents), `:hard` (5–8 agents + gates), `:team` (adversarial Golden Triangle).
|
|
130
130
|
|
|
131
131
|
**Acceptance Criteria**:
|
|
132
132
|
|
|
@@ -134,11 +134,10 @@ Each feature specification includes:
|
|
|
134
134
|
|---|-------|------|------|
|
|
135
135
|
| AC-1 | `/cook` command issued | User specifies `:fast` | 2–3 agents execute with basic quality gates |
|
|
136
136
|
| AC-2 | `/cook` command issued | User specifies `:hard` | 5–8 agents execute with test, review, and security gates |
|
|
137
|
-
| AC-3 | `/cook` command issued | User specifies `:
|
|
138
|
-
| AC-4 | `/cook` command issued | User specifies `:team` | Golden Triangle team (Tech Lead + Executor + Reviewer) with debate |
|
|
137
|
+
| AC-3 | `/cook` command issued | User specifies `:team` | Golden Triangle team (Tech Lead + Executor + Reviewer) with debate |
|
|
139
138
|
|
|
140
139
|
**Technical Surface**:
|
|
141
|
-
- `commands/cook/fast.md`, `commands/cook/hard.md`, `commands/cook/
|
|
140
|
+
- `commands/cook/fast.md`, `commands/cook/hard.md`, `commands/cook/team.md`
|
|
142
141
|
- Pattern replicated for each command supporting variants
|
|
143
142
|
|
|
144
143
|
**Dependencies**: BF-005 (command router)
|
|
@@ -156,7 +155,7 @@ Each feature specification includes:
|
|
|
156
155
|
| AC-1 | Agent has profile with backend domain | HSOL resolves skills | Backend-relevant skills from `matrix-skills/backend.yaml` are injected |
|
|
157
156
|
| AC-2 | 19 domain YAML files exist | HSOL resolution runs | All domains are searchable; `_index.yaml` is the entry point |
|
|
158
157
|
| AC-3 | Fitness score computed | Score >= 0.8 | Skill is included in the resolved set |
|
|
159
|
-
| AC-4 | Fitness score computed | Score < 0.8 in `:hard`/`:
|
|
158
|
+
| AC-4 | Fitness score computed | Score < 0.8 in `:hard`/`:team` | Dynamic discovery (BF-013) may trigger |
|
|
160
159
|
|
|
161
160
|
**Technical Surface**:
|
|
162
161
|
- `rules/SKILLS.md` — Resolution algorithm, fitness scoring, thresholds
|
|
@@ -274,7 +273,7 @@ Each feature specification includes:
|
|
|
274
273
|
|
|
275
274
|
### BF-013 — Dynamic Skill Discovery
|
|
276
275
|
|
|
277
|
-
**Description**: When fitness < 0.8 in `:hard`/`:
|
|
276
|
+
**Description**: When fitness < 0.8 in `:hard`/`:team`, `find-skills` discovers community skills. Tracked in `_dynamic.yaml`.
|
|
278
277
|
|
|
279
278
|
**Acceptance Criteria**:
|
|
280
279
|
|
|
@@ -470,7 +469,7 @@ Each feature specification includes:
|
|
|
470
469
|
|
|
471
470
|
**Technical Surface**:
|
|
472
471
|
- `commands/code.md` — Detection routing
|
|
473
|
-
- `commands/code/hard.md`, `commands/code/
|
|
472
|
+
- `commands/code/hard.md`, `commands/code/team.md` — Skip logic section
|
|
474
473
|
|
|
475
474
|
**Dependencies**: BF-005 (`/code` command)
|
|
476
475
|
|
|
@@ -129,11 +129,11 @@ All features on this chain must ship in order. Parallel branches (BF-005→BF-00
|
|
|
129
129
|
|
|
130
130
|
---
|
|
131
131
|
|
|
132
|
-
### v1.0.2 (2026-01-28) —
|
|
132
|
+
### v1.0.2 (2026-01-28) — Variant Expansion
|
|
133
133
|
|
|
134
134
|
| Feature | Description |
|
|
135
135
|
|---------|-------------|
|
|
136
|
-
| BF-006 |
|
|
136
|
+
| BF-006 | Team variant capability expanded for build and fix workflows |
|
|
137
137
|
|
|
138
138
|
---
|
|
139
139
|
|
|
@@ -217,7 +217,7 @@ gantt
|
|
|
217
217
|
BF-010 Cognitive Anchoring :done, 2026-01-26, 1d
|
|
218
218
|
|
|
219
219
|
section Must Have (enhanced)
|
|
220
|
-
BF-006
|
|
220
|
+
BF-006 Variant Refinement :done, 2026-01-28, 1d
|
|
221
221
|
BF-007 HSOL v2 Rewrite :done, 2026-02-03, 1d
|
|
222
222
|
BF-002 +Codex Platform :done, 2026-03-09, 1d
|
|
223
223
|
BF-006 +team Variant :done, 2026-03-09, 1d
|
|
@@ -75,7 +75,7 @@
|
|
|
75
75
|
|
|
76
76
|
| KPI | Baseline | Target | Measurement | Status |
|
|
77
77
|
|-----|----------|--------|-------------|--------|
|
|
78
|
-
| Variants per command | 1 (no variants) | Up to 4 (fast, hard,
|
|
78
|
+
| Variants per command | 1 (no variants) | Up to 4 (fast, hard, team) | Count variant files per command directory | ✅ VALIDATED |
|
|
79
79
|
| Agent scaling | Fixed | `:fast` 2–3, `:hard` 5–8, `:team` 3 per team | Verify agent count in variant file phase definitions | 📐 STRUCTURAL |
|
|
80
80
|
| Quality gate presence | None | `:hard` includes test + review + security gates | Parse `:hard` variant files for gate definitions | 📐 STRUCTURAL |
|
|
81
81
|
|
|
@@ -225,7 +225,7 @@
|
|
|
225
225
|
|
|
226
226
|
| KPI | Baseline | Target | Measurement | Status |
|
|
227
227
|
|-----|----------|--------|-------------|--------|
|
|
228
|
-
| Report variants | 0 |
|
|
228
|
+
| Report variants | 0 | 3 (fast, hard, team) | Count variant files | ✅ VALIDATED |
|
|
229
229
|
| Report accuracy | Manual reports | Grounded in project state | Compare report assertions to actual codebase state | ❌ UNVALIDATED |
|
|
230
230
|
|
|
231
231
|
---
|