bmad-plus 0.7.5 → 0.9.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 (281) hide show
  1. package/CHANGELOG.md +479 -425
  2. package/LICENSE +21 -21
  3. package/README.md +557 -447
  4. package/osint-agent-package/README.md +88 -88
  5. package/osint-agent-package/SETUP_KEYS.md +108 -108
  6. package/osint-agent-package/agents/osint-investigator.md +80 -80
  7. package/osint-agent-package/install.ps1 +87 -87
  8. package/osint-agent-package/install.sh +76 -76
  9. package/osint-agent-package/skills/bmad-osint-investigate/SKILL.md +147 -147
  10. package/osint-agent-package/skills/bmad-osint-investigate/osint/SKILL.md +452 -452
  11. package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/dossier-template.md +116 -116
  12. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/content-extraction.md +100 -100
  13. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/enrichment-databases-fr.md +148 -148
  14. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/platforms.md +130 -130
  15. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/psychoprofile.md +69 -69
  16. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/tools.md +281 -281
  17. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/_http.py +101 -101
  18. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/apify.py +266 -260
  19. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/brightdata.py +101 -101
  20. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/diagnose.py +141 -141
  21. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/exa.py +79 -79
  22. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/jina.py +71 -71
  23. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/mcp-client.py +136 -136
  24. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/parallel.py +85 -85
  25. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/perplexity.py +102 -102
  26. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/tavily.py +72 -72
  27. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/volley.py +208 -208
  28. package/osint-agent-package/skills/bmad-osint-investigator/SKILL.md +15 -15
  29. package/package.json +62 -57
  30. package/readme-international/README.de.md +584 -426
  31. package/readme-international/README.es.md +601 -518
  32. package/readme-international/README.fr.md +599 -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/data/role-triggers.yaml +209 -209
  46. package/src/bmad-plus/module-help.csv +10 -10
  47. package/src/bmad-plus/module.yaml +283 -280
  48. package/src/bmad-plus/{agents → packs}/pack-animated/animated-website-agent.md +325 -325
  49. package/src/bmad-plus/{agents → packs}/pack-animated/templates/animated-website-workflow.md +55 -55
  50. package/src/bmad-plus/{agents → packs}/pack-backup/backup-agent.md +71 -71
  51. package/src/bmad-plus/{agents → packs}/pack-backup/templates/backup-workflow.md +51 -51
  52. package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -162
  53. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +73 -73
  54. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +61 -61
  55. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +95 -95
  56. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +95 -95
  57. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +134 -134
  58. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +80 -80
  59. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +73 -73
  60. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +95 -95
  61. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +73 -73
  62. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +73 -73
  63. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +92 -92
  64. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +80 -80
  65. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +90 -90
  66. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -153
  67. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -173
  68. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -224
  69. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -329
  70. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -318
  71. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -359
  72. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -379
  73. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -361
  74. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +81 -81
  75. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +67 -67
  76. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -85
  77. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -35
  78. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -49
  79. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +131 -131
  80. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +89 -89
  81. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +300 -300
  82. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +428 -428
  83. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +73 -73
  84. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -80
  85. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +484 -484
  86. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +193 -193
  87. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +175 -175
  88. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +110 -110
  89. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1511 -1511
  90. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +298 -298
  91. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +296 -296
  92. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +29 -29
  93. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +74 -74
  94. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +29 -29
  95. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +73 -73
  96. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +89 -89
  97. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +73 -73
  98. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +29 -29
  99. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +141 -141
  100. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -37
  101. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -75
  102. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -6
  103. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +110 -110
  104. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +176 -176
  105. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -67
  106. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -86
  107. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -179
  108. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -66
  109. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +127 -127
  110. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -105
  111. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -120
  112. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -12
  113. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -328
  114. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -32
  115. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -81
  116. package/src/bmad-plus/packs/pack-memory/README.md +106 -106
  117. package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +79 -79
  118. package/src/bmad-plus/packs/pack-memory/shared/karpathy-guardrails.md +86 -86
  119. package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +143 -143
  120. package/src/bmad-plus/packs/pack-memory/templates/context.md +39 -39
  121. package/src/bmad-plus/packs/pack-memory/templates/decisions.md +25 -25
  122. package/src/bmad-plus/packs/pack-memory/templates/identity.yaml +39 -39
  123. package/src/bmad-plus/packs/pack-memory/templates/lessons.md +31 -31
  124. package/src/bmad-plus/packs/pack-memory/templates/patterns.md +24 -24
  125. package/src/bmad-plus/packs/pack-memory/templates/session-handoff.md +25 -25
  126. package/src/bmad-plus/packs/pack-memory/zecher-agent.md +157 -157
  127. package/src/bmad-plus/{agents → packs}/pack-seo/SKILL.md +171 -171
  128. package/src/bmad-plus/packs/pack-seo/bmad-skill-manifest.yaml +13 -0
  129. package/src/bmad-plus/{agents → packs}/pack-seo/checklist.md +140 -140
  130. package/src/bmad-plus/{agents → packs}/pack-seo/pagespeed-playbook.md +320 -320
  131. package/src/bmad-plus/{agents → packs}/pack-seo/ref/audit-schema.json +187 -187
  132. package/src/bmad-plus/{agents → packs}/pack-seo/ref/cwv-thresholds.md +87 -87
  133. package/src/bmad-plus/{agents → packs}/pack-seo/ref/eeat-criteria.md +123 -123
  134. package/src/bmad-plus/{agents → packs}/pack-seo/ref/geo-signals.md +167 -167
  135. package/src/bmad-plus/{agents → packs}/pack-seo/ref/hreflang-rules.md +153 -153
  136. package/src/bmad-plus/{agents → packs}/pack-seo/ref/quality-gates.md +133 -133
  137. package/src/bmad-plus/{agents → packs}/pack-seo/ref/schema-catalog.md +91 -91
  138. package/src/bmad-plus/{agents → packs}/pack-seo/ref/schema-templates.json +356 -356
  139. package/src/bmad-plus/{agents → packs}/pack-seo/seo-chief.md +294 -294
  140. package/src/bmad-plus/{agents → packs}/pack-seo/seo-judge.md +241 -241
  141. package/src/bmad-plus/{agents → packs}/pack-seo/seo-scout.md +171 -171
  142. package/src/bmad-plus/{agents → packs}/pack-seo/templates/seo-audit-workflow.md +241 -241
  143. package/src/bmad-plus/packs/pack-shield/README.md +110 -110
  144. package/src/bmad-plus/packs/pack-shield/SKILL.md +82 -0
  145. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/csrd-agent.md +262 -262
  146. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/section508-agent.md +179 -179
  147. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/wcag-agent.md +201 -201
  148. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/eu-ai-act-agent.md +97 -97
  149. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/iso42001-agent.md +251 -251
  150. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/nist-ai-rmf-agent.md +133 -133
  151. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/cis-controls-agent.md +221 -221
  152. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/ism-agent.md +150 -150
  153. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/iso27001-agent.md +167 -167
  154. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nis2-agent.md +83 -83
  155. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-800-53-agent.md +250 -250
  156. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-csf-agent.md +218 -218
  157. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/ccpa-agent.md +94 -94
  158. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/dpdpa-agent.md +136 -136
  159. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/gdpr-agent.md +296 -296
  160. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/iso27701-agent.md +134 -134
  161. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/lgpd-agent.md +129 -129
  162. package/src/bmad-plus/packs/pack-shield/categories/defense-export/cmmc-agent.md +127 -127
  163. package/src/bmad-plus/packs/pack-shield/categories/defense-export/ear-agent.md +272 -272
  164. package/src/bmad-plus/packs/pack-shield/categories/defense-export/itar-agent.md +202 -202
  165. package/src/bmad-plus/packs/pack-shield/categories/defense-export/tsa-agent.md +367 -367
  166. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/dora-agent.md +510 -510
  167. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/fedramp-agent.md +247 -247
  168. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/hipaa-agent.md +173 -173
  169. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/pci-dss-agent.md +239 -239
  170. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/soc2-agent.md +266 -266
  171. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/swift-csp-agent.md +164 -164
  172. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-classifier.md +131 -131
  173. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-fria.md +155 -155
  174. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-incidents.md +187 -187
  175. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-roles.md +113 -113
  176. package/src/bmad-plus/packs/pack-shield/categories/workflows/breach-sentinel.md +197 -197
  177. package/src/bmad-plus/packs/pack-shield/categories/workflows/cookie-policy-gen.md +180 -180
  178. package/src/bmad-plus/packs/pack-shield/categories/workflows/dpia-sentinel.md +235 -235
  179. package/src/bmad-plus/packs/pack-shield/categories/workflows/legitimate-interest.md +159 -159
  180. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-advisor.md +133 -133
  181. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-notice-gen.md +160 -160
  182. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-policy-gen.md +135 -135
  183. package/src/bmad-plus/packs/pack-shield/references/ccpa/ccpa-gdpr-comparison.md +117 -117
  184. package/src/bmad-plus/packs/pack-shield/references/ccpa/consumer-rights-workflows.md +177 -177
  185. package/src/bmad-plus/packs/pack-shield/references/cis-controls/framework-mappings.md +162 -162
  186. package/src/bmad-plus/packs/pack-shield/references/cis-controls/implementation-guidance.md +235 -235
  187. package/src/bmad-plus/packs/pack-shield/references/cis-controls/safeguards-detail.md +252 -252
  188. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-assessment.md +170 -170
  189. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-levels.md +113 -113
  190. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-practices.md +211 -211
  191. package/src/bmad-plus/packs/pack-shield/references/csrd/compliance-program.md +281 -281
  192. package/src/bmad-plus/packs/pack-shield/references/csrd/double-materiality.md +253 -253
  193. package/src/bmad-plus/packs/pack-shield/references/csrd/esrs-standards.md +401 -401
  194. package/src/bmad-plus/packs/pack-shield/references/dora/article-reference.md +441 -441
  195. package/src/bmad-plus/packs/pack-shield/references/dora/incident-classification.md +297 -297
  196. package/src/bmad-plus/packs/pack-shield/references/dora/rts-its-guide.md +306 -306
  197. package/src/bmad-plus/packs/pack-shield/references/dora/third-party-risk.md +349 -349
  198. package/src/bmad-plus/packs/pack-shield/references/dpdpa/gdpr-comparison.md +173 -173
  199. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rights-and-obligations.md +426 -426
  200. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rules-2025.md +599 -599
  201. package/src/bmad-plus/packs/pack-shield/references/dpdpa/sections-reference.md +319 -319
  202. package/src/bmad-plus/packs/pack-shield/references/ear/ccl-eccn-guide.md +250 -250
  203. package/src/bmad-plus/packs/pack-shield/references/ear/compliance-program.md +280 -280
  204. package/src/bmad-plus/packs/pack-shield/references/ear/license-exceptions.md +207 -207
  205. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/gpai-governance.md +267 -267
  206. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/obligations-high-risk.md +287 -287
  207. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/risk-classification.md +182 -182
  208. package/src/bmad-plus/packs/pack-shield/references/fedramp/appendices-guide.md +209 -209
  209. package/src/bmad-plus/packs/pack-shield/references/fedramp/control-families.md +281 -281
  210. package/src/bmad-plus/packs/pack-shield/references/fedramp/poam-guide.md +93 -93
  211. package/src/bmad-plus/packs/pack-shield/references/fedramp/readiness-checklist.md +134 -134
  212. package/src/bmad-plus/packs/pack-shield/references/fedramp/sap-sar-guide.md +86 -86
  213. package/src/bmad-plus/packs/pack-shield/references/fedramp/ssp-guide.md +129 -129
  214. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/documents.md +192 -192
  215. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/dpa-template.md +121 -121
  216. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/privacy-notice.md +87 -87
  217. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/breach-notification.md +293 -293
  218. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/privacy-rule.md +276 -276
  219. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/security-rule.md +299 -299
  220. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/templates.md +568 -568
  221. package/src/bmad-plus/packs/pack-shield/references/ism/control-applicability.md +181 -181
  222. package/src/bmad-plus/packs/pack-shield/references/ism/guidelines-overview.md +183 -183
  223. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2013.md +203 -203
  224. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2022.md +132 -132
  225. package/src/bmad-plus/packs/pack-shield/references/iso27001/control-mapping.md +153 -153
  226. package/src/bmad-plus/packs/pack-shield/references/iso27701/annex-a-controls.md +195 -195
  227. package/src/bmad-plus/packs/pack-shield/references/iso27701/regulatory-mapping.md +229 -229
  228. package/src/bmad-plus/packs/pack-shield/references/iso27701/transition-guide.md +219 -219
  229. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-ai-risk-assessment.md +258 -258
  230. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-clauses-requirements.md +279 -279
  231. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-controls-annex-a.md +155 -155
  232. package/src/bmad-plus/packs/pack-shield/references/itar/compliance-program.md +174 -174
  233. package/src/bmad-plus/packs/pack-shield/references/itar/licensing-guide.md +146 -146
  234. package/src/bmad-plus/packs/pack-shield/references/itar/usml-categories.md +93 -93
  235. package/src/bmad-plus/packs/pack-shield/references/lgpd/anpd-enforcement.md +147 -147
  236. package/src/bmad-plus/packs/pack-shield/references/lgpd/compliance-program.md +272 -272
  237. package/src/bmad-plus/packs/pack-shield/references/lgpd/lgpd-articles.md +271 -271
  238. package/src/bmad-plus/packs/pack-shield/references/nis2/article-21-measures.md +153 -153
  239. package/src/bmad-plus/packs/pack-shield/references/nis2/iso27001-nis2-mapping.md +68 -68
  240. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/assessment-rmf.md +349 -349
  241. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/baselines-tailoring.md +277 -277
  242. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/control-families.md +450 -450
  243. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-core.md +361 -361
  244. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-profiles.md +192 -192
  245. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-10-to-20-mapping.md +143 -143
  246. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-20-functions-categories.md +278 -278
  247. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-implementation-tiers.md +135 -135
  248. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-requirements.md +366 -366
  249. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-saq-guide.md +217 -217
  250. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-v4-changes.md +190 -190
  251. package/src/bmad-plus/packs/pack-shield/references/section-508/wcag-mapping.md +160 -160
  252. package/src/bmad-plus/packs/pack-shield/references/soc2/controls.md +241 -241
  253. package/src/bmad-plus/packs/pack-shield/references/soc2/evidence.md +236 -236
  254. package/src/bmad-plus/packs/pack-shield/references/soc2/policies.md +254 -254
  255. package/src/bmad-plus/packs/pack-shield/references/soc2/vendor.md +276 -276
  256. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-assessment.md +202 -202
  257. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-controls.md +545 -545
  258. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-crmp-requirements.md +359 -359
  259. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-directives-overview.md +187 -187
  260. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-incident-reporting.md +187 -187
  261. package/src/bmad-plus/packs/pack-shield/references/wcag/criteria-detail.md +510 -510
  262. package/src/bmad-plus/packs/pack-shield/shared/audit-report-template.md +103 -103
  263. package/src/bmad-plus/packs/pack-shield/shared/cross-framework-mapper.md +103 -103
  264. package/src/bmad-plus/packs/pack-shield/shared/gap-analysis-template.md +83 -83
  265. package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +229 -229
  266. package/src/bmad-plus/packs/pack-shield/upstream-sync.yaml +68 -68
  267. package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +99 -99
  268. package/src/bmad-plus/skills/bmad-plus-parallel/SKILL.md +93 -93
  269. package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +69 -69
  270. package/tools/bmad-plus-npx.js +3 -5
  271. package/tools/cli/commands/autoconfig.js +508 -489
  272. package/tools/cli/commands/doctor.js +219 -222
  273. package/tools/cli/commands/install.js +548 -739
  274. package/tools/cli/commands/memory.js +194 -194
  275. package/tools/cli/commands/scan.js +362 -350
  276. package/tools/cli/commands/uninstall.js +96 -96
  277. package/tools/cli/commands/update.js +116 -174
  278. package/tools/cli/i18n.js +845 -763
  279. package/tools/cli/lib/memory-init.js +114 -0
  280. package/tools/cli/lib/pack-copy.js +84 -0
  281. package/tools/cli/lib/packs.js +114 -0
@@ -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 |