sdtk-kit 0.3.6 → 0.3.8

package/README.md

@@ -4,6 +4,10 @@ SDTK CLI -- deterministic documentation toolkit for software teams.
 
 Wraps the SDTK PowerShell toolkit for portable, reproducible feature documentation scaffolding.
 
+Canonical install/runtime source in the source repo: `governance/ai/cli/SDTK_RUNTIME_AND_FEATURE_STATUS.md`
+
+Generated skills include verification gates and two-stage review hard gates. The current source baseline also ships a canonical skill catalog, handoff templates, public example packs, and a runtime readiness audit. See `toolkit/SDTK_TOOLKIT.md` for workflow quality contracts.
+
 ## Install
 
 ```bash
@@ -22,13 +26,15 @@ sdtk init --runtime claude
 sdtk auth --token ghp_xxxxxxxxxxxx
 sdtk auth --verify
 
-# 3. Generate feature documentation (17 files)
+# 3. Generate feature documentation (17-file scaffold)
 sdtk generate --feature-key USER_PROFILE --feature-name "User Profile"
 # Codex runtime remains available:
 # sdtk init --runtime codex
 
 ```
 
+The CLI generates the scaffold contract only. Full content enrichment still runs phase-by-phase through PM, BA, ARCH, DEV, and QA using the installed runtime guidance plus the toolkit docs.
+
 ## Commands
 
 ### `sdtk init`
