sdtk-kit 0.3.0

package/README.md

@@ -0,0 +1,131 @@
+# sdtk-kit
+
+SDTK CLI -- deterministic documentation toolkit for software teams.
+
+Wraps the SDTK PowerShell toolkit for portable, reproducible feature documentation scaffolding.
+
+## Install
+
+```bash
+npm install -g sdtk-kit
+# or link locally for development:
+npm link
+```
+
+## Quick Start
+
+```bash
+# 1. Initialize workspace with runtime adapter
+sdtk init --runtime codex
+
+# 2. Store GitHub token for entitlement
+sdtk auth --token ghp_xxxxxxxxxxxx
+sdtk auth --verify
+
+# 3. Generate feature documentation (17 files)
+sdtk generate --feature-key USER_PROFILE --feature-name "User Profile"
+```
+
+## Commands
+
+### `sdtk init`
+
+Initialize SDTK workspace in the current or specified project directory.
+
+```bash
+sdtk init --runtime <codex|claude> [--project-path <path>] [--force] [--skip-skills]
+```
+
+Creates:
+- `AGENTS.md` -- project-level agent guidance
+- `sdtk.config.json` -- project configuration
+- `sdtk.config.profiles.example.json` -- stack profile examples
+- `CODEX.md` or `CLAUDE.md` -- runtime adapter
+
+### `sdtk auth`
+
+Manage GitHub authentication and verify entitlement.
+
+```bash
+sdtk auth --token <value>   # store PAT
+sdtk auth --verify           # check repo access
+sdtk auth --status           # show auth state
+sdtk auth --logout           # clear credentials
+```
+
+#### Entitlement repo override
+
+By default, `sdtk auth --verify` checks access against the built-in private repo. You can override this with the `SDTK_ENTITLEMENT_REPO` environment variable:
+
+```bash
+# bash / zsh
+export SDTK_ENTITLEMENT_REPO=owner/repo
+sdtk auth --verify
+```
+
+```powershell
+# PowerShell
+$env:SDTK_ENTITLEMENT_REPO="owner/repo"
+sdtk auth --verify
+```
+
+### `sdtk generate`
+
+Generate feature documentation from templates. Produces 17 files matching the SDTK toolkit contract.
+
+```bash
+sdtk generate --feature-key <UPPER_SNAKE_CASE> --feature-name "<text>" [--project-path <path>] [--force] [--validate-only]
+```
+
+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 --help` / `sdtk --version`
+
+```bash
+sdtk --help
+sdtk --version
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | Validation or user error (bad args, missing auth) |
+| 2 | Dependency error (PowerShell not found) |
+| 3 | Integrity error (payload hash mismatch) |
+| 4 | Unexpected internal error |
+
+## Requirements
+
+- Node.js >= 18.13.0
+- PowerShell (Windows PowerShell 5.1+ or PowerShell Core)
+
+## Troubleshooting
+
+**PowerShell not found**
+- Ensure `powershell.exe` (Windows) or `pwsh` (macOS/Linux) is in your PATH.
+
+**Invalid or expired token**
+- Run `sdtk auth --token <new-token>` with a valid GitHub PAT.
+
+**No repository access**
+- Verify your token has access to the private distribution repo with `sdtk auth --verify`.
+- If your organization uses a custom entitlement repo, set `SDTK_ENTITLEMENT_REPO=owner/repo` before running `--verify`.
+
+**Payload hash mismatch**
+- The bundled toolkit payload may be corrupted. Reinstall the package.
+
+## Development
+
+```bash
+# Sync toolkit payload from repo root
+npm run build:payload
+
+# Verify payload integrity
+npm run verify:payload
+
+# Smoke test npm pack
+npm run pack:smoke
+```
+

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

