@1aboveio/skills 0.0.0-stage → 1.0.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 (633) hide show
  1. package/README.md +30 -2
  2. package/bin/cli.mjs +14 -0
  3. package/bin/select-core.mjs +172 -0
  4. package/package.json +146 -4
  5. package/skills/app-dev/airflow/LICENSE +3 -0
  6. package/skills/app-dev/airflow/SKILL.md +199 -0
  7. package/skills/app-dev/airflow/release-check.mjs +93 -0
  8. package/skills/app-dev/android-foundation/LICENSE +3 -0
  9. package/skills/app-dev/android-foundation/SKILL.md +192 -0
  10. package/skills/app-dev/android-foundation/assets/android-ci-job.yml +217 -0
  11. package/skills/app-dev/android-foundation/references/ci.md +87 -0
  12. package/skills/app-dev/android-foundation/references/gotchas.md +221 -0
  13. package/skills/app-dev/android-foundation/references/setup.md +164 -0
  14. package/skills/app-dev/android-foundation/release-check.mjs +93 -0
  15. package/skills/app-dev/android-foundation/scripts/device-run.sh +176 -0
  16. package/skills/app-dev/android-foundation/scripts/device-run.test.mjs +172 -0
  17. package/skills/app-dev/app-debug/LICENSE +3 -0
  18. package/skills/app-dev/app-debug/SKILL.md +110 -0
  19. package/skills/app-dev/app-debug/references/common-errors.md +128 -0
  20. package/skills/app-dev/app-debug/release-check.mjs +93 -0
  21. package/skills/app-dev/better-auth/LICENSE +3 -0
  22. package/skills/app-dev/better-auth/SKILL.md +598 -0
  23. package/skills/app-dev/better-auth/references/feishu-api.md +270 -0
  24. package/skills/app-dev/better-auth/release-check.mjs +93 -0
  25. package/skills/app-dev/data-catalog/LICENSE +3 -0
  26. package/skills/app-dev/data-catalog/SKILL.md +204 -0
  27. package/skills/app-dev/data-catalog/agents/openai.yaml +3 -0
  28. package/skills/app-dev/data-catalog/references/data-catalog-conventions.md +75 -0
  29. package/skills/app-dev/data-catalog/references/field-definitions.md +116 -0
  30. package/skills/app-dev/data-catalog/references/format.md +121 -0
  31. package/skills/app-dev/data-catalog/release-check.mjs +93 -0
  32. package/skills/app-dev/data-catalog/scripts/data-catalog.test.mjs +36 -0
  33. package/skills/app-dev/data-catalog/scripts/data_catalog.py +1392 -0
  34. package/skills/app-dev/data-catalog/scripts/persist-conventions-core.mjs +117 -0
  35. package/skills/app-dev/data-catalog/scripts/persist-conventions.mjs +17 -0
  36. package/skills/app-dev/data-catalog/scripts/test_data_catalog.py +571 -0
  37. package/skills/app-dev/ios-foundation/LICENSE +3 -0
  38. package/skills/app-dev/ios-foundation/SKILL.md +184 -0
  39. package/skills/app-dev/ios-foundation/references/setup.md +243 -0
  40. package/skills/app-dev/ios-foundation/release-check.mjs +93 -0
  41. package/skills/app-dev/monorepo/LICENSE +3 -0
  42. package/skills/app-dev/monorepo/SKILL.md +462 -0
  43. package/skills/app-dev/monorepo/release-check.mjs +93 -0
  44. package/skills/app-dev/nextjs-fullstack/LICENSE +3 -0
  45. package/skills/app-dev/nextjs-fullstack/SKILL.md +211 -0
  46. package/skills/app-dev/nextjs-fullstack/conventions.md +318 -0
  47. package/skills/app-dev/nextjs-fullstack/frontend-conventions.md +61 -0
  48. package/skills/app-dev/nextjs-fullstack/nextjs16.md +287 -0
  49. package/skills/app-dev/nextjs-fullstack/release-check.mjs +93 -0
  50. package/skills/app-dev/nextjs-fullstack/server-actions.md +409 -0
  51. package/skills/app-dev/prisma-setup/LICENSE +3 -0
  52. package/skills/app-dev/prisma-setup/SKILL.md +181 -0
  53. package/skills/app-dev/prisma-setup/nextjs.md +258 -0
  54. package/skills/app-dev/prisma-setup/release-check.mjs +93 -0
  55. package/skills/app-dev/prisma-setup/turborepo.md +301 -0
  56. package/skills/app-dev/pyspark/LICENSE +3 -0
  57. package/skills/app-dev/pyspark/SKILL.md +127 -0
  58. package/skills/app-dev/pyspark/assets/templates/etl.py +748 -0
  59. package/skills/app-dev/pyspark/assets/templates/utils/__init__.py +1 -0
  60. package/skills/app-dev/pyspark/assets/templates/utils/hudi_metadata.py +14 -0
  61. package/skills/app-dev/pyspark/references/diagnosis-and-profiling.md +169 -0
  62. package/skills/app-dev/pyspark/references/etl-contract.md +129 -0
  63. package/skills/app-dev/pyspark/references/production-validation.md +131 -0
  64. package/skills/app-dev/pyspark/references/reconciliation.md +38 -0
  65. package/skills/app-dev/pyspark/references/transformation-design.md +190 -0
  66. package/skills/app-dev/pyspark/references/velocity-feature-calculation.md +193 -0
  67. package/skills/app-dev/pyspark/release-check.mjs +93 -0
  68. package/skills/app-dev/pyspark/scripts/spark_eventlog_summary.py +223 -0
  69. package/skills/app-dev/python-backend/LICENSE +3 -0
  70. package/skills/app-dev/python-backend/SKILL.md +325 -0
  71. package/skills/app-dev/python-backend/assets/uv-install.sh +48 -0
  72. package/skills/app-dev/python-backend/references/uv-installs.md +83 -0
  73. package/skills/app-dev/python-backend/release-check.mjs +93 -0
  74. package/skills/app-dev/shadcn/LICENSE +3 -0
  75. package/skills/app-dev/shadcn/SKILL.md +120 -0
  76. package/skills/app-dev/shadcn/assets/shadcn-small.png +0 -0
  77. package/skills/app-dev/shadcn/assets/shadcn.png +0 -0
  78. package/skills/app-dev/shadcn/cli.md +411 -0
  79. package/skills/app-dev/shadcn/customization.md +224 -0
  80. package/skills/app-dev/shadcn/mcp.md +101 -0
  81. package/skills/app-dev/shadcn/release-check.mjs +93 -0
  82. package/skills/app-dev/shadcn/rules/base-vs-radix.md +323 -0
  83. package/skills/app-dev/shadcn/rules/component-selection.md +67 -0
  84. package/skills/app-dev/shadcn/rules/composition.md +195 -0
  85. package/skills/app-dev/shadcn/rules/data-table.md +201 -0
  86. package/skills/app-dev/shadcn/rules/forms.md +255 -0
  87. package/skills/app-dev/shadcn/rules/icons.md +103 -0
  88. package/skills/app-dev/shadcn/rules/styling.md +167 -0
  89. package/skills/app-dev/zod-v4/LICENSE +3 -0
  90. package/skills/app-dev/zod-v4/SKILL.md +286 -0
  91. package/skills/app-dev/zod-v4/release-check.mjs +93 -0
  92. package/skills/cicd/cloud-build/LICENSE +3 -0
  93. package/skills/cicd/cloud-build/SKILL.md +707 -0
  94. package/skills/cicd/cloud-build/release-check.mjs +93 -0
  95. package/skills/cicd/cloud-debug/LICENSE +3 -0
  96. package/skills/cicd/cloud-debug/SKILL.md +315 -0
  97. package/skills/cicd/cloud-debug/references/build-failures.md +238 -0
  98. package/skills/cicd/cloud-debug/references/deploy-failures.md +376 -0
  99. package/skills/cicd/cloud-debug/references/pipeline-failures.md +378 -0
  100. package/skills/cicd/cloud-debug/release-check.mjs +93 -0
  101. package/skills/cicd/cloud-deploy/LICENSE +3 -0
  102. package/skills/cicd/cloud-deploy/SKILL.md +230 -0
  103. package/skills/cicd/cloud-deploy/references/config-templates.md +257 -0
  104. package/skills/cicd/cloud-deploy/release-check.mjs +93 -0
  105. package/skills/cicd/docker/LICENSE +3 -0
  106. package/skills/cicd/docker/SKILL.md +151 -0
  107. package/skills/cicd/docker/release-check.mjs +93 -0
  108. package/skills/cicd/github-actions/LICENSE +3 -0
  109. package/skills/cicd/github-actions/SKILL.md +111 -0
  110. package/skills/cicd/github-actions/references/audit-profile-optimize.md +150 -0
  111. package/skills/cicd/github-actions/references/ci-case-studies.md +141 -0
  112. package/skills/cicd/github-actions/references/conditional-ci.md +214 -0
  113. package/skills/cicd/github-actions/references/debugging.md +13 -0
  114. package/skills/cicd/github-actions/references/pipeline.md +87 -0
  115. package/skills/cicd/github-actions/references/post-deploy-and-publishing.md +33 -0
  116. package/skills/cicd/github-actions/references/runners.md +253 -0
  117. package/skills/cicd/github-actions/references/security.md +29 -0
  118. package/skills/cicd/github-actions/references/speed-and-audit.md +115 -0
  119. package/skills/cicd/github-actions/references/two-pass-reading.md +92 -0
  120. package/skills/cicd/github-actions/release-check.mjs +93 -0
  121. package/skills/cicd/github-actions/scripts/ci-run-audit-core.mjs +612 -0
  122. package/skills/cicd/github-actions/scripts/ci-run-audit.mjs +4 -0
  123. package/skills/cicd/github-actions/scripts/ci-run-audit.test.mjs +637 -0
  124. package/skills/cicd/github-flow/LICENSE +3 -0
  125. package/skills/cicd/github-flow/SKILL.md +123 -0
  126. package/skills/cicd/github-flow/references/ci-conventions.md +14 -0
  127. package/skills/cicd/github-flow/release-check.mjs +93 -0
  128. package/skills/cicd/github-flow/scripts/flow-core.mjs +105 -0
  129. package/skills/cicd/github-flow/scripts/flow.mjs +81 -0
  130. package/skills/cicd/github-flow/scripts/flow.test.mjs +114 -0
  131. package/skills/cicd/github-flow/scripts/persist-conventions-core.mjs +117 -0
  132. package/skills/cicd/github-flow/scripts/persist-conventions.mjs +49 -0
  133. package/skills/cicd/github-flow/scripts/persist-conventions.test.mjs +108 -0
  134. package/skills/cicd/google-cloud/LICENSE +3 -0
  135. package/skills/cicd/google-cloud/SKILL.md +119 -0
  136. package/skills/cicd/google-cloud/references/gcs.md +469 -0
  137. package/skills/cicd/google-cloud/references/iam.md +451 -0
  138. package/skills/cicd/google-cloud/references/project.md +349 -0
  139. package/skills/cicd/google-cloud/references/secrets.md +336 -0
  140. package/skills/cicd/google-cloud/references/vpc.md +312 -0
  141. package/skills/cicd/google-cloud/release-check.mjs +93 -0
  142. package/skills/cicd/google-cloud/scripts/create-sa.sh +36 -0
  143. package/skills/cicd/google-cloud/scripts/gcp-config.sh +31 -0
  144. package/skills/cicd/google-cloud/scripts/grant-iap.sh +41 -0
  145. package/skills/cicd/google-cloud/scripts/setup-secrets.sh +48 -0
  146. package/skills/cicd/mergify/LICENSE +3 -0
  147. package/skills/cicd/mergify/SKILL.md +102 -0
  148. package/skills/cicd/mergify/assets/templates/mergify.yml +215 -0
  149. package/skills/cicd/mergify/assets/templates/ruleset.json +46 -0
  150. package/skills/cicd/mergify/references/branch-protection.md +282 -0
  151. package/skills/cicd/mergify/references/configuration.md +274 -0
  152. package/skills/cicd/mergify/references/diagnosis.md +109 -0
  153. package/skills/cicd/mergify/references/stacks.md +84 -0
  154. package/skills/cicd/mergify/references/traps.md +119 -0
  155. package/skills/cicd/mergify/references/watch-contract.md +274 -0
  156. package/skills/cicd/mergify/release-check.mjs +93 -0
  157. package/skills/cicd/mergify/scripts/audit-core.mjs +208 -0
  158. package/skills/cicd/mergify/scripts/audit.mjs +4 -0
  159. package/skills/cicd/mergify/scripts/audit.test.mjs +201 -0
  160. package/skills/cicd/mergify/scripts/entrypoints.test.mjs +106 -0
  161. package/skills/cicd/mergify/scripts/pr-620-mergify-comments.fixture.json +30 -0
  162. package/skills/cicd/mergify/scripts/stack-push-core.mjs +258 -0
  163. package/skills/cicd/mergify/scripts/stack-push.mjs +4 -0
  164. package/skills/cicd/mergify/scripts/stack-push.test.mjs +233 -0
  165. package/skills/cicd/mergify/scripts/watch-pr-delivery-core.mjs +1065 -0
  166. package/skills/cicd/mergify/scripts/watch-pr-delivery.mjs +4 -0
  167. package/skills/cicd/mergify/scripts/watch-pr-delivery.test.mjs +1826 -0
  168. package/skills/cicd/podman/LICENSE +3 -0
  169. package/skills/cicd/podman/SKILL.md +71 -0
  170. package/skills/cicd/podman/agents/openai.yaml +4 -0
  171. package/skills/cicd/podman/assets/templates/podman-compose-socket-directory.yml +6 -0
  172. package/skills/cicd/podman/assets/templates/podman-service-override.conf +3 -0
  173. package/skills/cicd/podman/references/compose-compatibility.md +70 -0
  174. package/skills/cicd/podman/references/networking-and-ports.md +74 -0
  175. package/skills/cicd/podman/references/rootless-services-and-sockets.md +156 -0
  176. package/skills/cicd/podman/references/troubleshooting.md +98 -0
  177. package/skills/cicd/podman/release-check.mjs +93 -0
  178. package/skills/content/article-review/LICENSE +3 -0
  179. package/skills/content/article-review/SKILL.md +66 -0
  180. package/skills/content/article-review/references/report-format.md +68 -0
  181. package/skills/content/article-review/references/template-guide.md +79 -0
  182. package/skills/content/article-review/references/template-wechat-payments.md +125 -0
  183. package/skills/content/article-review/release-check.mjs +93 -0
  184. package/skills/content/article-to-image/LICENSE +3 -0
  185. package/skills/content/article-to-image/SKILL.md +91 -0
  186. package/skills/content/article-to-image/references/formats.md +53 -0
  187. package/skills/content/article-to-image/release-check.mjs +93 -0
  188. package/skills/content/flowchart-svg/LICENSE +3 -0
  189. package/skills/content/flowchart-svg/SKILL.md +43 -0
  190. package/skills/content/flowchart-svg/release-check.mjs +93 -0
  191. package/skills/content/flowchart-svg/scripts/export_png.sh +8 -0
  192. package/skills/content/image-gen/LICENSE +3 -0
  193. package/skills/content/image-gen/SKILL.md +192 -0
  194. package/skills/content/image-gen/release-check.mjs +93 -0
  195. package/skills/content/image-gen/scripts/credentials.mjs +217 -0
  196. package/skills/content/image-gen/scripts/credentials.test.mjs +212 -0
  197. package/skills/content/image-gen/scripts/generate.mjs +240 -0
  198. package/skills/content/image-gen/scripts/options.mjs +293 -0
  199. package/skills/content/image-gen/scripts/options.test.mjs +245 -0
  200. package/skills/content/mermaid/LICENSE +3 -0
  201. package/skills/content/mermaid/SKILL.md +635 -0
  202. package/skills/content/mermaid/release-check.mjs +93 -0
  203. package/skills/content/wechat-article-writer/LICENSE +3 -0
  204. package/skills/content/wechat-article-writer/SKILL.md +92 -0
  205. package/skills/content/wechat-article-writer/references/style-selector.md +133 -0
  206. package/skills/content/wechat-article-writer/references/writing-rules.md +152 -0
  207. package/skills/content/wechat-article-writer/release-check.mjs +93 -0
  208. package/skills/content/wechat-article-writer/templates/wechat-comparison.md +52 -0
  209. package/skills/content/wechat-article-writer/templates/wechat-howto.md +51 -0
  210. package/skills/content/wechat-article-writer/templates/wechat-insight.md +50 -0
  211. package/skills/content/wechat-article-writer/templates/wechat-pitfall.md +52 -0
  212. package/skills/content/wechat-publisher/LICENSE +3 -0
  213. package/skills/content/wechat-publisher/SKILL.md +171 -0
  214. package/skills/content/wechat-publisher/references/api.md +105 -0
  215. package/skills/content/wechat-publisher/references/layout-rules.md +57 -0
  216. package/skills/content/wechat-publisher/references/wechat-safe-template.html +86 -0
  217. package/skills/content/wechat-publisher/release-check.mjs +93 -0
  218. package/skills/content/wechat-publisher/scripts/md_to_wechat_html.py +194 -0
  219. package/skills/content/wechat-publisher/scripts/publish.py +239 -0
  220. package/skills/content/wechat-search/LICENSE +3 -0
  221. package/skills/content/wechat-search/SKILL.md +211 -0
  222. package/skills/content/wechat-search/release-check.mjs +93 -0
  223. package/skills/content/wechat-search/scripts/start-chrome.sh +83 -0
  224. package/skills/content/xai-search/LICENSE +3 -0
  225. package/skills/content/xai-search/SKILL.md +79 -0
  226. package/skills/content/xai-search/release-check.mjs +93 -0
  227. package/skills/content/xai-search/scripts/xai_search.sh +187 -0
  228. package/skills/content/xai-search/tests/smoke_test.sh +36 -0
  229. package/skills/core/distill-writing/LICENSE +3 -0
  230. package/skills/core/distill-writing/SKILL.md +74 -0
  231. package/skills/core/distill-writing/references/extraction.md +95 -0
  232. package/skills/core/distill-writing/references/updating.md +46 -0
  233. package/skills/core/distill-writing/release-check.mjs +93 -0
  234. package/skills/core/doc-to-md/LICENSE +3 -0
  235. package/skills/core/doc-to-md/SKILL.md +78 -0
  236. package/skills/core/doc-to-md/release-check.mjs +93 -0
  237. package/skills/core/doc-to-md/scripts/convert.py +157 -0
  238. package/skills/core/editorial-review/LICENSE +3 -0
  239. package/skills/core/editorial-review/SKILL.md +79 -0
  240. package/skills/core/editorial-review/references/checklist.md +94 -0
  241. package/skills/core/editorial-review/release-check.mjs +93 -0
  242. package/skills/core/house-style/LICENSE +3 -0
  243. package/skills/core/house-style/SKILL.md +33 -0
  244. package/skills/core/house-style/references/defaults.md +66 -0
  245. package/skills/core/house-style/references/rules.md +267 -0
  246. package/skills/core/house-style/references/sources.md +27 -0
  247. package/skills/core/house-style/references/style-en.md +131 -0
  248. package/skills/core/house-style/references/style-zh.md +141 -0
  249. package/skills/core/house-style/references/terminology-zh.md +223 -0
  250. package/skills/core/house-style/release-check.mjs +93 -0
  251. package/skills/core/house-style/templates/brd.md +103 -0
  252. package/skills/core/house-style/templates/commercial-proposal.md +93 -0
  253. package/skills/core/house-style/templates/compliance-policy.md +109 -0
  254. package/skills/core/house-style/templates/gap-analysis.md +105 -0
  255. package/skills/core/house-style/templates/general.md +63 -0
  256. package/skills/core/house-style/templates/integration-guide.md +98 -0
  257. package/skills/core/house-style/templates/prd.md +81 -0
  258. package/skills/core/house-style/templates/risk-operations-procedure.md +94 -0
  259. package/skills/core/house-style/templates/technical-spec.md +96 -0
  260. package/skills/core/polish-cn/LICENSE +3 -0
  261. package/skills/core/polish-cn/SKILL.md +102 -0
  262. package/skills/core/polish-cn/references/brief.md +93 -0
  263. package/skills/core/polish-cn/references/models.md +76 -0
  264. package/skills/core/polish-cn/release-check.mjs +93 -0
  265. package/skills/core/polish-cn/scripts/polish-cn.test.mjs +244 -0
  266. package/skills/core/polish-cn/scripts/polish_blocks.py +489 -0
  267. package/skills/core/reg-parser/LICENSE +3 -0
  268. package/skills/core/reg-parser/SKILL.md +212 -0
  269. package/skills/core/reg-parser/references/checklist-schema.md +223 -0
  270. package/skills/core/reg-parser/references/checklists/hk-amlo-checklist.json +1306 -0
  271. package/skills/core/reg-parser/references/checklists/hk-amlo-checklist.md +469 -0
  272. package/skills/core/reg-parser/references/checklists/hk-fi-corporate-onboarding-cdd-checklist.json +634 -0
  273. package/skills/core/reg-parser/references/checklists/hk-fi-corporate-onboarding-cdd-checklist.md +233 -0
  274. package/skills/core/reg-parser/references/checklists/hk-mso-guideline-checklist.json +2194 -0
  275. package/skills/core/reg-parser/references/checklists/hk-mso-guideline-checklist.md +771 -0
  276. package/skills/core/reg-parser/references/checklists/kyc-aml-checklist.md +258 -0
  277. package/skills/core/reg-parser/references/checklists/visa-vars-checklist.md +1058 -0
  278. package/skills/core/reg-parser/references/mandates/hk-amlo-cap615.md +389 -0
  279. package/skills/core/reg-parser/references/mandates/visa-vars.md +205 -0
  280. package/skills/core/reg-parser/release-check.mjs +93 -0
  281. package/skills/core/reg-parser/scripts/compare_checklist.py +230 -0
  282. package/skills/core/reg-parser/scripts/dump_checklist.py +361 -0
  283. package/skills/core/reg-parser/scripts/preprocess-mandate.sh +187 -0
  284. package/skills/core/reg-parser/scripts/reg-parser.test.mjs +165 -0
  285. package/skills/core/reg-parser/scripts/test_quarantine.sh +105 -0
  286. package/skills/core/reg-parser/scripts/validate_checklist.py +563 -0
  287. package/skills/core/reg-parser/scripts/validate_mandate.py +273 -0
  288. package/skills/core/terminology/LICENSE +3 -0
  289. package/skills/core/terminology/SKILL.md +62 -0
  290. package/skills/core/terminology/references/format.md +50 -0
  291. package/skills/core/terminology/references/init.md +32 -0
  292. package/skills/core/terminology/release-check.mjs +93 -0
  293. package/skills/core/write-doc/LICENSE +3 -0
  294. package/skills/core/write-doc/SKILL.md +141 -0
  295. package/skills/core/write-doc/references/bilingual.md +60 -0
  296. package/skills/core/write-doc/release-check.mjs +93 -0
  297. package/skills/engineering/better-review/LICENSE +3 -0
  298. package/skills/engineering/better-review/SKILL.md +249 -0
  299. package/skills/engineering/better-review/agents/openai.yaml +9 -0
  300. package/skills/engineering/better-review/references/domain-hazards.md +53 -0
  301. package/skills/engineering/better-review/references/passes.md +147 -0
  302. package/skills/engineering/better-review/references/result.md +151 -0
  303. package/skills/engineering/better-review/release-check.mjs +93 -0
  304. package/skills/engineering/better-review/scripts/pr-context.mjs +212 -0
  305. package/skills/engineering/better-review/scripts/pr-context.test.mjs +168 -0
  306. package/skills/engineering/better-review/scripts/rereview-scope.mjs +503 -0
  307. package/skills/engineering/better-review/scripts/rereview-scope.test.mjs +587 -0
  308. package/skills/engineering/better-review/scripts/scan-diff.mjs +365 -0
  309. package/skills/engineering/better-review/scripts/scan-diff.test.mjs +414 -0
  310. package/skills/engineering/better-review/scripts/vendor-sync.test.mjs +96 -0
  311. package/skills/engineering/e2e-test/LICENSE +3 -0
  312. package/skills/engineering/e2e-test/SKILL.md +98 -0
  313. package/skills/engineering/e2e-test/assets/ci-gates.cloudbuild.yaml +24 -0
  314. package/skills/engineering/e2e-test/references/authoring/auth-flows.md +159 -0
  315. package/skills/engineering/e2e-test/references/authoring/playwright-config.md +73 -0
  316. package/skills/engineering/e2e-test/references/authoring/playwright-patterns.md +144 -0
  317. package/skills/engineering/e2e-test/references/ci-integration.md +25 -0
  318. package/skills/engineering/e2e-test/references/ci-playwright-container.md +290 -0
  319. package/skills/engineering/e2e-test/references/presentation-sweep.md +104 -0
  320. package/skills/engineering/e2e-test/references/reviewing.md +41 -0
  321. package/skills/engineering/e2e-test/references/route-manifest.md +51 -0
  322. package/skills/engineering/e2e-test/release-check.mjs +93 -0
  323. package/skills/engineering/e2e-test/scripts/detect-routes-nextjs.mjs +200 -0
  324. package/skills/engineering/e2e-test/scripts/presentation-checks.mjs +171 -0
  325. package/skills/engineering/e2e-test/scripts/presentation-checks.test.mjs +106 -0
  326. package/skills/engineering/e2e-test/scripts/presentation-perceivability.mjs +179 -0
  327. package/skills/engineering/e2e-test/scripts/presentation-perceivability.test.mjs +117 -0
  328. package/skills/engineering/e2e-test/scripts/presentation-reachability.mjs +154 -0
  329. package/skills/engineering/e2e-test/scripts/presentation-reachability.test.mjs +69 -0
  330. package/skills/engineering/e2e-test/scripts/presentation-render-health.mjs +141 -0
  331. package/skills/engineering/e2e-test/scripts/presentation-render-health.test.mjs +98 -0
  332. package/skills/engineering/e2e-test/scripts/presentation-sweep.mjs +147 -0
  333. package/skills/engineering/e2e-test/scripts/presentation-sweep.test.mjs +71 -0
  334. package/skills/engineering/e2e-test/scripts/presentation-temporal.mjs +127 -0
  335. package/skills/engineering/e2e-test/scripts/presentation-temporal.test.mjs +59 -0
  336. package/skills/engineering/e2e-test/scripts/project-route-manifest.mjs +82 -0
  337. package/skills/engineering/e2e-test/scripts/project-route-manifest.test.mjs +76 -0
  338. package/skills/engineering/e2e-test/scripts/validate-manifest.mjs +106 -0
  339. package/skills/engineering/engineering-runtime/LICENSE +3 -0
  340. package/skills/engineering/engineering-runtime/SKILL.md +11 -0
  341. package/skills/engineering/engineering-runtime/agents/openai.yaml +6 -0
  342. package/skills/engineering/engineering-runtime/coherence/workflow.json +597 -0
  343. package/skills/engineering/engineering-runtime/engineering-runtime.test.mjs +68 -0
  344. package/skills/engineering/engineering-runtime/release-check.mjs +93 -0
  345. package/skills/engineering/engineering-runtime/scripts/exact-head-artifact.mjs +131 -0
  346. package/skills/engineering/engineering-runtime/scripts/head-check-set.mjs +398 -0
  347. package/skills/engineering/engineering-runtime/scripts/invocation-policy.mjs +187 -0
  348. package/skills/engineering/engineering-runtime/scripts/invocation-policy.test.mjs +95 -0
  349. package/skills/engineering/engineering-runtime/scripts/main-module.mjs +79 -0
  350. package/skills/engineering/engineering-runtime/scripts/main-module.test.mjs +288 -0
  351. package/skills/engineering/engineering-runtime/scripts/mergify-yaml.mjs +11 -0
  352. package/skills/engineering/engineering-runtime/scripts/package-lock.json +43 -0
  353. package/skills/engineering/engineering-runtime/scripts/package.json +10 -0
  354. package/skills/engineering/engineering-runtime/scripts/required-check-plan.mjs +223 -0
  355. package/skills/engineering/engineering-runtime/scripts/required-check-plan.test.mjs +96 -0
  356. package/skills/engineering/engineering-runtime/scripts/review-completion.mjs +56 -0
  357. package/skills/engineering/engineering-runtime/scripts/workflow-coherence.mjs +595 -0
  358. package/skills/engineering/engineering-runtime/scripts/workflow-policy.mjs +189 -0
  359. package/skills/engineering/engineering-runtime/scripts/yaml-mapping.mjs +18 -0
  360. package/skills/engineering/ensure-coverage/LICENSE +3 -0
  361. package/skills/engineering/ensure-coverage/SKILL.md +129 -0
  362. package/skills/engineering/ensure-coverage/references/breadth/coverage-ledger.md +92 -0
  363. package/skills/engineering/ensure-coverage/references/breadth/inventory-contract.md +85 -0
  364. package/skills/engineering/ensure-coverage/references/breadth/surface-baseline.md +44 -0
  365. package/skills/engineering/ensure-coverage/references/breadth/surface-discovery.md +16 -0
  366. package/skills/engineering/ensure-coverage/references/depth/characterization.md +68 -0
  367. package/skills/engineering/ensure-coverage/references/depth/coverage.config.example.json +19 -0
  368. package/skills/engineering/ensure-coverage/references/depth/grading.md +35 -0
  369. package/skills/engineering/ensure-coverage/references/depth/mock-policy.md +57 -0
  370. package/skills/engineering/ensure-coverage/references/depth/test-smells.md +39 -0
  371. package/skills/engineering/ensure-coverage/references/enforcement/ci-contract.md +44 -0
  372. package/skills/engineering/ensure-coverage/references/examples/coverage-ledger.md +110 -0
  373. package/skills/engineering/ensure-coverage/references/examples/refund-flow.md +35 -0
  374. package/skills/engineering/ensure-coverage/references/presentation/axis.md +64 -0
  375. package/skills/engineering/ensure-coverage/references/process/audit-mode.md +27 -0
  376. package/skills/engineering/ensure-coverage/references/process/output-template.md +139 -0
  377. package/skills/engineering/ensure-coverage/references/process/test-strategy.md +56 -0
  378. package/skills/engineering/ensure-coverage/release-check.mjs +93 -0
  379. package/skills/engineering/ensure-coverage/schemas/coverage-config.schema.json +67 -0
  380. package/skills/engineering/ensure-coverage/schemas/coverage-file.schema.json +140 -0
  381. package/skills/engineering/ensure-coverage/scripts/README.md +99 -0
  382. package/skills/engineering/ensure-coverage/scripts/adapters/nextjs-inventory.mjs +182 -0
  383. package/skills/engineering/ensure-coverage/scripts/adapters/nextjs-inventory.test.mjs +96 -0
  384. package/skills/engineering/ensure-coverage/scripts/check-quarantine-expiry.mjs +105 -0
  385. package/skills/engineering/ensure-coverage/scripts/check-quarantine-expiry.test.mjs +47 -0
  386. package/skills/engineering/ensure-coverage/scripts/ci-audit.mjs +137 -0
  387. package/skills/engineering/ensure-coverage/scripts/ci-audit.test.mjs +86 -0
  388. package/skills/engineering/ensure-coverage/scripts/coverage-ledger.mjs +674 -0
  389. package/skills/engineering/ensure-coverage/scripts/coverage-ledger.test.mjs +447 -0
  390. package/skills/engineering/ensure-coverage/scripts/design-parity.mjs +591 -0
  391. package/skills/engineering/ensure-coverage/scripts/design-parity.test.mjs +552 -0
  392. package/skills/engineering/ensure-coverage/scripts/lint-tests.mjs +282 -0
  393. package/skills/engineering/ensure-coverage/scripts/lint-tests.test.mjs +289 -0
  394. package/skills/engineering/ensure-coverage/scripts/mock-policy-config.mjs +176 -0
  395. package/skills/engineering/ensure-coverage/scripts/mock-policy-config.test.mjs +119 -0
  396. package/skills/engineering/ensure-coverage/scripts/package.json +19 -0
  397. package/skills/engineering/golden-path/LICENSE +3 -0
  398. package/skills/engineering/golden-path/SKILL.md +230 -0
  399. package/skills/engineering/golden-path/agents/openai.yaml +3 -0
  400. package/skills/engineering/golden-path/assets/golden-paths.example.json +57 -0
  401. package/skills/engineering/golden-path/references/contract.md +239 -0
  402. package/skills/engineering/golden-path/references/migration.md +111 -0
  403. package/skills/engineering/golden-path/release-check.mjs +93 -0
  404. package/skills/engineering/golden-path/scripts/golden-path-core.mjs +1779 -0
  405. package/skills/engineering/golden-path/scripts/golden-path.mjs +6 -0
  406. package/skills/engineering/golden-path/scripts/golden-path.test.mjs +1457 -0
  407. package/skills/engineering/harness-runtime/LICENSE +3 -0
  408. package/skills/engineering/harness-runtime/SKILL.md +19 -0
  409. package/skills/engineering/harness-runtime/agents/openai.yaml +6 -0
  410. package/skills/engineering/harness-runtime/bin/discover-models.mjs +4 -0
  411. package/skills/engineering/harness-runtime/bin/model-catalog.mjs +4 -0
  412. package/skills/engineering/harness-runtime/contracts.md +15 -0
  413. package/skills/engineering/harness-runtime/discover-models.mjs +392 -0
  414. package/skills/engineering/harness-runtime/discover-models.test.mjs +363 -0
  415. package/skills/engineering/harness-runtime/fixtures/native-question-schemas.json +33 -0
  416. package/skills/engineering/harness-runtime/fixtures/question-responses.json +54 -0
  417. package/skills/engineering/harness-runtime/harness-runtime.test.mjs +967 -0
  418. package/skills/engineering/harness-runtime/index.mjs +767 -0
  419. package/skills/engineering/harness-runtime/model-catalog-seed.test.mjs +829 -0
  420. package/skills/engineering/harness-runtime/model-catalog.mjs +787 -0
  421. package/skills/engineering/harness-runtime/model-catalog.test.mjs +366 -0
  422. package/skills/engineering/harness-runtime/native-question-contracts.md +37 -0
  423. package/skills/engineering/harness-runtime/references/model-catalog-seed.json +408 -0
  424. package/skills/engineering/harness-runtime/references/model-catalog.md +57 -0
  425. package/skills/engineering/harness-runtime/release-check.mjs +93 -0
  426. package/skills/engineering/resolve-issues/LICENSE +3 -0
  427. package/skills/engineering/resolve-issues/SKILL.md +250 -0
  428. package/skills/engineering/resolve-issues/agents/openai.yaml +9 -0
  429. package/skills/engineering/resolve-issues/plugin-hooks.json +17 -0
  430. package/skills/engineering/resolve-issues/references/canary.md +28 -0
  431. package/skills/engineering/resolve-issues/references/ci.md +105 -0
  432. package/skills/engineering/resolve-issues/references/done.md +25 -0
  433. package/skills/engineering/resolve-issues/references/dropbox.md +90 -0
  434. package/skills/engineering/resolve-issues/references/expire.md +318 -0
  435. package/skills/engineering/resolve-issues/references/exploration.md +202 -0
  436. package/skills/engineering/resolve-issues/references/implementation.md +303 -0
  437. package/skills/engineering/resolve-issues/references/preflight.md +445 -0
  438. package/skills/engineering/resolve-issues/references/review.md +228 -0
  439. package/skills/engineering/resolve-issues/references/shared-modules.md +44 -0
  440. package/skills/engineering/resolve-issues/references/task-plan.md +264 -0
  441. package/skills/engineering/resolve-issues/release-check.mjs +93 -0
  442. package/skills/engineering/resolve-issues/scripts/cleanup-runs.mjs +364 -0
  443. package/skills/engineering/resolve-issues/scripts/cleanup-runs.test.mjs +280 -0
  444. package/skills/engineering/resolve-issues/scripts/discover-models.mjs +9 -0
  445. package/skills/engineering/resolve-issues/scripts/dropbox.mjs +473 -0
  446. package/skills/engineering/resolve-issues/scripts/dropbox.test.mjs +346 -0
  447. package/skills/engineering/resolve-issues/scripts/findings-reuse.mjs +98 -0
  448. package/skills/engineering/resolve-issues/scripts/findings-reuse.test.mjs +88 -0
  449. package/skills/engineering/resolve-issues/scripts/github-reviews.mjs +384 -0
  450. package/skills/engineering/resolve-issues/scripts/github-reviews.test.mjs +264 -0
  451. package/skills/engineering/resolve-issues/scripts/install-hooks.mjs +135 -0
  452. package/skills/engineering/resolve-issues/scripts/install-hooks.test.mjs +79 -0
  453. package/skills/engineering/resolve-issues/scripts/issue-tree.mjs +162 -0
  454. package/skills/engineering/resolve-issues/scripts/issue-tree.test.mjs +107 -0
  455. package/skills/engineering/resolve-issues/scripts/manual-invocation.test.mjs +14 -0
  456. package/skills/engineering/resolve-issues/scripts/model-catalog.mjs +9 -0
  457. package/skills/engineering/resolve-issues/scripts/next-actions-capacity.test.mjs +149 -0
  458. package/skills/engineering/resolve-issues/scripts/next-actions.mjs +856 -0
  459. package/skills/engineering/resolve-issues/scripts/next-actions.test.mjs +915 -0
  460. package/skills/engineering/resolve-issues/scripts/plan-sync.mjs +269 -0
  461. package/skills/engineering/resolve-issues/scripts/plan-sync.test.mjs +156 -0
  462. package/skills/engineering/resolve-issues/scripts/preflight-models.mjs +736 -0
  463. package/skills/engineering/resolve-issues/scripts/preflight-models.test.mjs +448 -0
  464. package/skills/engineering/resolve-issues/scripts/ready-check.mjs +185 -0
  465. package/skills/engineering/resolve-issues/scripts/ready-check.test.mjs +217 -0
  466. package/skills/engineering/resolve-issues/scripts/rehydrate.mjs +98 -0
  467. package/skills/engineering/resolve-issues/scripts/rehydrate.test.mjs +91 -0
  468. package/skills/engineering/resolve-issues/scripts/review-verdict.mjs +509 -0
  469. package/skills/engineering/resolve-issues/scripts/review-verdict.test.mjs +1060 -0
  470. package/skills/engineering/resolve-issues/scripts/size-check.mjs +492 -0
  471. package/skills/engineering/resolve-issues/scripts/size-check.test.mjs +458 -0
  472. package/skills/engineering/resolve-release/LICENSE +3 -0
  473. package/skills/engineering/resolve-release/SKILL.md +215 -0
  474. package/skills/engineering/resolve-release/agents/openai.yaml +8 -0
  475. package/skills/engineering/resolve-release/flows/cloud-run-canary.md +13 -0
  476. package/skills/engineering/resolve-release/flows/cloud-run.md +7 -0
  477. package/skills/engineering/resolve-release/flows/root-tag-npm.md +13 -0
  478. package/skills/engineering/resolve-release/flows/workspace-npm.md +22 -0
  479. package/skills/engineering/resolve-release/references/canary.md +51 -0
  480. package/skills/engineering/resolve-release/references/candidate.md +41 -0
  481. package/skills/engineering/resolve-release/references/cut.md +131 -0
  482. package/skills/engineering/resolve-release/references/dark-launch.md +66 -0
  483. package/skills/engineering/resolve-release/references/flows.md +150 -0
  484. package/skills/engineering/resolve-release/references/preflight.md +154 -0
  485. package/skills/engineering/resolve-release/references/prepared-metadata.md +260 -0
  486. package/skills/engineering/resolve-release/references/promotion.md +82 -0
  487. package/skills/engineering/resolve-release/references/publish.md +232 -0
  488. package/skills/engineering/resolve-release/references/workspace-npm.md +103 -0
  489. package/skills/engineering/resolve-release/release-check.mjs +93 -0
  490. package/skills/engineering/resolve-release/scripts/apply.mjs +212 -0
  491. package/skills/engineering/resolve-release/scripts/apply.test.mjs +99 -0
  492. package/skills/engineering/resolve-release/scripts/dark-flags.mjs +134 -0
  493. package/skills/engineering/resolve-release/scripts/dark-flags.test.mjs +100 -0
  494. package/skills/engineering/resolve-release/scripts/flow.mjs +500 -0
  495. package/skills/engineering/resolve-release/scripts/flow.test.mjs +340 -0
  496. package/skills/engineering/resolve-release/scripts/green-head.mjs +231 -0
  497. package/skills/engineering/resolve-release/scripts/green-head.test.mjs +101 -0
  498. package/skills/engineering/resolve-release/scripts/npm-version-absence.mjs +138 -0
  499. package/skills/engineering/resolve-release/scripts/npm-version-absence.test.mjs +426 -0
  500. package/skills/engineering/resolve-release/scripts/plan-npm.test.mjs +659 -0
  501. package/skills/engineering/resolve-release/scripts/plan-toml-boundary.test.mjs +317 -0
  502. package/skills/engineering/resolve-release/scripts/plan-uv.test.mjs +291 -0
  503. package/skills/engineering/resolve-release/scripts/plan.mjs +806 -0
  504. package/skills/engineering/resolve-release/scripts/plan.test.mjs +428 -0
  505. package/skills/engineering/rush-issues/LICENSE +3 -0
  506. package/skills/engineering/rush-issues/SKILL.md +58 -0
  507. package/skills/engineering/rush-issues/agents/openai.yaml +8 -0
  508. package/skills/engineering/rush-issues/rehydrate.mjs +10 -0
  509. package/skills/engineering/rush-issues/release-check.mjs +93 -0
  510. package/skills/engineering/rush-release/LICENSE +3 -0
  511. package/skills/engineering/rush-release/SKILL.md +35 -0
  512. package/skills/engineering/rush-release/agents/openai.yaml +8 -0
  513. package/skills/engineering/rush-release/release-check.mjs +93 -0
  514. package/skills/engineering/test-quality/LICENSE +3 -0
  515. package/skills/engineering/test-quality/SKILL.md +79 -0
  516. package/skills/engineering/test-quality/references/audit.md +80 -0
  517. package/skills/engineering/test-quality/references/lint.md +24 -0
  518. package/skills/engineering/test-quality/references/principles.md +143 -0
  519. package/skills/engineering/test-quality/references/testing-conventions.md +9 -0
  520. package/skills/engineering/test-quality/release-check.mjs +93 -0
  521. package/skills/engineering/test-quality/scripts/lint-tests.mjs +574 -0
  522. package/skills/engineering/test-quality/scripts/lint-tests.test.mjs +591 -0
  523. package/skills/engineering/test-quality/scripts/mock-policy-config.mjs +176 -0
  524. package/skills/engineering/test-quality/scripts/mock-policy-config.test.mjs +119 -0
  525. package/skills/engineering/test-quality/scripts/persist-conventions-core.mjs +117 -0
  526. package/skills/engineering/test-quality/scripts/persist-conventions.mjs +17 -0
  527. package/skills/engineering/test-quality/scripts/persist-conventions.test.mjs +104 -0
  528. package/skills/risk-compliance/compliance-audit/LICENSE +3 -0
  529. package/skills/risk-compliance/compliance-audit/SKILL.md +439 -0
  530. package/skills/risk-compliance/compliance-audit/references/findings-schema.md +293 -0
  531. package/skills/risk-compliance/compliance-audit/references/normalization-rules.md +45 -0
  532. package/skills/risk-compliance/compliance-audit/references/vars-checklist.md +1068 -0
  533. package/skills/risk-compliance/compliance-audit/references/vars-findings-schema.md +398 -0
  534. package/skills/risk-compliance/compliance-audit/release-check.mjs +93 -0
  535. package/skills/risk-compliance/compliance-audit/scripts/compliance-audit.test.mjs +14 -0
  536. package/skills/risk-compliance/compliance-audit/scripts/export_tracker_xlsx.py +221 -0
  537. package/skills/risk-compliance/compliance-audit/scripts/reconcile_tracker.py +458 -0
  538. package/skills/risk-compliance/compliance-audit/scripts/test_export_tracker_xlsx.py +97 -0
  539. package/skills/risk-compliance/compliance-audit/scripts/test_validate_tracker.py +157 -0
  540. package/skills/risk-compliance/compliance-audit/scripts/validate_tracker.py +829 -0
  541. package/skills/risk-compliance/contract-compare/LICENSE +3 -0
  542. package/skills/risk-compliance/contract-compare/SKILL.md +199 -0
  543. package/skills/risk-compliance/contract-compare/references/comparison-dimensions.md +209 -0
  544. package/skills/risk-compliance/contract-compare/release-check.mjs +93 -0
  545. package/skills/risk-compliance/contract-review/LICENSE +3 -0
  546. package/skills/risk-compliance/contract-review/SKILL.md +240 -0
  547. package/skills/risk-compliance/contract-review/references/review-criteria.md +223 -0
  548. package/skills/risk-compliance/contract-review/release-check.mjs +93 -0
  549. package/skills/risk-compliance/doc-authenticity/LICENSE +3 -0
  550. package/skills/risk-compliance/doc-authenticity/SKILL.md +160 -0
  551. package/skills/risk-compliance/doc-authenticity/agents/openai.yaml +8 -0
  552. package/skills/risk-compliance/doc-authenticity/manual-invocation.test.mjs +12 -0
  553. package/skills/risk-compliance/doc-authenticity/references/agreement.md +66 -0
  554. package/skills/risk-compliance/doc-authenticity/references/bank-statement.md +150 -0
  555. package/skills/risk-compliance/doc-authenticity/references/forensic-signals.md +157 -0
  556. package/skills/risk-compliance/doc-authenticity/references/image-signals.md +114 -0
  557. package/skills/risk-compliance/doc-authenticity/references/invoice.md +66 -0
  558. package/skills/risk-compliance/doc-authenticity/references/issuer-profiles.md +86 -0
  559. package/skills/risk-compliance/doc-authenticity/references/verdict-and-report.md +95 -0
  560. package/skills/risk-compliance/doc-authenticity/references/verdict.schema.json +81 -0
  561. package/skills/risk-compliance/doc-authenticity/release-check.mjs +93 -0
  562. package/skills/risk-compliance/doc-authenticity/scripts/image_forensics.py +294 -0
  563. package/skills/risk-compliance/doc-authenticity/scripts/pdf_forensics.py +401 -0
  564. package/skills/risk-compliance/doc-authenticity/scripts/validate_codes.py +224 -0
  565. package/skills/risk-compliance/doc-authenticity/scripts/validate_verdict.py +308 -0
  566. package/skills/risk-compliance/doc-authenticity/scripts/validate_verdict.test.mjs +212 -0
  567. package/skills/risk-compliance/fraud-analysis/LICENSE +3 -0
  568. package/skills/risk-compliance/fraud-analysis/SKILL.md +114 -0
  569. package/skills/risk-compliance/fraud-analysis/references/archetypes/authorized-payment-scam.md +41 -0
  570. package/skills/risk-compliance/fraud-analysis/references/archetypes/first-party-fraud.md +44 -0
  571. package/skills/risk-compliance/fraud-analysis/references/archetypes/third-party-fraud.md +27 -0
  572. package/skills/risk-compliance/fraud-analysis/references/contexts/bank-transfer.md +24 -0
  573. package/skills/risk-compliance/fraud-analysis/references/contexts/card-payment.md +30 -0
  574. package/skills/risk-compliance/fraud-analysis/references/contexts/payment-collection.md +20 -0
  575. package/skills/risk-compliance/fraud-analysis/references/contexts/payout.md +20 -0
  576. package/skills/risk-compliance/fraud-analysis/references/feature-engineering.md +158 -0
  577. package/skills/risk-compliance/fraud-analysis/references/mechanisms/account-takeover.md +36 -0
  578. package/skills/risk-compliance/fraud-analysis/references/report-rationale.md +45 -0
  579. package/skills/risk-compliance/fraud-analysis/references/report-template.md +190 -0
  580. package/skills/risk-compliance/fraud-analysis/references/review-checklist.md +175 -0
  581. package/skills/risk-compliance/fraud-analysis/references/taxonomy.md +79 -0
  582. package/skills/risk-compliance/fraud-analysis/references/terminology.md +108 -0
  583. package/skills/risk-compliance/fraud-analysis/references/workflow.md +175 -0
  584. package/skills/risk-compliance/fraud-analysis/release-check.mjs +93 -0
  585. package/skills/risk-compliance/payment-analysis/LICENSE +3 -0
  586. package/skills/risk-compliance/payment-analysis/SKILL.md +180 -0
  587. package/skills/risk-compliance/payment-analysis/references/auth-rate-actions.md +30 -0
  588. package/skills/risk-compliance/payment-analysis/references/chargebacks.md +208 -0
  589. package/skills/risk-compliance/payment-analysis/references/chinese-polish.md +51 -0
  590. package/skills/risk-compliance/payment-analysis/references/event-layers.md +127 -0
  591. package/skills/risk-compliance/payment-analysis/references/fx.md +59 -0
  592. package/skills/risk-compliance/payment-analysis/references/journey.md +79 -0
  593. package/skills/risk-compliance/payment-analysis/references/metrics.md +67 -0
  594. package/skills/risk-compliance/payment-analysis/references/report-template.md +119 -0
  595. package/skills/risk-compliance/payment-analysis/references/terminology.md +95 -0
  596. package/skills/risk-compliance/payment-analysis/references/visualization.md +56 -0
  597. package/skills/risk-compliance/payment-analysis/release-check.mjs +93 -0
  598. package/skills/risk-compliance/report-writing/LICENSE +3 -0
  599. package/skills/risk-compliance/report-writing/SKILL.md +220 -0
  600. package/skills/risk-compliance/report-writing/references/audit-report-template.md +121 -0
  601. package/skills/risk-compliance/report-writing/references/external-assessment-template.md +167 -0
  602. package/skills/risk-compliance/report-writing/references/management-report-template.md +145 -0
  603. package/skills/risk-compliance/report-writing/references/vars-report-template.md +224 -0
  604. package/skills/risk-compliance/report-writing/release-check.mjs +93 -0
  605. package/skills/risk-compliance/similar-domain/LICENSE +3 -0
  606. package/skills/risk-compliance/similar-domain/SKILL.md +203 -0
  607. package/skills/risk-compliance/similar-domain/references/entities.md +67 -0
  608. package/skills/risk-compliance/similar-domain/references/fingerprints.md +134 -0
  609. package/skills/risk-compliance/similar-domain/references/pivots.md +82 -0
  610. package/skills/risk-compliance/similar-domain/references/report-template.md +93 -0
  611. package/skills/risk-compliance/similar-domain/references/scoring.md +130 -0
  612. package/skills/risk-compliance/similar-domain/references/terminology.md +41 -0
  613. package/skills/risk-compliance/similar-domain/references/workflow.md +85 -0
  614. package/skills/risk-compliance/similar-domain/release-check.mjs +93 -0
  615. package/skills/risk-compliance/tld-detection/LICENSE +3 -0
  616. package/skills/risk-compliance/tld-detection/SKILL.md +245 -0
  617. package/skills/risk-compliance/tld-detection/agents/openai.yaml +9 -0
  618. package/skills/risk-compliance/tld-detection/references/chinese-polish.md +55 -0
  619. package/skills/risk-compliance/tld-detection/references/clean.md +51 -0
  620. package/skills/risk-compliance/tld-detection/references/clustering.md +235 -0
  621. package/skills/risk-compliance/tld-detection/references/decision.md +189 -0
  622. package/skills/risk-compliance/tld-detection/references/fx-conversion.md +232 -0
  623. package/skills/risk-compliance/tld-detection/references/report-template.md +272 -0
  624. package/skills/risk-compliance/tld-detection/references/streams.md +141 -0
  625. package/skills/risk-compliance/tld-detection/references/terminology.md +95 -0
  626. package/skills/risk-compliance/tld-detection/references/workflow.md +95 -0
  627. package/skills/risk-compliance/tld-detection/release-check.mjs +93 -0
  628. package/skills/risk-compliance/tld-detection/scripts/detect_ladders.py +390 -0
  629. package/skills/risk-compliance/tld-detection/scripts/detect_ladders.test.mjs +14 -0
  630. package/skills/risk-compliance/tld-detection/scripts/detect_streams.py +650 -0
  631. package/skills/risk-compliance/tld-detection/scripts/detect_streams.test.mjs +14 -0
  632. package/skills/risk-compliance/tld-detection/tests/test_detect_ladders.py +134 -0
  633. package/skills/risk-compliance/tld-detection/tests/test_detect_streams.py +520 -0
