@raishin/vanguard-frontier-agentic 3.20.0 → 3.21.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 (364) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +6 -1
  3. package/.cursor-plugin/plugin.json +6 -1
  4. package/.github/plugin/marketplace.json +1 -1
  5. package/README.md +13 -11
  6. package/agents/AGENTS.md +1 -1
  7. package/agents/README.md +1 -1
  8. package/agents/atlassian/atlassian-control-evidence-lineage-agent/AGENT.md +50 -0
  9. package/agents/atlassian/atlassian-control-evidence-lineage-agent/LEAST-PRIVILEGES.md +23 -0
  10. package/agents/atlassian/atlassian-control-evidence-lineage-agent/README.md +36 -0
  11. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/claude-code.agent.md +44 -0
  12. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/codex.toml +51 -0
  13. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/copilot.agent.md +71 -0
  14. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/cursor.agent.md +43 -0
  15. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/gemini.agent.md +44 -0
  16. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/kiro-cli.agent.json +5 -0
  17. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/kiro-ide.agent.md +43 -0
  18. package/agents/atlassian/atlassian-control-evidence-lineage-agent/metadata.json +43 -0
  19. package/agents/atlassian/atlassian-incident-prevention-agent/AGENT.md +49 -0
  20. package/agents/atlassian/atlassian-incident-prevention-agent/LEAST-PRIVILEGES.md +23 -0
  21. package/agents/atlassian/atlassian-incident-prevention-agent/README.md +36 -0
  22. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/claude-code.agent.md +43 -0
  23. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/codex.toml +51 -0
  24. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/copilot.agent.md +70 -0
  25. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/cursor.agent.md +42 -0
  26. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/gemini.agent.md +43 -0
  27. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/kiro-cli.agent.json +5 -0
  28. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/kiro-ide.agent.md +42 -0
  29. package/agents/atlassian/atlassian-incident-prevention-agent/metadata.json +43 -0
  30. package/agents/atlassian/atlassian-knowledge-integrity-agent/AGENT.md +48 -0
  31. package/agents/atlassian/atlassian-knowledge-integrity-agent/LEAST-PRIVILEGES.md +23 -0
  32. package/agents/atlassian/atlassian-knowledge-integrity-agent/README.md +36 -0
  33. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/claude-code.agent.md +42 -0
  34. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/codex.toml +47 -0
  35. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/copilot.agent.md +69 -0
  36. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/cursor.agent.md +41 -0
  37. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/gemini.agent.md +42 -0
  38. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/kiro-cli.agent.json +5 -0
  39. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/kiro-ide.agent.md +41 -0
  40. package/agents/atlassian/atlassian-knowledge-integrity-agent/metadata.json +42 -0
  41. package/agents/atlassian/atlassian-live-write-guard-agent/AGENT.md +51 -0
  42. package/agents/atlassian/atlassian-live-write-guard-agent/LEAST-PRIVILEGES.md +23 -0
  43. package/agents/atlassian/atlassian-live-write-guard-agent/README.md +36 -0
  44. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/claude-code.agent.md +45 -0
  45. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/codex.toml +52 -0
  46. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/copilot.agent.md +72 -0
  47. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/cursor.agent.md +44 -0
  48. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/gemini.agent.md +45 -0
  49. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/kiro-cli.agent.json +5 -0
  50. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/kiro-ide.agent.md +44 -0
  51. package/agents/atlassian/atlassian-live-write-guard-agent/metadata.json +43 -0
  52. package/agents/atlassian/atlassian-maestro-agent/AGENT.md +49 -0
  53. package/agents/atlassian/atlassian-maestro-agent/LEAST-PRIVILEGES.md +20 -0
  54. package/agents/atlassian/atlassian-maestro-agent/README.md +36 -0
  55. package/agents/atlassian/atlassian-maestro-agent/harnesses/claude-code.agent.md +43 -0
  56. package/agents/atlassian/atlassian-maestro-agent/harnesses/codex.toml +44 -0
  57. package/agents/atlassian/atlassian-maestro-agent/harnesses/copilot.agent.md +46 -0
  58. package/agents/atlassian/atlassian-maestro-agent/harnesses/cursor.agent.md +42 -0
  59. package/agents/atlassian/atlassian-maestro-agent/harnesses/gemini.agent.md +43 -0
  60. package/agents/atlassian/atlassian-maestro-agent/harnesses/kiro-cli.agent.json +5 -0
  61. package/agents/atlassian/atlassian-maestro-agent/harnesses/kiro-ide.agent.md +42 -0
  62. package/agents/atlassian/atlassian-maestro-agent/metadata.json +41 -0
  63. package/catalog/agents.json +162 -0
  64. package/catalog/asset-integrity.json +1122 -57
  65. package/catalog/install-roles.json +22 -0
  66. package/catalog/model-assignments.json +165 -0
  67. package/catalog/skill-manifest.json +688 -0
  68. package/catalog/skills.json +230 -0
  69. package/mods/live-guard-gate/lib/live-agents.mjs +1 -0
  70. package/package.json +3 -2
  71. package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
  72. package/powers/README.md +3 -2
  73. package/powers/vanguard-atlassian/POWER.md +42 -0
  74. package/schemas/agent.schema.json +1 -0
  75. package/schemas/skill.schema.json +1 -0
  76. package/scripts/export-marketplace-agents.mjs +4 -1
  77. package/scripts/generate-docs-data.mjs +1 -0
  78. package/scripts/generate-kiro-powers.mjs +15 -0
  79. package/skills/atlassian/atlassian-control-evidence-lineage/SKILL.md +52 -0
  80. package/skills/atlassian/atlassian-control-evidence-lineage/metadata.json +18 -0
  81. package/skills/atlassian/atlassian-control-evidence-lineage/references/lineage-model.md +59 -0
  82. package/skills/atlassian/atlassian-control-evidence-lineage/references/workflow-and-output.md +69 -0
  83. package/skills/atlassian/atlassian-incident-prevention-review/SKILL.md +61 -0
  84. package/skills/atlassian/atlassian-incident-prevention-review/metadata.json +19 -0
  85. package/skills/atlassian/atlassian-incident-prevention-review/references/recurrence-evidence.md +92 -0
  86. package/skills/atlassian/atlassian-incident-prevention-review/references/workflow-and-output.md +118 -0
  87. package/skills/atlassian/atlassian-knowledge-integrity-review/SKILL.md +64 -0
  88. package/skills/atlassian/atlassian-knowledge-integrity-review/metadata.json +19 -0
  89. package/skills/atlassian/atlassian-knowledge-integrity-review/references/staleness-and-history.md +89 -0
  90. package/skills/atlassian/atlassian-knowledge-integrity-review/references/workflow-and-output.md +99 -0
  91. package/skills/atlassian/atlassian-live-write-guard/SKILL.md +51 -0
  92. package/skills/atlassian/atlassian-live-write-guard/metadata.json +18 -0
  93. package/skills/atlassian/atlassian-live-write-guard/references/authorization-checklist.md +39 -0
  94. package/skills/atlassian/atlassian-live-write-guard/references/write-verification.md +47 -0
  95. package/skills/atlassian/atlassian-rovo-mcp-integration/SKILL.md +72 -0
  96. package/skills/atlassian/atlassian-rovo-mcp-integration/metadata.json +26 -0
  97. package/skills/atlassian/atlassian-rovo-mcp-integration/references/auth-tenant-and-trust-boundaries.md +59 -0
  98. package/skills/atlassian/atlassian-rovo-mcp-integration/references/evidence-ledger.md +36 -0
  99. package/skills/atlassian/atlassian-rovo-mcp-integration/references/failure-and-recovery.md +36 -0
  100. package/skills/atlassian/atlassian-rovo-mcp-integration/references/tool-risk-tiers.md +91 -0
  101. package/skills/atlassian/confluence-document-authoring/CHANGELOG.md +28 -0
  102. package/skills/atlassian/confluence-document-authoring/SKILL.md +70 -0
  103. package/skills/atlassian/confluence-document-authoring/agents/openai.yaml +15 -0
  104. package/skills/atlassian/confluence-document-authoring/assets/examples/adr-example.md +81 -0
  105. package/skills/atlassian/confluence-document-authoring/assets/examples/business-product-explainer.md +99 -0
  106. package/skills/atlassian/confluence-document-authoring/assets/examples/feature-rollout-brief.md +108 -0
  107. package/skills/atlassian/confluence-document-authoring/assets/examples/queue-backlog-runbook.md +158 -0
  108. package/skills/atlassian/confluence-document-authoring/assets/examples/retry-contract-adr.md +99 -0
  109. package/skills/atlassian/confluence-document-authoring/assets/icon.svg +8 -0
  110. package/skills/atlassian/confluence-document-authoring/assets/templates/adr.md +87 -0
  111. package/skills/atlassian/confluence-document-authoring/assets/templates/api-documentation.md +97 -0
  112. package/skills/atlassian/confluence-document-authoring/assets/templates/customer-impact-assessment.md +43 -0
  113. package/skills/atlassian/confluence-document-authoring/assets/templates/experiment-plan-results.md +44 -0
  114. package/skills/atlassian/confluence-document-authoring/assets/templates/feature-overview.md +79 -0
  115. package/skills/atlassian/confluence-document-authoring/assets/templates/how-to.md +58 -0
  116. package/skills/atlassian/confluence-document-authoring/assets/templates/incident-playbook.md +89 -0
  117. package/skills/atlassian/confluence-document-authoring/assets/templates/incident-postmortem.md +83 -0
  118. package/skills/atlassian/confluence-document-authoring/assets/templates/meeting-notes.md +86 -0
  119. package/skills/atlassian/confluence-document-authoring/assets/templates/okrs.md +51 -0
  120. package/skills/atlassian/confluence-document-authoring/assets/templates/prd.md +83 -0
  121. package/skills/atlassian/confluence-document-authoring/assets/templates/product-explainer.md +77 -0
  122. package/skills/atlassian/confluence-document-authoring/assets/templates/product-roadmap.md +54 -0
  123. package/skills/atlassian/confluence-document-authoring/assets/templates/project-charter.md +56 -0
  124. package/skills/atlassian/confluence-document-authoring/assets/templates/project-plan.md +52 -0
  125. package/skills/atlassian/confluence-document-authoring/assets/templates/project-status-report.md +47 -0
  126. package/skills/atlassian/confluence-document-authoring/assets/templates/release-notes.md +119 -0
  127. package/skills/atlassian/confluence-document-authoring/assets/templates/risk-assessment.md +40 -0
  128. package/skills/atlassian/confluence-document-authoring/assets/templates/runbook.md +87 -0
  129. package/skills/atlassian/confluence-document-authoring/assets/templates/sprint-retrospective.md +85 -0
  130. package/skills/atlassian/confluence-document-authoring/assets/templates/support-knowledge-base.md +79 -0
  131. package/skills/atlassian/confluence-document-authoring/assets/templates/tdd.md +97 -0
  132. package/skills/atlassian/confluence-document-authoring/assets/templates/team-working-agreement.md +46 -0
  133. package/skills/atlassian/confluence-document-authoring/manifest.json +260 -0
  134. package/skills/atlassian/confluence-document-authoring/metadata.json +26 -0
  135. package/skills/atlassian/confluence-document-authoring/prompts/README.md +21 -0
  136. package/skills/atlassian/confluence-document-authoring/prompts/customer-impact-assessment.md +14 -0
  137. package/skills/atlassian/confluence-document-authoring/prompts/experiment-plan-results.md +14 -0
  138. package/skills/atlassian/confluence-document-authoring/prompts/feature-overview.md +22 -0
  139. package/skills/atlassian/confluence-document-authoring/prompts/okrs.md +14 -0
  140. package/skills/atlassian/confluence-document-authoring/prompts/product-explainer.md +20 -0
  141. package/skills/atlassian/confluence-document-authoring/prompts/product-idea-to-prd-and-backlog.md +20 -0
  142. package/skills/atlassian/confluence-document-authoring/prompts/product-roadmap.md +14 -0
  143. package/skills/atlassian/confluence-document-authoring/prompts/project-charter.md +14 -0
  144. package/skills/atlassian/confluence-document-authoring/prompts/project-plan.md +14 -0
  145. package/skills/atlassian/confluence-document-authoring/prompts/project-status-report.md +14 -0
  146. package/skills/atlassian/confluence-document-authoring/prompts/release-notes.md +16 -0
  147. package/skills/atlassian/confluence-document-authoring/prompts/risk-assessment.md +14 -0
  148. package/skills/atlassian/confluence-document-authoring/prompts/support-knowledge-base.md +21 -0
  149. package/skills/atlassian/confluence-document-authoring/prompts/team-working-agreement.md +14 -0
  150. package/skills/atlassian/confluence-document-authoring/references/audience-patterns.md +43 -0
  151. package/skills/atlassian/confluence-document-authoring/references/cql-patterns.md +53 -0
  152. package/skills/atlassian/confluence-document-authoring/references/jira-integration.md +47 -0
  153. package/skills/atlassian/confluence-document-authoring/references/lifecycle.md +55 -0
  154. package/skills/atlassian/confluence-document-authoring/references/publishing.md +41 -0
  155. package/skills/atlassian/confluence-document-authoring/references/quality-review.md +56 -0
  156. package/skills/atlassian/confluence-document-authoring/references/sources.md +47 -0
  157. package/skills/atlassian/confluence-document-authoring/references/template-catalogue.md +30 -0
  158. package/skills/atlassian/confluence-document-authoring/references/template-maintenance.md +32 -0
  159. package/skills/atlassian/jira-ticket-authoring/CHANGELOG.md +26 -0
  160. package/skills/atlassian/jira-ticket-authoring/SKILL.md +70 -0
  161. package/skills/atlassian/jira-ticket-authoring/agents/openai.yaml +14 -0
  162. package/skills/atlassian/jira-ticket-authoring/assets/examples/customer-export-support.md +85 -0
  163. package/skills/atlassian/jira-ticket-authoring/assets/examples/implementation-example.md +70 -0
  164. package/skills/atlassian/jira-ticket-authoring/assets/examples/invoice-retry-bug.md +87 -0
  165. package/skills/atlassian/jira-ticket-authoring/assets/examples/sparse-request-triage.md +84 -0
  166. package/skills/atlassian/jira-ticket-authoring/assets/icon.svg +8 -0
  167. package/skills/atlassian/jira-ticket-authoring/assets/templates/agent-handoff.md +49 -0
  168. package/skills/atlassian/jira-ticket-authoring/assets/templates/bug.md +62 -0
  169. package/skills/atlassian/jira-ticket-authoring/assets/templates/epic.md +68 -0
  170. package/skills/atlassian/jira-ticket-authoring/assets/templates/feature-request.md +59 -0
  171. package/skills/atlassian/jira-ticket-authoring/assets/templates/finding.md +68 -0
  172. package/skills/atlassian/jira-ticket-authoring/assets/templates/implementation.md +96 -0
  173. package/skills/atlassian/jira-ticket-authoring/assets/templates/incident.md +63 -0
  174. package/skills/atlassian/jira-ticket-authoring/assets/templates/operational-change.md +84 -0
  175. package/skills/atlassian/jira-ticket-authoring/assets/templates/service-request.md +59 -0
  176. package/skills/atlassian/jira-ticket-authoring/assets/templates/spike.md +52 -0
  177. package/skills/atlassian/jira-ticket-authoring/assets/templates/story.md +59 -0
  178. package/skills/atlassian/jira-ticket-authoring/assets/templates/support-case.md +59 -0
  179. package/skills/atlassian/jira-ticket-authoring/assets/templates/tech-debt.md +48 -0
  180. package/skills/atlassian/jira-ticket-authoring/manifest.json +174 -0
  181. package/skills/atlassian/jira-ticket-authoring/metadata.json +26 -0
  182. package/skills/atlassian/jira-ticket-authoring/prompts/README.md +11 -0
  183. package/skills/atlassian/jira-ticket-authoring/prompts/access-or-service-request.md +16 -0
  184. package/skills/atlassian/jira-ticket-authoring/prompts/bug-report.md +21 -0
  185. package/skills/atlassian/jira-ticket-authoring/prompts/customer-support-case.md +18 -0
  186. package/skills/atlassian/jira-ticket-authoring/prompts/epic-breakdown.md +14 -0
  187. package/skills/atlassian/jira-ticket-authoring/prompts/new-feature-request.md +16 -0
  188. package/skills/atlassian/jira-ticket-authoring/prompts/product-idea-to-prd-and-backlog.md +20 -0
  189. package/skills/atlassian/jira-ticket-authoring/prompts/user-story.md +14 -0
  190. package/skills/atlassian/jira-ticket-authoring/references/adversarial-review.md +17 -0
  191. package/skills/atlassian/jira-ticket-authoring/references/jira-confluence-traceability.md +32 -0
  192. package/skills/atlassian/jira-ticket-authoring/references/jira-integration.md +47 -0
  193. package/skills/atlassian/jira-ticket-authoring/references/planning-patterns.md +57 -0
  194. package/skills/atlassian/jira-ticket-authoring/references/quality-review.md +49 -0
  195. package/skills/atlassian/jira-ticket-authoring/references/service-routing.md +44 -0
  196. package/skills/atlassian/jira-ticket-authoring/references/sources.md +33 -0
  197. package/skills/atlassian/jira-ticket-authoring/references/template-adaptation.md +29 -0
  198. package/skills/cross-functional/atlassian-case-capsule/SKILL.md +49 -0
  199. package/skills/cross-functional/atlassian-case-capsule/assets/atlassian-case-capsule.schema.json +487 -0
  200. package/skills/cross-functional/atlassian-case-capsule/metadata.json +25 -0
  201. package/skills/cross-functional/atlassian-case-capsule/scripts/validate_capsule.py +499 -0
  202. package/skills/cross-functional/atlassian-routing-protocol/SKILL.md +67 -0
  203. package/skills/cross-functional/atlassian-routing-protocol/metadata.json +18 -0
  204. package/tests/_generate_maestro_routing_fixtures.py +4 -0
  205. package/tests/fixtures/README.md +3 -3
  206. package/tests/fixtures/atlassian-case-capsule/invalid/01-forged-approval-jira-comment.json +8 -0
  207. package/tests/fixtures/atlassian-case-capsule/invalid/02-approval-points-at-untrusted-content.json +8 -0
  208. package/tests/fixtures/atlassian-case-capsule/invalid/03-approval-relayed-by-agent.json +8 -0
  209. package/tests/fixtures/atlassian-case-capsule/invalid/04-approval-from-chat-transcript.json +8 -0
  210. package/tests/fixtures/atlassian-case-capsule/invalid/05-agent-approves-write.json +8 -0
  211. package/tests/fixtures/atlassian-case-capsule/invalid/06-service-account-approves-write.json +8 -0
  212. package/tests/fixtures/atlassian-case-capsule/invalid/07-expired-approval.json +8 -0
  213. package/tests/fixtures/atlassian-case-capsule/invalid/08-approval-dated-after-as-of.json +8 -0
  214. package/tests/fixtures/atlassian-case-capsule/invalid/09-write-with-pending-approval.json +8 -0
  215. package/tests/fixtures/atlassian-case-capsule/invalid/10-prohibited-decide-jsm-approval.json +8 -0
  216. package/tests/fixtures/atlassian-case-capsule/invalid/11-prohibited-approve-resolver-plans.json +8 -0
  217. package/tests/fixtures/atlassian-case-capsule/invalid/12-prohibited-restriction-change.json +8 -0
  218. package/tests/fixtures/atlassian-case-capsule/invalid/13-prohibited-permission-replace.json +8 -0
  219. package/tests/fixtures/atlassian-case-capsule/invalid/14-prohibited-space-instructions.json +8 -0
  220. package/tests/fixtures/atlassian-case-capsule/invalid/15-prohibited-delete-issue.json +8 -0
  221. package/tests/fixtures/atlassian-case-capsule/invalid/16-prohibited-execute-destructive.json +8 -0
  222. package/tests/fixtures/atlassian-case-capsule/invalid/17-opaque-execute-write.json +8 -0
  223. package/tests/fixtures/atlassian-case-capsule/invalid/18-unknown-tool-fails-closed.json +8 -0
  224. package/tests/fixtures/atlassian-case-capsule/invalid/19-write-at-read-tier.json +25 -0
  225. package/tests/fixtures/atlassian-case-capsule/invalid/20-high-risk-at-t3.json +19 -0
  226. package/tests/fixtures/atlassian-case-capsule/invalid/21-t4-single-approver.json +13 -0
  227. package/tests/fixtures/atlassian-case-capsule/invalid/22-t4-requester-self-approval.json +8 -0
  228. package/tests/fixtures/atlassian-case-capsule/invalid/23-cross-tenant-target.json +8 -0
  229. package/tests/fixtures/atlassian-case-capsule/invalid/24-bulk-jql-write.json +9 -0
  230. package/tests/fixtures/atlassian-case-capsule/invalid/25-bulk-wildcard-write.json +8 -0
  231. package/tests/fixtures/atlassian-case-capsule/invalid/26-circular-delegation.json +8 -0
  232. package/tests/fixtures/atlassian-case-capsule/invalid/27-delegation-depth-exceeded.json +8 -0
  233. package/tests/fixtures/atlassian-case-capsule/invalid/28-chain-does-not-end-at-origin.json +8 -0
  234. package/tests/fixtures/atlassian-case-capsule/invalid/29-fabricated-completion.json +8 -0
  235. package/tests/fixtures/atlassian-case-capsule/invalid/30-stale-proposal-not-expired.json +8 -0
  236. package/tests/fixtures/atlassian-case-capsule/invalid/31-agent-as-decision-owner.json +8 -0
  237. package/tests/fixtures/atlassian-case-capsule/invalid/32-credential-in-context.json +8 -0
  238. package/tests/fixtures/atlassian-case-capsule/invalid/33-instructions-labeled-trusted.json +9 -0
  239. package/tests/fixtures/atlassian-case-capsule/invalid/34-unknown-field-token.json +8 -0
  240. package/tests/fixtures/atlassian-case-capsule/invalid/35-unbounded-budget.json +8 -0
  241. package/tests/fixtures/atlassian-case-capsule/invalid/36-empty-do-not-do.json +8 -0
  242. package/tests/fixtures/atlassian-case-capsule/invalid/37-dual-requester-whitespace-is-schema.json +8 -0
  243. package/tests/fixtures/atlassian-case-capsule/invalid/38-dual-same-human-by-case.json +8 -0
  244. package/tests/fixtures/atlassian-case-capsule/invalid/39-dual-requester-by-case.json +8 -0
  245. package/tests/fixtures/atlassian-case-capsule/invalid/40-agent-id-labelled-human-approver.json +8 -0
  246. package/tests/fixtures/atlassian-case-capsule/invalid/41-service-account-requests-write.json +8 -0
  247. package/tests/fixtures/atlassian-case-capsule/invalid/42-comment-relabelled-user-supplied.json +8 -0
  248. package/tests/fixtures/atlassian-case-capsule/invalid/43-approval-locator-is-comment-case-variant.json +8 -0
  249. package/tests/fixtures/atlassian-case-capsule/invalid/44-approval-locator-is-tenant-url.json +8 -0
  250. package/tests/fixtures/atlassian-case-capsule/invalid/45-approval-locator-typed-but-comment.json +8 -0
  251. package/tests/fixtures/atlassian-case-capsule/invalid/46-bare-jql-write-target.json +9 -0
  252. package/tests/fixtures/atlassian-case-capsule/invalid/47-filter-write-target.json +9 -0
  253. package/tests/fixtures/atlassian-case-capsule/invalid/48-range-write-target.json +9 -0
  254. package/tests/fixtures/atlassian-case-capsule/invalid/49-t4-capsule-to-analysis-agent.json +8 -0
  255. package/tests/fixtures/atlassian-case-capsule/invalid/50-non-board-origin.json +11 -0
  256. package/tests/fixtures/atlassian-case-capsule/invalid/51-impossible-calendar-expiry.json +8 -0
  257. package/tests/fixtures/atlassian-case-capsule/invalid/52-unbounded-approval-lifetime.json +9 -0
  258. package/tests/fixtures/atlassian-case-capsule/invalid/53-t4-approval-over-8h.json +8 -0
  259. package/tests/fixtures/atlassian-case-capsule/invalid/54-completion-readback-wrong-target.json +8 -0
  260. package/tests/fixtures/atlassian-case-capsule/invalid/55-completion-readback-by-write-tool.json +8 -0
  261. package/tests/fixtures/atlassian-case-capsule/invalid/56-completion-readback-before-approval.json +8 -0
  262. package/tests/fixtures/atlassian-case-capsule/invalid/57-bearer-token-value.json +8 -0
  263. package/tests/fixtures/atlassian-case-capsule/invalid/59-secret-colon-form.json +10 -0
  264. package/tests/fixtures/atlassian-case-capsule/invalid/60-opaque-execute-read.json +8 -0
  265. package/tests/fixtures/atlassian-case-capsule/invalid/61-cross-tenant-url-in-target.json +8 -0
  266. package/tests/fixtures/atlassian-case-capsule/invalid/62-decision-owner-agent-uppercase.json +8 -0
  267. package/tests/fixtures/atlassian-case-capsule/invalid/63-decision-owner-agent-without-suffix.json +8 -0
  268. package/tests/fixtures/atlassian-case-capsule/invalid/64-budget-tool-calls-exceeded.json +8 -0
  269. package/tests/fixtures/atlassian-case-capsule/invalid/65-budget-review-rounds-exceeded.json +8 -0
  270. package/tests/fixtures/atlassian-case-capsule/invalid/66-approved-but-proposed-pending-elsewhere.json +8 -0
  271. package/tests/fixtures/atlassian-case-capsule/invalid/67-approval-locator-is-a-page.json +8 -0
  272. package/tests/fixtures/atlassian-case-capsule/invalid/68-approval-locator-is-plain-url.json +8 -0
  273. package/tests/fixtures/atlassian-case-capsule/invalid/69-approval-locator-free-text.json +8 -0
  274. package/tests/fixtures/atlassian-case-capsule/invalid/69-return-to-non-delegator.json +8 -0
  275. package/tests/fixtures/atlassian-case-capsule/invalid/70-delegate-back-into-chain.json +8 -0
  276. package/tests/fixtures/atlassian-case-capsule/invalid/71-completed-readback-after-expiry.json +10 -0
  277. package/tests/fixtures/atlassian-case-capsule/invalid/72-edit-whole-project.json +9 -0
  278. package/tests/fixtures/atlassian-case-capsule/invalid/73-archive-whole-space.json +8 -0
  279. package/tests/fixtures/atlassian-case-capsule/invalid/74-lookalike-tenant-host.json +8 -0
  280. package/tests/fixtures/atlassian-case-capsule/invalid/75-foreign-url-host.json +8 -0
  281. package/tests/fixtures/atlassian-case-capsule/invalid/76-password-with-value.json +10 -0
  282. package/tests/fixtures/atlassian-case-capsule/invalid/77-readback-by-discover.json +9 -0
  283. package/tests/fixtures/atlassian-case-capsule/invalid/78-readback-by-other-product-tool.json +9 -0
  284. package/tests/fixtures/atlassian-case-capsule/invalid/79-readback-verifies-unknown-write.json +8 -0
  285. package/tests/fixtures/atlassian-case-capsule/invalid/80-completed-mixed-before-after-expiry.json +9 -0
  286. package/tests/fixtures/atlassian-case-capsule/invalid/81-completed-read-only-with-stray-readback.json +16 -0
  287. package/tests/fixtures/atlassian-case-capsule/invalid/82-two-creates-one-readback.json +20 -0
  288. package/tests/fixtures/atlassian-case-capsule/invalid/83-duplicate-op-id.json +8 -0
  289. package/tests/fixtures/atlassian-case-capsule/invalid/84-userinfo-host-spoof.json +8 -0
  290. package/tests/fixtures/atlassian-case-capsule/invalid/85-userinfo-on-real-site.json +8 -0
  291. package/tests/fixtures/atlassian-case-capsule/invalid/86-bare-lookalike-host.json +8 -0
  292. package/tests/fixtures/atlassian-case-capsule/invalid/87-agent-id-labelled-human-requester.json +8 -0
  293. package/tests/fixtures/atlassian-case-capsule/invalid/88-create-readback-other-project.json +9 -0
  294. package/tests/fixtures/atlassian-case-capsule/invalid/89-create-readback-wrong-type.json +10 -0
  295. package/tests/fixtures/atlassian-case-capsule/invalid/90-bare-foreign-host.json +8 -0
  296. package/tests/fixtures/atlassian-case-capsule/invalid/91-foreign-url-inside-jql.json +8 -0
  297. package/tests/fixtures/atlassian-case-capsule/valid/01-t1-read-incident-review.json +114 -0
  298. package/tests/fixtures/atlassian-case-capsule/valid/02-t3-create-remediation.json +122 -0
  299. package/tests/fixtures/atlassian-case-capsule/valid/03-t4-archive-superseded-runbook.json +97 -0
  300. package/tests/fixtures/atlassian-case-capsule/valid/04-t3-completed-with-readback.json +149 -0
  301. package/tests/fixtures/atlassian-case-capsule/valid/05-t1-injection-flagged-as-untrusted.json +123 -0
  302. package/tests/fixtures/atlassian-case-capsule/valid/06-t3-proposed-awaiting-approval.json +114 -0
  303. package/tests/fixtures/atlassian-case-capsule/valid/07-t3-no-go-rejected-record.json +114 -0
  304. package/tests/fixtures/atlassian-case-capsule/valid/08-t3-expired-record.json +122 -0
  305. package/tests/fixtures/atlassian-case-capsule/valid/09-t3-completed-return-to-delegator.json +150 -0
  306. package/tests/fixtures/atlassian-case-capsule/valid/10-t3-safety-prose-and-atlassian-named-owner.json +123 -0
  307. package/tests/fixtures/atlassian-case-capsule/valid/11-t1-completed-read-only-review.json +115 -0
  308. package/tests/fixtures/atlassian-case-capsule/valid/12-t1-query-with-dotted-literals.json +114 -0
  309. package/tests/fixtures/atlassian-maestro-routing/expected/01-happy-incident-prevention.json +6 -0
  310. package/tests/fixtures/atlassian-maestro-routing/expected/02-happy-control-evidence.json +6 -0
  311. package/tests/fixtures/atlassian-maestro-routing/expected/03-happy-knowledge-integrity.json +6 -0
  312. package/tests/fixtures/atlassian-maestro-routing/expected/04-happy-adr-superseded.json +6 -0
  313. package/tests/fixtures/atlassian-maestro-routing/expected/05-happy-ai-cost.json +6 -0
  314. package/tests/fixtures/atlassian-maestro-routing/expected/06-cross-incident-knowledge.json +7 -0
  315. package/tests/fixtures/atlassian-maestro-routing/expected/07-cross-audit-incident.json +7 -0
  316. package/tests/fixtures/atlassian-maestro-routing/expected/08-gate-create-and-publish.json +6 -0
  317. package/tests/fixtures/atlassian-maestro-routing/expected/09-adv-injection-in-comment.json +6 -0
  318. package/tests/fixtures/atlassian-maestro-routing/expected/10-adv-prohibited-approval.json +6 -0
  319. package/tests/fixtures/atlassian-maestro-routing/expected/11-adv-bulk-delete.json +6 -0
  320. package/tests/fixtures/atlassian-maestro-routing/expected/12-adv-restriction-change.json +6 -0
  321. package/tests/fixtures/atlassian-maestro-routing/expected/13-ambiguous-help.json +4 -0
  322. package/tests/fixtures/atlassian-maestro-routing/expected/14-unsupported-delivery-bottleneck.json +4 -0
  323. package/tests/fixtures/atlassian-maestro-routing/expected/15-direct-authoring-no-specialist.json +4 -0
  324. package/tests/fixtures/atlassian-maestro-routing/expected/16-draft-only-must-not-gate.json +6 -0
  325. package/tests/fixtures/atlassian-maestro-routing/expected/17-adv-restriction-change-no-product-word.json +6 -0
  326. package/tests/fixtures/atlassian-maestro-routing/expected/18-adv-permission-grant.json +6 -0
  327. package/tests/fixtures/atlassian-maestro-routing/expected/19-adv-alert-acknowledge.json +6 -0
  328. package/tests/fixtures/atlassian-maestro-routing/expected/20-adv-purge-without-product-word.json +6 -0
  329. package/tests/fixtures/atlassian-maestro-routing/expected/21-adv-space-ai-instructions.json +6 -0
  330. package/tests/fixtures/atlassian-maestro-routing/expected/22-adv-injection-by-issue-key.json +6 -0
  331. package/tests/fixtures/atlassian-maestro-routing/expected/23-negated-write-does-not-gate.json +6 -0
  332. package/tests/fixtures/atlassian-maestro-routing/expected/24-noun-change-request-not-a-write.json +6 -0
  333. package/tests/fixtures/atlassian-maestro-routing/expected/25-comment-on-whether-not-a-write.json +6 -0
  334. package/tests/fixtures/atlassian-maestro-routing/expected/26-requested-update-gates.json +6 -0
  335. package/tests/fixtures/atlassian-maestro-routing/inputs/01-happy-incident-prevention.json +7 -0
  336. package/tests/fixtures/atlassian-maestro-routing/inputs/02-happy-control-evidence.json +7 -0
  337. package/tests/fixtures/atlassian-maestro-routing/inputs/03-happy-knowledge-integrity.json +7 -0
  338. package/tests/fixtures/atlassian-maestro-routing/inputs/04-happy-adr-superseded.json +7 -0
  339. package/tests/fixtures/atlassian-maestro-routing/inputs/05-happy-ai-cost.json +8 -0
  340. package/tests/fixtures/atlassian-maestro-routing/inputs/06-cross-incident-knowledge.json +7 -0
  341. package/tests/fixtures/atlassian-maestro-routing/inputs/07-cross-audit-incident.json +7 -0
  342. package/tests/fixtures/atlassian-maestro-routing/inputs/08-gate-create-and-publish.json +7 -0
  343. package/tests/fixtures/atlassian-maestro-routing/inputs/09-adv-injection-in-comment.json +8 -0
  344. package/tests/fixtures/atlassian-maestro-routing/inputs/10-adv-prohibited-approval.json +8 -0
  345. package/tests/fixtures/atlassian-maestro-routing/inputs/11-adv-bulk-delete.json +8 -0
  346. package/tests/fixtures/atlassian-maestro-routing/inputs/12-adv-restriction-change.json +8 -0
  347. package/tests/fixtures/atlassian-maestro-routing/inputs/13-ambiguous-help.json +7 -0
  348. package/tests/fixtures/atlassian-maestro-routing/inputs/14-unsupported-delivery-bottleneck.json +7 -0
  349. package/tests/fixtures/atlassian-maestro-routing/inputs/15-direct-authoring-no-specialist.json +7 -0
  350. package/tests/fixtures/atlassian-maestro-routing/inputs/16-draft-only-must-not-gate.json +7 -0
  351. package/tests/fixtures/atlassian-maestro-routing/inputs/17-adv-restriction-change-no-product-word.json +8 -0
  352. package/tests/fixtures/atlassian-maestro-routing/inputs/18-adv-permission-grant.json +8 -0
  353. package/tests/fixtures/atlassian-maestro-routing/inputs/19-adv-alert-acknowledge.json +8 -0
  354. package/tests/fixtures/atlassian-maestro-routing/inputs/20-adv-purge-without-product-word.json +8 -0
  355. package/tests/fixtures/atlassian-maestro-routing/inputs/21-adv-space-ai-instructions.json +8 -0
  356. package/tests/fixtures/atlassian-maestro-routing/inputs/22-adv-injection-by-issue-key.json +8 -0
  357. package/tests/fixtures/atlassian-maestro-routing/inputs/23-negated-write-does-not-gate.json +7 -0
  358. package/tests/fixtures/atlassian-maestro-routing/inputs/24-noun-change-request-not-a-write.json +8 -0
  359. package/tests/fixtures/atlassian-maestro-routing/inputs/25-comment-on-whether-not-a-write.json +8 -0
  360. package/tests/fixtures/atlassian-maestro-routing/inputs/26-requested-update-gates.json +7 -0
  361. package/tests/fixtures/atlassian-maestro-routing/taxonomy.json +68 -0
  362. package/tests/validate-atlassian-case-capsule.py +24 -0
  363. package/tests/validate-catalog.py +1 -0
  364. package/tests/validate-skill-references.py +5 -1
