@namch/agent-assistant 1.3.0 → 1.3.2

package/commands/docs.md

@@ -1,13 +1,13 @@
 ---
-description: 📝 Docs — Full Documentation Suite (executes ALL sub-commands sequentially)
-version: "1.0"
+description: "📝 Docs - Full Documentation Suite (executes ALL sub-commands sequentially)"
+version: "2.0"
 category: documentation
 execution-mode: execute
 ---
 
 # /docs — Full Documentation Suite
 
-> **MISSION**: Execute ALL documentation sub-commands **SEQUENTIALLY**. Only report "Done" when ALL 13 files are created.
+> **MISSION**: Execute ALL documentation sub-commands **SEQUENTIALLY**. Only report "Done" when ALL deliverables are created: 5 knowledge folders (26+ files) + 4 business folders (22+ files) + 4 audit folders (20+ files).
 
 <scope>$ARGUMENTS</scope>
 
@@ -31,9 +31,9 @@ execution-mode: execute
 >
 > 1. You MUST execute each sub-command **IN ORDER**
 > 2. You MUST wait for each sub-command to **COMPLETE** before starting next
-> 3. You MUST create **ALL 13 FILES** across 3 sub-commands
+> 3. You MUST create ALL deliverables across 3 sub-commands
 > 4. You may **NOT** skip any sub-command
-> 5. Report "Done" **ONLY** when all 13 files exist
+> 5. Report "Done" **ONLY** when all deliverables exist
 
 ---
 
@@ -42,16 +42,17 @@ execution-mode: execute
 ```
 ┌─────────────────────────────────────────────────────────────────┐
 │ STEP 1: Load & Execute /docs:core                               │
-│   → Wait until ALL 5 core files are created                     │
-│   → Verify: knowledge-overview, architecture, domain,       │
-│   →         source-base, standards                            │
+│   → Wait until ALL 5 knowledge folders are created              │
+│   → Each folder: 00-index.md + numbered sub-files               │
+│   → Verify: knowledge-overview/, architecture/, domain/,        │
+│   →         source-base/, standards/                            │
 ├─────────────────────────────────────────────────────────────────┤
 │ STEP 2: Load & Execute /docs:business                           │
-│   → Wait until ALL 4 business files are created                 │
-│   → Verify: business-prd, features, workflows, glossary         │
+│   → Wait until ALL 4 business folders are created               │
+│   → Verify: business-prd/, features/, workflows/, glossary/     │
 ├─────────────────────────────────────────────────────────────────┤
 │ STEP 3: Load & Execute /docs:audit                              │
-│   → Wait until ALL 4 audit files are created                    │
+│   → Wait until ALL 4 audit folders are created                   │
 │   → Verify: audit-security, compliance, dataflow,               │
 │             recommendations                                     │
 └─────────────────────────────────────────────────────────────────┘
@@ -66,15 +67,15 @@ execution-mode: execute
 | **Sub-Command** | `~/.{TOOL}/agent-assistant/commands/docs/core.md` |
 | **Action**      | **LOAD AND FOLLOW** the entire core.md workflow   |
 
-### Files to be Created:
+### Folders to be Created (v3.0 — folder-based):
 
-- [ ] `./documents/knowledge-overview.md`
-- [ ] `./documents/knowledge-architecture.md`
-- [ ] `./documents/knowledge-domain.md`
-- [ ] `./documents/knowledge-source-base.md`
-- [ ] `./documents/knowledge-standards.md`
+- [ ] `./documents/knowledge-overview/` (00-index.md + 4 sub-files)
+- [ ] `./documents/knowledge-architecture/` (00-index.md + 5 sub-files)
+- [ ] `./documents/knowledge-domain/` (00-index.md + 4 sub-files)
+- [ ] `./documents/knowledge-source-base/` (00-index.md + 4 sub-files)
+- [ ] `./documents/knowledge-standards/` (00-index.md + 4 sub-files)
 
-**⏸️ PAUSE HERE** — Do NOT proceed to Step 2 until all 5 core files exist.
+**⏸️ PAUSE HERE** — Do NOT proceed to Step 2 until all 5 knowledge folders with sub-files exist.
 
 ---
 
@@ -85,14 +86,14 @@ execution-mode: execute
 | **Sub-Command** | `~/.{TOOL}/agent-assistant/commands/docs/business.md` |
 | **Action**      | **LOAD AND FOLLOW** the entire business.md workflow   |
 
-### Files to be Created:
+### Folders to be Created (v4.0 — folder-based):
 
-- [ ] `./documents/business/business-prd.md`
-- [ ] `./documents/business/business-features.md`
-- [ ] `./documents/business/business-workflows.md`
-- [ ] `./documents/business/business-glossary.md`
+- [ ] `./documents/business/business-prd/` (00-index.md + 4 sub-files)
+- [ ] `./documents/business/business-features/` (00-index.md + 5 sub-files)
+- [ ] `./documents/business/business-workflows/` (00-index.md + 5 sub-files)
+- [ ] `./documents/business/business-glossary/` (00-index.md + 4 sub-files)
 
-**⏸️ PAUSE HERE** — Do NOT proceed to Step 3 until all 4 business files exist.
+**⏸️ PAUSE HERE** — Do NOT proceed to Step 3 until all 4 business folders with sub-files exist.
 
 ---
 
@@ -103,57 +104,57 @@ execution-mode: execute
 | **Sub-Command** | `~/.{TOOL}/agent-assistant/commands/docs/audit.md` |
 | **Action**      | **LOAD AND FOLLOW** the entire audit.md workflow   |
 
-### Files to be Created:
+### Folders to be Created (v4.0 - folder-based):
 
-- [ ] `./documents/audit/audit-security.md`
-- [ ] `./documents/audit/audit-compliance.md`
-- [ ] `./documents/audit/audit-dataflow.md`
-- [ ] `./documents/audit/audit-recommendations.md`
+- [ ] `./documents/audit/audit-security/` (00-index.md + 4 sub-files)
+- [ ] `./documents/audit/audit-compliance/` (00-index.md + 4 sub-files)
+- [ ] `./documents/audit/audit-dataflow/` (00-index.md + 4 sub-files)
+- [ ] `./documents/audit/audit-recommendations/` (00-index.md + 4 sub-files)
 
 ---
 
 ## ✅ FINAL VERIFICATION (REQUIRED)
 
-Before reporting "Done", verify **ALL 13 FILES** exist:
+Before reporting "Done", verify ALL deliverables exist:
 
 ```
 ./documents/
