sdtk-kit 0.3.8 → 1.0.0

package/assets/toolkit/toolkit/AGENTS.md

@@ -1,131 +0,0 @@
-# SDTK Multi-Agent Software Development Toolkit
-
-Goal: use SDTK as a virtual PM/BA/ARCH/DEV/QA operating model to deliver one feature through a 6-phase SDLC flow with full traceability and quality gates.
-
-## 0) Default Rules
-- If role is not specified, default to PM (entry point) and start at Phase 1.
-- Do not skip phases. If inputs are missing, ask focused questions before moving on.
-- At the end of every phase, update:
-  - `SHARED_PLANNING.md`
-  - `QUALITY_CHECKLIST.md`
-- Artifact language under `docs/**` should default to English.
-- Read stack and command configuration from `sdtk.config.json` in the project root.
-- For VI/JP source requirements, keep original text in an appendix and add literal English translation for traceability.
-- Code review must be complete before QA starts.
-- Verification-before-completion: no phase may declare done, pass, or handoff-ready without fresh command evidence per `governance/ai/core/SDTK_VERIFICATION_BEFORE_COMPLETION_POLICY.md`.
-- `toolkit/skills/skills.catalog.yaml` is the inventory source of truth for the 13 core SDTK skills.
-
-## 0.1) Clarification Protocol
-Apply for all roles (`/pm`, `/ba`, `/arch`, `/dev`, `/qa`):
-1. If there is ambiguity or missing data, log `Open Questions` as `OQ-xx` in the current phase artifact.
-2. Do not guess for behavior, API contracts, UI/UX, data model, security, or release criteria.
-3. Escalate unresolved items to PM with question ID and file reference.
-4. PM resolves by:
-   - using available docs and making a clear decision, or
-   - asking the user if source information is still missing.
-5. Record decisions in PRD (`Decision Log`) and update the originating `OQ-xx` with resolution.
-
-## 1) Role Selection In One Message
-When the user prefixes a message, execute that role:
-- `/pm` (entry point + orchestrator)
-- `/ba`
-- `/arch`
-- `/dev`
-- `/qa`
-- `/engineer` (escalation for technical blockers)
-
-Notes:
-- Supported delivery roles are PM/BA/ARCH/DEV/QA.
-- There is no separate `/tester` role. Test-case design belongs to QA with `sdtk-test-case-spec`.
-
-## 2) Standard 6-Phase Pipeline
-1. PM Initiation -> `docs/product/PROJECT_INITIATION_[FEATURE_KEY].md`
-2. BA Analysis -> `docs/specs/BA_SPEC_[FEATURE_KEY].md`
-3. PM Planning -> `docs/product/PRD_[FEATURE_KEY].md` + `docs/product/BACKLOG_[FEATURE_KEY].md`
-4. ARCH Design -> `docs/architecture/ARCH_DESIGN_[FEATURE_KEY].md` (plus API/layout docs when needed)
-5. DEV Implementation + Code Review -> `docs/dev/FEATURE_IMPL_PLAN_[FEATURE_KEY].md` + code + tests
-6. QA Testing -> `docs/qa/[FEATURE_KEY]_TEST_CASE.md` + `docs/qa/QA_RELEASE_REPORT_[FEATURE_KEY].md`
-
-## 2.1) DEV Review Gates
-DEV Review Gates (mandatory, in order):
-1. Artifact/spec compliance review -- verify code matches BA spec, API YAML, FLOW_ACTION_SPEC, and DB spec line by line.
-2. Code quality review -- verify structure, naming, test coverage, and maintainability. Runs ONLY after Stage 1 PASS.
-
-QA handoff is blocked until both gates PASS.
-
-Stage 1 and QA validation must quote exact specification text when recording a match or mismatch.
-Use: `Spec says: "[exact quote]" -> Evidence: [match/mismatch + file reference]`
-
-## 3) Shared State And Quality Gates
-- `SHARED_PLANNING.md`: phase status, owners, artifacts, blockers, handoff notes.
-- `QUALITY_CHECKLIST.md`: gate checklist by phase.
-- No handoff to next phase while current gate is not PASS.
-- QA cannot start before code review gate is complete.
-
-## 4) Minimum Traceability
-- PM: `REQ-xx` requirements, scope, success metrics.
-- BA: `BR-xx`, `UC-xx`, `AC-xx`, `NFR-xx`, and traceability matrix.
-- ARCH: map UC/BR to API/DB/flows/screens.
-- DEV/QA: map backlog stories and tests to UC/AC.
-
-## 5) Feature Bootstrap
-Run from project root:
-
-```
-sdtk generate --feature-key YOUR_FEATURE --feature-name "Your Feature"
-```
-
-## 6) ARCH Deliverables (Extended)
-In addition to `ARCH_DESIGN`, ARCH may generate:
-- `docs/api/[FEATURE_KEY]_ENDPOINTS.md`
-- `docs/api/[FEATURE_KEY]_API_DESIGN_DETAIL.md`
-- `docs/database/DATABASE_SPEC_[FEATURE_KEY].md`
-- `docs/specs/[FEATURE_KEY]_FLOW_ACTION_SPEC.md`
-
-## 6.1) ARCH Orchestration Mapping
-- Use `sdtk-api-doc` when API scope exists.
-- Use `sdtk-api-design-spec` when API design detail is required from YAML + flow list.
-- Use `sdtk-screen-design-spec` when UI flow-action specification is needed.
-- Controlled by `sdtk.config.json`:
-  - `orchestration.apiDesignDetailMode = auto|on|off`
-  - `auto`: generate when API scope and required sources are available.
-  - `on`: always generate for API scope.
-  - `off`: skip unless explicitly requested.
-
-## 6.2) QA Orchestration Mapping
-- Use `sdtk-test-case-spec` when detailed worksheet-style test-case artifacts are required.
-- Use `sdtk-qa` for execution report and release decision.
-- Controlled by `sdtk.config.json`:
-  - `orchestration.testCaseSpecMode = auto|on|off`
-  - `auto`: generate when QA requires test-case artifacts.
-  - `on`: always generate in QA phase.
-  - `off`: skip unless explicitly requested.
-
-## 6.3) Maintainer Assets
-- Skill inventory: `toolkit/skills/skills.catalog.yaml`
-- Handoff templates: `toolkit/templates/handoffs/`
-- Example scenarios: `examples/`
-- Readiness audit: `toolkit/scripts/check-runtime-readiness.ps1`
-
-## 7) Mandatory Rule References
-Rule files are installed locally by the runtime. Skills resolve these at:
-- Claude Code: `.claude/skills/references/`
-- Codex: `$CODEX_HOME/skills/<skill>/references/`
-
-Workflow governance docs:
-- `governance/ai/core/SDTK_VERIFICATION_BEFORE_COMPLETION_POLICY.md` -- verification-before-completion gate
-- `governance/ai/core/SDTK_SKILL_AUTHORING_AND_TESTING.md` -- maintainer authoring/test guide
-
-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

