sdtk-kit 0.3.2 → 0.3.4

package/README.md

@@ -16,7 +16,7 @@ npm link
 
 ```bash
 # 1. Initialize workspace with runtime adapter
-sdtk init --runtime codex
+sdtk init --runtime claude
 
 # 2. Store GitHub token for entitlement
 sdtk auth --token ghp_xxxxxxxxxxxx
@@ -24,6 +24,9 @@ sdtk auth --verify
 
 # 3. Generate feature documentation (17 files)
 sdtk generate --feature-key USER_PROFILE --feature-name "User Profile"
+# Codex runtime remains available:
+# sdtk init --runtime codex
+
 ```
 
 ## Commands
@@ -33,7 +36,9 @@ sdtk generate --feature-key USER_PROFILE --feature-name "User Profile"
 Initialize SDTK workspace in the current or specified project directory.
 
 ```bash
-sdtk init --runtime <codex|claude> [--project-path <path>] [--force] [--skip-skills]
+sdtk init --runtime <codex|claude> [--project-path <path>] [--force] [--runtime-scope <project|user>] [--skip-runtime-assets]
+
+# Deprecated: --skip-skills (use --skip-runtime-assets instead)
 ```
 
 Creates:
@@ -41,6 +46,9 @@ Creates:
 - `sdtk.config.json` -- project configuration
 - `sdtk.config.profiles.example.json` -- stack profile examples
 - `CODEX.md` or `CLAUDE.md` -- runtime adapter
+- for `--runtime claude`, skill files are installed into `.claude/skills/` (project scope, default) or `~/.claude/skills/` (user scope) unless `--skip-runtime-assets` is used
+- for `--runtime codex`, skill files are installed into `$CODEX_HOME/skills/` or `~/.codex/skills/` (user scope only) unless `--skip-runtime-assets` is used
+- `--skip-skills` is deprecated; use `--skip-runtime-assets` instead
 
 ### `sdtk auth`
 
