sdtk-kit 0.3.1 → 0.3.2

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

@@ -1,10 +1,10 @@
 {
-    "buildTimestamp":  "2026-03-03T01:05:51Z",
+    "buildTimestamp":  "2026-03-03T11:32:21Z",
     "files":  [
                   {
                       "path":  "toolkit/AGENTS.md",
-                      "sha256":  "9f86a4c75be4c2dfb9a122bd836eecf24b5b8675ba628535df51157984e3d02b",
-                      "size":  4883
+                      "sha256":  "c6eeae87c70925803869ae90d0aa033eb12852c174019f373f62382d25b3a7e3",
+                      "size":  5060
                   },
                   {
                       "path":  "toolkit/install.ps1",
@@ -48,38 +48,58 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_CREATION_RULES.md",
-                      "sha256":  "6b76ca144f2324ab54fed3bc19f77d85ef1b956840a546dc225a73feb94e5108",
-                      "size":  6541
+                      "sha256":  "9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2",
+                      "size":  634
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_FLOWCHART_CREATION_RULES.md",
+                      "sha256":  "13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97",
+                      "size":  12827
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-design-spec/references/FLOWCHART_CREATION_RULES.md",
-                      "sha256":  "a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b",
-                      "size":  16047
+                      "sha256":  "decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f",
+                      "size":  791
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-design-spec/scripts/generate_api_design_detail.py",
-                      "sha256":  "33b80ae976c546ae3c1a51fb6263184f2003453d587828ef3ef0a25df9595c40",
-                      "size":  20474
+                      "sha256":  "c6147e7b01632cb6ffa017af43e4e5c9e1f98d160ed812ade1d087b1f3ca5490",
+                      "size":  24583
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-design-spec/SKILL.md",
-                      "sha256":  "33509e68380318c4275dfd31f4ab195ccbd2812e8b6c6b6d56419d27451c85e2",
-                      "size":  3329
+                      "sha256":  "49817620680d1abe9620c7615885e5d5e688982c98110db18bc3ce5fc79f01b4",
+                      "size":  3685
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-api-doc/references/API_DESIGN_FLOWCHART_CREATION_RULES.md",
+                      "sha256":  "13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97",
+                      "size":  12827
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-doc/references/FLOWCHART_CREATION_RULES.md",
-                      "sha256":  "a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b",
-                      "size":  16047
+                      "sha256":  "decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f",
+                      "size":  791
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-api-doc/references/YAML_CREATION_RULES.md",
+                      "sha256":  "f29c6774019ef0789dfb88678e1ab31d4d8eb7b3ab69b2115368ef5d879e5276",
+                      "size":  5997
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-doc/SKILL.md",
-                      "sha256":  "0bcf24b32a41c21a97e8a4726ca7b17a5eef160adb3f381bd781f40682949bc3",
-                      "size":  1849
+                      "sha256":  "d93980bc0332f25852a5e4b0e5187bde7185a5ede70c59c8ebaf542afdb42188",
+                      "size":  1966
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/references/API_DESIGN_CREATION_RULES.md",
-                      "sha256":  "6b76ca144f2324ab54fed3bc19f77d85ef1b956840a546dc225a73feb94e5108",
-                      "size":  6541
+                      "sha256":  "9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2",
+                      "size":  634
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-arch/references/API_DESIGN_FLOWCHART_CREATION_RULES.md",
+                      "sha256":  "13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97",
+                      "size":  12827
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/references/FLOW_ACTION_SPEC_CREATION_RULES.md",
@@ -88,13 +108,18 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/references/FLOWCHART_CREATION_RULES.md",
-                      "sha256":  "a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b",
-                      "size":  16047
+                      "sha256":  "decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f",
+                      "size":  791
+                  },
+                  {
+                      "path":  "toolkit/skills/sdtk-arch/references/YAML_CREATION_RULES.md",
+                      "sha256":  "f29c6774019ef0789dfb88678e1ab31d4d8eb7b3ab69b2115368ef5d879e5276",
+                      "size":  5997
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/SKILL.md",
-                      "sha256":  "568d55f947888581cd169774db3a6f486b3ac9b72937906d023faa6c1051bf32",
-                      "size":  2414
+                      "sha256":  "ddf57e65096fc6f1bdd0f2c829f2580d2d7edb99f79d3cba7a3f68e69d373f46",
+                      "size":  2489
                   },
                   {
                       "path":  "toolkit/skills/sdtk-ba/SKILL.md",
@@ -188,18 +213,23 @@
                   },
                   {
                       "path":  "toolkit/templates/docs/api/API_DESIGN_CREATION_RULES.md",
-                      "sha256":  "6b76ca144f2324ab54fed3bc19f77d85ef1b956840a546dc225a73feb94e5108",
-                      "size":  6541
+                      "sha256":  "9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2",
+                      "size":  634
                   },
                   {
                       "path":  "toolkit/templates/docs/api/API_DESIGN_DETAIL_TEMPLATE.md",
-                      "sha256":  "0a22d18756ed1f95cb8b841643eff95e9c03d5b350e6d4a55c71b553d0d35b7a",
-                      "size":  1173
+                      "sha256":  "d2aa0ee3a7c5351700b3bffb4ba66e8056ed955f55903c744c694624730038cb",
+                      "size":  1181
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md",
+                      "sha256":  "13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97",
+                      "size":  12827
                   },
                   {
                       "path":  "toolkit/templates/docs/api/API_ENDPOINTS_TEMPLATE.md",
-                      "sha256":  "b79febaeefe8be7dbeec2d29f9c095f159629b8a19d99d3e2a46ff3620786e8d",
-                      "size":  5055
+                      "sha256":  "7dd9840e7a9c268fd7671791c0e80cfbcf54c3c2ff8bbacd85e44662f238ac9c",
+                      "size":  5102
                   },
                   {
                       "path":  "toolkit/templates/docs/api/feature_api_flow_list_TEMPLATE.txt",
@@ -213,8 +243,13 @@
                   },
                   {
                       "path":  "toolkit/templates/docs/api/FLOWCHART_CREATION_RULES.md",
-                      "sha256":  "a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b",
-                      "size":  16047
+                      "sha256":  "decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f",
+                      "size":  791
+                  },
+                  {
+                      "path":  "toolkit/templates/docs/api/YAML_CREATION_RULES.md",
+                      "sha256":  "f29c6774019ef0789dfb88678e1ab31d4d8eb7b3ab69b2115368ef5d879e5276",
+                      "size":  5997
                   },
                   {
                       "path":  "toolkit/templates/docs/architecture/ARCH_DESIGN_TEMPLATE.md",
@@ -288,8 +323,8 @@
                   },
                   {
                       "path":  "toolkit/templates/README.md",
-                      "sha256":  "cec5f33d6d6eb4bb31ef2e30f2ace75985aa9eb32bc8c9a760c7464bf5d9bfac",
-                      "size":  2522
+                      "sha256":  "0ccb7a0509cf92aa91ebea95996dfffd5b52edd6ab4bbefbb827e4ed495abc31",
+                      "size":  2683
                   },
                   {
                       "path":  "toolkit/templates/SHARED_PLANNING.md",
@@ -297,7 +332,7 @@
                       "size":  3255
                   }
               ],
-    "sourceCommit":  "9a07f915dfc95b414fa86bcb7d97efcc2ab0e59d",
-    "version":  "0.3.1",
-    "fileCount":  59
+    "sourceCommit":  "bf9a10e9ccde3a1c4809836b2da20fc6e3ad07df",
+    "version":  "0.3.2",
+    "fileCount":  66
 }

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

