sdd-mcp-server 3.0.1 → 3.1.0

package/dist/cli/migrate-steering.js

@@ -0,0 +1,308 @@
+#!/usr/bin/env node
+/**
+ * Steering Migration Tool for SDD MCP v3.1
+ *
+ * Migrates projects from static steering documents to the new consolidated
+ * agents/rules/skills architecture.
+ *
+ * This tool:
+ * 1. Detects old steering structure (.spec/steering/ with static docs)
+ * 2. Backs up existing steering to .spec/steering.backup/
+ * 3. Removes static steering docs (principles, tdd-guideline, linus-review, etc.)
+ * 4. Preserves project-specific docs (product.md, tech.md, structure.md)
+ *
+ * The static steering content has been merged into:
+ * - principles.md → rules/coding-style.md
+ * - tdd-guideline.md → agents/tdd-guide.md
+ * - linus-review.md → agents/reviewer.md
+ * - owasp-top10-check.md → agents/security-auditor.md
+ * - commit.md → skills/sdd-commit/SKILL.md
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const HELP = `
+SDD Steering Migration Tool (v3.1)
+
+Migrates from static steering documents to consolidated agents/rules/skills.
+
+Usage: npx sdd-mcp-server migrate-steering [options]
+
+Options:
+  --path <dir>     Project directory (default: current directory)
+  --dry-run, -n    Preview without making changes
+  --force, -f      Skip confirmation prompts
+  --help, -h       Show this help
+
+What This Tool Does:
+  1. Backs up existing .spec/steering/ to .spec/steering.backup/
+  2. Removes static steering documents that have been merged:
+     - AGENTS.md (meta-doc, removed)
+     - commit.md (merged into skills/sdd-commit/SKILL.md)
+     - linus-review.md (merged into agents/reviewer.md)
+     - owasp-top10-check.md (merged into agents/security-auditor.md)
+     - principles.md (merged into rules/coding-style.md)
+     - tdd-guideline.md (merged into agents/tdd-guide.md)
+  3. Preserves project-specific templates:
+     - product.md
+     - tech.md
+     - structure.md
+
+Migration Path:
+  The static guidance content now lives in enhanced components:
+  - Design principles: .claude/rules/coding-style.md
+  - TDD methodology: .claude/agents/tdd-guide.md
+  - Review criteria: .claude/agents/reviewer.md
+  - Security checklist: .claude/agents/security-auditor.md
+  - Commit format: .claude/skills/sdd-commit/SKILL.md
+
+Examples:
+  npx sdd-mcp-server migrate-steering              # Migrate current directory
+  npx sdd-mcp-server migrate-steering --dry-run   # Preview changes
+  npx sdd-mcp-server migrate-steering --path ./my-project
+`;
+/**
+ * Static steering documents that should be removed
+ * These have been merged into agents/rules/skills
+ */
+const STATIC_STEERING_DOCS = [
+    'AGENTS.md',
+    'commit.md',
+    'linus-review.md',
+    'owasp-top10-check.md',
+    'principles.md',
+    'tdd-guideline.md',
+];
+/**
+ * Project-specific templates that should be preserved
+ */
+const PROJECT_SPECIFIC_DOCS = [
+    'product.md',
+    'tech.md',
+    'structure.md',
+];
+/**
+ * Parse command line arguments
+ */
+function parseArgs(args) {
+    let projectPath = process.cwd();
+    let dryRun = false;
+    let force = false;
+    let showHelp = false;
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case '--path':
+                projectPath = path.resolve(args[++i] || '.');
+                break;
+            case '--dry-run':
+            case '-n':
+                dryRun = true;
+                break;
+            case '--force':
+            case '-f':
+                force = true;
+                break;
+            case '--help':
+            case '-h':
+                showHelp = true;
+                break;
+        }
+    }
+    return { projectPath, dryRun, force, showHelp };
+}
+/**
+ * Get all files in a directory recursively
+ */
+function getAllFiles(dir) {
+    const files = [];
+    if (!fs.existsSync(dir))
+        return files;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...getAllFiles(fullPath));
+        }
+        else {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+/**
+ * Check if a steering directory has static docs that need migration
+ */
+function detectOldStructure(steeringPath) {
+    const staticDocs = [];
+    const projectDocs = [];
+    const otherDocs = [];
+    if (!fs.existsSync(steeringPath)) {
+        return { hasStaticDocs: false, staticDocs, projectDocs, otherDocs };
+    }
+    const entries = fs.readdirSync(steeringPath);
+    for (const entry of entries) {
+        if (!entry.endsWith('.md'))
+            continue;
+        if (STATIC_STEERING_DOCS.includes(entry)) {
+            staticDocs.push(entry);
+        }
+        else if (PROJECT_SPECIFIC_DOCS.includes(entry)) {
+            projectDocs.push(entry);
+        }
+        else {
+            otherDocs.push(entry);
+        }
+    }
+    return {
+        hasStaticDocs: staticDocs.length > 0,
+        staticDocs,
+        projectDocs,
+        otherDocs,
+    };
+}
+/**
+ * Create backup of steering directory
+ */
+function backupSteering(steeringPath, backupPath, dryRun) {
+    if (dryRun) {
+        console.log(`   Would backup: ${steeringPath} → ${backupPath}`);
+        return;
+    }
+    // If backup already exists, add timestamp
+    let finalBackupPath = backupPath;
+    if (fs.existsSync(backupPath)) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        finalBackupPath = `${backupPath}-${timestamp}`;
+    }
+    // Copy all files to backup
+    fs.mkdirSync(finalBackupPath, { recursive: true });
+    const files = getAllFiles(steeringPath);
+    for (const file of files) {
+        const rel = path.relative(steeringPath, file);
+        const destFile = path.join(finalBackupPath, rel);
+        fs.mkdirSync(path.dirname(destFile), { recursive: true });
+        fs.copyFileSync(file, destFile);
+    }
+    console.log(`   ✓ Backed up to: ${finalBackupPath}`);
+}
+/**
+ * Remove static steering documents
+ */
+function removeStaticDocs(steeringPath, staticDocs, dryRun) {
+    for (const doc of staticDocs) {
+        const docPath = path.join(steeringPath, doc);
+        if (dryRun) {
+            console.log(`   Would remove: ${doc}`);
+        }
+        else {
+            if (fs.existsSync(docPath)) {
+                fs.unlinkSync(docPath);
+                console.log(`   ✓ Removed: ${doc}`);
+            }
+        }
+    }
+}
+/**
+ * Main migration function
+ */
+export async function main() {
+    const args = process.argv.slice(2);
+    const { projectPath, dryRun, force, showHelp } = parseArgs(args);
+    if (showHelp) {
+        console.log(HELP);
+        return;
+    }
+    const steeringPath = path.join(projectPath, '.spec', 'steering');
+    const backupPath = path.join(projectPath, '.spec', 'steering.backup');
+    console.log('\n🔄 SDD Steering Migration (v3.1)\n');
+    // Check if .spec/steering exists
+    if (!fs.existsSync(steeringPath)) {
+        console.log('ℹ️  No .spec/steering directory found. Nothing to migrate.\n');
+        console.log('   If this is a new project, run: npx sdd-mcp-server install\n');
+        return;
+    }
+    // Detect structure
+    const { hasStaticDocs, staticDocs, projectDocs, otherDocs } = detectOldStructure(steeringPath);
+    if (!hasStaticDocs) {
+        console.log('✅ No static steering documents found. Already migrated or clean install.\n');
+        if (projectDocs.length > 0) {
+            console.log('   Project-specific documents preserved:');
+            for (const doc of projectDocs) {
+                console.log(`     • ${doc}`);
+            }
+            console.log('');
+        }
+        return;
+    }
+    // Display what will happen
+    console.log('📋 Migration Plan:\n');
+    console.log('   Static documents to remove (merged into components):');
+    for (const doc of staticDocs) {
+        const mergedInto = getMergeTarget(doc);
+        console.log(`     • ${doc} → ${mergedInto}`);
+    }
+    console.log('');
+    if (projectDocs.length > 0) {
+        console.log('   Project-specific documents to preserve:');
+        for (const doc of projectDocs) {
+            console.log(`     • ${doc}`);
+        }
+        console.log('');
+    }
+    if (otherDocs.length > 0) {
+        console.log('   Other documents (will be preserved):');
+        for (const doc of otherDocs) {
+            console.log(`     • ${doc}`);
+        }
+        console.log('');
+    }
+    if (dryRun) {
+        console.log('🔍 DRY RUN - No changes will be made.\n');
+    }
+    // Backup
+    console.log('📦 Backup:\n');
+    backupSteering(steeringPath, backupPath, dryRun);
+    console.log('');
+    // Remove static docs
+    console.log('🗑️  Removing static documents:\n');
+    removeStaticDocs(steeringPath, staticDocs, dryRun);
+    console.log('');
+    // Summary
+    if (dryRun) {
+        console.log('✅ Preview complete. Run without --dry-run to apply changes.\n');
+    }
+    else {
+        console.log('✅ Migration complete!\n');
+        console.log('   The static steering content now lives in:');
+        console.log('     • .claude/rules/coding-style.md (SOLID, DRY, KISS, YAGNI)');
+        console.log('     • .claude/agents/reviewer.md (Linus-style review)');
+        console.log('     • .claude/agents/tdd-guide.md (TDD methodology)');
+        console.log('     • .claude/agents/security-auditor.md (OWASP Top 10)');
+        console.log('     • .claude/skills/sdd-commit/SKILL.md (Commit format)\n');
+        console.log('   To update .claude/ components, run: npx sdd-mcp-server install\n');
+    }
+}
+/**
+ * Get the merge target description for a static doc
+ */
+function getMergeTarget(doc) {
+    const targets = {
+        'AGENTS.md': '(removed - meta documentation)',
+        'commit.md': 'skills/sdd-commit/SKILL.md',
+        'linus-review.md': 'agents/reviewer.md',
+        'owasp-top10-check.md': 'agents/security-auditor.md',
+        'principles.md': 'rules/coding-style.md',
+        'tdd-guideline.md': 'agents/tdd-guide.md',
+    };
+    return targets[doc] || '(unknown)';
+}
+// ESM main module detection
+const isMainModule = process.argv[1] && (process.argv[1].endsWith('/migrate-steering.js') ||
+    process.argv[1].endsWith('/migrate-steering.ts') ||
+    process.argv[1].endsWith('\\migrate-steering.js') ||
+    process.argv[1].endsWith('\\migrate-steering.ts'));
+if (isMainModule) {
+    main().catch((error) => {
+        console.error('Error:', error.message);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=migrate-steering.js.map

package/dist/cli/migrate-steering.js.map

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

package/dist/cli/sdd-mcp-cli.js

@@ -10,6 +10,7 @@
  */
 import { main as installSkillsMain, mainInstall as installMain } from './install-skills.js';
 import { main as migrateKiroMain } from './migrate-kiro.js';
+import { main as migrateSteeringMain } from './migrate-steering.js';
 const HELP = `
 SDD MCP CLI
 
@@ -19,6 +20,7 @@ Commands:
   install           Install SDD skills AND steering documents (recommended)
   install-skills    Install SDD skills only (legacy)
   migrate-kiro      Migrate .kiro directory to .spec (v2.1.0+)
+  migrate-steering  Migrate steering docs to consolidated components (v3.1.0+)
 
 Options:
   --help, -h        Show this help message
@@ -32,6 +34,8 @@ Examples:
   npx sdd-mcp-server install-skills --list       # List available skills
   npx sdd-mcp-server migrate-kiro                # Migrate .kiro to .spec
   npx sdd-mcp-server migrate-kiro --dry-run      # Preview migration
+  npx sdd-mcp-server migrate-steering            # Migrate static steering docs
+  npx sdd-mcp-server migrate-steering --dry-run  # Preview steering migration
 
 Running without a command starts the MCP server (for IDE integrations).
 `;
@@ -58,6 +62,11 @@ async function main() {
             process.argv = [process.argv[0], process.argv[1], ...args.slice(1)];
             await migrateKiroMain();
             break;
+        case 'migrate-steering':
+            // Remove the command from args and pass the rest to migrate-steering
+            process.argv = [process.argv[0], process.argv[1], ...args.slice(1)];
+            await migrateSteeringMain();
+            break;
         default:
             console.error(`Unknown command: ${command}`);
             console.log(HELP);

package/dist/cli/sdd-mcp-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdd-mcp-cli.js","sourceRoot":"","sources":["../../src/cli/sdd-mcp-cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,IAAI,iBAAiB,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBZ,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,qDAAqD;YACrD,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QAER,KAAK,gBAAgB;YACnB,8BAA8B;YAC9B,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,MAAM,iBAAiB,EAAE,CAAC;YAC1B,MAAM;QAER,KAAK,cAAc;YACjB,iEAAiE;YACjE,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,MAAM,eAAe,EAAE,CAAC;YACxB,MAAM;QAER;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"sdd-mcp-cli.js","sourceRoot":"","sources":["../../src/cli/sdd-mcp-cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,IAAI,iBAAiB,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,IAAI,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BZ,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,qDAAqD;YACrD,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QAER,KAAK,gBAAgB;YACnB,8BAA8B;YAC9B,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,MAAM,iBAAiB,EAAE,CAAC;YAC1B,MAAM;QAER,KAAK,cAAc;YACjB,iEAAiE;YACjE,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,MAAM,eAAe,EAAE,CAAC;YACxB,MAAM;QAER,KAAK,kBAAkB;YACrB,qEAAqE;YACrE,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,MAAM,mBAAmB,EAAE,CAAC;YAC5B,MAAM;QAER;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/hooks/post-tool-use/log-tool-execution.md

@@ -0,0 +1,51 @@
+---
+name: log-tool-execution
+description: Logs all tool executions for debugging and audit purposes
+event: post-tool-use
+priority: 50
+enabled: false
+---
+
+# Log Tool Execution Hook
+
+This hook logs all tool executions to a local log file for debugging and auditing.
+
+## Purpose
+
+- **Debugging** - Trace issues by reviewing tool invocation history
+- **Auditing** - Track what actions were taken during a session
+- **Learning** - Analyze patterns in tool usage over time
+
+## Log Format
+
+```
+[2024-01-15T10:30:00.000Z] TOOL_EXEC
+  tool: sdd-requirements
+  feature: user-authentication
+  duration: 1250ms
+  status: success
+  output_files:
+    - .spec/specs/user-authentication/requirements.md
+```
+
+## Log Location
+
+Logs are written to:
+- Default: `.sdd/logs/tool-execution.log`
+- Configurable via `SDD_LOG_PATH` environment variable
+
+## Configuration
+
+```yaml
+# In .sdd/config.yaml
+hooks:
+  log-tool-execution:
+    enabled: true
+    log_level: info  # debug, info, warn, error
+    max_log_size: 10MB
+    retain_days: 30
+```
+
+## Note
+
+This hook is disabled by default to avoid unnecessary disk I/O during normal development. Enable it when debugging or for compliance requirements.

package/hooks/post-tool-use/update-spec-status.md

@@ -0,0 +1,50 @@
+---
+name: update-spec-status
+description: Automatically updates spec.json status after SDD tool completion
+event: post-tool-use
+priority: 100
+enabled: true
+---
+
+# Update Spec Status Hook
+
+This hook automatically updates the spec.json file after SDD workflow tools complete successfully.
+
+## Trigger Conditions
+
+Triggered after these tools complete successfully:
+- `sdd-init` - Sets status to "initialized"
+- `sdd-requirements` - Sets requirements phase to "generated"
+- `sdd-approve requirements` - Sets requirements phase to "approved"
+- `sdd-design` - Sets design phase to "generated"
+- `sdd-approve design` - Sets design phase to "approved"
+- `sdd-tasks` - Sets tasks phase to "generated"
+- `sdd-approve tasks` - Sets tasks phase to "approved"
+- `sdd-implement` - Updates task completion status
+
+## Status Updates
+
+```json
+{
+  "workflow_status": {
+    "current_phase": "design",
+    "phases": {
+      "requirements": {
+        "status": "approved",
+        "completed_at": "2024-01-15T10:30:00Z"
+      },
+      "design": {
+        "status": "in_progress",
+        "started_at": "2024-01-15T11:00:00Z"
+      }
+    }
+  }
+}
+```
+
+## Benefits
+
+1. **Audit Trail** - Track when each phase was completed
+2. **Workflow Validation** - Enable pre-tool-use hooks to validate phase order
+3. **Progress Visibility** - Show current workflow status in sdd-status
+4. **Automation** - Enable CI/CD integration based on spec status

package/hooks/pre-tool-use/check-test-coverage.md

@@ -0,0 +1,51 @@
+---
+name: check-test-coverage
+description: Reminds developers to write tests first when implementing features
+event: pre-tool-use
+priority: 90
+enabled: true
+---
+
+# Check Test Coverage Hook
+
+This hook promotes TDD by reminding developers to write tests before implementation.
+
+## Trigger Conditions
+
+Triggered before code modification tools:
+- File writes to `src/**/*.ts` (excluding test files)
+- Code generation requests
+- Implementation-related tool calls
+
+## Validation Logic
+
+```
+IF modifying source file (not test file) THEN
+  CHECK if corresponding test file exists
+  IF no test file THEN
+    WARN about TDD best practice
+    SUGGEST creating test file first
+```
+
+## Example Prompt
+
+```
+🧪 TDD Reminder
+
+You're about to modify 'src/services/UserService.ts' but no
+corresponding test file was found.
+
+Consider creating 'src/__tests__/services/UserService.test.ts'
+first and writing failing tests for the expected behavior.
+
+TDD Flow:
+1. Write failing test (Red)
+2. Implement code to pass test (Green)
+3. Refactor for quality (Refactor)
+```
+
+## Configuration
+
+This hook can be configured via environment variables:
+- `SDD_TDD_STRICT=true` - Block modifications without tests
+- `SDD_TDD_REMINDER=true` - Show reminder but allow proceeding (default)

package/hooks/pre-tool-use/validate-sdd-workflow.md

@@ -0,0 +1,55 @@
+---
+name: validate-sdd-workflow
+description: Validates that SDD workflow phases are followed in correct order
+event: pre-tool-use
+priority: 100
+enabled: true
+---
+
+# Validate SDD Workflow Hook
+
+This hook validates that the SDD workflow phases are being followed correctly before tool invocation.
+
+## Trigger Conditions
+
+Triggered before these tools are invoked:
+- `sdd-design` (requires `sdd-requirements` to be completed first)
+- `sdd-tasks` (requires `sdd-design` to be completed first)
+- `sdd-implement` (requires `sdd-tasks` to be completed first)
+
+## Validation Logic
+
+```
+IF tool == 'sdd-design' THEN
+  CHECK that requirements.md exists and is approved
+  CHECK that spec.json shows requirements phase completed
+
+IF tool == 'sdd-tasks' THEN
+  CHECK that design.md exists and is approved
+  CHECK that spec.json shows design phase completed
+
+IF tool == 'sdd-implement' THEN
+  CHECK that tasks.md exists
+  CHECK that spec.json shows tasks phase completed
+```
+
+## On Validation Failure
+
+If validation fails:
+1. Display warning message explaining which phase is missing
+2. Suggest running the correct phase first
+3. Allow override with explicit `--skip-validation` flag
+
+## Example Warning
+
+```
+⚠️ SDD Workflow Violation
+
+You're attempting to run 'sdd-design' but the requirements phase
+has not been completed yet.
+
+Please run 'sdd-requirements' first to generate the requirements
+document, then have it reviewed and approved before proceeding.
+
+To skip this check: sdd-design --skip-validation
+```

package/hooks/session-end/remind-uncommitted-changes.md

@@ -0,0 +1,58 @@
+---
+name: remind-uncommitted-changes
+description: Reminds developer of uncommitted changes before ending session
+event: session-end
+priority: 90
+enabled: true
+---
+
+# Remind Uncommitted Changes Hook
+
+This hook checks for uncommitted changes and reminds the developer before the session ends.
+
+## Actions
+
+1. **Check Git Status**
+   - Detect uncommitted changes
+   - Identify untracked files
+   - Check for stashed changes
+
+2. **Display Warning**
+   ```
+   ⚠️ Uncommitted Changes Detected
+
+   You have changes that haven't been committed:
+
+   Modified:
+     • src/hooks/HookLoader.ts
+     • src/__tests__/hooks/HookLoader.test.ts
+
+   Untracked:
+     • hooks/pre-tool-use/validate-sdd-workflow.md
+
+   Consider committing your changes before ending the session.
+   Run: /sdd-commit to create a commit with proper message
+   ```
+
+3. **Suggest Actions**
+   - Offer to run commit command
+   - Show diff summary
+   - Remind about push to remote
+
+## Configuration
+
+```yaml
+# In .sdd/config.yaml
+hooks:
+  remind-uncommitted-changes:
+    enabled: true
+    include_untracked: true
+    warn_large_diff: true
+    large_diff_threshold: 500  # lines
+```
+
+## Benefits
+
+- **Prevent Lost Work** - Don't lose changes between sessions
+- **Clean State** - End sessions with clean working directory
+- **Team Sync** - Remind to push for team visibility