sdd-mcp-server 2.1.0 → 2.2.0

package/dist/cli/install-skills.js

@@ -11,14 +11,18 @@ const __dirname = path.dirname(__filename);
  */
 export class InstallSkillsCLI {
     skillManager;
+    steeringPath;
     /**
      * Create CLI instance
      * @param skillsPath - Optional path to skills directory (for testing)
+     * @param steeringPath - Optional path to steering directory (for testing)
      */
-    constructor(skillsPath) {
+    constructor(skillsPath, steeringPath) {
         // If no path provided, determine from package location
-        const resolvedPath = skillsPath || this.getDefaultSkillsPath();
-        this.skillManager = new SkillManager(resolvedPath);
+        const resolvedSkillsPath = skillsPath || this.getDefaultSkillsPath();
+        const resolvedSteeringPath = steeringPath || this.getDefaultSteeringPath();
+        this.skillManager = new SkillManager(resolvedSkillsPath);
+        this.steeringPath = resolvedSteeringPath;
     }
     /**
      * Get the default skills path based on package location
@@ -45,6 +49,31 @@ export class InstallSkillsCLI {
         // Fallback to first path (will error in SkillManager if not found)
         return possiblePaths[0];
     }
+    /**
+     * Get the default steering path based on package location
+     */
+    getDefaultSteeringPath() {
+        // Try multiple paths and return the first one that exists
+        const possiblePaths = [
+            // Relative to this file (dist/cli/install-skills.js -> steering/)
+            path.resolve(__dirname, '../../steering'),
+            // Alternative: one level up
+            path.resolve(__dirname, '../steering'),
+            // From package root when installed globally or via npx
+            path.resolve(__dirname, '../../../steering'),
+            // From current working directory
+            path.resolve(process.cwd(), 'node_modules/sdd-mcp-server/steering'),
+            path.resolve(process.cwd(), 'steering'),
+        ];
+        // Return the first path that exists
+        for (const p of possiblePaths) {
+            if (fs.existsSync(p)) {
+                return p;
+            }
+        }
+        // Fallback to first path
+        return possiblePaths[0];
+    }
     /**
      * Parse command line arguments
      * @param args - Command line arguments (process.argv.slice(2))
@@ -53,8 +82,11 @@ export class InstallSkillsCLI {
     parseArgs(args) {
         const options = {
             targetPath: '.claude/skills',
+            steeringPath: '.spec/steering',
             listOnly: false,
             showHelp: false,
+            skillsOnly: false,
+            steeringOnly: false,
         };
         for (let i = 0; i < args.length; i++) {
             const arg = args[i];
@@ -64,6 +96,11 @@ export class InstallSkillsCLI {
                         options.targetPath = args[++i];
                     }
                     break;
+                case '--steering-path':
+                    if (i + 1 < args.length) {
+                        options.steeringPath = args[++i];
+                    }
+                    break;
                 case '--list':
                 case '-l':
                     options.listOnly = true;
@@ -72,12 +109,18 @@ export class InstallSkillsCLI {
                 case '-h':
                     options.showHelp = true;
                     break;
+                case '--skills':
+                    options.skillsOnly = true;
+                    break;
+                case '--steering':
+                    options.steeringOnly = true;
+                    break;
             }
         }
         return options;
     }
     /**
-     * Run the CLI with given options
+     * Run the CLI with given options (legacy skills-only mode)
      * @param options - CLI options
      */
     async run(options) {
@@ -91,6 +134,29 @@ export class InstallSkillsCLI {
         }
         await this.installSkills(options.targetPath);
     }
+    /**
+     * Run unified install (skills + steering)
+     * @param options - CLI options
+     */
+    async runUnified(options) {
+        if (options.showHelp) {
+            console.log(this.getUnifiedHelp());
+            return;
+        }
+        if (options.listOnly) {
+            await this.listAll();
+            return;
+        }
+        // Determine what to install
+        const installSkills = !options.steeringOnly;
+        const installSteering = !options.skillsOnly;
+        if (installSkills) {
+            await this.installSkills(options.targetPath);
+        }
+        if (installSteering) {
+            await this.installSteering(options.steeringPath);
+        }
+    }
     /**
      * List available skills
      */
@@ -111,6 +177,56 @@ export class InstallSkillsCLI {
         console.log(`Total: ${skills.length} skills\n`);
         console.log('Run "npx sdd-mcp install-skills" to install all skills.\n');
     }
+    /**
+     * List available steering documents
+     */
+    async listSteering() {
+        const steeringDocs = [];
+        try {
+            const entries = await fs.promises.readdir(this.steeringPath);
+            for (const entry of entries) {
+                if (entry.endsWith('.md')) {
+                    steeringDocs.push(entry);
+                }
+            }
+        }
+        catch {
+            // Return empty array if steering directory doesn't exist
+        }
+        return steeringDocs;
+    }
+    /**
+     * List all available skills and steering documents
+     */
+    async listAll() {
+        const skills = await this.skillManager.listSkills();
+        const steeringDocs = await this.listSteering();
+        console.log('\n📚 Available Skills:\n');
+        if (skills.length === 0) {
+            console.log('  (none)\n');
+        }
+        else {
+            for (const skill of skills) {
+                console.log(`  • ${skill.name}`);
+                if (skill.description) {
+                    console.log(`    ${skill.description}`);
+                }
+                console.log('');
+            }
+            console.log(`  Total: ${skills.length} skills\n`);
+        }
+        console.log('📄 Available Steering Documents:\n');
+        if (steeringDocs.length === 0) {
+            console.log('  (none)\n');
+        }
+        else {
+            for (const doc of steeringDocs) {
+                console.log(`  • ${doc}`);
+            }
+            console.log(`\n  Total: ${steeringDocs.length} steering documents\n`);
+        }
+        console.log('Run "npx sdd-mcp install" to install all skills and steering documents.\n');
+    }
     /**
      * Install skills to target directory
      * @param targetPath - Target directory
@@ -138,6 +254,60 @@ export class InstallSkillsCLI {
             console.log('   Use /sdd-requirements, /sdd-design, etc. in Claude Code.\n');
         }
     }
+    /**
+     * Install steering documents to target directory
+     * @param targetPath - Target directory (e.g., .spec/steering)
+     */
+    async installSteering(targetPath) {
+        console.log(`\n📄 Installing steering documents to: ${targetPath}\n`);
+        const installed = [];
+        const failed = [];
+        try {
+            // Create target directory
+            await fs.promises.mkdir(targetPath, { recursive: true });
+            // Read source steering directory
+            const entries = await fs.promises.readdir(this.steeringPath);
+            for (const entry of entries) {
+                if (entry.endsWith('.md')) {
+                    try {
+                        const sourceFile = path.join(this.steeringPath, entry);
+                        const destFile = path.join(targetPath, entry);
+                        await fs.promises.copyFile(sourceFile, destFile);
+                        installed.push(entry);
+                    }
+                    catch (error) {
+                        failed.push({
+                            name: entry,
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error(`❌ Failed to read steering directory: ${error instanceof Error ? error.message : String(error)}`);
+            return;
+        }
+        if (installed.length > 0) {
+            const plural = installed.length === 1 ? 'document' : 'documents';
+            console.log(`✅ Installed ${installed.length} steering ${plural}:`);
+            for (const name of installed) {
+                console.log(`   • ${name}`);
+            }
+            console.log('');
+        }
+        if (failed.length > 0) {
+            console.error(`❌ Failed to install ${failed.length} document(s):`);
+            for (const failure of failed) {
+                console.error(`   • ${failure.name}: ${failure.error}`);
+            }
+            console.log('');
+        }
+        if (installed.length > 0) {
+            console.log('🎉 Steering documents installed successfully!');
+            console.log('   These provide project-wide guidance for AI interactions.\n');
+        }
+    }
     /**
      * Get help text
      * @returns Help message
@@ -166,15 +336,61 @@ After installation, you can use them in Claude Code with:
   /sdd-implement <feature-name>
   /sdd-steering
   /sdd-commit
+`;
+    }
+    /**
+     * Get unified install help text
+     * @returns Help message for unified install
+     */
+    getUnifiedHelp() {
+        return `
+SDD Unified Installer
+
+Usage: npx sdd-mcp install [options]
+
+Installs both SDD skills and steering documents to your project.
+
+Options:
+  --skills              Install skills only (to .claude/skills)
+  --steering            Install steering documents only (to .spec/steering)
+  --path <dir>          Target directory for skills (default: .claude/skills)
+  --steering-path <dir> Target directory for steering (default: .spec/steering)
+  --list, -l            List available skills and steering documents
+  --help, -h            Show this help message
+
+Examples:
+  npx sdd-mcp install                     # Install both skills and steering
+  npx sdd-mcp install --skills            # Install skills only
+  npx sdd-mcp install --steering          # Install steering only
+  npx sdd-mcp install --list              # List available content
+
+Skills are installed to .claude/skills/ and provide workflow guidance.
+Steering documents are installed to .spec/steering/ and provide project-wide rules.
+
+After installation, use skills in Claude Code:
+  /sdd-requirements <feature-name>
+  /sdd-design <feature-name>
+  /sdd-tasks <feature-name>
+  /sdd-implement <feature-name>
+  /sdd-steering
+  /sdd-commit
+
+Steering documents are automatically loaded by the SDD MCP server.
 `;
     }
 }
-// Main entry point when run directly
+// Main entry point when run directly (legacy install-skills)
 export async function main() {
     const cli = new InstallSkillsCLI();
     const options = cli.parseArgs(process.argv.slice(2));
     await cli.run(options);
 }
+// Main entry point for unified install command
+export async function mainInstall() {
+    const cli = new InstallSkillsCLI();
+    const options = cli.parseArgs(process.argv.slice(2));
+    await cli.runUnified(options);
+}
 // ESM main module detection: check if this file is the entry point
 const isMainModule = process.argv[1] && (process.argv[1] === __filename ||
     process.argv[1].endsWith('/install-skills.js') ||

package/dist/cli/install-skills.js.map

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

package/dist/cli/sdd-mcp-cli.d.ts

@@ -3,7 +3,8 @@
  * Main CLI entry point for sdd-mcp commands
  *
  * Usage:
- *   npx sdd-mcp install-skills [options]
+ *   npx sdd-mcp install [options]           # Install skills AND steering (unified)
+ *   npx sdd-mcp install-skills [options]    # Install skills only (legacy)
  *   npx sdd-mcp migrate-kiro [options]
  *   npx sdd-mcp --help
  */

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

@@ -3,11 +3,12 @@
  * Main CLI entry point for sdd-mcp commands
  *
  * Usage:
- *   npx sdd-mcp install-skills [options]
+ *   npx sdd-mcp install [options]           # Install skills AND steering (unified)
+ *   npx sdd-mcp install-skills [options]    # Install skills only (legacy)
  *   npx sdd-mcp migrate-kiro [options]
  *   npx sdd-mcp --help
  */
-import { main as installSkillsMain } from './install-skills.js';
+import { main as installSkillsMain, mainInstall as installMain } from './install-skills.js';
 import { main as migrateKiroMain } from './migrate-kiro.js';
 const HELP = `
 SDD MCP CLI
@@ -15,16 +16,20 @@ SDD MCP CLI
 Usage: npx sdd-mcp <command> [options]
 
 Commands:
-  install-skills    Install SDD skills to your project
+  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+)
 
 Options:
   --help, -h        Show this help message
 
 Examples:
-  npx sdd-mcp install-skills              # Install to .claude/skills
+  npx sdd-mcp install                     # Install skills to .claude/skills + steering to .spec/steering
+  npx sdd-mcp install --skills            # Install skills only
+  npx sdd-mcp install --steering          # Install steering only
+  npx sdd-mcp install --list              # List available skills and steering docs
+  npx sdd-mcp install-skills              # Legacy: Install skills to .claude/skills
   npx sdd-mcp install-skills --list       # List available skills
-  npx sdd-mcp install-skills --path ./    # Install to custom path
   npx sdd-mcp migrate-kiro                # Migrate .kiro to .spec
   npx sdd-mcp migrate-kiro --dry-run      # Preview migration
 
@@ -38,8 +43,13 @@ async function main() {
         process.exit(0);
     }
     switch (command) {
+        case 'install':
+            // Unified install command - both skills and steering
+            process.argv = [process.argv[0], process.argv[1], ...args.slice(1)];
+            await installMain();
+            break;
         case 'install-skills':
-            // Remove the command from args and pass the rest to install-skills
+            // Legacy: Install skills only
             process.argv = [process.argv[0], process.argv[1], ...args.slice(1)];
             await installSkillsMain();
             break;

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;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;CAoBZ,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,gBAAgB;YACnB,mEAAmE;YACnE,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;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"}

package/dist/utils/atomicWrite.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Atomic file write utility
+ * 原子性檔案寫入工具
+ *
+ * Prevents file corruption when write operations are interrupted (crash, kill signal).
+ * Uses the temp-file + rename pattern which is atomic on POSIX systems.
+ * 防止寫入操作被中斷時（crash、kill signal）造成檔案損壞。
+ * 使用 temp-file + rename 模式，在 POSIX 系統上是原子操作。
+ *
+ * @note Windows Limitation / Windows 限制:
+ *   On Windows, fs.rename() may fail with EEXIST if target exists.
+ *   For Windows production use, consider using 'write-file-atomic' package.
+ *   在 Windows 上，若目標檔案存在，fs.rename() 可能會失敗。
+ *   若需在 Windows 生產環境使用，建議改用 'write-file-atomic' 套件。
+ *
+ * @module utils/atomicWrite
+ */
+/**
+ * Write content to a file atomically.
+ *
+ * This function writes to a temporary file first, then renames it to the target path.
+ * The rename operation is atomic on POSIX systems, ensuring the file is never left
+ * in a corrupted state.
+ *
+ * @param filePath - The target file path
+ * @param content - The content to write
+ * @param options - Optional write options
+ * @returns Promise that resolves when write is complete
+ *
+ * @example
+ * ```typescript
+ * await atomicWriteFile('/path/to/spec.json', JSON.stringify(data, null, 2));
+ * ```
+ */
+export declare function atomicWriteFile(filePath: string, content: string, options?: {
+    encoding?: BufferEncoding;
+}): Promise<void>;
+/**
+ * Write JSON content to a file atomically.
+ *
+ * Convenience wrapper that handles JSON serialization with pretty printing.
+ *
+ * @param filePath - The target file path
+ * @param data - The data to serialize and write
+ * @param options - Optional options (indent spaces, default 2)
+ * @returns Promise that resolves when write is complete
+ *
+ * @example
+ * ```typescript
+ * await atomicWriteJSON('/path/to/spec.json', specData);
+ * ```
+ */
+export declare function atomicWriteJSON(filePath: string, data: unknown, options?: {
+    indent?: number;
+}): Promise<void>;

package/dist/utils/atomicWrite.js

@@ -0,0 +1,84 @@
+/**
+ * Atomic file write utility
+ * 原子性檔案寫入工具
+ *
+ * Prevents file corruption when write operations are interrupted (crash, kill signal).
+ * Uses the temp-file + rename pattern which is atomic on POSIX systems.
+ * 防止寫入操作被中斷時（crash、kill signal）造成檔案損壞。
+ * 使用 temp-file + rename 模式，在 POSIX 系統上是原子操作。
+ *
+ * @note Windows Limitation / Windows 限制:
+ *   On Windows, fs.rename() may fail with EEXIST if target exists.
+ *   For Windows production use, consider using 'write-file-atomic' package.
+ *   在 Windows 上，若目標檔案存在，fs.rename() 可能會失敗。
+ *   若需在 Windows 生產環境使用，建議改用 'write-file-atomic' 套件。
+ *
+ * @module utils/atomicWrite
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+/**
+ * Write content to a file atomically.
+ *
+ * This function writes to a temporary file first, then renames it to the target path.
+ * The rename operation is atomic on POSIX systems, ensuring the file is never left
+ * in a corrupted state.
+ *
+ * @param filePath - The target file path
+ * @param content - The content to write
+ * @param options - Optional write options
+ * @returns Promise that resolves when write is complete
+ *
+ * @example
+ * ```typescript
+ * await atomicWriteFile('/path/to/spec.json', JSON.stringify(data, null, 2));
+ * ```
+ */
+export async function atomicWriteFile(filePath, content, options) {
+    const encoding = options?.encoding ?? "utf8";
+    const dir = path.dirname(filePath);
+    const filename = path.basename(filePath);
+    // Create temp file path with process ID, timestamp, and random suffix for uniqueness
+    // Random suffix prevents collisions when multiple writes occur within the same millisecond
+    const uniqueSuffix = `${Date.now()}.${Math.random().toString(36).slice(2, 10)}`;
+    const tempPath = path.join(dir, `.${filename}.${process.pid}.${uniqueSuffix}.tmp`);
+    try {
+        // Ensure directory exists
+        await fs.mkdir(dir, { recursive: true });
+        // Write to temp file
+        await fs.writeFile(tempPath, content, encoding);
+        // Atomic rename (on POSIX systems)
+        await fs.rename(tempPath, filePath);
+    }
+    catch (error) {
+        // Clean up temp file if it exists
+        try {
+            await fs.unlink(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+}
+/**
+ * Write JSON content to a file atomically.
+ *
+ * Convenience wrapper that handles JSON serialization with pretty printing.
+ *
+ * @param filePath - The target file path
+ * @param data - The data to serialize and write
+ * @param options - Optional options (indent spaces, default 2)
+ * @returns Promise that resolves when write is complete
+ *
+ * @example
+ * ```typescript
+ * await atomicWriteJSON('/path/to/spec.json', specData);
+ * ```
+ */
+export async function atomicWriteJSON(filePath, data, options) {
+    const indent = options?.indent ?? 2;
+    const content = JSON.stringify(data, null, indent);
+    await atomicWriteFile(filePath, content);
+}
+//# sourceMappingURL=atomicWrite.js.map

package/dist/utils/atomicWrite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomicWrite.js","sourceRoot":"","sources":["../../src/utils/atomicWrite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAAe,EACf,OAAuC;IAEvC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,MAAM,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEzC,qFAAqF;IACrF,2FAA2F;IAC3F,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,IAAI,OAAO,CAAC,GAAG,IAAI,YAAY,MAAM,CAAC,CAAC;IAEnF,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,qBAAqB;QACrB,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEhD,mCAAmC;QACnC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kCAAkC;QAClC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,IAAa,EACb,OAA6B;IAE7B,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/mcp-server.js

@@ -10,6 +10,7 @@ import {
   generateTechDocument,
   generateStructureDocument,
 } from "./documentGenerator.js";
+import { atomicWriteJSON } from "./atomicWrite.js";
 
 // Best-effort dynamic loader for spec generators (requirements/design/tasks)
 async function loadSpecGenerator() {
@@ -551,7 +552,7 @@ server.registerTool(
       spec.approvals.requirements.generated = true;
       spec.updated_at = await getCurrentTimestamp();
 
-      await fs.writeFile(specPath, JSON.stringify(spec, null, 2));
+      await atomicWriteJSON(specPath, spec);
 
       return {
         content: [
@@ -633,7 +634,7 @@ server.registerTool(
       spec.approvals.design.generated = true;
       spec.updated_at = await getCurrentTimestamp();
 
-      await fs.writeFile(specPath, JSON.stringify(spec, null, 2));
+      await atomicWriteJSON(specPath, spec);
 
       return {
         content: [
@@ -771,7 +772,7 @@ ${designContext.substring(0, 1000)}${designContext.length > 1000 ? "...\n[Design
       spec.ready_for_implementation = true;
       spec.updated_at = await getCurrentTimestamp();
 
-      await fs.writeFile(specPath, JSON.stringify(spec, null, 2));
+      await atomicWriteJSON(specPath, spec);
 
       return {
         content: [
@@ -1034,7 +1035,7 @@ server.registerTool(
       spec.approvals[phase].approved = true;
       spec.updated_at = await getCurrentTimestamp();
 
-      await fs.writeFile(specPath, JSON.stringify(spec, null, 2));
+      await atomicWriteJSON(specPath, spec);
 
       return {
         content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-mcp-server",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "MCP server for spec-driven development workflows across AI-agent CLIs and IDEs",
   "main": "dist/index.js",
   "bin": {
@@ -12,7 +12,9 @@
   "files": [
     "dist/**/*",
     "skills/**/*",
+    "steering/**/*",
     "mcp-server.js",
+    "atomicWrite.js",
     "documentGenerator.js",
     "specGenerator.js",
     "README.md",

package/skills/sdd-commit/SKILL.md

@@ -271,6 +271,20 @@ git rebase origin/main
 git push origin feature/AUTH-123-jwt-auth
 ```
 
+## Steering Document References
+
+Apply these steering documents for commits and PRs:
+
+| Document | Purpose | Key Application |
+|----------|---------|-----------------|
+| `.spec/steering/commit.md` | Commit message conventions | Follow type prefixes, scope, and format guidelines |
+
+**Key Commit Rules:**
+1. Use type prefixes: `feat`, `fix`, `docs`, `refactor`, `test`, etc.
+2. Keep subject line under 72 characters
+3. Use imperative mood ("add" not "added")
+4. Reference issues in footer
+
 ## Quality Checklist
 
 - [ ] Commit message follows format

package/skills/sdd-design/SKILL.md

@@ -248,6 +248,21 @@ Before finalizing, validate against these principles:
 | `sdd-validate-design` | Perform GO/NO-GO review |
 | `sdd-approve` | Mark design phase as approved |
 
+## Steering Document References
+
+Apply these steering documents during design:
+
+| Document | Purpose | Key Application |
+|----------|---------|-----------------|
+| `.spec/steering/principles.md` | SOLID, DRY, KISS, YAGNI | Apply SOLID principles to component design, ensure interfaces follow ISP and DIP |
+| `.spec/steering/linus-review.md` | Code quality, data structures | Focus on data structures first, eliminate special cases, ensure backward compatibility |
+
+**Key Linus Principles for Design:**
+1. **Data Structures First**: "Bad programmers worry about the code. Good programmers worry about data structures."
+2. **Eliminate Special Cases**: "Good code has no special cases"
+3. **Simplicity**: "If implementation needs more than 3 levels of indentation, redesign it"
+4. **Never Break Userspace**: Ensure backward compatibility
+
 ## Quality Checklist
 
 - [ ] All FR-* requirements have corresponding components