specweave 0.30.16 → 0.30.18

package/dist/src/utils/structure-level-detector.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Structure Level Detector
+ *
+ * Detects whether the project uses 1-level or 2-level folder structure
+ * for living docs specs:
+ *
+ * - 1-Level: internal/specs/{project}/FS-XXX/
+ * - 2-Level: internal/specs/{project}/{board}/FS-XXX/
+ *
+ * 2-level is used when:
+ * - ADO area path mapping is configured (project → area paths)
+ * - JIRA board mapping is configured with multiple boards per project
+ * - Umbrella with team-based organization
+ *
+ * @module utils/structure-level-detector
+ */
+/**
+ * Structure level configuration
+ */
+export interface StructureLevelConfig {
+    /** Whether this is 1-level or 2-level structure */
+    level: 1 | 2;
+    /** Available projects (for 1-level) or top-level containers (for 2-level) */
+    projects: ProjectInfo[];
+    /** Available boards (only for 2-level) - organized by project */
+    boardsByProject?: Record<string, BoardInfo[]>;
+    /** Detection reason for debugging */
+    detectionReason: string;
+    /** Source of configuration */
+    source: 'ado-area-path' | 'jira-board' | 'umbrella-teams' | 'multi-project' | 'single-project' | 'existing-folders';
+}
+/**
+ * Project information
+ */
+export interface ProjectInfo {
+    id: string;
+    name: string;
+    /** For 2-level: this is the ADO project or JIRA project key */
+    externalId?: string;
+}
+/**
+ * Board information (for 2-level structures)
+ */
+export interface BoardInfo {
+    id: string;
+    name: string;
+    /** Parent project ID */
+    projectId: string;
+    /** Keywords for matching */
+    keywords?: string[];
+    /** ADO area path */
+    areaPath?: string;
+    /** JIRA board ID */
+    jiraBoardId?: string;
+}
+/**
+ * Validation result for spec.md project/board context
+ */
+export interface ProjectContextValidation {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    /** Detected structure level */
+    structureLevel: 1 | 2;
+    /** Parsed project from spec */
+    project?: string;
+    /** Parsed board from spec (for 2-level) */
+    board?: string;
+    /** Expected path where this spec will sync to */
+    expectedPath?: string;
+}
+/**
+ * Detect structure level from configuration
+ *
+ * @param projectRoot - Path to project root
+ * @returns Structure level configuration
+ */
+export declare function detectStructureLevel(projectRoot?: string): StructureLevelConfig;
+/**
+ * Validate spec.md has required project/board context
+ *
+ * @param specContent - Content of spec.md file
+ * @param projectRoot - Path to project root
+ * @returns Validation result
+ */
+export declare function validateProjectContext(specContent: string, projectRoot?: string): ProjectContextValidation;
+/**
+ * Get required fields for spec.md based on structure level
+ *
+ * @param projectRoot - Path to project root
+ * @returns Object describing required fields
+ */
+export declare function getRequiredSpecFields(projectRoot?: string): {
+    level: 1 | 2;
+    requiredFields: string[];
+    optionalFields: string[];
+    projects: ProjectInfo[];
+    boardsByProject?: Record<string, BoardInfo[]>;
+};
+/**
+ * Normalize ID to kebab-case
+ */
+declare function normalizeId(name: string): string;
+export { normalizeId };
+//# sourceMappingURL=structure-level-detector.d.ts.map

package/dist/src/utils/structure-level-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-level-detector.d.ts","sourceRoot":"","sources":["../../../src/utils/structure-level-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IAEb,6EAA6E;IAC7E,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAE9C,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IAExB,8BAA8B;IAC9B,MAAM,EAAE,eAAe,GAAG,YAAY,GAAG,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;CACrH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC;IACtB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA+CD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,GAAE,MAAsB,GAAG,oBAAoB,CAoQ9F;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAsB,GAClC,wBAAwB,CAgH1B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,GAAE,MAAsB,GAAG;IAC1E,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;CAC/C,CAmBA;AAED;;GAEG;AACH,iBAAS,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOzC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/src/utils/structure-level-detector.js

