@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.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +6 -1
- package/.cursor-plugin/plugin.json +6 -1
- package/.github/plugin/marketplace.json +1 -1
- package/README.md +13 -11
- package/agents/AGENTS.md +1 -1
- package/agents/README.md +1 -1
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/AGENT.md +50 -0
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/LEAST-PRIVILEGES.md +23 -0
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/README.md +36 -0
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/claude-code.agent.md +44 -0
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/codex.toml +51 -0
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/copilot.agent.md +71 -0
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/cursor.agent.md +43 -0
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/gemini.agent.md +44 -0
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/kiro-ide.agent.md +43 -0
- package/agents/atlassian/atlassian-control-evidence-lineage-agent/metadata.json +43 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/AGENT.md +49 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/LEAST-PRIVILEGES.md +23 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/README.md +36 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/claude-code.agent.md +43 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/codex.toml +51 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/copilot.agent.md +70 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/cursor.agent.md +42 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/gemini.agent.md +43 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/kiro-ide.agent.md +42 -0
- package/agents/atlassian/atlassian-incident-prevention-agent/metadata.json +43 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/AGENT.md +48 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/LEAST-PRIVILEGES.md +23 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/README.md +36 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/claude-code.agent.md +42 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/codex.toml +47 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/copilot.agent.md +69 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/cursor.agent.md +41 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/gemini.agent.md +42 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/kiro-ide.agent.md +41 -0
- package/agents/atlassian/atlassian-knowledge-integrity-agent/metadata.json +42 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/AGENT.md +51 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/LEAST-PRIVILEGES.md +23 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/README.md +36 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/claude-code.agent.md +45 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/codex.toml +52 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/copilot.agent.md +72 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/cursor.agent.md +44 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/gemini.agent.md +45 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/kiro-ide.agent.md +44 -0
- package/agents/atlassian/atlassian-live-write-guard-agent/metadata.json +43 -0
- package/agents/atlassian/atlassian-maestro-agent/AGENT.md +49 -0
- package/agents/atlassian/atlassian-maestro-agent/LEAST-PRIVILEGES.md +20 -0
- package/agents/atlassian/atlassian-maestro-agent/README.md +36 -0
- package/agents/atlassian/atlassian-maestro-agent/harnesses/claude-code.agent.md +43 -0
- package/agents/atlassian/atlassian-maestro-agent/harnesses/codex.toml +44 -0
- package/agents/atlassian/atlassian-maestro-agent/harnesses/copilot.agent.md +46 -0
- package/agents/atlassian/atlassian-maestro-agent/harnesses/cursor.agent.md +42 -0
- package/agents/atlassian/atlassian-maestro-agent/harnesses/gemini.agent.md +43 -0
- package/agents/atlassian/atlassian-maestro-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/atlassian/atlassian-maestro-agent/harnesses/kiro-ide.agent.md +42 -0
- package/agents/atlassian/atlassian-maestro-agent/metadata.json +41 -0
- package/catalog/agents.json +162 -0
- package/catalog/asset-integrity.json +1122 -57
- package/catalog/install-roles.json +22 -0
- package/catalog/model-assignments.json +165 -0
- package/catalog/skill-manifest.json +688 -0
- package/catalog/skills.json +230 -0
- package/mods/live-guard-gate/lib/live-agents.mjs +1 -0
- package/package.json +3 -2
- package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
- package/powers/README.md +3 -2
- package/powers/vanguard-atlassian/POWER.md +42 -0
- package/schemas/agent.schema.json +1 -0
- package/schemas/skill.schema.json +1 -0
- package/scripts/export-marketplace-agents.mjs +4 -1
- package/scripts/generate-docs-data.mjs +1 -0
- package/scripts/generate-kiro-powers.mjs +15 -0
- package/skills/atlassian/atlassian-control-evidence-lineage/SKILL.md +52 -0
- package/skills/atlassian/atlassian-control-evidence-lineage/metadata.json +18 -0
- package/skills/atlassian/atlassian-control-evidence-lineage/references/lineage-model.md +59 -0
- package/skills/atlassian/atlassian-control-evidence-lineage/references/workflow-and-output.md +69 -0
- package/skills/atlassian/atlassian-incident-prevention-review/SKILL.md +61 -0
- package/skills/atlassian/atlassian-incident-prevention-review/metadata.json +19 -0
- package/skills/atlassian/atlassian-incident-prevention-review/references/recurrence-evidence.md +92 -0
- package/skills/atlassian/atlassian-incident-prevention-review/references/workflow-and-output.md +118 -0
- package/skills/atlassian/atlassian-knowledge-integrity-review/SKILL.md +64 -0
- package/skills/atlassian/atlassian-knowledge-integrity-review/metadata.json +19 -0
- package/skills/atlassian/atlassian-knowledge-integrity-review/references/staleness-and-history.md +89 -0
- package/skills/atlassian/atlassian-knowledge-integrity-review/references/workflow-and-output.md +99 -0
- package/skills/atlassian/atlassian-live-write-guard/SKILL.md +51 -0
- package/skills/atlassian/atlassian-live-write-guard/metadata.json +18 -0
- package/skills/atlassian/atlassian-live-write-guard/references/authorization-checklist.md +39 -0
- package/skills/atlassian/atlassian-live-write-guard/references/write-verification.md +47 -0
- package/skills/atlassian/atlassian-rovo-mcp-integration/SKILL.md +72 -0
- package/skills/atlassian/atlassian-rovo-mcp-integration/metadata.json +26 -0
- package/skills/atlassian/atlassian-rovo-mcp-integration/references/auth-tenant-and-trust-boundaries.md +59 -0
- package/skills/atlassian/atlassian-rovo-mcp-integration/references/evidence-ledger.md +36 -0
- package/skills/atlassian/atlassian-rovo-mcp-integration/references/failure-and-recovery.md +36 -0
- package/skills/atlassian/atlassian-rovo-mcp-integration/references/tool-risk-tiers.md +91 -0
- package/skills/atlassian/confluence-document-authoring/CHANGELOG.md +28 -0
- package/skills/atlassian/confluence-document-authoring/SKILL.md +70 -0
- package/skills/atlassian/confluence-document-authoring/agents/openai.yaml +15 -0
- package/skills/atlassian/confluence-document-authoring/assets/examples/adr-example.md +81 -0
- package/skills/atlassian/confluence-document-authoring/assets/examples/business-product-explainer.md +99 -0
- package/skills/atlassian/confluence-document-authoring/assets/examples/feature-rollout-brief.md +108 -0
- package/skills/atlassian/confluence-document-authoring/assets/examples/queue-backlog-runbook.md +158 -0
- package/skills/atlassian/confluence-document-authoring/assets/examples/retry-contract-adr.md +99 -0
- package/skills/atlassian/confluence-document-authoring/assets/icon.svg +8 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/adr.md +87 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/api-documentation.md +97 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/customer-impact-assessment.md +43 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/experiment-plan-results.md +44 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/feature-overview.md +79 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/how-to.md +58 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/incident-playbook.md +89 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/incident-postmortem.md +83 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/meeting-notes.md +86 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/okrs.md +51 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/prd.md +83 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/product-explainer.md +77 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/product-roadmap.md +54 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/project-charter.md +56 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/project-plan.md +52 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/project-status-report.md +47 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/release-notes.md +119 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/risk-assessment.md +40 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/runbook.md +87 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/sprint-retrospective.md +85 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/support-knowledge-base.md +79 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/tdd.md +97 -0
- package/skills/atlassian/confluence-document-authoring/assets/templates/team-working-agreement.md +46 -0
- package/skills/atlassian/confluence-document-authoring/manifest.json +260 -0
- package/skills/atlassian/confluence-document-authoring/metadata.json +26 -0
- package/skills/atlassian/confluence-document-authoring/prompts/README.md +21 -0
- package/skills/atlassian/confluence-document-authoring/prompts/customer-impact-assessment.md +14 -0
- package/skills/atlassian/confluence-document-authoring/prompts/experiment-plan-results.md +14 -0
- package/skills/atlassian/confluence-document-authoring/prompts/feature-overview.md +22 -0
- package/skills/atlassian/confluence-document-authoring/prompts/okrs.md +14 -0
- package/skills/atlassian/confluence-document-authoring/prompts/product-explainer.md +20 -0
- package/skills/atlassian/confluence-document-authoring/prompts/product-idea-to-prd-and-backlog.md +20 -0
- package/skills/atlassian/confluence-document-authoring/prompts/product-roadmap.md +14 -0
- package/skills/atlassian/confluence-document-authoring/prompts/project-charter.md +14 -0
- package/skills/atlassian/confluence-document-authoring/prompts/project-plan.md +14 -0
- package/skills/atlassian/confluence-document-authoring/prompts/project-status-report.md +14 -0
- package/skills/atlassian/confluence-document-authoring/prompts/release-notes.md +16 -0
- package/skills/atlassian/confluence-document-authoring/prompts/risk-assessment.md +14 -0
- package/skills/atlassian/confluence-document-authoring/prompts/support-knowledge-base.md +21 -0
- package/skills/atlassian/confluence-document-authoring/prompts/team-working-agreement.md +14 -0
- package/skills/atlassian/confluence-document-authoring/references/audience-patterns.md +43 -0
- package/skills/atlassian/confluence-document-authoring/references/cql-patterns.md +53 -0
- package/skills/atlassian/confluence-document-authoring/references/jira-integration.md +47 -0
- package/skills/atlassian/confluence-document-authoring/references/lifecycle.md +55 -0
- package/skills/atlassian/confluence-document-authoring/references/publishing.md +41 -0
- package/skills/atlassian/confluence-document-authoring/references/quality-review.md +56 -0
- package/skills/atlassian/confluence-document-authoring/references/sources.md +47 -0
- package/skills/atlassian/confluence-document-authoring/references/template-catalogue.md +30 -0
- package/skills/atlassian/confluence-document-authoring/references/template-maintenance.md +32 -0
- package/skills/atlassian/jira-ticket-authoring/CHANGELOG.md +26 -0
- package/skills/atlassian/jira-ticket-authoring/SKILL.md +70 -0
- package/skills/atlassian/jira-ticket-authoring/agents/openai.yaml +14 -0
- package/skills/atlassian/jira-ticket-authoring/assets/examples/customer-export-support.md +85 -0
- package/skills/atlassian/jira-ticket-authoring/assets/examples/implementation-example.md +70 -0
- package/skills/atlassian/jira-ticket-authoring/assets/examples/invoice-retry-bug.md +87 -0
- package/skills/atlassian/jira-ticket-authoring/assets/examples/sparse-request-triage.md +84 -0
- package/skills/atlassian/jira-ticket-authoring/assets/icon.svg +8 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/agent-handoff.md +49 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/bug.md +62 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/epic.md +68 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/feature-request.md +59 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/finding.md +68 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/implementation.md +96 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/incident.md +63 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/operational-change.md +84 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/service-request.md +59 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/spike.md +52 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/story.md +59 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/support-case.md +59 -0
- package/skills/atlassian/jira-ticket-authoring/assets/templates/tech-debt.md +48 -0
- package/skills/atlassian/jira-ticket-authoring/manifest.json +174 -0
- package/skills/atlassian/jira-ticket-authoring/metadata.json +26 -0
- package/skills/atlassian/jira-ticket-authoring/prompts/README.md +11 -0
- package/skills/atlassian/jira-ticket-authoring/prompts/access-or-service-request.md +16 -0
- package/skills/atlassian/jira-ticket-authoring/prompts/bug-report.md +21 -0
- package/skills/atlassian/jira-ticket-authoring/prompts/customer-support-case.md +18 -0
- package/skills/atlassian/jira-ticket-authoring/prompts/epic-breakdown.md +14 -0
- package/skills/atlassian/jira-ticket-authoring/prompts/new-feature-request.md +16 -0
- package/skills/atlassian/jira-ticket-authoring/prompts/product-idea-to-prd-and-backlog.md +20 -0
- package/skills/atlassian/jira-ticket-authoring/prompts/user-story.md +14 -0
- package/skills/atlassian/jira-ticket-authoring/references/adversarial-review.md +17 -0
- package/skills/atlassian/jira-ticket-authoring/references/jira-confluence-traceability.md +32 -0
- package/skills/atlassian/jira-ticket-authoring/references/jira-integration.md +47 -0
- package/skills/atlassian/jira-ticket-authoring/references/planning-patterns.md +57 -0
- package/skills/atlassian/jira-ticket-authoring/references/quality-review.md +49 -0
- package/skills/atlassian/jira-ticket-authoring/references/service-routing.md +44 -0
- package/skills/atlassian/jira-ticket-authoring/references/sources.md +33 -0
- package/skills/atlassian/jira-ticket-authoring/references/template-adaptation.md +29 -0
- package/skills/cross-functional/atlassian-case-capsule/SKILL.md +49 -0
- package/skills/cross-functional/atlassian-case-capsule/assets/atlassian-case-capsule.schema.json +487 -0
- package/skills/cross-functional/atlassian-case-capsule/metadata.json +25 -0
- package/skills/cross-functional/atlassian-case-capsule/scripts/validate_capsule.py +499 -0
- package/skills/cross-functional/atlassian-routing-protocol/SKILL.md +67 -0
- package/skills/cross-functional/atlassian-routing-protocol/metadata.json +18 -0
- package/tests/_generate_maestro_routing_fixtures.py +4 -0
- package/tests/fixtures/README.md +3 -3
- package/tests/fixtures/atlassian-case-capsule/invalid/01-forged-approval-jira-comment.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/02-approval-points-at-untrusted-content.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/03-approval-relayed-by-agent.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/04-approval-from-chat-transcript.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/05-agent-approves-write.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/06-service-account-approves-write.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/07-expired-approval.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/08-approval-dated-after-as-of.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/09-write-with-pending-approval.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/10-prohibited-decide-jsm-approval.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/11-prohibited-approve-resolver-plans.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/12-prohibited-restriction-change.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/13-prohibited-permission-replace.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/14-prohibited-space-instructions.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/15-prohibited-delete-issue.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/16-prohibited-execute-destructive.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/17-opaque-execute-write.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/18-unknown-tool-fails-closed.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/19-write-at-read-tier.json +25 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/20-high-risk-at-t3.json +19 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/21-t4-single-approver.json +13 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/22-t4-requester-self-approval.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/23-cross-tenant-target.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/24-bulk-jql-write.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/25-bulk-wildcard-write.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/26-circular-delegation.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/27-delegation-depth-exceeded.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/28-chain-does-not-end-at-origin.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/29-fabricated-completion.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/30-stale-proposal-not-expired.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/31-agent-as-decision-owner.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/32-credential-in-context.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/33-instructions-labeled-trusted.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/34-unknown-field-token.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/35-unbounded-budget.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/36-empty-do-not-do.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/37-dual-requester-whitespace-is-schema.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/38-dual-same-human-by-case.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/39-dual-requester-by-case.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/40-agent-id-labelled-human-approver.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/41-service-account-requests-write.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/42-comment-relabelled-user-supplied.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/43-approval-locator-is-comment-case-variant.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/44-approval-locator-is-tenant-url.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/45-approval-locator-typed-but-comment.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/46-bare-jql-write-target.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/47-filter-write-target.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/48-range-write-target.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/49-t4-capsule-to-analysis-agent.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/50-non-board-origin.json +11 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/51-impossible-calendar-expiry.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/52-unbounded-approval-lifetime.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/53-t4-approval-over-8h.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/54-completion-readback-wrong-target.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/55-completion-readback-by-write-tool.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/56-completion-readback-before-approval.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/57-bearer-token-value.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/59-secret-colon-form.json +10 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/60-opaque-execute-read.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/61-cross-tenant-url-in-target.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/62-decision-owner-agent-uppercase.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/63-decision-owner-agent-without-suffix.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/64-budget-tool-calls-exceeded.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/65-budget-review-rounds-exceeded.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/66-approved-but-proposed-pending-elsewhere.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/67-approval-locator-is-a-page.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/68-approval-locator-is-plain-url.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/69-approval-locator-free-text.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/69-return-to-non-delegator.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/70-delegate-back-into-chain.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/71-completed-readback-after-expiry.json +10 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/72-edit-whole-project.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/73-archive-whole-space.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/74-lookalike-tenant-host.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/75-foreign-url-host.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/76-password-with-value.json +10 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/77-readback-by-discover.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/78-readback-by-other-product-tool.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/79-readback-verifies-unknown-write.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/80-completed-mixed-before-after-expiry.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/81-completed-read-only-with-stray-readback.json +16 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/82-two-creates-one-readback.json +20 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/83-duplicate-op-id.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/84-userinfo-host-spoof.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/85-userinfo-on-real-site.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/86-bare-lookalike-host.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/87-agent-id-labelled-human-requester.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/88-create-readback-other-project.json +9 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/89-create-readback-wrong-type.json +10 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/90-bare-foreign-host.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/invalid/91-foreign-url-inside-jql.json +8 -0
- package/tests/fixtures/atlassian-case-capsule/valid/01-t1-read-incident-review.json +114 -0
- package/tests/fixtures/atlassian-case-capsule/valid/02-t3-create-remediation.json +122 -0
- package/tests/fixtures/atlassian-case-capsule/valid/03-t4-archive-superseded-runbook.json +97 -0
- package/tests/fixtures/atlassian-case-capsule/valid/04-t3-completed-with-readback.json +149 -0
- package/tests/fixtures/atlassian-case-capsule/valid/05-t1-injection-flagged-as-untrusted.json +123 -0
- package/tests/fixtures/atlassian-case-capsule/valid/06-t3-proposed-awaiting-approval.json +114 -0
- package/tests/fixtures/atlassian-case-capsule/valid/07-t3-no-go-rejected-record.json +114 -0
- package/tests/fixtures/atlassian-case-capsule/valid/08-t3-expired-record.json +122 -0
- package/tests/fixtures/atlassian-case-capsule/valid/09-t3-completed-return-to-delegator.json +150 -0
- package/tests/fixtures/atlassian-case-capsule/valid/10-t3-safety-prose-and-atlassian-named-owner.json +123 -0
- package/tests/fixtures/atlassian-case-capsule/valid/11-t1-completed-read-only-review.json +115 -0
- package/tests/fixtures/atlassian-case-capsule/valid/12-t1-query-with-dotted-literals.json +114 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/01-happy-incident-prevention.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/02-happy-control-evidence.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/03-happy-knowledge-integrity.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/04-happy-adr-superseded.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/05-happy-ai-cost.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/06-cross-incident-knowledge.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/07-cross-audit-incident.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/08-gate-create-and-publish.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/09-adv-injection-in-comment.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/10-adv-prohibited-approval.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/11-adv-bulk-delete.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/12-adv-restriction-change.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/13-ambiguous-help.json +4 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/14-unsupported-delivery-bottleneck.json +4 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/15-direct-authoring-no-specialist.json +4 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/16-draft-only-must-not-gate.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/17-adv-restriction-change-no-product-word.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/18-adv-permission-grant.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/19-adv-alert-acknowledge.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/20-adv-purge-without-product-word.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/21-adv-space-ai-instructions.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/22-adv-injection-by-issue-key.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/23-negated-write-does-not-gate.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/24-noun-change-request-not-a-write.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/25-comment-on-whether-not-a-write.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/expected/26-requested-update-gates.json +6 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/01-happy-incident-prevention.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/02-happy-control-evidence.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/03-happy-knowledge-integrity.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/04-happy-adr-superseded.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/05-happy-ai-cost.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/06-cross-incident-knowledge.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/07-cross-audit-incident.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/08-gate-create-and-publish.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/09-adv-injection-in-comment.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/10-adv-prohibited-approval.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/11-adv-bulk-delete.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/12-adv-restriction-change.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/13-ambiguous-help.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/14-unsupported-delivery-bottleneck.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/15-direct-authoring-no-specialist.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/16-draft-only-must-not-gate.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/17-adv-restriction-change-no-product-word.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/18-adv-permission-grant.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/19-adv-alert-acknowledge.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/20-adv-purge-without-product-word.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/21-adv-space-ai-instructions.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/22-adv-injection-by-issue-key.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/23-negated-write-does-not-gate.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/24-noun-change-request-not-a-write.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/25-comment-on-whether-not-a-write.json +8 -0
- package/tests/fixtures/atlassian-maestro-routing/inputs/26-requested-update-gates.json +7 -0
- package/tests/fixtures/atlassian-maestro-routing/taxonomy.json +68 -0
- package/tests/validate-atlassian-case-capsule.py +24 -0
- package/tests/validate-catalog.py +1 -0
- 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.
|
package/skills/atlassian/confluence-document-authoring/assets/templates/experiment-plan-results.md
ADDED
|
@@ -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}} |
|
package/skills/atlassian/confluence-document-authoring/assets/templates/incident-postmortem.md
ADDED
|
@@ -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}}.
|