diff --git a/CHANGELOG.md b/CHANGELOG.md index 2ce8c49..3640664 100644 --- a/CHANGELOG.md +++ b/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//SKILL.md`. Combined with `repo`, install becomes `npx skills add --skill `. 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//SKILL.md`) into the `broomva/skills` Tier-2 monorepo at `skills//SKILL.md`. The registry entries previously pointed at per-skill `broomva/` 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/` 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) diff --git a/VERSION b/VERSION index 5a03fb7..8854156 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.20.0 +0.21.0 diff --git a/references/companion-skills.yaml b/references/companion-skills.yaml index d3b2908..0210b5d 100644 --- a/references/companion-skills.yaml +++ b/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/ 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 diff --git a/references/skills-roster.md b/references/skills-roster.md index 3730a28..296e534 100644 --- a/references/skills-roster.md +++ b/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. | diff --git a/schemas/companion-skills.v1.json b/schemas/companion-skills.v1.json index 83f5449..aa44d73 100644 --- a/schemas/companion-skills.v1.json +++ b/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 --skill `. Omit for standalone per-skill repos." + }, "category": { "enum": ["lifecycle", "knowledge", "orchestration", "safety", "meta", "design", "platform", "strategy", "content", "observability"] },