-├── Core (5 files)
-│   ├── ✅ knowledge-overview.md
-│   ├── ✅ knowledge-architecture.md
-│   ├── ✅ knowledge-domain.md
-│   ├── ✅ knowledge-source-base.md
-│   └── ✅ knowledge-standards.md
-├── Business (folder)
-│   ├── ✅ business-prd.md
-│   ├── ✅ business-features.md
-│   ├── ✅ business-workflows.md
-│   └── ✅ business-glossary.md
-└── Audit (4 files)
-    ├── ✅ audit-security.md
-    ├── ✅ audit-compliance.md
-    ├── ✅ audit-dataflow.md
-    └── ✅ audit-recommendations.md
+├── Core (5 folders, 26+ files)
+│   ├── ✅ knowledge-overview/        (00-index + 01~04)
+│   ├── ✅ knowledge-architecture/    (00-index + 01~05)
+│   ├── ✅ knowledge-domain/          (00-index + 01~04)
+│   ├── ✅ knowledge-source-base/     (00-index + 01~04)
+│   └── ✅ knowledge-standards/       (00-index + 01~04)
+├── Business (4 folders, 22+ files)
+│   ├── ✅ business-prd/          (00-index + 01~04)
+│   ├── ✅ business-features/     (00-index + 01~05)
+│   ├── ✅ business-workflows/    (00-index + 01~05)
+│   └── ✅ business-glossary/     (00-index + 01~04)
+└── Audit (4 folders, 20+ files)
+    ├── ✅ audit-security/         (00-index + 01~04)
+    ├── ✅ audit-compliance/       (00-index + 01~04)
+    ├── ✅ audit-dataflow/         (00-index + 01~04)
+    └── ✅ audit-recommendations/  (00-index + 01~04)
 ```
 
 ---
 
 ## 📊 COMPLETION OUTPUT
 
-Only output this when ALL 13 files are verified:
+Only output this when ALL deliverables are verified:
 
 ```markdown
 ## ✅ Full Documentation Suite Complete
 
