miro-prod-checklist

v2026.09.24

Audit repository readiness for a fail-closed Miro production release across authorization, data, resilience, rollback, and an approval-gated live handoff. Use when preparing to enable a Miro integration in production. Trigger with "ship Miro integration".

GitHub
Install command
npx skhub add jeremylongshore/miro-prod-checklist
Markdown
SKILL.md

Miro Production Readiness Gate

Overview

Turn production approval into an evidence-backed decision bound to one immutable release and app configuration; use the evidence produced here to make the next decision explicit and reviewable.

Prerequisites

  • Immutable release candidate and deployment manifest
  • Production app/team ownership and approved scopes
  • Test, observability, incident, rollback, and data-handling evidence

Tool Discipline

Use Read, Glob, and Grep to inspect the repository, configuration names, adapters, tests, and evidence. Use WebFetch only for current official Miro documentation. Use Write or Edit after confirming the requested mode, target environment, tenant, board, and approval boundary. These declared tools do not call authenticated Miro APIs or deployment CLIs; implement client, configuration, and test changes, then return exact operator commands or an approval-gated handoff for live execution.

Current Contract

  • Production REST uses v2 resource endpoints and OAuth under /v1/oauth.
  • Experimental features are not production contracts and must be isolated behind explicit risk acceptance.
  • Rate capacity is credit-weighted and must include all callers for a user/application pair.
  • Miro service status, token revocation, and tenant mismatch need operational responses before launch.

Authentication

For REST work, use OAuth 2.0 Authorization Code with the narrowest Miro scopes. Bind each encrypted token record to its user, application, authorized team, and granted scopes. Never print access tokens, refresh tokens, client secrets, authorization codes, or board content.

Instructions

  1. Bind the review to release SHA, dependency lock, app ID hash, scopes, redirect URIs, and environment.
  2. Verify tenant isolation, expiring-token rotation, revocation, least privilege, and redaction controls.
  3. Run unit, contract, bounded live-read, failure, rate, rollback, and recovery tests.
  4. Confirm dashboards, alerts, runbooks, owner/on-call, status dependency, retention, and support escalation.
  5. List every mutation and experimental dependency; require an explicit disposition for each.
  6. Issue GO only when all blocking evidence is current; otherwise return NO-GO with owners and retest criteria.

Approval Boundaries

Production deployment, new app installation, scope changes, initial write enablement, and risk acceptance require the designated owners' explicit approval. Pause when the responsible owner or exact target is uncertain.

Output

Return GO/NO-GO, immutable identity, gate table, evidence links, approvals, rollback trigger, residual risks, and expiry date. State what was not inspected or changed so the receipt cannot overclaim coverage.

Error Handling

ConditionResponse
Release identity changesInvalidate the approval and rerun affected gates.
Evidence is missing or staleReturn NO-GO.
Rollback is untestedReturn NO-GO for write-capable releases.
Experimental dependency is undisclosedStop and route for explicit risk review.

Examples

The example is a redacted operator receipt; identifiers are hashes or bounded labels, not board content or credentials.

sha=8f2c1a7; env=prod; gates=18/18; scopes=approved; rollback=passed; experimental=0; decision=GO

Resources

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

skills/.curated/miro-prod-checklist

Default branch

main

Latest commit

e5a6c3b

Tree SHA

c2dc8e8