specweave 0.15.1 → 0.16.2

package/plugins/specweave/skills/increment-planner/SKILL.md

@@ -149,12 +149,19 @@ User: "I want to build real-time price tracking"
     ↓
 increment-planner skill
     ↓
-STEP 1: Scan existing docs
+STEP 1: Determine increment number and check for duplicates
+├─ Use the Bash tool to run: node plugins/specweave/skills/increment-planner/scripts/feature-utils.js next
+├─ Get next available increment number (e.g., "0021")
+├─ Get short name from user description
+├─ Check if increment already exists using: node plugins/specweave/skills/increment-planner/scripts/feature-utils.js check-increment {number}
+└─ If duplicate found, STOP and tell user: "Increment {number} already exists! Please use the existing increment."
+    ↓
+STEP 2: Scan existing docs
 ├─ Read .specweave/docs/internal/strategy/ (existing requirements)
 ├─ Read .specweave/docs/internal/architecture/adr/ (existing decisions)
 └─ Pass existing context to agents
     ↓
-STEP 2: Invoke PM Agent (🚨 MANDATORY - USE TASK TOOL)
+STEP 3: Invoke PM Agent (🚨 MANDATORY - USE TASK TOOL)
 
 YOU MUST USE THE TASK TOOL - DO NOT SKIP:
 
