@raishin/vanguard-frontier-agentic 3.18.0 → 3.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (594) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +8 -1
  3. package/.cursor-plugin/plugin.json +8 -1
  4. package/.github/plugin/marketplace.json +1 -1
  5. package/README.md +21 -21
  6. package/agents/AGENTS.md +4 -4
  7. package/agents/README.md +7 -7
  8. package/agents/alibaba/alibaba-tablestore-architect-agent/AGENT.md +54 -0
  9. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/claude-code.agent.md +37 -0
  10. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/codex.toml +11 -0
  11. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/copilot.agent.md +43 -0
  12. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/cursor.agent.md +38 -0
  13. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/gemini.agent.md +39 -0
  14. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  15. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  16. package/agents/alibaba/alibaba-tablestore-architect-agent/metadata.json +39 -0
  17. package/agents/aws/aws-dynamodb-patterns-agent/AGENT.md +53 -0
  18. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/claude-code.agent.md +36 -0
  19. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/codex.toml +23 -0
  20. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/copilot.agent.md +42 -0
  21. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/cursor.agent.md +38 -0
  22. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/gemini.agent.md +38 -0
  23. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-cli.agent.json +5 -0
  24. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-ide.agent.md +36 -0
  25. package/agents/aws/aws-dynamodb-patterns-agent/metadata.json +39 -0
  26. package/agents/azure/azure-cosmosdb-application-developer-agent/metadata.json +4 -0
  27. package/agents/azure/azure-cosmosdb-pattern-agent/AGENT.md +53 -0
  28. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/claude-code.agent.md +36 -0
  29. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/codex.toml +23 -0
  30. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/copilot.agent.md +42 -0
  31. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/cursor.agent.md +37 -0
  32. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/gemini.agent.md +38 -0
  33. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
  34. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
  35. package/agents/azure/azure-cosmosdb-pattern-agent/metadata.json +38 -0
  36. package/agents/gcp/gcp-bigtable-architect-agent/AGENT.md +54 -0
  37. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/claude-code.agent.md +37 -0
  38. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/codex.toml +11 -0
  39. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/copilot.agent.md +43 -0
  40. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/cursor.agent.md +38 -0
  41. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/gemini.agent.md +39 -0
  42. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  43. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  44. package/agents/gcp/gcp-bigtable-architect-agent/metadata.json +39 -0
  45. package/agents/huawei/huawei-geminidb-architect-agent/AGENT.md +54 -0
  46. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/claude-code.agent.md +37 -0
  47. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/codex.toml +11 -0
  48. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/copilot.agent.md +43 -0
  49. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/cursor.agent.md +38 -0
  50. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/gemini.agent.md +39 -0
  51. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  52. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  53. package/agents/huawei/huawei-geminidb-architect-agent/metadata.json +38 -0
  54. package/agents/oci/oci-nosql-database-architect-agent/AGENT.md +54 -0
  55. package/agents/oci/oci-nosql-database-architect-agent/harnesses/claude-code.agent.md +37 -0
  56. package/agents/oci/oci-nosql-database-architect-agent/harnesses/codex.toml +11 -0
  57. package/agents/oci/oci-nosql-database-architect-agent/harnesses/copilot.agent.md +43 -0
  58. package/agents/oci/oci-nosql-database-architect-agent/harnesses/cursor.agent.md +39 -0
  59. package/agents/oci/oci-nosql-database-architect-agent/harnesses/gemini.agent.md +39 -0
  60. package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  61. package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  62. package/agents/oci/oci-nosql-database-architect-agent/metadata.json +39 -0
  63. package/agents/oci/oci-nosql-pattern-agent/AGENT.md +53 -0
  64. package/agents/oci/oci-nosql-pattern-agent/harnesses/claude-code.agent.md +36 -0
  65. package/agents/oci/oci-nosql-pattern-agent/harnesses/codex.toml +23 -0
  66. package/agents/oci/oci-nosql-pattern-agent/harnesses/copilot.agent.md +42 -0
  67. package/agents/oci/oci-nosql-pattern-agent/harnesses/cursor.agent.md +38 -0
  68. package/agents/oci/oci-nosql-pattern-agent/harnesses/gemini.agent.md +38 -0
  69. package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
  70. package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
  71. package/agents/oci/oci-nosql-pattern-agent/metadata.json +38 -0
  72. package/catalog/agents.json +204 -1
  73. package/catalog/asset-integrity.json +620 -75
  74. package/catalog/install-roles.json +19 -1
  75. package/catalog/model-assignments.json +231 -0
  76. package/catalog/skill-manifest.json +2074 -527
  77. package/catalog/skills.json +314 -14
  78. package/package.json +8 -2
  79. package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
  80. package/powers/vanguard-alibaba/POWER.md +1 -1
  81. package/powers/vanguard-aws/POWER.md +1 -1
  82. package/powers/vanguard-azure/POWER.md +1 -1
  83. package/powers/vanguard-gcp/POWER.md +1 -1
  84. package/powers/vanguard-huawei/POWER.md +1 -1
  85. package/powers/vanguard-oci/POWER.md +1 -1
  86. package/rules/codex/cloud-provenance-rule.md +1 -1
  87. package/scripts/generate-kiro-powers.mjs +2 -2
  88. package/skills/alibaba/README.md +2 -1
  89. package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
  90. package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
  91. package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
  92. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
  93. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
  94. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
  95. package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
  96. package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
  97. package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
  98. package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
  99. package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
  100. package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
  101. package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
  102. package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
  103. package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
  104. package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
  105. package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
  106. package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
  107. package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
  108. package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
  109. package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
  110. package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
  111. package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
  112. package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
  113. package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
  114. package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
  115. package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
  116. package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
  117. package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
  118. package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
  119. package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
  120. package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
  121. package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
  122. package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
  123. package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
  124. package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
  125. package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
  126. package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
  127. package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
  128. package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
  129. package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
  130. package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
  131. package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
  132. package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
  133. package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
  134. package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
  135. package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
  136. package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
  137. package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
  138. package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
  139. package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
  140. package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
  141. package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
  142. package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
  143. package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
  144. package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
  145. package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
  146. package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
  147. package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
  148. package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
  149. package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
  150. package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
  151. package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
  152. package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
  153. package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
  154. package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
  155. package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
  156. package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
  157. package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
  158. package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
  159. package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
  160. package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
  161. package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
  162. package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
  163. package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
  164. package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
  165. package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
  166. package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
  167. package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
  168. package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
  169. package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
  170. package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
  171. package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
  172. package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
  173. package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
  174. package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
  175. package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
  176. package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
  177. package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
  178. package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
  179. package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
  180. package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
  181. package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
  182. package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
  183. package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
  184. package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
  185. package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
  186. package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
  187. package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
  188. package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
  189. package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
  190. package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
  191. package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
  192. package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
  193. package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
  194. package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
  195. package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
  196. package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
  197. package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
  198. package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
  199. package/skills/aws/aws-maestro/SKILL.md +1 -1
  200. package/skills/aws/aws-maestro/metadata.json +1 -1
  201. package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
  202. package/skills/azure/azure-ai-foundry-ops-governor/SKILL.md +2 -2
  203. package/skills/azure/azure-aks-platform-operator/SKILL.md +1 -1
  204. package/skills/azure/azure-app-service-production-readiness/SKILL.md +1 -1
  205. package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +5 -3
  206. package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
  207. package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
  208. package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
  209. package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
  210. package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
  211. package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
  212. package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
  213. package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
  214. package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
  215. package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
  216. package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
  217. package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
  218. package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
  219. package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
  220. package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
  221. package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
  222. package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
  223. package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
  224. package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
  225. package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
  226. package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
  227. package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
  228. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
  229. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
  230. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
  231. package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
  232. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
  233. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
  234. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
  235. package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
  236. package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
  237. package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
  238. package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
  239. package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
  240. package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
  241. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
  242. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
  243. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
  244. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
  245. package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
  246. package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
  247. package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
  248. package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
  249. package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
  250. package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
  251. package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
  252. package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
  253. package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
  254. package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
  255. package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
  256. package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
  257. package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
  258. package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
  259. package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
  260. package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
  261. package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
  262. package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
  263. package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
  264. package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
  265. package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
  266. package/skills/azure/azure-cosmosdb-performance-investigator/SKILL.md +1 -1
  267. package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +7 -3
  268. package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
  269. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
  270. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
  271. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
  272. package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
  273. package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
  274. package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
  275. package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
  276. package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
  277. package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
  278. package/skills/azure/azure-cost-estimation-review/SKILL.md +1 -1
  279. package/skills/azure/azure-cost-optimization-governor/SKILL.md +1 -1
  280. package/skills/azure/azure-entra-id-specialist/SKILL.md +1 -1
  281. package/skills/azure/azure-governance-policy-guardrails/SKILL.md +1 -1
  282. package/skills/azure/azure-identity-governance-review/SKILL.md +1 -1
  283. package/skills/azure/azure-key-vault-secret-lifecycle-auditor/SKILL.md +1 -1
  284. package/skills/azure/azure-landing-zone-architect/SKILL.md +1 -1
  285. package/skills/azure/azure-maestro/SKILL.md +2 -1
  286. package/skills/azure/azure-migrate-landing-zone-cutover/SKILL.md +1 -1
  287. package/skills/azure/azure-network-topology-review/SKILL.md +1 -1
  288. package/skills/azure/azure-observability-investigator/SKILL.md +1 -1
  289. package/skills/azure/azure-platform-automation-devops/SKILL.md +1 -1
  290. package/skills/azure/azure-private-endpoint-adoption-planner/SKILL.md +1 -1
  291. package/skills/azure/azure-rbac-review/SKILL.md +1 -1
  292. package/skills/azure/azure-resilience-bcdr-review/SKILL.md +1 -1
  293. package/skills/azure/azure-resource-health-incident-triage/SKILL.md +1 -1
  294. package/skills/azure/azure-role-selector/SKILL.md +1 -1
  295. package/skills/azure/azure-security-posture-hardening/SKILL.md +1 -1
  296. package/skills/azure/azure-subscription-resource-organization/SKILL.md +1 -1
  297. package/skills/azure/azure-waf-cost-optimization-review/SKILL.md +1 -1
  298. package/skills/azure/azure-waf-reliability-review/SKILL.md +1 -1
  299. package/skills/azure/azure-waf-security-review/SKILL.md +1 -1
  300. package/skills/contabo/contabo-security-hardening/SKILL.md +1 -1
  301. package/skills/cross-functional/agentic-board-protocol/SKILL.md +1 -1
  302. package/skills/cross-functional/copilot-data-readiness-protocol/SKILL.md +1 -1
  303. package/skills/cross-functional/salesforce-case-capsule/SKILL.md +1 -1
  304. package/skills/cross-functional/salesforce-data-exposure-escalation-protocol/SKILL.md +1 -1
  305. package/skills/cross-functional/salesforce-live-change-approval-protocol/SKILL.md +1 -1
  306. package/skills/cross-functional/salesforce-risk-taxonomy/SKILL.md +1 -1
  307. package/skills/databricks/databricks-lakehouse-engineering-at-azure/SKILL.md +1 -1
  308. package/skills/databricks/databricks-unity-catalog-governance-at-azure/SKILL.md +1 -1
  309. package/skills/dotnet/dotnet-performance-aot-review/SKILL.md +1 -1
  310. package/skills/frontend/vue-router-navigation-security-review/SKILL.md +1 -1
  311. package/skills/gcp/README.md +2 -1
  312. package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
  313. package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
  314. package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
  315. package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
  316. package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
  317. package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
  318. package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
  319. package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
  320. package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
  321. package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
  322. package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
  323. package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
  324. package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
  325. package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
  326. package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
  327. package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
  328. package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
  329. package/skills/gcp/gcp-maestro/SKILL.md +2 -1
  330. package/skills/huawei/README.md +2 -1
  331. package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
  332. package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
  333. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
  334. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
  335. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
  336. package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
  337. package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
  338. package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
  339. package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
  340. package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
  341. package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
  342. package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
  343. package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
  344. package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
  345. package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
  346. package/skills/huawei/huawei-maestro/SKILL.md +2 -1
  347. package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
  348. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
  349. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
  350. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
  351. package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
  352. package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
  353. package/skills/java/java-application-server-exit/SKILL.md +1 -1
  354. package/skills/java/java-jvm-performance-and-gc/SKILL.md +1 -1
  355. package/skills/java/java-resilience-pattern/SKILL.md +1 -1
  356. package/skills/java/java-test-architecture/SKILL.md +1 -1
  357. package/skills/java/java-transaction-and-consistency/SKILL.md +1 -1
  358. package/skills/kubernetes/kubernetes-rbac-review/SKILL.md +1 -1
  359. package/skills/marketing/analytics-data-minimization-review/SKILL.md +1 -1
  360. package/skills/microsoft/d365-customer-insights-journeys/SKILL.md +1 -1
  361. package/skills/microsoft/fabric-analytics-engineering/SKILL.md +1 -1
  362. package/skills/microsoft/m365-defender-xdr-security-operations/SKILL.md +1 -1
  363. package/skills/microsoft/m365-purview-data-security-compliance/SKILL.md +1 -1
  364. package/skills/oci/README.md +6 -1
  365. package/skills/oci/oci-autonomous-database-architect/SKILL.md +1 -1
  366. package/skills/oci/oci-certificates-issuer-review/SKILL.md +1 -1
  367. package/skills/oci/oci-cloud-guard-responder/SKILL.md +1 -1
  368. package/skills/oci/oci-compute-instance-agent-operator/SKILL.md +1 -1
  369. package/skills/oci/oci-compute-platform-operator/SKILL.md +1 -1
  370. package/skills/oci/oci-cost-finops-analyst/SKILL.md +1 -1
  371. package/skills/oci/oci-database-platform-dba/SKILL.md +1 -1
  372. package/skills/oci/oci-dbtools-sql-analyst/SKILL.md +1 -1
  373. package/skills/oci/oci-devops-container-platform-engineer/SKILL.md +1 -1
  374. package/skills/oci/oci-exadata-database-architect/SKILL.md +1 -1
  375. package/skills/oci/oci-exadata-platform-architect/SKILL.md +1 -1
  376. package/skills/oci/oci-fusion-apps-environment-operator/SKILL.md +1 -1
  377. package/skills/oci/oci-goldengate-replication-operator/SKILL.md +1 -1
  378. package/skills/oci/oci-identity-access-governor/SKILL.md +1 -1
  379. package/skills/oci/oci-iot-digital-twin-engineer/SKILL.md +1 -1
  380. package/skills/oci/oci-limits-capacity-planner/SKILL.md +1 -1
  381. package/skills/oci/oci-live-autonomous-db-lifecycle-guard/SKILL.md +1 -1
  382. package/skills/oci/oci-live-cost-budget-runaway-guard/SKILL.md +1 -1
  383. package/skills/oci/oci-live-iam-policy-compartment-guard/SKILL.md +1 -1
  384. package/skills/oci/oci-live-network-security-rule-guard/SKILL.md +1 -1
  385. package/skills/oci/oci-live-oke-rollout-guard/SKILL.md +1 -1
  386. package/skills/oci/oci-live-resource-manager-stack-guard/SKILL.md +1 -1
  387. package/skills/oci/oci-live-vault-key-destruction-guard/SKILL.md +1 -1
  388. package/skills/oci/oci-load-balancer-traffic-engineer/SKILL.md +1 -1
  389. package/skills/oci/oci-maestro/SKILL.md +1 -1
  390. package/skills/oci/oci-migration-cutover-architect/SKILL.md +1 -1
  391. package/skills/oci/oci-multi-cloud-architect/SKILL.md +1 -1
  392. package/skills/oci/oci-mysql-heatwave-ai-specialist/SKILL.md +1 -1
  393. package/skills/oci/oci-network-architect/SKILL.md +1 -1
  394. package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
  395. package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
  396. package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
  397. package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
  398. package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
  399. package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
  400. package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
  401. package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
  402. package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
  403. package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
  404. package/skills/oci/oci-nosql-pattern/README.md +81 -0
  405. package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
  406. package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
  407. package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
  408. package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
  409. package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
  410. package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
  411. package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
  412. package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
  413. package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
  414. package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
  415. package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
  416. package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
  417. package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
  418. package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
  419. package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
  420. package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
  421. package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
  422. package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
  423. package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
  424. package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
  425. package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
  426. package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
  427. package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
  428. package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
  429. package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
  430. package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
  431. package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
  432. package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
  433. package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
  434. package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
  435. package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
  436. package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
  437. package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
  438. package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
  439. package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
  440. package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
  441. package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
  442. package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
  443. package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
  444. package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
  445. package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
  446. package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
  447. package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
  448. package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
  449. package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
  450. package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
  451. package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
  452. package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
  453. package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
  454. package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
  455. package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
  456. package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
  457. package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
  458. package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
  459. package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
  460. package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
  461. package/skills/oci/oci-observability-incident-responder/SKILL.md +1 -1
  462. package/skills/oci/oci-recovery-service-operator/SKILL.md +1 -1
  463. package/skills/oci/oci-registry-artifact-governor/SKILL.md +1 -1
  464. package/skills/oci/oci-resource-search-inventory-analyst/SKILL.md +1 -1
  465. package/skills/oci/oci-security-compliance-reviewer/SKILL.md +1 -1
  466. package/skills/oci/oci-solution-architect/SKILL.md +1 -1
  467. package/skills/oci/oci-storage-backup-steward/SKILL.md +1 -1
  468. package/skills/oci/oci-support-incident-coordinator/SKILL.md +1 -1
  469. package/skills/oci/oci-waf-cost-optimization-review/SKILL.md +1 -1
  470. package/skills/oci/oci-waf-reliability-review/SKILL.md +1 -1
  471. package/skills/oci/oci-waf-security-review/SKILL.md +1 -1
  472. package/skills/oci/oracle-oci-mcp-grounded-advisor/SKILL.md +1 -1
  473. package/skills/ovhcloud/ovhcloud-cost-finops-analyst/SKILL.md +1 -1
  474. package/skills/ovhcloud/ovhcloud-live-kms-key-destruction-guard/SKILL.md +1 -1
  475. package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
  476. package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
  477. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
  478. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
  479. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
  480. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
  481. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
  482. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
  483. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
  484. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
  485. package/skills/salesforce/salesforce-agentforce-risk-review-skill/SKILL.md +1 -1
  486. package/skills/salesforce/salesforce-apex-lwc-code-review-skill/SKILL.md +1 -1
  487. package/skills/salesforce/salesforce-devsecops-pipeline-skill/SKILL.md +1 -1
  488. package/skills/salesforce/salesforce-flow-automation-review-skill/SKILL.md +1 -1
  489. package/skills/salesforce/salesforce-infrastructure-audit-skill/SKILL.md +1 -1
  490. package/skills/salesforce/salesforce-integration-review-skill/SKILL.md +1 -1
  491. package/skills/salesforce/salesforce-marketing-consent-review-skill/SKILL.md +1 -1
  492. package/skills/salesforce/salesforce-metadata-review-skill/SKILL.md +1 -1
  493. package/skills/salesforce/salesforce-org-assessment-skill/SKILL.md +1 -1
  494. package/skills/salesforce/salesforce-permission-model-review-skill/SKILL.md +1 -1
  495. package/skills/salesforce/salesforce-release-readiness-skill/SKILL.md +1 -1
  496. package/skills/salesforce/salesforce-zero-trust-maturity-skill/SKILL.md +1 -1
  497. package/skills/sap/sap-analytics-cloud-planning-governance/SKILL.md +1 -1
  498. package/skills/sap/sap-btp-governance-review/SKILL.md +1 -1
  499. package/skills/sap/sap-cloud-alm-sre-incident-review/SKILL.md +1 -1
  500. package/skills/sap/sap-datasphere-data-product-architecture/SKILL.md +1 -1
  501. package/skills/sap/sap-ewm-tm-logistics-execution-review/SKILL.md +1 -1
  502. package/skills/sap/sap-finance-fico-controls-review/SKILL.md +1 -1
  503. package/skills/sap/sap-hana-cloud-performance-cost/SKILL.md +1 -1
  504. package/skills/sap/sap-hypercare-incident-commander-review/SKILL.md +1 -1
  505. package/skills/sap/sap-integration-suite-review/SKILL.md +1 -1
  506. package/skills/sap/sap-joule-governance-adoption-review/SKILL.md +1 -1
  507. package/skills/sap/sap-license-btp-consumption-finops-review/SKILL.md +1 -1
  508. package/skills/sap/sap-manufacturing-execution-risk-review/SKILL.md +1 -1
  509. package/skills/sap/sap-mdg-master-data-quality-review/SKILL.md +1 -1
  510. package/skills/sap/sap-order-to-cash-review/SKILL.md +1 -1
  511. package/skills/sap/sap-procurement-ariba-value-leakage-review/SKILL.md +1 -1
  512. package/skills/sap/sap-release-change-collision-review/SKILL.md +1 -1
  513. package/skills/sap/sap-rise-sla-vendor-risk-review/SKILL.md +1 -1
  514. package/skills/sap/sap-security-iam-grc-sod-review/SKILL.md +1 -1
  515. package/skills/sap/sap-signavio-process-mining-value/SKILL.md +1 -1
  516. package/skills/sap/sap-successfactors-hr-process-risk-review/SKILL.md +1 -1
  517. package/skills/sap/sap-supply-chain-ibp-resilience-review/SKILL.md +1 -1
  518. package/skills/sap/sap-testing-quality-gate-review/SKILL.md +1 -1
  519. package/skills/sap/sap-transformation-portfolio-triage-review/SKILL.md +1 -1
  520. package/skills/sap/sap-treasury-cash-risk-review/SKILL.md +1 -1
  521. package/skills/scaleway/scaleway-kapsule-platform-operator/SKILL.md +1 -1
  522. package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
  523. package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
  524. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
  525. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
  526. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
  527. package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
  528. package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
  529. package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
  530. package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
  531. package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
  532. package/skills/scaleway/scaleway-network-architect/SKILL.md +1 -1
  533. package/templates/nosql-audit-template.md +127 -0
  534. package/templates/nosql-operations-template.md +60 -0
  535. package/tests/_generate_maestro_routing_fixtures.py +11 -0
  536. package/tests/fixtures/README.md +2 -2
  537. package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
  538. package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
  539. package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
  540. package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
  541. package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
  542. package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
  543. package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
  544. package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
  545. package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
  546. package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
  547. package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
  548. package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
  549. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
  550. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
  551. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
  552. package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
  553. package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
  554. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
  555. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
  556. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
  557. package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
  558. package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
  559. package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
  560. package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
  561. package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
  562. package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
  563. package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
  564. package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
  565. package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
  566. package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
  567. package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
  568. package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
  569. package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
  570. package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
  571. package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
  572. package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
  573. package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
  574. package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
  575. package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
  576. package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
  577. package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
  578. package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
  579. package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
  580. package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
  581. package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
  582. package/tests/requirements-ci.txt +8 -0
  583. package/tests/test-marketplace-validators.py +7 -1
  584. package/tests/validate-agent-frontmatter-schema.py +7 -1
  585. package/tests/validate-aws-skill-quality.py +7 -0
  586. package/tests/validate-kiro-powers.py +8 -1
  587. package/tests/validate-nosql-audit.py +741 -0
  588. package/tests/validate-nosql-operations.py +136 -0
  589. package/tests/validate-nosql-pattern-evals.py +96 -0
  590. package/tests/validate-nosql-scenarios.py +94 -0
  591. package/tests/validate-skill-frontmatter-schema.py +7 -1
  592. package/tests/validate-skill-manifest.py +6 -1
  593. package/tests/validate-skill-references.py +225 -0
  594. package/tests/validate-skill-yaml-strict.py +84 -0