@@ -0,0 +1,388 @@
+/**
+ * Structure Level Detector
+ *
+ * Detects whether the project uses 1-level or 2-level folder structure
+ * for living docs specs:
+ *
+ * - 1-Level: internal/specs/{project}/FS-XXX/
+ * - 2-Level: internal/specs/{project}/{board}/FS-XXX/
+ *
+ * 2-level is used when:
+ * - ADO area path mapping is configured (project → area paths)
+ * - JIRA board mapping is configured with multiple boards per project
+ * - Umbrella with team-based organization
+ *
+ * @module utils/structure-level-detector
+ */
+import * as fs from './fs-native.js';
+import path from 'path';
+/**
+ * Detect structure level from configuration
+ *
+ * @param projectRoot - Path to project root
+ * @returns Structure level configuration
+ */
+export function detectStructureLevel(projectRoot = process.cwd()) {
+    const configPath = path.join(projectRoot, '.specweave', 'config.json');
+    const specsPath = path.join(projectRoot, '.specweave', 'docs', 'internal', 'specs');
+    let config = {};
+    // Read config.json if exists
+    if (fs.existsSync(configPath)) {
+        try {
+            config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        }
+        catch {
+            // Ignore parse errors, use defaults
+        }
+    }
+    // Check 1: ADO area path mapping (2-level structure)
+    if (config.sync?.profiles) {
+        for (const [, profile] of Object.entries(config.sync.profiles)) {
+            if (profile.provider !== 'ado')
+                continue;
+            const adoProject = profile.config?.project;
+            // ADO with areaPathMapping = 2-level structure
+            if (profile.config?.areaPathMapping?.mappings?.length && adoProject) {
+                const projects = [{
+                        id: normalizeId(adoProject),
+                        name: adoProject,
+                        externalId: adoProject
+                    }];
+                const boardsByProject = {};
+                const projectId = normalizeId(adoProject);
+                boardsByProject[projectId] = [];
+                for (const mapping of profile.config.areaPathMapping.mappings) {
+                    boardsByProject[projectId].push({
+                        id: normalizeId(mapping.specweaveProject),
+                        name: mapping.specweaveProject,
+                        projectId: projectId,
+                        keywords: mapping.keywords,
+                        areaPath: mapping.areaPath
+                    });
+                }
+                return {
+                    level: 2,
+                    projects,
+                    boardsByProject,
+                    detectionReason: 'ADO area path mapping configured',
+                    source: 'ado-area-path'
+                };
+            }
+            // ADO with simple areaPaths list = also 2-level (project/area)
+            if (profile.config?.areaPaths?.length && adoProject) {
+                const projects = [{
+                        id: normalizeId(adoProject),
+                        name: adoProject,
+                        externalId: adoProject
+                    }];
+                const boardsByProject = {};
+                const projectId = normalizeId(adoProject);
+                boardsByProject[projectId] = profile.config.areaPaths.map(ap => ({
+                    id: normalizeId(ap),
+                    name: ap,
+                    projectId: projectId,
+                    areaPath: ap
+                }));
+                return {
+                    level: 2,
+                    projects,
+                    boardsByProject,
+                    detectionReason: 'ADO area paths configured',
+                    source: 'ado-area-path'
+                };
+            }
+        }
+    }
+    // Check 2: JIRA board mapping with multiple boards (2-level structure)
+    if (config.sync?.profiles) {
+        for (const [, profile] of Object.entries(config.sync.profiles)) {
+            if (profile.provider !== 'jira')
+                continue;
+            if (profile.config?.boardMapping?.boards?.length) {
+                const boards = profile.config.boardMapping.boards;
+                // Group boards by specweaveProject to detect structure
+                const projectSet = new Set(boards.map(b => normalizeId(b.specweaveProject)));
+                if (projectSet.size > 1 || boards.length > 1) {
+                    // Multiple boards or multiple projects = 2-level
+                    const projects = Array.from(projectSet).map(p => ({
+                        id: p,
+                        name: p
+                    }));
+                    const boardsByProject = {};
+                    for (const board of boards) {
+                        const pid = normalizeId(board.specweaveProject);
+                        if (!boardsByProject[pid]) {
+                            boardsByProject[pid] = [];
+                        }
+                        boardsByProject[pid].push({
+                            id: normalizeId(board.name),
+                            name: board.name,
+                            projectId: pid,
+                            keywords: board.keywords,
+                            jiraBoardId: board.id
+                        });
+                    }
+                    return {
+                        level: 2,
+                        projects,
+                        boardsByProject,
+                        detectionReason: 'JIRA board mapping with multiple boards',
+                        source: 'jira-board'
+                    };
+                }
+            }
+        }
+    }
+    // Check 3: Umbrella with teams (2-level structure)
+    if (config.umbrella?.enabled && config.umbrella?.childRepos?.length) {
+        const repos = config.umbrella.childRepos;
+        const teams = new Set(repos.filter(r => r.team).map(r => r.team));
+        if (teams.size > 1) {
+            // Multiple teams = 2-level (team/repo)
+            const projects = Array.from(teams).map(t => ({
+                id: normalizeId(t),
+                name: t
+            }));
+            const boardsByProject = {};
+            for (const team of teams) {
+                const teamId = normalizeId(team);
+                boardsByProject[teamId] = repos
+                    .filter(r => r.team === team)
+                    .map(r => ({
+                    id: normalizeId(r.name || r.id),
+                    name: r.name || r.id,
+                    projectId: teamId
+                }));
+            }
+            return {
+                level: 2,
+                projects,
+                boardsByProject,
+                detectionReason: 'Umbrella with multiple teams',
+                source: 'umbrella-teams'
+            };
+        }
+    }
+    // Check 4: multiProject.projects (1-level structure)
+    if (config.multiProject?.enabled && config.multiProject?.projects) {
+        const projectEntries = Object.entries(config.multiProject.projects);
+        if (projectEntries.length >= 1) {
+            const projects = projectEntries.map(([id, p]) => ({
+                id: normalizeId(id),
+                name: p.name || id
+            }));
+            return {
+                level: 1,
+                projects,
+                detectionReason: 'multiProject configuration',
+                source: 'multi-project'
+            };
+        }
+    }
+    // Check 5: Existing folder structure
+    if (fs.existsSync(specsPath)) {
+        try {
+            const entries = fs.readdirSync(specsPath, { withFileTypes: true });
+            const folders = entries.filter(e => e.isDirectory() &&
+                !e.name.startsWith('_') &&
+                !e.name.startsWith('.') &&
+                !e.name.match(/^FS-\d{3,}/));
+            if (folders.length > 0) {
+                // Check if any folder has sub-folders (2-level)
+                const firstFolder = folders[0];
+                const subPath = path.join(specsPath, firstFolder.name);
+                const subEntries = fs.readdirSync(subPath, { withFileTypes: true });
+                const subFolders = subEntries.filter(e => e.isDirectory() &&
+                    !e.name.startsWith('_') &&
+                    !e.name.match(/^FS-\d{3,}/));
+                if (subFolders.length > 0) {
+                    // Has sub-folders that aren't FS-XXX = 2-level
+                    const projects = folders.map(f => ({
+                        id: f.name,
+                        name: f.name
+                    }));
+                    const boardsByProject = {};
+                    for (const folder of folders) {
+                        const pPath = path.join(specsPath, folder.name);
+                        const pEntries = fs.readdirSync(pPath, { withFileTypes: true });
+                        const pFolders = pEntries.filter(e => e.isDirectory() &&
+                            !e.name.startsWith('_') &&
+                            !e.name.match(/^FS-\d{3,}/));
+                        if (pFolders.length > 0) {
+                            boardsByProject[folder.name] = pFolders.map(b => ({
+                                id: b.name,
+                                name: b.name,
+                                projectId: folder.name
+                            }));
+                        }
+                    }
+                    return {
+                        level: 2,
+                        projects,
+                        boardsByProject,
+                        detectionReason: 'Existing 2-level folder structure',
+                        source: 'existing-folders'
+                    };
+                }
+                // 1-level structure
+                const projects = folders.map(f => ({
+                    id: f.name,
+                    name: f.name
+                }));
+                return {
+                    level: 1,
+                    projects,
+                    detectionReason: 'Existing project folders',
+                    source: 'existing-folders'
+                };
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    // Default: single project (1-level)
+    return {
+        level: 1,
+        projects: [{ id: 'default', name: 'Default' }],
+        detectionReason: 'No multi-project configuration - single project mode',
+        source: 'single-project'
+    };
+}
+/**
+ * Validate spec.md has required project/board context
+ *
+ * @param specContent - Content of spec.md file
+ * @param projectRoot - Path to project root
+ * @returns Validation result
+ */
+export function validateProjectContext(specContent, projectRoot = process.cwd()) {
+    const structureConfig = detectStructureLevel(projectRoot);
+    const errors = [];
+    const warnings = [];
+    // Parse YAML frontmatter
+    let project;
+    let board;
+    const frontmatterMatch = specContent.match(/^---\n([\s\S]*?)\n---/);
+    if (frontmatterMatch) {
+        const frontmatter = frontmatterMatch[1];
+        // Extract project field
+        const projectMatch = frontmatter.match(/^project:\s*(.+)$/m);
+        if (projectMatch) {
+            project = projectMatch[1].trim().replace(/^["']|["']$/g, '');
+        }
+        // Extract board field
+        const boardMatch = frontmatter.match(/^board:\s*(.+)$/m);
+        if (boardMatch) {
+            board = boardMatch[1].trim().replace(/^["']|["']$/g, '');
+        }
+    }
+    // Also check for **Project**: field in body (legacy format)
+    if (!project) {
+        const bodyProjectMatch = specContent.match(/\*\*Project\*\*:\s*(.+?)(?:\n|$)/i);
+        if (bodyProjectMatch) {
+            project = bodyProjectMatch[1].trim();
+            warnings.push('Using **Project**: field from body - prefer project: in YAML frontmatter');
+        }
+    }
+    // Validation based on structure level
+    if (structureConfig.level === 1) {
+        // 1-level: project is REQUIRED
+        if (!project) {
+            errors.push('Missing project field in spec.md. ' +
+                'Add `project: <project_name>` to YAML frontmatter. ' +
+                `Available projects: ${structureConfig.projects.map(p => p.id).join(', ')}`);
+        }
+        else {
+            // Validate project exists
+            const validProject = structureConfig.projects.find(p => normalizeId(p.id) === normalizeId(project));
+            if (!validProject && structureConfig.source !== 'single-project') {
+                warnings.push(`Project "${project}" not found in configuration. ` +
+                    `Available: ${structureConfig.projects.map(p => p.id).join(', ')}`);
+            }
+        }
+    }
+    else {
+        // 2-level: BOTH project AND board are REQUIRED
+        if (!project) {
+            errors.push('Missing project field in spec.md (2-level structure detected). ' +
+                'Add `project: <project_name>` to YAML frontmatter. ' +
+                `Available projects: ${structureConfig.projects.map(p => p.id).join(', ')}`);
+        }
+        if (!board) {
+            const boardOptions = project && structureConfig.boardsByProject?.[normalizeId(project)]
+                ? structureConfig.boardsByProject[normalizeId(project)].map(b => b.id).join(', ')
+                : 'N/A';
+            errors.push('Missing board field in spec.md (2-level structure detected). ' +
+                'Add `board: <board_name>` to YAML frontmatter. ' +
+                `Available boards: ${boardOptions}`);
+        }
+        else if (project && structureConfig.boardsByProject) {
+            // Validate board exists under project
+            const projectBoards = structureConfig.boardsByProject[normalizeId(project)];
+            if (projectBoards) {
+                const validBoard = projectBoards.find(b => normalizeId(b.id) === normalizeId(board));
+                if (!validBoard) {
+                    warnings.push(`Board "${board}" not found under project "${project}". ` +
+                        `Available: ${projectBoards.map(b => b.id).join(', ')}`);
+                }
+            }
+        }
+    }
+    // Calculate expected path
+    let expectedPath;
+    if (project) {
+        if (structureConfig.level === 2 && board) {
+            expectedPath = `internal/specs/${normalizeId(project)}/${normalizeId(board)}/`;
+        }
+        else if (structureConfig.level === 1) {
+            expectedPath = `internal/specs/${normalizeId(project)}/`;
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+        structureLevel: structureConfig.level,
+        project,
+        board,
+        expectedPath
+    };
+}
+/**
+ * Get required fields for spec.md based on structure level
+ *
+ * @param projectRoot - Path to project root
+ * @returns Object describing required fields
+ */
+export function getRequiredSpecFields(projectRoot = process.cwd()) {
+    const config = detectStructureLevel(projectRoot);
+    if (config.level === 2) {
+        return {
+            level: 2,
+            requiredFields: ['project', 'board'],
+            optionalFields: [],
+            projects: config.projects,
+            boardsByProject: config.boardsByProject
+        };
+    }
+    return {
+        level: 1,
+        requiredFields: ['project'],
+        optionalFields: ['board'],
+        projects: config.projects
+    };
+}
+/**
+ * Normalize ID to kebab-case
+ */
+function normalizeId(name) {
+    return name
+        .toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9-]/g, '')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+export { normalizeId };
+//# sourceMappingURL=structure-level-detector.js.map

package/dist/src/utils/structure-level-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-level-detector.js","sourceRoot":"","sources":["../../../src/utils/structure-level-detector.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.30.16",
+  "version": "0.30.18",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/commands/specweave-increment.md

@@ -371,18 +371,60 @@ Proceeding with hotfix 0006...
 - Find highest number across both directories (e.g., 032)
 - Next increment: 033
 
-### Step 1.5: Detect Multi-Project Mode (CRITICAL!)
+### Step 1.5: Detect Structure Level & Select Project/Board (v0.31.0+ MANDATORY!)
 
-**⚠️ MANDATORY CHECK before generating spec.md:**
+**⚠️ MANDATORY CHECK before generating spec.md!**
 
-```bash
-# Check for umbrella configuration
-UMBRELLA_ENABLED=$(cat .specweave/config.json 2>/dev/null | jq -r '.umbrella.enabled // false')
-CHILD_REPOS=$(cat .specweave/config.json 2>/dev/null | jq -r '.umbrella.childRepos[]?.id // empty' | tr '\n' ',')
-PROJECT_FOLDERS=$(ls -1 .specweave/docs/internal/specs/ 2>/dev/null | grep -v "^_" | head -5)
+**Structure Level Detection** (use `src/utils/structure-level-detector.ts`):
+
+```typescript
+import { detectStructureLevel } from './utils/structure-level-detector.js';
+
+const structureConfig = detectStructureLevel(projectRoot);
+// structureConfig.level: 1 or 2
+// structureConfig.projects: available projects
+// structureConfig.boardsByProject: boards per project (if 2-level)
+```
+
+**Detection Sources** (priority order):
+1. ADO area path mapping (`sync.profiles.*.config.areaPathMapping`)
+2. ADO `areaPaths` array
+3. JIRA board mapping (`sync.profiles.*.config.boardMapping`)
+4. Umbrella teams (`umbrella.teams`)
+5. Umbrella repos (`umbrella.childRepos`)
+6. Multi-project config (`multiProject.enabled`)
+7. Existing folder structure (fallback)
+
+**For 1-Level Structure** (projects only):
+```
+📁 Structure Level: 1 (projects only)
+   Available projects: web-app, mobile-app, platform-infra
+
+Which project should this increment target?
+> web-app
+
+✅ spec.md will include: project: web-app
+✅ Sync path: internal/specs/web-app/FS-XXX/
+```
+
+**For 2-Level Structure** (projects + boards):
 ```
+📁 Structure Level: 2 (projects + boards)
+   Available projects: acme-corp
+
+   📁 Project: acme-corp
+      Boards: clinical-insights, platform-engineering, digital-operations
+
+Which board should this increment sync to?
+> clinical-insights
 
-**If multi-project detected:**
+✅ spec.md will include:
+   project: acme-corp
+   board: clinical-insights
+✅ Sync path: internal/specs/acme-corp/clinical-insights/FS-XXX/
+```
+
+**Multi-Project User Stories** (if umbrella detected):
 ```
 📁 Multi-Project Mode Detected!
 
@@ -399,7 +441,7 @@ User stories will be generated with project prefixes:
 Each story will include "Related Repo" field for clarity.
 ```
 
-**Pass this context to increment-planner skill!**
+**Pass project/board values to increment-planner skill!**
 
 ### Step 2: Detect tech stack (CRITICAL - framework-agnostic)
    - Settings auto-detected
@@ -628,6 +670,8 @@ Next steps:
 
 **IMPORTANT**: Tech stack is AUTO-DETECTED from project files (package.json, requirements.txt, etc.), NOT hardcoded!
 
+**IMPORTANT (v0.31.0+)**: `project:` (and `board:` for 2-level) fields are MANDATORY. See Step 1.5.
+
 ```yaml
 ---
 increment: 003-user-authentication
@@ -638,6 +682,10 @@ created: 2025-10-26
 dependencies: []
 structure: user-stories
 
+# PROJECT/BOARD (v0.31.0+ MANDATORY)
+project: web-app                           # REQUIRED - target project for living docs sync
+board: digital-operations                  # REQUIRED only for 2-level structures (ADO/JIRA boards)
+
 # Tech stack is DETECTED, not hardcoded
 tech_stack:
   detected_from: "package.json"  # or "requirements.txt", "go.mod", etc.

package/plugins/specweave/commands/specweave-qa.md

@@ -10,10 +10,40 @@ description: Run quality assessment on a SpecWeave increment with risk scoring a
 ## Purpose
 
 Run comprehensive quality assessment on an increment using:
-- ✅ Rule-based validation (120 checks)
-- ✅ AI quality assessment (7 dimensions including risk)
-- ✅ Quantitative risk scoring (Probability × Impact)
-- ✅ Quality gate decisions (PASS/CONCERNS/FAIL)
+- ✅ **Gate 1: Rule-based validation** (130+ automated checks)
+- ✅ **Gate 2: LLM-as-Judge** (AI quality assessment with chain-of-thought reasoning)
+- ✅ **Gate 3: Risk scoring** (BMAD Probability × Impact quantitative assessment)
+- ✅ **Quality gate decisions** (PASS/CONCERNS/FAIL)
+
+## LLM-as-Judge Pattern
+
+This command implements the **LLM-as-Judge** pattern - an established AI/ML evaluation technique where an LLM evaluates outputs using structured reasoning.
+
+**How it works:**
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    LLM-as-Judge Gate                        │
+├─────────────────────────────────────────────────────────────┤
+│  Input: spec.md, plan.md, tasks.md                         │
+│                                                             │
+│  Process:                                                   │
+│  1. Chain-of-thought analysis (7 dimensions)               │
+│  2. Evidence-based scoring (0-100 per dimension)           │
+│  3. Risk identification (BMAD P×I formula)                 │
+│  4. Formal verdict (PASS/CONCERNS/FAIL)                    │
+│                                                             │
+│  Output: Structured quality report with:                   │
+│  - Blockers (MUST fix)                                     │
+│  - Concerns (SHOULD fix)                                   │
+│  - Recommendations (NICE to fix)                           │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Why LLM-as-Judge?**
+- **Consistency**: Applies uniform evaluation criteria
+- **Depth**: Catches nuanced issues humans might miss
+- **Speed**: ~30 seconds vs hours of manual review
+- **Documented reasoning**: Explains WHY something is an issue
 
 ## Usage