Linear Deliver Feature

Use this as the combined lifecycle controller for one Linear issue. Run the narrower skills as phase implementations, but keep the state transitions here.

Read and follow docs/superpowers-linear-persistence.md before changing workflow state or code.

Start by running linear-status against the actual Linear issue. Use the detected labels, status, newest marked comments, and issue description dashboard to resume from the detected phase. Do not start from memory or from the user's last chat message when Linear evidence is available.

Lifecycle State Machine

1. detect-current-state - run linear-status to identify current phase, missing evidence, state disagreement, and recommended next skill.
2. capture-metadata - query live Linear teams, projects, and labels, then normalize them with scripts/linear_metadata.ts capture.
3. create-issue - run linear-create-issue to create or update the issue with target team, target project, proposed matching labels/tags, type label, and one LLM state label.
4. refine-plan - run linear-refine until the issue has a marked plan comment with plan_status: ready or an explicit blocked/accepted-unknown state.
5. implement - run linear-implement only after the ready plan exists, the Superpowers task list is mirrored into the issue description dashboard, and the same required implementer permission context used by direct runs has been passed or confirmed. That context includes workspace write access, package manager and verification command permission, Linear MCP read/write tools, Git/GitHub tools when branch or PR work is in scope, and required project MCP tools. Make code changes, run verification, update the dashboard before moving between top-level tasks, and post marked status comments only for blockers, review readiness, abandoned work, verification failures, handoffs, or write-unavailable mutations.
6. validate-comments - run scripts/validate_marked_comments.ts against the final plan/status comments and issue description dashboard before claiming the workflow is ready for review.
7. review-handoff - confirm PRs or patches are ready, verification evidence is present, and the issue has exactly one workflow state label: llm-review when review is ready, or llm-blocked when not.
8. closeout - run linear-close after review only when the PR is merged, direct issue-ID commit evidence is present, or squash/import release evidence proves current main contains the expected file/content evidence and release/main CI passed. Verify merged PR, direct commit, or release evidence plus mainline and CI evidence, then move the issue to Done, remove all llm-* labels, preserve cumulative sp-* labels, update the dashboard, and post final closeout evidence. If the current issue ID and the implemented issue ID in ticket evidence have different Linear team prefixes because the issue was moved to another team, manually verify the old implemented ID under the same rules, close the current issue, and include both IDs in the closeout note.
9. final-linear-mutations - apply final labels/comments through Linear MCP when write tools are available, or emit REQUIRED_LINEAR_MUTATIONS with exact changes.