-### 📁 All 13 Documents Created
+### 📁 All Documents Created
 
-| Type     | Files Created                                        | Status |
-| -------- | ---------------------------------------------------- | ------ |
-| Core     | overview, architecture, domain, source-base, standards | ✅ 5/5 |
-| Business | prd, features, workflows, glossary                   | ✅ 4/4 |
-| Audit    | security, compliance, dataflow, recommendations      | ✅ 4/4 |
+| Type     | Deliverables                                                | Status   |
+| -------- | ----------------------------------------------------------- | -------- |
+| Core     | 5 knowledge folders (overview, architecture, domain, source-base, standards) | ✅ 5/5 folders |
+| Business | 4 business folders (prd, features, workflows, glossary)     | ✅ 4/4 folders |
+| Audit    | 4 audit folders (security, compliance, dataflow, recommendations) | ✅ 4/4 folders |
 
-**Total: 13/13 files created in `./documents/`**
+**Total: 13 folders (68+ files) created in `./documents/`**
 ```
 
 ---
@@ -161,9 +162,9 @@ Only output this when ALL 13 files are verified:
 ## 🚫 FORBIDDEN
 
 - ❌ Skipping any sub-command
-- ❌ Creating partial files and reporting "Done"
+- ❌ Creating partial deliverables and reporting "Done"
 - ❌ Executing sub-commands in parallel (must be sequential)
-- ❌ Reporting "Done" before all 12 files exist
+- ❌ Reporting "Done" before all deliverables exist
 
 ---
 
@@ -171,8 +172,8 @@ Only output this when ALL 13 files are verified:
 
 If you need only ONE type:
 
-| Route            | Files Created        |
-| ---------------- | -------------------- |
-| `/docs:core`     | 5 knowledge-\* files |
-| `/docs:business` | 4 business-\* files  |
-| `/docs:audit`    | 4 audit-\* files     |
+| Route            | Deliverables Created                           |
+| ---------------- | ---------------------------------------------- |
+| `/docs:core`     | 5 knowledge folders with 00-index + sub-files  |
+| `/docs:business` | 4 business folders with 00-index + sub-files  |
+| `/docs:audit`    | 4 audit folders with 00-index + sub-files      |

package/commands/fix/hard.md

@@ -22,7 +22,7 @@ execution-mode: execute
 
 **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
 
-**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
+**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
 
 ---
 

package/commands/fix.md

@@ -34,9 +34,6 @@ IF issue is simple (clear cause, quick fix):
 IF issue is complex (research needed, multi-file):
   → Route to /fix:hard
 
-IF issue is complex AND context optimization is critical:
-  → Route to /fix:focus
-
 IF issue is complex AND maximum quality with team collaboration needed:
   → Route to /fix:team
 
@@ -52,7 +49,6 @@ IF unsure:
 | ------------ | ----------------------------------------------------- |
 | `/fix:fast`  | Quick fixes, clear issues                             |
 | `/fix:hard`  | Complex issues, research needed                       |
-| `/fix:focus` | Complex issues with **enforced context optimization** |
 | `/fix:team`  | Maximum quality with parallel agent team collaboration |
 
 ---
@@ -68,8 +64,7 @@ IF unsure:
 
 1. ⚡ **Fast** → `/fix:fast` — Quick fix
 2. ⚡⚡⚡ **Hard** → `/fix:hard` — Full resolution
-3. 🎯 **Focus** → `/fix:focus` — Full resolution with **automatic context clearing** (prevents hallucination)
-4. 👥 **Team** → `/fix:team` — Full team collaboration (parallel agents, maximum quality)
+3. 👥 **Team** → `/fix:team` — Full team collaboration (parallel agents, maximum quality)
 
 ⏳ Awaiting selection...
 ```

