feat(0.21.0): registry support for Tier-2 monorepo (skillPath) + Phase-3 strategy migration

CHANGELOG.md

@@ -1,5 +1,62 @@
 # Changelog
 
+## 0.21.0 — 2026-05-25
+
+### Schema additive bump — `skillPath` field for monorepo support
+
+`schemas/companion-skills.v1.json` gains an optional `skillPath` field on each skill entry. When a skill lives inside a monorepo (e.g. `broomva/skills`), `skillPath` is the relative path to its `SKILL.md` within that repo, e.g. `skills/<name>/SKILL.md`. Combined with `repo`, install becomes `npx skills add <repo> --skill <name>`. The field is **purely additive** — existing entries that omit it continue to work as standalone per-skill installs. Schema version remains 1 (no breaking change).
+
+### Strategy & decision-intelligence migration (Phase 3 of skills-packaging strategy)
+
+Per [`broomva/workspace docs/specs/2026-05-25-skills-packaging-strategy.html`](https://github.com/broomva/workspace/blob/main/docs/specs/2026-05-25-skills-packaging-strategy.html) §8 Phase 3, the 9 strategy sub-skills migrated from the bundled `broomva/strategy-skills` repo (where they lived under `.skills/<name>/SKILL.md`) into the `broomva/skills` Tier-2 monorepo at `skills/<name>/SKILL.md`. The registry entries previously pointed at per-skill `broomva/<name>` repos that never existed as standalones (stale-registry condition). This release fixes the install paths.
+
+Migrated entries (now using monorepo `skillPath`):
+
+- `pre-mortem` — 4-category failure-mode analysis + mitigation plan
+- `premortem` — Klein/Kahneman premortem with parallel sub-agent deep-dives (NEW — was missing from registry)
+- `braindump` — raw thoughts → Obsidian with auto-categorization
+- `morning-briefing` — daily brief from vault priorities + action items
+- `drift-check` — priority drift report (stated vs actual effort)
+- `strategy-critique` — red-team critique of strategy documents
+- `stakeholder-update` — multi-audience generator (technical / business / customer)
+- `decision-log` — structured decision capture → vault
+- `weekly-review` — weekly vault change scan + attention flags
+
+Install paths:
+```bash
+# New (per-skill from monorepo)
+npx skills add broomva/skills --skill pre-mortem
+npx skills add broomva/skills --skill braindump
+# ... etc
+
+# Backward-compat (bundled install via deprecated repo, 6mo window until 2026-11-25)
+npx skills add broomva/strategy-skills
+```
+
+Related: `broomva/skills` PR #3 (merge `af42d83`); `broomva/strategy-skills` redirect-stub PR #1.
+
+### Workflow & lifecycle skills registered
+
+The two Tier-2 prototypes that graduated in `broomva/skills` PR #2 (merge `f21515e`) — `handoff` and `make-spec` — are now in the registry. Both `min_bstack_version: 0.21.0` (need `skillPath` field added by this release).
+
+- `handoff` — fresh-session handoff doc drafting (workflow & lifecycle category)
+- `make-spec` — native-HTML design-doc scaffold per P18 Category-C (design category)
+
+### Files changed
+
+- `schemas/companion-skills.v1.json` — adds optional `skillPath` field with pattern validation
+- `references/companion-skills.yaml` — replaces 8 strategy entries with 9 monorepo entries; adds `handoff` + `make-spec`; total entries +3 net (was 32, now 35)
+- `VERSION` — `0.20.0` → `0.21.0`
+- `CHANGELOG.md` — this entry
+
+### Migration notes for downstream consumers
+
+- Workspaces with `companion-skills.yaml` `schema_version: 1` continue to validate — `skillPath` is additive.
+- The 8 old strategy entries pointed at `repo: broomva/<name>` repos that never existed; downstream `bstack doctor` runs that tried to resolve those installs would have errored. After this release, those installs resolve via the monorepo path.
+- `min_bstack_version: 0.21.0` is set on every new/changed entry to signal that the consumer's `bstack` must be `≥ 0.21.0` to recognize `skillPath`.
+
+---
+
 ## 0.20.0 — 2026-05-22
 
 ### Cross-review CLI — restore the P20 mechanism (BRO-1227 Fix B)

VERSION

@@ -1 +1 @@
-0.20.0
+0.21.0

references/companion-skills.yaml

@@ -190,61 +190,110 @@ skills:
     description: "SEO + LLM-optimized content"
 
   # ── Strategy + decision intelligence ────────────────────────────────────
+  # Migrated 2026-05-25 from per-skill broomva/<name> repos (which never
+  # existed as standalones) to the broomva/skills Tier-2 monorepo
+  # (broomva/skills PR #3 merged af42d83). The bundled install via
+  # broomva/strategy-skills remains available during a 6-month deprecation
+  # window (until 2026-11-25) for backward compat.
   - name: pre-mortem
-    repo: broomva/pre-mortem
+    repo: broomva/skills
+    skillPath: skills/pre-mortem/SKILL.md
     category: strategy
     required: false
     introduced_in: 0.1.0
-    description: "Pre-mortem risk analysis"
+    min_bstack_version: 0.21.0
+    description: "Pre-mortem failure-mode analysis (4-category scoring + mitigation plan)"
+
+  - name: premortem
+    repo: broomva/skills
+    skillPath: skills/premortem/SKILL.md
+    category: strategy
+    required: false
+    introduced_in: 0.21.0
+    min_bstack_version: 0.21.0
+    description: "Klein/Kahneman premortem with parallel sub-agent deep-dives + HTML report"
 
   - name: braindump
-    repo: broomva/braindump
+    repo: broomva/skills
+    skillPath: skills/braindump/SKILL.md
     category: strategy
     required: false
     introduced_in: 0.1.0
-    description: "Structured idea capture + triage"
+    min_bstack_version: 0.21.0
+    description: "Structured idea capture → Obsidian vault with auto-categorization"
 
   - name: morning-briefing
-    repo: broomva/morning-briefing
+    repo: broomva/skills
+    skillPath: skills/morning-briefing/SKILL.md
     category: strategy
     required: false
     introduced_in: 0.1.0
-    description: "Daily context briefing"
+    min_bstack_version: 0.21.0
+    description: "Daily focused brief from vault priorities + action items"
 
   - name: drift-check
-    repo: broomva/drift-check
+    repo: broomva/skills
+    skillPath: skills/drift-check/SKILL.md
     category: strategy
     required: false
     introduced_in: 0.1.0
-    description: "Detect drift from stated plan"
+    min_bstack_version: 0.21.0
+    description: "Priority drift report (stated priorities vs actual effort via git + vault)"
 
   - name: strategy-critique
-    repo: broomva/strategy-critique
+    repo: broomva/skills
+    skillPath: skills/strategy-critique/SKILL.md
     category: strategy
     required: false
     introduced_in: 0.1.0
-    description: "Strategic decision critique"
+    min_bstack_version: 0.21.0
+    description: "Red-team critique of strategy documents with gaps + missing assumptions"
 
   - name: stakeholder-update
-    repo: broomva/stakeholder-update
+    repo: broomva/skills
+    skillPath: skills/stakeholder-update/SKILL.md
     category: strategy
     required: false
     introduced_in: 0.1.0
-    description: "Stakeholder communication drafting"
+    min_bstack_version: 0.21.0
+    description: "Multi-audience communication generator (technical / business / customer)"
 
   - name: decision-log
-    repo: broomva/decision-log
+    repo: broomva/skills
+    skillPath: skills/decision-log/SKILL.md
     category: strategy
     required: false
     introduced_in: 0.1.0
-    description: "Structured decision log + ADR"
+    min_bstack_version: 0.21.0
+    description: "Structured decision capture with context, alternatives, rationale → vault"
 
   - name: weekly-review
-    repo: broomva/weekly-review
+    repo: broomva/skills
+    skillPath: skills/weekly-review/SKILL.md
     category: strategy
     required: false
     introduced_in: 0.1.0
-    description: "Weekly retrospective + planning"
+    min_bstack_version: 0.21.0
+    description: "Weekly vault change scan + attention flags"
+
+  # ── Workflow & lifecycle (Tier-2 monorepo) ──────────────────────────────
+  - name: handoff
+    repo: broomva/skills
+    skillPath: skills/handoff/SKILL.md
+    category: lifecycle
+    required: false
+    introduced_in: 0.21.0
+    min_bstack_version: 0.21.0
+    description: "Fresh-session handoff doc drafting — compress an arc into a resumable doc for the next agent context"
+
+  - name: make-spec
+    repo: broomva/skills
+    skillPath: skills/make-spec/SKILL.md
+    category: design
+    required: false
+    introduced_in: 0.21.0
+    min_bstack_version: 0.21.0
+    description: "Native-HTML design-doc scaffold (spec / plan / ADR / report / pr-explainer) using the canonical Broomva dark theme — implements P18 Category-C"
 
   # ── Platform + finance ──────────────────────────────────────────────────
   - name: finance-substrate

references/skills-roster.md

@@ -54,13 +54,25 @@
 
 ## Strategy & Decision Intelligence
 
+> Migrated 2026-05-25 to `broomva/skills` Tier-2 monorepo (was bundled in `broomva/strategy-skills`; bundle remains backward-compatible for 6-month deprecation window until 2026-11-25). 9 individual skills now installable separately.
+
+| # | Skill | Install | Description |
+|---|-------|---------|-------------|
+| 21 | `pre-mortem` | `npx skills add broomva/skills --skill pre-mortem` | 4-category failure-mode analysis (likelihood × impact) with mitigation plan. |
+| 22 | `premortem` | `npx skills add broomva/skills --skill premortem` | Klein/Kahneman premortem with parallel sub-agent deep-dives + HTML report. |
+| 23 | `braindump` | `npx skills add broomva/skills --skill braindump` | Raw thoughts → Obsidian vault with auto-categorization, tags, and backlinks. |
+| 24 | `morning-briefing` | `npx skills add broomva/skills --skill morning-briefing` | Daily focused brief from vault priorities + action items + updates. |
+| 25 | `drift-check` | `npx skills add broomva/skills --skill drift-check` | Priority drift report — stated priorities vs actual effort (git log + vault). |
+| 26 | `strategy-critique` | `npx skills add broomva/skills --skill strategy-critique` | Red-team critique of strategy documents with gaps, risks, missing assumptions. |
+| 27 | `stakeholder-update` | `npx skills add broomva/skills --skill stakeholder-update` | One fact set → 3 audience versions (technical / business / customer). |
+| 28 | `decision-log` | `npx skills add broomva/skills --skill decision-log` | Structured decision capture with context, alternatives, rationale → vault. |
+| 29 | `weekly-review` | `npx skills add broomva/skills --skill weekly-review` | Weekly vault change scan + attention flags. |
+
+## Workflow & Lifecycle (Tier-2 monorepo)
+
+> Graduated from workspace-local prototypes 2026-05-25 (`broomva/skills` PR #2).
+
 | # | Skill | Install | Description |
 |---|-------|---------|-------------|
-| 21 | `pre-mortem` | `npx skills add broomva/strategy-skills` | Assumes project failure, works backward to identify top causes, scores by likelihood × impact, outputs mitigation plan. |
-| 22 | `braindump` | `npx skills add broomva/strategy-skills` | Takes raw unstructured thoughts or transcripts, auto-files into vault folders with tags and backlinks. |
-| 23 | `morning-briefing` | `npx skills add broomva/strategy-skills` | Reads action items, priorities, and vault updates → produces a focused daily brief. |
-| 24 | `drift-check` | `npx skills add broomva/strategy-skills` | Compares stated priorities vs actual effort (git log + vault) → strategy drift report. |
-| 25 | `strategy-critique` | `npx skills add broomva/strategy-skills` | Red-team critique of a strategy doc with gaps, risks, and missing assumptions. |
-| 26 | `stakeholder-update` | `npx skills add broomva/strategy-skills` | Takes one set of facts → generates 3 versions: technical, business, customer-facing. |
-| 27 | `decision-log` | `npx skills add broomva/strategy-skills` | Captures decisions with context, alternatives, rationale → links to project doc in vault. |
-| 28 | `weekly-review` | `npx skills add broomva/strategy-skills` | Scans vault for weekly changes, surfaces what changed, flags what needs attention. |
+| 30 | `handoff` | `npx skills add broomva/skills --skill handoff` | Fresh-session handoff doc drafting — compress an arc into a resumable doc for the next agent context. |
+| 31 | `make-spec` | `npx skills add broomva/skills --skill make-spec` | Native-HTML design-doc scaffold (spec / plan / ADR / report / pr-explainer) using the canonical Broomva dark theme — implements P18 Category-C. |

schemas/companion-skills.v1.json

@@ -27,6 +27,11 @@
             "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$",
             "description": "GitHub-style repo handle (e.g. broomva/p9) used by `npx skills add`."
           },
+          "skillPath": {
+            "type": "string",
+            "pattern": "^skills/[a-z0-9][a-z0-9-]*/SKILL\\.md$",
+            "description": "Optional: when this skill lives inside a monorepo (e.g. broomva/skills), the relative path to the SKILL.md within that repo. Combined with `repo`, the install command becomes `npx skills add <repo> --skill <name>`. Omit for standalone per-skill repos."
+          },
           "category": {
             "enum": ["lifecycle", "knowledge", "orchestration", "safety", "meta", "design", "platform", "strategy", "content", "observability"]
           },