@@ -1,270 +0,0 @@
-param(
-  [string]$ProjectPath,
-  [switch]$Force,
-  [switch]$SkipSkills,
-  [switch]$SkipRuntimeAssets,
-  [switch]$Quiet,
-  [ValidateSet('codex', 'claude')]
-  [string]$Runtime = 'codex',
-  [ValidateSet('project', 'user', '')]
-  [string]$Scope = ''
-)
-
-$ErrorActionPreference = 'Stop'
-Set-StrictMode -Version Latest
-
-function Get-FileSha256 {
-  param(
-    [Parameter(Mandatory = $true)][string]$Path
-  )
-
-  if (-not (Test-Path -LiteralPath $Path)) {
-    return $null
-  }
-
-  $stream = [System.IO.File]::OpenRead($Path)
-  try {
-    $sha = [System.Security.Cryptography.SHA256]::Create()
-    $hashBytes = $sha.ComputeHash($stream)
-    return [BitConverter]::ToString($hashBytes).Replace('-', '')
-  } finally {
-    $stream.Close()
-  }
-}
-
-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
-}
-
-function Install-RuntimeAdapter {
-  param(
-    [Parameter(Mandatory = $true)][string]$ToolkitRoot,
-    [Parameter(Mandatory = $true)][string]$ProjectRoot,
-    [Parameter(Mandatory = $true)][string]$RuntimeName,
-    [Parameter(Mandatory = $true)][bool]$Overwrite
-  )
-
-  if ($RuntimeName -eq 'codex') {
-    $source = Join-Path $ToolkitRoot 'runtimes/codex/CODEX_TEMPLATE.md'
-    $dest = Join-Path $ProjectRoot 'CODEX.md'
-    Copy-File -SourcePath $source -DestinationPath $dest -Overwrite $Overwrite
-    return
-  }
-
-  if ($RuntimeName -eq 'claude') {
-    $source = Join-Path $ToolkitRoot 'runtimes/claude/CLAUDE_TEMPLATE.md'
-    $dest = Join-Path $ProjectRoot 'CLAUDE.md'
-    Copy-File -SourcePath $source -DestinationPath $dest -Overwrite $Overwrite
-    return
-  }
-
-  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
-$apiDesignRulesPath = Join-Path $toolkitRoot 'templates/docs/api/API_DESIGN_CREATION_RULES.md'
-$apiDesignRulesHash = Get-FileSha256 -Path $apiDesignRulesPath
-$flowActionRulesPath = Join-Path $toolkitRoot 'templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md'
-$flowActionRulesHash = Get-FileSha256 -Path $flowActionRulesPath
-
-if (-not $ProjectPath) {
-  $ProjectPath = (Resolve-Path (Join-Path $toolkitRoot '..')).Path
-}
-$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"
-  Write-Host "Runtime      : $Runtime"
-  if ($canonicalRulesHash) {
-    Write-Host "API ruleset  : $canonicalRulesPath"
-    Write-Host "Ruleset hash : $canonicalRulesHash"
-  } else {
-    Write-Warning "API ruleset not found: $canonicalRulesPath"
-  }
-  if ($apiDesignRulesHash) {
-    Write-Host "API design ruleset: $apiDesignRulesPath"
-    Write-Host "Ruleset hash      : $apiDesignRulesHash"
-  } else {
-    Write-Warning "API design ruleset not found: $apiDesignRulesPath"
-  }
-  if ($flowActionRulesHash) {
-    Write-Host "Flow ruleset : $flowActionRulesPath"
-    Write-Host "Ruleset hash : $flowActionRulesHash"
-  } else {
-    Write-Warning "Flow ruleset not found: $flowActionRulesPath"
-  }
-}
-
-Copy-File -SourcePath (Join-Path $toolkitRoot 'AGENTS.md') -DestinationPath (Join-Path $projectRoot 'AGENTS.md') -Overwrite ([bool]$Force)
-Copy-File -SourcePath (Join-Path $toolkitRoot 'sdtk.config.json') -DestinationPath (Join-Path $projectRoot 'sdtk.config.json') -Overwrite ([bool]$Force)
-Copy-File -SourcePath (Join-Path $toolkitRoot 'sdtk.config.profiles.example.json') -DestinationPath (Join-Path $projectRoot 'sdtk.config.profiles.example.json') -Overwrite ([bool]$Force)
-Install-RuntimeAdapter -ToolkitRoot $toolkitRoot -ProjectRoot $projectRoot -RuntimeName $Runtime -Overwrite ([bool]$Force)
-
-if (($Runtime -eq 'codex') -and (-not $SkipSkills)) {
-  $skillInstaller = Join-Path $toolkitRoot 'scripts/install-codex-skills.ps1'
-  if (-not (Test-Path -LiteralPath $skillInstaller)) {
-    throw "Missing skill installer script: $skillInstaller"
-  }
-
-  Write-Host ""
-  Write-Host "Installing Codex skills (scope: $Scope)..."
-  if ($Force) {
-    & $skillInstaller -Scope $Scope -Force | Out-Host
-  } else {
-    & $skillInstaller -Scope $Scope | Out-Host
-  }
-}
-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) {
-  Write-Host ""
-  Write-Host "Install complete."
-  Write-Host "Next:"
-  Write-Host "1) Edit project config: $((Join-Path $projectRoot 'sdtk.config.json'))"
-  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 + 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,54 +0,0 @@
-# CLAUDE.md
-
-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.
-
-## 1) Rule Priority
-1. Explicit user request
-2. `AGENTS.md` (project root)
-3. Installed skill content (`.claude/skills/*/SKILL.md`)
-4. This file (`CLAUDE.md`)
-5. `sdtk.config.json`
-
-## 2) Runtime Model
-- Primary workflow: 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 `/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) 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/runtimes/codex/CODEX_TEMPLATE.md

@@ -1,32 +0,0 @@
-# CODEX.md
-
-Version: 1.0
-Last Updated: 2026-02-25
-Owner: SDTK Core Team
-
-This file defines runtime guidance for Codex sessions in projects using SDTK.
-
-## 1) Rule Priority
-1. Explicit user request
-2. `AGENTS.md` (project root)
-3. `toolkit/AGENTS.md`
-4. This file (`CODEX.md`)
-5. Other supporting docs
-
-## 2) Runtime Model
-- Primary workflow: PM -> BA -> ARCH -> DEV -> QA
-- Role tags: `/pm`, `/ba`, `/arch`, `/dev`, `/qa`
-- Shared state files:
-  - `SHARED_PLANNING.md`
-  - `QUALITY_CHECKLIST.md`
-
-## 3) Minimal Session Flow
-1. Start with `/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`