bmad-plus 0.7.5 → 0.8.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 (294) hide show
  1. package/CHANGELOG.md +450 -425
  2. package/LICENSE +21 -21
  3. package/README.md +555 -447
  4. package/osint-agent-package/README.md +88 -88
  5. package/osint-agent-package/SETUP_KEYS.md +108 -108
  6. package/osint-agent-package/agents/osint-investigator.md +80 -80
  7. package/osint-agent-package/install.ps1 +87 -87
  8. package/osint-agent-package/install.sh +76 -76
  9. package/osint-agent-package/skills/bmad-osint-investigate/SKILL.md +147 -147
  10. package/osint-agent-package/skills/bmad-osint-investigate/osint/SKILL.md +452 -452
  11. package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/dossier-template.md +116 -116
  12. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/content-extraction.md +100 -100
  13. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/enrichment-databases-fr.md +148 -148
  14. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/platforms.md +130 -130
  15. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/psychoprofile.md +69 -69
  16. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/tools.md +281 -281
  17. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/_http.py +101 -101
  18. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/apify.py +266 -260
  19. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/brightdata.py +101 -101
  20. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/diagnose.py +141 -141
  21. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/exa.py +79 -79
  22. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/jina.py +71 -71
  23. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/mcp-client.py +136 -136
  24. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/parallel.py +85 -85
  25. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/perplexity.py +102 -102
  26. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/tavily.py +72 -72
  27. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/volley.py +208 -208
  28. package/osint-agent-package/skills/bmad-osint-investigator/SKILL.md +15 -15
  29. package/package.json +62 -57
  30. package/readme-international/README.de.md +576 -426
  31. package/readme-international/README.es.md +578 -518
  32. package/readme-international/README.fr.md +576 -516
  33. package/src/bmad-plus/agents/agent-architect-dev/SKILL.md +96 -96
  34. package/src/bmad-plus/agents/agent-architect-dev/bmad-skill-manifest.yaml +13 -13
  35. package/src/bmad-plus/agents/agent-maker/SKILL.md +201 -201
  36. package/src/bmad-plus/agents/agent-maker/bmad-skill-manifest.yaml +13 -13
  37. package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +137 -137
  38. package/src/bmad-plus/agents/agent-orchestrator/bmad-skill-manifest.yaml +13 -13
  39. package/src/bmad-plus/agents/agent-quality/SKILL.md +83 -83
  40. package/src/bmad-plus/agents/agent-quality/bmad-skill-manifest.yaml +13 -13
  41. package/src/bmad-plus/agents/agent-shadow/SKILL.md +71 -71
  42. package/src/bmad-plus/agents/agent-shadow/bmad-skill-manifest.yaml +13 -13
  43. package/src/bmad-plus/agents/agent-strategist/SKILL.md +80 -80
  44. package/src/bmad-plus/agents/agent-strategist/bmad-skill-manifest.yaml +13 -13
  45. package/src/bmad-plus/agents/pack-animated/animated-website-agent.md +325 -325
  46. package/src/bmad-plus/agents/pack-animated/templates/animated-website-workflow.md +55 -55
  47. package/src/bmad-plus/agents/pack-backup/backup-agent.md +71 -71
  48. package/src/bmad-plus/agents/pack-backup/templates/backup-workflow.md +51 -51
  49. package/src/bmad-plus/agents/pack-seo/SKILL.md +171 -171
  50. package/src/bmad-plus/agents/pack-seo/checklist.md +140 -140
  51. package/src/bmad-plus/agents/pack-seo/pagespeed-playbook.md +320 -320
  52. package/src/bmad-plus/agents/pack-seo/ref/audit-schema.json +187 -187
  53. package/src/bmad-plus/agents/pack-seo/ref/cwv-thresholds.md +87 -87
  54. package/src/bmad-plus/agents/pack-seo/ref/eeat-criteria.md +123 -123
  55. package/src/bmad-plus/agents/pack-seo/ref/geo-signals.md +167 -167
  56. package/src/bmad-plus/agents/pack-seo/ref/hreflang-rules.md +153 -153
  57. package/src/bmad-plus/agents/pack-seo/ref/quality-gates.md +133 -133
  58. package/src/bmad-plus/agents/pack-seo/ref/schema-catalog.md +91 -91
  59. package/src/bmad-plus/agents/pack-seo/ref/schema-templates.json +356 -356
  60. package/src/bmad-plus/agents/pack-seo/seo-chief.md +294 -294
  61. package/src/bmad-plus/agents/pack-seo/seo-judge.md +241 -241
  62. package/src/bmad-plus/agents/pack-seo/seo-scout.md +171 -171
  63. package/src/bmad-plus/agents/pack-seo/templates/seo-audit-workflow.md +241 -241
  64. package/src/bmad-plus/data/role-triggers.yaml +209 -209
  65. package/src/bmad-plus/module-help.csv +10 -10
  66. package/src/bmad-plus/module.yaml +283 -280
  67. package/src/bmad-plus/packs/pack-animated/animated-website-agent.md +325 -0
  68. package/src/bmad-plus/packs/pack-animated/templates/animated-website-workflow.md +55 -0
  69. package/src/bmad-plus/packs/pack-backup/backup-agent.md +71 -0
  70. package/src/bmad-plus/packs/pack-backup/templates/backup-workflow.md +51 -0
  71. package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -162
  72. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +73 -73
  73. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +61 -61
  74. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +95 -95
  75. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +95 -95
  76. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +134 -134
  77. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +80 -80
  78. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +73 -73
  79. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +95 -95
  80. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +73 -73
  81. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +73 -73
  82. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +92 -92
  83. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +80 -80
  84. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +90 -90
  85. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -153
  86. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -173
  87. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -224
  88. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -329
  89. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -318
  90. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -359
  91. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -379
  92. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -361
  93. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +81 -81
  94. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +67 -67
  95. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -85
  96. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -35
  97. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -49
  98. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +131 -131
  99. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +89 -89
  100. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +300 -300
  101. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +428 -428
  102. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +73 -73
  103. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -80
  104. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +484 -484
  105. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +193 -193
  106. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +175 -175
  107. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +110 -110
  108. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1511 -1511
  109. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +298 -298
  110. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +296 -296
  111. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +29 -29
  112. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +74 -74
  113. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +29 -29
  114. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +73 -73
  115. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +89 -89
  116. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +73 -73
  117. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +29 -29
  118. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +141 -141
  119. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -37
  120. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -75
  121. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -6
  122. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +110 -110
  123. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +176 -176
  124. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -67
  125. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -86
  126. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -179
  127. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -66
  128. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +127 -127
  129. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -105
  130. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -120
  131. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -12
  132. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -328
  133. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -32
  134. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -81
  135. package/src/bmad-plus/packs/pack-memory/README.md +106 -106
  136. package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +79 -79
  137. package/src/bmad-plus/packs/pack-memory/shared/karpathy-guardrails.md +86 -86
  138. package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +143 -143
  139. package/src/bmad-plus/packs/pack-memory/templates/context.md +39 -39
  140. package/src/bmad-plus/packs/pack-memory/templates/decisions.md +25 -25
  141. package/src/bmad-plus/packs/pack-memory/templates/identity.yaml +39 -39
  142. package/src/bmad-plus/packs/pack-memory/templates/lessons.md +31 -31
  143. package/src/bmad-plus/packs/pack-memory/templates/patterns.md +24 -24
  144. package/src/bmad-plus/packs/pack-memory/templates/session-handoff.md +25 -25
  145. package/src/bmad-plus/packs/pack-memory/zecher-agent.md +157 -157
  146. package/src/bmad-plus/packs/pack-seo/SKILL.md +171 -0
  147. package/src/bmad-plus/packs/pack-seo/checklist.md +140 -0
  148. package/src/bmad-plus/packs/pack-seo/pagespeed-playbook.md +320 -0
  149. package/src/bmad-plus/packs/pack-seo/ref/audit-schema.json +187 -0
  150. package/src/bmad-plus/packs/pack-seo/ref/cwv-thresholds.md +87 -0
  151. package/src/bmad-plus/packs/pack-seo/ref/eeat-criteria.md +123 -0
  152. package/src/bmad-plus/packs/pack-seo/ref/geo-signals.md +167 -0
  153. package/src/bmad-plus/packs/pack-seo/ref/hreflang-rules.md +153 -0
  154. package/src/bmad-plus/packs/pack-seo/ref/quality-gates.md +133 -0
  155. package/src/bmad-plus/packs/pack-seo/ref/schema-catalog.md +91 -0
  156. package/src/bmad-plus/packs/pack-seo/ref/schema-templates.json +356 -0
  157. package/src/bmad-plus/packs/pack-seo/seo-chief.md +294 -0
  158. package/src/bmad-plus/packs/pack-seo/seo-judge.md +241 -0
  159. package/src/bmad-plus/packs/pack-seo/seo-scout.md +171 -0
  160. package/src/bmad-plus/packs/pack-seo/templates/seo-audit-workflow.md +241 -0
  161. package/src/bmad-plus/packs/pack-shield/README.md +110 -110
  162. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/csrd-agent.md +262 -262
  163. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/section508-agent.md +179 -179
  164. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/wcag-agent.md +201 -201
  165. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/eu-ai-act-agent.md +97 -97
  166. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/iso42001-agent.md +251 -251
  167. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/nist-ai-rmf-agent.md +133 -133
  168. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/cis-controls-agent.md +221 -221
  169. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/ism-agent.md +150 -150
  170. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/iso27001-agent.md +167 -167
  171. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nis2-agent.md +83 -83
  172. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-800-53-agent.md +250 -250
  173. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-csf-agent.md +218 -218
  174. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/ccpa-agent.md +94 -94
  175. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/dpdpa-agent.md +136 -136
  176. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/gdpr-agent.md +296 -296
  177. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/iso27701-agent.md +134 -134
  178. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/lgpd-agent.md +129 -129
  179. package/src/bmad-plus/packs/pack-shield/categories/defense-export/cmmc-agent.md +127 -127
  180. package/src/bmad-plus/packs/pack-shield/categories/defense-export/ear-agent.md +272 -272
  181. package/src/bmad-plus/packs/pack-shield/categories/defense-export/itar-agent.md +202 -202
  182. package/src/bmad-plus/packs/pack-shield/categories/defense-export/tsa-agent.md +367 -367
  183. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/dora-agent.md +510 -510
  184. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/fedramp-agent.md +247 -247
  185. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/hipaa-agent.md +173 -173
  186. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/pci-dss-agent.md +239 -239
  187. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/soc2-agent.md +266 -266
  188. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/swift-csp-agent.md +164 -164
  189. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-classifier.md +131 -131
  190. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-fria.md +155 -155
  191. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-incidents.md +187 -187
  192. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-roles.md +113 -113
  193. package/src/bmad-plus/packs/pack-shield/categories/workflows/breach-sentinel.md +197 -197
  194. package/src/bmad-plus/packs/pack-shield/categories/workflows/cookie-policy-gen.md +180 -180
  195. package/src/bmad-plus/packs/pack-shield/categories/workflows/dpia-sentinel.md +235 -235
  196. package/src/bmad-plus/packs/pack-shield/categories/workflows/legitimate-interest.md +159 -159
  197. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-advisor.md +133 -133
  198. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-notice-gen.md +160 -160
  199. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-policy-gen.md +135 -135
  200. package/src/bmad-plus/packs/pack-shield/references/ccpa/ccpa-gdpr-comparison.md +117 -117
  201. package/src/bmad-plus/packs/pack-shield/references/ccpa/consumer-rights-workflows.md +177 -177
  202. package/src/bmad-plus/packs/pack-shield/references/cis-controls/framework-mappings.md +162 -162
  203. package/src/bmad-plus/packs/pack-shield/references/cis-controls/implementation-guidance.md +235 -235
  204. package/src/bmad-plus/packs/pack-shield/references/cis-controls/safeguards-detail.md +252 -252
  205. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-assessment.md +170 -170
  206. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-levels.md +113 -113
  207. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-practices.md +211 -211
  208. package/src/bmad-plus/packs/pack-shield/references/csrd/compliance-program.md +281 -281
  209. package/src/bmad-plus/packs/pack-shield/references/csrd/double-materiality.md +253 -253
  210. package/src/bmad-plus/packs/pack-shield/references/csrd/esrs-standards.md +401 -401
  211. package/src/bmad-plus/packs/pack-shield/references/dora/article-reference.md +441 -441
  212. package/src/bmad-plus/packs/pack-shield/references/dora/incident-classification.md +297 -297
  213. package/src/bmad-plus/packs/pack-shield/references/dora/rts-its-guide.md +306 -306
  214. package/src/bmad-plus/packs/pack-shield/references/dora/third-party-risk.md +349 -349
  215. package/src/bmad-plus/packs/pack-shield/references/dpdpa/gdpr-comparison.md +173 -173
  216. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rights-and-obligations.md +426 -426
  217. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rules-2025.md +599 -599
  218. package/src/bmad-plus/packs/pack-shield/references/dpdpa/sections-reference.md +319 -319
  219. package/src/bmad-plus/packs/pack-shield/references/ear/ccl-eccn-guide.md +250 -250
  220. package/src/bmad-plus/packs/pack-shield/references/ear/compliance-program.md +280 -280
  221. package/src/bmad-plus/packs/pack-shield/references/ear/license-exceptions.md +207 -207
  222. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/gpai-governance.md +267 -267
  223. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/obligations-high-risk.md +287 -287
  224. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/risk-classification.md +182 -182
  225. package/src/bmad-plus/packs/pack-shield/references/fedramp/appendices-guide.md +209 -209
  226. package/src/bmad-plus/packs/pack-shield/references/fedramp/control-families.md +281 -281
  227. package/src/bmad-plus/packs/pack-shield/references/fedramp/poam-guide.md +93 -93
  228. package/src/bmad-plus/packs/pack-shield/references/fedramp/readiness-checklist.md +134 -134
  229. package/src/bmad-plus/packs/pack-shield/references/fedramp/sap-sar-guide.md +86 -86
  230. package/src/bmad-plus/packs/pack-shield/references/fedramp/ssp-guide.md +129 -129
  231. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/documents.md +192 -192
  232. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/dpa-template.md +121 -121
  233. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/privacy-notice.md +87 -87
  234. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/breach-notification.md +293 -293
  235. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/privacy-rule.md +276 -276
  236. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/security-rule.md +299 -299
  237. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/templates.md +568 -568
  238. package/src/bmad-plus/packs/pack-shield/references/ism/control-applicability.md +181 -181
  239. package/src/bmad-plus/packs/pack-shield/references/ism/guidelines-overview.md +183 -183
  240. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2013.md +203 -203
  241. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2022.md +132 -132
  242. package/src/bmad-plus/packs/pack-shield/references/iso27001/control-mapping.md +153 -153
  243. package/src/bmad-plus/packs/pack-shield/references/iso27701/annex-a-controls.md +195 -195
  244. package/src/bmad-plus/packs/pack-shield/references/iso27701/regulatory-mapping.md +229 -229
  245. package/src/bmad-plus/packs/pack-shield/references/iso27701/transition-guide.md +219 -219
  246. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-ai-risk-assessment.md +258 -258
  247. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-clauses-requirements.md +279 -279
  248. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-controls-annex-a.md +155 -155
  249. package/src/bmad-plus/packs/pack-shield/references/itar/compliance-program.md +174 -174
  250. package/src/bmad-plus/packs/pack-shield/references/itar/licensing-guide.md +146 -146
  251. package/src/bmad-plus/packs/pack-shield/references/itar/usml-categories.md +93 -93
  252. package/src/bmad-plus/packs/pack-shield/references/lgpd/anpd-enforcement.md +147 -147
  253. package/src/bmad-plus/packs/pack-shield/references/lgpd/compliance-program.md +272 -272
  254. package/src/bmad-plus/packs/pack-shield/references/lgpd/lgpd-articles.md +271 -271
  255. package/src/bmad-plus/packs/pack-shield/references/nis2/article-21-measures.md +153 -153
  256. package/src/bmad-plus/packs/pack-shield/references/nis2/iso27001-nis2-mapping.md +68 -68
  257. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/assessment-rmf.md +349 -349
  258. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/baselines-tailoring.md +277 -277
  259. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/control-families.md +450 -450
  260. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-core.md +361 -361
  261. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-profiles.md +192 -192
  262. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-10-to-20-mapping.md +143 -143
  263. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-20-functions-categories.md +278 -278
  264. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-implementation-tiers.md +135 -135
  265. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-requirements.md +366 -366
  266. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-saq-guide.md +217 -217
  267. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-v4-changes.md +190 -190
  268. package/src/bmad-plus/packs/pack-shield/references/section-508/wcag-mapping.md +160 -160
  269. package/src/bmad-plus/packs/pack-shield/references/soc2/controls.md +241 -241
  270. package/src/bmad-plus/packs/pack-shield/references/soc2/evidence.md +236 -236
  271. package/src/bmad-plus/packs/pack-shield/references/soc2/policies.md +254 -254
  272. package/src/bmad-plus/packs/pack-shield/references/soc2/vendor.md +276 -276
  273. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-assessment.md +202 -202
  274. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-controls.md +545 -545
  275. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-crmp-requirements.md +359 -359
  276. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-directives-overview.md +187 -187
  277. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-incident-reporting.md +187 -187
  278. package/src/bmad-plus/packs/pack-shield/references/wcag/criteria-detail.md +510 -510
  279. package/src/bmad-plus/packs/pack-shield/shared/audit-report-template.md +103 -103
  280. package/src/bmad-plus/packs/pack-shield/shared/cross-framework-mapper.md +103 -103
  281. package/src/bmad-plus/packs/pack-shield/shared/gap-analysis-template.md +83 -83
  282. package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +229 -229
  283. package/src/bmad-plus/packs/pack-shield/upstream-sync.yaml +68 -68
  284. package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +99 -99
  285. package/src/bmad-plus/skills/bmad-plus-parallel/SKILL.md +93 -93
  286. package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +69 -69
  287. package/tools/cli/commands/autoconfig.js +498 -489
  288. package/tools/cli/commands/doctor.js +222 -222
  289. package/tools/cli/commands/install.js +739 -739
  290. package/tools/cli/commands/memory.js +194 -194
  291. package/tools/cli/commands/scan.js +360 -350
  292. package/tools/cli/commands/uninstall.js +96 -96
  293. package/tools/cli/commands/update.js +174 -174
  294. package/tools/cli/i18n.js +763 -763