@@ -206,7 +213,7 @@ Task(
 
 Wait for PM agent to complete!
     ↓
-STEP 3: Invoke Architect Agent (🚨 MANDATORY - USE TASK TOOL)
+STEP 4: Invoke Architect Agent (🚨 MANDATORY - USE TASK TOOL)
 
 YOU MUST USE THE TASK TOOL - DO NOT SKIP:
 
@@ -239,7 +246,7 @@ Task(
 
 Wait for Architect agent to complete!
     ↓
-STEP 4: Invoke Test-Aware Planner Agent (🚨 MANDATORY - USE TASK TOOL)
+STEP 5: Invoke Test-Aware Planner Agent (🚨 MANDATORY - USE TASK TOOL)
 
 YOU MUST USE THE TASK TOOL - DO NOT SKIP:
 
@@ -275,7 +282,7 @@ Task(
 
 Wait for test-aware-planner agent to complete!
     ↓
-STEP 5: Validate Living Docs and Increment Files
+STEP 6: Validate Living Docs and Increment Files
 ├─ Check .specweave/docs/internal/specs/spec-{number}-{name}/spec.md exists (SOURCE OF TRUTH)
 ├─ Check living spec.md contains ALL user stories, requirements, AC-IDs (with AC-IDs)
 ├─ Check .specweave/docs/internal/architecture/adr/ has ≥3 ADRs

package/plugins/specweave/skills/increment-planner/scripts/feature-utils.js

@@ -3,8 +3,12 @@
  * Supports increment-planner skill with auto-numbering and name generation
  */
 
-const fs = require('fs');
-const path = require('path');
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 
 /**
  * Stop words to filter from feature descriptions
@@ -198,7 +202,7 @@ function parseFeatureDescription(description) {
   };
 }
 
-module.exports = {
+export {
   generateShortName,
   getNextFeatureNumber,
   featureExists,
@@ -210,8 +214,8 @@ module.exports = {
   STOP_WORDS
 };
 
-// CLI usage
-if (require.main === module) {
+// CLI usage - check if this file is being run directly
+if (import.meta.url === `file://${process.argv[1]}`) {
   const args = process.argv.slice(2);
 
   if (args.length === 0) {
@@ -219,6 +223,7 @@ if (require.main === module) {
     console.log('  node feature-utils.js shortname "feature description"');
     console.log('  node feature-utils.js next [features-dir]');
     console.log('  node feature-utils.js parse "feature description"');
+    console.log('  node feature-utils.js check-increment <number> [features-dir]');
     process.exit(0);
   }
 
@@ -243,6 +248,22 @@ if (require.main === module) {
       }
       break;
 
+    case 'check-increment':
+      if (args[1]) {
+        const incrementNumber = args[1];
+        const checkDir = args[2] || '.specweave/increments';
+        if (incrementNumberExists(incrementNumber, checkDir)) {
+          console.error(`ERROR: Increment ${incrementNumber} already exists!`);
+          process.exit(1);
+        } else {
+          console.log(`OK: Increment ${incrementNumber} is available`);
+        }
+      } else {
+        console.error('Error: Increment number required');
+        process.exit(1);
+      }
+      break;
+
     default:
       console.error(`Unknown command: ${command}`);
       process.exit(1);

package/plugins/specweave-ado/skills/ado-sync/SKILL.md

@@ -47,7 +47,7 @@ description: Bidirectional synchronization between SpecWeave increments and Azur
 /plugin list --installed | grep specweave-ado
 
 # Install if needed
-/plugin install specweave-ado@specweave
+/plugin install specweave-ado
 ```
 
 ### 2. Azure DevOps Personal Access Token (PAT)
@@ -403,4 +403,4 @@ Sync Enabled: ✅
 
 **Status**: Ready to use
 **Version**: 0.1.0
-**Plugin**: specweave-ado@specweave
+**Plugin**: specweave-ado

package/plugins/specweave-figma/ARCHITECTURE.md

@@ -287,7 +287,7 @@ specweave plugin install figma
 **Via Claude Code**:
 ```bash
 /plugin marketplace add specweave/marketplace
-/plugin install specweave-figma@specweave
+/plugin install specweave-figma
 ```
 
 ### Verify Installation

package/plugins/specweave-figma/README.md

@@ -102,7 +102,7 @@ specweave plugin list
 /plugin marketplace add https://raw.githubusercontent.com/anton-abyzov/specweave/main/marketplace/.claude-plugin/marketplace.json
 
 # Install figma plugin
-/plugin install specweave-figma@specweave
+/plugin install specweave-figma
 
 # Verify
 /plugin list

package/plugins/specweave-ml/README.md

@@ -28,7 +28,7 @@ Brings the same engineering discipline to ML that SpecWeave brings to software:
 
 ```bash
 # Install SpecWeave ML plugin
-/plugin install specweave-ml@specweave
+/plugin install specweave-ml
 
 # Verify installation
 /plugin list

package/src/templates/CLAUDE.md.template

@@ -208,11 +208,10 @@ Both approaches work perfectly - use whichever feels more natural!
 ### Increment Structure
 
 ```
-.specweave/increments/0001-user-auth/
+.specweave/increments/0001-user-auth/   # ⚠️ ID must be unique!
 ├── spec.md                      # WHAT & WHY
 ├── plan.md                      # HOW
-├── tasks.md                     # Implementation steps
-├── tests.md                     # Test strategy
+├── tasks.md                     # Implementation steps with embedded tests
 ├── context-manifest.yaml        # Selective context loading
 ├── logs/                        # ✅ Execution logs, errors, AI sessions
 ├── scripts/                     # ✅ Helper scripts, migrations, setup
@@ -278,12 +277,11 @@ Config: Auto-detected from project files
 │   │   │   ├── operations/      # Runbooks, monitoring
 │   │   │   └── governance/      # Security, compliance
 │   │   └── public/              # Published docs
-│   ├── increments/              # Features (auto-numbered)
-│   │   └── 0001-feature-name/
-│   │       ├── spec.md
-│   │       ├── plan.md
-│   │       ├── tasks.md
-│   │       ├── tests.md
+│   ├── increments/              # Features (auto-numbered, UNIQUE IDs)
+│   │   └── 0001-feature-name/   # ⚠️ Each ID must be unique (0001-9999)
+│   │       ├── spec.md          # What we're building
+│   │       ├── plan.md          # How we'll build it
+│   │       ├── tasks.md         # Tasks with embedded tests
 │   │       ├── logs/            # ✅ Put logs here
 │   │       ├── scripts/         # ✅ Put scripts here
 │   │       └── reports/         # ✅ Put reports here
@@ -436,6 +434,7 @@ Plugins are detected and suggested during `specweave init` based on:
 4. **Validated**: Every increment validated before closure
 5. **Traceable**: All work traces back to specs and requirements
 6. **Clean Organization**: All supporting files in increment folders, never root
+7. **No Duplicate Increments**: Each increment must have a unique 4-digit ID (0001-9999)
 
 ---
 

package/plugins/specweave-github/hooks/post-increment-done.sh

@@ -1,224 +0,0 @@
-#!/bin/bash
-# Post-Increment-Done Hook - GitHub Plugin
-#
-# Purpose: Automatically syncs living docs spec to GitHub Project when increment closes
-#
-# Triggered by: /specweave:done command completion
-# Event: PostSlashCommand (commandName: "specweave:done")
-#
-# Flow:
-# 1. Increment closes → PM validates
-# 2. Hook fires automatically
-# 3. Syncs living docs spec to GitHub Project
-# 4. Closes GitHub Issue (if exists)
-#
-# Configuration (.specweave/config.json):
-#   "hooks": {
-#     "post_increment_done": {
-#       "sync_to_github_project": true,
-#       "close_github_issue": true,
-#       "update_living_docs_first": true
-#     }
-#   }
-
-set -e
-
-# ============================================================================
-# Configuration & Logging
-# ============================================================================
-
-INCREMENT_ID="$1"
-HOOK_NAME="post-increment-done"
-LOG_DIR=".specweave/logs"
-LOG_FILE="${LOG_DIR}/hooks-debug.log"
-CONFIG_FILE=".specweave/config.json"
-
-# Ensure log directory exists
-mkdir -p "${LOG_DIR}"
-
-# Logging function
-log() {
-  local level="$1"
-  shift
-  local message="$*"
-  local timestamp
-  timestamp=$(date '+%Y-%m-%d %H:%M:%S')
-  echo "[${timestamp}] [${HOOK_NAME}] [${level}] ${message}" | tee -a "${LOG_FILE}"
-}
-
-log "INFO" "=========================================="
-log "INFO" "Post-Increment-Done Hook Started"
-log "INFO" "Increment: ${INCREMENT_ID}"
-log "INFO" "=========================================="
-
-# ============================================================================
-# Validation & Configuration
-# ============================================================================
-
-# Check if increment ID provided
-if [ -z "$INCREMENT_ID" ]; then
-  log "ERROR" "No increment ID provided to hook"
-  exit 0
-fi
-
-# Normalize increment ID to 4-digit format
-# First strip leading zeros to avoid octal interpretation (0019 → 19)
-INCREMENT_ID_NUM=$(echo "$INCREMENT_ID" | sed 's/^0*//')
-# Then normalize to 4-digit format (19 → 0019)
-INCREMENT_ID=$(printf "%04d" "$INCREMENT_ID_NUM" 2>/dev/null || echo "$INCREMENT_ID")
-
-# Find increment directory (format: 0019-name or 0019)
-INCREMENT_DIR=$(find .specweave/increments/ -maxdepth 1 -type d -name "${INCREMENT_ID}*" | head -1)
-
-if [ -z "$INCREMENT_DIR" ] || [ ! -d "$INCREMENT_DIR" ]; then
-  log "WARN" "Increment directory not found for ID: ${INCREMENT_ID}"
-  exit 0
-fi
-
-log "INFO" "Found increment directory: ${INCREMENT_DIR}"
-
-# Read configuration
-if [ ! -f "$CONFIG_FILE" ]; then
-  log "WARN" "Config file not found: ${CONFIG_FILE}"
-  exit 0
-fi
-
-# Check if GitHub Project sync is enabled
-SYNC_ENABLED=$(node -pe "
-  try {
-    const config = require('./${CONFIG_FILE}');
-    config.hooks?.post_increment_done?.sync_to_github_project || false;
-  } catch (e) {
-    false;
-  }
-" 2>/dev/null || echo "false")
-
-log "INFO" "GitHub Project sync enabled: ${SYNC_ENABLED}"
-
-if [ "$SYNC_ENABLED" != "true" ]; then
-  log "INFO" "GitHub Project sync disabled, skipping"
-  exit 0
-fi
-
-# Check if GitHub CLI is available
-if ! command -v gh &> /dev/null; then
-  log "WARN" "GitHub CLI (gh) not found, skipping sync"
-  exit 0
-fi
-
-# Check if gh is authenticated
-if ! gh auth status &> /dev/null; then
-  log "WARN" "GitHub CLI not authenticated, skipping sync"
-  exit 0
-fi
-
-# ============================================================================
-# Find Living Docs Spec
-# ============================================================================
-
-log "INFO" "Finding living docs spec for increment ${INCREMENT_ID}..."
-
-# Pattern 1: spec-NNNN-name.md (e.g., spec-0018-strict-increment-discipline.md)
-SPEC_FILE=$(find .specweave/docs/internal/specs/ -name "spec-${INCREMENT_ID}*.md" 2>/dev/null | head -1)
-
-# Pattern 2: spec-NNN-name.md (e.g., spec-018-strict-increment-discipline.md)
-if [ -z "$SPEC_FILE" ]; then
-  INCREMENT_ID_3DIGIT=$(printf "%03d" "$INCREMENT_ID" 2>/dev/null || echo "$INCREMENT_ID")
-  SPEC_FILE=$(find .specweave/docs/internal/specs/ -name "spec-${INCREMENT_ID_3DIGIT}*.md" 2>/dev/null | head -1)
-fi
-
-# Pattern 3: Check increment spec.md for living docs reference
-if [ -z "$SPEC_FILE" ] && [ -f "${INCREMENT_DIR}/spec.md" ]; then
-  log "INFO" "Checking increment spec.md for living docs reference..."
-  SPEC_REFERENCE=$(grep -E "Living Docs:.*spec-[0-9]+" "${INCREMENT_DIR}/spec.md" | grep -oE "spec-[0-9]+-[a-z-]+" | head -1)
-  if [ -n "$SPEC_REFERENCE" ]; then
-    SPEC_FILE=$(find .specweave/docs/internal/specs/ -name "${SPEC_REFERENCE}.md" 2>/dev/null | head -1)
-  fi
-fi
-
-if [ -z "$SPEC_FILE" ]; then
-  log "WARN" "No living docs spec found for increment ${INCREMENT_ID}"
-  log "INFO" "This is OK for bug/hotfix increments that don't create new specs"
-  exit 0
-fi
-
-log "INFO" "Found living docs spec: ${SPEC_FILE}"
-
-# ============================================================================
-# Sync to GitHub Project
-# ============================================================================
-
-log "INFO" "🔄 Syncing living docs spec to GitHub Project..."
-
-# Extract spec ID from filename (e.g., spec-018-name.md → 018)
-SPEC_ID=$(basename "$SPEC_FILE" | grep -oE "spec-[0-9]+" | grep -oE "[0-9]+")
-
-log "INFO" "Spec ID: ${SPEC_ID}"
-
-# Call the sync-spec command
-# NOTE: This assumes /specweave-github:sync-spec command exists
-# If not implemented yet, this will gracefully fail
-if npx specweave sync-spec "$SPEC_FILE" >> "${LOG_FILE}" 2>&1; then
-  log "INFO" "✅ GitHub Project synced successfully"
-else
-  log "WARN" "Failed to sync to GitHub Project (command may not exist yet)"
-  log "INFO" "Manual sync: /specweave-github:sync-spec ${SPEC_FILE}"
-fi
-
-# ============================================================================
-# Close GitHub Issue (Optional)
-# ============================================================================
-
-CLOSE_ISSUE=$(node -pe "
-  try {
-    const config = require('./${CONFIG_FILE}');
-    config.hooks?.post_increment_done?.close_github_issue || false;
-  } catch (e) {
-    false;
-  }
-" 2>/dev/null || echo "false")
-
-log "INFO" "Close GitHub issue enabled: ${CLOSE_ISSUE}"
-
-if [ "$CLOSE_ISSUE" = "true" ]; then
-  # Check if increment has GitHub issue metadata
-  METADATA_FILE="${INCREMENT_DIR}/.metadata.json"
-
-  if [ -f "$METADATA_FILE" ]; then
-    ISSUE_NUMBER=$(node -pe "
-      try {
-        const metadata = require('./${METADATA_FILE}');
-        metadata.github?.issue || '';
-      } catch (e) {
-        '';
-      }
-    " 2>/dev/null || echo "")
-
-    if [ -n "$ISSUE_NUMBER" ]; then
-      log "INFO" "Closing GitHub issue #${ISSUE_NUMBER}..."
-
-      # Close issue via gh CLI
-      if gh issue close "$ISSUE_NUMBER" --comment "✅ Increment ${INCREMENT_ID} completed and closed" >> "${LOG_FILE}" 2>&1; then
-        log "INFO" "✅ GitHub issue #${ISSUE_NUMBER} closed"
-      else
-        log "WARN" "Failed to close GitHub issue #${ISSUE_NUMBER}"
-      fi
-    else
-      log "INFO" "No GitHub issue found in metadata"
-    fi
-  else
-    log "INFO" "No metadata file found: ${METADATA_FILE}"
-  fi
-fi
-
-# ============================================================================
-# Completion
-# ============================================================================
-
-log "INFO" "=========================================="
-log "INFO" "Post-Increment-Done Hook Completed"
-log "INFO" "Increment: ${INCREMENT_ID}"
-log "INFO" "Spec: ${SPEC_FILE}"
-log "INFO" "=========================================="
-
-exit 0