package/commands/plan/hard.md

@@ -23,7 +23,7 @@ execution-mode: execute
 
 **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
 
-**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
+**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
 
 ---
 

package/commands/plan.md

@@ -34,9 +34,6 @@ IF task is clear (known approach, codebase-only):
 IF task is complex (research needed, architectural):
   → Route to /plan:hard
 
-IF task is complex AND clean implementation handoff is critical:
-  → Route to /plan:focus
-
 IF task is complex AND maximum quality with team collaboration needed:
   → Route to /plan:team
 
@@ -52,7 +49,6 @@ IF unsure:
 | ------------- | ---------------------------------------------------- |
 | `/plan:fast`  | Quick planning without research                      |
 | `/plan:hard`  | Full planning with research                          |
-| `/plan:focus` | Full planning with **enforced context optimization** |
 | `/plan:team`  | Maximum quality with parallel agent team collaboration |
 
 ---
@@ -68,8 +64,7 @@ IF unsure:
 
 1. ⚡ **Fast** → `/plan:fast` — Quick plan
 2. ⚡⚡⚡ **Hard** → `/plan:hard` — Full research-backed plan
-3. 🎯 **Focus** → `/plan:focus` — Full plan with **automatic context clearing** (clean implementation handoff)
-4. 👥 **Team** → `/plan:team` — Full team collaboration (parallel agents, maximum quality)
+3. 👥 **Team** → `/plan:team` — Full team collaboration (parallel agents, maximum quality)
 
 ⏳ Awaiting selection...
 ```

package/commands/report/fast.md

@@ -10,7 +10,7 @@ execution-mode: execute
 > **MISSION**: Generate concise, actionable status reports and summaries.
 >
 > Use for daily standups, progress checks, and high-level overviews.
-> For **update existing files** or **generate from template**, use `/report:hard` or `/report:focus`.
+> For **update existing files** or **generate from template**, use `/report:hard` or `/report:team`.
 
 <task>$ARGUMENTS</task>
 
@@ -61,7 +61,7 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
 | Agent | `reporter`                                                                 |
 | ----- | -------------------------------------------------------------------------- |
 | Goal  | Infer intent; if **create report** → generate concise status report        |
-| Exit  | Report with Summary, Key Changes, Next Steps — or recommend `/report:hard`/`/report:focus` if user intent is update/template |
+| Exit  | Report with Summary, Key Changes, Next Steps — or recommend `/report:hard`/`/report:team` if user intent is update/template |
 
 ---
 

package/commands/report/hard.md

@@ -25,7 +25,7 @@ execution-mode: execute
 
 **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
 
-**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
+**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
 
 ---
 

package/commands/report.md

@@ -50,11 +50,8 @@ IF task is simple status update OR summary:
 IF task is comprehensive analysis OR deep dive OR any non-trivial topic (infer from request):
   → Route to /report:hard
 
-IF task requires absolute context clarity OR "clean slate" analysis:
-  → Route to /report:focus
-
 IF user explicitly asks to UPDATE existing files (not create report):
-  → Still use /report:hard or /report:focus; reporter OUTPUT MODE = update existing files
+  → Use /report:hard or /report:team; reporter OUTPUT MODE = update existing files
 
 IF task is complex AND maximum quality with team collaboration needed:
   → Route to /report:team
@@ -71,7 +68,6 @@ IF unsure:
 | --------------- | --------------------------------------------------------------------------- |
 | `/report:fast`  | Quick status updates, daily summaries                                       |
 | `/report:hard`  | Detailed analysis, any topic (algorithms, docs, changes), template-based  |
-| `/report:focus` | Deep analysis with **enforced context optimization**; update or create      |
 | `/report:team`  | Maximum quality with parallel agent team collaboration |
 
 ---
@@ -87,8 +83,7 @@ IF unsure:
 
 1. ⚡ **Fast** → `/report:fast` — Quick summary
 2. ⚡⚡⚡ **Hard** → `/report:hard` — Full analysis, any topic; create report **or** update existing files / use template
-3. 🎯 **Focus** → `/report:focus` — Deep analysis with **automatic context clearing**; create or update per task
-4. 👥 **Team** → `/report:team` — Full team collaboration (parallel agents, maximum quality)
+3. 👥 **Team** → `/report:team` — Full team collaboration (parallel agents, maximum quality)
 
 ⏳ Awaiting selection...
 ```