@@ -79,6 +87,36 @@ sdtk generate --feature-key <UPPER_SNAKE_CASE> --feature-name "<text>" [--projec
 
 Output files include: project initiation, BA spec, flow-action spec, PRD, backlog, architecture design, database spec, API specs (OpenAPI + endpoints + design detail + flow list), UI design layout, implementation plan, test cases, and QA release report.
 
+### `sdtk runtime`
+
+Manage runtime skill assets independently of `sdtk init`.
+
+```bash
+sdtk runtime install --runtime <codex|claude> [--scope <project|user>]
+sdtk runtime uninstall --runtime <codex|claude> [--scope <project|user>]
+sdtk runtime status --runtime <codex|claude>
+```
+
+Scope defaults:
+- `claude`: `project` (installs to `.claude/skills/`); `user` installs to `~/.claude/skills/`
+- `codex`: `user` only (installs to `$CODEX_HOME/skills/` or `~/.codex/skills/`); project scope is not supported (Gate C0)
+
+Examples:
+
+```bash
+# Install Claude skills at project scope (default)
+sdtk runtime install --runtime claude
+
+# Install Claude skills at user scope
+sdtk runtime install --runtime claude --scope user
+
+# Check installed runtime assets
+sdtk runtime status --runtime claude
+
+# Remove runtime assets
+sdtk runtime uninstall --runtime claude --scope project
+```
+
 ### `sdtk --help` / `sdtk --version`
 
 ```bash
@@ -128,4 +166,3 @@ npm run verify:payload
 # Smoke test npm pack
 npm run pack:smoke
 ```
-

package/assets/manifest/toolkit-bundle.manifest.json

@@ -1,20 +1,20 @@
 {
-    "buildTimestamp":  "2026-03-03T11:32:21Z",
+    "buildTimestamp":  "2026-03-07T02:40:24Z",
     "files":  [
                   {
                       "path":  "toolkit/AGENTS.md",
-                      "sha256":  "c6eeae87c70925803869ae90d0aa033eb12852c174019f373f62382d25b3a7e3",
-                      "size":  5060
+                      "sha256":  "868430474b46e4e8d27ed26b780a794936e84cf4f0278f2cc3d061f54877f498",
+                      "size":  5113
                   },
                   {
                       "path":  "toolkit/install.ps1",
-                      "sha256":  "cc717ae87a0dbcf5aef2204d45211fe59f9506f9d03314eb283eddb3a5997279",
-                      "size":  5519
+                      "sha256":  "e717a2791fb597d7a21f57f4c4790dbc545e954f0af3ca0c47f160f78c8a2474",
+                      "size":  9777
                   },
                   {
                       "path":  "toolkit/runtimes/claude/CLAUDE_TEMPLATE.md",
-                      "sha256":  "fdf45036d4c0079cdb03e65efb7b5a84ea130e67a4c82522bb93c2bb73aa6661",
-                      "size":  882
+                      "sha256":  "0f3e0bfe1b5165250f0da4da5790a9e6220023752713088a0076eb7f17fd6397",
+                      "size":  1933
                   },
                   {
                       "path":  "toolkit/runtimes/codex/CODEX_TEMPLATE.md",
@@ -26,10 +26,20 @@
                       "sha256":  "5c1f5442fd3c26b8bf62db4b25e9f1c4207258c7fe52f12ed533968f77dfbf65",
                       "size":  10557
                   },
+                  {
+                      "path":  "toolkit/scripts/install-claude-skills.ps1",
+                      "sha256":  "8c66c27262ad4abc3c42bbcbe3a97752a5f29956ac93397133e6780354911549",
+                      "size":  4315
+                  },
                   {
                       "path":  "toolkit/scripts/install-codex-skills.ps1",
-                      "sha256":  "68a82e421d0309e47cdb79e949b1044c17375ad7fd52e2ab9ccdc9dd33f8cdd0",
-                      "size":  9175
+                      "sha256":  "ca64e0c2a0f13137bc6b780a57442de46a3e0551778bbcbadd4eb779c21cb203",
+                      "size":  9427
+                  },
+                  {
+                      "path":  "toolkit/scripts/uninstall-claude-skills.ps1",
+                      "sha256":  "809ffc1f96528ac1cd453214cd1c2d231ca0753f0d3c19b4a20f11835a64a152",
+                      "size":  4482
                   },
                   {
                       "path":  "toolkit/scripts/uninstall-codex-skills.ps1",
@@ -211,6 +221,71 @@
                       "sha256":  "72ca16e07c286910333243954610e116217ca2abb3a5e276cbe91e92eb826ad5",
                       "size":  2652
                   },
+                  {
+                      "path":  "toolkit/skills-claude/api-design-spec/SKILL.md",
+                      "sha256":  "123873681ff65792a9a269b264155c65a5feb68b23e4eeb1e68cb7da1a137d54",
+                      "size":  3252
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/api-doc/SKILL.md",
+                      "sha256":  "57176bb3d74e19ef5feb1a8d59d8c7c1714634f67e1d51bf4667d3f189093319",
+                      "size":  2240
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/arch/SKILL.md",
+                      "sha256":  "5ab03dc8a928c6528d1ccaad427a15c686427e8fd9114421da495d9223652337",
+                      "size":  4108
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/ba/SKILL.md",
+                      "sha256":  "1956fd69ff1a0adb54c8abbf06b37bd5c21b7f0ca597b6d8b94dfed0606cd2e4",
+                      "size":  2551
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/design-layout/SKILL.md",
+                      "sha256":  "9765f229108c5aff27457489707218570ad83dc362353a79c2f5a78607adf4de",
+                      "size":  840
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/dev/SKILL.md",
+                      "sha256":  "cea9f6512bc805d5b22a84a4ef8dbd229b4f7a3f073f9e125e933e6e79a206d5",
+                      "size":  2505
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/dev-backend/SKILL.md",
+                      "sha256":  "142a8fe088a4b0326ca79e00200cb5f562c53728b7adc83e6b749db6e29f1d0d",
+                      "size":  841
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/dev-frontend/SKILL.md",
+                      "sha256":  "1631bd51bc3d0106c18f4c00412f6279626bdce9f0e310822d5dcdff08063a88",
+                      "size":  800
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/orchestrator/SKILL.md",
+                      "sha256":  "c8e8303f1833e71cacdf20b1f398e476b44b3de14fbffad9a404c2a68fa713a3",
+                      "size":  4046
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/pm/SKILL.md",
+                      "sha256":  "b34621fe61957e573c616ad816d591a60a6c8d1333d0bfb71f39f45b93331cb0",
+                      "size":  3043
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/qa/SKILL.md",
+                      "sha256":  "eb0a540d28144855b5026e7b40ce965c4049a9b56f6e7ffd9732964006f63d1a",
+                      "size":  2687
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/screen-design-spec/SKILL.md",
+                      "sha256":  "5686da60872f1a3c6791e9a740897d4a564f40d53d54902a47fbc3165e68a1ec",
+                      "size":  3261
+                  },
+                  {
+                      "path":  "toolkit/skills-claude/test-case-spec/SKILL.md",
+                      "sha256":  "efd43e2087961f4e30177144c42e06b6c9b3d73f9533dad34f9ce1284fcdf126",
+                      "size":  2625
+                  },
                   {
                       "path":  "toolkit/templates/docs/api/API_DESIGN_CREATION_RULES.md",
                       "sha256":  "9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2",
@@ -332,7 +407,7 @@
                       "size":  3255
                   }
               ],
-    "sourceCommit":  "bf9a10e9ccde3a1c4809836b2da20fc6e3ad07df",
-    "version":  "0.3.2",
-    "fileCount":  66
+    "sourceCommit":  "965d6ad1f80a42b8b49c4296ec7a96ffef2655e3",
+    "version":  "0.3.4",
+    "fileCount":  81
 }

package/assets/manifest/toolkit-bundle.sha256.txt

@@ -1,9 +1,11 @@
-c6eeae87c70925803869ae90d0aa033eb12852c174019f373f62382d25b3a7e3  toolkit/AGENTS.md
-cc717ae87a0dbcf5aef2204d45211fe59f9506f9d03314eb283eddb3a5997279  toolkit/install.ps1
-fdf45036d4c0079cdb03e65efb7b5a84ea130e67a4c82522bb93c2bb73aa6661  toolkit/runtimes/claude/CLAUDE_TEMPLATE.md
+868430474b46e4e8d27ed26b780a794936e84cf4f0278f2cc3d061f54877f498  toolkit/AGENTS.md
+e717a2791fb597d7a21f57f4c4790dbc545e954f0af3ca0c47f160f78c8a2474  toolkit/install.ps1
+0f3e0bfe1b5165250f0da4da5790a9e6220023752713088a0076eb7f17fd6397  toolkit/runtimes/claude/CLAUDE_TEMPLATE.md
 4154c15c71f44d2f2caf07fb41722fa65d4f9ec7e78f798ee084effd12345c62  toolkit/runtimes/codex/CODEX_TEMPLATE.md
 5c1f5442fd3c26b8bf62db4b25e9f1c4207258c7fe52f12ed533968f77dfbf65  toolkit/scripts/init-feature.ps1
-68a82e421d0309e47cdb79e949b1044c17375ad7fd52e2ab9ccdc9dd33f8cdd0  toolkit/scripts/install-codex-skills.ps1
+8c66c27262ad4abc3c42bbcbe3a97752a5f29956ac93397133e6780354911549  toolkit/scripts/install-claude-skills.ps1
+ca64e0c2a0f13137bc6b780a57442de46a3e0551778bbcbadd4eb779c21cb203  toolkit/scripts/install-codex-skills.ps1
+809ffc1f96528ac1cd453214cd1c2d231ca0753f0d3c19b4a20f11835a64a152  toolkit/scripts/uninstall-claude-skills.ps1
 e0d462bd6dcdb17cc003d459063ff341bd2e4f60b245cda9b7e9b9e94b3cf01f  toolkit/scripts/uninstall-codex-skills.ps1
 de2921da9ce504487d9c7d97bf862b65d0ba00b9f1593a4fbfadf41ac36adb49  toolkit/sdtk.config.json
 21b1b0212f85c76dc6a89ae5936b39c4c1df7837a333f7a3db337f3039babb7b  toolkit/sdtk.config.profiles.example.json
@@ -40,6 +42,19 @@ ae0bc9b120c19a142f10cc79168a8f7d6bf8a37e48341fc16cbc74bbdc2e692c  toolkit/skills
 7c21e74f5eee712c6b65665b4f10483ed008113186a92dc0a4673ce1fcd3ef5c  toolkit/skills/sdtk-test-case-spec/references/TEST_CASE_CREATION_RULES.md
 4d1e813908114f2be68007fb7373973e2c6e0aebc5a6305b8b19443d5ae477d0  toolkit/skills/sdtk-test-case-spec/scripts/validate_test_case_spec.py
 72ca16e07c286910333243954610e116217ca2abb3a5e276cbe91e92eb826ad5  toolkit/skills/sdtk-test-case-spec/SKILL.md
+123873681ff65792a9a269b264155c65a5feb68b23e4eeb1e68cb7da1a137d54  toolkit/skills-claude/api-design-spec/SKILL.md
+57176bb3d74e19ef5feb1a8d59d8c7c1714634f67e1d51bf4667d3f189093319  toolkit/skills-claude/api-doc/SKILL.md
+5ab03dc8a928c6528d1ccaad427a15c686427e8fd9114421da495d9223652337  toolkit/skills-claude/arch/SKILL.md
+1956fd69ff1a0adb54c8abbf06b37bd5c21b7f0ca597b6d8b94dfed0606cd2e4  toolkit/skills-claude/ba/SKILL.md
+9765f229108c5aff27457489707218570ad83dc362353a79c2f5a78607adf4de  toolkit/skills-claude/design-layout/SKILL.md
+cea9f6512bc805d5b22a84a4ef8dbd229b4f7a3f073f9e125e933e6e79a206d5  toolkit/skills-claude/dev/SKILL.md
+142a8fe088a4b0326ca79e00200cb5f562c53728b7adc83e6b749db6e29f1d0d  toolkit/skills-claude/dev-backend/SKILL.md
+1631bd51bc3d0106c18f4c00412f6279626bdce9f0e310822d5dcdff08063a88  toolkit/skills-claude/dev-frontend/SKILL.md
+c8e8303f1833e71cacdf20b1f398e476b44b3de14fbffad9a404c2a68fa713a3  toolkit/skills-claude/orchestrator/SKILL.md
+b34621fe61957e573c616ad816d591a60a6c8d1333d0bfb71f39f45b93331cb0  toolkit/skills-claude/pm/SKILL.md
+eb0a540d28144855b5026e7b40ce965c4049a9b56f6e7ffd9732964006f63d1a  toolkit/skills-claude/qa/SKILL.md
+5686da60872f1a3c6791e9a740897d4a564f40d53d54902a47fbc3165e68a1ec  toolkit/skills-claude/screen-design-spec/SKILL.md
+efd43e2087961f4e30177144c42e06b6c9b3d73f9533dad34f9ce1284fcdf126  toolkit/skills-claude/test-case-spec/SKILL.md
 9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2  toolkit/templates/docs/api/API_DESIGN_CREATION_RULES.md
 d2aa0ee3a7c5351700b3bffb4ba66e8056ed955f55903c744c694624730038cb  toolkit/templates/docs/api/API_DESIGN_DETAIL_TEMPLATE.md
 13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97  toolkit/templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md

package/assets/toolkit/toolkit/AGENTS.md

@@ -59,9 +59,9 @@ Notes:
 ## 5) Feature Bootstrap
 Run from project root:
 
-`powershell -ExecutionPolicy Bypass -File ".\\toolkit\\scripts\\init-feature.ps1" -FeatureKey YOUR_FEATURE -FeatureName "Your Feature"`
-
-Or create artifacts manually from templates in `toolkit/templates/`.
+```
+sdtk generate --feature-key YOUR_FEATURE --feature-name "Your Feature"
+```
 
 ## 6) ARCH Deliverables (Extended)
 In addition to `ARCH_DESIGN`, ARCH may generate:
@@ -90,16 +90,20 @@ In addition to `ARCH_DESIGN`, ARCH may generate:
   - `off`: skip unless explicitly requested.
 
 ## 7) Mandatory Rule References
-- API YAML docs:
-  - `toolkit/templates/docs/api/YAML_CREATION_RULES.md`
-- API design detail + flow docs:
-  - `toolkit/templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md`
-- Compatibility notes kept for legacy references:
-  - `toolkit/templates/docs/api/FLOWCHART_CREATION_RULES.md`
-  - `toolkit/templates/docs/api/API_DESIGN_CREATION_RULES.md`
-- Screen flow-action specs:
-  - `toolkit/templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md`
-- QA test-case specs:
-  - `toolkit/templates/docs/qa/TEST_CASE_CREATION_RULES.md`
-- Flow-action numbering policy:
-  - Use one global numbering mode for the whole document (no per-screen reset).
+Rule files are installed locally by the runtime. Skills resolve these at:
+- Claude Code: `.claude/skills/references/`
+- Codex: `$CODEX_HOME/skills/<skill>/references/`
+
+Available rule files:
+- `YAML_CREATION_RULES.md` — API YAML docs
+- `API_DESIGN_FLOWCHART_CREATION_RULES.md` — API design detail + flow docs
+- `FLOWCHART_CREATION_RULES.md` — Flowchart (legacy compat)
+- `API_DESIGN_CREATION_RULES.md` — API design (legacy compat)
+- `FLOW_ACTION_SPEC_CREATION_RULES.md` — Screen flow-action specs
+- `TEST_CASE_CREATION_RULES.md` — QA test-case specs
+- `numbering-rules.md` — Flow-action numbering policy
+- `figma-mcp.md` — Figma MCP integration
+- `excel-image-export.md` — Excel image export
+
+Flow-action numbering policy:
+- Use one global numbering mode for the whole document (no per-screen reset).

package/assets/toolkit/toolkit/install.ps1

@@ -2,9 +2,12 @@ param(
   [string]$ProjectPath,
   [switch]$Force,
   [switch]$SkipSkills,
+  [switch]$SkipRuntimeAssets,
   [switch]$Quiet,
   [ValidateSet('codex', 'claude')]
-  [string]$Runtime = 'codex'
+  [string]$Runtime = 'codex',
+  [ValidateSet('project', 'user', '')]
+  [string]$Scope = ''
 )
 
 $ErrorActionPreference = 'Stop'
@@ -80,6 +83,94 @@ function Install-RuntimeAdapter {
   throw "Unsupported runtime: $RuntimeName"
 }
 
+function Install-ClaudeSkills {
+  param(
+    [Parameter(Mandatory = $true)][string]$ToolkitRoot,
+    [Parameter(Mandatory = $true)][string]$ProjectRoot,
+    [Parameter(Mandatory = $true)][bool]$Overwrite
+  )
+
+  $skillsSource = Join-Path $ToolkitRoot 'skills-claude'
+  $skillsDest = Join-Path $ProjectRoot '.claude/skills'
+
+  if (-not (Test-Path -LiteralPath $skillsSource)) {
+    throw "Claude skills source not found: $skillsSource"
+  }
+
+  $skillCount = 0
+  foreach ($skillDir in (Get-ChildItem -Path $skillsSource -Directory)) {
+    $srcFile = Join-Path $skillDir.FullName 'SKILL.md'
+    if (-not (Test-Path -LiteralPath $srcFile)) { continue }
+
+    $destFile = Join-Path $skillsDest "$($skillDir.Name)/SKILL.md"
+    Copy-File -SourcePath $srcFile -DestinationPath $destFile -Overwrite $Overwrite
+    $skillCount++
+  }
+
+  # Install reference files
+  $refDest = Join-Path $skillsDest 'references'
+  if (-not (Test-Path -LiteralPath $refDest)) {
+    New-Item -ItemType Directory -Force -Path $refDest | Out-Null
+  }
+
+  $refCount = 0
+  $missingRefs = @()
+
+  # 6 files from toolkit/templates/docs/
+  $templateRefs = @(
+    @{ Src = 'templates/docs/api/YAML_CREATION_RULES.md' },
+    @{ Src = 'templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md' },
+    @{ Src = 'templates/docs/api/FLOWCHART_CREATION_RULES.md' },
+    @{ Src = 'templates/docs/api/API_DESIGN_CREATION_RULES.md' },
+    @{ Src = 'templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md' },
+    @{ Src = 'templates/docs/qa/TEST_CASE_CREATION_RULES.md' }
+  )
+
+  foreach ($ref in $templateRefs) {
+    $srcPath = Join-Path $ToolkitRoot $ref.Src
+    $fileName = Split-Path -Leaf $srcPath
+    $destPath = Join-Path $refDest $fileName
+    if (Test-Path -LiteralPath $srcPath) {
+      Copy-File -SourcePath $srcPath -DestinationPath $destPath -Overwrite $Overwrite
+      $refCount++
+    } else {
+      $missingRefs += $srcPath
+    }
+  }
+
+  # 3 files from toolkit/skills/sdtk-screen-design-spec/references/
+  $screenRefs = @('numbering-rules.md', 'figma-mcp.md', 'excel-image-export.md')
+  foreach ($fileName in $screenRefs) {
+    $srcPath = Join-Path $ToolkitRoot "skills/sdtk-screen-design-spec/references/$fileName"
+    $destPath = Join-Path $refDest $fileName
+    if (Test-Path -LiteralPath $srcPath) {
+      Copy-File -SourcePath $srcPath -DestinationPath $destPath -Overwrite $Overwrite
+      $refCount++
+    } else {
+      $missingRefs += $srcPath
+    }
+  }
+
+  # Fail-fast: abort if any reference files are missing
+  if ($missingRefs.Count -gt 0) {
+    $list = ($missingRefs | ForEach-Object { "  - $_" }) -join "`n"
+    throw "Claude install failed. Missing reference files:`n$list"
+  }
+
+  # Strict count assertions
+  $expectedSkills = 13
+  $expectedRefs = 9
+  if ($skillCount -ne $expectedSkills) {
+    throw "Claude install failed. Expected $expectedSkills skills but installed $skillCount."
+  }
+  if ($refCount -ne $expectedRefs) {
+    throw "Claude install failed. Expected $expectedRefs reference files but installed $refCount."
+  }
+
+  Write-Host "  Skills installed: $skillCount"
+  Write-Host "  Reference files : $refCount"
+}
+
 $toolkitRoot = Resolve-Path $PSScriptRoot
 $canonicalRulesPath = Join-Path $toolkitRoot 'templates/docs/api/FLOWCHART_CREATION_RULES.md'
 $canonicalRulesHash = Get-FileSha256 -Path $canonicalRulesPath
@@ -93,6 +184,15 @@ if (-not $ProjectPath) {
 }
 $projectRoot = Resolve-Path -LiteralPath $ProjectPath
 
+# Merge SkipRuntimeAssets and legacy SkipSkills
+if ($SkipRuntimeAssets) { $SkipSkills = $true }
+
+# Default scope: project for Claude, user for Codex
+if (-not $Scope -or $Scope -eq '') {
+  if ($Runtime -eq 'claude') { $Scope = 'project' }
+  else { $Scope = 'user' }
+}
+
 if (-not $Quiet) {
   Write-Host "SDTK toolkit : $toolkitRoot"
   Write-Host "Project root : $projectRoot"
@@ -129,15 +229,29 @@ if (($Runtime -eq 'codex') -and (-not $SkipSkills)) {
   }
 
   Write-Host ""
-  Write-Host "Installing Codex skills globally..."
+  Write-Host "Installing Codex skills (scope: $Scope)..."
   if ($Force) {
-    & $skillInstaller -Force | Out-Host
+    & $skillInstaller -Scope $Scope -Force | Out-Host
   } else {
-    & $skillInstaller | Out-Host
+    & $skillInstaller -Scope $Scope | Out-Host
   }
 }
-elseif (($Runtime -eq 'claude') -and (-not $SkipSkills) -and (-not $Quiet)) {
-  Write-Warning "Runtime 'claude' does not install Codex skills. Skipping skill installation."
+elseif (($Runtime -eq 'claude') -and (-not $SkipSkills)) {
+  $skillInstaller = Join-Path $toolkitRoot 'scripts/install-claude-skills.ps1'
+  if (-not (Test-Path -LiteralPath $skillInstaller)) {
+    # Fallback to inline Install-ClaudeSkills for backward compatibility
+    Write-Host ""
+    Write-Host "Installing Claude Code skills..."
+    Install-ClaudeSkills -ToolkitRoot $toolkitRoot -ProjectRoot $projectRoot -Overwrite ([bool]$Force)
+  } else {
+    Write-Host ""
+    Write-Host "Installing Claude Code skills (scope: $Scope)..."
+    if ($Force) {
+      & $skillInstaller -Scope $Scope -ProjectPath $projectRoot.ToString() -Force | Out-Host
+    } else {
+      & $skillInstaller -Scope $Scope -ProjectPath $projectRoot.ToString() | Out-Host
+    }
+  }
 }
 
 if (-not $Quiet) {
@@ -148,7 +262,8 @@ if (-not $Quiet) {
   if ($Runtime -eq 'codex') {
     Write-Host "2) Restart Codex (to load runtime adapter and skills)"
   } else {
-    Write-Host "2) Restart Claude Code (to load CLAUDE.md adapter)"
+    Write-Host "2) Restart Claude Code (to load CLAUDE.md + skills)"
+    Write-Host "   Commands: /orchestrator /pm /ba /arch /dev /qa"
   }
   Write-Host '3) Generate feature docs:'
   Write-Host '   sdtk generate --feature-key YOUR_FEATURE --feature-name "Your Feature"'

package/assets/toolkit/toolkit/runtimes/claude/CLAUDE_TEMPLATE.md

@@ -1,7 +1,7 @@
 # CLAUDE.md
 
-Version: 1.0
-Last Updated: 2026-02-25
+Version: 2.0
+Last Updated: 2026-03-05
 Owner: SDTK Core Team
 
 This file defines runtime guidance for Claude Code sessions in projects using SDTK.
@@ -9,24 +9,46 @@ This file defines runtime guidance for Claude Code sessions in projects using SD
 ## 1) Rule Priority
 1. Explicit user request
 2. `AGENTS.md` (project root)
-3. `toolkit/AGENTS.md`
+3. Installed skill content (`.claude/skills/*/SKILL.md`)
 4. This file (`CLAUDE.md`)
-5. Other supporting docs
+5. `sdtk.config.json`
 
 ## 2) Runtime Model
 - Primary workflow: PM -> BA -> ARCH -> DEV -> QA
-- Role tags: `/pm`, `/ba`, `/arch`, `/dev`, `/qa`
+- Entry point: `/orchestrator` (recommended) or `/pm`
+- Role commands: `/pm`, `/ba`, `/arch`, `/dev`, `/qa`
+- Sub-skill commands: `/api-doc`, `/api-design-spec`, `/screen-design-spec`, `/design-layout`, `/test-case-spec`, `/dev-backend`, `/dev-frontend`
 - Shared state files:
   - `SHARED_PLANNING.md`
   - `QUALITY_CHECKLIST.md`
 
 ## 3) Minimal Session Flow
-1. Start with `/pm` to define feature scope.
+1. Start with `/orchestrator` or `/pm` to define feature scope.
 2. Move phase-by-phase without skipping gates.
 3. Keep traceability from requirements to design, implementation, and tests.
 4. Require code review completion before QA release decision.
 
-## 4) References
-- `toolkit/SDTK_TOOLKIT.md`
-- `toolkit/AGENTS.md`
-- `sdtk.config.json`
+## 4) Installed Skills
+Skills are installed at `.claude/skills/` and provide slash commands:
+
+| Command | Purpose |
+|---------|---------|
+| `/orchestrator` | Full 6-phase SDLC orchestration |
+| `/pm` | PM initiation + planning |
+| `/ba` | Business analysis |
+| `/arch` | Solution architecture |
+| `/dev` | Development + code review |
+| `/qa` | QA testing + release decision |
+| `/api-doc` | OpenAPI YAML + flow diagrams |
+| `/api-design-spec` | API design detail spec |
+| `/screen-design-spec` | Screen flow-action spec |
+| `/design-layout` | UI screen layout wireframes |
+| `/test-case-spec` | QA test-case spec |
+| `/dev-backend` | Backend code conventions |
+| `/dev-frontend` | Frontend code conventions |
+
+Rule reference files are installed at `.claude/skills/references/`.
+
+## 5) References
+- `sdtk.config.json`
+- `.claude/skills/references/` (rule files)

package/assets/toolkit/toolkit/scripts/install-claude-skills.ps1

@@ -0,0 +1,129 @@
+param(
+  [string]$ProjectPath,
+  [ValidateSet('project', 'user')]
+  [string]$Scope = 'project',
+  [switch]$Force
+)
+
+$ErrorActionPreference = 'Stop'
+Set-StrictMode -Version Latest
+
+function Copy-File {
+  param(
+    [Parameter(Mandatory = $true)][string]$SourcePath,
+    [Parameter(Mandatory = $true)][string]$DestinationPath,
+    [Parameter(Mandatory = $true)][bool]$Overwrite
+  )
+
+  if (-not (Test-Path -LiteralPath $SourcePath)) {
+    throw "Missing source: $SourcePath"
+  }
+
+  if (Test-Path -LiteralPath $DestinationPath) {
+    if (-not $Overwrite) {
+      Write-Warning "Already exists (skipping). Use -Force to overwrite: $DestinationPath"
+      return
+    }
+  }
+
+  $parent = Split-Path -Parent $DestinationPath
+  if ($parent -and -not (Test-Path -LiteralPath $parent)) {
+    New-Item -ItemType Directory -Force -Path $parent | Out-Null
+  }
+
+  Copy-Item -LiteralPath $SourcePath -Destination $DestinationPath -Force
+}
+
+$toolkitRoot = Resolve-Path (Join-Path $PSScriptRoot '..')
+
+# Resolve destination based on scope
+if ($Scope -eq 'user') {
+  $skillsDest = Join-Path $HOME '.claude/skills'
+  Write-Host "Scope: user (installing to $skillsDest)"
+} else {
+  if (-not $ProjectPath) {
+    $ProjectPath = (Resolve-Path (Join-Path $toolkitRoot '..')).Path
+  }
+  $projectRoot = Resolve-Path -LiteralPath $ProjectPath
+  $skillsDest = Join-Path $projectRoot '.claude/skills'
+  Write-Host "Scope: project (installing to $skillsDest)"
+}
+
+$skillsSource = Join-Path $toolkitRoot 'skills-claude'
+if (-not (Test-Path -LiteralPath $skillsSource)) {
+  throw "Claude skills source not found: $skillsSource"
+}
+
+$skillCount = 0
+foreach ($skillDir in (Get-ChildItem -Path $skillsSource -Directory)) {
+  $srcFile = Join-Path $skillDir.FullName 'SKILL.md'
+  if (-not (Test-Path -LiteralPath $srcFile)) { continue }
+
+  $destFile = Join-Path $skillsDest "$($skillDir.Name)/SKILL.md"
+  Copy-File -SourcePath $srcFile -DestinationPath $destFile -Overwrite ([bool]$Force)
+  $skillCount++
+}
+
+# Install reference files
+$refDest = Join-Path $skillsDest 'references'
+if (-not (Test-Path -LiteralPath $refDest)) {
+  New-Item -ItemType Directory -Force -Path $refDest | Out-Null
+}
+
+$refCount = 0
+$missingRefs = @()
+
+# 6 files from toolkit/templates/docs/
+$templateRefs = @(
+  @{ Src = 'templates/docs/api/YAML_CREATION_RULES.md' },
+  @{ Src = 'templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md' },
+  @{ Src = 'templates/docs/api/FLOWCHART_CREATION_RULES.md' },
+  @{ Src = 'templates/docs/api/API_DESIGN_CREATION_RULES.md' },
+  @{ Src = 'templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md' },
+  @{ Src = 'templates/docs/qa/TEST_CASE_CREATION_RULES.md' }
+)
+
+foreach ($ref in $templateRefs) {
+  $srcPath = Join-Path $toolkitRoot $ref.Src
+  $fileName = Split-Path -Leaf $srcPath
+  $destPath = Join-Path $refDest $fileName
+  if (Test-Path -LiteralPath $srcPath) {
+    Copy-File -SourcePath $srcPath -DestinationPath $destPath -Overwrite ([bool]$Force)
+    $refCount++
+  } else {
+    $missingRefs += $srcPath
+  }
+}
+
+# 3 files from toolkit/skills/sdtk-screen-design-spec/references/
+$screenRefs = @('numbering-rules.md', 'figma-mcp.md', 'excel-image-export.md')
+foreach ($fileName in $screenRefs) {
+  $srcPath = Join-Path $toolkitRoot "skills/sdtk-screen-design-spec/references/$fileName"
+  $destPath = Join-Path $refDest $fileName
+  if (Test-Path -LiteralPath $srcPath) {
+    Copy-File -SourcePath $srcPath -DestinationPath $destPath -Overwrite ([bool]$Force)
+    $refCount++
+  } else {
+    $missingRefs += $srcPath
+  }
+}
+
+# Fail-fast: abort if any reference files are missing
+if ($missingRefs.Count -gt 0) {
+  $list = ($missingRefs | ForEach-Object { "  - $_" }) -join "`n"
+  throw "Claude install failed. Missing reference files:`n$list"
+}
+
+# Strict count assertions
+$expectedSkills = 13
+$expectedRefs = 9
+if ($skillCount -ne $expectedSkills) {
+  throw "Claude install failed. Expected $expectedSkills skills but installed $skillCount."
+}
+if ($refCount -ne $expectedRefs) {
+  throw "Claude install failed. Expected $expectedRefs reference files but installed $refCount."
+}
+
+Write-Host "  Skills installed: $skillCount"
+Write-Host "  Reference files : $refCount"
+Write-Host "  Destination     : $skillsDest"