@@ -0,0 +1,303 @@
+{
+    "buildTimestamp":  "2026-03-01T02:47:01Z",
+    "files":  [
+                  {
+                      "path":  "toolkit/AGENTS.md",
+                      "sha256":  "9f86a4c75be4c2dfb9a122bd836eecf24b5b8675ba628535df51157984e3d02b",
+                      "size":  4883
+                  },
+                  {
+                      "path":  "toolkit/install.ps1",
+                      "sha256":  "cc717ae87a0dbcf5aef2204d45211fe59f9506f9d03314eb283eddb3a5997279",
+                      "size":  5519
+                  },
+                  {
+                      "path":  "toolkit/runtimes/claude/CLAUDE_TEMPLATE.md",
+                      "sha256":  "fdf45036d4c0079cdb03e65efb7b5a84ea130e67a4c82522bb93c2bb73aa6661",
+                      "size":  882
+                  },
+                  {
+                      "path":  "toolkit/runtimes/codex/CODEX_TEMPLATE.md",
+                      "sha256":  "4154c15c71f44d2f2caf07fb41722fa65d4f9ec7e78f798ee084effd12345c62",
+                      "size":  874
+                  },
+                  {
+                      "path":  "toolkit/scripts/init-feature.ps1",
+                      "sha256":  "4e44c36964f1933e09aaa92ac9764d5eb7f39dfa00a0ce7d5a649d217f848b04",
+                      "size":  10047
+                  },
+                  {
+                      "path":  "toolkit/scripts/install-codex-skills.ps1",
+                      "sha256":  "68a82e421d0309e47cdb79e949b1044c17375ad7fd52e2ab9ccdc9dd33f8cdd0",
+                      "size":  9175
+                  },
+                  {
+                      "path":  "toolkit/scripts/uninstall-codex-skills.ps1",
+                      "sha256":  "e0d462bd6dcdb17cc003d459063ff341bd2e4f60b245cda9b7e9b9e94b3cf01f",
+                      "size":  3550
+                  },
+                  {
+                      "path":  "toolkit/sdtk.config.json",
+                      "sha256":  "de2921da9ce504487d9c7d97bf862b65d0ba00b9f1593a4fbfadf41ac36adb49",
+                      "size":  1000
+                  },
+                  {
+                      "path":  "toolkit/sdtk.config.profiles.example.json",
+                      "sha256":  "21b1b0212f85c76dc6a89ae5936b39c4c1df7837a333f7a3db337f3039babb7b",
+                      "size":  1540
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_CREATION_RULES.md",
+                      "sha256":  "6b76ca144f2324ab54fed3bc19f77d85ef1b956840a546dc225a73feb94e5108",
+                      "size":  6541
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-api-design-spec/references/FLOWCHART_CREATION_RULES.md",
+                      "sha256":  "a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b",
+                      "size":  16047
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-api-design-spec/scripts/generate_api_design_detail.py",
+                      "sha256":  "33b80ae976c546ae3c1a51fb6263184f2003453d587828ef3ef0a25df9595c40",
+                      "size":  20474
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-api-design-spec/SKILL.md",
+                      "sha256":  "33509e68380318c4275dfd31f4ab195ccbd2812e8b6c6b6d56419d27451c85e2",
+                      "size":  3329
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-api-doc/references/FLOWCHART_CREATION_RULES.md",
+                      "sha256":  "a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b",
+                      "size":  16047
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-api-doc/SKILL.md",
+                      "sha256":  "0bcf24b32a41c21a97e8a4726ca7b17a5eef160adb3f381bd781f40682949bc3",
+                      "size":  1849
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-arch/references/API_DESIGN_CREATION_RULES.md",
+                      "sha256":  "6b76ca144f2324ab54fed3bc19f77d85ef1b956840a546dc225a73feb94e5108",
+                      "size":  6541
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-arch/references/FLOW_ACTION_SPEC_CREATION_RULES.md",
+                      "sha256":  "b1ed7f7cad8f4098bd305fa9aaea6cdf1c78cf909284547baa50235fa677d8c0",
+                      "size":  5741
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-arch/references/FLOWCHART_CREATION_RULES.md",
+                      "sha256":  "a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b",
+                      "size":  16047
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-arch/SKILL.md",
+                      "sha256":  "568d55f947888581cd169774db3a6f486b3ac9b72937906d023faa6c1051bf32",
+                      "size":  2414
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-ba/SKILL.md",
+                      "sha256":  "7bc02ad898b5e7dc36282026dcc718818600a507d18046a9e80d8e6eba588131",
+                      "size":  1041
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-design-layout/SKILL.md",
+                      "sha256":  "8eabb7bdb821a91766ccd5b5fdcc1a4e876b51052cd6c6429b98b4d9946e2b1a",
+                      "size":  718
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-dev/SKILL.md",
+                      "sha256":  "7a7f5a799247896a8ddebc5cefec25450bf9284d34044b6b69b13e4535c005a1",
+                      "size":  1006
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-dev-backend/SKILL.md",
+                      "sha256":  "4b242b5f86d0074538e14721cc66c0fbaac5757e984796145f5e4477c89c6729",
+                      "size":  820
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-dev-frontend/SKILL.md",
+                      "sha256":  "390d895ab5da1fd214efecdbbd13c81e92815d4db157a7e9e8f32c79e09439dd",
+                      "size":  779
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-orchestrator/SKILL.md",
+                      "sha256":  "e6560b5a0c893d66117eedac3762bb0758553a80bcd1e7c24c84ba91f6ab7f9c",
+                      "size":  2868
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-pm/SKILL.md",
+                      "sha256":  "7dd81943172b1d7a96093424b0ba76519db3d713272374d5c4aedb15f37adbe2",
+                      "size":  1480
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-qa/SKILL.md",
+                      "sha256":  "c221eb80c68ba8672fb8a3c13fd6b36d5b65ccdd9988a32be88c6589c4594498",
+                      "size":  1142
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-screen-design-spec/references/excel-image-export.md",
+                      "sha256":  "97f65fd84c80e4836c9bbb82d8b7fc81527336c55dbbd82ea5e69672e21b22e4",
+                      "size":  2046
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-screen-design-spec/references/figma-mcp.md",
+                      "sha256":  "a9b414a07d76e63331ffc832dea2381357f9a99e2cd82ea74f713b3a9d7acee7",
+                      "size":  1905
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-screen-design-spec/references/FLOW_ACTION_SPEC_CREATION_RULES.md",
+                      "sha256":  "b1ed7f7cad8f4098bd305fa9aaea6cdf1c78cf909284547baa50235fa677d8c0",
+                      "size":  5741
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-screen-design-spec/references/numbering-rules.md",
+                      "sha256":  "4edd3318634fbc142f1ce3161fc3ac93d901a6bb7f0add1d1bed7fc25293c4d9",
+                      "size":  3833
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-screen-design-spec/scripts/renumber_flow_action_spec_global.py",
+                      "sha256":  "b54b14cc75c02c3fe9f89547b3f09baf1d7d036ef5f3d9f40487516e22351c45",
+                      "size":  3950
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-screen-design-spec/scripts/validate_flow_action_spec_numbering.py",
+                      "sha256":  "ae0bc9b120c19a142f10cc79168a8f7d6bf8a37e48341fc16cbc74bbdc2e692c",
+                      "size":  8481
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-screen-design-spec/SKILL.md",
+                      "sha256":  "876d546e077ce451082792776360a4a309cc79a34c74234f1b55f80c56b159d1",
+                      "size":  2996
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-test-case-spec/references/TEST_CASE_CREATION_RULES.md",
+                      "sha256":  "7c21e74f5eee712c6b65665b4f10483ed008113186a92dc0a4673ce1fcd3ef5c",
+                      "size":  3765
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-test-case-spec/scripts/validate_test_case_spec.py",
+                      "sha256":  "4d1e813908114f2be68007fb7373973e2c6e0aebc5a6305b8b19443d5ae477d0",
+                      "size":  2889
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-test-case-spec/SKILL.md",
+                      "sha256":  "72ca16e07c286910333243954610e116217ca2abb3a5e276cbe91e92eb826ad5",
+                      "size":  2652
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/api/API_DESIGN_CREATION_RULES.md",
+                      "sha256":  "6b76ca144f2324ab54fed3bc19f77d85ef1b956840a546dc225a73feb94e5108",
+                      "size":  6541
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/api/API_DESIGN_DETAIL_TEMPLATE.md",
+                      "sha256":  "0a22d18756ed1f95cb8b841643eff95e9c03d5b350e6d4a55c71b553d0d35b7a",
+                      "size":  1173
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/api/API_ENDPOINTS_TEMPLATE.md",
+                      "sha256":  "b79febaeefe8be7dbeec2d29f9c095f159629b8a19d99d3e2a46ff3620786e8d",
+                      "size":  5055
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/api/feature_api_flow_list_TEMPLATE.txt",
+                      "sha256":  "56e2b2a150ff737b856bb75e58fea603d09fe5c26d9fe5d5ea0516b4eb4703e8",
+                      "size":  211
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/api/FEATURE_API_TEMPLATE.yaml",
+                      "sha256":  "7a86c642f2d5826b2ce76fddb8ed0bcb300af4eb654e70e16576057927654d7a",
+                      "size":  361
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/api/FLOWCHART_CREATION_RULES.md",
+                      "sha256":  "a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b",
+                      "size":  16047
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/architecture/ARCH_DESIGN_TEMPLATE.md",
+                      "sha256":  "bc32ad83f06dc60ada7312f8d05f56b12da2d5e99c275fbc7895cf1e34a6c358",
+                      "size":  2414
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/database/DATABASE_SPEC_TEMPLATE.md",
+                      "sha256":  "d4cec8811e2a336a0ab8dd6e68998753cf7eca927207cdb8afc20666a5c452f7",
+                      "size":  4700
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/design/DESIGN_LAYOUT_TEMPLATE.md",
+                      "sha256":  "fdc466bdf39a3678e8e3ef005cb3416eedacf681c2d56edbe17e9dfb22db21fd",
+                      "size":  845
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/dev/FEATURE_IMPL_PLAN_TEMPLATE.md",
+                      "sha256":  "b7bb3ed90857029f3e7c38f628bac8e04f4ba0ea506c9bbf940765da55b19df1",
+                      "size":  1724
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/product/BACKLOG_TEMPLATE.md",
+                      "sha256":  "35488641da64f1bca10c985f66c495da85257d193aad1879a5bd9152e6bbc8c5",
+                      "size":  1085
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/product/PRD_TEMPLATE.md",
+                      "sha256":  "8c04fe6dcfdc1f2de178dddcafe9ea92803f1a94b1bbc9ef351be632cf04af94",
+                      "size":  1718
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/product/PROJECT_INITIATION_TEMPLATE.md",
+                      "sha256":  "b6f24e7cc11e1f944847df7c314a95efe6341fcb7026c03f54516eec6e5cc007",
+                      "size":  2369
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/qa/QA_RELEASE_REPORT_TEMPLATE.md",
+                      "sha256":  "e8d3554fc4893a8a57fbf006e58f37f21347de5f31ce02f0717e97d29b387eea",
+                      "size":  1409
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/qa/TEST_CASE_CREATION_RULES.md",
+                      "sha256":  "7c21e74f5eee712c6b65665b4f10483ed008113186a92dc0a4673ce1fcd3ef5c",
+                      "size":  3765
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/qa/TEST_CASE_TEMPLATE.md",
+                      "sha256":  "4b64a123d6e22edefa17a23a1eff766cf612ec5fa2f78b34bf50eecb39abf06a",
+                      "size":  3306
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/specs/BA_SPEC_TEMPLATE.md",
+                      "sha256":  "3b5f911d5e0eb042efc388ef3a441285a57d2dc02ae032d080934495e2d06f4d",
+                      "size":  3476
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md",
+                      "sha256":  "b1ed7f7cad8f4098bd305fa9aaea6cdf1c78cf909284547baa50235fa677d8c0",
+                      "size":  5741
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/specs/FLOW_ACTION_SPEC_TEMPLATE.md",
+                      "sha256":  "afa6ac33875037495e28238a2c3fae2f4dcbb12f318c3cec0696fe45465cdf2a",
+                      "size":  4135
+                  },
+                  {
+                      "path":  "toolkit/templates/QUALITY_CHECKLIST.md",
+                      "sha256":  "f9dc0d49ceeeb8814d77670e43f09b5221f46d406fb1e89eb575c1ab39bc022a",
+                      "size":  6500
+                  },
+                  {
+                      "path":  "toolkit/templates/README.md",
+                      "sha256":  "065b5b536aa7adc7447b54d862ff41340b38d7cbf8f1e4b4fed69abcb45a97a9",
+                      "size":  2151
+                  },
+                  {
+                      "path":  "toolkit/templates/SHARED_PLANNING.md",
+                      "sha256":  "2b5d4d10019e3c9b3219d92b8123acc85872d9c76230107206e7a270a5ece5a2",
+                      "size":  3255
+                  }
+              ],
+    "sourceCommit":  "23d2a15f3107eecec328abe120de2d1d8f53b02d",
+    "version":  "0.2.0",
+    "fileCount":  59
+}

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

