@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,86 @@
1
+ # Meeting Notes: {{MEETING_TITLE}}
2
+
3
+ <!-- Record what the source supports. Discussion, suggestions, decisions, and assigned actions are different. Do not invent attendance, agreement, owners, or due dates. Remove comments and unused optional sections from the filled document. -->
4
+
5
+ | Metadata | Value |
6
+ | --- | --- |
7
+ | Date / time / timezone | {{DATE_TIME_AND_TIMEZONE}} |
8
+ | Location / meeting link | {{VERIFIED_LOCATION_OR_CALL_REFERENCE_OR_NOT_RECORDED}} |
9
+ | Facilitator / notes owner | {{FACILITATOR}} / {{OWNER}} |
10
+ | Notes status / version | {{DRAFT_REVIEWED_OR_FINAL}} / {{VERSION}} |
11
+ | Last updated | {{DATE}} |
12
+ | Meeting source | {{SUPPLIED_NOTES_TRANSCRIPT_OR_RECORDING_REFERENCE}} |
13
+ | Jira / project references | {{VERIFIED_REFERENCES_OR_NOT_LINKED}} |
14
+ | Attendees confirmed by source | {{NAMES_OR_UNKNOWN}} |
15
+ | Invitees / absent participants | {{ONLY_IF_CONFIRMED_OR_NOT_RECORDED}} |
16
+
17
+ ## Purpose and desired outcomes
18
+
19
+ {{STATE_THE_PURPOSE_AND_EXPECTED_OUTCOME_WITHOUT_IMPLYING_IT_WAS_ACHIEVED}}
20
+
21
+ ## Agenda and materials
22
+
23
+ | Topic | Lead / source material | Intended outcome |
24
+ | --- | --- | --- |
25
+ | {{TOPIC}} | {{CONFIRMED_LEAD_AND_REFERENCE_OR_UNKNOWN}} | {{DISCUSSION_REVIEW_OR_DECISION}} |
26
+
27
+ ## Discussion record
28
+
29
+ | Topic | What was discussed | Source pointer | Unresolved view / uncertainty |
30
+ | --- | --- | --- | --- |
31
+ | {{TOPIC}} | {{NEUTRAL_SUMMARY_WITH_ATTRIBUTION_WHERE_RELEVANT}} | {{TIMESTAMP_SECTION_OR_NOTE_ID}} | {{DISAGREEMENT_OR_UNKNOWN}} |
32
+
33
+ <!-- Optional: retain for substantive proposals that were not adopted. -->
34
+ ### Proposals still under consideration
35
+
36
+ {{RECORD_PROPOSAL_PROPONENT_IF_KNOWN_AND_WHY_NO_DECISION_IS_RECORDED}}
37
+
38
+ ## Decisions actually recorded
39
+
40
+ | Decision ID | Decision / scope | Decision maker / authority | Evidence | Conditions / follow-up |
41
+ | --- | --- | --- | --- | --- |
42
+ | {{LOCAL_ID}} | {{RECORDED_DECISION_OR_NO_DECISION_RECORDED}} | {{ACTUAL_AUTHORITY_OR_UNKNOWN}} | {{SOURCE_POINTER}} | {{CONDITION_OR_NONE_RECORDED}} |
43
+
44
+ {{DISTINGUISH_EXPLICIT_DECISIONS_FROM_CONSENSUS_ASSUMED_BY_THE_NOTE_TAKER}}
45
+
46
+ ## Action items
47
+
48
+ | Action ID | Concrete deliverable / completion check | Owner | Due date / timezone | State / Jira reference |
49
+ | --- | --- | --- | --- | --- |
50
+ | {{LOCAL_ID}} | {{ACTION_AND_ACCEPTANCE_CHECK}} | {{ASSIGNED_PERSON_OR_UNASSIGNED}} | {{AGREED_DATE_OR_NOT_SET}} | {{PROPOSED_AGREED_OR_TRACKED_AND_VERIFIED_KEY}} |
51
+
52
+ {{STATE_WHICH_ACTIONS_WERE_AGREED_AND_WHICH_REQUIRE_OWNER_OR_DATE_CONFIRMATION}}
53
+
54
+ ## Open questions and dependencies
55
+
56
+ | Question / dependency | Why it matters | Owner to resolve | Required evidence / due |
57
+ | --- | --- | --- | --- |
58
+ | {{QUESTION}} | {{IMPACT}} | {{OWNER_OR_UNASSIGNED}} | {{CHECK_AND_DATE_OR_NOT_SET}} |
59
+
60
+ ## Follow-up
61
+
62
+ | Follow-up | Responsible person | Confirmed arrangement / evidence |
63
+ | --- | --- | --- |
64
+ | {{REVIEW_OR_NEXT_MEETING}} | {{PERSON_OR_UNASSIGNED}} | {{CONFIRMED_DETAILS_OR_PROPOSED}} |
65
+
66
+ {{LIST_VERIFIED_ADR_DESIGN_OR_PROJECT_RECORDS_THAT_NEED_AN_UPDATE}}
67
+
68
+ ## Review and corrections
69
+
70
+ | Reviewer / date | Scope checked | Correction / evidence |
71
+ | --- | --- | --- |
72
+ | {{REVIEWER_AND_DATE_OR_NOT_REVIEWED}} | {{DECISIONS_ACTIONS_OR_FULL_NOTES}} | {{CORRECTION_OR_REVIEW_RESULT}} |
73
+
74
+ ## Source register and limitations
75
+
76
+ | Source ID | Reference / supplied artifact | Coverage | Limitation |
77
+ | --- | --- | --- | --- |
78
+ | {{SOURCE_ID}} | {{VERIFIED_REFERENCE}} | {{TIME_RANGE_OR_TOPIC}} | {{MISSING_SEGMENT_AMBIGUOUS_SPEAKER_OR_NONE}} |
79
+
80
+ {{LIST_MATERIAL_UNKNOWNS_AND_ANY_LABELED_INFERENCES_NOT_ESTABLISHED_BY_THE_SOURCES}}
81
+
82
+ ## Change history
83
+
84
+ | Version / date | Change | Author |
85
+ | --- | --- | --- |
86
+ | {{VERSION_AND_DATE}} | {{CHANGE}} | {{AUTHOR}} |
@@ -0,0 +1,51 @@
1
+ # Objectives and key results: {{team_and_period}}
2
+
3
+ | Metadata | Value |
4
+ | --- | --- |
5
+ | Document lifecycle | draft |
6
+ | Accountable owner / audience | {{owner_or_unknown}} / {{audience}} |
7
+ | Revision / planning period | {{revision}} / {{start_end_and_timezone_or_unknown}} |
8
+ | Sources and revisions | {{strategy_baseline_and_agreement_sources_or_unknown}} |
9
+ | Review cadence / trigger | {{cadence_and_change_trigger_or_unknown}} |
10
+ | Agreement authority / evidence | {{authority_and_evidence_or_pending}} |
11
+
12
+ Replace placeholders with evidence or **unknown**. Proposed goals are not agreed commitments. Missing baselines or measurements are not zero progress.
13
+
14
+ ## Objective and alignment
15
+
16
+ - Objective ID and intended outcome: {{objective_id}} / {{outcome}}
17
+ - Beneficiaries and strategic reason: {{users_and_strategy_source}}
18
+ - Constraints and exclusions: {{constraints_and_exclusions}}
19
+
20
+ Repeat the key-result rows for each relevant objective; do not impose an arbitrary objective count.
21
+
22
+ ## Measurable key results
23
+
24
+ | KR ID / objective | Outcome measure / unit | Baseline / date / source | Target / deadline / authority | Owner | Method / cohort / window | Current result / evidence |
25
+ | --- | --- | --- | --- | --- | --- | --- |
26
+ | {{kr_id_and_objective}} | {{measure_and_unit}} | {{baseline_or_unknown}} | {{target_or_proposed_and_source}} | {{owner_or_unknown}} | {{method_or_unknown}} | NOT MEASURED |
27
+
28
+ A task or shipped feature may support a key result; it is not itself evidence that the outcome changed.
29
+
30
+ ## Supporting initiatives and dependencies
31
+
32
+ | Initiative / verified Jira reference | Key result supported | Assumption / dependency | Owner / validation gate |
33
+ | --- | --- | --- | --- |
34
+ | {{initiative_or_reference_or_unknown}} | {{kr_id}} | {{assumption_or_dependency}} | {{owner_and_gate_or_unknown}} |
35
+
36
+ ## Dated check-in log (when useful)
37
+
38
+ | Check-in date / measurement cutoff | KR ID | Observed value / units / source | Confidence and evidence-based rationale | Blocker / decision / owner |
39
+ | --- | --- | --- | --- | --- |
40
+ | {{date_and_cutoff_or_unknown}} | {{kr_id}} | NOT MEASURED | {{confidence_basis_or_unknown}} | {{decision_and_owner_or_unknown}} |
41
+
42
+ Preserve earlier check-ins and record corrections transparently. Confidence is an assessment, not measured progress; use no numeric confidence scale unless the team supplied one.
43
+
44
+ ## Review and interpretation
45
+
46
+ - Actual measurement cutoff and limitations: {{cutoff_and_limits_or_not_measured}}
47
+ - Scoring method and agreement evidence, if used: {{existing_method_and_source_or_unknown}}
48
+ - Changes to targets and approval evidence: {{change_record_or_none_supplied}}
49
+ - Next decision, owner, and review date: {{decision}} / {{owner_or_unknown}} / {{date_or_trigger}}
50
+
51
+ Do not invent scores, percentages, measured improvements, or cross-team commitments.
@@ -0,0 +1,83 @@
1
+ # Product requirements: {{capability}}
2
+
3
+ | Metadata | Value |
4
+ |---|---|
5
+ | Document lifecycle | draft |
6
+ | Accountable owner | {{owner_or_unknown}} |
7
+ | Reviewer / decision authority | {{reviewer_and_authority_or_unknown}} |
8
+ | Revision / last edited | {{revision_or_unknown}} / {{date_or_unknown}} |
9
+ | Sources and their revisions | {{source_links_versions_and_dates_or_unknown}} |
10
+ | Jira / related documentation | {{jira_links_or_unknown}} / {{related_links_or_unknown}} |
11
+ | Review trigger | {{date_or_event_that_requires_review}} |
12
+
13
+ Replace `{{placeholders}}` with evidence-backed values. Write **unknown** when evidence is missing; use **not applicable — {{reason}}** only with a reason. The lifecycle is `draft`, `in-review`, or `approved`; it does not describe Confluence publication, delivery, or deployment. Record actual approval evidence before using `approved`.
14
+
15
+ ## Problem and intended outcome
16
+
17
+ - Affected users and context: {{users_context_and_source_or_unknown}}
18
+ - Current problem and observed impact: {{problem_evidence_or_unknown}}
19
+ - Intended outcome: {{outcome}}
20
+ - Why now: {{priority_and_source_or_unknown}}
21
+ - Decision this document supports: {{decision_and_authority_or_unknown}}
22
+
23
+ | Success measure | Current baseline / source | Target / authority | Measurement method | Evidence state |
24
+ |---|---|---|---|---|
25
+ | {{measure}} | {{baseline_and_source_or_unknown}} | {{target_and_authority_or_unknown}} | {{method_or_unknown}} | NOT MEASURED |
26
+
27
+ ## Scope
28
+
29
+ | Included | Excluded | Constraint and source |
30
+ |---|---|---|
31
+ | {{included_user_outcome}} | {{excluded_outcome}} | {{constraint_and_source_or_unknown}} |
32
+
33
+ ## User journey and requirements
34
+
35
+ Describe the starting condition, user action, result, and important failure or exception paths: {{journey_and_exceptions}}.
36
+
37
+ Every material requirement must trace to a business rule or stated need. Link a specific Jira acceptance criterion, not only an epic title. A proposed criterion is not an agreed requirement.
38
+
39
+ | Requirement ID | Business rule / authoritative source and revision | Jira acceptance criterion: link + identifier | Verification method / evidence | State |
40
+ |---|---|---|---|---|
41
+ | BR-01 | {{rule_and_source_or_unknown}} | {{jira_ac_or_unknown}} | {{verification_method}}; NOT RUN | {{proposed_agreed_or_blocked}} |
42
+
43
+ ### Acceptance criterion detail
44
+
45
+ - Criterion: {{ac_identifier_or_unknown}}
46
+ - Given: {{initial_conditions}}
47
+ - When: {{user_or_system_action}}
48
+ - Then: {{observable_result}}
49
+ - Relevant exception / boundary: {{exception_or_boundary_or_unknown}}
50
+ - Authority and agreement evidence: {{authority_and_evidence_or_unknown}}
51
+
52
+ ## Dependencies and material unknowns
53
+
54
+ | Dependency / unresolved fact | Authoritative source and version | Owner | Effect on requirements | Resolution / gate |
55
+ |---|---|---|---|---|
56
+ | {{external_schema_or_dependency}} | {{contract_source_and_version_or_unknown}} | {{owner_or_unknown}} | {{affected_requirement_ids}} | {{required_validation_before_commitment}} |
57
+
58
+ If a material external schema is unavailable, state **unknown** and mark dependent requirements conditional or blocked. Do not invent field names, payloads, limits, or compatibility promises. Identify the contract owner and the evidence needed to unblock the requirement.
59
+
60
+ ## Options and tradeoffs
61
+
62
+ | Option | User value / evidence | Cost or limitation | Risk / unresolved assumption | Disposition and reason |
63
+ |---|---|---|---|---|
64
+ | {{option_a}} | {{value_and_source_or_unknown}} | {{cost_or_unknown}} | {{risk_or_unknown}} | {{proposed_disposition}} |
65
+ | {{option_b_or_status_quo}} | {{value_and_source_or_unknown}} | {{cost_or_unknown}} | {{risk_or_unknown}} | {{proposed_disposition}} |
66
+
67
+ ## Delivery and operational acceptance
68
+
69
+ - Readiness dependencies: {{dependencies_and_owners_or_unknown}}
70
+ - Accessibility, privacy, security, and support requirements: {{applicable_requirements_and_sources_or_unknown}}
71
+ - Rollout audience and success/stop criteria: {{audience_and_criteria_or_unknown}}
72
+ - Training, documentation, or support changes: {{changes_and_owners_or_unknown}}
73
+ - Validation evidence needed before declaring the outcome achieved: {{evidence_required}}
74
+
75
+ ## Open questions and review record
76
+
77
+ | Question / decision | Blocks | Owner | Due / trigger | Resolution evidence |
78
+ |---|---|---|---|---|
79
+ | {{question}} | {{requirement_or_milestone}} | {{owner_or_unknown}} | {{date_or_event_or_unknown}} | unknown |
80
+
81
+ | Review date | Reviewer / authorized role | Scope reviewed | Outcome and conditions | Evidence |
82
+ |---|---|---|---|---|
83
+ | {{date_or_unknown}} | {{reviewer_or_unknown}} | {{scope}} | {{pending_or_recorded_outcome}} | {{evidence_link_or_unknown}} |
@@ -0,0 +1,77 @@
1
+ # Product explainer: {{product_name}}
2
+
3
+ | Metadata | Value |
4
+ |---|---|
5
+ | Audience / purpose | {{business_customer_support_or_other_readers}} / {{question_this_page_answers}} |
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_and_source_or_unknown}} |
11
+ | Jira / related documentation | {{jira_links_or_unknown}} / {{documentation_links_or_unknown}} |
12
+
13
+ Replace `{{placeholders}}` with sourced content, **unknown**, or **not applicable — reason**. Keep proposed, reported, observed, and measured statements distinct. Document approval does not establish that a product is available or that a benefit has been achieved. Remove this authoring note from the finished page.
14
+
15
+ ## What it does
16
+
17
+ {{One_or_two_plain_language_sentences_explaining_the_job_people_use_it_for_and_the_result}}.
18
+
19
+ ## Who it helps and why
20
+
21
+ - Intended users and situation: {{who_has_the_problem_and_when}}.
22
+ - Problem and evidence: {{observed_or_reported_problem_with_source_or_unknown}}.
23
+ - Why the problem matters: {{business_or_customer_consequence_with_source_or_unknown}}.
24
+
25
+ | Before | With the product | Evidence and status |
26
+ |---|---|---|
27
+ | {{current_workflow_or_problem}} | {{supported_behavior_or_explicitly_proposed_workflow}} | {{source_revision_and_observed_reported_or_proposed}} |
28
+
29
+ | Benefit | Desired outcome | Measured outcome / method / period |
30
+ |---|---|---|
31
+ | {{benefit_in_business_terms}} | {{intended_improvement_or_unknown}} | {{measured_result_and_source_or_not_measured}} |
32
+
33
+ ## Key terms in business language
34
+
35
+ | Term | Meaning for the reader | Concrete example | Source / qualification |
36
+ |---|---|---|---|
37
+ | {{product_or_technical_term}} | {{plain_language_meaning}} | {{illustrative_example_labelled_as_such}} | {{definition_source_or_proposed_definition}} |
38
+
39
+ ## Common workflows
40
+
41
+ | Step | What the person does | What happens next | Exception / help |
42
+ |---|---|---|---|
43
+ | 1 | {{starting_action_and_required_access}} | {{expected_result_and_behavior_evidence}} | {{missing_access_or_input_path}} |
44
+ | 2 | {{next_action}} | {{expected_result_and_behavior_evidence}} | {{failure_or_alternative_path}} |
45
+
46
+ Detailed instructions: {{verified_how_to_link_or_unknown}}. Identify proposed or unverified journeys explicitly; do not invent menu labels or screenshots.
47
+
48
+ ## Capabilities and boundaries
49
+
50
+ | Need | Supported capability / state | Limitation or excluded case | Evidence / version |
51
+ |---|---|---|---|
52
+ | {{user_need}} | {{capability_and_proposed_or_verified_state}} | {{limit_or_unknown}} | {{source_revision_and_applicable_version_or_unknown}} |
53
+
54
+ ## Availability, prerequisites, and commercial terms
55
+
56
+ | Reader question | Answer | Evidence / applicable scope |
57
+ |---|---|---|
58
+ | Who can use it now? | {{verified_plans_roles_regions_cohorts_or_unknown}} | {{availability_source_and_checked_date_or_unknown}} |
59
+ | What is required first? | {{permissions_setup_dependencies_or_unknown}} | {{source_or_unknown}} |
60
+ | What does it cost? | {{published_price_or_commercial_contact_or_unknown}} | {{price_source_currency_scope_and_date_or_unknown}} |
61
+ | What commitments apply? | {{verified_support_service_or_contract_terms_or_unknown}} | {{authoritative_terms_and_revision_or_unknown}} |
62
+
63
+ An unknown price, plan, limit, or commitment stays unknown. A design proposal or roadmap does not establish entitlement or availability.
64
+
65
+ ## Questions and help
66
+
67
+ - Common question: {{reader_question}}. Answer: {{sourced_answer_or_unknown}}.
68
+ - Support / feedback route: {{verified_link_or_contact_or_unknown}}.
69
+ - Open question affecting this explanation: {{question_owner_and_resolution_trigger_or_unknown}}.
70
+
71
+ ## Optional technical appendix
72
+
73
+ Keep this separate from the business explanation; omit it if the audience does not need it.
74
+
75
+ - Architecture, integration, or data-flow reference: {{source_link_and_revision_or_unknown}}.
76
+ - Relevant technical constraints and their user impact: {{constraint_impact_and_source_or_unknown}}.
77
+ - Implementation state / validation evidence: {{observed_state_and_evidence_or_unknown}}.
@@ -0,0 +1,54 @@
1
+ # Product roadmap: {{product_and_planning_horizon}}
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 | {{source_links_and_versions_or_unknown}} |
9
+ | Related objectives / Jira | {{verified_references_or_unknown}} |
10
+ | Prioritization authority | {{authority_and_decision_evidence_or_unknown}} |
11
+
12
+ Use **unknown** where evidence is missing. This roadmap is directional, not a delivery promise or evidence of customer availability. Retain actual commitments only with their authority and source.
13
+
14
+ ## Product direction
15
+
16
+ - Users, problem, and intended business outcome: {{users_problem_and_outcome}}
17
+ - Planning horizon and exclusions: {{horizon_and_exclusions}}
18
+ - Inputs and prioritization rationale: {{customer_business_and_technical_evidence}}
19
+
20
+ ## Outcome horizons
21
+
22
+ Use the team's existing horizon names; any new grouping remains proposed.
23
+
24
+ | Horizon | Initiative / intended outcome | Supporting evidence / priority rationale | Owner | Confidence / unresolved assumptions | Date type and source |
25
+ | --- | --- | --- | --- | --- | --- |
26
+ | {{horizon}} | {{initiative_and_outcome}} | {{sources_or_unknown}} | {{owner_or_unknown}} | {{confidence_basis_or_unknown}} | {{forecast_commitment_or_unknown_and_source}} |
27
+
28
+ ## Dependencies and capacity
29
+
30
+ | Initiative | Dependency / capacity constraint | Evidence or validation required | Decision gate |
31
+ | --- | --- | --- | --- |
32
+ | {{initiative}} | {{constraint_or_unknown}} | {{source_or_needed_check}} | {{owner_and_gate_or_unknown}} |
33
+
34
+ ## Outcome validation and availability
35
+
36
+ | Initiative | Measure / baseline / target | Measurement method / window | Observed outcome | Availability evidence |
37
+ | --- | --- | --- | --- | --- |
38
+ | {{initiative}} | {{measure_and_values_or_unknown}} | {{method_or_unknown}} | NOT MEASURED | {{customer_enablement_evidence_or_unknown}} |
39
+
40
+ Distinguish discovery, planned work, merged code, deployment, and customer enablement. None implies the next stage.
41
+
42
+ ## Optional audience-specific summary
43
+
44
+ | Audience | Outcome information needed | Approved facts / source | Disclosure or availability limit |
45
+ | --- | --- | --- | --- |
46
+ | {{internal_executive_or_customer_audience}} | {{relevant_outcome_or_decision}} | {{approved_source_or_unknown}} | {{restriction_or_missing_approval}} |
47
+
48
+ Create a summary only from facts appropriate for that audience. A filtered view, hidden column, or summary is not an access-control boundary. Verify actual sharing restrictions before exposing internal details; a customer-facing horizon remains directional unless a commitment is evidenced.
49
+
50
+ ## Decisions and revision history
51
+
52
+ | Change / tradeoff | Reason / source | Authority / decision evidence | Communication needed |
53
+ | --- | --- | --- | --- |
54
+ | {{change_or_open_question}} | {{reason_or_unknown}} | {{evidence_or_pending}} | {{audience_and_owner_or_unknown}} |
@@ -0,0 +1,56 @@
1
+ # Project charter: {{proposed_initiative}}
2
+
3
+ | Metadata | Value |
4
+ | --- | --- |
5
+ | Document lifecycle | draft |
6
+ | Accountable owner / intended audience | {{owner_or_unknown}} / {{audience}} |
7
+ | Revision / date / review trigger | {{revision}} / {{date_or_unknown}} / {{trigger}} |
8
+ | Source material and revisions | {{verified_links_versions_or_unknown}} |
9
+ | Proposed sponsor / actual decision authority | {{sponsor_or_unknown}} / {{authority_and_source_or_unknown}} |
10
+ | Related requirements / delivery plan / Jira | {{verified_references_or_unknown}} |
11
+
12
+ Replace placeholders with supplied evidence or **unknown**. A charter draft proposes a mandate; it does not approve funding, allocate people, authorize procurement, or permit deployment.
13
+
14
+ ## Need, intended value, and alternatives
15
+
16
+ - Affected users and evidenced problem: {{users_problem_and_source}}
17
+ - Intended benefit and measurement approach: {{benefit_hypothesis_baseline_target_method_or_unknown}}; NOT MEASURED
18
+ - Alternatives, including no change: {{options_and_tradeoffs_supported_by_evidence}}
19
+ - Decision requested from whom: {{bounded_request_and_authority_or_unknown}}
20
+
21
+ ## Mandate and boundaries
22
+
23
+ - Proposed outcomes and exclusions: {{included_outcomes}} / {{excluded_work}}
24
+ - Constraints, dependencies, and unresolved assumptions: {{constraints_and_evidence_or_unknown}}
25
+ - Proposed timing versus actual commitment: {{forecast_or_commitment_and_source_or_unknown}}
26
+
27
+ ## Stakeholder decision rights
28
+
29
+ | Decision / responsibility | Proposed or confirmed role | Scope of authority / source | Agreement evidence / open question |
30
+ | --- | --- | --- | --- |
31
+ | {{funding_scope_delivery_or_acceptance_decision}} | {{role_or_unknown}} | {{authority_boundary_or_unknown}} | pending |
32
+
33
+ Do not assign a person or imply agreement from a name appearing in meeting notes. Follow existing decision-governance conventions rather than imposing a new approval framework.
34
+
35
+ ## Resource and funding proposal
36
+
37
+ | Resource / cost item | Estimate / currency / period / basis | Requested allocation | Approved amount or authority evidence | Remaining gate |
38
+ | --- | --- | --- | --- | --- |
39
+ | {{item}} | {{estimate_and_source_or_unknown}} | {{proposal_or_unknown}} | unknown | {{decision_and_owner_or_unknown}} |
40
+
41
+ No budget amount, staffing level, contingency percentage, or commercial commitment is a default. Separate estimates from actual authorization.
42
+
43
+ ## Risks and authorization gates
44
+
45
+ | Risk / unresolved decision | Consequence | Evidence needed | Decision authority / next action |
46
+ | --- | --- | --- | --- |
47
+ | {{risk_or_question}} | {{consequence}} | {{validation_or_approval_needed}} | {{role_and_action_or_unknown}} |
48
+
49
+ ## Decision record and handoff
50
+
51
+ - Mandate decision, conditions, and actual evidence: pending — {{required_authority_or_unknown}}
52
+ - Funding/resource decision and actual evidence: pending — {{required_authority_or_unknown}}
53
+ - Activities currently authorized and their limits: {{explicit_scope_and_source_or_none_evidenced}}
54
+ - Requirements and delivery planning next steps: {{bounded_next_step_and_owner_or_unknown}}
55
+
56
+ Record actual decisions separately from authoring readiness. Use the [project plan](project-plan.md) for delivery sequencing after the relevant mandate is resolved; do not invent approval to make the document look complete.
@@ -0,0 +1,52 @@
1
+ # Project plan: {{initiative}}
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 | {{source_links_and_versions_or_unknown}} |
9
+ | Related requirements / Jira | {{verified_references_or_unknown}} |
10
+ | Decision authority | {{authority_and_approval_evidence_or_unknown}} |
11
+
12
+ Replace placeholders with supplied evidence or **unknown**. Keep estimates and proposed allocations explicit. Document approval is not authority to spend, assign people, or execute changes.
13
+
14
+ ## Outcome and boundaries
15
+
16
+ - Beneficiaries and intended outcome: {{users_and_outcome}}
17
+ - Included / excluded delivery: {{included}} / {{excluded}}
18
+ - Requirements and design references: {{verified_prd_tdd_or_unknown}}
19
+
20
+ For an initial mandate, sponsor decision rights, or funding proposal, use a linked [project charter](project-charter.md); this delivery plan does not supply that approval.
21
+
22
+ ## Delivery sequence
23
+
24
+ | Milestone | Dependency / gate | Owner | Date: forecast or confirmed commitment / source | Completion evidence required |
25
+ | --- | --- | --- | --- | --- |
26
+ | {{milestone}} | {{dependency_or_unknown}} | {{owner_or_unknown}} | {{date_type_and_source_or_unknown}} | {{observable_completion_check}} |
27
+
28
+ ## Capacity and constraints
29
+
30
+ | Resource / constraint | Estimate / source | Confirmed allocation or unresolved approval | Consequence |
31
+ | --- | --- | --- | --- |
32
+ | {{capacity_cost_or_constraint}} | {{estimate_and_source_or_unknown}} | {{evidence_or_unknown}} | {{schedule_or_scope_effect}} |
33
+
34
+ ## Success measures
35
+
36
+ | Measure | Baseline / source | Target / authority | Method / observation window | Observed result |
37
+ | --- | --- | --- | --- | --- |
38
+ | {{measure}} | {{baseline_or_unknown}} | {{target_or_proposed}} | {{method_and_window_or_unknown}} | NOT MEASURED |
39
+
40
+ ## Risks and decision gates
41
+
42
+ | Risk / unknown / decision | Affected milestone | Proposed response | Owner / trigger | Resolution evidence |
43
+ | --- | --- | --- | --- | --- |
44
+ | {{risk_or_decision}} | {{milestone}} | {{response}} | {{owner_or_unknown}} / {{trigger}} | pending |
45
+
46
+ ## Communication and closure
47
+
48
+ - Update audience, channel, and cadence: {{proposed_or_agreed_arrangement_and_source}}
49
+ - Acceptance authority and required evidence: {{authority_and_gate_or_unknown}}
50
+ - Next action and owner: {{action}} / {{owner_or_unknown}}
51
+
52
+ Do not report the intended outcome achieved merely because all planning tasks are closed.
@@ -0,0 +1,47 @@
1
+ # Project status: {{initiative}} — {{reporting_period}}
2
+
3
+ | Metadata | Value |
4
+ | --- | --- |
5
+ | Document lifecycle | draft |
6
+ | Accountable owner / audience | {{owner_or_unknown}} / {{audience}} |
7
+ | Revision / cutoff / timezone | {{revision}} / {{as_of_time_or_unknown}} / {{timezone_or_unknown}} |
8
+ | Sources and revisions | {{source_links_versions_and_collection_times_or_unknown}} |
9
+ | Related plan / Jira | {{verified_references_or_unknown}} |
10
+ | Next review | {{date_or_trigger_or_unknown}} |
11
+
12
+ Use **unknown** for missing evidence. This report is a snapshot, not a live feed. Draft readiness does not establish project approval or delivery success.
13
+
14
+ ## Executive assessment
15
+
16
+ - Intended outcome and scope: {{outcome_and_scope}}
17
+ - Current assessment: {{assessment_or_unknown}}
18
+ - Assessment rule and supporting evidence: {{agreed_health_rule_and_sources_or_unknown}}
19
+ - Material change since the prior report: {{change_and_prior_revision_or_unknown}}
20
+
21
+ Do not assign a green/red health rating without stating its basis.
22
+
23
+ ## Delivery evidence
24
+
25
+ | Outcome / milestone | Previous forecast | Current forecast and basis | Observed state / evidence at cutoff | Owner |
26
+ | --- | --- | --- | --- | --- |
27
+ | {{milestone}} | {{previous_or_unknown}} | {{forecast_or_unknown}} | {{observed_state_and_source_or_unknown}} | {{owner_or_unknown}} |
28
+
29
+ ## Measurements and limits
30
+
31
+ | Measure | Baseline / target / units | Current observation / window / source | Interpretation / missing data |
32
+ | --- | --- | --- | --- |
33
+ | {{measure}} | {{values_or_unknown}} | NOT MEASURED | {{limit_or_required_check}} |
34
+
35
+ Resolved tickets do not establish deployed behavior or customer availability. Label estimates separately from observations.
36
+
37
+ ## Blockers, risks, and decisions
38
+
39
+ | Item | Impact / evidence | Next action | Owner | Decision authority / needed by |
40
+ | --- | --- | --- | --- | --- |
41
+ | {{issue_risk_or_decision}} | {{impact_and_source_or_unknown}} | {{proposed_action}} | {{owner_or_unknown}} | {{authority_and_date_or_unknown}} |
42
+
43
+ ## Next reporting period
44
+
45
+ - Planned outcomes and dependencies: {{plan_and_dependencies}}
46
+ - Support or decision requested: {{specific_ask_and_authority_or_unknown}}
47
+ - Missing coverage or stale sources: {{limits_and_refresh_action}}
@@ -0,0 +1,119 @@
1
+ # Release Notes: {{PRODUCT}} {{RELEASE_IDENTIFIER}}
2
+
3
+ <!-- Planned work, completed Jira issues, deployed artifacts, and enabled features are distinct. Use evidence for each claim. Remove comments and unused optional sections from the filled document. -->
4
+
5
+ | Metadata | Value |
6
+ | --- | --- |
7
+ | Release owner / documentation owner | {{RELEASE_OWNER}} / {{DOC_OWNER}} |
8
+ | Document lifecycle | {{DRAFT_IN_REVIEW_APPROVED_OR_UNKNOWN}} |
9
+ | Reviewer / review evidence | {{REVIEWER_AND_REVIEW_RECORD_OR_UNKNOWN}} |
10
+ | Release status | {{PLANNED_IN_PROGRESS_DEPLOYED_PARTIAL_ROLLED_BACK_OR_UNKNOWN}} |
11
+ | Target / actual release date | {{TARGET_DATE}} / {{ACTUAL_DATE_OR_NOT_VERIFIED}} |
12
+ | Affected product / environment | {{PRODUCT_AND_ENVIRONMENT_SCOPE}} |
13
+ | Document version / checked | {{VERSION}} / {{DATE}} |
14
+ | Jira release / delivery reference | {{VERIFIED_REFERENCE_OR_NOT_LINKED}} |
15
+ | Release artifact / source revision | {{VERIFIED_ARTIFACT_AND_REVISION_OR_UNKNOWN}} |
16
+ | Review trigger | {{NEXT_DATE_EVENT_OR_UNKNOWN}} |
17
+
18
+ <!-- Document review lifecycle is separate from release status and Confluence publication. Approval requires actual review evidence; it does not establish deployment or user enablement. -->
19
+
20
+ ## Release summary
21
+
22
+ {{DESCRIBE_THE_USER_RELEVANT_CHANGE_AND_THE_CURRENT_DELIVERY_STATE}}
23
+
24
+ {{STATE_WHO_IS_AFFECTED_AND_WHETHER_ACTION_IS_REQUIRED}}
25
+
26
+ ## Customer and business impact
27
+
28
+ {{EXPLAIN_THE_USER_TASK_OR_BUSINESS_PROBLEM_IN_FAMILIAR_LANGUAGE}}
29
+
30
+ {{DESCRIBE_THE_BENEFIT_WITH_EVIDENCE_OR_LABEL_IT_EXPECTED_NOT_YET_MEASURED}}
31
+
32
+ {{STATE_VERIFIED_ELIGIBILITY_PLAN_REGION_COHORT_AND_LIMITATIONS_OR_UNKNOWN}}
33
+
34
+ ### How to use a new feature
35
+
36
+ | Step | User action | Expected result | Prerequisite / help reference |
37
+ | --- | --- | --- | --- |
38
+ | {{STEP}} | {{VERIFIED_ACTION_OR_NOT_YET_VERIFIED}} | {{OBSERVABLE_RESULT}} | {{VERIFIED_ACCESS_REQUIREMENT_OR_HELP_LINK_OR_UNKNOWN}} |
39
+
40
+ <!-- Use verified product navigation; do not invent menu labels. Retain this subsection when a feature needs usage guidance. Put implementation details in the technical appendix. -->
41
+
42
+ ## Delivery evidence
43
+
44
+ | Claim | Artifact / deployment evidence | Environment / timestamp | Verification limit |
45
+ | --- | --- | --- | --- |
46
+ | {{PLANNED_MERGED_BUILT_DEPLOYED_OR_ENABLED}} | {{VERIFIED_RECORD_OR_NOT_AVAILABLE}} | {{ENVIRONMENT_AND_TIMEZONE}} | {{WHAT_IS_NOT_ESTABLISHED}} |
47
+
48
+ ## Features and improvements
49
+
50
+ | Change | User impact | Availability / rollout state | Jira / evidence |
51
+ | --- | --- | --- | --- |
52
+ | {{CHANGE}} | {{USER_VISIBLE_BENEFIT_OR_BEHAVIOR}} | {{VERIFIED_AVAILABILITY_PLANNED_OR_UNKNOWN}} | {{VERIFIED_REFERENCE}} |
53
+
54
+ ## Fixes
55
+
56
+ | Fixed behavior | Affected users / conditions | Verification / availability | Jira reference |
57
+ | --- | --- | --- | --- |
58
+ | {{CORRECTED_BEHAVIOR}} | {{SCOPE}} | {{TEST_OR_RELEASE_EVIDENCE_OR_UNVERIFIED}} | {{VERIFIED_KEY_OR_NOT_LINKED}} |
59
+
60
+ ## Breaking changes and required actions
61
+
62
+ | Change | Who must act | Required action / deadline | Compatibility / support reference |
63
+ | --- | --- | --- | --- |
64
+ | {{BREAKING_CHANGE_UNKNOWN_OR_NONE_IDENTIFIED_BY_REVIEW}} | {{AFFECTED_AUDIENCE}} | {{VERIFIED_ACTION_AND_DATE}} | {{VERIFIED_GUIDE_OR_UNKNOWN}} |
65
+
66
+ <!-- If compatibility was not assessed, keep it unknown. “None identified” needs an explicit review scope and evidence. -->
67
+
68
+ <!-- Optional: retain when client, schema, configuration, or data migration is required. -->
69
+ ## Migration / upgrade guidance
70
+
71
+ {{DESCRIBE_VERIFIED_PREREQUISITES_ORDERED_ACTIONS_AND_SUCCESS_CHECKS_WITH_GUIDE_REFERENCES}}
72
+
73
+ {{STATE_DATA_COMPATIBILITY_AND_REVERSIBILITY_LIMITS_WITHOUT_INVENTING_RECOVERY_GUARANTEES}}
74
+
75
+ ## Known issues and limitations
76
+
77
+ | Issue / limitation | Impact / affected scope | Workaround / owner | Tracking reference |
78
+ | --- | --- | --- | --- |
79
+ | {{KNOWN_ISSUE_OR_NONE_KNOWN_FROM_LISTED_EVIDENCE}} | {{IMPACT}} | {{VERIFIED_WORKAROUND_OR_UNAVAILABLE_AND_OWNER}} | {{VERIFIED_REFERENCE_OR_PENDING}} |
80
+
81
+ ## Rollout and recovery status
82
+
83
+ | Stage / environment | State and evidence | Next gate / owner | Recovery reference |
84
+ | --- | --- | --- | --- |
85
+ | {{STAGE}} | {{PLANNED_OR_OBSERVED_STATE_AND_SOURCE}} | {{CRITERION_AND_OWNER}} | {{VERIFIED_RUNBOOK_OR_UNKNOWN}} |
86
+
87
+ ## Validation summary
88
+
89
+ | Check | Result | Evidence / date | Remaining gap |
90
+ | --- | --- | --- | --- |
91
+ | {{CHECK}} | {{PASSED_FAILED_NOT_RUN_OR_UNKNOWN}} | {{ACTUAL_ARTIFACT_AND_DATE}} | {{GAP_OR_NONE}} |
92
+
93
+ ## Support and related documentation
94
+
95
+ {{PROVIDE_VERIFIED_SUPPORT_ROUTE_HOW_TO_API_DOCS_DESIGN_OR_RUNBOOK_REFERENCES}}
96
+
97
+ ## Technical appendix
98
+
99
+ <!-- Optional detail for engineering and support readers. The customer summary and usage guidance must stand alone. -->
100
+
101
+ {{DESCRIBE_VERIFIED_COMPONENT_API_OR_CONFIGURATION_CHANGES_AND_SOURCE_REVISIONS}}
102
+
103
+ {{LINK_DETAILED_MIGRATION_DIAGNOSTIC_OR_RECOVERY_PROCEDURES_WITH_KNOWN_LIMITS}}
104
+
105
+ ## Sources and unknowns
106
+
107
+ | Source / revision | Supports | Retrieved / limitation |
108
+ | --- | --- | --- |
109
+ | {{VERIFIED_RELEASE_ARTIFACT_DEPLOYMENT_RECORD_OR_JIRA_REFERENCE}} | {{CLAIM}} | {{DATE_AND_LIMIT}} |
110
+
111
+ | Unknown / assumption | User or release impact | Owner / next check |
112
+ | --- | --- | --- |
113
+ | {{UNKNOWN_OR_ASSUMPTION}} | {{IMPACT}} | {{OWNER_AND_CHECK}} |
114
+
115
+ ## Revision history
116
+
117
+ | Document version / date | Correction or update | Evidence / author |
118
+ | --- | --- | --- |
119
+ | {{VERSION_AND_DATE}} | {{CHANGE}} | {{REFERENCE_AND_AUTHOR}} |