@@ -0,0 +1,439 @@
1
+ ---
2
+ name: compliance-audit
3
+ version: 2.9.0
4
+ description: "Audit operations against financial-compliance checklists (AML/KYC, VARS, PCI-DSS, TPA oversight, onboarding, transaction monitoring). Produces tracker.md (with a tracker.xlsx export) and phase-trail.md with layered validation; cites evidence by original filename. Input: reg-parser or the built-in VARS checklist."
5
+ release-version: 0.36.0
6
+ ---
7
+ **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
8
+ # Compliance Audit
9
+ Guide an auditor/analyst through examining operations, processes, and controls
10
+ against a compliance checklist. Produce an assessment tracker — a worksheet
11
+ keyed by control item that the client can update through remediation —
12
+ alongside a phase trail companion file (work product) that preserves what each
13
+ phase saw before the tracker was finalised.
14
+
15
+ ## Audience
16
+
17
+ The user is a **compliance auditor or analyst** working in regulated financial
18
+ services — payments, banking, fintech, insurance. They audit against financial
19
+ regulatory frameworks: AML regulations, KYC requirements, financial reporting
20
+ standards, local financial authority rules, and card-scheme standards such as
21
+ VARS.
22
+
23
+ ## Audit Workflow
24
+
25
+ The pipeline is eleven steps in three phases:
26
+
27
+ | Phase | Steps | Purpose |
28
+ |---|---|---|
29
+ | **Setup** | 0–4 | Preprocess evidence, load checklist, scope, plan phases, map evidence to controls |
30
+ | **Review** | 5–7 | Run review phases (document / onsite / sample), synthesize tracker rows |
31
+ | **Sign-off** | 8–10 | Produce deliverables; run layered validation (deterministic + LLM judge + adversarial challenger); normalize formatting before reviewer sign-off |
32
+
33
+ For large audits the **chunked** path (Step 6 onward) parallelises across control groups via subagents; the unchunked path (Step 5) is sequential. Pick based on size — VARS (45 controls) and similar always benefit from chunking.
34
+
35
+ ### Step 0: Preprocess Evidence Documents (if needed)
36
+
37
+ If evidence files are in binary formats (PDF, DOCX, PPTX, XLSX, images), spawn a subagent to convert them to markdown before the audit begins.
38
+
39
+ - **Model:** **Small / fast tier.** This is mechanical doc conversion. Capability above the small tier is wasted here.
40
+ - **Task prompt:**
41
+
42
+ ```text
43
+ Convert all documents in <evidence-dir>/ to markdown using the doc-to-md skill.
44
+ Run: python3 {doc-to-md baseDir}/scripts/convert.py <evidence-dir>/ <evidence-md-dir>/
45
+ Report which files succeeded and which failed (if any).
46
+ ```
47
+
48
+ Wait for the subagent to complete before proceeding. Skip this step if evidence is already in text/markdown format.
49
+
50
+ **Cite the original document, not the parsed copy.** The markdown is a working copy for reading; the client and reviewer know the file they supplied. Every document reference in the evidence map, phase trail, tracker, judge and challenger output, and logs uses the original filename with its extension:
51
+
52
+ - Right: `Covered in merchant-agreement-v2.4.pdf section 3.2`
53
+ - Wrong: `Covered in merchant-agreement-v2.4.md section 3.2`, or `Covered in Merchant Agreement section 3.2`
54
+
55
+ doc-to-md keeps the stem (`merchant-agreement-v2.4.pdf` → `merchant-agreement-v2.4.md`), so the validator resolves an original filename to its parsed copy. If two originals share a stem (`policy.pdf` and `policy.docx`), convert each into a subfolder named after its extension (`pdf/policy.md`, `docx/policy.md`) and cite each by its full original name; otherwise the validator reports the citation as ambiguous. Evidence supplied as markdown is its own original.
56
+
57
+ ### Step 1: Load the Checklist
58
+
59
+ 1. Read the compliance checklist file provided by the user.
60
+ 2. Parse control IDs, control titles, archetypes / categories, severity, requirement text, and control criteria.
61
+ 3. Confirm the checklist loaded correctly — list the control groups and total controls in scope. No checklist provided: ask for its path.
62
+
63
+ ### Step 2: Scope the Audit
64
+
65
+ Determine scope with the user:
66
+
67
+ - **Full audit** — all controls in the checklist.
68
+ - **Targeted audit** — specific archetypes, categories, or control IDs only.
69
+
70
+ Confirm scope before proceeding. Record scope in the tracker metadata header.
71
+
72
+ ### Step 3: Establish the Phase Plan
73
+
74
+ The audit runs through up to three review phases on the same control set, plus a synthesis step that produces the tracker:
75
+
76
+ 1. `document_review` (phase)
77
+ 2. `onsite_review` (phase)
78
+ 3. `sample_test` (phase)
79
+ 4. tracker synthesis (Step 7) — consolidates whichever phases ran into `tracker.md`
80
+
81
+ Phases are **optional and additive** — many engagements stop after `document_review` (a gap analysis) or skip `onsite_review` for remote audits. Confirm with the user which phases are in scope and record the chosen subset under `Audit Phases Completed` in the tracker header. The tracker rating is always produced as the synthesis of whichever phases ran.
82
+
83
+ Rules:
84
+
85
+ - Each phase updates the same `Control ID` records in `phase-trail.md` rather than creating disconnected findings.
86
+ - The tracker (`tracker.md`, exported to `tracker.xlsx`) is the consolidated deliverable after the completed phases.
87
+ - `Control Effectiveness Rating` (VARS) or `Effectiveness` (generic) is required because it drives the tracker rating.
88
+ - `Recommended Action Ref` is optional. If a co-located best-practice repository keyed by `Control ID` exists, point to it (e.g. `best-practice://AACQ.C14.1`); otherwise inline a one-line remediation pointer or omit. Do not invent links to repositories that do not exist.
89
+
90
+ ### Step 4: Evidence Mapping
91
+
92
+ Map evidence to controls or logical control groups before reviewing, by original filename:
93
+
94
+ ```text
95
+ AACQ.C1.1 risk-appetite-policy.pdf, board-minutes-2026-03.docx
96
+ AACQ.C5.1 underwriting-policy.pdf, onboarding-procedure.docx
97
+ ATPA.C8.1 monitoring-rules.xlsx, alert-log-sample.csv
98
+ ```
99
+
100
+ Only the mapped evidence for a control or control group should be passed into that review pass.
101
+
102
+ ### Step 5: Run the Audit Phase
103
+
104
+ For each phase in scope, review the controls and record phase-specific observations into `phase-trail.md` using the appropriate schema:
105
+
106
+ - **VARS audits:** `references/vars-findings-schema.md` (Visa-canonical tracker + per-mandatory-item granularity).
107
+ - **All other audits:** `references/findings-schema.md` (generic per-Control-ID tracker).
108
+
109
+ `phase-trail.md` is the audit work product across all phases. The tracker (`tracker.md`) is produced from it in Step 7.
110
+
111
+ Step 5 is the **non-chunked** path; for large audits skip to Step 6. Each phase below appends a phase block per `Control ID` to `phase-trail.md` using Variant A in the chosen schema.
112
+
113
+ #### Phase 5A: Document Review
114
+
115
+ Input: policy documents, procedures, agreements, governance materials, system descriptions.
116
+
117
+ Record `document_review` observations per `Control ID`.
118
+
119
+ #### Phase 5B: Onsite Review
120
+
121
+ Input: interview records, walkthrough notes, live demonstrations, operating context.
122
+
123
+ Record `onsite_review` observations per `Control ID` and note whether onsite work confirms, weakens, or strengthens document-review conclusions.
124
+
125
+ #### Phase 5C: Sample Test
126
+
127
+ Input: sample evidence such as merchant files, alerts, case logs, transactions, approvals, reports, screenshots.
128
+
129
+ Record `sample_test` observations per `Control ID` and capture concrete evidence of operating effectiveness.
130
+
131
+ ### Step 6: Chunked Workflow for Large Audits
132
+
133
+ When the checklist or evidence is large, the **main agent orchestrates** and **spawns one subagent per control group / category** for each phase. Phase outputs are kept in per-group files and consumed directly by Step 7 — there is no merge step in between.
134
+
135
+ #### Step A: Prepare a bounded prompt
136
+
137
+ Before spawning, group controls into logical chunks and attach only the relevant evidence. Extract only the rows for the chunk's `Control ID`s from the checklist — never paste the full checklist into a subagent prompt. The full checklist can be hundreds of KB and bloats every subagent's context.
138
+
139
+ ```text
140
+ Group 1: AACQ Risk Appetite and Written Agreements
141
+ Controls: AACQ.C1.1, AACQ.C2.1, AACQ.C3.1, AACQ.C4.1
142
+ Evidence: risk-appetite-policy.pdf, merchant-agreement-template.docx
143
+ ```
144
+
145
+ #### Step B: Spawn subagents per chunk
146
+
147
+ - **Model:** **Mid tier.** Per-phase review needs careful reasoning across a control's evidence; a small model will miss subtle gaps.
148
+ - **Output schema:** Pick the same schema chosen in Step 5 — generic (`findings-schema.md`) or VARS (`vars-findings-schema.md`). Each schema file owns two subagent prompt templates: **Variant A** for per-phase chunking (this step) and **Variant B** for synthesis chunking (Step 7). Use Variant A here. Do not improvise a third format.
149
+ - **Task prompt skeleton** (fill the bracketed slots from Variant A in the schema):
150
+
151
+ ```text
152
+ You are a compliance auditor. Review the following controls for the specified audit phase.
153
+
154
+ Audit phase: <document_review | onsite_review | sample_test>
155
+ Controls:
156
+ <paste only the checklist rows for these Control IDs>
157
+
158
+ Evidence:
159
+ <paste mapped evidence only, each excerpt headed by its original filename>
160
+
161
+ Output format:
162
+ <paste the Variant A block from the chosen schema's "Subagent Prompt Template" section>
163
+
164
+ Rules:
165
+ - Never mark a control effective without direct evidence.
166
+ - If evidence is absent or ambiguous, mark the gap and explain why.
167
+ - Cite each document by its original filename (e.g. merchant-agreement-v2.4.pdf), never the parsed .md.
168
+ - Keep observations specific to this phase.
169
+ - Output observations only.
170
+ ```
171
+
172
+ - **Output:** Each subagent writes phase observations to `phase-<phase>-<group>.md`.
173
+ - **Parallelism:** Spawn all independent chunks concurrently. No merge step is required at this point — Step 7 consumes the per-group phase files directly.
174
+
175
+ ### Step 7: Synthesize Tracker (chunked)
176
+
177
+ Synthesis is **chunked the same way as Step 6**. The full per-control tracker plus phase trail can blow main-agent context on a 45-control VARS audit; spawn one synthesis subagent per control group.
178
+
179
+ Use the **same group definitions** as Step 6 so each synthesis subagent reads its group's `phase-<phase>-<group>.md` files and emits both:
180
+
181
+ 1. tracker rows (deliverable)
182
+ 2. merged phase-trail blocks (audit work product)
183
+
184
+ …for that group only.
185
+
186
+ #### Step A: Spawn synthesis subagents per group
187
+
188
+ - **Model:** **Mid tier.** Synthesis consolidates multiple phases per Control ID and applies the rubric; needs balanced reasoning. Don't use a small model here.
189
+ - **Output schema:** Variant B in the chosen schema file (`vars-findings-schema.md` or `findings-schema.md`).
190
+ - **Task prompt skeleton** (fill the bracketed slots from Variant B):
191
+
192
+ ```text
193
+ You are a compliance auditor consolidating an assessment.
194
+
195
+ Controls in scope (this group):
196
+ <paste only the checklist rows for these Control IDs>
197
+
198
+ Phase trail blocks (all completed phases for these Control IDs):
199
+ <paste contents of phase-<phase>-<group>.md for every phase that ran>
200
+
201
+ Output format:
202
+ <paste the "Subagent Prompt Template — Variant B" block from the chosen schema file>
203
+
204
+ Cite each document by its original filename (e.g. merchant-agreement-v2.4.pdf) on every bullet.
205
+ ```
206
+
207
+ - **Output:** Each subagent writes `synth-<group>.md` containing tracker rows, then a `---` separator, then merged phase-trail blocks.
208
+ - **Parallelism:** Spawn all groups concurrently.
209
+
210
+ #### Step B: Assemble final files
211
+
212
+ Once synthesis subagents complete, the main agent:
213
+
214
+ 1. Reads each `synth-<group>.md`.
215
+ 2. Splits each file on the `---` separator into tracker-rows half and phase-trail half.
216
+ 3. Concatenates all tracker-rows halves under the audit-metadata header and the table header into `tracker.md`.
217
+ 4. Concatenates all phase-trail halves under the `# Phase Trail` (or `# VARS Phase Trail`) heading into `phase-trail.md`.
218
+ 5. Verifies every Control ID in scope appears in both files.
219
+
220
+ The main agent does **not** rewrite or re-rate findings during assembly — that work happened in the subagents. Assembly is concatenation + sanity check only.
221
+
222
+ ### Step 8: Deliverables
223
+
224
+ Three files:
225
+
226
+ - `tracker.md` — the deliverable and the source of truth. One row per Control ID under a metadata header. For VARS, per-mandatory-item detail (`Control 1a:`, `Control 1b:`, …) appears as bulleted entries inside the Observations cell. No executive summary, no roll-up counts, no critical-gaps section.
227
+ - `tracker.xlsx` — always delivered: the same tracker as an Excel workbook for the client to filter and update through remediation. Generated from `tracker.md` by `scripts/export_tracker_xlsx.py` (Step 10); never edited by hand.
228
+ - `phase-trail.md` — the audit work product. Per-Control-ID phase-by-phase record. Preserves observations from `document_review`, `onsite_review`, `sample_test` as they were captured.
229
+
230
+ Treat the checklist as the control library and the schema as the tracker format. If the client wants a roll-up or executive summary, generate it from the tracker on demand — do not write one into the deliverable.
231
+
232
+ ### Step 9: Validate the Tracker
233
+
234
+ Before sign-off, run a layered validation pass to catch hallucination, schema drift, and over-claimed coverage. The four sub-steps are cheap-to-expensive; run **9A and 9B always**, run **9C and 9D for high-stakes deliverables** (e.g. VARS findings sent to a regulator).
235
+
236
+ #### Step 9A: Structural validation (deterministic)
237
+
238
+ Steps 9A, 9B, 9E and 10 are built for the VARS tracker format; for a generic tracker, check row coverage and citations by hand. Run `scripts/validate_tracker.py` against the produced tracker:
239
+
240
+ ```bash
241
+ python3 {compliance-audit baseDir}/scripts/validate_tracker.py tracker.md \
242
+ --checklist {compliance-audit baseDir}/references/vars-checklist.md
243
+ ```
244
+
245
+ Checks performed:
246
+
247
+ - `row_coverage` — every scoped Control ID has exactly one tracker row.
248
+ - `item_coverage` — every numbered checklist item appears as a `Control N:` bullet in Observations.
249
+ - `rating_value` — `Control Effectiveness Rating` is one of the four canonical outcomes: `Satisfactory` / `Improvement Recommended` / `Unsatisfactory` / `N/A`.
250
+ - `rubric_consistency` — the rating obeys the VARS rubric (any mandatory item `Partial` or `Not addressed` ⇒ Unsatisfactory; all mandatory met but a recommended item missing/partial ⇒ Improvement Recommended; all covered ⇒ Satisfactory; `N/A` rows are exempt). Coverage rolls up: a leaf with no bullet inherits its nearest bulleted ancestor's status.
251
+ - `gap_xref` — every `(Control N)` / `[Control N: …]` referenced in Issue Description corresponds to a `Not addressed` or `Partial` Observation bullet (a Recommendations entry may also point to a `Covered` mandatory item flagged for strengthening).
252
+ - `clause_marker` — warns when a cell uses `§`; the tracker writes `section`.
253
+
254
+ Exit 0 = no errors. Errors are blocking; warnings are surfaced for reviewer judgement. Use `--strict` to fail on warnings too.
255
+
256
+ #### Step 9B: Citation grounding (deterministic, requires evidence dir)
257
+
258
+ Add `--evidence` to the same script:
259
+
260
+ ```bash
261
+ python3 {compliance-audit baseDir}/scripts/validate_tracker.py tracker.md \
262
+ --checklist {compliance-audit baseDir}/references/vars-checklist.md \
263
+ --evidence ./evidence-md/
264
+ ```
265
+
266
+ For every `Covered in <doc> section <clause>` citation, the script verifies the doc resolves to an evidence markdown file and the cited clause string actually appears in that file. `<doc>` is the original filename; it resolves to the parsed markdown with the same stem, and warnings name the original filename. Phantom citations (clause does not exist) are flagged as warnings.
267
+
268
+ #### Step 9C: Citation judge (subagent — clean context)
269
+
270
+ Spawn one subagent **per control group** (same chunking as Steps 6–7) using **Variant C** in the schema's "Subagent Prompt Template" section. The subagent receives **only**:
271
+
272
+ - the checklist rows for its group (with full Verification text),
273
+ - the tracker rows for its group (Observations + Issue Description),
274
+ - the cited evidence excerpts.
275
+
276
+ It does **not** see the phase trail, other groups' findings, or synthesis context: the judge verifies each citation cold.
277
+
278
+ - **Model:** **Small / fast tier.** Citation verification is local clause-vs-requirement comparison; a small model handles it well at a fraction of the cost.
279
+ - **Output:** `judge-<group>.md` and `judge-<group>.json` (Step 9E reads the JSON) with per-bullet verdicts (`Confirmed` / `Weak` / `Off-target` / `Missing`).
280
+ - **Parallelism:** Spawn all groups concurrently.
281
+
282
+ The main agent collates non-`Confirmed` verdicts into a Citation Judge Report attached to the tracker for reviewer attention.
283
+
284
+ #### Step 9D: Adversarial challenger (subagent — clean context, adversarial system prompt)
285
+
286
+ Spawn one subagent **per control group** using **Variant D** in the schema. The subagent runs with an **explicit adversarial system prompt**: assume the prior auditor was too generous and look for downgrades.
287
+
288
+ Critical: this subagent must run with **clean context** — no access to the phase trail, judge findings, or synthesis reasoning. It must form its own challenge from the checklist + tracker + evidence only. Otherwise it will rationalise rather than challenge.
289
+
290
+ - **Model:** **Mid tier** for routine audits; **large / top-tier** for regulator-facing deliverables where a missed challenge is costly. The challenger has to form a credible adversarial read and articulate concrete downgrades — a too-small model will rubber-stamp.
291
+ - **System prompt:** Variant D in the schema. The system prompt itself frames the adversarial stance — do not soften it in the wrapper.
292
+ - **Output:** `challenge-<group>.md` listing concrete recommended downgrades per coverage claim, with requirement reference and specific weakness.
293
+ - **Parallelism:** Spawn all groups concurrently.
294
+
295
+ The main agent collates challenges into a Challenge Report. The reviewer reads it and decides per-challenge whether to accept the downgrade before finalising the tracker.
296
+
297
+ #### Step 9E: Reconcile validated findings into the tracker
298
+
299
+ Steps 9A–9D produce side files. Step 9E **applies the deterministic ones to `tracker.md`** so hallucinated coverage doesn't survive into the deliverable. The split is deliberate: auto-apply only what's mechanically verifiable; surface the rest for the reviewer.
300
+
301
+ | Source | Treatment |
302
+ |---|---|
303
+ | 9B citation_grounding "missing clause" warnings | **Auto-apply.** The cited `section X` exact-string isn't in the evidence file, so the citation is hallucinated. Bullet flips `Covered`/`Partial` → `Not addressed — cited clause section X not found in DOC`. |
304
+ | 9B "no evidence file matches" warnings | **Auto-apply.** Bullet flips → `Not addressed — cited document not found`. Ambiguous-document and missing-extension warnings are reviewer-mediated. |
305
+ | 9C judge verdict `Off-target` | **Auto-apply.** Judge confirmed the cited clause doesn't address the requirement. Bullet flips → `Not addressed — judge: <reason>`. |
306
+ | 9C judge verdict `Missing` | **Auto-apply.** Judge couldn't locate the cited clause. Bullet flips → `Not addressed — judge: <reason>`. |
307
+ | 9C judge verdict `Weak` | **Reviewer-mediated.** Judge says clause references the topic but doesn't operationalise it. Surfaced in `reconciliation.md` for human decision; tracker untouched. |
308
+ | 9D challenger recommendations | **Reviewer-mediated.** These are explicit value judgements, not facts. Surfaced in `reconciliation.md`. |
309
+
310
+ Run the reconciler:
311
+
312
+ ```bash
313
+ python3 {compliance-audit baseDir}/scripts/reconcile_tracker.py tracker.md \
314
+ --checklist {compliance-audit baseDir}/references/vars-checklist.md \
315
+ --validation validation.json \
316
+ --judge judge-aacq.json \
317
+ --judge judge-atpa.json \
318
+ --log reconciliation.md
319
+ ```
320
+
321
+ `--validation` takes the JSON output of `validate_tracker.py --json` (re-run with `--json` to capture it). `--judge` may be passed multiple times to merge per-group judge sidecars.
322
+
323
+ The reconciler:
324
+
325
+ 1. Parses `tracker.md` and the checklist.
326
+ 2. Walks every Observations bullet. For each "auto-apply" finding hitting that bullet, transforms the bullet text and flips its status to `Not addressed`.
327
+ 3. Recomputes the row's Control Effectiveness Rating per the rubric using the new statuses.
328
+ 4. Prepends a `**[Step 9E reconciled]:**` note to Issue Description naming the flipped items. It does not write Actions Required or Recommendations entries; the reviewer adds them, then Step 10 normalizes.
329
+ 5. Writes the updated tracker (default: in place) and a `reconciliation.md` log of every change plus the reviewer-mediated items still pending.
330
+
331
+ After 9E runs, re-run 9A as a final structural check on the reconciled tracker. The reviewer then works through `reconciliation.md`'s "pending review" section before sign-off.
332
+
333
+ ### Step 10: Normalize Deliverable Formatting
334
+
335
+ Subagent and reconciler edits leave inconsistent cells (bolded or missing `Control` prefixes, `-` bullets, literal newlines). Step 10 enforces one canonical format.
336
+
337
+ This step is **purely cosmetic** — it must not change ratings, statuses, citations, or which items are present. If a normalization rule would alter meaning, leave the bullet alone and flag it in `normalization.md` for the reviewer.
338
+
339
+ Run it after Step 9E and before sign-off. The canonical cell formats and the rewrite rules are in [references/normalization-rules.md](references/normalization-rules.md).
340
+
341
+ #### How to run
342
+
343
+ No normalization script ships. The main agent (small / fast tier) applies only the rewrites listed in [references/normalization-rules.md](references/normalization-rules.md), in place, and logs every rewrite and every declined bullet (unmatched item id, ambiguous status phrase, missing group label) to `normalization.md`. Anything ambiguous goes in `normalization.md`, not silently into the tracker. The reviewer skims it before sign-off.
344
+
345
+ After normalization, re-run Step 9A:
346
+
347
+ ```bash
348
+ python3 {compliance-audit baseDir}/scripts/validate_tracker.py tracker.md \
349
+ --checklist {compliance-audit baseDir}/references/vars-checklist.md
350
+ ```
351
+
352
+ Zero errors before proceeding to the export.
353
+
354
+ #### Export tracker.xlsx
355
+
356
+ Always export the final tracker to Excel:
357
+
358
+ ```bash
359
+ python3 {compliance-audit baseDir}/scripts/export_tracker_xlsx.py tracker.md --output tracker.xlsx
360
+ ```
361
+
362
+ The workbook has a `Tracker` sheet (one row per Control ID, bold frozen header, filters, `<br>` as in-cell line breaks) and a `Metadata` sheet (the header block). It is a view of `tracker.md`: re-run the export after every later change to the tracker, including reviewer decisions at sign-off.
363
+
364
+ #### Reviewer sign-off gate
365
+
366
+ Before delivering `tracker.md` and `tracker.xlsx` to the client, the human reviewer must:
367
+
368
+ 1. Confirm Step 9A passes with zero errors against the **reconciled and normalized** tracker.
369
+ 2. Read `reconciliation.md`. Confirm the auto-applied changes (9B phantom citations, 9C `Off-target` / `Missing` verdicts) are correct — these are the most mechanical and should rarely need intervention.
370
+ 3. Work through `reconciliation.md`'s "pending review" section: 9C `Weak` verdicts and 9D challenger recommendations. Accept or reject each, recording the decision.
371
+ 4. Confirm any 9B warnings that the reconciler couldn't auto-apply (e.g. ambiguous citations) are resolved or documented as exceptions.
372
+ 5. Skim `normalization.md`. Confirm any bullets the normalizer declined to rewrite (unmatched item ids, ambiguous status phrases) are real issues to fix — not formatting noise to ignore.
373
+ 6. Confirm `tracker.xlsx` was exported from the final `tracker.md`, after the last change.
374
+
375
+ The reviewer's sign-off — not the tooling's pass — is what makes the tracker deliverable.
376
+
377
+ ## Built-in Checklists
378
+
379
+ The following checklist is bundled locally in `references/` and can be loaded directly:
380
+
381
+ - `references/vars-checklist.md` — Visa VARS control library (table format) keyed by Visa `Control ID` across `AACQ`, `ATPA`, `AHIR`, `AATM`, and `AVDC`. Pair with `references/vars-findings-schema.md` for the tracker format.
382
+
383
+ To use a built-in checklist, load it in Step 1 instead of asking the user to provide one.
384
+
385
+ ## VARS Audits
386
+
387
+ VARS governs acquirer obligations under the Visa network across five archetypes (45 sub-controls total):
388
+
389
+ | Archetype | Code | Applies To | Sub-controls |
390
+ |-----------|------|------------|--------------|
391
+ | All Acquirers | AACQ | Every Visa acquirer | 22 |
392
+ | TPA Sponsors | ATPA | Acquirers sponsoring Third-Party Agents | 15 |
393
+ | High Integrity Risk | AHIR | Acquirers in the VIRP programme | 1 |
394
+ | ATM Acquirers | AATM | Acquirers operating ATM networks | 5 |
395
+ | Visa Direct Clients | AVDC | Acquirers enabling Visa Direct | 2 (recommended-only) |
396
+
397
+ **At audit start:**
398
+ - Confirm which archetypes apply to the entity. Skip non-applicable parts (e.g., skip ATPA if the acquirer does not sponsor TPAs).
399
+ - Load `references/vars-checklist.md` (control library) and follow `references/vars-findings-schema.md` (tracker output).
400
+ - Tracker rows are **per Control ID**. Per-mandatory-item detail (`1a`, `1b`, `3.i`, …) is captured as bulleted entries inside the Observations cell, prefixed `Control 1a:`, `Control 1b:`, etc., per Visa VCA convention.
401
+ - Use the Visa effectiveness rubric (Satisfactory / Improvement Recommended / Unsatisfactory / N/A; a mandatory `Partial` or `Not addressed` is Unsatisfactory). Do **not** import a critical/major/minor severity scheme.
402
+
403
+ **Key evidence areas:**
404
+ - Risk appetite policy (board-approved, version-controlled)
405
+ - Merchant agreements and underwriting records
406
+ - VMSS/sanctions screening logs at onboarding and ongoing
407
+ - Transaction monitoring rules, alert logs, investigation records
408
+ - Suspicious activity reporting (SAR) records and procedures
409
+ - PCI DSS certification and data security documentation
410
+ - TPA agreements, underwriting files, monitoring reports (ATPA only)
411
+ - VIRP registration documentation (AHIR only)
412
+ - ATM operator agreements and KYO verifications (AATM only)
413
+
414
+ ## Additional Checklists from reg-parser
415
+
416
+ For standards not listed above, check `{reg-parser baseDir}/references/checklists/` — additional checklists are added there as they are extracted. Load the relevant checklist and apply the same phased workflow.
417
+
418
+ ## Guidelines
419
+
420
+ - **One control at a time.** Within any review pass — whether the main agent or a subagent chunk — work through controls one by one. Chunking (Step 6) parallelises *across* control groups but the work *within* a chunk is still sequential, control by control.
421
+ - **Evidence first.** Never mark PASS / Green / Satisfactory without reviewing actual evidence.
422
+ - **Phase-specific observations.** Keep document, onsite, and sample-test conclusions distinct before synthesizing.
423
+ - **Be specific.** Observations reference concrete documents (by original filename), records, interviews, or test samples.
424
+ - **No assumptions.** If evidence is unavailable, mark FAIL / PARTIAL / Unsatisfactory or request more evidence.
425
+ - **Preserve checklist structure.** Findings map 1:1 to `Control ID` records.
426
+ - **Keep the audit trail.** `tracker.md` is the deliverable but `phase-trail.md` is the defensible record — never overwrite phase observations when finalising the tracker.
427
+ - **Model selection.** Match the subagent's model tier to the cognitive load of its task. Adversarial-stance and synthesis work needs more capability; mechanical tasks (doc conversion, citation lookup) do not. Tiers are vendor-neutral — pick whatever your provider offers at each tier.
428
+
429
+ | Step | Task character | Recommended tier |
430
+ |---|---|---|
431
+ | Step 0 — evidence preprocessing | Mechanical doc conversion (binary → md) | **Small / fast** |
432
+ | Step 6B — per-phase review | Careful reasoning across a control's evidence | **Mid** |
433
+ | Step 7A — tracker synthesis | Multi-phase consolidation per Control ID | **Mid** |
434
+ | Step 9C — citation judge | Local clause-vs-requirement comparison | **Small / fast** |
435
+ | Step 9D — adversarial challenger | Forming a credible challenge, recommending downgrades | **Mid** for routine; **large / top-tier** for regulator-facing audits |
436
+ | Step 10 — normalize formatting | Mechanical text rewrites against a fixed rule set | **Small / fast** (no script ships) |
437
+ | Step 10 — export tracker.xlsx | Markdown table → workbook | **Deterministic script** (no model) |
438
+
439
+ A small model on synthesis or the challenger costs more in re-runs than it saves; a mid-tier model on preprocessing or the judge buys nothing.