@@ -1,4 +1,4 @@
-9f86a4c75be4c2dfb9a122bd836eecf24b5b8675ba628535df51157984e3d02b  toolkit/AGENTS.md
+c6eeae87c70925803869ae90d0aa033eb12852c174019f373f62382d25b3a7e3  toolkit/AGENTS.md
 cc717ae87a0dbcf5aef2204d45211fe59f9506f9d03314eb283eddb3a5997279  toolkit/install.ps1
 fdf45036d4c0079cdb03e65efb7b5a84ea130e67a4c82522bb93c2bb73aa6661  toolkit/runtimes/claude/CLAUDE_TEMPLATE.md
 4154c15c71f44d2f2caf07fb41722fa65d4f9ec7e78f798ee084effd12345c62  toolkit/runtimes/codex/CODEX_TEMPLATE.md
@@ -7,16 +7,21 @@ fdf45036d4c0079cdb03e65efb7b5a84ea130e67a4c82522bb93c2bb73aa6661  toolkit/runtim
 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
+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
+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
+decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f  toolkit/skills/sdtk-api-doc/references/FLOWCHART_CREATION_RULES.md
+f29c6774019ef0789dfb88678e1ab31d4d8eb7b3ab69b2115368ef5d879e5276  toolkit/skills/sdtk-api-doc/references/YAML_CREATION_RULES.md
+d93980bc0332f25852a5e4b0e5187bde7185a5ede70c59c8ebaf542afdb42188  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
 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
+decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f  toolkit/skills/sdtk-arch/references/FLOWCHART_CREATION_RULES.md
+f29c6774019ef0789dfb88678e1ab31d4d8eb7b3ab69b2115368ef5d879e5276  toolkit/skills/sdtk-arch/references/YAML_CREATION_RULES.md
+ddf57e65096fc6f1bdd0f2c829f2580d2d7edb99f79d3cba7a3f68e69d373f46  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
@@ -35,12 +40,14 @@ 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
-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
+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
+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
-a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b  toolkit/templates/docs/api/FLOWCHART_CREATION_RULES.md
+decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f  toolkit/templates/docs/api/FLOWCHART_CREATION_RULES.md
+f29c6774019ef0789dfb88678e1ab31d4d8eb7b3ab69b2115368ef5d879e5276  toolkit/templates/docs/api/YAML_CREATION_RULES.md
 bc32ad83f06dc60ada7312f8d05f56b12da2d5e99c275fbc7895cf1e34a6c358  toolkit/templates/docs/architecture/ARCH_DESIGN_TEMPLATE.md
 d4cec8811e2a336a0ab8dd6e68998753cf7eca927207cdb8afc20666a5c452f7  toolkit/templates/docs/database/DATABASE_SPEC_TEMPLATE.md
 26fc80a5bced4b67debea943a49c729532a576146a81994f7e28615c3debe681  toolkit/templates/docs/design/DESIGN_LAYOUT_TEMPLATE.md
@@ -55,5 +62,5 @@ e8d3554fc4893a8a57fbf006e58f37f21347de5f31ce02f0717e97d29b387eea  toolkit/templa
 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
-cec5f33d6d6eb4bb31ef2e30f2ace75985aa9eb32bc8c9a760c7464bf5d9bfac  toolkit/templates/README.md
+0ccb7a0509cf92aa91ebea95996dfffd5b52edd6ab4bbefbb827e4ed495abc31  toolkit/templates/README.md
 2b5d4d10019e3c9b3219d92b8123acc85872d9c76230107206e7a270a5ece5a2  toolkit/templates/SHARED_PLANNING.md

package/assets/toolkit/toolkit/AGENTS.md

@@ -90,9 +90,12 @@ In addition to `ARCH_DESIGN`, ARCH may generate:
   - `off`: skip unless explicitly requested.
 
 ## 7) Mandatory Rule References
-- API YAML and flow docs:
+- 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`
-- 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`
@@ -100,4 +103,3 @@ In addition to `ARCH_DESIGN`, ARCH may generate:
   - `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).
-

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

@@ -21,22 +21,26 @@ description: Generate detailed API design markdown (`[FEATURE_KEY]_API_DESIGN_DE
   - Fallback: a specified flow list path
 
 ## Core Rules
-- Apply `./references/API_DESIGN_CREATION_RULES.md` first.
+- Apply `./references/API_DESIGN_FLOWCHART_CREATION_RULES.md` first.
 - Keep endpoint contracts consistent with source YAML.
 - Keep process flow source synchronized with flow list (`*_api_flow_list.txt`).
 - Keep one visible flowchart per API section (embed image), avoid duplicate preview rendering.
+- Keep `Process Flow` sections implementation-readable:
+  - include YAML-derived flow summary / notes / login bullets
+  - keep error sections aligned with actual flow exits, not `None`
 
 ## Generation Procedure
 1. Resolve input files (`yaml`, `flow_list`, `output`).
 2. Parse YAML endpoints (method, path, request schema, success/error schema).
 3. Parse flow blocks from flow list (`@startuml ... @enduml`) and map by `METHOD + path`.
 4. Generate detailed markdown sections per API:
+   - Flow summary / notes / login bullets from YAML `description`
    - Process flow source block (`text` fenced block)
    - Embedded flowchart image
    - Path parameter table
    - Request table (hierarchy levels + type + format + required)
    - Success response table