package/commands/review/hard.md

@@ -22,7 +22,7 @@ execution-mode: execute
 
 **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
 
-**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
+**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
 
 ---
 

package/commands/test/hard.md

@@ -23,7 +23,7 @@ execution-mode: execute
 
 **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
 
-**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
+**Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
 
 ---
 

package/commands/test.md

@@ -33,9 +33,6 @@ IF scope is limited (unit tests, quick check):
 IF scope is comprehensive (full suite, E2E):
   → Route to /test:hard
 
-IF scope is comprehensive AND clean execution focus is critical:
-  → Route to /test:focus
-
 IF scope is comprehensive AND maximum quality with team collaboration needed:
   → Route to /test:team
 
@@ -51,7 +48,6 @@ IF unsure:
 | -------------- | -------------------------------------------------- |
 | `/test:fast`   | Quick tests, unit tests                            |
 | `/test:hard`   | Full test suite, E2E                               |
-| `/test:focus` | Full testing with **enforced context optimization** |
 | `/test:team`  | Maximum quality with parallel agent team collaboration |
 
 ---
@@ -67,8 +63,7 @@ IF unsure:
 
 1. ⚡ **Fast** → `/test:fast` — Quick tests
 2. ⚡⚡⚡ **Hard** → `/test:hard` — Comprehensive testing
-3. 🔒 **Focus** → `/test:focus` — Comprehensive testing with **automatic context clearing** (focused execution)
-4. 👥 **Team** → `/test:team` — Full team collaboration (parallel agents, maximum quality)
+3. 👥 **Team** → `/test:team` — Full team collaboration (parallel agents, maximum quality)
 
 ⏳ Awaiting selection...
 ```

package/documents/HSOL-ASSESSMENT.md

@@ -11,7 +11,7 @@
 | Dimension | Rating | Notes |
 |-----------|--------|--------|
 | **Completeness** | Strong | Resolution algorithm, decision gate, blocking/async, variant/fitness, trust, conflict, edge cases are defined. |
-| **Consistency** | Strong | Thresholds (0.75, 0.8), variant (fast/hard/focus), and flow align across Discovery, Orchestration, _index.yaml, Blueprint. |
+| **Consistency** | Strong | Thresholds (0.75, 0.8), variant (fast/hard/team), and flow align across Discovery, Orchestration, _index.yaml, Blueprint. |
 | **Production readiness** | Good | Clear rules for tool scope, install commands, fallbacks; a few operational gaps (see below). |
 | **Agent intelligence** | Strong | Matrix-first + dynamic enhancement, blocking when matrix insufficient so current task uses new skill; async when matrix adequate. |
 
@@ -28,9 +28,9 @@
 
 2. **Variant + fitness logic**
    - Fast → no discovery (keeps fast path low-latency).
-   - Hard/Focus + fitness ≥ 0.8 → skip discovery.
-   - Hard/Focus + 0.75 ≤ fitness < 0.8 → async (recommend for next time).
-   - Hard/Focus + fitness < 0.75 → blocking (current task uses new skill). Aligns with “skill for current work” goal.
+   - Hard/Team + fitness ≥ 0.8 → skip discovery.
+   - Hard/Team + 0.75 ≤ fitness < 0.8 → async (recommend for next time).
+   - Hard/Team + fitness < 0.75 → blocking (current task uses new skill). Aligns with “skill for current work” goal.
 
 3. **Tool-scoped behavior**
    - 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 @@
 
 ### 5. Default variant (optional)
 
-**Issue**: When user says `/cook` without `:fast` or `:hard`, the router picks a default. Discovery runs only for hard/focus. If the default is “hard”, discovery applies; if “fast”, it does not. Not ambiguous but could be explicit.
+**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.
 
 **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.
 
@@ -96,7 +96,7 @@
 - **Install flow**: Commands, scope (current tool), and confirm rules are clear.
 - **Fallbacks**: Timeout, no skills, install failure are handled.
 - **Config**: _index.yaml has discovery on/off, thresholds, variants, promotion; per-agent overrides exist.
-- **Cross-doc alignment**: Thresholds (0.75, 0.8), variant list (hard, focus), and flow (blocking vs async) match across docs and config.
+- **Cross-doc alignment**: Thresholds (0.75, 0.8), variant list (hard, team), and flow (blocking vs async) match across docs and config.
 
 ---
 

package/documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md

@@ -263,7 +263,7 @@ ROOT CAUSE: No automated feedback loop between:
 > **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.
 
 **Principle 2b: Conditional Discovery (Variant + Fitness)**
-> Dynamic discovery (find-skills, steps 8–10) runs **only** when: (1) command variant is **`hard`** or **`focus`** — **`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/focus + matrix sufficient → same; hard/focus + matrix < 0.8 → full flow including discovery.
+> 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.
 
 **Principle 3: Graduated Trust**
 > Newly discovered skills start in "evaluation mode" with limited scope. Trust increases with successful executions.

