manifest

Pick up, fix, and promote Manifest contracts. Run with no args (or `help`) to get a quick tutorial. Subcommands: pickup (canonical Spec entry), fix, promote, decompose, diagram, migrate, archive. `new` and `verify` exist for backward compatibility and power-user re-checks respectively.

Review a PR diff for code-level defects (security, correctness, performance, maintainability) and post a severity-tagged review comment. Complements /verify-pr's AC-conformance check.

Manually run bug triage for a contract — scan Sentry, support tickets, and app store reviews for new bug clusters, dedupe against existing JIRA tickets, file new ones. Normally fires automatically via the daily launch-monitor cron, but invoke this when you want an ad-hoc check.

Show where a feature is in its canary ramp and the next recommended step. Reads the latest rollback-guard health verdict and the rolloutPlan. Recommends the next flag change for a human to make — never flips the flag itself.

Express lane for trivial bugs and tiny changes — skips the full contract ceremony. Use for one-line fixes, copy/CSS tweaks, config changes, dependency bumps. Triages size and escalates to /contract if the change turns out bigger than trivial.

Scan Sentry, support tickets, and app store reviews for new bug clusters; deduplicate against existing tickets; file to JIRA with contract back-references; then route each new cluster back into the pipeline (trivial→/fix, substantial→/contract) with propose-by-default guardrails. Invoked nightly by launch-monitor.yml as part of the 4-week monitoring window.

Review a PR diff for code-level defects — security, correctness, performance, and maintainability — and post a severity-tagged review comment. Runs at the PR stage AFTER implementation, complementing verify-pr (which checks contract/AC conformance). Invoked by /code-review or the pr-verify.yml workflow. Stack-agnostic.

Turn a Large contract into a dependency-ordered sequence of Small/Medium child contracts, with risky parts (migrations, auth) flagged as human-led. Use when a contract is sized Large and the user says "decompose", "break this down", "split this epic", or invokes `/contract decompose <ID>`. Large isn't refused — it's made tractable.

Author a new Manifest contract from a rough idea, a one-liner, OR a link to an existing source of truth — JIRA ticket, Linear issue, Notion page, Confluence doc, GitHub issue, or Figma file. Use when the user says "new contract", "draft PRD", "spec out a feature", "pull contract from this JIRA ticket", or invokes `/contract new` with either prose or a URL. Pre-fills as much of the contract as possible from the source, then asks the user only what's still missing.

The canonical Spec entry for Manifest. Dev gives any source — JIRA / Linear / Notion / Confluence / Google Doc / Slack message / GitHub issue / Figma URL, pasted text, an image, or a free-form description — and the agent does the code archaeology, drafts the contract, runs the critics inline, and sorts every gap into three buckets (auto-fill from code, dev decides, PM must answer). PM stays in their normal tool (JIRA comment, Slack DM); they never have to touch Manifest. Use when the user says "pick up this PRD", "start on this ticket", "spec out this feature", "I got a doc from PM", or invokes `/contract pickup <source>` / `/pickup <source>`. Replaces the older `/contract new` → `/contract verify` two-step flow with a single conversational pass.