fix(cc-sdd): install commands on Linux by reusing mac templates (Fixes #44)

- Update manifests to include linux for commands_os_mac\n- Add Linux runtime tests for claude-code and gemini-cli\n- Update README (root + tool) and localized READMEs to note Linux support\n- Document platform behavior and examples

Author: Gota

.github/workflows/publish.yml

@@ -3,7 +3,7 @@ name: Publish Package
 on:
   push:
     tags:
-      - 'cc-sdd-v*'
+      - 'v*.*.*'  # Trigger on version tags like v1.0.0
 
 permissions:
   id-token: write  # Required for OIDC

.gitignore

@@ -71,9 +71,10 @@ coverage/
 # Project specific
 BLOG.md
 docs/cc-sdd/
+docs/kiro/prompt/
 
-# Claude Code
+# Agent configurations
 .claude/agents/
 .claude/hooks/
-
-docs/kiro/prompt/
+GEMINI.md
+AGENTS.md

README.md

@@ -21,7 +21,7 @@ One command installs **AI-DLC** (AI-Driven Development Life Cycle) with **SDD**
 npx cc-sdd@latest
 
 # With language: --lang en (English) or --lang ja (Japanese) or --lang zh-TW (Traditional Chinese)
-# With OS: --os mac or --os windows (if auto-detection fails)
+# With OS: --os mac | --os windows | --os linux (if auto-detection fails)
 npx cc-sdd@latest --lang ja --os mac
 
 # With different agents: gemini-cli
@@ -120,7 +120,7 @@ npx cc-sdd@latest --kiro-dir docs/specs
 ✅ **AI-DLC Integration** - Complete AI-Driven Development Life Cycle  
 ✅ **Project Memory** - Steering that learns your codebase and patterns  
 ✅ **Spec-Driven Development** - Structured requirements → design → tasks → implementation  
-✅ **Cross-Platform** - macOS and Windows support with auto-detection  
+✅ **Cross-Platform** - macOS, Linux, and Windows support with auto-detection (Linux reuses mac templates)  
 ✅ **Multi-Language** - Japanese, English, Traditional Chinese  
 ✅ **Safe Updates** - Interactive prompts with backup options  
 

tools/cc-sdd/README.md

@@ -85,7 +85,8 @@ npx cc-sdd@latest --gemini-cli --lang ja # For Gemini CLI instead
 
 ```bash
 # Language and platform
-npx cc-sdd@latest --lang ja --os mac
+npx cc-sdd@latest --lang ja --os mac   # macOS
+npx cc-sdd@latest --lang ja --os linux # Linux (shares mac templates)
 
 # Safe operations  
 npx cc-sdd@latest --dry-run --backup
@@ -116,3 +117,7 @@ project/
 ---
 
 **Beta Release** - Ready to use, actively improving. [Report issues](https://github.com/gotalab/claude-code-spec/issues) | MIT License
+
+### Platform Support
+- Supported OS: macOS, Linux, Windows (auto-detected by default).
+- Linux uses the same command templates as macOS. Windows has dedicated templates.

tools/cc-sdd/README_ja.md

@@ -85,7 +85,9 @@ npx cc-sdd@latest --gemini-cli --lang ja # Gemini CLI用
 
 ```bash
 # 言語とプラットフォーム
-npx cc-sdd@latest --lang ja --os mac
+npx cc-sdd@latest --lang ja --os mac   # macOS
+npx cc-sdd@latest --lang ja --os linux # Linux（macテンプレートを共有）
+npx cc-sdd@latest --lang ja --os windows # Windows（専用テンプレート）
 
 # 安全な操作  
 npx cc-sdd@latest --dry-run --backup
@@ -116,3 +118,7 @@ project/
 ---
 
 **ベータリリース** - 使用可能、改善中。[問題を報告](https://github.com/gotalab/claude-code-spec/issues) | MIT License
+
+### プラットフォーム対応
+- 対応OS: macOS / Linux / Windows（通常は自動検出）。
+- Linux は macOS と同じコマンドテンプレートを使用します。Windows は専用テンプレートを使用します。

tools/cc-sdd/README_zh-TW.md

@@ -85,7 +85,9 @@ npx cc-sdd@latest --gemini-cli --lang zh-TW # Gemini CLI 用
 
 ```bash
 # 語言與平台
-npx cc-sdd@latest --lang zh-TW --os mac
+npx cc-sdd@latest --lang zh-TW --os mac    # macOS
+npx cc-sdd@latest --lang zh-TW --os linux  # Linux（與 mac 共用模板）
+npx cc-sdd@latest --lang zh-TW --os windows # Windows（專用模板）
 
 # 安全操作
 npx cc-sdd@latest --dry-run --backup
@@ -116,3 +118,7 @@ project/
 ---
 
 **Beta 版本** - 可用且持續改進中。[回報問題](https://github.com/gotalab/claude-code-spec/issues) | MIT License
+
+### 平台支援
+- 支援 OS：macOS / Linux / Windows（預設自動偵測）。
+- Linux 與 macOS 使用相同的指令模板；Windows 使用專用模板。

tools/cc-sdd/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-sdd",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.4",
   "description": "Transform your coding workflow with AI-DLC and Spec-Driven Development. One command installs 7 powerful slash commands, Project Memory, and structured development workflows for Claude Code.",
   "keywords": ["claude-code", "spec-driven-development", "kiro", "steering", "ai-development", "tdd", "ai-dlc", "ai-driven-development-life-cycle"],
   "author": "Gota",

tools/cc-sdd/templates/manifests/claude-code.json

@@ -8,7 +8,7 @@
         "fromDir": "templates/agents/{{AGENT}}/commands/os-mac",
         "toDir": "{{AGENT_COMMANDS_DIR}}"
       },
-      "when": { "agent": "claude-code", "os": "mac" }
+      "when": { "agent": "claude-code", "os": ["mac", "linux"] }
     },
     {
       "id": "commands_os_windows",

tools/cc-sdd/templates/manifests/gemini-cli.json

@@ -8,7 +8,7 @@
         "fromDir": "templates/agents/{{AGENT}}/commands/os-mac",
         "toDir": "{{AGENT_COMMANDS_DIR}}"
       },
-      "when": { "agent": "gemini-cli", "os": "mac" }
+      "when": { "agent": "gemini-cli", "os": ["mac", "linux"] }
     },
     {
       "id": "commands_os_windows",

tools/cc-sdd/test/realManifestClaudeCode.test.ts

@@ -60,3 +60,35 @@ describe('real claude-code manifest', () => {
     expect(ctx.logs.join('\n')).toMatch(/Applied plan:/);
   });
 });
+
+describe('real claude-code manifest (linux)', () => {
+  const runtimeLinux = { platform: 'linux' } as const;
+
+  it('dry-run prints plan including commands for linux via mac template', async () => {
+    const ctx = makeIO();
+    const code = await runCli(['--dry-run', '--lang', 'en', '--manifest', manifestPath], runtimeLinux, ctx.io, {});
+    expect(code).toBe(0);
+    const out = ctx.logs.join('\n');
+    expect(out).toMatch(/Plan \(dry-run\)/);
+    expect(out).toContain('[templateDir] commands_os_mac: templates/agents/claude-code/commands/os-mac -> .claude/commands/kiro');
+    expect(out).toContain('[templateFile] doc_main: templates/agents/claude-code/docs/CLAUDE/CLAUDE.en.tpl.md -> ./CLAUDE.md');
+  });
+
+  it('apply writes CLAUDE.md and command files to cwd on linux', async () => {
+    const cwd = await mkTmp();
+    const ctx = makeIO();
+    const code = await runCli(['--lang', 'en', '--manifest', manifestPath, '--overwrite=force'], runtimeLinux, ctx.io, {}, { cwd, templatesRoot: process.cwd() });
+    expect(code).toBe(0);
+
+    const doc = join(cwd, 'CLAUDE.md');
+    expect(await exists(doc)).toBe(true);
+    const text = await readFile(doc, 'utf8');
+    expect(text).toMatch(/Claude Code Spec-Driven Development/);
+    expect(text).toContain('Steering: `.kiro/steering/`');
+
+    const cmd = join(cwd, '.claude/commands/kiro/spec-init.md');
+    expect(await exists(cmd)).toBe(true);
+
+    expect(ctx.logs.join('\n')).toMatch(/Applied plan:/);
+  });
+});