bmad-plus 0.7.4 → 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 -407
  2. package/LICENSE +21 -0
  3. package/README.md +555 -446
  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 -175
  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,258 +1,258 @@
1
- # ISO/IEC 42001:2023 — AI Risk Assessment & AISIA Methodology
2
-
3
- This reference covers the two mandatory assessments under Clause 6.1.2:
4
- 1. **AI Risk Assessment** — evaluates risks to the organisation from AI systems
5
- 2. **AI System Impact Assessment (AISIA)** — evaluates risks to individuals and society from AI systems
6
-
7
- Both must be completed for every AI system in scope. Both must be maintained and updated over time.
8
-
9
- ---
10
-
11
- ## Part 1: AI Risk Assessment
12
-
13
- ### Purpose
14
- Identify, analyse, and evaluate risks associated with AI systems so that appropriate treatment decisions can be made. This is a **risk-to-the-organisation** lens (complement to the AISIA which takes a societal/individual lens).
15
-
16
- ### Risk Assessment Framework
17
-
18
- **Step 1: Identify AI Risks**
19
-
20
- For each AI system in scope, identify risks across these categories:
21
-
22
- #### Model Risks
23
- | Risk | Description | Example |
24
- |------|-------------|---------|
25
- | Bias and unfairness | Model produces systematically different outputs for protected groups | Loan approval AI approves at lower rates for certain demographic groups |
26
- | Hallucination / confabulation | Model generates plausible-sounding but incorrect outputs | LLM generates false legal citations |
27
- | Model drift | Model performance degrades as real-world data distribution shifts | Fraud detection model misses new fraud patterns 12 months post-deployment |
28
- | Adversarial attacks | Inputs crafted to manipulate model outputs | Adversarial examples cause image classifier to misclassify |
29
- | Model inversion | Training data can be reconstructed from model outputs | Privacy violation — personal data extracted from model |
30
- | Overfitting | Model performs well in testing but poorly in production | High accuracy in evaluation, low accuracy on live data |
31
-
32
- #### Data Risks
33
- | Risk | Description | Example |
34
- |------|-------------|---------|
35
- | Training data quality | Poor quality data leads to poor model performance | Incomplete labels cause systematic errors |
36
- | Data poisoning | Attacker inserts malicious training data to manipulate model behaviour | Supply chain compromise of training dataset |
37
- | Privacy in training data | Training data contains PII or sensitive data unlawfully | Medical data used for AI training without lawful basis |
38
- | Data representativeness | Training data doesn't represent the deployment population | Model trained on US data deployed globally — cultural bias |
39
- | Data provenance gaps | Origin and rights for training data unknown | Copyright or licence violations in training data |
40
-
41
- #### Operational Risks
42
- | Risk | Description | Example |
43
- |------|-------------|---------|
44
- | Unintended use | AI system used for purposes not covered by AISIA | Internal HR tool used to screen job applicants |
45
- | System failure | AI system becomes unavailable or produces errors at scale | API outage causes customer-facing decisions to fail |
46
- | Scope creep | AI system expanded to new use cases without re-assessment | Chatbot expanded to give medical advice without clinical review |
47
- | Human over-reliance | Users accept AI outputs without appropriate scrutiny | Staff approve AI recommendations without verification |
48
- | Lack of explainability | Cannot explain AI decisions to affected individuals | Automated rejection letter with no basis provided |
49
-
50
- #### Supply Chain Risks
51
- | Risk | Description | Example |
52
- |------|-------------|---------|
53
- | Third-party model risk | Pre-trained model from vendor contains bias or backdoor | Open-source LLM used without bias evaluation |
54
- | API dependency | AI functionality depends on external API with reliability risk | Vendor changes model behaviour mid-contract |
55
- | Vendor lock-in | Cannot switch AI provider without major operational disruption | All AI inference tied to single cloud provider |
56
- | Third-party data handling | AI vendor handles sensitive data — data protection risk | Vendor uses customer data to retrain models without consent |
57
-
58
- #### Regulatory and Reputational Risks
59
- | Risk | Description | Example |
60
- |------|-------------|---------|
61
- | Regulatory non-compliance | AI system violates applicable law | EU AI Act high-risk AI system deployed without conformity assessment |
62
- | Reputational harm | AI system behaviour causes public trust damage | Discriminatory AI hiring tool exposed in media |
63
- | Liability | Organisation liable for AI system harm to individuals | AI medical diagnosis system misses condition — clinical liability |
64
-
65
- ---
66
-
67
- ### Step 2: Assess Risk Likelihood and Severity
68
-
69
- **Likelihood scale:**
70
- | Score | Level | Definition |
71
- |-------|-------|-----------|
72
- | 1 | Rare | May occur only in exceptional circumstances (<5% probability in system lifecycle) |
73
- | 2 | Unlikely | Could occur but not expected (5–25% probability) |
74
- | 3 | Possible | Might occur at some point (25–50% probability) |
75
- | 4 | Likely | Will probably occur in most circumstances (50–80% probability) |
76
- | 5 | Almost certain | Expected to occur frequently (>80% probability) |
77
-
78
- **Severity scale:**
79
- | Score | Level | Definition |
80
- |-------|-------|-----------|
81
- | 1 | Negligible | No meaningful harm; easily corrected |
82
- | 2 | Minor | Limited impact; correctable with minor effort |
83
- | 3 | Moderate | Significant but recoverable harm; some operational disruption |
84
- | 4 | Major | Serious harm; difficult to reverse; significant operational or reputational impact |
85
- | 5 | Critical | Catastrophic harm; irreversible; severe regulatory, legal, financial, or societal impact |
86
-
87
- **Risk score = Likelihood × Severity**
88
-
89
- **Risk rating matrix:**
90
- ```
91
- Severity → 1-Neg 2-Minor 3-Mod 4-Major 5-Crit
92
- Likelihood ↓
93
- 1-Rare 1 2 3 4 5
94
- 2-Unlikely 2 4 6 8 10
95
- 3-Possible 3 6 9 12 15
96
- 4-Likely 4 8 12 16 20
97
- 5-Almost 5 10 15 20 25
98
- ```
99
-
100
- | Score range | Rating | Treatment |
101
- |------------|--------|-----------|
102
- | 1–4 | Low | Monitor; accept with documented rationale |
103
- | 5–9 | Medium | Implement controls; review quarterly |
104
- | 10–16 | High | Priority treatment required; management sign-off |
105
- | 17–25 | Critical | Immediate treatment; may need to halt AI system until controlled |
106
-
107
- ---
108
-
109
- ### Step 3: Select Risk Treatment
110
-
111
- For each identified risk with rating Medium or above:
112
-
113
- | Treatment Option | When to Use | Controls to Apply |
114
- |----------------|------------|------------------|
115
- | **Modify the AI system** | Risk is inherent to current design | Retrain with better data, add guardrails, change architecture, implement bias mitigation |
116
- | **Add operational controls** | Risk can be managed through process | Human review checkpoints, output filtering, monitoring, incident alerting |
117
- | **Accept with monitoring** | Residual risk is acceptable; monitoring can detect materialisation | Document acceptance decision with senior sign-off; define alert thresholds |
118
- | **Avoid** | Risk cannot be reduced to acceptable level | Do not deploy AI for this use case; find non-AI alternative |
119
- | **Transfer** | Third-party better placed to manage | Contractual liability allocation; insurance; require vendor indemnification (A.10.2 Allocating responsibilities, A.10.3 Suppliers) |
120
-
121
- ---
122
-
123
- ### Step 4: Document the AI Risk Register
124
-
125
- **Required fields per risk entry:**
126
- ```
127
- Risk ID | AI System | Risk Category | Risk Description | Likelihood | Severity | Score | Rating | Treatment | Control(s) Applied | Residual Risk | Owner | Review Date
128
- ```
129
-
130
- **Example entry:**
131
- ```
132
- R-001 | Loan_Approval_Model_v2 | Model - Bias | Model may produce discriminatory outcomes for applicants by protected characteristic | 3 | 5 | 15 | High | Modify: implement fairness-aware retraining + quarterly demographic disparity monitoring | A.5.4, A.5.5, A.6.2.4, A.6.2.6 | Medium (score 6) after treatment | AI Risk Owner - Credit | Q2 2025
133
- ```
134
-
135
- ---
136
-
137
- ## Part 2: AI System Impact Assessment (AISIA)
138
-
139
- ### Purpose
140
- The AISIA takes a **stakeholder and societal lens** — it assesses impacts on individuals, groups, and society from the AI system's outputs and decisions. This is mandatory under Clause 6.1.2 and directly referenced in Annex A.5 (controls A.5.2–A.5.5).
141
-
142
- ### When to Conduct an AISIA
143
- - **Before initial deployment** of any AI system in scope
144
- - **When the AI system changes** significantly (new use case, new population, new output type)
145
- - **When operating context changes** (new regulation, new demographic affected)
146
- - **On a scheduled review cycle** (annually recommended for medium/high impact systems)
147
-
148
- ---
149
-
150
- ### AISIA Step-by-Step Process
151
-
152
- **Step 1: Document the AI System**
153
- | Field | Content |
154
- |-------|---------|
155
- | AI system name and version | |
156
- | AI system owner | |
157
- | Intended purpose | What the system is designed to do |
158
- | Output type | Decision support / Autonomous decision / Content generation / Classification / Prediction / Recommendation / Other |
159
- | Inputs | What data is fed into the system |
160
- | Deployment context | Where and how used — internal/customer-facing/regulatory context |
161
- | Operating conditions | Conditions under which system is expected to perform correctly |
162
-
163
- **Step 2: Identify Affected Populations**
164
- | Population | How Affected | Vulnerability |
165
- |-----------|-------------|--------------|
166
- | Identify all groups whose rights, opportunities, or wellbeing may be affected by AI outputs | | |
167
-
168
- Vulnerability factors: age (children/elderly), disability, socioeconomic status, minority group membership, limited AI literacy, power imbalance (employer/employee; government/citizen).
169
-
170
- **Step 3: Assess Impact Dimensions**
171
-
172
- For each affected population, assess:
173
-
174
- | Dimension | Questions to Ask |
175
- |-----------|----------------|
176
- | **Nature of impact** | What kind of harm could occur? Financial, physical, psychological, reputational, loss of rights, discrimination? |
177
- | **Severity** | How serious is the worst-case impact? |
178
- | **Breadth** | How many individuals could be affected? |
179
- | **Reversibility** | Can the harm be corrected if the AI system makes an error? |
180
- | **Duration** | Is the impact short-term or long-lasting? |
181
- | **Consent and awareness** | Are affected individuals aware AI is being used? Did they consent? |
182
- | **Human oversight** | Is there a meaningful human review of AI outputs before they affect individuals? |
183
- | **Recourse** | Can individuals challenge AI decisions? Is there an appeal process? |
184
-
185
- **Step 4: Classify Impact Level**
186
-
187
- | Level | Criteria | Examples |
188
- |-------|----------|---------|
189
- | **Low** | Limited impact; easily reversible; non-vulnerable individuals; AI is advisory only; robust human oversight | Product recommendation engine; internal productivity tool |
190
- | **Medium** | Moderate impact; partially reversible; some vulnerable individuals may be affected; AI has significant weight in decisions | Customer service routing; content moderation; credit risk scoring with human review |
191
- | **High** | Significant impact; hard-to-reverse; vulnerable individuals; AI drives decisions with limited human review; affects fundamental rights | Automated hiring decisions; medical diagnosis AI; benefits eligibility AI; criminal risk scoring; biometric identification |
192
-
193
- **Step 5: Determine Control Requirements Based on Impact Level**
194
-
195
- | Control Area | Low Impact | Medium Impact | High Impact |
196
- |-------------|-----------|--------------|-------------|
197
- | Transparency (A.8.2, A.8.5) | General notice that AI is used | Inform affected individuals; describe what AI does | Full disclosure; right to explanation; right to human review |
198
- | Human oversight (A.6.2.6) | Human oversight available on request | Structured human review for edge cases | Mandatory human review of all consequential AI outputs |
199
- | Verification & bias testing (A.6.2.4, A.7.4) | Basic performance testing | Fairness testing before deployment | Ongoing fairness monitoring with demographic breakdown |
200
- | Documentation (A.6.2.7, A.5.3) | Technical documentation | Technical + user-facing documentation | Full model card; audit trail per decision |
201
- | Monitoring (A.6.2.6, A.6.2.8) | Annual performance review | Quarterly monitoring | Continuous monitoring with automated alerts |
202
- | Recourse mechanism | General complaints process | AI-specific appeal process | Formal right to challenge AI decisions; human decision-maker available |
203
- | AISIA review cycle (A.5.2) | Every 3 years or at major change | Annually or at significant change | Every 6 months or at any change |
204
-
205
- **Step 6: Document AISIA Findings**
206
-
207
- **AISIA Record format:**
208
- ```
209
- AISIA ID: AISIA-[number]
210
- AI System: [name and version]
211
- Assessment Date: [date]
212
- Assessor: [name/role]
213
- Review Date: [date]
214
-
215
- 1. AI System Description
216
- 2. Intended Purpose
217
- 3. Output Type
218
- 4. Affected Populations (table)
219
- 5. Impact Assessment (per population)
220
- 6. Impact Classification: [Low / Medium / High]
221
- 7. Controls Selected (with references to Annex A)
222
- 8. Residual Impact Assessment
223
- 9. Approval: [AI Risk Owner signature / date]
224
- 10. AISIA Review Schedule
225
- ```
226
-
227
- ---
228
-
229
- ## Part 3: Relationship Between AI Risk Assessment and AISIA
230
-
231
- | Dimension | AI Risk Assessment | AISIA |
232
- |-----------|-------------------|-------|
233
- | **Primary lens** | Organisational risk | Individual and societal impact |
234
- | **Key question** | What could go wrong for the organisation? | Who could be harmed and how? |
235
- | **Output** | Risk register; risk treatment plan | Impact classification; control requirements |
236
- | **Feeds into** | SoA control selection; risk treatment plan | Transparency obligations; human oversight design |
237
- | **Mandatory** | Yes (Clause 6.1.2) | Yes (Clause 6.1.2) |
238
- | **Repeated when** | AI system changes; annually recommended | AI system changes; on defined review cycle |
239
-
240
- **Important:** A risk that is Low for the organisation may be High impact for individuals (e.g., an AI system with low organisational risk of failure but high impact on vulnerable individuals when it does fail). Both assessments are always required — one does not substitute for the other.
241
-
242
- ---
243
-
244
- ## Part 4: Integration with EU AI Act
245
-
246
- ISO 42001 AISIA aligns closely with **EU AI Act Fundamental Rights Impact Assessment (FRIA)** requirements for high-risk AI systems. Organisations preparing for EU AI Act compliance can use their 42001 AISIA as a foundation — extending it to cover the specific FRIA requirements for EU high-risk AI system categories:
247
-
248
- | EU AI Act Category | ISO 42001 AISIA Overlap |
249
- |-------------------|------------------------|
250
- | Biometric identification | High impact → maximum controls → maps directly |
251
- | Critical infrastructure management | High impact |
252
- | Education/vocational training | Medium-High impact |
253
- | Employment and worker management | High impact (especially automated decisions) |
254
- | Access to essential services | High impact |
255
- | Law enforcement | High impact |
256
- | Migration/asylum/border control | High impact |
257
- | Justice/democratic processes | High impact |
258
- | General purpose AI (GPAI) | A.6.2.7 technical documentation; A.8.2 and A.8.5 transparency |
1
+ # ISO/IEC 42001:2023 — AI Risk Assessment & AISIA Methodology
2
+
3
+ This reference covers the two mandatory assessments under Clause 6.1.2:
4
+ 1. **AI Risk Assessment** — evaluates risks to the organisation from AI systems
5
+ 2. **AI System Impact Assessment (AISIA)** — evaluates risks to individuals and society from AI systems
6
+
7
+ Both must be completed for every AI system in scope. Both must be maintained and updated over time.
8
+
9
+ ---
10
+
11
+ ## Part 1: AI Risk Assessment
12
+
13
+ ### Purpose
14
+ Identify, analyse, and evaluate risks associated with AI systems so that appropriate treatment decisions can be made. This is a **risk-to-the-organisation** lens (complement to the AISIA which takes a societal/individual lens).
15
+
16
+ ### Risk Assessment Framework
17
+
18
+ **Step 1: Identify AI Risks**
19
+
20
+ For each AI system in scope, identify risks across these categories:
21
+
22
+ #### Model Risks
23
+ | Risk | Description | Example |
24
+ |------|-------------|---------|
25
+ | Bias and unfairness | Model produces systematically different outputs for protected groups | Loan approval AI approves at lower rates for certain demographic groups |
26
+ | Hallucination / confabulation | Model generates plausible-sounding but incorrect outputs | LLM generates false legal citations |
27
+ | Model drift | Model performance degrades as real-world data distribution shifts | Fraud detection model misses new fraud patterns 12 months post-deployment |
28
+ | Adversarial attacks | Inputs crafted to manipulate model outputs | Adversarial examples cause image classifier to misclassify |
29
+ | Model inversion | Training data can be reconstructed from model outputs | Privacy violation — personal data extracted from model |
30
+ | Overfitting | Model performs well in testing but poorly in production | High accuracy in evaluation, low accuracy on live data |
31
+
32
+ #### Data Risks
33
+ | Risk | Description | Example |
34
+ |------|-------------|---------|
35
+ | Training data quality | Poor quality data leads to poor model performance | Incomplete labels cause systematic errors |
36
+ | Data poisoning | Attacker inserts malicious training data to manipulate model behaviour | Supply chain compromise of training dataset |
37
+ | Privacy in training data | Training data contains PII or sensitive data unlawfully | Medical data used for AI training without lawful basis |
38
+ | Data representativeness | Training data doesn't represent the deployment population | Model trained on US data deployed globally — cultural bias |
39
+ | Data provenance gaps | Origin and rights for training data unknown | Copyright or licence violations in training data |
40
+
41
+ #### Operational Risks
42
+ | Risk | Description | Example |
43
+ |------|-------------|---------|
44
+ | Unintended use | AI system used for purposes not covered by AISIA | Internal HR tool used to screen job applicants |
45
+ | System failure | AI system becomes unavailable or produces errors at scale | API outage causes customer-facing decisions to fail |
46
+ | Scope creep | AI system expanded to new use cases without re-assessment | Chatbot expanded to give medical advice without clinical review |
47
+ | Human over-reliance | Users accept AI outputs without appropriate scrutiny | Staff approve AI recommendations without verification |
48
+ | Lack of explainability | Cannot explain AI decisions to affected individuals | Automated rejection letter with no basis provided |
49
+
50
+ #### Supply Chain Risks
51
+ | Risk | Description | Example |
52
+ |------|-------------|---------|
53
+ | Third-party model risk | Pre-trained model from vendor contains bias or backdoor | Open-source LLM used without bias evaluation |
54
+ | API dependency | AI functionality depends on external API with reliability risk | Vendor changes model behaviour mid-contract |
55
+ | Vendor lock-in | Cannot switch AI provider without major operational disruption | All AI inference tied to single cloud provider |
56
+ | Third-party data handling | AI vendor handles sensitive data — data protection risk | Vendor uses customer data to retrain models without consent |
57
+
58
+ #### Regulatory and Reputational Risks
59
+ | Risk | Description | Example |
60
+ |------|-------------|---------|
61
+ | Regulatory non-compliance | AI system violates applicable law | EU AI Act high-risk AI system deployed without conformity assessment |
62
+ | Reputational harm | AI system behaviour causes public trust damage | Discriminatory AI hiring tool exposed in media |
63
+ | Liability | Organisation liable for AI system harm to individuals | AI medical diagnosis system misses condition — clinical liability |
64
+
65
+ ---
66
+
67
+ ### Step 2: Assess Risk Likelihood and Severity
68
+
69
+ **Likelihood scale:**
70
+ | Score | Level | Definition |
71
+ |-------|-------|-----------|
72
+ | 1 | Rare | May occur only in exceptional circumstances (<5% probability in system lifecycle) |
73
+ | 2 | Unlikely | Could occur but not expected (5–25% probability) |
74
+ | 3 | Possible | Might occur at some point (25–50% probability) |
75
+ | 4 | Likely | Will probably occur in most circumstances (50–80% probability) |
76
+ | 5 | Almost certain | Expected to occur frequently (>80% probability) |
77
+
78
+ **Severity scale:**
79
+ | Score | Level | Definition |
80
+ |-------|-------|-----------|
81
+ | 1 | Negligible | No meaningful harm; easily corrected |
82
+ | 2 | Minor | Limited impact; correctable with minor effort |
83
+ | 3 | Moderate | Significant but recoverable harm; some operational disruption |
84
+ | 4 | Major | Serious harm; difficult to reverse; significant operational or reputational impact |
85
+ | 5 | Critical | Catastrophic harm; irreversible; severe regulatory, legal, financial, or societal impact |
86
+
87
+ **Risk score = Likelihood × Severity**
88
+
89
+ **Risk rating matrix:**
90
+ ```
91
+ Severity → 1-Neg 2-Minor 3-Mod 4-Major 5-Crit
92
+ Likelihood ↓
93
+ 1-Rare 1 2 3 4 5
94
+ 2-Unlikely 2 4 6 8 10
95
+ 3-Possible 3 6 9 12 15
96
+ 4-Likely 4 8 12 16 20
97
+ 5-Almost 5 10 15 20 25
98
+ ```
99
+
100
+ | Score range | Rating | Treatment |
101
+ |------------|--------|-----------|
102
+ | 1–4 | Low | Monitor; accept with documented rationale |
103
+ | 5–9 | Medium | Implement controls; review quarterly |
104
+ | 10–16 | High | Priority treatment required; management sign-off |
105
+ | 17–25 | Critical | Immediate treatment; may need to halt AI system until controlled |
106
+
107
+ ---
108
+
109
+ ### Step 3: Select Risk Treatment
110
+
111
+ For each identified risk with rating Medium or above:
112
+
113
+ | Treatment Option | When to Use | Controls to Apply |
114
+ |----------------|------------|------------------|
115
+ | **Modify the AI system** | Risk is inherent to current design | Retrain with better data, add guardrails, change architecture, implement bias mitigation |
116
+ | **Add operational controls** | Risk can be managed through process | Human review checkpoints, output filtering, monitoring, incident alerting |
117
+ | **Accept with monitoring** | Residual risk is acceptable; monitoring can detect materialisation | Document acceptance decision with senior sign-off; define alert thresholds |
118
+ | **Avoid** | Risk cannot be reduced to acceptable level | Do not deploy AI for this use case; find non-AI alternative |
119
+ | **Transfer** | Third-party better placed to manage | Contractual liability allocation; insurance; require vendor indemnification (A.10.2 Allocating responsibilities, A.10.3 Suppliers) |
120
+
121
+ ---
122
+
123
+ ### Step 4: Document the AI Risk Register
124
+
125
+ **Required fields per risk entry:**
126
+ ```
127
+ Risk ID | AI System | Risk Category | Risk Description | Likelihood | Severity | Score | Rating | Treatment | Control(s) Applied | Residual Risk | Owner | Review Date
128
+ ```
129
+
130
+ **Example entry:**
131
+ ```
132
+ R-001 | Loan_Approval_Model_v2 | Model - Bias | Model may produce discriminatory outcomes for applicants by protected characteristic | 3 | 5 | 15 | High | Modify: implement fairness-aware retraining + quarterly demographic disparity monitoring | A.5.4, A.5.5, A.6.2.4, A.6.2.6 | Medium (score 6) after treatment | AI Risk Owner - Credit | Q2 2025
133
+ ```
134
+
135
+ ---
136
+
137
+ ## Part 2: AI System Impact Assessment (AISIA)
138
+
139
+ ### Purpose
140
+ The AISIA takes a **stakeholder and societal lens** — it assesses impacts on individuals, groups, and society from the AI system's outputs and decisions. This is mandatory under Clause 6.1.2 and directly referenced in Annex A.5 (controls A.5.2–A.5.5).
141
+
142
+ ### When to Conduct an AISIA
143
+ - **Before initial deployment** of any AI system in scope
144
+ - **When the AI system changes** significantly (new use case, new population, new output type)
145
+ - **When operating context changes** (new regulation, new demographic affected)
146
+ - **On a scheduled review cycle** (annually recommended for medium/high impact systems)
147
+
148
+ ---
149
+
150
+ ### AISIA Step-by-Step Process
151
+
152
+ **Step 1: Document the AI System**
153
+ | Field | Content |
154
+ |-------|---------|
155
+ | AI system name and version | |
156
+ | AI system owner | |
157
+ | Intended purpose | What the system is designed to do |
158
+ | Output type | Decision support / Autonomous decision / Content generation / Classification / Prediction / Recommendation / Other |
159
+ | Inputs | What data is fed into the system |
160
+ | Deployment context | Where and how used — internal/customer-facing/regulatory context |
161
+ | Operating conditions | Conditions under which system is expected to perform correctly |
162
+
163
+ **Step 2: Identify Affected Populations**
164
+ | Population | How Affected | Vulnerability |
165
+ |-----------|-------------|--------------|
166
+ | Identify all groups whose rights, opportunities, or wellbeing may be affected by AI outputs | | |
167
+
168
+ Vulnerability factors: age (children/elderly), disability, socioeconomic status, minority group membership, limited AI literacy, power imbalance (employer/employee; government/citizen).
169
+
170
+ **Step 3: Assess Impact Dimensions**
171
+
172
+ For each affected population, assess:
173
+
174
+ | Dimension | Questions to Ask |
175
+ |-----------|----------------|
176
+ | **Nature of impact** | What kind of harm could occur? Financial, physical, psychological, reputational, loss of rights, discrimination? |
177
+ | **Severity** | How serious is the worst-case impact? |
178
+ | **Breadth** | How many individuals could be affected? |
179
+ | **Reversibility** | Can the harm be corrected if the AI system makes an error? |
180
+ | **Duration** | Is the impact short-term or long-lasting? |
181
+ | **Consent and awareness** | Are affected individuals aware AI is being used? Did they consent? |
182
+ | **Human oversight** | Is there a meaningful human review of AI outputs before they affect individuals? |
183
+ | **Recourse** | Can individuals challenge AI decisions? Is there an appeal process? |
184
+
185
+ **Step 4: Classify Impact Level**
186
+
187
+ | Level | Criteria | Examples |
188
+ |-------|----------|---------|
189
+ | **Low** | Limited impact; easily reversible; non-vulnerable individuals; AI is advisory only; robust human oversight | Product recommendation engine; internal productivity tool |
190
+ | **Medium** | Moderate impact; partially reversible; some vulnerable individuals may be affected; AI has significant weight in decisions | Customer service routing; content moderation; credit risk scoring with human review |
191
+ | **High** | Significant impact; hard-to-reverse; vulnerable individuals; AI drives decisions with limited human review; affects fundamental rights | Automated hiring decisions; medical diagnosis AI; benefits eligibility AI; criminal risk scoring; biometric identification |
192
+
193
+ **Step 5: Determine Control Requirements Based on Impact Level**
194
+
195
+ | Control Area | Low Impact | Medium Impact | High Impact |
196
+ |-------------|-----------|--------------|-------------|
197
+ | Transparency (A.8.2, A.8.5) | General notice that AI is used | Inform affected individuals; describe what AI does | Full disclosure; right to explanation; right to human review |
198
+ | Human oversight (A.6.2.6) | Human oversight available on request | Structured human review for edge cases | Mandatory human review of all consequential AI outputs |
199
+ | Verification & bias testing (A.6.2.4, A.7.4) | Basic performance testing | Fairness testing before deployment | Ongoing fairness monitoring with demographic breakdown |
200
+ | Documentation (A.6.2.7, A.5.3) | Technical documentation | Technical + user-facing documentation | Full model card; audit trail per decision |
201
+ | Monitoring (A.6.2.6, A.6.2.8) | Annual performance review | Quarterly monitoring | Continuous monitoring with automated alerts |
202
+ | Recourse mechanism | General complaints process | AI-specific appeal process | Formal right to challenge AI decisions; human decision-maker available |
203
+ | AISIA review cycle (A.5.2) | Every 3 years or at major change | Annually or at significant change | Every 6 months or at any change |
204
+
205
+ **Step 6: Document AISIA Findings**
206
+
207
+ **AISIA Record format:**
208
+ ```
209
+ AISIA ID: AISIA-[number]
210
+ AI System: [name and version]
211
+ Assessment Date: [date]
212
+ Assessor: [name/role]
213
+ Review Date: [date]
214
+
215
+ 1. AI System Description
216
+ 2. Intended Purpose
217
+ 3. Output Type
218
+ 4. Affected Populations (table)
219
+ 5. Impact Assessment (per population)
220
+ 6. Impact Classification: [Low / Medium / High]
221
+ 7. Controls Selected (with references to Annex A)
222
+ 8. Residual Impact Assessment
223
+ 9. Approval: [AI Risk Owner signature / date]
224
+ 10. AISIA Review Schedule
225
+ ```
226
+
227
+ ---
228
+
229
+ ## Part 3: Relationship Between AI Risk Assessment and AISIA
230
+
231
+ | Dimension | AI Risk Assessment | AISIA |
232
+ |-----------|-------------------|-------|
233
+ | **Primary lens** | Organisational risk | Individual and societal impact |
234
+ | **Key question** | What could go wrong for the organisation? | Who could be harmed and how? |
235
+ | **Output** | Risk register; risk treatment plan | Impact classification; control requirements |
236
+ | **Feeds into** | SoA control selection; risk treatment plan | Transparency obligations; human oversight design |
237
+ | **Mandatory** | Yes (Clause 6.1.2) | Yes (Clause 6.1.2) |
238
+ | **Repeated when** | AI system changes; annually recommended | AI system changes; on defined review cycle |
239
+
240
+ **Important:** A risk that is Low for the organisation may be High impact for individuals (e.g., an AI system with low organisational risk of failure but high impact on vulnerable individuals when it does fail). Both assessments are always required — one does not substitute for the other.
241
+
242
+ ---
243
+
244
+ ## Part 4: Integration with EU AI Act
245
+
246
+ ISO 42001 AISIA aligns closely with **EU AI Act Fundamental Rights Impact Assessment (FRIA)** requirements for high-risk AI systems. Organisations preparing for EU AI Act compliance can use their 42001 AISIA as a foundation — extending it to cover the specific FRIA requirements for EU high-risk AI system categories:
247
+
248
+ | EU AI Act Category | ISO 42001 AISIA Overlap |
249
+ |-------------------|------------------------|
250
+ | Biometric identification | High impact → maximum controls → maps directly |
251
+ | Critical infrastructure management | High impact |
252
+ | Education/vocational training | Medium-High impact |
253
+ | Employment and worker management | High impact (especially automated decisions) |
254
+ | Access to essential services | High impact |
255
+ | Law enforcement | High impact |
256
+ | Migration/asylum/border control | High impact |
257
+ | Justice/democratic processes | High impact |
258
+ | General purpose AI (GPAI) | A.6.2.7 technical documentation; A.8.2 and A.8.5 transparency |