@@ -166,3 +172,6 @@ npm run verify:payload
 # Smoke test npm pack
 npm run pack:smoke
 ```
+
+Run `tests/skill_triggering/` to validate skill routing behavior.
+

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

@@ -1,13 +1,13 @@
 {
-    "version":  "0.3.6",
-    "sourceCommit":  "f15ad683ea08ad6974f2f6c6572a95411be3eac0",
-    "buildTimestamp":  "2026-03-12T06:10:16Z",
-    "fileCount":  81,
+    "version":  "0.3.8",
+    "sourceCommit":  "9753d286b48644a330683e5570ffd1b2dbe18ffe",
+    "buildTimestamp":  "2026-03-19T02:33:04Z",
+    "fileCount":  93,
     "files":  [
                   {
                       "path":  "toolkit/AGENTS.md",
-                      "sha256":  "868430474b46e4e8d27ed26b780a794936e84cf4f0278f2cc3d061f54877f498",
-                      "size":  5113
+                      "sha256":  "f13f557e79ead09d5f57452d5ea7cbe192d12ac0a3de138a7a1a2514e44df505",
+                      "size":  6406
                   },
                   {
                       "path":  "toolkit/install.ps1",
@@ -61,13 +61,13 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_CREATION_RULES.md",
-                      "sha256":  "9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2",
-                      "size":  634
+                      "sha256":  "e169500521e556036ea550d7ea61031e27646eb7f65fd4a75a6a5c03f53eabc5",
+                      "size":  949
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_FLOWCHART_CREATION_RULES.md",
-                      "sha256":  "13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97",
-                      "size":  12827
+                      "sha256":  "d77095777dc689b545337fcdb8f61384936ed53ea9a0ca6bc8589975e284204b",
+                      "size":  13406
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-design-spec/references/FLOWCHART_CREATION_RULES.md",
@@ -81,13 +81,13 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-design-spec/SKILL.md",
-                      "sha256":  "49817620680d1abe9620c7615885e5d5e688982c98110db18bc3ce5fc79f01b4",
-                      "size":  3685
+                      "sha256":  "6b653f9858f5daa8ae4f2d425f28332676a60053d210aaf8ebccdadc3de9f026",
+                      "size":  3857
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-doc/references/API_DESIGN_FLOWCHART_CREATION_RULES.md",
-                      "sha256":  "13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97",
-                      "size":  12827
+                      "sha256":  "d77095777dc689b545337fcdb8f61384936ed53ea9a0ca6bc8589975e284204b",
+                      "size":  13406
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-doc/references/FLOWCHART_CREATION_RULES.md",
@@ -101,23 +101,23 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-doc/SKILL.md",
-                      "sha256":  "2c4bc8edda84f20bf05130fdf19b9abd562dd87b03508301dff9ccd877b52a2f",
-                      "size":  2248
+                      "sha256":  "dd23e42dbdbedf6d0f9f88788957ff8f7d3e6849b533c9d1a18326944dcdeda2",
+                      "size":  2441
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/references/API_DESIGN_CREATION_RULES.md",
-                      "sha256":  "9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2",
-                      "size":  634
+                      "sha256":  "e169500521e556036ea550d7ea61031e27646eb7f65fd4a75a6a5c03f53eabc5",
+                      "size":  949
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/references/API_DESIGN_FLOWCHART_CREATION_RULES.md",
-                      "sha256":  "13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97",
-                      "size":  12827
+                      "sha256":  "d77095777dc689b545337fcdb8f61384936ed53ea9a0ca6bc8589975e284204b",
+                      "size":  13406
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/references/FLOW_ACTION_SPEC_CREATION_RULES.md",
-                      "sha256":  "096c720bfb51cd44d2cf4241313f25874f9b6a1baa6874523a6ea8dcdb7a21b8",
-                      "size":  6736
+                      "sha256":  "e007db18ad55333a371be739f6ef7928316a5f6f55a9fbffcf6de9a821a02ff0",
+                      "size":  10052
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/references/FLOWCHART_CREATION_RULES.md",
@@ -131,48 +131,68 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/SKILL.md",
-                      "sha256":  "87ac00226478a8198ea9f218e221de8f49f34ccdae3fde2f26a5a1b6b7216feb",
-                      "size":  3156
+                      "sha256":  "469a274eca3ac8a353f67a6159feed430b6f14dee6f5a090248e202b51e8a5cd",
+                      "size":  5078
                   },
                   {
                       "path":  "toolkit/skills/sdtk-ba/SKILL.md",
-                      "sha256":  "0a7c6aa20be2e29aa2124355264ee45847df76f635437c2d05ddd26f7121f12e",
-                      "size":  1177
+                      "sha256":  "2548951bc437bf05066cbedb9adf71a66739eab7e4bbc920650fc9415cea6e8d",
+                      "size":  1383
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-design-layout/scripts/render_design_layout_images.py",
+                      "sha256":  "ee01a3daeeb4822429f4dcf530c11f15ac65df6700615beefd6c04c3fb41bbbc",
+                      "size":  6832
                   },
                   {
                       "path":  "toolkit/skills/sdtk-design-layout/SKILL.md",
-                      "sha256":  "8eabb7bdb821a91766ccd5b5fdcc1a4e876b51052cd6c6429b98b4d9946e2b1a",
-                      "size":  718
+                      "sha256":  "e3d739dd8167b3800075fabb4aa8458a29481b85626d8f6bb5ac2e76dd229527",
+                      "size":  1928
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-dev/prompts/code-quality-reviewer.md",
+                      "sha256":  "3d44bc436dab6201beeb4fed52ab3aa94791c51baca7b7b8e2e8a5ecd6c08baf",
+                      "size":  1125
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-dev/prompts/implementer.md",
+                      "sha256":  "9bed2859fbeee84257199e63eb471874975d26d57f5a19dcedab0c06980e24ad",
+                      "size":  1844
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-dev/prompts/spec-reviewer.md",
+                      "sha256":  "1dc33dd59afe48c4c78564bdb32999b9a4f34958361ad8f5580cef0e77c953ef",
+                      "size":  1222
                   },
                   {
                       "path":  "toolkit/skills/sdtk-dev/SKILL.md",
-                      "sha256":  "7a7f5a799247896a8ddebc5cefec25450bf9284d34044b6b69b13e4535c005a1",
-                      "size":  1006
+                      "sha256":  "9f30778b6b8a949e56f9d91398cfd386f834e380fa30e7802fc861dde39559a8",
+                      "size":  5626
                   },
                   {
                       "path":  "toolkit/skills/sdtk-dev-backend/SKILL.md",
-                      "sha256":  "4b242b5f86d0074538e14721cc66c0fbaac5757e984796145f5e4477c89c6729",
-                      "size":  820
+                      "sha256":  "dcb763d46fc49d977a7ef608541c36950ac6958da26729696e07f98082a07552",
+                      "size":  1009
                   },
                   {
                       "path":  "toolkit/skills/sdtk-dev-frontend/SKILL.md",
-                      "sha256":  "390d895ab5da1fd214efecdbbd13c81e92815d4db157a7e9e8f32c79e09439dd",
-                      "size":  779
+                      "sha256":  "097ea3e4870c855d3635d81ec462c3289e5589f51c5c3308534c4fd5ebe514aa",
+                      "size":  967
                   },
                   {
                       "path":  "toolkit/skills/sdtk-orchestrator/SKILL.md",
-                      "sha256":  "e6560b5a0c893d66117eedac3762bb0758553a80bcd1e7c24c84ba91f6ab7f9c",
-                      "size":  2868
+                      "sha256":  "16eed42e46c7d8a3ebda8887056e0b079cdc07be4699c7811eeb9a9f72a3b629",
+                      "size":  4525
                   },
                   {
                       "path":  "toolkit/skills/sdtk-pm/SKILL.md",
-                      "sha256":  "7dd81943172b1d7a96093424b0ba76519db3d713272374d5c4aedb15f37adbe2",
-                      "size":  1480
+                      "sha256":  "25d9335c9a395008f99fa683b44c0eca1ccccf9e66a64628b01c60d31d86e77f",
+                      "size":  1722
                   },
                   {
                       "path":  "toolkit/skills/sdtk-qa/SKILL.md",
-                      "sha256":  "564c536395227511ac9be215e41a3b5604e2f249da28319417ca75a6bfe8ed3b",
-                      "size":  1459
+                      "sha256":  "c6092cb13646afdd6d49ca2766b52b1265a542f0452fadd0b7c716478b0435b5",
+                      "size":  3221
                   },
                   {
                       "path":  "toolkit/skills/sdtk-screen-design-spec/references/excel-image-export.md",
@@ -186,8 +206,8 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-screen-design-spec/references/FLOW_ACTION_SPEC_CREATION_RULES.md",
-                      "sha256":  "096c720bfb51cd44d2cf4241313f25874f9b6a1baa6874523a6ea8dcdb7a21b8",
-                      "size":  6736
+                      "sha256":  "e007db18ad55333a371be739f6ef7928316a5f6f55a9fbffcf6de9a821a02ff0",
+                      "size":  10052
                   },
                   {
                       "path":  "toolkit/skills/sdtk-screen-design-spec/references/numbering-rules.md",
@@ -206,8 +226,8 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-screen-design-spec/SKILL.md",
-                      "sha256":  "6e66a8c258a94be377d756cf80835968aa30a66ba200a8ac151558ab5bb675d3",
-                      "size":  3771
+                      "sha256":  "36ddb765725ec9cc4b01fe02cac222cf7e621643bc1212bac6e073b942f3eee0",
+                      "size":  4446
                   },
                   {
                       "path":  "toolkit/skills/sdtk-test-case-spec/references/TEST_CASE_CREATION_RULES.md",
@@ -221,8 +241,13 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-test-case-spec/SKILL.md",
-                      "sha256":  "727a9870a455e9c455b2c405cb52c6b9867f229fa56d8ce9408e66b6f6cae4a5",
-                      "size":  2842
+                      "sha256":  "c4e9e276b440bbe0822fb0c0ff62d6eb0dea5e8fb25f1a9f342ebcf30a12b754",
+                      "size":  3414
+                  },
+                  {
+                      "path":  "toolkit/skills/skills.catalog.yaml",
+                      "sha256":  "9b1a4917cd1cccbacd11d3922319b2abdbc763f0b6906b1875f840ed967e4975",
+                      "size":  11782
                   },
                   {
                       "path":  "toolkit/skills-claude/api-design-spec/SKILL.md",
@@ -291,18 +316,18 @@
                   },
                   {
                       "path":  "toolkit/templates/docs/api/API_DESIGN_CREATION_RULES.md",
-                      "sha256":  "9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2",
-                      "size":  634
+                      "sha256":  "e169500521e556036ea550d7ea61031e27646eb7f65fd4a75a6a5c03f53eabc5",
+                      "size":  949
                   },
                   {
                       "path":  "toolkit/templates/docs/api/API_DESIGN_DETAIL_TEMPLATE.md",
-                      "sha256":  "d2aa0ee3a7c5351700b3bffb4ba66e8056ed955f55903c744c694624730038cb",
-                      "size":  1181
+                      "sha256":  "7a13ed21baa2f8ccf2dc3a4ecdd2e30c90f0cbcbbcff06db2a64df6a8945b727",
+                      "size":  1300
                   },
                   {
                       "path":  "toolkit/templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md",
-                      "sha256":  "13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97",
-                      "size":  12827
+                      "sha256":  "d77095777dc689b545337fcdb8f61384936ed53ea9a0ca6bc8589975e284204b",
+                      "size":  13406
                   },
                   {
                       "path":  "toolkit/templates/docs/api/API_ENDPOINTS_TEMPLATE.md",
@@ -386,13 +411,48 @@
                   },
                   {
                       "path":  "toolkit/templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md",
-                      "sha256":  "096c720bfb51cd44d2cf4241313f25874f9b6a1baa6874523a6ea8dcdb7a21b8",
-                      "size":  6736
+                      "sha256":  "e007db18ad55333a371be739f6ef7928316a5f6f55a9fbffcf6de9a821a02ff0",
+                      "size":  10052
                   },
                   {
                       "path":  "toolkit/templates/docs/specs/FLOW_ACTION_SPEC_TEMPLATE.md",
-                      "sha256":  "df87638e4e997beeee22f1e6a5cbbab83b6ed5fe2bf0ac5f3b816a1e852bba5d",
-                      "size":  4386
+                      "sha256":  "97367b222dbe970c5b1f08fd72533d778a422cd209bc82f32dd67b9b98827f0f",
+                      "size":  4879
+                  },
+                  {
+                      "path":  "toolkit/templates/handoffs/ARCH_TO_DEV.md",
+                      "sha256":  "8af30132cee4a0e9740e56e678f292649b096a22a97d03d5c099480bcd19ad0a",
+                      "size":  1201
+                  },
+                  {
+                      "path":  "toolkit/templates/handoffs/BA_TO_ARCH.md",
+                      "sha256":  "e0195c1815bc14852d02e9ee57ebc1845df80c02a6d052a12f8ed12b82941cc3",
+                      "size":  919
+                  },
+                  {
+                      "path":  "toolkit/templates/handoffs/DEV_STAGE1_SPEC_REVIEW.md",
+                      "sha256":  "4450703248fa18c9d9a2c030cfe253c95fc812bc45a427c3b30b4312734b6684",
+                      "size":  1090
+                  },
+                  {
+                      "path":  "toolkit/templates/handoffs/DEV_STAGE2_CODE_QUALITY_REVIEW.md",
+                      "sha256":  "81a093320b911a27fdabfded87131135f63e4aeef3241e254147b33f68030d50",
+                      "size":  695
+                  },
+                  {
+                      "path":  "toolkit/templates/handoffs/DEV_TO_QA.md",
+                      "sha256":  "947751b720f7711c9ef6090a06a8d073988ea13d22b12712b4f192fb07fa338d",
+                      "size":  709
+                  },
+                  {
+                      "path":  "toolkit/templates/handoffs/PM_TO_BA.md",
+                      "sha256":  "98b927fe381984a229ff69ad294686595eb3ecc90129b461b8a33fb5cca61531",
+                      "size":  839
+                  },
+                  {
+                      "path":  "toolkit/templates/handoffs/QA_RELEASE_DECISION.md",
+                      "sha256":  "002ab3c8cc5f686de73060e1927675fa2a762d2ba62353eebd08bb7eb616c097",
+                      "size":  725
                   },
                   {
                       "path":  "toolkit/templates/QUALITY_CHECKLIST.md",

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

@@ -1,4 +1,4 @@
-868430474b46e4e8d27ed26b780a794936e84cf4f0278f2cc3d061f54877f498  toolkit/AGENTS.md
+f13f557e79ead09d5f57452d5ea7cbe192d12ac0a3de138a7a1a2514e44df505  toolkit/AGENTS.md
 e717a2791fb597d7a21f57f4c4790dbc545e954f0af3ca0c47f160f78c8a2474  toolkit/install.ps1
 0f3e0bfe1b5165250f0da4da5790a9e6220023752713088a0076eb7f17fd6397  toolkit/runtimes/claude/CLAUDE_TEMPLATE.md
 4154c15c71f44d2f2caf07fb41722fa65d4f9ec7e78f798ee084effd12345c62  toolkit/runtimes/codex/CODEX_TEMPLATE.md
@@ -9,39 +9,44 @@ ca64e0c2a0f13137bc6b780a57442de46a3e0551778bbcbadd4eb779c21cb203  toolkit/script
 e0d462bd6dcdb17cc003d459063ff341bd2e4f60b245cda9b7e9b9e94b3cf01f  toolkit/scripts/uninstall-codex-skills.ps1
 de2921da9ce504487d9c7d97bf862b65d0ba00b9f1593a4fbfadf41ac36adb49  toolkit/sdtk.config.json
 21b1b0212f85c76dc6a89ae5936b39c4c1df7837a333f7a3db337f3039babb7b  toolkit/sdtk.config.profiles.example.json
-9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2  toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_CREATION_RULES.md
-13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97  toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_FLOWCHART_CREATION_RULES.md
+e169500521e556036ea550d7ea61031e27646eb7f65fd4a75a6a5c03f53eabc5  toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_CREATION_RULES.md
+d77095777dc689b545337fcdb8f61384936ed53ea9a0ca6bc8589975e284204b  toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_FLOWCHART_CREATION_RULES.md
 decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f  toolkit/skills/sdtk-api-design-spec/references/FLOWCHART_CREATION_RULES.md
 c6147e7b01632cb6ffa017af43e4e5c9e1f98d160ed812ade1d087b1f3ca5490  toolkit/skills/sdtk-api-design-spec/scripts/generate_api_design_detail.py
-49817620680d1abe9620c7615885e5d5e688982c98110db18bc3ce5fc79f01b4  toolkit/skills/sdtk-api-design-spec/SKILL.md
-13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97  toolkit/skills/sdtk-api-doc/references/API_DESIGN_FLOWCHART_CREATION_RULES.md
+6b653f9858f5daa8ae4f2d425f28332676a60053d210aaf8ebccdadc3de9f026  toolkit/skills/sdtk-api-design-spec/SKILL.md
+d77095777dc689b545337fcdb8f61384936ed53ea9a0ca6bc8589975e284204b  toolkit/skills/sdtk-api-doc/references/API_DESIGN_FLOWCHART_CREATION_RULES.md
 decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f  toolkit/skills/sdtk-api-doc/references/FLOWCHART_CREATION_RULES.md
 f29c6774019ef0789dfb88678e1ab31d4d8eb7b3ab69b2115368ef5d879e5276  toolkit/skills/sdtk-api-doc/references/YAML_CREATION_RULES.md
-2c4bc8edda84f20bf05130fdf19b9abd562dd87b03508301dff9ccd877b52a2f  toolkit/skills/sdtk-api-doc/SKILL.md
-9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2  toolkit/skills/sdtk-arch/references/API_DESIGN_CREATION_RULES.md
-13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97  toolkit/skills/sdtk-arch/references/API_DESIGN_FLOWCHART_CREATION_RULES.md
-096c720bfb51cd44d2cf4241313f25874f9b6a1baa6874523a6ea8dcdb7a21b8  toolkit/skills/sdtk-arch/references/FLOW_ACTION_SPEC_CREATION_RULES.md
+dd23e42dbdbedf6d0f9f88788957ff8f7d3e6849b533c9d1a18326944dcdeda2  toolkit/skills/sdtk-api-doc/SKILL.md
+e169500521e556036ea550d7ea61031e27646eb7f65fd4a75a6a5c03f53eabc5  toolkit/skills/sdtk-arch/references/API_DESIGN_CREATION_RULES.md
+d77095777dc689b545337fcdb8f61384936ed53ea9a0ca6bc8589975e284204b  toolkit/skills/sdtk-arch/references/API_DESIGN_FLOWCHART_CREATION_RULES.md
+e007db18ad55333a371be739f6ef7928316a5f6f55a9fbffcf6de9a821a02ff0  toolkit/skills/sdtk-arch/references/FLOW_ACTION_SPEC_CREATION_RULES.md
 decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f  toolkit/skills/sdtk-arch/references/FLOWCHART_CREATION_RULES.md
 f29c6774019ef0789dfb88678e1ab31d4d8eb7b3ab69b2115368ef5d879e5276  toolkit/skills/sdtk-arch/references/YAML_CREATION_RULES.md
-87ac00226478a8198ea9f218e221de8f49f34ccdae3fde2f26a5a1b6b7216feb  toolkit/skills/sdtk-arch/SKILL.md
-0a7c6aa20be2e29aa2124355264ee45847df76f635437c2d05ddd26f7121f12e  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
-564c536395227511ac9be215e41a3b5604e2f249da28319417ca75a6bfe8ed3b  toolkit/skills/sdtk-qa/SKILL.md
+469a274eca3ac8a353f67a6159feed430b6f14dee6f5a090248e202b51e8a5cd  toolkit/skills/sdtk-arch/SKILL.md
+2548951bc437bf05066cbedb9adf71a66739eab7e4bbc920650fc9415cea6e8d  toolkit/skills/sdtk-ba/SKILL.md
+ee01a3daeeb4822429f4dcf530c11f15ac65df6700615beefd6c04c3fb41bbbc  toolkit/skills/sdtk-design-layout/scripts/render_design_layout_images.py
+e3d739dd8167b3800075fabb4aa8458a29481b85626d8f6bb5ac2e76dd229527  toolkit/skills/sdtk-design-layout/SKILL.md
+3d44bc436dab6201beeb4fed52ab3aa94791c51baca7b7b8e2e8a5ecd6c08baf  toolkit/skills/sdtk-dev/prompts/code-quality-reviewer.md
+9bed2859fbeee84257199e63eb471874975d26d57f5a19dcedab0c06980e24ad  toolkit/skills/sdtk-dev/prompts/implementer.md
+1dc33dd59afe48c4c78564bdb32999b9a4f34958361ad8f5580cef0e77c953ef  toolkit/skills/sdtk-dev/prompts/spec-reviewer.md
+9f30778b6b8a949e56f9d91398cfd386f834e380fa30e7802fc861dde39559a8  toolkit/skills/sdtk-dev/SKILL.md
+dcb763d46fc49d977a7ef608541c36950ac6958da26729696e07f98082a07552  toolkit/skills/sdtk-dev-backend/SKILL.md
+097ea3e4870c855d3635d81ec462c3289e5589f51c5c3308534c4fd5ebe514aa  toolkit/skills/sdtk-dev-frontend/SKILL.md
+16eed42e46c7d8a3ebda8887056e0b079cdc07be4699c7811eeb9a9f72a3b629  toolkit/skills/sdtk-orchestrator/SKILL.md
+25d9335c9a395008f99fa683b44c0eca1ccccf9e66a64628b01c60d31d86e77f  toolkit/skills/sdtk-pm/SKILL.md
+c6092cb13646afdd6d49ca2766b52b1265a542f0452fadd0b7c716478b0435b5  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
-096c720bfb51cd44d2cf4241313f25874f9b6a1baa6874523a6ea8dcdb7a21b8  toolkit/skills/sdtk-screen-design-spec/references/FLOW_ACTION_SPEC_CREATION_RULES.md
+e007db18ad55333a371be739f6ef7928316a5f6f55a9fbffcf6de9a821a02ff0  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
-6e66a8c258a94be377d756cf80835968aa30a66ba200a8ac151558ab5bb675d3  toolkit/skills/sdtk-screen-design-spec/SKILL.md
+36ddb765725ec9cc4b01fe02cac222cf7e621643bc1212bac6e073b942f3eee0  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
-727a9870a455e9c455b2c405cb52c6b9867f229fa56d8ce9408e66b6f6cae4a5  toolkit/skills/sdtk-test-case-spec/SKILL.md
+c4e9e276b440bbe0822fb0c0ff62d6eb0dea5e8fb25f1a9f342ebcf30a12b754  toolkit/skills/sdtk-test-case-spec/SKILL.md
+9b1a4917cd1cccbacd11d3922319b2abdbc763f0b6906b1875f840ed967e4975  toolkit/skills/skills.catalog.yaml
 123873681ff65792a9a269b264155c65a5feb68b23e4eeb1e68cb7da1a137d54  toolkit/skills-claude/api-design-spec/SKILL.md
 6f6ddb470bc61d286b84418e299b360d5f148e6bed75fa50b6c8f2929e6fe49c  toolkit/skills-claude/api-doc/SKILL.md
 e293fd71f9fc71ac63e5e53bf55fbfe9c71e186e298b2fd3429c71a4e972a8b1  toolkit/skills-claude/arch/SKILL.md
@@ -55,9 +60,9 @@ b34621fe61957e573c616ad816d591a60a6c8d1333d0bfb71f39f45b93331cb0  toolkit/skills
 3ab5af1b27aa0947052ef7b76abca132d89b78b74516b8668474c08c344289aa  toolkit/skills-claude/qa/SKILL.md
 5686da60872f1a3c6791e9a740897d4a564f40d53d54902a47fbc3165e68a1ec  toolkit/skills-claude/screen-design-spec/SKILL.md
 c397431a7752fcdee1dbb7720472703d262bfcc8fb543c4562fbc24a79064769  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
+e169500521e556036ea550d7ea61031e27646eb7f65fd4a75a6a5c03f53eabc5  toolkit/templates/docs/api/API_DESIGN_CREATION_RULES.md
+7a13ed21baa2f8ccf2dc3a4ecdd2e30c90f0cbcbbcff06db2a64df6a8945b727  toolkit/templates/docs/api/API_DESIGN_DETAIL_TEMPLATE.md
+d77095777dc689b545337fcdb8f61384936ed53ea9a0ca6bc8589975e284204b  toolkit/templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md
 7dd9840e7a9c268fd7671791c0e80cfbcf54c3c2ff8bbacd85e44662f238ac9c  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
@@ -74,8 +79,15 @@ e8d3554fc4893a8a57fbf006e58f37f21347de5f31ce02f0717e97d29b387eea  toolkit/templa
 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
-096c720bfb51cd44d2cf4241313f25874f9b6a1baa6874523a6ea8dcdb7a21b8  toolkit/templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md
-df87638e4e997beeee22f1e6a5cbbab83b6ed5fe2bf0ac5f3b816a1e852bba5d  toolkit/templates/docs/specs/FLOW_ACTION_SPEC_TEMPLATE.md
+e007db18ad55333a371be739f6ef7928316a5f6f55a9fbffcf6de9a821a02ff0  toolkit/templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md
+97367b222dbe970c5b1f08fd72533d778a422cd209bc82f32dd67b9b98827f0f  toolkit/templates/docs/specs/FLOW_ACTION_SPEC_TEMPLATE.md
+8af30132cee4a0e9740e56e678f292649b096a22a97d03d5c099480bcd19ad0a  toolkit/templates/handoffs/ARCH_TO_DEV.md
+e0195c1815bc14852d02e9ee57ebc1845df80c02a6d052a12f8ed12b82941cc3  toolkit/templates/handoffs/BA_TO_ARCH.md
+4450703248fa18c9d9a2c030cfe253c95fc812bc45a427c3b30b4312734b6684  toolkit/templates/handoffs/DEV_STAGE1_SPEC_REVIEW.md
+81a093320b911a27fdabfded87131135f63e4aeef3241e254147b33f68030d50  toolkit/templates/handoffs/DEV_STAGE2_CODE_QUALITY_REVIEW.md
+947751b720f7711c9ef6090a06a8d073988ea13d22b12712b4f192fb07fa338d  toolkit/templates/handoffs/DEV_TO_QA.md
+98b927fe381984a229ff69ad294686595eb3ecc90129b461b8a33fb5cca61531  toolkit/templates/handoffs/PM_TO_BA.md
+002ab3c8cc5f686de73060e1927675fa2a762d2ba62353eebd08bb7eb616c097  toolkit/templates/handoffs/QA_RELEASE_DECISION.md
 f9dc0d49ceeeb8814d77670e43f09b5221f46d406fb1e89eb575c1ab39bc022a  toolkit/templates/QUALITY_CHECKLIST.md
 0ccb7a0509cf92aa91ebea95996dfffd5b52edd6ab4bbefbb827e4ed495abc31  toolkit/templates/README.md
 2b5d4d10019e3c9b3219d92b8123acc85872d9c76230107206e7a270a5ece5a2  toolkit/templates/SHARED_PLANNING.md

package/assets/toolkit/toolkit/AGENTS.md

@@ -12,6 +12,8 @@ Goal: use SDTK as a virtual PM/BA/ARCH/DEV/QA operating model to deliver one fea
 - 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`):