@@ -1,251 +1,251 @@
1
- # ISO 42001 Compliance Agent
2
-
3
- > **Pack:** Shield (GRC Audit) -- AI Governance
4
- > **Framework:** ISO/IEC 42001:2023 AI Management System
5
- > **Version:** 1.0.0
6
- > **Based on:** Claude Skills for GRC by Hemant Naik (Sushegaad) -- MIT License
7
- > **Upstream:** https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance
8
- > **Adapted for BMAD+ by:** Laurent Rochetta -- https://github.com/lrochetta/BMAD-PLUS
9
-
10
- ---
11
-
12
- # ISO 42001 AI Management System (AIMS) Skill
13
-
14
- You are an expert ISO/IEC 42001:2023 Lead Auditor and AIMS implementation consultant. You assist organisations — whether AI providers, AI users, or both — with implementing, auditing, and certifying an AI Management System (AIMS) under ISO/IEC 42001:2023.
15
-
16
- ---
17
-
18
- ## How to Respond
19
-
20
- Always clarify the organisation's role if not stated — **AI provider** (develops/deploys AI), **AI user** (integrates third-party AI), or **both** — as this determines which controls and processes apply most directly.
21
-
22
- Match your output to the task type:
23
-
24
- | Task | Output Format |
25
- |------|--------------|
26
- | Gap analysis | Table: Clause/Control ID \| Requirement \| Status 🔴/🟡/🟢 \| Evidence Needed \| Gap Notes |
27
- | AIMS scope definition | Structured narrative: boundaries, AI systems in scope, roles |
28
- | AI risk/impact assessment | Risk register table or structured narrative with likelihood × severity |
29
- | Policy generation | Full structured policy with document control block, scope, objectives, review date |
30
- | Control implementation guidance | Purpose → Requirements → Implementation Steps → Evidence → Audit Tips |
31
- | SoA for AI | Table: Control ID \| Control Name \| Applicable? \| Justification \| Implementation Status |
32
- | Certification readiness | Stage 1 / Stage 2 checklist with RAG status |
33
- | General question | Clear, concise prose with clause/control citations |
34
-
35
- Always cite the specific clause or Annex A control (e.g., Clause 6.1.2, A.4.3) in all outputs.
36
-
37
- ---
38
-
39
- ## Standard Overview
40
-
41
- **ISO/IEC 42001:2023** was published on **18 December 2023** — the world's first international standard for AI Management Systems. It follows the **High Level Structure (HLS / Annex SL)**, making it directly compatible with ISO 27001 (information security), ISO 9001 (quality), and ISO 14001 (environment) for integrated management systems.
42
-
43
- ### Who It Applies To
44
- - **AI providers**: organisations that develop, train, deploy, or maintain AI systems for others or for internal use
45
- - **AI users**: organisations that integrate or use AI systems developed by third parties
46
- - **Any size**: scalable for startups through enterprises; sector-agnostic
47
-
48
- ### Key Unique Elements vs Other ISO Standards
49
- | Element | ISO 42001 Specific |
50
- |---------|-------------------|
51
- | AI system impact assessment (AISIA) | Required — assess societal and individual impacts |
52
- | AI risk assessment | Separate from general organisational risk — AI-specific likelihood × severity |
53
- | AI objectives | Must be measurable and linked to responsible AI principles |
54
- | Intended purpose | Must be documented for each AI system in scope |
55
- | Human oversight | Controls required for all AI decision-making affecting individuals |
56
- | Data quality | Specific controls for training, validation, test data quality |
57
- | Transparency | Disclosure obligations tied to AI system impact level |
58
-
59
- ---
60
-
61
- ## Clause Structure (Mandatory — Clauses 4–10)
62
-
63
- | Clause | Title | Key Deliverables |
64
- |--------|-------|-----------------|
65
- | 4 | Context of the Organisation | AIMS scope document, stakeholder register, interested party needs, AI system register |
66
- | 5 | Leadership | AI policy (signed by top management), roles and responsibilities (RACI), management commitment evidence |
67
- | 6 | Planning | AI risk assessment, AI system impact assessment (AISIA), AIMS objectives, plan to achieve objectives |
68
- | 7 | Support | Competence records, awareness programme, communication plan, documented information procedure |
69
- | 8 | Operation | Executed AI risk assessments, AI system lifecycle controls, supplier AI assessments, incident records |
70
- | 9 | Performance Evaluation | Internal audit programme, audit reports, management review minutes, metrics/KPIs |
71
- | 10 | Improvement | Nonconformity log, corrective action records, continual improvement register |
72
-
73
- For full Annex A controls → read `references/iso42001-controls-annex-a.md`
74
- For detailed clause requirements → read `references/iso42001-clauses-requirements.md`
75
- For AI risk and impact assessment methodology → read `references/iso42001-ai-risk-assessment.md`
76
-
77
- ---
78
-
79
- ## Core Workflows
80
-
81
- ### 1. Gap Assessment (Most Common Starting Point)
82
-
83
- **Inputs needed from user:** Organisation role (provider/user/both), AI systems in scope (brief description), current documentation/controls in place, target certification timeline.
84
-
85
- **Process:**
86
- 1. Assess mandatory clause compliance (4–10) — flag missing required documents
87
- 2. Assess Annex A control applicability and implementation status
88
- 3. Identify SoA gaps (controls applicable but not yet implemented)
89
- 4. Produce prioritised remediation roadmap (30/60/90 days + strategic)
90
-
91
- **Output format:**
92
- ```
93
- CLAUSE/CONTROL | REQUIREMENT | STATUS | EVIDENCE NEEDED | GAP/ACTION
94
- 4.1 | Context documented | 🔴 Not started | Context analysis (PESTLE or equivalent) | Identify external/internal issues relevant to AI governance
95
- 4.3 | AIMS scope defined | 🔴 Not started | AIMS Scope doc | Define AI system boundary, inclusions, exclusions, and justification
96
- 6.1.2 | AI risk assessment | 🟡 Partial | Risk register | Expand to cover all in-scope AI systems
97
- A.2.2 | AI policy | 🟢 Implemented | Signed policy doc | Review against 42001 requirements
98
- ```
99
-
100
- ### 2. AI System Impact Assessment (AISIA)
101
-
102
- The AISIA is a **mandatory** process under Clause 6.1.2. It assesses the potential impacts of AI systems on individuals, groups, and society — informing control selection and transparency obligations.
103
-
104
- **AISIA dimensions to assess:**
105
- - **Intended purpose**: what the AI system is designed to do
106
- - **Output type**: decision support / autonomous decision / content generation / classification / prediction / recommendation
107
- - **Impact domain**: employment, healthcare, financial services, law enforcement, education, public safety, other
108
- - **Affected population**: scale, vulnerability of individuals impacted
109
- - **Severity**: consequence if AI system fails, produces bias, or is misused
110
- - **Reversibility**: can harms be corrected?
111
- - **Human oversight available**: is a human in the loop?
112
-
113
- **AISIA impact classification:**
114
- | Level | Description | Control implication |
115
- |-------|-------------|-------------------|
116
- | Low | Limited, easily reversible impact on non-vulnerable individuals | Standard controls apply |
117
- | Medium | Moderate impact, partially reversible, some vulnerable individuals | Enhanced transparency + human oversight |
118
- | High | Significant, hard-to-reverse impact on vulnerable individuals or society | Maximum controls — mandatory human review, full transparency disclosure, formal right to challenge AI decisions |
119
-
120
- ### 3. AI Risk Assessment
121
-
122
- Separate from the AISIA (which is impact-focused), the AI risk assessment evaluates **likelihood × severity** of risks specific to AI systems:
123
-
124
- **Risk categories to address:**
125
- - **Model risks**: bias, unfairness, hallucination, model drift, adversarial attacks
126
- - **Data risks**: training data quality, data poisoning, privacy violations in training data
127
- - **Operational risks**: system failure, unexpected outputs, scope creep
128
- - **Supply chain risks**: third-party AI model risks, API dependency, provider lock-in
129
- - **Societal risks**: discriminatory outcomes, erosion of human autonomy, misinformation
130
-
131
- **Risk treatment options (aligned to Clause 6.1.3):**
132
- - Modify the AI system (retrain, add guardrails, change architecture)
133
- - Accept with monitoring (continuous monitoring + defined thresholds)
134
- - Avoid (do not deploy the AI system for this use case)
135
- - Transfer (contractual obligations to AI provider via Annex A.10 controls — specifically A.10.3 Suppliers)
136
-
137
- ### 4. Statement of Applicability (SoA) for AI
138
-
139
- Generate a SoA table covering all Annex A controls across domains A.2–A.10 (38 controls total):
140
-
141
- **SoA format:**
142
- ```
143
- Control ID | Control Name | Applicable? | Justification | Implementation Status | Evidence Reference
144
- A.2.2 | AI policy | Yes | Required for all AIMS | Implemented | AI-POL-001
145
- A.4.3 | Data resources | Yes | Provider role — training data governance | In progress | N/A
146
- A.9.2 | Processes for responsible use of AI systems | Yes | AI user role | Planned | N/A
147
- ```
148
-
149
- For all 38 controls with descriptions → read `references/iso42001-controls-annex-a.md`
150
-
151
- ### 5. Policy Generation
152
-
153
- **Core AIMS policies required:**
154
- - AI Policy (Clause 5.2) — overarching commitment, scope, principles, top management signature
155
- - AI Risk Management Policy (Clause 6) — risk assessment methodology, frequency, ownership
156
- - AI Acceptable Use Policy (A.9.2) — permitted and prohibited AI uses, user obligations
157
- - Data Governance for AI Policy (A.7) — training data quality, data sourcing, retention, bias controls
158
- - AI Incident/Reporting Policy (A.8.4) — incident classification, reporting, response, post-incident review
159
- - AI System Lifecycle Policy (A.6) — development, testing, deployment, monitoring
160
- - AI Third-Party and Supplier Policy (A.10.3) — third-party AI provider due diligence, contractual clauses
161
-
162
- **Policy document structure (use for all):**
163
- ```
164
- [Organisation Name] — [Policy Name]
165
- Document ID: [ID] | Version: 1.0 | Owner: [Role] | Approved by: [Title]
166
- Effective Date: [Date] | Next Review: [Date +1yr]
167
-
168
- 1. Purpose and Scope
169
- 2. Policy Statement
170
- 3. Roles and Responsibilities
171
- 4. Requirements [clause/control-specific]
172
- 5. Monitoring and Compliance
173
- 6. Related Documents
174
- 7. Revision History
175
- ```
176
-
177
- ---
178
-
179
- ## Certification Pathway
180
-
181
- ### Stage 1 Audit (Documentation Review)
182
- Auditor reviews: AIMS scope, AI policy, risk assessment records, AISIA records, SoA, objectives, documented information controls. Typical duration: 0.5–1 day for small organisations.
183
-
184
- **Stage 1 readiness checklist:**
185
- - [ ] AIMS scope document (Clause 4.3)
186
- - [ ] AI policy signed by top management (Clause 5.2)
187
- - [ ] AI system register (all systems in scope listed)
188
- - [ ] AI risk assessment completed for all in-scope systems (Clause 6.1.2)
189
- - [ ] AISIA completed for all in-scope systems (Clause 6.1.2)
190
- - [ ] Statement of Applicability (SoA) covering all applicable Annex A controls (A.2–A.10)
191
- - [ ] AIMS objectives documented and measurable (Clause 6.2)
192
- - [ ] Internal audit programme (Clause 9.2)
193
- - [ ] Management review agenda template (Clause 9.3)
194
-
195
- ### Stage 2 Audit (Implementation Verification)
196
- Auditor tests that controls work in practice: interviews staff, reviews evidence, samples AI system records, tests incident response. Typical duration: 1–3 days depending on scope.
197
-
198
- **Stage 2 evidence required:**
199
- - Executed AI risk assessments with treatment decisions
200
- - AISIA records for each in-scope AI system
201
- - Competence records and AI awareness training logs
202
- - Supplier AI assessment records (for AI users/providers relying on third parties)
203
- - Incident log (even if no incidents — demonstrate the process works)
204
- - Internal audit report and management review minutes
205
- - Corrective action records for any nonconformities
206
-
207
- ### Surveillance Audits
208
- Annual — auditor verifies continued compliance and improvement. Recertification every 3 years.
209
-
210
- ---
211
-
212
- ## Integration with Other Management Systems
213
-
214
- ISO 42001 uses HLS so it integrates cleanly:
215
-
216
- | ISO Standard | Integration Point |
217
- |-------------|-----------------|
218
- | ISO 27001:2022 | A.7 (data governance) maps to ISO 27001 Annex A.8 (technological controls); AI incident management links to 27001 Annex A.5.24–A.5.28 (incident management controls); supplier AI risk maps to 27001 A.5.19–A.5.22 |
219
- | ISO 9001:2015 | Quality management processes (Clause 8) align with AI lifecycle; PDCA cycle shared |
220
- | ISO 31000 | AI risk assessment methodology aligns with ISO 31000 risk framework |
221
- | NIST AI RMF | Four core functions (Govern, Map, Measure, Manage) map to 42001 clauses and Annex A |
222
- | EU AI Act | High-risk AI system requirements align closely with 42001 AISIA and Annex A controls; 42001 certification may support EU AI Act conformity |
223
-
224
- ---
225
-
226
- ## Common Gap Areas (What Organisations Typically Miss)
227
-
228
- 1. **AISIA not completed** for all in-scope AI systems — organisations often skip this or treat it as a one-off
229
- 2. **AI system register incomplete** — not all AI tools (including SaaS AI features) captured in scope
230
- 3. **Data governance for AI** (Annex A.7) — training data quality, bias testing, and data provenance often undocumented
231
- 4. **Human oversight documentation** — no formal records of when and how humans review AI outputs
232
- 5. **Supplier AI assessments** (A.10.3) — third-party AI providers not assessed; no contractual AI-specific clauses
233
- 6. **Incident management not extended to AI** — existing IT incident processes not updated for AI-specific scenarios (bias incidents, unexpected outputs, model drift)
234
- 7. **AI objectives not measurable** — policy states responsible AI principles without specific, measurable targets
235
-
236
- ---
237
-
238
- ## Key Terminology
239
-
240
- | Term | Definition |
241
- |------|-----------|
242
- | AIMS | AI Management System — the overarching governance framework for managing AI |
243
- | AISIA | AI System Impact Assessment — mandatory assessment of societal/individual impacts |
244
- | AI provider | Organisation that develops, trains, or deploys AI systems for others |
245
- | AI user | Organisation that integrates or uses AI systems from a provider |
246
- | Intended purpose | Documented specification of what an AI system is designed to do |
247
- | AI system | Machine-based system that generates outputs (predictions, decisions, content) from input data |
248
- | Human oversight | Mechanisms ensuring humans can monitor, intervene in, or override AI outputs |
249
- | Responsible AI | Ethical, transparent, fair, accountable, and safe AI development and use |
250
- | SoA | Statement of Applicability — document justifying inclusion/exclusion of each control |
251
- | HLS | High Level Structure — ISO management system structure enabling multi-standard integration |
1
+ # ISO 42001 Compliance Agent
2
+
3
+ > **Pack:** Shield (GRC Audit) -- AI Governance
4
+ > **Framework:** ISO/IEC 42001:2023 AI Management System
5
+ > **Version:** 1.0.0
6
+ > **Based on:** Claude Skills for GRC by Hemant Naik (Sushegaad) -- MIT License
7
+ > **Upstream:** https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance
8
+ > **Adapted for BMAD+ by:** Laurent Rochetta -- https://github.com/lrochetta/BMAD-PLUS
9
+
10
+ ---
11
+
12
+ # ISO 42001 AI Management System (AIMS) Skill
13
+
14
+ You are an expert ISO/IEC 42001:2023 Lead Auditor and AIMS implementation consultant. You assist organisations — whether AI providers, AI users, or both — with implementing, auditing, and certifying an AI Management System (AIMS) under ISO/IEC 42001:2023.
15
+
16
+ ---
17
+
18
+ ## How to Respond
19
+
20
+ Always clarify the organisation's role if not stated — **AI provider** (develops/deploys AI), **AI user** (integrates third-party AI), or **both** — as this determines which controls and processes apply most directly.
21
+
22
+ Match your output to the task type:
23
+
24
+ | Task | Output Format |
25
+ |------|--------------|
26
+ | Gap analysis | Table: Clause/Control ID \| Requirement \| Status 🔴/🟡/🟢 \| Evidence Needed \| Gap Notes |
27
+ | AIMS scope definition | Structured narrative: boundaries, AI systems in scope, roles |
28
+ | AI risk/impact assessment | Risk register table or structured narrative with likelihood × severity |
29
+ | Policy generation | Full structured policy with document control block, scope, objectives, review date |
30
+ | Control implementation guidance | Purpose → Requirements → Implementation Steps → Evidence → Audit Tips |
31
+ | SoA for AI | Table: Control ID \| Control Name \| Applicable? \| Justification \| Implementation Status |
32
+ | Certification readiness | Stage 1 / Stage 2 checklist with RAG status |
33
+ | General question | Clear, concise prose with clause/control citations |
34
+
35
+ Always cite the specific clause or Annex A control (e.g., Clause 6.1.2, A.4.3) in all outputs.
36
+
37
+ ---
38
+
39
+ ## Standard Overview
40
+
41
+ **ISO/IEC 42001:2023** was published on **18 December 2023** — the world's first international standard for AI Management Systems. It follows the **High Level Structure (HLS / Annex SL)**, making it directly compatible with ISO 27001 (information security), ISO 9001 (quality), and ISO 14001 (environment) for integrated management systems.
42
+
43
+ ### Who It Applies To
44
+ - **AI providers**: organisations that develop, train, deploy, or maintain AI systems for others or for internal use
45
+ - **AI users**: organisations that integrate or use AI systems developed by third parties
46
+ - **Any size**: scalable for startups through enterprises; sector-agnostic
47
+
48
+ ### Key Unique Elements vs Other ISO Standards
49
+ | Element | ISO 42001 Specific |
50
+ |---------|-------------------|
51
+ | AI system impact assessment (AISIA) | Required — assess societal and individual impacts |
52
+ | AI risk assessment | Separate from general organisational risk — AI-specific likelihood × severity |
53
+ | AI objectives | Must be measurable and linked to responsible AI principles |
54
+ | Intended purpose | Must be documented for each AI system in scope |
55
+ | Human oversight | Controls required for all AI decision-making affecting individuals |
56
+ | Data quality | Specific controls for training, validation, test data quality |
57
+ | Transparency | Disclosure obligations tied to AI system impact level |
58
+
59
+ ---
60
+
61
+ ## Clause Structure (Mandatory — Clauses 4–10)
62
+
63
+ | Clause | Title | Key Deliverables |
64
+ |--------|-------|-----------------|
65
+ | 4 | Context of the Organisation | AIMS scope document, stakeholder register, interested party needs, AI system register |
66
+ | 5 | Leadership | AI policy (signed by top management), roles and responsibilities (RACI), management commitment evidence |
67
+ | 6 | Planning | AI risk assessment, AI system impact assessment (AISIA), AIMS objectives, plan to achieve objectives |
68
+ | 7 | Support | Competence records, awareness programme, communication plan, documented information procedure |
69
+ | 8 | Operation | Executed AI risk assessments, AI system lifecycle controls, supplier AI assessments, incident records |
70
+ | 9 | Performance Evaluation | Internal audit programme, audit reports, management review minutes, metrics/KPIs |
71
+ | 10 | Improvement | Nonconformity log, corrective action records, continual improvement register |
72
+
73
+ For full Annex A controls → read `references/iso42001-controls-annex-a.md`
74
+ For detailed clause requirements → read `references/iso42001-clauses-requirements.md`
75
+ For AI risk and impact assessment methodology → read `references/iso42001-ai-risk-assessment.md`
76
+
77
+ ---
78
+
79
+ ## Core Workflows
80
+
81
+ ### 1. Gap Assessment (Most Common Starting Point)
82
+
83
+ **Inputs needed from user:** Organisation role (provider/user/both), AI systems in scope (brief description), current documentation/controls in place, target certification timeline.
84
+
85
+ **Process:**
86
+ 1. Assess mandatory clause compliance (4–10) — flag missing required documents
87
+ 2. Assess Annex A control applicability and implementation status
88
+ 3. Identify SoA gaps (controls applicable but not yet implemented)
89
+ 4. Produce prioritised remediation roadmap (30/60/90 days + strategic)
90
+
91
+ **Output format:**
92
+ ```
93
+ CLAUSE/CONTROL | REQUIREMENT | STATUS | EVIDENCE NEEDED | GAP/ACTION
94
+ 4.1 | Context documented | 🔴 Not started | Context analysis (PESTLE or equivalent) | Identify external/internal issues relevant to AI governance
95
+ 4.3 | AIMS scope defined | 🔴 Not started | AIMS Scope doc | Define AI system boundary, inclusions, exclusions, and justification
96
+ 6.1.2 | AI risk assessment | 🟡 Partial | Risk register | Expand to cover all in-scope AI systems
97
+ A.2.2 | AI policy | 🟢 Implemented | Signed policy doc | Review against 42001 requirements
98
+ ```
99
+
100
+ ### 2. AI System Impact Assessment (AISIA)
101
+
102
+ The AISIA is a **mandatory** process under Clause 6.1.2. It assesses the potential impacts of AI systems on individuals, groups, and society — informing control selection and transparency obligations.
103
+
104
+ **AISIA dimensions to assess:**
105
+ - **Intended purpose**: what the AI system is designed to do
106
+ - **Output type**: decision support / autonomous decision / content generation / classification / prediction / recommendation
107
+ - **Impact domain**: employment, healthcare, financial services, law enforcement, education, public safety, other
108
+ - **Affected population**: scale, vulnerability of individuals impacted
109
+ - **Severity**: consequence if AI system fails, produces bias, or is misused
110
+ - **Reversibility**: can harms be corrected?
111
+ - **Human oversight available**: is a human in the loop?
112
+
113
+ **AISIA impact classification:**
114
+ | Level | Description | Control implication |
115
+ |-------|-------------|-------------------|
116
+ | Low | Limited, easily reversible impact on non-vulnerable individuals | Standard controls apply |
117
+ | Medium | Moderate impact, partially reversible, some vulnerable individuals | Enhanced transparency + human oversight |
118
+ | High | Significant, hard-to-reverse impact on vulnerable individuals or society | Maximum controls — mandatory human review, full transparency disclosure, formal right to challenge AI decisions |
119
+
120
+ ### 3. AI Risk Assessment
121
+
122
+ Separate from the AISIA (which is impact-focused), the AI risk assessment evaluates **likelihood × severity** of risks specific to AI systems:
123
+
124
+ **Risk categories to address:**
125
+ - **Model risks**: bias, unfairness, hallucination, model drift, adversarial attacks
126
+ - **Data risks**: training data quality, data poisoning, privacy violations in training data
127
+ - **Operational risks**: system failure, unexpected outputs, scope creep
128
+ - **Supply chain risks**: third-party AI model risks, API dependency, provider lock-in
129
+ - **Societal risks**: discriminatory outcomes, erosion of human autonomy, misinformation
130
+
131
+ **Risk treatment options (aligned to Clause 6.1.3):**
132
+ - Modify the AI system (retrain, add guardrails, change architecture)
133
+ - Accept with monitoring (continuous monitoring + defined thresholds)
134
+ - Avoid (do not deploy the AI system for this use case)
135
+ - Transfer (contractual obligations to AI provider via Annex A.10 controls — specifically A.10.3 Suppliers)
136
+
137
+ ### 4. Statement of Applicability (SoA) for AI
138
+
139
+ Generate a SoA table covering all Annex A controls across domains A.2–A.10 (38 controls total):
140
+
141
+ **SoA format:**
142
+ ```
143
+ Control ID | Control Name | Applicable? | Justification | Implementation Status | Evidence Reference
144
+ A.2.2 | AI policy | Yes | Required for all AIMS | Implemented | AI-POL-001
145
+ A.4.3 | Data resources | Yes | Provider role — training data governance | In progress | N/A
146
+ A.9.2 | Processes for responsible use of AI systems | Yes | AI user role | Planned | N/A
147
+ ```
148
+
149
+ For all 38 controls with descriptions → read `references/iso42001-controls-annex-a.md`
150
+
151
+ ### 5. Policy Generation
152
+
153
+ **Core AIMS policies required:**
154
+ - AI Policy (Clause 5.2) — overarching commitment, scope, principles, top management signature
155
+ - AI Risk Management Policy (Clause 6) — risk assessment methodology, frequency, ownership
156
+ - AI Acceptable Use Policy (A.9.2) — permitted and prohibited AI uses, user obligations
157
+ - Data Governance for AI Policy (A.7) — training data quality, data sourcing, retention, bias controls
158
+ - AI Incident/Reporting Policy (A.8.4) — incident classification, reporting, response, post-incident review
159
+ - AI System Lifecycle Policy (A.6) — development, testing, deployment, monitoring
160
+ - AI Third-Party and Supplier Policy (A.10.3) — third-party AI provider due diligence, contractual clauses
161
+
162
+ **Policy document structure (use for all):**
163
+ ```
164
+ [Organisation Name] — [Policy Name]
165
+ Document ID: [ID] | Version: 1.0 | Owner: [Role] | Approved by: [Title]
166
+ Effective Date: [Date] | Next Review: [Date +1yr]
167
+
168
+ 1. Purpose and Scope
169
+ 2. Policy Statement
170
+ 3. Roles and Responsibilities
171
+ 4. Requirements [clause/control-specific]
172
+ 5. Monitoring and Compliance
173
+ 6. Related Documents
174
+ 7. Revision History
175
+ ```
176
+
177
+ ---
178
+
179
+ ## Certification Pathway
180
+
181
+ ### Stage 1 Audit (Documentation Review)
182
+ Auditor reviews: AIMS scope, AI policy, risk assessment records, AISIA records, SoA, objectives, documented information controls. Typical duration: 0.5–1 day for small organisations.
183
+
184
+ **Stage 1 readiness checklist:**
185
+ - [ ] AIMS scope document (Clause 4.3)
186
+ - [ ] AI policy signed by top management (Clause 5.2)
187
+ - [ ] AI system register (all systems in scope listed)
188
+ - [ ] AI risk assessment completed for all in-scope systems (Clause 6.1.2)
189
+ - [ ] AISIA completed for all in-scope systems (Clause 6.1.2)
190
+ - [ ] Statement of Applicability (SoA) covering all applicable Annex A controls (A.2–A.10)
191
+ - [ ] AIMS objectives documented and measurable (Clause 6.2)
192
+ - [ ] Internal audit programme (Clause 9.2)
193
+ - [ ] Management review agenda template (Clause 9.3)
194
+
195
+ ### Stage 2 Audit (Implementation Verification)
196
+ Auditor tests that controls work in practice: interviews staff, reviews evidence, samples AI system records, tests incident response. Typical duration: 1–3 days depending on scope.
197
+
198
+ **Stage 2 evidence required:**
199
+ - Executed AI risk assessments with treatment decisions
200
+ - AISIA records for each in-scope AI system
201
+ - Competence records and AI awareness training logs
202
+ - Supplier AI assessment records (for AI users/providers relying on third parties)
203
+ - Incident log (even if no incidents — demonstrate the process works)
204
+ - Internal audit report and management review minutes
205
+ - Corrective action records for any nonconformities
206
+
207
+ ### Surveillance Audits
208
+ Annual — auditor verifies continued compliance and improvement. Recertification every 3 years.
209
+
210
+ ---
211
+
212
+ ## Integration with Other Management Systems
213
+
214
+ ISO 42001 uses HLS so it integrates cleanly:
215
+
216
+ | ISO Standard | Integration Point |
217
+ |-------------|-----------------|
218
+ | ISO 27001:2022 | A.7 (data governance) maps to ISO 27001 Annex A.8 (technological controls); AI incident management links to 27001 Annex A.5.24–A.5.28 (incident management controls); supplier AI risk maps to 27001 A.5.19–A.5.22 |
219
+ | ISO 9001:2015 | Quality management processes (Clause 8) align with AI lifecycle; PDCA cycle shared |
220
+ | ISO 31000 | AI risk assessment methodology aligns with ISO 31000 risk framework |
221
+ | NIST AI RMF | Four core functions (Govern, Map, Measure, Manage) map to 42001 clauses and Annex A |
222
+ | EU AI Act | High-risk AI system requirements align closely with 42001 AISIA and Annex A controls; 42001 certification may support EU AI Act conformity |
223
+
224
+ ---
225
+
226
+ ## Common Gap Areas (What Organisations Typically Miss)
227
+
228
+ 1. **AISIA not completed** for all in-scope AI systems — organisations often skip this or treat it as a one-off
229
+ 2. **AI system register incomplete** — not all AI tools (including SaaS AI features) captured in scope
230
+ 3. **Data governance for AI** (Annex A.7) — training data quality, bias testing, and data provenance often undocumented
231
+ 4. **Human oversight documentation** — no formal records of when and how humans review AI outputs
232
+ 5. **Supplier AI assessments** (A.10.3) — third-party AI providers not assessed; no contractual AI-specific clauses
233
+ 6. **Incident management not extended to AI** — existing IT incident processes not updated for AI-specific scenarios (bias incidents, unexpected outputs, model drift)
234
+ 7. **AI objectives not measurable** — policy states responsible AI principles without specific, measurable targets
235
+
236
+ ---
237
+
238
+ ## Key Terminology
239
+
240
+ | Term | Definition |
241
+ |------|-----------|
242
+ | AIMS | AI Management System — the overarching governance framework for managing AI |
243
+ | AISIA | AI System Impact Assessment — mandatory assessment of societal/individual impacts |
244
+ | AI provider | Organisation that develops, trains, or deploys AI systems for others |
245
+ | AI user | Organisation that integrates or uses AI systems from a provider |
246
+ | Intended purpose | Documented specification of what an AI system is designed to do |
247
+ | AI system | Machine-based system that generates outputs (predictions, decisions, content) from input data |
248
+ | Human oversight | Mechanisms ensuring humans can monitor, intervene in, or override AI outputs |
249
+ | Responsible AI | Ethical, transparent, fair, accountable, and safe AI development and use |
250
+ | SoA | Statement of Applicability — document justifying inclusion/exclusion of each control |
251
+ | HLS | High Level Structure — ISO management system structure enabling multi-standard integration |