@@ -0,0 +1,59 @@
+9f86a4c75be4c2dfb9a122bd836eecf24b5b8675ba628535df51157984e3d02b  toolkit/AGENTS.md
+cc717ae87a0dbcf5aef2204d45211fe59f9506f9d03314eb283eddb3a5997279  toolkit/install.ps1
+fdf45036d4c0079cdb03e65efb7b5a84ea130e67a4c82522bb93c2bb73aa6661  toolkit/runtimes/claude/CLAUDE_TEMPLATE.md
+4154c15c71f44d2f2caf07fb41722fa65d4f9ec7e78f798ee084effd12345c62  toolkit/runtimes/codex/CODEX_TEMPLATE.md
+4e44c36964f1933e09aaa92ac9764d5eb7f39dfa00a0ce7d5a649d217f848b04  toolkit/scripts/init-feature.ps1
+68a82e421d0309e47cdb79e949b1044c17375ad7fd52e2ab9ccdc9dd33f8cdd0  toolkit/scripts/install-codex-skills.ps1
+e0d462bd6dcdb17cc003d459063ff341bd2e4f60b245cda9b7e9b9e94b3cf01f  toolkit/scripts/uninstall-codex-skills.ps1
+de2921da9ce504487d9c7d97bf862b65d0ba00b9f1593a4fbfadf41ac36adb49  toolkit/sdtk.config.json
+21b1b0212f85c76dc6a89ae5936b39c4c1df7837a333f7a3db337f3039babb7b  toolkit/sdtk.config.profiles.example.json
+6b76ca144f2324ab54fed3bc19f77d85ef1b956840a546dc225a73feb94e5108  toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_CREATION_RULES.md
+a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b  toolkit/skills/sdtk-api-design-spec/references/FLOWCHART_CREATION_RULES.md
+33b80ae976c546ae3c1a51fb6263184f2003453d587828ef3ef0a25df9595c40  toolkit/skills/sdtk-api-design-spec/scripts/generate_api_design_detail.py
+33509e68380318c4275dfd31f4ab195ccbd2812e8b6c6b6d56419d27451c85e2  toolkit/skills/sdtk-api-design-spec/SKILL.md
+a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b  toolkit/skills/sdtk-api-doc/references/FLOWCHART_CREATION_RULES.md
+0bcf24b32a41c21a97e8a4726ca7b17a5eef160adb3f381bd781f40682949bc3  toolkit/skills/sdtk-api-doc/SKILL.md
+6b76ca144f2324ab54fed3bc19f77d85ef1b956840a546dc225a73feb94e5108  toolkit/skills/sdtk-arch/references/API_DESIGN_CREATION_RULES.md
+b1ed7f7cad8f4098bd305fa9aaea6cdf1c78cf909284547baa50235fa677d8c0  toolkit/skills/sdtk-arch/references/FLOW_ACTION_SPEC_CREATION_RULES.md
+a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b  toolkit/skills/sdtk-arch/references/FLOWCHART_CREATION_RULES.md
+568d55f947888581cd169774db3a6f486b3ac9b72937906d023faa6c1051bf32  toolkit/skills/sdtk-arch/SKILL.md
+7bc02ad898b5e7dc36282026dcc718818600a507d18046a9e80d8e6eba588131  toolkit/skills/sdtk-ba/SKILL.md
+8eabb7bdb821a91766ccd5b5fdcc1a4e876b51052cd6c6429b98b4d9946e2b1a  toolkit/skills/sdtk-design-layout/SKILL.md
+7a7f5a799247896a8ddebc5cefec25450bf9284d34044b6b69b13e4535c005a1  toolkit/skills/sdtk-dev/SKILL.md
+4b242b5f86d0074538e14721cc66c0fbaac5757e984796145f5e4477c89c6729  toolkit/skills/sdtk-dev-backend/SKILL.md
+390d895ab5da1fd214efecdbbd13c81e92815d4db157a7e9e8f32c79e09439dd  toolkit/skills/sdtk-dev-frontend/SKILL.md
+e6560b5a0c893d66117eedac3762bb0758553a80bcd1e7c24c84ba91f6ab7f9c  toolkit/skills/sdtk-orchestrator/SKILL.md
+7dd81943172b1d7a96093424b0ba76519db3d713272374d5c4aedb15f37adbe2  toolkit/skills/sdtk-pm/SKILL.md
+c221eb80c68ba8672fb8a3c13fd6b36d5b65ccdd9988a32be88c6589c4594498  toolkit/skills/sdtk-qa/SKILL.md
+97f65fd84c80e4836c9bbb82d8b7fc81527336c55dbbd82ea5e69672e21b22e4  toolkit/skills/sdtk-screen-design-spec/references/excel-image-export.md
+a9b414a07d76e63331ffc832dea2381357f9a99e2cd82ea74f713b3a9d7acee7  toolkit/skills/sdtk-screen-design-spec/references/figma-mcp.md
+b1ed7f7cad8f4098bd305fa9aaea6cdf1c78cf909284547baa50235fa677d8c0  toolkit/skills/sdtk-screen-design-spec/references/FLOW_ACTION_SPEC_CREATION_RULES.md
+4edd3318634fbc142f1ce3161fc3ac93d901a6bb7f0add1d1bed7fc25293c4d9  toolkit/skills/sdtk-screen-design-spec/references/numbering-rules.md
+b54b14cc75c02c3fe9f89547b3f09baf1d7d036ef5f3d9f40487516e22351c45  toolkit/skills/sdtk-screen-design-spec/scripts/renumber_flow_action_spec_global.py
+ae0bc9b120c19a142f10cc79168a8f7d6bf8a37e48341fc16cbc74bbdc2e692c  toolkit/skills/sdtk-screen-design-spec/scripts/validate_flow_action_spec_numbering.py
+876d546e077ce451082792776360a4a309cc79a34c74234f1b55f80c56b159d1  toolkit/skills/sdtk-screen-design-spec/SKILL.md
+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
+6b76ca144f2324ab54fed3bc19f77d85ef1b956840a546dc225a73feb94e5108  toolkit/templates/docs/api/API_DESIGN_CREATION_RULES.md
+0a22d18756ed1f95cb8b841643eff95e9c03d5b350e6d4a55c71b553d0d35b7a  toolkit/templates/docs/api/API_DESIGN_DETAIL_TEMPLATE.md
+b79febaeefe8be7dbeec2d29f9c095f159629b8a19d99d3e2a46ff3620786e8d  toolkit/templates/docs/api/API_ENDPOINTS_TEMPLATE.md
+56e2b2a150ff737b856bb75e58fea603d09fe5c26d9fe5d5ea0516b4eb4703e8  toolkit/templates/docs/api/feature_api_flow_list_TEMPLATE.txt
+7a86c642f2d5826b2ce76fddb8ed0bcb300af4eb654e70e16576057927654d7a  toolkit/templates/docs/api/FEATURE_API_TEMPLATE.yaml
+a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b  toolkit/templates/docs/api/FLOWCHART_CREATION_RULES.md
+bc32ad83f06dc60ada7312f8d05f56b12da2d5e99c275fbc7895cf1e34a6c358  toolkit/templates/docs/architecture/ARCH_DESIGN_TEMPLATE.md
+d4cec8811e2a336a0ab8dd6e68998753cf7eca927207cdb8afc20666a5c452f7  toolkit/templates/docs/database/DATABASE_SPEC_TEMPLATE.md
+fdc466bdf39a3678e8e3ef005cb3416eedacf681c2d56edbe17e9dfb22db21fd  toolkit/templates/docs/design/DESIGN_LAYOUT_TEMPLATE.md
+b7bb3ed90857029f3e7c38f628bac8e04f4ba0ea506c9bbf940765da55b19df1  toolkit/templates/docs/dev/FEATURE_IMPL_PLAN_TEMPLATE.md
+35488641da64f1bca10c985f66c495da85257d193aad1879a5bd9152e6bbc8c5  toolkit/templates/docs/product/BACKLOG_TEMPLATE.md
+8c04fe6dcfdc1f2de178dddcafe9ea92803f1a94b1bbc9ef351be632cf04af94  toolkit/templates/docs/product/PRD_TEMPLATE.md
+b6f24e7cc11e1f944847df7c314a95efe6341fcb7026c03f54516eec6e5cc007  toolkit/templates/docs/product/PROJECT_INITIATION_TEMPLATE.md
+e8d3554fc4893a8a57fbf006e58f37f21347de5f31ce02f0717e97d29b387eea  toolkit/templates/docs/qa/QA_RELEASE_REPORT_TEMPLATE.md
+7c21e74f5eee712c6b65665b4f10483ed008113186a92dc0a4673ce1fcd3ef5c  toolkit/templates/docs/qa/TEST_CASE_CREATION_RULES.md
+4b64a123d6e22edefa17a23a1eff766cf612ec5fa2f78b34bf50eecb39abf06a  toolkit/templates/docs/qa/TEST_CASE_TEMPLATE.md
+3b5f911d5e0eb042efc388ef3a441285a57d2dc02ae032d080934495e2d06f4d  toolkit/templates/docs/specs/BA_SPEC_TEMPLATE.md
+b1ed7f7cad8f4098bd305fa9aaea6cdf1c78cf909284547baa50235fa677d8c0  toolkit/templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md
+afa6ac33875037495e28238a2c3fae2f4dcbb12f318c3cec0696fe45465cdf2a  toolkit/templates/docs/specs/FLOW_ACTION_SPEC_TEMPLATE.md
+f9dc0d49ceeeb8814d77670e43f09b5221f46d406fb1e89eb575c1ab39bc022a  toolkit/templates/QUALITY_CHECKLIST.md
+065b5b536aa7adc7447b54d862ff41340b38d7cbf8f1e4b4fed69abcb45a97a9  toolkit/templates/README.md
+2b5d4d10019e3c9b3219d92b8123acc85872d9c76230107206e7a270a5ece5a2  toolkit/templates/SHARED_PLANNING.md

package/assets/toolkit/toolkit/AGENTS.md

@@ -0,0 +1,103 @@
+# 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.
+
+## 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`
+
+## 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:
+
+`powershell -ExecutionPolicy Bypass -File ".\\toolkit\\scripts\\init-feature.ps1" -FeatureKey YOUR_FEATURE -FeatureName "Your Feature"`
+
+Or create artifacts manually from templates in `toolkit/templates/`.
+
+## 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.
+
+## 7) Mandatory Rule References
+- API YAML and flow docs:
+  - `toolkit/templates/docs/api/FLOWCHART_CREATION_RULES.md`
+- API design detail docs:
+  - `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).
+