-   - Error response table
+   - Error response table (explicit schema if defined, otherwise shared envelope + inferred business statuses from flow)
 5. Generate/update `.puml` per API under `docs/api/flows`.
 6. Render `.svg` images under `docs/api/images`.
 7. Validate:
@@ -74,5 +78,3 @@ python "toolkit/skills/sdtk-api-design-spec/scripts/generate_api_design_detail.p
   - `auto` (default): generate API design detail when ARCH has API scope and YAML/flow sources are available.
   - `on`: always generate API design detail for API scope (fail if required sources are missing).
   - `off`: skip unless user explicitly requests.
-
-

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

@@ -1,212 +1,16 @@
-# API Design Creation Rules for AI Agents (Excel Template)
+# API DESIGN CREATION RULES (Compatibility Note)
 
-This document defines reusable rules for creating API design documents in Excel format based on `Example/Docs/API/API_design.xlsx`.
+This file is kept only for backward compatibility.
 
-## 1. Scope and Goal
+Do not use this file as the primary source of truth anymore.
+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)
 
-- Reuse one consistent Excel structure for API contract documentation.
-- Keep flow, endpoint parameters, request schema, response schema, and revision history in one workbook.
-- Keep generated sheets deterministic and review-friendly.
-
-## 2. Source Template Baseline
-
-| No | Sheet Pattern | Purpose |
-| ---: | --- | --- |
-| 1 | `History` | Global workbook change history |
-| 2 | `API detail (...)` | One API per sheet |
-
-Observed baseline in `API_design.xlsx`:
-- 1 history sheet.
-- 5 API detail sheets (list/create/detail/update/logical delete).
-
-## 3. Workbook Rules
-
-### 3.1 Sheet Naming
-
-- Use one API per sheet.
-- Recommended naming style:
-  - `API detail (<domain action>)`
-- Keep API sheet order stable (for example: list -> create -> detail -> update -> delete).
-
-### 3.2 History Sheet
-
-- Keep `History` as the first sheet.
-- Header layout:
-  - `A3=Date`
-  - `C3=Version`
-  - `F3=Editor`
-  - `M3=Edit content`
-- Append rows only. Do not rewrite historical rows.
-
-## 4. API Detail Sheet Layout
-
-### 4.1 Header Metadata Block
-
-Use this label/value map:
-
-| No | Label Cell Group | Value Cell Group | Meaning |
-| ---: | --- | --- | --- |
-| 1 | `Q1:X1` | `Y1:AQ1` | System name |
-| 2 | `Q2:X2` | `Y2:AQ2` | System ID |
-| 3 | `Q3:X3` | `Y3:AQ3` | Subsystem name |
-| 4 | `Q4:X4` | `Y4:AQ4` | Function name |
-| 5 | `AR1:AV1` | `AW1:BC1` | Created by |
-| 6 | `AR2:AV2` | `AW2:BC2` | Created date |
-| 7 | `AR3:AV3` | `AW3:BC3` | Revised by |
-| 8 | `AR4:AV4` | `AW4:BC4` | Revised date |
-
-Also keep document title block:
-- `A1:P4` = document title area.
-
-### 4.2 Mandatory Section Order
-
-Each API sheet must keep this order:
-1. Process flow section
-2. `Parameters:`
-3. Request parameter section (JSON format)
-4. Success response section (JSON format)
-5. Error response section (JSON format)
-
-### 4.3 Endpoint Title Placement
-
-- Put endpoint summary at top flow area: `B7`.
-  - Format: `<METHOD> <PATH> <summary>`
-- Repeat the same endpoint summary in contract area:
-  - Column `A`, one row above `Parameters:`.
-- Both endpoint strings must be identical.
-
-### 4.4 Flowchart Placement
-
-- Put PlantUML text in `BG8` (multi-line content in one cell).
-- `BG6` can contain tool/reference note.
-- Helper + main flows can be placed in one cell value if clearly separated.
-- Flow syntax/content standards follow:
-  - `Example/Docs/API/FLOWCHART_CREATION_RULES.md`
-
-## 5. Endpoint and Parameter Rules
-
-### 5.1 Path Parameter Block
-
-- Anchor row: column `B` equals `Parameters:`.
-- Parameter rows:
-  - parameter key in column `C`
-  - description in column `K`
-- Include every path placeholder from endpoint path.
-- Keep parameter order aligned with placeholder order.
-
-### 5.2 Consistency Checks
-
-- Every `{placeholder}` in path must exist exactly once in the parameter rows.
-- Avoid duplicate parameter names unless explicitly documented.
-- Remove stale parameter rows after endpoint rename.
-
-## 6. Request/Response Table Rules
-
-### 6.1 Common Column Model
-
-| No | Column Group | Meaning |
-| ---: | --- | --- |
-| 1 | `A:B` | Row No |
-| 2 | `C:J` | Item label |
-| 3 | `K:N` | Hierarchy level 1 |
-| 4 | `O:R` | Hierarchy level 2 |
-| 5 | `S:V` | Hierarchy level 3 |
-| 6 | `W:Z` | Hierarchy level 4 |
-| 7 | `AA:AD` | Hierarchy level 5 |
-| 8 | `AE:AH` | Hierarchy level 6 |
-| 9 | `AI:AK` | Data type |
-
-### 6.2 Request Header Mode
-
-For write/search request tables, include:
-- `No`
-- `Item Name`
-- `Item`
-- `Type`
-- `Format`
-- `Length`
-- `Required`
-
-Column groups:
-- `AL:AN` -> `Format`
-- `AO:AP` -> `Length`
-- `AQ:AR` -> `Required`
-
-### 6.3 Response Header Mode
-
-For response tables, include:
-- `No`
-- `Item Name`
-- `Item`
-- `Type`
-- `Note`
-
-Column group:
-- `AL:AN` -> `Note`
-
-### 6.4 GET Request Body Rule
-
-- If API has no JSON request body, set request body to:
-  - `None`
-
-### 6.5 Hierarchy Modeling Rule
-
-- Use hierarchy columns (level 1 to level 6) to represent nesting.
-- Represent root wrapper explicitly (for example `data`).
-- For array object children, define parent array node first, then child fields at deeper levels.
-
-## 7. Status and Error Contract Rules
-
-- Success response must include `status` at minimum.
-- Error response must include:
-  - `status`
-  - `data` (message or detail payload)
-- If status detail references an external code table, note that in response notes.
-
-## 8. Type and Format Rules
-
-- Use stable type keywords:
-  - `string`
-  - `integer`
-  - `number`
-  - `object`
-  - `array`
-- If datetime format is constrained, write it in `Format` or `Note` (for example `yyyymmddHHMMSS`).
-- Business constraints (constant flags, nullable behavior, etc.) go to `Note`.
-
-## 9. Recommended Generation Procedure
-
-1. Duplicate an existing API detail sheet.
-2. Update metadata fields (`Q..BC` blocks).
-3. Update endpoint title in `B7`.
-4. Update PlantUML in `BG8`.
-5. Update repeated endpoint title above `Parameters:`.
-6. Update path parameters (`C/K` rows).
-7. Update request section:
-   - `None` for no-body APIs.
-   - request table for body APIs.
-8. Update success response table.
-9. Update error response table.
-10. Append one new row in `History`.
-
-## 10. Quality Gate Checklist Before Handoff
-
-- Section order is complete and unchanged.
-- Endpoint title in `B7` matches the endpoint title above `Parameters:`.
-- Path placeholders and parameter rows are 1:1 matched.
-- Request/response sections use correct header mode.
-- `No` is sequential in every table.
-- Hierarchy columns reflect actual payload nesting.
-- `status` and error payload structure are documented.
-- PlantUML in `BG8` matches endpoint behavior.
-- `History` has a new appended entry.
-
-## 11. Known Pitfalls and Prevention
-
-| No | Pitfall | Prevention Rule |
-| ---: | --- | --- |
-| 1 | Endpoint placeholder renamed but parameter rows not synced | Run path-vs-parameter check for every API sheet |
-| 2 | Request/response headers mixed (`Note` vs `Required`) | Use section-specific header mode only |
-| 3 | Nested array fields placed at wrong hierarchy level | Define parent array first, then child fields deeper |
-| 4 | Endpoint summary mismatch between top and contract blocks | Maintain a single canonical endpoint title string and reuse it |
+Use that file for:
+- API design detail markdown structure
+- flowchart integration and synchronization rules
+- error section rules
+- flow summary / notes / login rules
 
+This compatibility note should remain only until all references are migrated.