@@ -0,0 +1,131 @@
1
+ # Modeling from access patterns
2
+
3
+ ## Decide what not to build
4
+
5
+ Start with known application operations, not an entity diagram translated one
6
+ table per SQL table and not a compulsory single-table conversion. Compare:
7
+
8
+ | Option | Good fit | Price paid |
9
+ |---|---|---|
10
+ | Simple key/value or one entity/table | Direct key access, distinct ownership/lifecycle | More requests for aggregate reads |
11
+ | Single-table, multiple item types | Stable aggregate queries and bounded relationships | Key discipline, denormalization, coupled migration/tooling |
12
+ | Multiple DynamoDB tables | Different access/lifecycle/security needs | Application composition; transactions still have service boundaries |
13
+ | Relational/search/analytics adjunct | Arbitrary joins, text search, broad reporting | Additional store/sync/freshness and operational cost |
14
+
15
+ No option earns a cost or latency claim without item-size, request and skew data.
16
+ Tables do not enforce a schema for non-key attributes. Application schema/version
17
+ validation is still necessary in every SDK or wrapper.
18
+
19
+ ## Worked model: customer orders and a tenant's open-order queue
20
+
21
+ Assumptions: moderate per-customer/per-tenant peaks, immutable creation time,
22
+ tenant-local operations, eventual queue visibility acceptable. These are examples,
23
+ not measured sizing. Delimiter-containing IDs must be encoded or rejected
24
+ consistently; normalize timestamps to fixed-width UTC for lexical ordering.
25
+
26
+ | Item | PK | SK | GSI1PK | GSI1SK |
27
+ |---|---|---|---|---|
28
+ | Customer profile | `TENANT#acme#CUSTOMER#c42` | `PROFILE` | absent | absent |
29
+ | Open order | `TENANT#acme#CUSTOMER#c42` | `ORDER#2026-01-02T10:00:00.000Z#o100` | `TENANT#acme#STATUS#OPEN` | `2026-01-02T10:00:00.000Z#o100` |
30
+ | Closed order | Same customer PK | Same immutable order SK | absent | absent |
31
+
32
+ Order attributes: `entityType=Order`, `orderId=o100`, `customerId=c42`,
33
+ `status=OPEN`, `version=1`, `totalMinor=1250`, `currency=USD`.
34
+ Represent money in explicitly bounded integer minor units or exact decimals;
35
+ define scale/currency. Optional `expiresAt` is epoch seconds for disposable records,
36
+ not a default retention policy for financial orders. Do not expire orders casually.
37
+
38
+ ### Access paths and actual requests
39
+
40
+ - **Customer profile**: `GetItem(PK, SK=PROFILE)`; strong read optional.
41
+ - **List orders**: `Query(PK = :customer AND begins_with(SK, :orderPrefix))`,
42
+ `:orderPrefix=ORDER#`, descending, `Limit=50`, cursor; strong read optional.
43
+ - **Known order key**: `GetItem(PK, complete immutable order SK)`.
44
+ - **Open queue**: `Query(IndexName=GSI1, GSI1PK=:tenantOpen)`, descending,
45
+ `Limit=50`; no strong reads. The asset projects keys plus `status`, `orderId`,
46
+ `totalMinor`, `currency`; fetch the base item if more fields or current state are
47
+ required. GSI membership can lag even if subsequent base gets are strong.
48
+ - **Order ID only**: unsupported by this layout. Supply customer+creation key,
49
+ introduce a conditional locator item keyed by tenant+order ID, or redesign.
50
+ A locator and order requiring atomic creation may use a transaction. Account for
51
+ its extra item/write/read, Region scope and idempotency.
52
+ - **Monthly totals/search across all customers**: not a free query. Define a
53
+ bounded materialized aggregate or export/search/analytics pipeline with explicit
54
+ freshness and reconciliation rather than scanning on each web request.
55
+
56
+ Single-table co-location here permits a customer aggregate query, but the order
57
+ list alone does not prove that merging the profile is better than two tables.
58
+
59
+ ### Sparse index lifecycle
60
+
61
+ Populate **both** GSI key attributes only for qualifying open orders. Closing an
62
+ order must update status/version and remove those keys in the same `UpdateItem`:
63
+
64
+ ```json
65
+ {
66
+ "UpdateExpression": "SET #st = :closed, #v = #v + :one REMOVE GSI1PK, GSI1SK",
67
+ "ConditionExpression": "#st = :open AND #v = :expected",
68
+ "ExpressionAttributeNames": {"#st": "status", "#v": "version"},
69
+ "ExpressionAttributeValues": {
70
+ ":closed": {"S": "CLOSED"}, ":open": {"S": "OPEN"},
71
+ ":one": {"N": "1"}, ":expected": {"N": "1"}
72
+ }
73
+ }
74
+ ```
75
+
76
+ This is a **fragment**: add the real `TableName` and full `Key`, authorize the
77
+ tenant, and handle the failed condition as a conflict. Reopening must restore both
78
+ keys, matching status and new version in one update. An eventual GSI may still show
79
+ the old entry briefly; queue consumers recheck authoritative state conditionally.
80
+
81
+ ## Keys, relationships and indexes
82
+
83
+ For the full selection sequence, comparison and worked alternatives, read
84
+ [LSI vs GSI](lsi-vs-gsi.md). Copyable operations are in [Commands](commands/aws-cli.md).
85
+
86
+ - Composite sort keys encode hierarchy/ranges. Numbers sort numerically only when
87
+ stored as Number keys; string `2` and `10` sort lexically. Use deliberate padding
88
+ or numeric types, consistent case/encoding, tie-break IDs and immutable keys.
89
+ - One-to-many: co-locate bounded child items when read together; paginate large
90
+ collections. Many-to-many: consider two adjacency items/inverted access paths;
91
+ define synchronization/deletion and transaction boundaries. Do not claim joins.
92
+ - GSI: distinct partition/sort keys and independently provisioned throughput when
93
+ provisioned mode is used; eventual reads, storage and write amplification.
94
+ `KEYS_ONLY`, `INCLUDE`, `ALL` trade index size versus extra base reads. A request
95
+ projection is not the same as a physically smaller index projection.
96
+ - LSI: same partition key, alternative sort key, strong reads possible. Create
97
+ only at table creation; cannot add/delete later. With any LSI, each item
98
+ collection (base+LSI data for one PK) has a 10 GB limit. This is **not** a general
99
+ per-key limit on every table. Avoid adding LSIs for hypothetical future queries.
100
+ - GSI non-key uniqueness is not enforced; two items can share an index key.
101
+ Model unique claims under authoritative primary keys with conditions/transactions.
102
+ - A compound query not served by an existing key needs an explicit new access path,
103
+ a bounded client composition, or a different datastore—not arbitrary key predicates.
104
+
105
+ ## Skew and cost are part of the model
106
+
107
+ `GSI1PK=OPEN` is a global hot key. Tenant-prefixing limits scope, not heat: one large
108
+ tenant can still dominate. A balanced base table can have an unbalanced index;
109
+ index back-pressure can throttle base writes. Monotonic sort keys can keep new
110
+ writes at one hot edge. On-demand/adaptive capacity do not remove physical limits.
111
+
112
+ For a measured hotspot, choose a stable shard count/function plus time buckets
113
+ where appropriate. Include:
114
+
115
+ 1. How writers select the shard and how retries preserve it.
116
+ 2. How readers fan out to all required shards/buckets and merge `(time, id)` order.
117
+ 3. Per-shard continuation state and any buffered items, bound to a cursor version;
118
+ one `LastEvaluatedKey` cannot represent all shards.
119
+ 4. Fan-out costs, empty queries, page/deadline budgets, key evolution and backfill.
120
+
121
+ Estimate base and each affected index separately. A nontransactional 1 KB write
122
+ uses one write unit; read unit baseline is 4 KB, strong versus eventual differs,
123
+ transactions cost more. Use actual operation-level rounding/aggregation rules from
124
+ AWS docs, not `ceil(each item / 4KB)` blindly for Query. Include projected bytes,
125
+ storage, replication, backups, streams/consumers and traffic spikes. Fetch current
126
+ Region/pricing data before quoting money; label estimates rather than promises.
127
+
128
+ Sources: [index guidelines](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-indexes-general.html),
129
+ [sparse indexes](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-indexes-general-sparse-indexes.html),
130
+ [capacity accounting](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/read-write-operations.html),
131
+ [GSI back-pressure](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/gsi-throttling.html).
@@ -0,0 +1,137 @@
1
+ # CloudWatch monitoring by component
2
+
3
+ Start with user-visible latency/error objectives, not a dashboard of averages.
4
+ Distinguish table/index throttling, SDK retry/network time, stream consumer lag,
5
+ replication delay and cache misses. Commands below are examples; metric reads need
6
+ authorized account/Region scope and alarm writes need separate reviewed approval.
7
+ No alarm delivery, endpoint reachability or production health is proved here.
8
+
9
+ ```bash
10
+ set -euo pipefail
11
+ : "${AWS_PROFILE:?}" "${AWS_REGION:?}" "${TABLE_NAME:?}"
12
+ : "${METRIC_START_UTC:?Explicit ISO-8601 start}" "${METRIC_END_UTC:?Explicit ISO-8601 end}"
13
+ : "${GSI_NAME:?Approved observed GSI name, not an assumed default}"
14
+ aws_target=(aws --profile "$AWS_PROFILE" --region "$AWS_REGION" --no-cli-pager --output json)
15
+ # Metadata preflight: stop before index metrics/alarm writes if the GSI is absent or not ACTIVE.
16
+ index_state=$("${aws_target[@]}" dynamodb describe-table --table-name "$TABLE_NAME" \
17
+ --query Table.GlobalSecondaryIndexes)
18
+ printf '%s' "$index_state" | python3 -c \
19
+ 'import json,sys; indexes=json.load(sys.stdin); ok=any(i.get("IndexName")==sys.argv[1] and i.get("IndexStatus")=="ACTIVE" for i in (indexes or [])); sys.exit(0 if ok else "Selected GSI is absent or not ACTIVE")' "$GSI_NAME"
20
+ ```
21
+
22
+ ## Domain: table and index health
23
+
24
+ | AWS/DynamoDB signal | Correct dimension set / statistic | What not to infer |
25
+ |---|---|---|
26
+ | ConsumedReadCapacityUnits / ConsumedWriteCapacityUnits | TableName; add GlobalSecondaryIndexName for a GSI; Sum divided by seconds for a rate | Period sum is not units/second; table-only does not aggregate every GSI |
27
+ | ReadThrottleEvents / WriteThrottleEvents | TableName; add GlobalSecondaryIndexName for GSI; Sum | Balanced table does not exclude a hot index or partial-batch throttling |
28
+ | ThrottledRequests / SystemErrors | TableName **and Operation**; Sum | SystemErrors with only TableName is not the matching series |
29
+ | SuccessfulRequestLatency | TableName + Operation; Average or p95/p99 | Service latency excludes client/network/retry time |
30
+ | UserErrors | Regional/account aggregate, no table dimensions; Sum | Not a per-table metric by inventing a TableName dimension |
31
+ | OnlineIndexPercentageProgress / OnlineIndexThrottleEvents | Documented table/index dimensions; inspect published series | A table ACTIVE waiter does not prove an online index ready |
32
+
33
+ Use documented metric dimensions exactly; extra/missing dimensions select a
34
+ different or nonexistent series rather than filtering a metric. `list-metrics`
35
+ helps discover published series but an absent series may be inactive/sparse, not
36
+ proof the metric or table doesn't exist. Inspect throttle reasons and per-key/index
37
+ signals; don't diagnose every event as insufficient total provisioned capacity.
38
+
39
+ ### Commands: discover and query table/GSI metrics
40
+
41
+ ```bash
42
+ "${aws_target[@]}" cloudwatch list-metrics --namespace AWS/DynamoDB \
43
+ --metric-name ReadThrottleEvents --dimensions Name=TableName,Value="$TABLE_NAME" --no-paginate
44
+ "${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DynamoDB \
45
+ --metric-name ReadThrottleEvents --dimensions Name=TableName,Value="$TABLE_NAME" \
46
+ --start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Sum
47
+ "${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DynamoDB \
48
+ --metric-name WriteThrottleEvents \
49
+ --dimensions Name=TableName,Value="$TABLE_NAME" Name=GlobalSecondaryIndexName,Value="$GSI_NAME" \
50
+ --start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Sum
51
+ "${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DynamoDB \
52
+ --metric-name SuccessfulRequestLatency \
53
+ --dimensions Name=TableName,Value="$TABLE_NAME" Name=Operation,Value=Query \
54
+ --start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --extended-statistics p99
55
+ "${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DynamoDB \
56
+ --metric-name SystemErrors --dimensions Name=TableName,Value="$TABLE_NAME" Name=Operation,Value=Query \
57
+ --start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Sum
58
+ ```
59
+
60
+ No datapoints is not a positive health verdict. Verify time bounds, metric
61
+ publication/retention granularity, namespace, Region, dimensions and sparse-event
62
+ behavior. Contributor Insights can reveal hot keys but is opt-in/cost-bearing and
63
+ can expose key values; handle activation and access as a separate privacy review.
64
+
65
+ ## Domain: replica, stream consumer and cache monitoring
66
+
67
+ | Component | Namespace / metric / dimensions | Interpretation |
68
+ |---|---|---|
69
+ | MREC replication | AWS/DynamoDB / ReplicationLatency / TableName + ReceivingRegion, queried in source Region; Average or Maximum | Observed lag, not a failover/RPO guarantee or MRSC transaction latency metric |
70
+ | Lambda stream consumer | AWS/Lambda / IteratorAge / FunctionName; Maximum | Alert well before 24-hour record retention; also inspect Errors/Throttles Sum and failure destinations |
71
+ | DAX | AWS/DAX / ItemCacheHits, ItemCacheMisses, QueryCacheHits, QueryCacheMisses / ClusterId (or observed ClusterId+NodeId); Sum | Compute hits/(hits+misses), guard zero denominator; separate item/query caches |
72
+
73
+ DAX emits sparse/nonzero signals; an idle cache is not a proven healthy cache.
74
+ Include DAX CPU/memory pressure, errors and throttles, plus application-level
75
+ cache staleness and fallback load. Check actual published dimension sets before
76
+ composing dashboards; do not combine a node series with an aggregate cluster one.
77
+
78
+ ```bash
79
+ : "${REPLICA_REGION:?Destination Region}" "${FUNCTION_NAME:?Consumer function}" "${DAX_CLUSTER_NAME:?Cluster ID}"
80
+ "${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DynamoDB \
81
+ --metric-name ReplicationLatency \
82
+ --dimensions Name=TableName,Value="$TABLE_NAME" Name=ReceivingRegion,Value="$REPLICA_REGION" \
83
+ --start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Maximum
84
+ "${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/Lambda \
85
+ --metric-name IteratorAge --dimensions Name=FunctionName,Value="$FUNCTION_NAME" \
86
+ --start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Maximum
87
+ "${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DAX \
88
+ --metric-name ItemCacheHits --dimensions Name=ClusterId,Value="$DAX_CLUSTER_NAME" \
89
+ --start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Sum
90
+ ```
91
+
92
+ ## Domain: alarms, notifications and permission boundaries
93
+
94
+ The following creates/updates one named GSI alarm and can overwrite an existing
95
+ alarm's settings. Inspect the current definition first, review its owner and exact
96
+ delta, and keep a rollback definition. Threshold/window here is illustrative, not
97
+ a workload-calibrated SLO. Wire an approved SNS topic and test subscriptions/topic
98
+ policy and actual delivery separately; an AlarmActions ARN alone proves nothing.
99
+
100
+ ```bash
101
+ : "${ALARM_NAME:?Reviewed alarm name}" "${SNS_TOPIC_ARN:?Approved notification topic}"
102
+ "${aws_target[@]}" cloudwatch describe-alarms --alarm-names "$ALARM_NAME"
103
+ # Approved alarm mutation; two of two one-minute periods with at least one event.
104
+ "${aws_target[@]}" cloudwatch put-metric-alarm --alarm-name "$ALARM_NAME" \
105
+ --namespace AWS/DynamoDB --metric-name WriteThrottleEvents \
106
+ --dimensions Name=TableName,Value="$TABLE_NAME" Name=GlobalSecondaryIndexName,Value="$GSI_NAME" \
107
+ --statistic Sum --period 60 --evaluation-periods 2 --datapoints-to-alarm 2 \
108
+ --threshold 0 --comparison-operator GreaterThanThreshold \
109
+ --treat-missing-data ignore --alarm-actions "$SNS_TOPIC_ARN" --actions-enabled
110
+ "${aws_target[@]}" cloudwatch describe-alarms --alarm-names "$ALARM_NAME"
111
+ ```
112
+
113
+ Current primary sources **disagree**: the CloudWatch user guide describes a default
114
+ of ignore with an override, while PutMetricAlarm's API reference says AWS/DynamoDB
115
+ always ignores missing data even when another setting is supplied. Do not claim
116
+ an override is guaranteed or silently label one source obsolete. This example
117
+ explicitly uses `ignore`, consistent with both descriptions: missing data can leave
118
+ the alarm in a stale state, including ALARM. It is not a heartbeat detector or an
119
+ automatic all-clear policy. Design a verified recovery/healthy signal and test
120
+ OK/ALARM/INSUFFICIENT_DATA transitions and notification delivery in the target
121
+ environment before relying on a different missing-data setting.
122
+
123
+ Metric queries use cloudwatch:ListMetrics/GetMetricStatistics/GetMetricData, not
124
+ dynamodb:GetItem. Account/metric read actions often lack table-level ARN scoping;
125
+ check CloudWatch SAR rather than using a DynamoDB ARN in their Resource field.
126
+ Alarm configuration uses cloudwatch:PutMetricAlarm/DescribeAlarms with appropriate
127
+ alarm resources; SNS delivery/topic administration is a separate service/policy.
128
+ Lambda logs and stream processing likewise have distinct role and resource scopes.
129
+ Keep these operational rights out of ordinary item CRUD roles.
130
+
131
+ Sources: [DynamoDB metrics/dimensions](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/metrics-dimensions.html),
132
+ [global-table monitoring](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html),
133
+ [DAX metrics](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/dax-metrics-dimensions-dax.html),
134
+ [Lambda metrics](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html),
135
+ [missing-data behavior](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarms-and-missing-data.html),
136
+ [PutMetricAlarm API conflict](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html),
137
+ [CloudWatch IAM](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazoncloudwatch.html).
@@ -0,0 +1,34 @@
1
+ # Official sources (repository adapter)
2
+
3
+ Use AWS documentation as the authority for service behaviour. Third-party skills,
4
+ blogs and model memory are leads, not evidence.
5
+
6
+ ## Where the evidence lives
7
+
8
+ - [The evidence ledger](evidence-ledger.md) traces each material AWS claim in this
9
+ skill to the AWS page that was fetched on its retrieval date, with its status
10
+ (VERIFIED, UNVERIFIED or CONFLICT).
11
+ - [The evidence index](evidence-index.md) maps ledger rows to the skill files they cover
12
+ and lists every unconfirmed or conflicting claim.
13
+ - [The source log](sources.md) records how each release was
14
+ researched, including the third-party skills that were read for inspiration only.
15
+
16
+ ## Primary AWS documentation
17
+
18
+ - DynamoDB Developer Guide:
19
+ <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/>
20
+ - DynamoDB API Reference:
21
+ <https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/>
22
+ - AWS CLI `dynamodb` reference:
23
+ <https://docs.aws.amazon.com/cli/latest/reference/dynamodb/>
24
+ - CloudFormation `AWS::DynamoDB::Table`:
25
+ <https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-dynamodb-table.html>
26
+ - Service Authorization Reference (IAM actions and condition keys):
27
+ <https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazondynamodb.html>
28
+
29
+ ## Grounding rule
30
+
31
+ Re-fetch the page before relying on a limit, quota, API parameter or IAM action:
32
+ they change. Where two AWS pages disagree, say so and cite both (see the CONFLICT
33
+ rows in the ledger). If no AWS page settles a claim, label it unverified rather than
34
+ inferring it from silence.
@@ -0,0 +1,130 @@
1
+ # Amazon DynamoDB operations
2
+
3
+ Operational coverage for Amazon DynamoDB (control-plane and data-plane APIs; on-demand and provisioned capacity modes; single-Region tables and global tables). Every section uses the
4
+ same heading and states one status. Cite evidence rows from
5
+ [the evidence ledger](evidence-ledger.md) as `[DP-Exx]`.
6
+ `tests/validate-nosql-operations.py` enforces this structure.
7
+
8
+ Statuses:
9
+
10
+ - `VERIFIED`: the provider documents the capability; every statement below cites a
11
+ VERIFIED row.
12
+ - `PARTIAL`: some of it is documented and some is not, or it is limited (by tier,
13
+ mode, Region or API); say which part is which.
14
+ - `UNSUPPORTED`: provider documentation states the capability does not exist. Cite it.
15
+ - `UNVERIFIED`: no official page settled it in this pass. Say what was searched.
16
+ - `NOT APPLICABLE`: the capability does not apply to this service. Say why.
17
+
18
+ ## Backup and restore
19
+
20
+ **Status:** VERIFIED
21
+
22
+ - Two backup types: on-demand backups (a table snapshot that DynamoDB stores and manages, created by DynamoDB or by AWS Backup) and continuous point-in-time recovery (PITR) backups. Each on-demand backup copies the entire table and there is no limit on how many you can take [DP-E601]. AWS Backup can run backup plans with schedules and retention policies for DynamoDB tables [DP-E605].
23
+ - PITR recovery period is configurable from 1 to 35 days [DP-E401]; `LatestRestorableDateTime` is typically about five minutes behind the current time [DP-E402]. Disabling and re-enabling PITR resets the start of the recoverable history [DP-E404].
24
+ - Backups and restores consume no provisioned throughput on the table [DP-E602]. On-demand backups are asynchronous and not causally consistent across items: changes within one minute of the request may or may not be included [DP-E416].
25
+ - Restore target is always a new table, never in place: PITR restore creates a new table [DP-E410], restore from a backup creates a new table from a backup ARN [DP-E415], and an existing table is not overwritten [DP-E604].
26
+ - A restore can change GSIs, LSIs, billing mode, provisioned capacity and encryption settings, and can target a different Region from where the backup resides [DP-E603].
27
+ - Not restored automatically (set them again on the restored table): auto scaling policies, IAM policies, CloudWatch metrics and alarms, tags, stream settings, TTL, deletion protection and PITR settings [DP-E411].
28
+ - Deleting a table with PITR enabled creates a system backup retained for 35 days [DP-E413]. All backups are automatically encrypted [DP-E607]; an on-demand backup made before a key change keeps its original key and needs it to restore [DP-E347].
29
+ - Tags and ABAC are not supported on DynamoDB-native backups; AWS Backup is the documented route for ABAC with backups [DP-E606].
30
+
31
+ ## Disaster recovery and replication
32
+
33
+ **Status:** VERIFIED
34
+
35
+ - Single-Region options are PITR and backups. The disaster recovery guide lists PITR with an RPO of seconds and an RTO of minutes, in a single Region only [DP-E608].
36
+ - Multi-Region option is global tables, in two consistency modes: multi-Region eventual consistency (MREC) and multi-Region strong consistency (MRSC) [DP-E144] [DP-E146]. MRSC mode cannot be changed after creation [DP-E431].
37
+ - Stated availability SLA: 99.999% for global tables versus 99.99% for single-Region tables [DP-E609].
38
+ - Stated RPO: MREC equals the replication delay between replicas, usually a few seconds [DP-E610]; MRSC supports an RPO of zero [DP-E611]. MREC replication is asynchronous and a strongly consistent read at a replica can miss a write from another Region [DP-E144]. No RTO figure is stated for global tables on the pages read here.
39
+ - Failover mode: the documentation describes shifting application traffic to a healthy replica table, which accepts reads and writes [DP-E612]. Replica placement is your decision: MRSC needs exactly three Regions (three replicas, or two plus a witness) [DP-E429].
40
+ - MREC transactions are not replicated atomically as a group [DP-E145]. PITR, tags, deletion protection and resource policies are not synchronized between replicas, so verify them per Region [DP-E426].
41
+ - Multi-account global tables are MREC only and have a different settings contract [DP-E436]. The MREC replication stream cannot be disabled [DP-E442].
42
+ - Cross-Region recovery from backups is separate from replication: a backup can be restored into a different Region [DP-E603].
43
+
44
+ ## Cost
45
+
46
+ **Status:** VERIFIED
47
+
48
+ Pricing: <https://aws.amazon.com/dynamodb/pricing/>. Estimate with the [AWS Pricing Calculator](https://calculator.aws/). No unit prices are recorded here.
49
+
50
+ - Throughput, on-demand: billed per read request unit and write request unit [DP-E613]. Reads are 4 KB increments and writes 1 KB increments; query capacity rounds the total returned size, and filters or projections do not reduce consumed capacity [DP-E127] [DP-E131].
51
+ - Throughput, provisioned: billed on the hourly provisioned read and write capacity, not on consumption [DP-E614]. Reserved capacity is an upfront fee plus a commitment to a minimum provisioned level [DP-E626].
52
+ - Storage: billed on raw item bytes plus a per-item overhead that depends on enabled features [DP-E615]. Usage types differ by table class (Standard or Standard-IA) [DP-E616].
53
+ - Backup: PITR is billed on table size for as long as PITR is enabled [DP-E617]; reducing the recovery window does not reduce the PITR price [DP-E406]. On-demand backups are billed on size and duration [DP-E618]. Restores are billed on total GB restored, including indexes [DP-E619].
54
+ - Replication: global table writes are billed per replica as replicated write units, GSI updates use standard write units [DP-E620]. There is no cross-Region transfer fee for global table replication [DP-E621]. TTL deletes replicate and are charged in the other Regions [DP-E425].
55
+ - Streams: DynamoDB Streams reads are billed in read request units [DP-E622]; Lambda trigger reads and global table replication reads are not charged [DP-E623].
56
+ - Data transfer: no charge for inbound transfer or same-Region transfer to other AWS services; cross-Region transfer is charged on both sides [DP-E624]. Interface (PrivateLink) endpoints are billed, gateway endpoints are not [DP-E648].
57
+ - Adjacent services: Contributor Insights is billed under CloudWatch [DP-E625]; CloudTrail data events and the CloudTrail logs of replication reads are billed by CloudTrail [DP-E660].
58
+
59
+ ## Monitoring
60
+
61
+ **Status:** PARTIAL
62
+
63
+ - DynamoDB publishes metrics to Amazon CloudWatch in the `AWS/DynamoDB` namespace [DP-E664]; consumed provisioned throughput is emitted per one-minute period [DP-E663].
64
+ - Capacity and throttling metrics: `ConsumedReadCapacityUnits` and `ConsumedWriteCapacityUnits` (add `GlobalSecondaryIndexName` for an index) [DP-E501]; `ReadThrottleEvents` and `WriteThrottleEvents` [DP-E502]; `ThrottledRequests` and `SystemErrors`, which need both `TableName` and `Operation` [DP-E503]; `UserErrors` is a Regional aggregate without a table dimension [DP-E505].
65
+ - Cause-specific throttle metrics include `ReadKeyRangeThroughputThrottleEvents` for partition limits [DP-E633].
66
+ - Global tables: MREC publishes `ReplicationLatency` with `TableName` and `ReceivingRegion` dimensions [DP-E509]; MRSC does not publish it [DP-E511].
67
+ - Usage metrics integrate with Service Quotas, and CloudWatch alarms can alert when usage approaches a threshold [DP-E665].
68
+ - PARTIAL because: a provider-recommended alarm set was not found on the pages read (searched the metrics and dimensions page, the throttling pages and the monitoring overview, which is JavaScript-rendered and returned no text). Alarm thresholds are therefore your own choice.
69
+
70
+ ## Performance
71
+
72
+ **Status:** VERIFIED
73
+
74
+ - Each partition is designed for a maximum of 3,000 read units and 1,000 write units per second [DP-E627]. Adaptive capacity applies to both on-demand and provisioned modes [DP-E628].
75
+ - Throttling has four documented causes: partition (key range) limits in both modes, provisioned throughput exceeded, account-level quotas in on-demand mode, and a configured on-demand maximum throughput [DP-E629]. Each maps to a cause-specific metric [DP-E633].
76
+ - The throttle exception carries `ThrottlingReason` fields naming the resource, operation and limit [DP-E632]. The AWS SDKs automatically retry `ProvisionedThroughputExceededException` [DP-E635].
77
+ - On-demand scaling: new tables sustain up to 4,000 writes and 12,000 reads per second [DP-E636]; tables accommodate up to double the previous peak instantly [DP-E630], and throttling can occur if you exceed double the previous peak within 30 minutes [DP-E631]. An optional maximum throughput per table or index throttles requests above it [DP-E634].
78
+ - Index pressure: an overloaded GSI can throttle base-table writes [DP-E107]; on-demand GSIs still have limits and hot keys [DP-E116].
79
+ - An LSI item collection lives in one partition and is limited to 10 GB per partition key value [DP-E108] [DP-E122].
80
+
81
+ ## IAM
82
+
83
+ **Status:** VERIFIED
84
+
85
+ - Identity-based policies use `dynamodb:*` actions. Control-plane actions (`CreateTable`, `UpdateTable`, `DeleteTable`, `DescribeTable`, TTL and continuous-backup actions) apply to the table resource [DP-E307]; `ListTables`, `ListStreams`, `DescribeLimits` and `DescribeEndpoints` have no resource-level scope [DP-E309].
86
+ - Resource ARNs: tables `table/<name>`, indexes `table/<name>/index/<index>`, streams `table/<name>/stream/<label>` [DP-E301].
87
+ - Built-in managed policies: `AmazonDynamoDBFullAccess` [DP-E637] and `AmazonDynamoDBReadOnlyAccess` [DP-E638]. They are broad, so prefer scoped custom policies for production.
88
+ - Least privilege levers: restrict by table and index ARN [DP-E301]; `dynamodb:LeadingKeys` for item-level scoping on supported actions (not `Scan`) [DP-E315]; tag conditions with ABAC [DP-E321].
89
+ - Resource-based policies are supported for tables, indexes and streams [DP-E639]; support differs by API and cross-account use [DP-E325]. IAM Access Analyzer reports cross-account access in them [DP-E640], and Block Public Access is enforced automatically with no setting [DP-E641].
90
+ - Global tables use a service-linked role; an explicit deny of its replication action breaks adding or deleting replicas [DP-E331]. Replica creation needs specific permissions on source and destination [DP-E421].
91
+
92
+ ## Tagging
93
+
94
+ **Status:** PARTIAL
95
+
96
+ - Tables can be tagged [DP-E642], tags feed AWS cost reports [DP-E643], and indexes inherit the tags of their table [DP-E317]. Tag operations (`TagResource`, `UntagResource`, `ListTagsOfResource`) apply to a table or stream [DP-E310].
97
+ - Tag-based access control (ABAC) is documented for tables and, separately, for Streams, with enablement scoped per account and Region [DP-E321]. Behaviour of tag conditions when ABAC is disabled differs [DP-E323].
98
+ - Not covered: DynamoDB-native backups cannot be tagged and do not support ABAC [DP-E606]. Tags are not restored with a table [DP-E411] and are not synchronized between global table replicas [DP-E426].
99
+ - PARTIAL because two official pages disagree on Streams: the Tagging page says Streams usage cannot be tagged, while the Streams tagging page documents adding tags to existing streams [DP-E644] [DP-E318]. Test before relying on stream tags.
100
+
101
+ ## Encryption
102
+
103
+ **Status:** VERIFIED
104
+
105
+ - At rest: server-side encryption is always on and cannot be disabled; LSIs and GSIs use the base table key [DP-E334] [DP-E120].
106
+ - Key choices: AWS owned key (default, no charge), AWS managed key `alias/aws/dynamodb`, or customer managed key; the latter two incur AWS KMS charges [DP-E335]. For the AWS managed key you can view the policy and audit use in CloudTrail [DP-E336].
107
+ - Customer managed key restrictions: symmetric keys only [DP-E337]; the key policy must grant DynamoDB access, at minimum including `kms:CreateGrant` [DP-E346]; disabling or deleting the key, or removing grants, can block table access [DP-E349]. Global tables add a customer managed key version requirement [DP-E350].
108
+ - Changing keys with `update-table` switches the table key [DP-E343]; older on-demand backups keep their original key and need it to restore [DP-E347]. Table keys are cached, so KMS is not called for every item access [DP-E338].
109
+ - DAX cluster encryption is separate and does not support a customer managed key [DP-E351]. All backups are automatically encrypted [DP-E607].
110
+ - In transit: clients must support TLS 1.2 [DP-E645].
111
+
112
+ ## Network isolation
113
+
114
+ **Status:** PARTIAL
115
+
116
+ - Two VPC endpoint types reach DynamoDB: a gateway endpoint (a route-table target over the AWS network) and an interface endpoint using AWS PrivateLink [DP-E646]. Both can coexist in one VPC [DP-E648].
117
+ - Interface endpoints give VPC applications private IP access without public IP addresses [DP-E647]. They are billed; gateway endpoints are not [DP-E648]. PrivateLink is also supported for DynamoDB Streams endpoints [DP-E652].
118
+ - Scope access with a VPC endpoint policy (principal, actions, resources) [DP-E651]. For requests via a VPC endpoint, both the IAM policy and the endpoint policy must authorize `DescribeEndpoints` [DP-E653].
119
+ - PrivateLink limits: 50,000 requests per second per endpoint [DP-E650]; do not override DynamoDB DNS names with private hosted zones, point clients at the endpoint URL instead [DP-E649].
120
+ - PARTIAL because: the documentation read here describes private paths and policy scoping but no setting that turns off the public DynamoDB endpoint for an account or table. Block Public Access applies to resource-based policies, not to the network path [DP-E641]. Two pages also differ on on-premises reach of "VPC endpoints" (Site-to-Site VPN and Direct Connect) without saying which endpoint type the older note means [DP-E654].
121
+
122
+ ## Audit logging
123
+
124
+ **Status:** VERIFIED
125
+
126
+ - AWS CloudTrail records DynamoDB API calls from the console, SDKs, PartiQL and the classic API [DP-E655]. Without a trail, recent events stay in CloudTrail Event history [DP-E661].
127
+ - Control-plane events (table, backup, global table, tag, TTL, DAX and Streams describe or list actions) are logged by default [DP-E656]. Backup and restore actions are recorded [DP-E662].
128
+ - Data-plane (item-level) auditing is possible but opt-in: you must enable logging of data plane API activity as CloudTrail data events [DP-E657].
129
+ - Data events can be filtered by resource type (table or stream) to control what is logged and billed [DP-E658]. TTL deletions are not logged [DP-E659].
130
+ - Logging `GetRecords` data events also captures internal global tables replication calls and is billed by CloudTrail, so filter them out [DP-E660].
@@ -0,0 +1,110 @@
1
+ # Create the worked-model table
2
+
3
+ Choose **one** owner: CloudFormation **or** direct CLI, not both for the same new
4
+ table. These are examples to inspect and adapt, not instructions to execute during
5
+ skill authoring. Any live AWS call needs authorized target/data scope; creation
6
+ additionally needs approval of the exact change and recurring charges.
7
+
8
+ Both paths define string PK/SK, string GSI1PK/GSI1SK, GSI1 with INCLUDE projection,
9
+ on-demand billing, deletion protection, TTL and PITR. The CLI creates the same keys,
10
+ index and billing first, then configures TTL/PITR through separate APIs.
11
+
12
+ For these ordinary table/GSI examples, only key attributes belong in
13
+ `AttributeDefinitions`. Do **not** add `status`,
14
+ `orderId`, `totalMinor` or every application field there. They are item attributes,
15
+ not key declarations. Sparse membership depends on which items supply GSI keys.
16
+ Native vector indexes are different: their HASH **and INLINE_FILTER** SearchSchema
17
+ attributes need scalar declarations; the embedding list itself does not. See
18
+ [data types and vectors](data-types-and-vectors.md) instead of extending this
19
+ ordinary-index rule to vector indexes.
20
+
21
+ For operational commands and the optional **new-table** LSI alternative, see
22
+ [Commands](commands/aws-cli.md) and [LSI vs GSI](lsi-vs-gsi.md). For deliberate AWS-managed
23
+ or customer-managed KMS selection, use [Encryption](encryption.md). The default
24
+ assets still use an AWS-owned key and no LSI; do not silently change either.
25
+
26
+ ## CloudFormation
27
+
28
+ Use [table.cfn.yaml](../assets/table.cfn.yaml). Essential excerpt (not a standalone
29
+ template; the asset includes index attribute definitions and preservation policies):
30
+
31
+ ```yaml
32
+ Type: AWS::DynamoDB::Table
33
+ Properties:
34
+ BillingMode: PAY_PER_REQUEST
35
+ DeletionProtectionEnabled: true
36
+ KeySchema:
37
+ - AttributeName: PK
38
+ KeyType: HASH
39
+ - AttributeName: SK
40
+ KeyType: RANGE
41
+ TimeToLiveSpecification:
42
+ AttributeName: expiresAt
43
+ Enabled: true
44
+ PointInTimeRecoverySpecification:
45
+ PointInTimeRecoveryEnabled: true
46
+ ```
47
+
48
+ After target/cost approval, create an **unexecuted** change set, inspect it, then
49
+ obtain approval before executing that exact change-set ARN:
50
+
51
+ ```bash
52
+ # Run from this skill's directory. All variables are explicit approved values.
53
+ : "${AWS_PROFILE:?}" "${AWS_REGION:?}" "${STACK_NAME:?}" "${TABLE_NAME:?}"
54
+ aws --profile "$AWS_PROFILE" --region "$AWS_REGION" sts get-caller-identity
55
+ cfn-lint assets/table.cfn.yaml # local check only
56
+ aws --profile "$AWS_PROFILE" --region "$AWS_REGION" cloudformation deploy \
57
+ --template-file assets/table.cfn.yaml --stack-name "$STACK_NAME" \
58
+ --parameter-overrides TableName="$TABLE_NAME" --no-execute-changeset
59
+ # Inspect the generated change set. Use its exact ARN for subsequent approved
60
+ # describe-change-set / execute-change-set / wait stack-create-complete calls.
61
+ # An update uses the matching stack-update waiter instead. No implicit execution.
62
+ ```
63
+
64
+ `Retain`/`UpdateReplacePolicy: Retain` deliberately keep billable data/resources.
65
+ The named table may prevent replacement; inspect changes rather than forcing it.
66
+ Deletion protection also blocks normal table deletion; disabling it is a separate
67
+ destructive decision, not a default cleanup step. DynamoDB encrypts at rest by
68
+ default; this example leaves the AWS-owned default key. Customer-managed KMS keys
69
+ need separate key policy/IAM, availability, lifecycle and cost review.
70
+
71
+ ## AWS CLI v2
72
+
73
+ Inspect [create-table.json](../assets/create-table.json) and
74
+ [create-table.sh](../assets/create-table.sh). Minimal creation shape, **not executed**:
75
+
76
+ ```bash
77
+ : "${AWS_PROFILE:?}" "${AWS_REGION:?}" "${TABLE_NAME:?}"
78
+ aws --profile "$AWS_PROFILE" --region "$AWS_REGION" dynamodb create-table \
79
+ --table-name "$TABLE_NAME" --cli-input-json file://assets/create-table.json
80
+ aws --profile "$AWS_PROFILE" --region "$AWS_REGION" dynamodb wait table-exists \
81
+ --table-name "$TABLE_NAME"
82
+ aws --profile "$AWS_PROFILE" --region "$AWS_REGION" dynamodb update-time-to-live \
83
+ --table-name "$TABLE_NAME" \
84
+ --time-to-live-specification 'Enabled=true,AttributeName=expiresAt'
85
+ aws --profile "$AWS_PROFILE" --region "$AWS_REGION" dynamodb update-continuous-backups \
86
+ --table-name "$TABLE_NAME" \
87
+ --point-in-time-recovery-specification 'PointInTimeRecoveryEnabled=true'
88
+ ```
89
+
90
+ The complete shell example adds an account guard and interactive target check.
91
+ Its confirmation prompt is not a substitute for approval of role/Region/resource.
92
+ It fails on an existing table and on any failed step. If TTL/PITR fails **after**
93
+ creation, leave the table intact, read back actual state, and resume only the
94
+ approved missing configuration; do not rerun creation, auto-delete or adopt a
95
+ different table. A create timeout is also an unknown outcome: reconcile first.
96
+
97
+ TTL may report ENABLING before ENABLED; explicitly verify final status when TTL
98
+ is required. Check table and GSI ACTIVE, key/projection/billing, deletion protection,
99
+ PITR ENABLED and TTL attribute/status. A successful create response or table waiter
100
+ does not prove all later settings or application access. Do not auto-delete test
101
+ resources; disclose retained cost and propose separately approved cleanup.
102
+
103
+ The example deliberately excludes LSIs, Streams, Global Tables, alarms, workload
104
+ IAM, tags and on-demand maximum/warm-throughput tuning. Add only when justified;
105
+ it is not a complete production landing zone. On-demand has workload/partition
106
+ limits and is not a cost ceiling. Refresh service quotas and prices for the Region.
107
+
108
+ Sources: [CloudFormation table](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-dynamodb-table.html),
109
+ [CLI CreateTable](https://docs.aws.amazon.com/cli/latest/reference/dynamodb/create-table.html),
110
+ [PITR](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/PointInTimeRecovery.html).