package/documents/business/business-features/00-index.md

@@ -0,0 +1,101 @@
+# Agent Assistant — Business Features (MoSCoW)
+
+> **Purpose**: Features summary, table of contents, key facts, cross-references, and known gaps for @namch/agent-assistant v1.3.0
+> **Last Updated**: 2026-03-26
+> **Generated By**: docs-business skill
+
+---
+
+## Quick Summary
+
+This document set catalogs the **23 business features** of @namch/agent-assistant v1.3.0, classified using the MoSCoW prioritization framework. Features span the full product surface — from one-time global installation (BF-001) through autonomous execution (BF-020) — and map directly to 10 business goals (BG-001 through BG-010).
+
+The MoSCoW breakdown is: **10 Must Have** (core orchestration, agents, commands, skills), **8 Should Have** (teams, error healing, dynamic discovery, debate), **5 Could Have** (deployment workflows, autonomous mode, reporting, plan short-circuit, CLI list). All 10 Must Have features shipped in v1.0.0. Should Have features landed across v1.0.3–v1.2.0. Could Have features are partially delivered (BF-019 in v1.2.0, BF-020–BF-022 in v1.0.4, BF-023 pending).
+
+---
+
+## Sub-Files
+
+| # | File | Description |
+|---|------|-------------|
+| 1 | [01-feature-inventory.md](./01-feature-inventory.md) | Complete inventory of all 23 features (BF-001–BF-023) with descriptions and business value |
+| 2 | [02-prioritization-moscow.md](./02-prioritization-moscow.md) | MoSCoW classification with rationale and dependency analysis |
+| 3 | [03-feature-specifications.md](./03-feature-specifications.md) | Per-feature specifications: acceptance criteria (Given/When/Then), technical surface, dependencies |
+| 4 | [04-dependencies-and-release-sequencing.md](./04-dependencies-and-release-sequencing.md) | Dependency graph (Mermaid), release history mapping, recommended rollout order |
+| 5 | [05-success-metrics.md](./05-success-metrics.md) | KPIs per feature, baselines, targets, measurement approach |
+
+---
+
+## Key Facts
+
+| Key | Value |
+|-----|-------|
+| Total Features | 23 (BF-001 through BF-023) |
+| Must Have | 10 |
+| Should Have | 8 |
+| Could Have | 5 |
+| Won't Have | 0 (this release) |
+| Features Delivered | 22 of 23 |
+| Features Pending | 1 (BF-023: CLI List Command) |
+| Business Goals Covered | 10 of 10 (BG-001–BG-010) |
+| First Feature Release | v1.0.0 (2026-01-26) |
+| Latest Feature Release | v1.3.0 (2026-03-23) |
+| Releases with Features | 6 (v1.0.0, v1.0.3, v1.0.4, v1.1.0, v1.2.0, v1.3.0) |
+
+---
+
+## Cross-References
+
+### Knowledge Folders (docs-core)
+
+| Folder | Relationship to Features |
+|--------|--------------------------|
+| [../knowledge-overview/](../knowledge-overview/) | Feature descriptions, capability counts, performance metrics — factual basis for BF inventory |
+| [../knowledge-architecture/](../knowledge-architecture/) | System components, data flow, design patterns — informs technical surface per feature |
+| [../knowledge-domain/](../knowledge-domain/) | Entities, business rules — domain context for feature specifications |
+| [../knowledge-source-base/](../knowledge-source-base/) | Directory structure, key modules — evidence for file mappings in specifications |
+| [../knowledge-standards/](../knowledge-standards/) | Code style, conventions — informs quality-related features (BF-012, BF-014) |
+
+### Business Folders (docs-business)
+
+| Folder | Relationship to Features |
+|--------|--------------------------|
+| [../business-prd/](../business-prd/) | PRD goals (BG-001–BG-010) and requirements (BR-001–BR-023) that features implement |
+| business-features/ (this folder) | MoSCoW feature classification, specifications, dependencies, metrics |
+| business-user-stories/ | User stories derived from these features |
+| business-use-cases/ | Use case specifications exercising these features |
+| business-glossary/ | Canonical terminology for feature descriptions |
+
+### Source Documents
+
+| Document | Relationship |
+|----------|-------------|
+| [../../reports/business-analysis/structured-business-pack.md](../../reports/business-analysis/structured-business-pack.md) | Primary source — features section with MoSCoW table and goal mappings |
+| [../../CHANGELOG.md](../../CHANGELOG.md) | Release history — maps features to versions |
+| [../../README.md](../../README.md) | Public feature descriptions and metrics |
+| [../HSOL-ASSESSMENT.md](../HSOL-ASSESSMENT.md) | HSOL readiness — informs BF-007, BF-013, BF-014 metrics |
+
+---
+
+## Known Gaps
+
+| Gap ID | Description | Impact | Mitigation |
+|--------|-------------|--------|------------|
+| GAP-F01 | Performance metrics (70% faster, 70% bug reduction, 85% token savings) are self-reported and unvalidated by independent testing | Success metrics for BF-003, BF-007, BF-008 rely on unverified baselines | Flag as "UNVALIDATED" in metrics; plan benchmark suite |
+| GAP-F02 | BF-023 (CLI List Command) not yet implemented | Feature inventory shows 22/23 delivered | Low priority — Could Have classification; no business goal blocked |
+| GAP-F03 | Dynamic skill discovery (BF-013) depends on external network and community skill registry that does not yet have a published API | BF-014 (Trust Progression) also blocked without functional discovery | Design offline fallback; define registry API contract |
+| GAP-F04 | No formal A/B testing or telemetry to measure feature adoption rates | Cannot validate success metrics for adoption-related KPIs | Define measurement plan before v2.0 |
+| GAP-F05 | Debate mechanism (BF-016) max rounds and convergence rates not benchmarked | Cannot confirm 3-round max is sufficient for all domains | Collect empirical data from `:team` variant usage |
+
+---
+
+## Evidence Sources
+
+| Source | Path |
+|--------|------|
+| Structured Business Pack (features, goals, MoSCoW) | [../../reports/business-analysis/structured-business-pack.md](../../reports/business-analysis/structured-business-pack.md) |
+| CHANGELOG (release history) | [../../CHANGELOG.md](../../CHANGELOG.md) |
+| README (feature descriptions) | [../../README.md](../../README.md) |
+| Knowledge overview — features | [../knowledge-overview/03-features.md](../knowledge-overview/03-features.md) |
+| PRD — goals and scope | [../business-prd/02-problem-goals-and-scope.md](../business-prd/02-problem-goals-and-scope.md) |
+| PRD — requirements | [../business-prd/03-stakeholders-and-requirements.md](../business-prd/03-stakeholders-and-requirements.md) |