@@ -44,6 +46,16 @@ Notes:
 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.
@@ -89,21 +101,31 @@ In addition to `ARCH_DESIGN`, ARCH may generate:
   - `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
+- `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/skills/sdtk-api-design-spec/SKILL.md

@@ -5,6 +5,10 @@ description: Generate detailed API design markdown (`[FEATURE_KEY]_API_DESIGN_DE
 
 # SDTK API Design Detail Spec
 
+## Critical Constraints
+- I do not drift from the source YAML or flow list.
+- I do not leave broken flow image embeds or missing assumptions in the API design detail.
+
 ## Outputs
 - `docs/api/[FEATURE_KEY]_API_DESIGN_DETAIL.md`
 - Supporting generated assets:

package/assets/toolkit/toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_CREATION_RULES.md

@@ -7,10 +7,16 @@ The active rule source for API design detail and API flowchart behavior is now:
 - `API_DESIGN_FLOWCHART_CREATION_RULES_FINAL.md` (root)
 - `templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md` (toolkit)
 
-Use that file for:
+Even in compatibility mode, generated API design detail docs must still include:
+- a top-level `## Assumptions` section
+- this table format: `| # | Assumption | Verified | Risk if wrong |`
+- explicit unresolved assumptions when downstream review depends on them
+
+Use the active rule file for:
 - API design detail markdown structure
 - flowchart integration and synchronization rules
 - error section rules
 - flow summary / notes / login rules
+- assumptions-section requirements
 
 This compatibility note should remain only until all references are migrated.

package/assets/toolkit/toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_FLOWCHART_CREATION_RULES.md

@@ -38,6 +38,23 @@ Primary sample references:
 - `GET /bukken/info/{company_uuid}/{bukken_uuid}` style
 - search API query-builder style shown in the Bukken sample helper flow
 
+## 2.1 API Design Detail Markdown Requirements
+
+Generated `*_API_DESIGN_DETAIL.md` files must keep this minimum structure:
+- `## 0. Abbreviations`
+- `## 1. Document Scope`
+- `## Assumptions`
+- per-endpoint `## <n>. API Detail ...` sections
+- `## 3. Generation Notes` or the current equivalent final notes section
+
+`## Assumptions` must use this table shape:
+
+```text
+| # | Assumption | Verified | Risk if wrong |
+```
+
+If an assumption is not verified yet, keep it explicit and treat it as a downstream review risk instead of silently collapsing it into a fact.
+
 ## 3. Core Flowchart Writing Rules
 
 ### Rule A. Add a visible API header for every block

package/assets/toolkit/toolkit/skills/sdtk-api-doc/SKILL.md

@@ -5,6 +5,10 @@ description: Generate OpenAPI 3.x YAML and PlantUML flow diagrams for a feature
 
 # SDTK API Documentation
 
+## Critical Constraints
+- I do not invent API paths or payload contracts that contradict BA or ARCH artifacts.
+- I do not leave YAML, endpoint markdown, and flow-list outputs out of sync.
+
 ## Outputs
 - `docs/api/[FeaturePascal]_API.yaml`
 - `docs/api/[FEATURE_KEY]_ENDPOINTS.md`

package/assets/toolkit/toolkit/skills/sdtk-api-doc/references/API_DESIGN_FLOWCHART_CREATION_RULES.md

@@ -38,6 +38,23 @@ Primary sample references:
 - `GET /bukken/info/{company_uuid}/{bukken_uuid}` style
 - search API query-builder style shown in the Bukken sample helper flow
 
+## 2.1 API Design Detail Markdown Requirements
+
+Generated `*_API_DESIGN_DETAIL.md` files must keep this minimum structure:
+- `## 0. Abbreviations`
+- `## 1. Document Scope`
+- `## Assumptions`
+- per-endpoint `## <n>. API Detail ...` sections
+- `## 3. Generation Notes` or the current equivalent final notes section
+
+`## Assumptions` must use this table shape:
+
+```text
+| # | Assumption | Verified | Risk if wrong |
+```
+
+If an assumption is not verified yet, keep it explicit and treat it as a downstream review risk instead of silently collapsing it into a fact.
+
 ## 3. Core Flowchart Writing Rules
 
 ### Rule A. Add a visible API header for every block