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,359 +1,359 @@
1
- # TSA CRMP — Detailed Requirements and Implementation Guidance
2
-
3
- Source: Based on publicly available TSA Security Directive summaries, Federal Register notices, and DHS/CISA publications.
4
-
5
- ---
6
-
7
- ## CRMP Component 1: Cybersecurity Implementation Plan (CIP) / COIP
8
-
9
- ### Purpose
10
- The CIP (or COIP under the NPRM) is the master compliance document that demonstrates how the covered entity implements and maintains all required cybersecurity measures. It must be submitted to TSA for review and approval.
11
-
12
- ### Required Sections
13
-
14
- **Section 1: Leadership and Accountability**
15
- - Identity of the Accountable Executive (named C-suite individual with authority over cybersecurity decisions and resources)
16
- - Identity of the Cybersecurity Coordinator (primary) and backup designee
17
- - Contact information for both (including 24/7 phone numbers)
18
- - Reporting structure between coordinator and accountable executive
19
-
20
- **Section 2: Critical Cyber System (CCS) Inventory**
21
- - Complete list of systems designated as Critical Cyber Systems
22
- - For each CCS: system name, type (IT/OT/ICS), function, owner, physical location, network zone
23
- - Methodology used for CCS determination
24
- - Process for updating the inventory when architecture changes
25
-
26
- **Section 3: Network Architecture Overview**
27
- - Current network topology diagrams (IT and OT — must be accurate and current)
28
- - Description of IT/OT boundary mechanisms (firewalls, DMZs, data diodes)
29
- - Remote access architecture into OT environments
30
- - Third-party and vendor connectivity to CCS
31
- - Identification of any legacy systems with limited segmentation capability
32
-
33
- **Section 4: Cybersecurity Measures (Four Technical Domains)**
34
-
35
- *Domain 1 — Network Segmentation:*
36
- - Segmentation policy and how it is enforced
37
- - Description of technical controls implementing the IT/OT boundary
38
- - Compensating controls for systems that cannot be fully segmented
39
- - Process for authorising exceptions
40
-
41
- *Domain 2 — Access Controls:*
42
- - Authentication requirements for CCS access (MFA for remote and privileged access)
43
- - Account lifecycle management (provisioning, review, de-provisioning)
44
- - Privileged access management approach
45
- - Third-party/vendor access controls
46
-
47
- *Domain 3 — Continuous Monitoring:*
48
- - Monitoring tools and coverage (IT and OT)
49
- - Log collection and retention policy
50
- - Alerting thresholds and escalation procedures
51
- - Integration with SOC or monitoring team
52
-
53
- *Domain 4 — Patch Management:*
54
- - Risk-based patch prioritisation methodology
55
- - Patch timelines by severity (critical, high, medium, low)
56
- - OT-specific patching process (vendor approval, testing, maintenance windows)
57
- - Compensating controls for unpatched legacy OT systems
58
-
59
- **Section 5: Incident Detection and Response**
60
- - High-level description of how incidents are detected (monitoring, alerting, user reporting)
61
- - Escalation path from detection to Cybersecurity Coordinator
62
- - Reference to the Cybersecurity Incident Response Plan (separate document)
63
- - CISA 24-hour reporting procedure
64
-
65
- **Section 6: Annual Review Process**
66
- - Frequency and process for reviewing and updating the CIP
67
- - Triggers for out-of-cycle review (major architecture change, significant incident, new threat intelligence)
68
- - Approval process for CIP updates
69
- - TSA submission process for material changes
70
-
71
- ### CIP Approval Process
72
- 1. Covered entity submits CIP to TSA via designated secure channel
73
- 2. TSA reviews for completeness and alignment with directive requirements
74
- 3. TSA may approve, request modifications, or reject
75
- 4. Entity implements CIP; cannot claim TSA-approved CIP until approval is granted
76
- 5. Material changes to CIP require resubmission
77
-
78
- ---
79
-
80
- ## CRMP Component 2: Incident Response Plan (IRP / CIRP)
81
-
82
- ### Required IRP Elements
83
-
84
- **1. Scope and Objectives**
85
- - What systems are covered (all CCS)
86
- - IRP objectives: contain, eradicate, recover, report
87
-
88
- **2. Roles and Responsibilities**
89
- - Incident Commander (typically Cybersecurity Coordinator)
90
- - IT response team
91
- - OT/ICS response team (may include OT vendor support)
92
- - Legal and communications (for regulatory reporting)
93
- - Executive escalation path
94
-
95
- **3. Incident Classification**
96
- Define severity tiers:
97
- | Tier | Definition | Response Time |
98
- |------|-----------|--------------|
99
- | Critical | Active threat to CCS operations/safety | Immediate — all hands |
100
- | High | Confirmed unauthorised access to CCS | Within 1 hour |
101
- | Medium | Suspected compromise; investigation underway | Within 4 hours |
102
- | Low | Indicator of compromise; no confirmed access | Within 24 hours |
103
-
104
- **4. Detection and Initial Analysis**
105
- - How anomalies are identified (monitoring alerts, user reports, third-party notification)
106
- - Initial triage process: confirm vs false positive
107
- - Evidence preservation from first moments
108
-
109
- **5. Containment Procedures**
110
- - IT containment: isolate affected systems from network
111
- - OT containment: procedures for isolating OT from IT (IT/OT segregation under incident conditions)
112
- - Manual operation fallback: how to operate OT assets if control systems are isolated
113
- - Preserve operational capability while containing cyber threat
114
-
115
- **6. Eradication and Recovery**
116
- - Threat removal procedures
117
- - Backup restoration: integrity verification before restoration
118
- - System rebuild and hardening before reconnecting
119
- - Phased return to operation
120
-
121
- **7. CISA and TSA Notification**
122
- - 24-hour CISA reporting trigger (see `tsa-incident-reporting.md`)
123
- - TSA notification procedure
124
- - Internal escalation to Accountable Executive
125
- - Regulatory notification log (record of all notifications made)
126
-
127
- **8. Post-Incident Review**
128
- - After-action review within 30 days of incident closure
129
- - Root cause analysis
130
- - Lessons learned documented
131
- - CIP/IRP updated based on findings
132
- - Consider sharing with CISA/ISAC
133
-
134
- ### Annual IRP Testing
135
-
136
- Covered entities must **test at least two IRP objectives annually**. Testing may be conducted via:
137
- - **Tabletop exercise**: Discussion-based walkthrough of a scenario (minimum viable testing)
138
- - **Functional exercise**: Partial activation of IRP with actual system interaction
139
- - **Full-scale exercise**: Complete IRP activation with IT/OT teams
140
-
141
- **Recommended test scenarios for TSA compliance**:
142
- 1. **IT/OT segregation drill**: Simulate IT compromise; test ability to isolate OT and continue operations manually
143
- 2. **Ransomware response drill**: Malware detected on IT; test containment, backup integrity check, restoration procedure
144
- 3. **Unauthorised access to OT**: Simulate credential compromise leading to OT access; test detection and response
145
- 4. **Vendor access abuse**: Simulate third-party remote access misuse; test detection and revocation
146
-
147
- **Test documentation required**:
148
- - Date and type of exercise
149
- - Scenario description
150
- - Participants
151
- - Objectives tested
152
- - Pass/fail for each objective
153
- - Findings and corrective actions
154
- - Corrective action closure tracking
155
-
156
- ---
157
-
158
- ## CRMP Component 3: Architecture Design Review (ADR)
159
-
160
- ### ADR Objectives
161
- 1. Confirm network diagrams are current, accurate, and complete
162
- 2. Assess effectiveness of IT/OT segmentation
163
- 3. Identify undocumented or unauthorised connections to CCS
164
- 4. Evaluate remote access security
165
- 5. Assess vendor/third-party connectivity risks
166
- 6. Produce findings and remediation plan
167
-
168
- ### ADR Process
169
-
170
- **Step 1: Inventory and Documentation Review**
171
- - Collect current network topology diagrams (IT and OT)
172
- - Review CCS inventory for completeness
173
- - Compare diagrams to actual architecture (passive discovery or authorised scan)
174
- - Document any discrepancies
175
-
176
- **Step 2: Segmentation Assessment**
177
- For each IT/OT boundary connection:
178
- - Is the connection documented and authorised?
179
- - What security controls enforce the boundary (firewall, DMZ, data diode)?
180
- - Are firewall rules reviewed and minimised?
181
- - Is there a default-deny rule on the OT side?
182
- - Are any direct connections from internet to OT environment?
183
-
184
- **Step 3: Remote Access Review**
185
- - Inventory all remote access paths into OT (VPN, RDP, vendor jump servers)
186
- - Confirm MFA is enforced for all remote OT access
187
- - Confirm all remote access is logged and monitored
188
- - Confirm vendor access is time-limited and requires explicit approval
189
-
190
- **Step 4: Third-Party Connectivity**
191
- - Map all third-party connections to CCS (vendor remote support, SCADA hosting, cloud-based OT monitoring)
192
- - Assess contractual cybersecurity obligations of third parties
193
- - Confirm third parties cannot access OT without entity approval and monitoring
194
-
195
- **Step 5: Vulnerability and Risk Identification**
196
- - Identify high-risk architecture patterns:
197
- - Flat networks where IT and OT share the same subnet
198
- - OT devices with direct internet connectivity
199
- - Obsolete OT systems with no compensating controls
200
- - Shared accounts between IT and OT
201
- - Unencrypted protocols on OT networks (Telnet, FTP, HTTP to HMIs)
202
-
203
- **Step 6: Findings and Remediation Plan**
204
- For each finding:
205
- | Finding ID | Description | Risk Level | Recommendation | Owner | Target Date |
206
- |-----------|-------------|-----------|----------------|-------|-------------|
207
- | ADR-001 | PLC subnet not segmented from corporate LAN | Critical | Deploy firewall; implement DMZ | OT Manager | Q2 |
208
-
209
- ### ADR Outputs
210
- - Updated and validated network topology diagrams
211
- - Findings report (findings, risk ratings, recommendations)
212
- - Remediation action plan with owners and target dates
213
- - Sign-off by Accountable Executive
214
-
215
- ---
216
-
217
- ## CRMP Component 4: Cybersecurity Assessment Plan (CAP)
218
-
219
- ### Purpose
220
- The CAP documents how the entity will assess the effectiveness of its CRMP each year. It is not the assessment itself — it is the plan for conducting assessments. Results are reported to TSA annually.
221
-
222
- ### Required CAP Elements
223
-
224
- **1. Assessment Scope**
225
- - Which CCS and CRMP components are in scope each assessment cycle
226
- - Rationale for any CCS excluded from scope (with compensating coverage explanation)
227
-
228
- **2. Assessment Methodology**
229
- Define the types of assessments to be performed:
230
- | Assessment Type | Description | Applicable To |
231
- |----------------|-------------|---------------|
232
- | Vulnerability scan | Automated scan of IT/OT assets for known CVEs | IT; limited OT (passive preferred) |
233
- | Penetration testing | Authorised simulated attack to test defences | IT; OT where safe and agreed |
234
- | Configuration review | Compare system configs against hardening standards | IT servers; network devices; OT where possible |
235
- | Process review | Interview-based review of policies and procedures | All CRMP components |
236
- | Red team exercise | Adversary simulation against CCS | Large/complex environments |
237
-
238
- **OT assessment cautions**:
239
- - Active scanning of OT networks can disrupt industrial communications — use passive monitoring tools
240
- - Penetration testing in OT requires vendor coordination and operational approval
241
- - Prioritise configuration review and architecture review over intrusive testing for OT
242
-
243
- **3. Assessment Schedule**
244
- Provide a 12-month schedule:
245
- | Quarter | Assessment Activity | CCS in Scope |
246
- |---------|-------------------|-------------|
247
- | Q1 | Vulnerability scan (IT); IRP tabletop exercise | All IT CCS; IRP |
248
- | Q2 | Configuration review (OT); ADR | OT CCS; architecture |
249
- | Q3 | Penetration test (IT external + internal) | IT CCS |
250
- | Q4 | Process review (all CRMP components); CAP results compilation | All |
251
-
252
- **4. Responsible Parties**
253
- - Internal assessment teams or third-party assessors
254
- - OT assessment requires OT-qualified personnel (GICSP, GCIA, or equivalent)
255
- - Independence requirements: assessors should not assess their own implementations
256
-
257
- **5. Annual Reporting to TSA**
258
- - Compile assessment findings and remediation status
259
- - Submit results to TSA via designated secure channel annually
260
- - Include: findings summary, risk ratings, remediation plan, open items, corrective action progress
261
-
262
- ---
263
-
264
- ## Four Technical Domains — Detailed Implementation Guidance
265
-
266
- ### Domain 1: Network Segmentation — Implementation Details
267
-
268
- **Minimum acceptable architecture:**
269
- ```
270
- [Internet] → [Edge Firewall] → [Corporate IT Network]
271
-
272
- [IT/OT Firewall / DMZ]
273
-
274
- [OT Network / ICS Network]
275
-
276
- [Field Devices: PLCs, RTUs, HMIs]
277
- ```
278
-
279
- **Security controls for each boundary:**
280
- - **Edge to IT**: Stateful firewall; DMZ for internet-facing services; IDS/IPS
281
- - **IT to OT**: Dedicated firewall or data diode; default-deny; whitelist only required protocols/ports; no direct routing
282
- - **OT to field**: Segmented VLANs for different process areas; restrict inter-VLAN traffic
283
-
284
- **Data diodes / unidirectional gateways**: Preferred for highest-security OT environments. Data flows one way (OT → IT for monitoring/historian) — no return path possible. Vendors: Waterfall Security, Owl Cyber Defense, Bayshore Networks.
285
-
286
- **Compensating controls for flat networks** (where full segmentation is not immediately feasible):
287
- - Host-based firewall on all IT systems to block OT traffic
288
- - Enhanced monitoring and alerting at the flat network level
289
- - Documented exception with remediation timeline
290
- - Enhanced access controls at OT device level
291
-
292
- ### Domain 2: Access Controls — OT-Specific Guidance
293
-
294
- **OT account management challenges**:
295
- - Many OT systems have limited account management capability (single shared admin account)
296
- - Legacy HMIs may not support MFA natively
297
- - Vendor accounts are often needed for maintenance but may be always-on
298
-
299
- **Solutions for OT access control limitations**:
300
- | Challenge | Solution |
301
- |-----------|---------|
302
- | Legacy HMI, no MFA | Deploy a jump server/bastion host with MFA in front of HMI; access HMI only via jump server |
303
- | Shared OT admin account | Log all access via PAM tool; require check-out with approval for shared account use |
304
- | Vendor remote access | Use vendor-specific VPN with MFA; time-limited sessions; all sessions logged; revoke after job |
305
- | No LDAP/AD support in OT | Maintain local accounts on OT devices with strong passwords; rotate quarterly |
306
-
307
- **Privileged Access Management (PAM) for OT**:
308
- - Check-out workflows for privileged OT credentials
309
- - Session recording for all privileged OT access
310
- - Automatic expiry of vendor sessions
311
- - Alert on out-of-hours privileged access
312
-
313
- ### Domain 3: Continuous Monitoring — OT-Specific Tools
314
-
315
- **Recommended OT monitoring approaches:**
316
- | Approach | Tools | Notes |
317
- |---------|-------|-------|
318
- | Passive network monitoring | Claroty, Dragos Platform, Nozomi Networks Guardian, Armis | No traffic injection; learn by listening |
319
- | Asset discovery | Passive discovery via monitoring tools | Builds CCS inventory automatically |
320
- | Anomaly detection | Dragos, Claroty, Nozomi | Alert on deviations from OT communication baselines |
321
- | Log collection | Syslog from OT-capable devices; SIEM with OT parsers | Not all PLCs support syslog |
322
- | Threat intelligence | Dragos WorldView, Claroty Team82, CISA ICS-CERT advisories | OT-specific threat intelligence |
323
-
324
- **What to monitor in OT environments:**
325
- - New devices appearing on OT network (unauthorised asset)
326
- - New communication paths (protocol, endpoint pair)
327
- - Engineering workstation connections to PLCs outside maintenance windows
328
- - Remote access sessions to OT
329
- - Command injection attempts (Modbus, DNP3, EtherNet/IP abnormal commands)
330
- - Authentication failures on OT devices
331
-
332
- ### Domain 4: Patch Management — OT-Specific Guidance
333
-
334
- **OT patching lifecycle:**
335
- 1. **Vendor notification**: Receive patch/advisory from OT vendor
336
- 2. **Risk assessment**: Evaluate CVE severity vs operational impact of patching
337
- 3. **Vendor confirmation**: Confirm patch is supported for your firmware version
338
- 4. **Test environment**: Test patch in lab/test environment before production
339
- 5. **Change approval**: Change management ticket; operations approval for downtime window
340
- 6. **Deployment**: Apply during planned maintenance window
341
- 7. **Verification**: Confirm system operation post-patch
342
- 8. **Documentation**: Record patch applied, date, version
343
-
344
- **Unpatched legacy OT systems (compensating controls)**:
345
- | Compensating Control | Description |
346
- |--------------------|-------------|
347
- | Network isolation | Further isolate the legacy system to its own VLAN; restrict to minimum required communications |
348
- | Enhanced monitoring | Increase monitoring sensitivity for the legacy system |
349
- | Application whitelisting | If OS supports it, whitelist only authorised executables |
350
- | Removal from internet path | Ensure no internet connectivity path to the legacy device |
351
- | Documentation | Document the legacy system, its risks, and compensating controls in the CIP |
352
-
353
- **Patch prioritisation (risk-based):**
354
- | CVSS Score | Severity | Target Patch Timeline |
355
- |-----------|---------|----------------------|
356
- | 9.0–10.0 | Critical | 30 days (or compensating controls within 7 days) |
357
- | 7.0–8.9 | High | 60 days |
358
- | 4.0–6.9 | Medium | 90 days |
359
- | 0.1–3.9 | Low | 180 days or next planned maintenance |
1
+ # TSA CRMP — Detailed Requirements and Implementation Guidance
2
+
3
+ Source: Based on publicly available TSA Security Directive summaries, Federal Register notices, and DHS/CISA publications.
4
+
5
+ ---
6
+
7
+ ## CRMP Component 1: Cybersecurity Implementation Plan (CIP) / COIP
8
+
9
+ ### Purpose
10
+ The CIP (or COIP under the NPRM) is the master compliance document that demonstrates how the covered entity implements and maintains all required cybersecurity measures. It must be submitted to TSA for review and approval.
11
+
12
+ ### Required Sections
13
+
14
+ **Section 1: Leadership and Accountability**
15
+ - Identity of the Accountable Executive (named C-suite individual with authority over cybersecurity decisions and resources)
16
+ - Identity of the Cybersecurity Coordinator (primary) and backup designee
17
+ - Contact information for both (including 24/7 phone numbers)
18
+ - Reporting structure between coordinator and accountable executive
19
+
20
+ **Section 2: Critical Cyber System (CCS) Inventory**
21
+ - Complete list of systems designated as Critical Cyber Systems
22
+ - For each CCS: system name, type (IT/OT/ICS), function, owner, physical location, network zone
23
+ - Methodology used for CCS determination
24
+ - Process for updating the inventory when architecture changes
25
+
26
+ **Section 3: Network Architecture Overview**
27
+ - Current network topology diagrams (IT and OT — must be accurate and current)
28
+ - Description of IT/OT boundary mechanisms (firewalls, DMZs, data diodes)
29
+ - Remote access architecture into OT environments
30
+ - Third-party and vendor connectivity to CCS
31
+ - Identification of any legacy systems with limited segmentation capability
32
+
33
+ **Section 4: Cybersecurity Measures (Four Technical Domains)**
34
+
35
+ *Domain 1 — Network Segmentation:*
36
+ - Segmentation policy and how it is enforced
37
+ - Description of technical controls implementing the IT/OT boundary
38
+ - Compensating controls for systems that cannot be fully segmented
39
+ - Process for authorising exceptions
40
+
41
+ *Domain 2 — Access Controls:*
42
+ - Authentication requirements for CCS access (MFA for remote and privileged access)
43
+ - Account lifecycle management (provisioning, review, de-provisioning)
44
+ - Privileged access management approach
45
+ - Third-party/vendor access controls
46
+
47
+ *Domain 3 — Continuous Monitoring:*
48
+ - Monitoring tools and coverage (IT and OT)
49
+ - Log collection and retention policy
50
+ - Alerting thresholds and escalation procedures
51
+ - Integration with SOC or monitoring team
52
+
53
+ *Domain 4 — Patch Management:*
54
+ - Risk-based patch prioritisation methodology
55
+ - Patch timelines by severity (critical, high, medium, low)
56
+ - OT-specific patching process (vendor approval, testing, maintenance windows)
57
+ - Compensating controls for unpatched legacy OT systems
58
+
59
+ **Section 5: Incident Detection and Response**
60
+ - High-level description of how incidents are detected (monitoring, alerting, user reporting)
61
+ - Escalation path from detection to Cybersecurity Coordinator
62
+ - Reference to the Cybersecurity Incident Response Plan (separate document)
63
+ - CISA 24-hour reporting procedure
64
+
65
+ **Section 6: Annual Review Process**
66
+ - Frequency and process for reviewing and updating the CIP
67
+ - Triggers for out-of-cycle review (major architecture change, significant incident, new threat intelligence)
68
+ - Approval process for CIP updates
69
+ - TSA submission process for material changes
70
+
71
+ ### CIP Approval Process
72
+ 1. Covered entity submits CIP to TSA via designated secure channel
73
+ 2. TSA reviews for completeness and alignment with directive requirements
74
+ 3. TSA may approve, request modifications, or reject
75
+ 4. Entity implements CIP; cannot claim TSA-approved CIP until approval is granted
76
+ 5. Material changes to CIP require resubmission
77
+
78
+ ---
79
+
80
+ ## CRMP Component 2: Incident Response Plan (IRP / CIRP)
81
+
82
+ ### Required IRP Elements
83
+
84
+ **1. Scope and Objectives**
85
+ - What systems are covered (all CCS)
86
+ - IRP objectives: contain, eradicate, recover, report
87
+
88
+ **2. Roles and Responsibilities**
89
+ - Incident Commander (typically Cybersecurity Coordinator)
90
+ - IT response team
91
+ - OT/ICS response team (may include OT vendor support)
92
+ - Legal and communications (for regulatory reporting)
93
+ - Executive escalation path
94
+
95
+ **3. Incident Classification**
96
+ Define severity tiers:
97
+ | Tier | Definition | Response Time |
98
+ |------|-----------|--------------|
99
+ | Critical | Active threat to CCS operations/safety | Immediate — all hands |
100
+ | High | Confirmed unauthorised access to CCS | Within 1 hour |
101
+ | Medium | Suspected compromise; investigation underway | Within 4 hours |
102
+ | Low | Indicator of compromise; no confirmed access | Within 24 hours |
103
+
104
+ **4. Detection and Initial Analysis**
105
+ - How anomalies are identified (monitoring alerts, user reports, third-party notification)
106
+ - Initial triage process: confirm vs false positive
107
+ - Evidence preservation from first moments
108
+
109
+ **5. Containment Procedures**
110
+ - IT containment: isolate affected systems from network
111
+ - OT containment: procedures for isolating OT from IT (IT/OT segregation under incident conditions)
112
+ - Manual operation fallback: how to operate OT assets if control systems are isolated
113
+ - Preserve operational capability while containing cyber threat
114
+
115
+ **6. Eradication and Recovery**
116
+ - Threat removal procedures
117
+ - Backup restoration: integrity verification before restoration
118
+ - System rebuild and hardening before reconnecting
119
+ - Phased return to operation
120
+
121
+ **7. CISA and TSA Notification**
122
+ - 24-hour CISA reporting trigger (see `tsa-incident-reporting.md`)
123
+ - TSA notification procedure
124
+ - Internal escalation to Accountable Executive
125
+ - Regulatory notification log (record of all notifications made)
126
+
127
+ **8. Post-Incident Review**
128
+ - After-action review within 30 days of incident closure
129
+ - Root cause analysis
130
+ - Lessons learned documented
131
+ - CIP/IRP updated based on findings
132
+ - Consider sharing with CISA/ISAC
133
+
134
+ ### Annual IRP Testing
135
+
136
+ Covered entities must **test at least two IRP objectives annually**. Testing may be conducted via:
137
+ - **Tabletop exercise**: Discussion-based walkthrough of a scenario (minimum viable testing)
138
+ - **Functional exercise**: Partial activation of IRP with actual system interaction
139
+ - **Full-scale exercise**: Complete IRP activation with IT/OT teams
140
+
141
+ **Recommended test scenarios for TSA compliance**:
142
+ 1. **IT/OT segregation drill**: Simulate IT compromise; test ability to isolate OT and continue operations manually
143
+ 2. **Ransomware response drill**: Malware detected on IT; test containment, backup integrity check, restoration procedure
144
+ 3. **Unauthorised access to OT**: Simulate credential compromise leading to OT access; test detection and response
145
+ 4. **Vendor access abuse**: Simulate third-party remote access misuse; test detection and revocation
146
+
147
+ **Test documentation required**:
148
+ - Date and type of exercise
149
+ - Scenario description
150
+ - Participants
151
+ - Objectives tested
152
+ - Pass/fail for each objective
153
+ - Findings and corrective actions
154
+ - Corrective action closure tracking
155
+
156
+ ---
157
+
158
+ ## CRMP Component 3: Architecture Design Review (ADR)
159
+
160
+ ### ADR Objectives
161
+ 1. Confirm network diagrams are current, accurate, and complete
162
+ 2. Assess effectiveness of IT/OT segmentation
163
+ 3. Identify undocumented or unauthorised connections to CCS
164
+ 4. Evaluate remote access security
165
+ 5. Assess vendor/third-party connectivity risks
166
+ 6. Produce findings and remediation plan
167
+
168
+ ### ADR Process
169
+
170
+ **Step 1: Inventory and Documentation Review**
171
+ - Collect current network topology diagrams (IT and OT)
172
+ - Review CCS inventory for completeness
173
+ - Compare diagrams to actual architecture (passive discovery or authorised scan)
174
+ - Document any discrepancies
175
+
176
+ **Step 2: Segmentation Assessment**
177
+ For each IT/OT boundary connection:
178
+ - Is the connection documented and authorised?
179
+ - What security controls enforce the boundary (firewall, DMZ, data diode)?
180
+ - Are firewall rules reviewed and minimised?
181
+ - Is there a default-deny rule on the OT side?
182
+ - Are any direct connections from internet to OT environment?
183
+
184
+ **Step 3: Remote Access Review**
185
+ - Inventory all remote access paths into OT (VPN, RDP, vendor jump servers)
186
+ - Confirm MFA is enforced for all remote OT access
187
+ - Confirm all remote access is logged and monitored
188
+ - Confirm vendor access is time-limited and requires explicit approval
189
+
190
+ **Step 4: Third-Party Connectivity**
191
+ - Map all third-party connections to CCS (vendor remote support, SCADA hosting, cloud-based OT monitoring)
192
+ - Assess contractual cybersecurity obligations of third parties
193
+ - Confirm third parties cannot access OT without entity approval and monitoring
194
+
195
+ **Step 5: Vulnerability and Risk Identification**
196
+ - Identify high-risk architecture patterns:
197
+ - Flat networks where IT and OT share the same subnet
198
+ - OT devices with direct internet connectivity
199
+ - Obsolete OT systems with no compensating controls
200
+ - Shared accounts between IT and OT
201
+ - Unencrypted protocols on OT networks (Telnet, FTP, HTTP to HMIs)
202
+
203
+ **Step 6: Findings and Remediation Plan**
204
+ For each finding:
205
+ | Finding ID | Description | Risk Level | Recommendation | Owner | Target Date |
206
+ |-----------|-------------|-----------|----------------|-------|-------------|
207
+ | ADR-001 | PLC subnet not segmented from corporate LAN | Critical | Deploy firewall; implement DMZ | OT Manager | Q2 |
208
+
209
+ ### ADR Outputs
210
+ - Updated and validated network topology diagrams
211
+ - Findings report (findings, risk ratings, recommendations)
212
+ - Remediation action plan with owners and target dates
213
+ - Sign-off by Accountable Executive
214
+
215
+ ---
216
+
217
+ ## CRMP Component 4: Cybersecurity Assessment Plan (CAP)
218
+
219
+ ### Purpose
220
+ The CAP documents how the entity will assess the effectiveness of its CRMP each year. It is not the assessment itself — it is the plan for conducting assessments. Results are reported to TSA annually.
221
+
222
+ ### Required CAP Elements
223
+
224
+ **1. Assessment Scope**
225
+ - Which CCS and CRMP components are in scope each assessment cycle
226
+ - Rationale for any CCS excluded from scope (with compensating coverage explanation)
227
+
228
+ **2. Assessment Methodology**
229
+ Define the types of assessments to be performed:
230
+ | Assessment Type | Description | Applicable To |
231
+ |----------------|-------------|---------------|
232
+ | Vulnerability scan | Automated scan of IT/OT assets for known CVEs | IT; limited OT (passive preferred) |
233
+ | Penetration testing | Authorised simulated attack to test defences | IT; OT where safe and agreed |
234
+ | Configuration review | Compare system configs against hardening standards | IT servers; network devices; OT where possible |
235
+ | Process review | Interview-based review of policies and procedures | All CRMP components |
236
+ | Red team exercise | Adversary simulation against CCS | Large/complex environments |
237
+
238
+ **OT assessment cautions**:
239
+ - Active scanning of OT networks can disrupt industrial communications — use passive monitoring tools
240
+ - Penetration testing in OT requires vendor coordination and operational approval
241
+ - Prioritise configuration review and architecture review over intrusive testing for OT
242
+
243
+ **3. Assessment Schedule**
244
+ Provide a 12-month schedule:
245
+ | Quarter | Assessment Activity | CCS in Scope |
246
+ |---------|-------------------|-------------|
247
+ | Q1 | Vulnerability scan (IT); IRP tabletop exercise | All IT CCS; IRP |
248
+ | Q2 | Configuration review (OT); ADR | OT CCS; architecture |
249
+ | Q3 | Penetration test (IT external + internal) | IT CCS |
250
+ | Q4 | Process review (all CRMP components); CAP results compilation | All |
251
+
252
+ **4. Responsible Parties**
253
+ - Internal assessment teams or third-party assessors
254
+ - OT assessment requires OT-qualified personnel (GICSP, GCIA, or equivalent)
255
+ - Independence requirements: assessors should not assess their own implementations
256
+
257
+ **5. Annual Reporting to TSA**
258
+ - Compile assessment findings and remediation status
259
+ - Submit results to TSA via designated secure channel annually
260
+ - Include: findings summary, risk ratings, remediation plan, open items, corrective action progress
261
+
262
+ ---
263
+
264
+ ## Four Technical Domains — Detailed Implementation Guidance
265
+
266
+ ### Domain 1: Network Segmentation — Implementation Details
267
+
268
+ **Minimum acceptable architecture:**
269
+ ```
270
+ [Internet] → [Edge Firewall] → [Corporate IT Network]
271
+
272
+ [IT/OT Firewall / DMZ]
273
+
274
+ [OT Network / ICS Network]
275
+
276
+ [Field Devices: PLCs, RTUs, HMIs]
277
+ ```
278
+
279
+ **Security controls for each boundary:**
280
+ - **Edge to IT**: Stateful firewall; DMZ for internet-facing services; IDS/IPS
281
+ - **IT to OT**: Dedicated firewall or data diode; default-deny; whitelist only required protocols/ports; no direct routing
282
+ - **OT to field**: Segmented VLANs for different process areas; restrict inter-VLAN traffic
283
+
284
+ **Data diodes / unidirectional gateways**: Preferred for highest-security OT environments. Data flows one way (OT → IT for monitoring/historian) — no return path possible. Vendors: Waterfall Security, Owl Cyber Defense, Bayshore Networks.
285
+
286
+ **Compensating controls for flat networks** (where full segmentation is not immediately feasible):
287
+ - Host-based firewall on all IT systems to block OT traffic
288
+ - Enhanced monitoring and alerting at the flat network level
289
+ - Documented exception with remediation timeline
290
+ - Enhanced access controls at OT device level
291
+
292
+ ### Domain 2: Access Controls — OT-Specific Guidance
293
+
294
+ **OT account management challenges**:
295
+ - Many OT systems have limited account management capability (single shared admin account)
296
+ - Legacy HMIs may not support MFA natively
297
+ - Vendor accounts are often needed for maintenance but may be always-on
298
+
299
+ **Solutions for OT access control limitations**:
300
+ | Challenge | Solution |
301
+ |-----------|---------|
302
+ | Legacy HMI, no MFA | Deploy a jump server/bastion host with MFA in front of HMI; access HMI only via jump server |
303
+ | Shared OT admin account | Log all access via PAM tool; require check-out with approval for shared account use |
304
+ | Vendor remote access | Use vendor-specific VPN with MFA; time-limited sessions; all sessions logged; revoke after job |
305
+ | No LDAP/AD support in OT | Maintain local accounts on OT devices with strong passwords; rotate quarterly |
306
+
307
+ **Privileged Access Management (PAM) for OT**:
308
+ - Check-out workflows for privileged OT credentials
309
+ - Session recording for all privileged OT access
310
+ - Automatic expiry of vendor sessions
311
+ - Alert on out-of-hours privileged access
312
+
313
+ ### Domain 3: Continuous Monitoring — OT-Specific Tools
314
+
315
+ **Recommended OT monitoring approaches:**
316
+ | Approach | Tools | Notes |
317
+ |---------|-------|-------|
318
+ | Passive network monitoring | Claroty, Dragos Platform, Nozomi Networks Guardian, Armis | No traffic injection; learn by listening |
319
+ | Asset discovery | Passive discovery via monitoring tools | Builds CCS inventory automatically |
320
+ | Anomaly detection | Dragos, Claroty, Nozomi | Alert on deviations from OT communication baselines |
321
+ | Log collection | Syslog from OT-capable devices; SIEM with OT parsers | Not all PLCs support syslog |
322
+ | Threat intelligence | Dragos WorldView, Claroty Team82, CISA ICS-CERT advisories | OT-specific threat intelligence |
323
+
324
+ **What to monitor in OT environments:**
325
+ - New devices appearing on OT network (unauthorised asset)
326
+ - New communication paths (protocol, endpoint pair)
327
+ - Engineering workstation connections to PLCs outside maintenance windows
328
+ - Remote access sessions to OT
329
+ - Command injection attempts (Modbus, DNP3, EtherNet/IP abnormal commands)
330
+ - Authentication failures on OT devices
331
+
332
+ ### Domain 4: Patch Management — OT-Specific Guidance
333
+
334
+ **OT patching lifecycle:**
335
+ 1. **Vendor notification**: Receive patch/advisory from OT vendor
336
+ 2. **Risk assessment**: Evaluate CVE severity vs operational impact of patching
337
+ 3. **Vendor confirmation**: Confirm patch is supported for your firmware version
338
+ 4. **Test environment**: Test patch in lab/test environment before production
339
+ 5. **Change approval**: Change management ticket; operations approval for downtime window
340
+ 6. **Deployment**: Apply during planned maintenance window
341
+ 7. **Verification**: Confirm system operation post-patch
342
+ 8. **Documentation**: Record patch applied, date, version
343
+
344
+ **Unpatched legacy OT systems (compensating controls)**:
345
+ | Compensating Control | Description |
346
+ |--------------------|-------------|
347
+ | Network isolation | Further isolate the legacy system to its own VLAN; restrict to minimum required communications |
348
+ | Enhanced monitoring | Increase monitoring sensitivity for the legacy system |
349
+ | Application whitelisting | If OS supports it, whitelist only authorised executables |
350
+ | Removal from internet path | Ensure no internet connectivity path to the legacy device |
351
+ | Documentation | Document the legacy system, its risks, and compensating controls in the CIP |
352
+
353
+ **Patch prioritisation (risk-based):**
354
+ | CVSS Score | Severity | Target Patch Timeline |
355
+ |-----------|---------|----------------------|
356
+ | 9.0–10.0 | Critical | 30 days (or compensating controls within 7 days) |
357
+ | 7.0–8.9 | High | 60 days |
358
+ | 4.0–6.9 | Medium | 90 days |
359
+ | 0.1–3.9 | Low | 180 days or next planned maintenance |