Release: v2.16.0 — Teaching Ecosystem + Branch Protection

.STATUS

@@ -1,32 +1,29 @@
 status: Active
-version: 2.15.0
-release_date: 2026-02-06
-milestone: v2.15.0 - Brainstorm v2.5.0 (Spec Simplification + Smart Questions)
-last_session: 2026-02-06
+version: 2.16.0
+release_date: 2026-02-07
+milestone: v2.16.0 - Teaching Ecosystem + Branch Protection
+last_session: 2026-02-07
 
-progress: 95% (PR #56 open, docs synced, awaiting merge + release tag)
+progress: v2.16.0 release preparation — version bumped, pre-release checks passing
 
 📊 Branch Status:
 
-| Branch | Head    | Base | Status                          |
-|--------|---------|------|---------------------------------|
-| main   | 4d20c14 | —    | Production (v2.14.0 + docs sync)|
-| dev    | pending | main | v2.15.0 implementation          |
+| Branch | Head    | Base | Status                        |
+|--------|---------|------|-------------------------------|
+| main   | bbd6ac7 | —    | Production (v2.15.0 released) |
+| dev    | pending | main | v2.16.0 ready for release PR  |
 
-✅ Just Completed (2026-02-06 session):
+✅ v2.15.0 — Brainstorm v2.5.0: Spec Simplification + Smart Questions (2026-02-06):
 - Brainstorm spec simplification: 1,919 → 312 lines (84% reduction)
 - Extracted to 4 reference docs (question bank, tutorial, refcard, version history)
 - New: utils/brainstorm_context.py — context-aware smart questions
 - 38 new tests (all passing) + 53+24 existing brainstorm tests verified
 - Project-type question extensions: 6 types, 12 new questions
 - Dynamic questions: matching spec, prior brainstorm, failing tests detection
 - Docs health check: synced 7 stale version refs, added 3 nav entries
-- PR #56 created and pushed to dev
-
-✅ Previous session (2026-02-06):
-- Synced version refs across README, REFCARD, CLAUDE.md (v2.12.0 → v2.14.0)
-- Updated 7 docs site pages (test counts 1171/1174 → 1248, docs 98% → 99%)
-- Merged PR #55 to main (docs sync)
+- PR #56 merged, release tagged: https://github.com/Data-Wise/craft/releases/tag/v2.15.0
+- Site pages synced (7 files: REFCARD, CHANGELOG, tutorials, conventions)
+- Docs deployed to GitHub Pages
 
 ✅ v2.14.0 — Unified Formatting Library (2026-02-05):
 - New: scripts/formatting.sh — shared box-drawing, colors, ANSI-aware padding
@@ -35,18 +32,24 @@ progress: 95% (PR #56 open, docs synced, awaiting merge + release tag)
 
 ---
 
-## Next Steps
+## In Progress (v2.16.0)
+
+**feature/teaching-ecosystem**: ✅ MERGED (PR #57, 2026-02-07)
+- Config normalizer, break validation fix, 8 new tests, Teaching docs tab
 
-🎯 Next Action: Merge PR #56 to main, tag v2.15.0 release
+**feature/branch-protection** (9/9 complete ✅):
+1. ✅ Hook script (scripts/branch-guard.sh — moved into repo)
+2. ✅ Hook config (settings.json PreToolUse registration)
+3. ✅ Dry-run test
+4. ✅ Enable enforcement
+5. ✅ Per-project config (.claude/branch-guard.json)
+6. ✅ Craft command enhancements (check, do, worktree, status)
+7. ✅ New commands (unprotect, protect)
+8. ✅ Tests (49 unit + 31 e2e + 6 integration = 86 total)
+9. ✅ Documentation + standalone installer + Homebrew formula
 
-**v2.15.0 Deliverables:**
-- Brainstorm spec: 1,919 → 312 lines
-- New utility: utils/brainstorm_context.py (~280 lines)
-- New docs: SPEC-brainstorm-question-bank.md, TUTORIAL-brainstorm-power-user.md, REFCARD-BRAINSTORM.md
-- Updated: VERSION-HISTORY.md (brainstorm evolution table)
-- Tests: 38 new (test_brainstorm_context.py), 1286 total
+## Future (v2.17.0+)
 
-**Future (v2.16.0+):**
 - Language detection for multi-lang projects
 - Markdownlint rule expansion (30 → 42)
 - Remove deprecation aliases for old claude-md commands

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "craft",
-  "version": "2.15.0",
-  "description": "Full-stack developer toolkit with integrated workflow automation - 106 commands (94 craft + 12 workflow), 8 agents, 21 skills with standardized dry-run preview mode (29 with --dry-run support). Code, git, site, docs, testing, architecture, CI, distribution, teaching workflows, planning, and ADHD-friendly features including brainstorming, task management, and spec capture",
+  "version": "2.16.0",
+  "description": "Full-stack developer toolkit with integrated workflow automation - 108 commands (96 craft + 12 workflow), 8 agents, 21 skills with standardized dry-run preview mode (29 with --dry-run support). Code, git, site, docs, testing, architecture, CI, distribution, teaching workflows, planning, and ADHD-friendly features including brainstorming, task management, and spec capture",
   "author": {
     "name": "Data-Wise",
     "email": "dt@stat-wise.com"

.gitignore

@@ -21,12 +21,19 @@ env/
 .DS_Store
 Thumbs.db
 
-# Test reports
+# Test reports and logs
 tests/craft_test_report.md
+tests/cli/logs/
 .coverage
 
-# Brainstorm documents (working drafts)
-docs/brainstorm/
+# Working artifacts (session outputs, plans, reports)
+ORCHESTRATE
+WAVE*.md
+PHASE*.md
+IMPLEMENTATION*.md
+WIP*.md
+POST-MERGE-*.md
+PRE-PR-*.md
 
 # MkDocs
 site/

.linkcheck-ignore

@@ -42,20 +42,11 @@ File: `docs/test-violations.md`
 - Contains intentionally broken links to verify linting works
 - Should NOT be fixed
 
-### 2. Brainstorm Files (Gitignored)
+### 2. Archived Specs (Frozen References)
 Files with broken links:
-- `docs/specs/SPEC-craft-hub-v2-2026-01-15.md`
-- `docs/specs/SPEC-teaching-workflow-2026-01-16.md`
-- `docs/specs/_archive/SPEC-craft-hub-v2-2026-01-15.md`
-- `docs/brainstorm/*.md` (all brainstorm files - gitignored, not published)
+- `docs/specs/_archive/*.md`
 
-Targets:
-- `docs/brainstorm/*.md`
-- `../../BRAINSTORM-craft-hub-update-2026-01-15.md`
-- `.markdownlint.json`
-- `../../.markdownlint.json`
-- Reason: Brainstorm files are working documents, not published
-- Fix: Update specs to reference GitHub blob URLs or remove references
+- Reason: Archived specs contain stale relative links to brainstorm files, sibling specs, and docs that moved. These are frozen historical documents and won't be updated.
 
 ### 3. README References (Outside Docs)
 Files with broken links:
@@ -208,6 +199,16 @@ Targets:
 Reason: Spec documents contain example pointer syntax (`->`) that demonstrates the format — these resolve from project root, not from spec file location
 Fix: Not needed - these are examples of pointer syntax, not navigable links
 
+### 13. Historical Release Notes References
+Files with broken links:
+- `CHANGELOG.md`
+
+Targets:
+- `DRY-RUN-SUMMARY.md`
+
+Reason: Historical v1.20.0 changelog references a dry-run tracking document that was a working artifact, never committed
+Fix: Not needed - historical changelog entry, document was ephemeral
+
 ## Next Steps (Phase 2+)
 1. Update teaching docs to use category page anchors
 2. Copy README teaching section to docs/ or use GitHub links