specweave 0.30.16 → 0.30.18

package/plugins/specweave/skills/multi-project-spec-mapper/SKILL.md

@@ -95,8 +95,31 @@ US-005: Cross-Platform Data Sync (Mobile)
     └── README.md
 ```
 
+**spec.md YAML Frontmatter (v0.31.0+ MANDATORY)**:
+
+```yaml
+# For 1-level structure (projects only)
+---
+increment: 0001-fitness-tracker-web
+project: FE                      # REQUIRED
+title: "Fitness Tracker Web UI"
+status: planned
+---
+
+# For 2-level structure (projects + boards)
+---
+increment: 0001-fitness-tracker-web
+project: acme-corp               # REQUIRED
+board: digital-operations        # REQUIRED for 2-level
+title: "Fitness Tracker Web UI"
+status: planned
+---
+```
+
+**Detection**: Use `detectStructureLevel()` from `src/utils/structure-level-detector.ts`
+
 **Each spec contains**:
-- Frontmatter with `project: FE` tag
+- YAML frontmatter with `project:` (and `board:` for 2-level) fields - MANDATORY
 - User stories mapped to that project
 - Project-specific acceptance criteria
 - Links to shared infrastructure/requirements

package/plugins/specweave/skills/spec-generator/SKILL.md

@@ -27,6 +27,24 @@ description: Generates comprehensive specifications (spec.md, plan.md, tasks.md
 - **Bug Fix**: Problem statement, root cause, solution, impact analysis
 - **Refactoring**: Current state, proposed changes, benefits, migration plan
 
+**YAML Frontmatter** (v0.31.0+ MANDATORY):
+```yaml
+---
+increment: 0001-feature-name
+title: "Feature Title"
+type: feature
+priority: P1
+status: planned
+created: 2025-12-04
+project: my-project          # REQUIRED - target project for living docs sync
+board: my-board              # REQUIRED for 2-level structures (ADO area paths, JIRA boards)
+---
+```
+
+**Detect Structure Level First** (see `src/utils/structure-level-detector.ts`):
+- 1-level: `project:` field REQUIRED
+- 2-level: `project:` AND `board:` fields REQUIRED
+
 **Core Sections** (Always Present):
 ```markdown
 # Product Specification: [Increment Name]

package/plugins/specweave/skills/specweave-framework/SKILL.md

@@ -30,6 +30,31 @@ An **increment** = a complete feature with:
 
 > **When to skip plan.md**: Bug fixes, simple migrations, hotfixes, and straightforward tasks where spec.md already describes the approach.
 
+### spec.md Mandatory Fields (v0.31.0+)
+
+**CRITICAL**: spec.md YAML frontmatter MUST include project (and board for 2-level structures):
+
+```yaml
+# 1-level structure (single-project or multiProject):
+---
+increment: 0001-feature-name
+project: my-project          # REQUIRED
+---
+
+# 2-level structure (ADO area paths, JIRA boards, umbrella teams):
+---
+increment: 0001-feature-name
+project: acme-corp           # REQUIRED
+board: digital-operations    # REQUIRED for 2-level
+---
+```
+
+**Why?** Ensures increment syncs to correct location in living docs. Without explicit project/board, sync-specs may fail or place specs in wrong folder.
+
+**Detection**: Use `src/utils/structure-level-detector.ts` to determine if 1-level or 2-level structure is needed.
+
+**See**: [ADR-0190](/internal/architecture/adr/0190-spec-project-board-requirement.md)
+
 ### Increment Naming Convention (v0.6.0+)
 
 **CRITICAL RULE**: All increments MUST use descriptive names, not just numbers!

package/plugins/specweave-github/hooks/.specweave/logs/hooks-debug.log

@@ -280,3 +280,17 @@
 [Wed Dec  3 02:07:36 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
 [Wed Dec  3 02:07:36 EST 2025] [GitHub] 🔗 GitHub sync hook fired
 [Wed Dec  3 02:07:36 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Thu Dec  4 17:45:45 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Thu Dec  4 17:45:45 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Thu Dec  4 17:45:45 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Thu Dec  4 17:45:45 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Thu Dec  4 17:45:46 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Thu Dec  4 17:45:46 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Thu Dec  4 17:45:46 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Thu Dec  4 17:45:46 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Thu Dec  4 17:45:55 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Thu Dec  4 17:45:55 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Thu Dec  4 17:45:55 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Thu Dec  4 17:45:55 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Thu Dec  4 17:45:55 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Thu Dec  4 17:45:55 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync

package/plugins/specweave-release/hooks/.specweave/logs/dora-tracking.log

@@ -421,3 +421,24 @@
 [2025-12-03 02:07:36] 🎯 Post-Increment-Completion Hook Triggered
 [2025-12-03 02:07:36] ⚠️  DORA calculator not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
 [2025-12-03 02:07:36]    Run: npm run build
+[2025-12-04 17:45:45] 🎯 Post-Increment-Completion Hook Triggered
+[2025-12-04 17:45:45] ⚠️  DORA calculator not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-12-04 17:45:45]    Run: npm run build
+[2025-12-04 17:45:45] 🎯 Post-Increment-Completion Hook Triggered
+[2025-12-04 17:45:45] ⚠️  DORA calculator not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-12-04 17:45:45]    Run: npm run build
+[2025-12-04 17:45:46] 🎯 Post-Increment-Completion Hook Triggered
+[2025-12-04 17:45:46] ⚠️  DORA calculator not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-12-04 17:45:46]    Run: npm run build
+[2025-12-04 17:45:46] 🎯 Post-Increment-Completion Hook Triggered
+[2025-12-04 17:45:46] ⚠️  DORA calculator not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-12-04 17:45:46]    Run: npm run build
+[2025-12-04 17:45:55] 🎯 Post-Increment-Completion Hook Triggered
+[2025-12-04 17:45:55] ⚠️  DORA calculator not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-12-04 17:45:55]    Run: npm run build
+[2025-12-04 17:45:55] 🎯 Post-Increment-Completion Hook Triggered
+[2025-12-04 17:45:55] ⚠️  DORA calculator not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-12-04 17:45:55]    Run: npm run build
+[2025-12-04 17:45:55] 🎯 Post-Increment-Completion Hook Triggered
+[2025-12-04 17:45:55] ⚠️  DORA calculator not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-12-04 17:45:55]    Run: npm run build