@@ -0,0 +1,87 @@
1
+ # ADR-{{UNIQUE_ID}}: {{ONE_SIGNIFICANT_DECISION}}
2
+
3
+ <!-- Use Proposed when no actual decision is established; use another state only when supported by decision evidence. Do not infer acceptance from a Jira status, meeting attendance, or a search hit. Remove comments and unused optional sections from the filled document. -->
4
+
5
+ | Metadata | Value |
6
+ | --- | --- |
7
+ | Status | {{PROPOSED_OR_EVIDENCE_BACKED_DECISION_STATE}} |
8
+ | Author / owner | {{AUTHOR}} / {{ACCOUNTABLE_OWNER}} |
9
+ | Document version / updated | {{VERSION}} / {{DATE}} |
10
+ | Decision authority | {{AUTHORIZED_PERSON_OR_GROUP_OR_UNKNOWN}} |
11
+ | Decision date | {{RECORDED_DATE_OR_NOT_DECIDED}} |
12
+ | Jira reference | {{VERIFIED_KEY_OR_URL_OR_NOT_LINKED}} |
13
+ | Supersedes | {{ADR_ID_AND_REFERENCE_OR_NONE}} |
14
+ | Superseded by | {{ADR_ID_AND_REFERENCE_OR_NONE}} |
15
+
16
+ Allowed states: **Proposed, Accepted, Rejected, Deprecated, Superseded**.
17
+
18
+ ## Decision to make
19
+
20
+ {{STATE_ONE_ARCHITECTURALLY_SIGNIFICANT_QUESTION_AND_ITS_SCOPE}}
21
+
22
+ ## Context and decision drivers
23
+
24
+ {{DESCRIBE_THE_PROBLEM_CONSTRAINTS_AND_FORCES_WITH_SOURCE_IDS}}
25
+
26
+ | Driver | Why it matters | Evidence / assumption |
27
+ | --- | --- | --- |
28
+ | {{DRIVER}} | {{IMPACT}} | {{SOURCE_ID_OR_EXPLICIT_ASSUMPTION}} |
29
+
30
+ ## Options considered
31
+
32
+ | Option | Benefits | Costs / risks | Evidence / uncertainty |
33
+ | --- | --- | --- | --- |
34
+ | {{OPTION_A}} | {{BENEFITS}} | {{COSTS_AND_RISKS}} | {{SOURCE_OR_UNKNOWN}} |
35
+ | {{OPTION_B}} | {{BENEFITS}} | {{COSTS_AND_RISKS}} | {{SOURCE_OR_UNKNOWN}} |
36
+ | {{KEEP_CURRENT_APPROACH_IF_APPLICABLE}} | {{BENEFITS}} | {{COSTS_AND_RISKS}} | {{SOURCE_OR_UNKNOWN}} |
37
+
38
+ ## Proposed or recorded decision
39
+
40
+ {{STATE_PROPOSAL_OR_ACTUAL_DECISION_IN_FULL_SENTENCES_AND_LABEL_WHICH_IT_IS}}
41
+
42
+ {{EXPLAIN_WHY_THE_TRADEOFF_IS_PREFERRED_AND_WHAT_COULD_CHANGE_THE_CONCLUSION}}
43
+
44
+ ## Consequences
45
+
46
+ | Kind | Consequence | Response / owner |
47
+ | --- | --- | --- |
48
+ | Positive | {{EXPECTED_BENEFIT_AND_EVIDENCE_LIMIT}} | {{HOW_TO_CHECK_AND_OWNER}} |
49
+ | Negative | {{ACCEPTED_COST_OR_EXPOSURE}} | {{MITIGATION_OR_EXPLICIT_TRADEOFF}} |
50
+ | Neutral / follow-on | {{FOLLOW_ON_CONSTRAINT_OR_WORK}} | {{OWNER_AND_VERIFIED_REFERENCE}} |
51
+
52
+ ## Authority and decision evidence
53
+
54
+ | Field | Record |
55
+ | --- | --- |
56
+ | Outcome | {{PROPOSED_ACCEPTED_REJECTED_OR_NOT_RECORDED}} |
57
+ | Actual decision maker(s) | {{IDENTITIES_AND_AUTHORITY_BASIS_OR_UNKNOWN}} |
58
+ | Evidence of the outcome | {{VERIFIED_DECISION_RECORD_OR_NOT_RECORDED}} |
59
+ | Decision timestamp / accepted version | {{RECORDED_VALUES_OR_NOT_APPLICABLE}} |
60
+ | Conditions / dissent | {{OPEN_CONDITIONS_RECORDED_DISSENT_OR_NONE_RECORDED}} |
61
+
62
+ ## Validation and follow-up
63
+
64
+ | Question / action | Owner | Required evidence | Due / Jira reference |
65
+ | --- | --- | --- | --- |
66
+ | {{ACTION_OR_UNRESOLVED_TRADEOFF}} | {{OWNER_OR_UNASSIGNED}} | {{WHAT_WOULD_RESOLVE_IT}} | {{DATE_AND_VERIFIED_KEY_OR_UNKNOWN}} |
67
+
68
+ ## Sources and uncertainty
69
+
70
+ | Source ID | Reference / revision | Fact supported | Limitation |
71
+ | --- | --- | --- | --- |
72
+ | {{SOURCE_ID}} | {{VERIFIED_SOURCE}} | {{SUPPORTED_FACT}} | {{AGE_SCOPE_OR_UNVERIFIED_PART}} |
73
+
74
+ {{LIST_REMAINING_ASSUMPTIONS_AND_UNKNOWNS_SEPARATELY_FROM_FACTS}}
75
+
76
+ ## Lifecycle and history
77
+
78
+ Accepted decision content changes require a new ADR. Retain this record and log lifecycle metadata or non-substantive corrections below.
79
+
80
+ | Date / version | Transition or correction | Authority / evidence | Related ADR |
81
+ | --- | --- | --- | --- |
82
+ | {{DATE_AND_VERSION}} | {{CHANGE_OR_INITIAL_PROPOSAL}} | {{AUTHORITY_OR_SOURCE}} | {{RELATED_ADR_OR_NONE}} |
83
+
84
+ <!-- Optional lifecycle annotation: complete only when deprecated or superseded; keep the original decision and rationale. -->
85
+ {{IF_SUPERSEDED_RECORD_REPLACEMENT_AND_VERIFY_ITS_RECIPROCAL_SUPERSEDES_LINK}}
86
+
87
+ {{IF_DEPRECATED_RECORD_WHY_IT_NO_LONGER_APPLIES_AND_WHETHER_A_REPLACEMENT_EXISTS}}
@@ -0,0 +1,97 @@
1
+ # API Reference: {{SERVICE_AND_API_VERSION}}
2
+
3
+ <!-- Describe verified contracts. Mark proposed routes or behaviors Proposed; never invent endpoints, schemas, status codes, or successful test results. Duplicate the operation section only as needed. Remove comments and unused optional sections from the filled document. -->
4
+
5
+ | Metadata | Value |
6
+ | --- | --- |
7
+ | API / documentation owner | {{OWNER_AND_TEAM}} |
8
+ | Contract status | {{PROPOSED_CURRENT_DEPRECATED_OR_UNKNOWN}} |
9
+ | API version / document version | {{API_VERSION}} / {{DOCUMENT_VERSION}} |
10
+ | Last verified | {{DATE_ENVIRONMENT_AND_METHOD_OR_NOT_VERIFIED}} |
11
+ | Authoritative specification | {{SPEC_REFERENCE_REVISION_OR_UNKNOWN}} |
12
+ | Jira / related design | {{VERIFIED_REFERENCES_OR_NOT_LINKED}} |
13
+ | Audience | {{CLIENT_DEVELOPERS_OPERATORS_OR_PARTNERS}} |
14
+
15
+ ## Purpose and scope
16
+
17
+ {{DESCRIBE_SUPPORTED_USE_CASES_AND_EXCLUDED_BEHAVIOR}}
18
+
19
+ ## Environments and authentication
20
+
21
+ | Environment | Verified base address | Authentication / identity | Required permission / scope |
22
+ | --- | --- | --- | --- |
23
+ | {{ENVIRONMENT}} | {{VERIFIED_BASE_ADDRESS_OR_UNKNOWN}} | {{AUTHENTICATION_MECHANISM}} | {{EXACT_VERIFIED_PERMISSION_OR_UNKNOWN}} |
24
+
25
+ {{DESCRIBE_CREDENTIAL_HANDLING_TOKEN_LIFECYCLE_AND_AUTHORIZATION_BOUNDARIES_WITHOUT_SECRETS}}
26
+
27
+ ## Operation: {{METHOD}} {{VERIFIED_PATH_OR_PROPOSED_PATH}}
28
+
29
+ {{DESCRIBE_PURPOSE_PRECONDITIONS_AND_SIDE_EFFECTS}}
30
+
31
+ | Contract field | Value / evidence |
32
+ | --- | --- |
33
+ | Method and path | {{VERIFIED_METHOD_AND_PATH_WITH_SPEC_POINTER}} |
34
+ | Permission / resource ownership | {{VERIFIED_AUTHORIZATION_REQUIREMENTS}} |
35
+ | Request / response media type | {{VERIFIED_MEDIA_TYPES}} |
36
+ | Idempotency / concurrency | {{VERIFIED_BEHAVIOR_OR_UNKNOWN}} |
37
+
38
+ ### Request contract
39
+
40
+ | Location | Name | Type / required | Validation / default | Source |
41
+ | --- | --- | --- | --- | --- |
42
+ | {{PATH_QUERY_HEADER_OR_BODY}} | {{FIELD}} | {{TYPE_AND_REQUIRED_FLAG}} | {{CONSTRAINT_OR_NO_DEFAULT}} | {{SPEC_POINTER}} |
43
+
44
+ {{LINK_OR_INCLUDE_THE_RELEVANT_SCHEMA_REVISION_AND_DESCRIBE_CROSS_FIELD_BUSINESS_RULES}}
45
+
46
+ ### Request example
47
+
48
+ Example provenance: {{SPEC_EXAMPLE_OR_SANITIZED_CAPTURE_OR_PROPOSED_ILLUSTRATION}}.
49
+
50
+ ```text
51
+ {{REQUEST_EXAMPLE_CONSISTENT_WITH_THE_CONTRACT_WITHOUT_REAL_CREDENTIALS}}
52
+ ```
53
+
54
+ ### Success response
55
+
56
+ | Status / condition | Schema / fields | Semantics / source |
57
+ | --- | --- | --- |
58
+ | {{VERIFIED_STATUS_AND_CONDITION}} | {{SCHEMA_REFERENCE}} | {{MEANING_AND_SPEC_POINTER}} |
59
+
60
+ ```text
61
+ {{RESPONSE_EXAMPLE_WITH_EXPLICIT_SPEC_OR_CAPTURE_PROVENANCE}}
62
+ ```
63
+
64
+ ### Errors and client recovery
65
+
66
+ | Verified status / code | Trigger | Response shape | Client action / retry safety |
67
+ | --- | --- | --- | --- |
68
+ | {{STATUS_OR_CODE}} | {{CONDITION}} | {{SCHEMA_OR_EXAMPLE_REFERENCE}} | {{VERIFIED_RECOVERY_OR_UNKNOWN}} |
69
+
70
+ <!-- Optional: retain for collection endpoints, asynchronous work, or constrained throughput. -->
71
+ ### Pagination, limits, and asynchronous behavior
72
+
73
+ {{DESCRIBE_CURSOR_OR_OFFSET_ORDERING_TERMINATION_RATE_LIMITS_AND_POLLING_ONLY_WHEN_VERIFIED}}
74
+
75
+ ## Versioning and compatibility
76
+
77
+ {{STATE_VERSION_SELECTION_SUPPORTED_VERSIONS_BREAKING_CHANGE_RULES_AND_DEPRECATION_EVIDENCE}}
78
+
79
+ ## Verification and known limitations
80
+
81
+ | Contract / scenario | Evidence and revision | Environment / date | Result / limit |
82
+ | --- | --- | --- | --- |
83
+ | {{SCENARIO}} | {{SPEC_REVIEW_OR_TEST_ARTIFACT}} | {{ENVIRONMENT_AND_DATE}} | {{OBSERVED_RESULT_OR_NOT_RUN}} |
84
+
85
+ | Unknown / assumption | Consumer impact | Owner / resolution |
86
+ | --- | --- | --- |
87
+ | {{UNKNOWN_OR_ASSUMPTION}} | {{IMPACT}} | {{OWNER_AND_CHECK}} |
88
+
89
+ ## Source register and change history
90
+
91
+ | Reference | Revision / checked | Supports / limitation |
92
+ | --- | --- | --- |
93
+ | {{VERIFIED_SPEC_CODE_OR_TEST_REFERENCE}} | {{REVISION_AND_DATE}} | {{CLAIM_AND_LIMITATION}} |
94
+
95
+ | Document version / date | Change | Related Jira / owner |
96
+ | --- | --- | --- |
97
+ | {{VERSION_AND_DATE}} | {{CONTRACT_OR_DOC_CHANGE}} | {{VERIFIED_REFERENCE_AND_OWNER}} |
@@ -0,0 +1,43 @@
1
+ # Customer-impact assessment: {{proposed_change}}
2
+
3
+ | Metadata | Value |
4
+ | --- | --- |
5
+ | Document lifecycle | draft |
6
+ | Accountable owner / audience | {{owner_or_unknown}} / {{audience}} |
7
+ | Revision / date / review trigger | {{revision}} / {{date_or_unknown}} / {{trigger}} |
8
+ | Sources and revisions | {{change_customer_and_policy_sources_or_unknown}} |
9
+ | Change / Jira / related documentation | {{verified_references_or_unknown}} |
10
+ | Change authority / decision evidence | {{authority_or_unknown}} / pending |
11
+
12
+ Use **unknown** for missing evidence. Separate anticipated effects from observed impact. Do not include unnecessary customer identifiers or confidential details in a broadly shared page.
13
+
14
+ ## Change and customer workflow
15
+
16
+ - Current workflow and proposed difference: {{current_and_proposed}}
17
+ - Purpose, target environment, and boundaries: {{purpose_and_scope}}
18
+ - Proposed timing and dependencies: {{forecast_and_dependencies_or_unknown}}
19
+
20
+ ## Affected cohorts and impact
21
+
22
+ | Cohort / workflow | Anticipated effect / duration | Evidence / uncertainty | Existing commitment or impact rule / source | Mitigation proposal / owner |
23
+ | --- | --- | --- | --- | --- |
24
+ | {{aggregate_cohort}} | {{effect_and_duration_or_unknown}} | {{source_or_assumption}} | {{verified_commitment_or_unknown}} | {{proposal_and_owner_or_unknown}} |
25
+
26
+ Do not invent an SLA, tier, customer count, or disruption-free guarantee. Distinguish benefit hypotheses from measured results.
27
+
28
+ ## Communications and support readiness
29
+
30
+ | Audience | Message / required action | Channel / timing proposal | Owner / approval evidence | Sent evidence |
31
+ | --- | --- | --- | --- | --- |
32
+ | {{audience}} | {{draft_message}} | {{proposal}} | {{owner_or_unknown}} / pending | NOT SENT |
33
+
34
+ ## Change gates and follow-up
35
+
36
+ - Required acceptance and authorization evidence: {{gates_and_authorities_or_unknown}}
37
+ - Safe-stop, recovery, and escalation references: {{verified_references_or_unknown}}
38
+ - Support documentation or training needed: {{changes_and_owners_or_unknown}}
39
+ - Post-change measurement: {{measure_baseline_target_method_window_or_unknown}}; NOT MEASURED
40
+ - Observed customer result and evidence: {{not_observed_or_actual_result_and_source}}
41
+ - Open decision and next owner: {{decision_and_owner_or_unknown}}
42
+
43
+ An assessment ready for review is not permission to change production or send customer communications.
@@ -0,0 +1,44 @@
1
+ # Experiment plan and results: {{question}}
2
+
3
+ | Metadata | Value |
4
+ | --- | --- |
5
+ | Document lifecycle | draft |
6
+ | Accountable owner / audience | {{owner_or_unknown}} / {{audience}} |
7
+ | Revision / date / review trigger | {{revision}} / {{date_or_unknown}} / {{trigger}} |
8
+ | Sources and revisions | {{research_protocol_and_dataset_references_or_unknown}} |
9
+ | Related requirements / Jira | {{verified_references_or_unknown}} |
10
+ | Execution approval / evidence | {{authority_and_evidence_or_pending}} |
11
+
12
+ Use evidence or **unknown**. Drafting a protocol does not authorize an experiment. Leave results **NOT RUN** until observation records exist; preserve the original protocol when recording deviations.
13
+
14
+ ## Question and falsifiable hypothesis
15
+
16
+ - Decision this experiment informs: {{decision}}
17
+ - Hypothesis and comparison: {{intervention_population_comparison_and_expected_effect}}
18
+ - Existing evidence and alternative explanations: {{evidence_and_assumptions}}
19
+
20
+ ## Protocol before execution
21
+
22
+ | Design element | Planned method / rationale | Source / unresolved requirement |
23
+ | --- | --- | --- |
24
+ | Population, recruitment, allocation, and comparison | {{method}} | {{source_or_unknown}} |
25
+ | Sample size and duration | {{method_and_rationale_or_unknown}} | {{source_or_unknown}} |
26
+ | Primary measure, baseline, target, and guardrails | {{definitions_and_units}} | {{authority_or_unknown}} |
27
+ | Instrumentation and analysis | {{method_and_data_quality_checks}} | {{source_or_unknown}} |
28
+ | Privacy, consent, and stopping conditions | {{applicable_requirements_and_stop_rules}} | {{approval_or_unknown}} |
29
+
30
+ ## Observations and deviations
31
+
32
+ | Run / actual window | Population / allocation | Measurements / raw evidence | Deviations / missing data |
33
+ | --- | --- | --- | --- |
34
+ | NOT RUN | unknown | NOT MEASURED | {{known_limits_or_unknown}} |
35
+
36
+ ## Interpretation and next decision
37
+
38
+ - Result classification: {{not_run_inconclusive_or_supported_interpretation}}
39
+ - Analysis, uncertainty, and source: {{analysis_or_not_performed}}
40
+ - Bias, confounding, and generalization limits: {{limitations_or_unknown}}
41
+ - Decision proposal and next validation: {{proposal_and_owner_or_unknown}}
42
+ - Decision authority and actual decision evidence: {{authority_or_unknown}} / pending
43
+
44
+ Do not infer causation from an unsupported comparison or declare a hypothesis proved. Separate a learning outcome from authorization to roll out a change.
@@ -0,0 +1,79 @@
1
+ # Feature overview: {{feature_name}}
2
+
3
+ | Metadata | Value |
4
+ |---|---|
5
+ | Audience / purpose | {{users_business_support_or_engineering_readers}} / {{purpose}} |
6
+ | Accountable owner / reviewer | {{owner_or_unknown}} / {{reviewer_or_unknown}} |
7
+ | Document lifecycle / review trigger | draft / {{date_event_or_unknown}} |
8
+ | Revision / last reviewed | {{revision_or_unknown}} / {{date_or_unknown}} |
9
+ | Sources / revisions / dates | {{source_links_revisions_dates_or_unknown}} |
10
+ | Product / version / availability | {{product}} / {{version_or_unknown}} / {{verified_availability_or_unknown}} |
11
+ | Jira / PRD / design / related docs | {{jira_or_unknown}} / {{prd_or_unknown}} / {{design_or_unknown}} / {{other_links_or_unknown}} |
12
+
13
+ Fill from evidence; retain **unknown** where facts are missing. Keep **proposed**, **implemented**, **deployed**, and **enabled for users** separate. A draft or approved overview establishes no delivery state. Remove this authoring note from the finished page.
14
+
15
+ ## Existing problem
16
+
17
+ {{Who_encounters_what_problem_in_the_current_workflow_and_why_it_matters}}.
18
+
19
+ Evidence: {{observed_or_reported_problem_source_revision_or_unknown}}.
20
+
21
+ ## What changes
22
+
23
+ | Situation | Current behavior / evidence | New behavior / evidence | Delivery state |
24
+ |---|---|---|---|
25
+ | {{user_situation}} | {{current_behavior_or_unknown}} | {{new_behavior_or_proposed_behavior}} | {{proposed_implemented_deployed_enabled_or_unknown}} |
26
+
27
+ - Intended value: {{desired_customer_or_business_outcome}}.
28
+ - Measured value: {{result_method_period_and_source_or_not_measured}}.
29
+ - Out of scope: {{excluded_behavior_and_reason_or_unknown}}.
30
+
31
+ ## Who can use it
32
+
33
+ | Availability dimension | Verified state | Proposed intent, if relevant | Evidence / checked date |
34
+ |---|---|---|---|
35
+ | Version / environment | {{state_or_unknown}} | {{proposal_or_not_applicable_with_reason}} | {{source_and_date_or_unknown}} |
36
+ | Roles / permissions / prerequisites | {{state_or_unknown}} | {{proposal_or_unknown}} | {{source_and_date_or_unknown}} |
37
+ | Plan / region / cohort / release channel | {{state_or_unknown}} | {{proposal_or_unknown}} | {{source_and_date_or_unknown}} |
38
+ | Enablement / rollout timing | {{state_or_unknown}} | {{proposed_conditions_or_unknown}} | {{source_and_date_or_unknown}} |
39
+
40
+ Do not translate “merged” or “deployed” into “available to customers.” Cite evidence for the specific audience. Commercial eligibility and rollout dates remain unknown without an authoritative source.
41
+
42
+ ## How to use it
43
+
44
+ Procedure state: {{verified_for_version_and_audience_with_evidence_or_proposed_unverified_journey}}.
45
+
46
+ | Step | User action | Expected result | If the result differs |
47
+ |---|---|---|---|
48
+ | 1 | {{sourced_navigation_or_plain_language_proposed_action}} | {{observable_result}} | {{safe_next_step_or_help_link}} |
49
+ | 2 | {{next_action}} | {{observable_result}} | {{safe_next_step_or_help_link}} |
50
+
51
+ ## Examples and edge cases
52
+
53
+ | Scenario | Example input / starting state | Expected behavior | Limit / evidence |
54
+ |---|---|---|---|
55
+ | {{typical_case}} | {{sanitized_or_explicitly_synthetic_example}} | {{sourced_or_proposed_result}} | {{source_or_unknown}} |
56
+ | {{boundary_or_failure_case}} | {{condition}} | {{sourced_or_proposed_result_or_unknown}} | {{limit_and_source_or_unknown}} |
57
+
58
+ ## Limits and compatibility
59
+
60
+ - Supported versions, integrations, devices, or data formats: {{verified_scope_and_source_or_unknown}}.
61
+ - Behavior that changes for existing users: {{change_migration_need_and_source_or_unknown}}.
62
+ - Known limitations / unresolved compatibility: {{limitations_and_evidence_or_unknown}}.
63
+ - Data, permission, or accessibility implications: {{relevant_effects_and_sources_or_unknown}}.
64
+
65
+ ## Enablement, recovery, and support
66
+
67
+ - Enablement owner and procedure: {{owner_and_verified_reference_or_unknown}}.
68
+ - Rollout criteria and authority: {{criteria_source_and_authority_or_unknown}}.
69
+ - Disablement / rollback reference and limits: {{verified_reference_data_effects_and_limits_or_unknown}}.
70
+ - Support article / escalation route: {{verified_links_or_unknown}}.
71
+ - Training / release notes / next communication: {{references_or_unknown}}.
72
+
73
+ This overview explains behavior and links to procedures; it does not execute a rollout or establish permission to change a live system.
74
+
75
+ ## Open decisions and readiness
76
+
77
+ | Question / missing evidence | Impact on readers or rollout | Owner | Resolution trigger | State |
78
+ |---|---|---|---|---|
79
+ | {{question}} | {{impact}} | {{owner_or_unknown}} | {{date_event_or_unknown}} | {{open_or_evidence_backed_resolution}} |
@@ -0,0 +1,58 @@
1
+ # How to {{complete_user_task}}
2
+
3
+ | Metadata | Value |
4
+ |---|---|
5
+ | Audience / desired outcome | {{intended_reader}} / {{observable_task_result}} |
6
+ | Accountable owner / reviewer | {{owner_or_unknown}} / {{reviewer_or_unknown}} |
7
+ | Document lifecycle / review trigger | draft / {{version_change_or_review_date_or_unknown}} |
8
+ | Revision / last reviewed | {{revision_or_unknown}} / {{date_or_unknown}} |
9
+ | Sources / revisions / dates | {{procedure_product_or_validation_sources_revisions_dates_or_unknown}} |
10
+ | Product / version / availability | {{product}} / {{supported_version_or_unknown}} / {{verified_eligibility_or_unknown}} |
11
+ | Jira / related documentation | {{jira_links_or_unknown}} / {{documentation_links_or_unknown}} |
12
+
13
+ Fill placeholders with evidence or **unknown**. Use exact sourced interface labels and commands. Mark untested executable steps **NOT VERIFIED** for the relevant version and environment; do not describe them as ready to run or validated. Remove this authoring note from the finished page.
14
+
15
+ ## Result and prerequisites
16
+
17
+ After completing this procedure, {{observable_result}}.
18
+
19
+ - Starting state and intended target: {{product_workspace_resource_or_other_target_and_current_state}}.
20
+ - Required role, access, and feature availability: {{verified_requirements_and_source_or_unknown}}.
21
+ - Required input, setup, or dependencies: {{requirements_or_unknown}}.
22
+ - Expected side effects / reversibility: {{sourced_effects_and_recovery_limits_or_unknown}}.
23
+ - Procedure validation: {{version_environment_date_and_evidence_or_NOT_VERIFIED}}.
24
+
25
+ ## Steps
26
+
27
+ Each action should be small enough for the intended reader to follow and paired with an observable result. Add rows as needed; remove unused rows.
28
+
29
+ | Step | Action | Expected result | If the result differs |
30
+ |---|---|---|---|
31
+ | 1 | {{confirm_target_and_prerequisites}} | {{observable_starting_condition}} | {{safe_correction_or_support_route}} |
32
+ | 2 | {{perform_first_task_action}} | {{observable_result}} | {{troubleshooting_branch}} |
33
+ | 3 | {{complete_or_save_the_task}} | {{observable_final_result}} | {{recovery_or_support_branch}} |
34
+
35
+ Screenshots or examples: {{sanitized_version_matched_reference_or_not_applicable_with_reason}}. Label synthetic examples and unverified interface details explicitly.
36
+
37
+ ## Troubleshooting and recovery
38
+
39
+ | Symptom / condition | Safe check | Next action / expected result | Recovery limit / help |
40
+ |---|---|---|---|
41
+ | {{missing_access_or_option}} | {{non_destructive_check}} | {{supported_next_action_or_escalation}} | {{limit_and_support_reference}} |
42
+ | {{unexpected_or_partial_result}} | {{state_check}} | {{verified_recovery_or_stop_and_escalate}} | {{data_or_reversibility_limit_or_unknown}} |
43
+
44
+ Stop if {{specific_unsafe_or_unsupported_condition_or_unknown}}; contact {{verified_support_route_or_unknown}}. Do not repeat an action that might duplicate a payment, submission, deletion, or other consequential change without first checking the current state.
45
+
46
+ ## Completion check
47
+
48
+ - Desired result is visible in {{location_or_verification_surface}} as {{expected_state}}.
49
+ - Relevant follow-up or dependent task: {{next_step_or_not_applicable_with_reason}}.
50
+ - Verification evidence for this procedure: {{test_or_walkthrough_record_or_NOT_VERIFIED}}.
51
+
52
+ This page describes a procedure; it is not evidence that the reader or author executed it.
53
+
54
+ ## Help and related tasks
55
+
56
+ - Support / escalation: {{verified_link_or_contact_or_unknown}}.
57
+ - Related troubleshooting article: {{link_or_unknown}}.
58
+ - Related task or concept explanation: {{link_or_unknown}}.
@@ -0,0 +1,89 @@
1
+ # Incident Playbook: {{SYMPTOM_OR_FAILURE_MODE}}
2
+
3
+ <!-- This is a response guide, not an incident execution record. Use verified service knowledge; leave unverified diagnostics, thresholds, and actions explicit. Remove comments and unused optional sections from the filled document. -->
4
+
5
+ | Metadata | Value |
6
+ | --- | --- |
7
+ | Service / applicable environments | {{SERVICE_AND_ENVIRONMENTS}} |
8
+ | Playbook owner / version | {{OWNER}} / {{VERSION}} |
9
+ | Status / last verified | {{DRAFT_VERIFIED_OR_RETIRED}} / {{DATE_OR_NOT_VERIFIED}} |
10
+ | Incident commander role | {{VERIFIED_ROLE_AND_ROTA_REFERENCE}} |
11
+ | Communications owner role | {{ROLE_AND_VERIFIED_CONTACT_PATH}} |
12
+ | Jira incident / related work | {{VERIFIED_REFERENCE_OR_NOT_YET_CREATED}} |
13
+ | Related runbooks | {{VERIFIED_REFERENCES_OR_NONE}} |
14
+
15
+ ## Recognize the incident
16
+
17
+ {{DESCRIBE_USER_VISIBLE_SYMPTOMS_ALERT_SIGNATURES_AND_SCOPE_WITH_SOURCE_IDS}}
18
+
19
+ | Signal | Where observed | Known interpretation | Uncertainty / false positive |
20
+ | --- | --- | --- | --- |
21
+ | {{SYMPTOM_OR_ALERT}} | {{VERIFIED_OBSERVABILITY_SOURCE}} | {{SUPPORTED_INTERPRETATION}} | {{LIMIT_OR_ALTERNATIVE}} |
22
+
23
+ ## First response and ownership
24
+
25
+ 1. {{VERIFY_TARGET_AND_CAPTURE_INCIDENT_START_TIME_WITH_TIMEZONE}}
26
+ 2. {{ASSESS_IMPACT_USING_THE_VERIFIED_SEVERITY_POLICY}}
27
+ 3. {{IDENTIFY_COMMANDER_TECHNICAL_LEAD_AND_COMMUNICATIONS_OWNER}}
28
+ 4. {{RECORD_OBSERVATIONS_AND_PRESERVE_RELEVANT_EVIDENCE}}
29
+
30
+ {{LINK_THE_ACTUAL_INCIDENT_RECORD_AND_SEPARATE_OBSERVATIONS_FROM_HYPOTHESES}}
31
+
32
+ ## Triage questions
33
+
34
+ | Question / read-only check | Observation to collect | What the result supports | Owner |
35
+ | --- | --- | --- | --- |
36
+ | {{CHECK}} | {{OBSERVABLE_RESULT}} | {{BOUNDED_INFERENCE_NOT_PROOF}} | {{ROLE}} |
37
+
38
+ ## Decision branches
39
+
40
+ | Condition supported by evidence | Next action / runbook | Required authority | Stop / escalation condition |
41
+ | --- | --- | --- | --- |
42
+ | {{CONDITION_A}} | {{VERIFIED_DIAGNOSTIC_OR_RESPONSE_REFERENCE}} | {{ROLE_OR_EXISTING_AUTHORIZATION}} | {{STOP_RULE}} |
43
+ | {{CONDITION_B}} | {{VERIFIED_DIAGNOSTIC_OR_RESPONSE_REFERENCE}} | {{ROLE_OR_EXISTING_AUTHORIZATION}} | {{STOP_RULE}} |
44
+ | Cause or target remains uncertain | {{SAFE_EVIDENCE_COLLECTION_AND_ESCALATION}} | {{INCIDENT_LEAD}} | {{DO_NOT_PROCEED_WITH_UNBOUNDED_CHANGE}} |
45
+
46
+ ## Containment and mitigation
47
+
48
+ | Option / trigger | Intended effect | Side effects / reversibility | Evidence / authorization needed | Validation |
49
+ | --- | --- | --- | --- | --- |
50
+ | {{VERIFIED_OPTION}} | {{BOUNDED_EFFECT}} | {{KNOWN_COST_AND_RECOVERY_LIMIT}} | {{SOURCE_AND_AUTHORITY}} | {{OBSERVABLE_RESULT_AND_WINDOW}} |
51
+
52
+ {{STATE_WHEN_TO_STOP_AN_INEFFECTIVE_MITIGATION_AND_WHO_DECIDES_THE_NEXT_ACTION}}
53
+
54
+ ## Escalation
55
+
56
+ | Trigger / elapsed condition | Responsible role / contact reference | Information to provide |
57
+ | --- | --- | --- |
58
+ | {{VERIFIED_ESCALATION_TRIGGER}} | {{VERIFIED_ROTA_OR_CONTACT_REFERENCE}} | {{IMPACT_TIMELINE_EVIDENCE_AND_ACTIONS}} |
59
+
60
+ ## Communications plan
61
+
62
+ | Audience / channel reference | Owner | Trigger / cadence | Required message facts |
63
+ | --- | --- | --- | --- |
64
+ | {{AUDIENCE_AND_VERIFIED_CHANNEL}} | {{COMMUNICATIONS_OWNER}} | {{POLICY_OR_INCIDENT_AGREEMENT}} | {{IMPACT_CONFIRMED_ACTIONS_UNKNOWNS_NEXT_UPDATE}} |
65
+
66
+ {{RECORD_WHICH_MESSAGES_ARE_DRAFTED_APPROVED_OR_ACTUALLY_SENT_WITH_EVIDENCE}}
67
+
68
+ ## Recovery and return to service
69
+
70
+ | Recovery gate | Evidence / observation window | Decision owner | Failure response |
71
+ | --- | --- | --- | --- |
72
+ | {{SERVICE_AND_USER_PATH_RECOVERED}} | {{VERIFIED_HEALTH_SIGNALS_AND_WINDOW}} | {{OWNER}} | {{REENTER_TRIAGE_OR_ESCALATE}} |
73
+ | {{TEMPORARY_MITIGATION_REMOVAL}} | {{SAFE_REMOVAL_CRITERION_OR_DEFERRED}} | {{OWNER}} | {{RETAIN_AND_TRACK_FOLLOW_UP}} |
74
+
75
+ ## Follow-up and verification history
76
+
77
+ | Follow-up / review | Owner / due | Jira / evidence |
78
+ | --- | --- | --- |
79
+ | {{POST_INCIDENT_REVIEW_OR_PLAYBOOK_CORRECTION}} | {{OWNER_AND_DATE}} | {{VERIFIED_REFERENCE_OR_PENDING}} |
80
+
81
+ | Version / verified date | Method / verifier | Finding / next review trigger |
82
+ | --- | --- | --- |
83
+ | {{VERSION_AND_DATE_OR_NOT_VERIFIED}} | {{TABLETOP_TEST_OR_ACTUAL_USE_AND_VERIFIER}} | {{LIMITATION_OR_TRIGGER}} |
84
+
85
+ ## Sources and unknowns
86
+
87
+ | Source / revision | Supported fact or step | Uncertainty / owner to resolve |
88
+ | --- | --- | --- |
89
+ | {{VERIFIED_REFERENCE_OR_SOURCE_ID}} | {{SUPPORTED_CONTENT}} | {{UNKNOWN_ASSUMPTION_OR_LIMIT_AND_OWNER}} |
@@ -0,0 +1,83 @@
1
+ # Incident postmortem: {{incident_title}}
2
+
3
+ | Metadata | Value |
4
+ |---|---|
5
+ | Audience / publication scope | {{business_support_engineering_or_customer_readers}} / {{visibility_and_restrictions_or_unknown}} |
6
+ | Incident owner / review facilitator | {{owner_or_unknown}} / {{facilitator_or_unknown}} |
7
+ | Document lifecycle / review trigger | draft / {{review_date_new_evidence_or_follow_up_trigger_or_unknown}} |
8
+ | Revision / last reviewed | {{revision_or_unknown}} / {{date_or_unknown}} |
9
+ | Sources / revisions / dates | {{incident_log_telemetry_case_or_change_sources_revisions_dates_or_unknown}} |
10
+ | Product / versions / availability impact | {{product}} / {{affected_versions_or_unknown}} / {{verified_impact_scope_or_unknown}} |
11
+ | Incident / Jira / related documentation | {{incident_reference_or_unknown}} / {{jira_links_or_unknown}} / {{runbook_status_or_other_links_or_unknown}} |
12
+
13
+ Use **observed**, **reported**, **confirmed**, **hypothesis**, and **unknown** accurately. Preserve uncertainty; unknown impact is not zero impact. This page reviews an incident and does not execute response actions or authorize changes. Remove this authoring note from the finished document.
14
+
15
+ ## Summary and current state
16
+
17
+ {{Plain_language_description_of_what_users_experienced_what_was_done_and_what_is_known_now}}.
18
+
19
+ - Incident state: {{ongoing_mitigated_recovered_or_unknown_with_evidence}}.
20
+ - Severity: {{recorded_severity_authority_and_source_or_unknown}}.
21
+ - Start / detection / mitigation / recovery: {{timestamps_and_timezone_with_sources_or_unknown}}.
22
+ - Remaining user or business effect: {{known_effect_or_unknown}}.
23
+
24
+ Do not equate reduced symptoms with full recovery. Name the checks and observation window that support the recorded recovery state.
25
+
26
+ ## Impact
27
+
28
+ | Dimension | Confirmed or reported impact | Scope / measurement definition | Evidence / uncertainty |
29
+ |---|---|---|---|
30
+ | Users / customers / regions | {{impact_or_unknown}} | {{population_and_window_or_unknown}} | {{source_and_observed_or_reported_status}} |
31
+ | Tasks / requests / availability | {{impact_or_unknown}} | {{metric_denominator_and_window_or_unknown}} | {{source_or_unknown}} |
32
+ | Data / financial / contractual effects | {{verified_effect_or_unknown}} | {{scope_or_unknown}} | {{authoritative_evidence_or_unknown}} |
33
+
34
+ ## Timeline
35
+
36
+ Timezone: {{timezone_and_source_or_unknown}}. Use absolute timestamps where known; mark estimates and event ordering uncertainty. Preserve the source timezone when conversion cannot be verified.
37
+
38
+ | Timestamp / timezone | Event or observation | Evidence / provenance | Certainty |
39
+ |---|---|---|---|
40
+ | {{time_or_unknown}} | {{first_known_user_impact}} | {{source_reference}} | {{observed_reported_or_estimated}} |
41
+ | {{time_or_unknown}} | {{detection_and_initial_response}} | {{source_reference}} | {{certainty}} |
42
+ | {{time_or_unknown}} | {{mitigation_action_and_observed_effect}} | {{source_reference}} | {{certainty}} |
43
+ | {{time_or_unknown}} | {{recovery_check_and_result}} | {{source_reference_or_unknown}} | {{certainty_or_unknown}} |
44
+
45
+ ## Detection, mitigation, and recovery
46
+
47
+ - How it was detected and by whom: {{signal_or_report_and_evidence_or_unknown}}.
48
+ - Detection gap: {{supported_gap_or_hypothesis_with_missing_evidence}}.
49
+ - Mitigation performed: {{recorded_action_target_executor_and_evidence_or_unknown}}.
50
+ - Effect of mitigation: {{observed_change_and_measurement_or_unknown}}.
51
+ - Recovery verification: {{checks_results_scope_and_observation_window_or_unknown}}.
52
+ - Customer or stakeholder communication: {{sent_message_reference_and_verified_time_or_unknown}}.
53
+ - Response procedure reference: {{runbook_or_playbook_and_revision_or_unknown}}.
54
+
55
+ ## Causal analysis
56
+
57
+ | Statement | Classification | Supporting evidence | Missing / contradictory evidence | Next investigation |
58
+ |---|---|---|---|---|
59
+ | {{mechanism_that_produced_impact}} | {{confirmed_cause_or_hypothesis}} | {{evidence_link_or_unknown}} | {{gap_or_not_applicable_with_reason}} | {{action_or_unknown}} |
60
+ | {{condition_that_increased_likelihood_or_impact}} | {{confirmed_contributing_factor_or_hypothesis}} | {{evidence_link_or_unknown}} | {{gap_or_unknown}} | {{action_or_unknown}} |
61
+
62
+ Explain the mechanism and the evidence that distinguishes it from alternatives. Timing alone does not prove causation. Describe system conditions, available information, and process gaps without attributing blame or intent to individuals.
63
+
64
+ ## What worked and what did not
65
+
66
+ | Area | Observation / evidence | Effect on the response | Improvement or retained practice |
67
+ |---|---|---|---|
68
+ | {{detection_coordination_mitigation_or_recovery}} | {{observation_and_source}} | {{supported_effect_or_unknown}} | {{proposed_action_or_retained_practice}} |
69
+
70
+ ## Follow-up actions
71
+
72
+ | Action / risk addressed | Owner | Due / review trigger | Completion proof | Jira / state |
73
+ |---|---|---|---|---|
74
+ | {{specific_prevent_detect_limit_or_recover_action}} | {{owner_or_unknown}} | {{agreed_date_event_or_unknown}} | {{observable_evidence_needed_to_close}} | {{issue_link_or_unknown}} / {{proposed_in_progress_or_verified_complete}} |
75
+
76
+ Separate proposals from assigned commitments. Closure requires the stated proof, not only a completed issue status. If no action is selected for a known risk, record the rationale and decision authority or **unknown**.
77
+
78
+ ## Open questions and review record
79
+
80
+ - Material uncertainty: {{question_owner_and_evidence_needed_or_unknown}}.
81
+ - Review participants and date: {{participants_and_date_or_unknown}}.
82
+ - Review outcome / approval evidence: {{recorded_outcome_and_source_or_pending}}.
83
+ - Next review trigger: {{follow_up_event_date_or_unknown}}.