Issue Planning Phase
Use this skill for planner-only sessions.
Trigger intent (simple UX)
- •
linear-plan <feature request> - •
linear-plan <problem statement>
If the request is ambiguous, ask clarification questions first, then continue planning.
Required workflow
- •Ask targeted clarification questions until objective and definition of done are clear.
- •Define in-scope and out-of-scope boundaries.
- •Identify constraints and invariants from
docs/agent/security.mdanddocs/agent/quality.md. - •Define acceptance checks.
- •Decompose by ownership (client/server/shared/reviewer/verifier).
- •Choose ticket strategy:
- •small/bounded: create one implementation issue
- •medium/large or dependency-heavy: create orchestration parent issue plus child implementation/review/verification issues
- •Set execution routing label on the main issue:
- •
execution-mode:singlefor direct execution - •
execution-mode:orchestratedfor parent-child orchestration
- •
- •Set deterministic decision labels on the main issue:
- •
risk:low|risk:medium|risk:high - •
scope:client|scope:server|scope:shared|scope:fullstack - •
verification:standard|verification:strict
- •
- •Set issue hierarchy label on the main issue:
- •
issue-role:top-level(required for Linear view filtering)
- •
- •Add
done-whenchecklist in the main issue body (3-6 concrete acceptance bullets). - •Create or update issue(s) with objective, scope, checklist, and dependencies.
- •Only for exceptional high-risk/audit work, also create a companion exec-plan file under
docs/agent/exec-plans/active/.
Output contract
Always return:
- •issue references (
DIM-123and URL) - •main issue ID for execution
- •execution routing label set on main issue (
execution-mode:singleorexecution-mode:orchestrated) - •decision labels set on main issue (
risk:*,scope:*,verification:*) - •issue hierarchy label set on main issue (
issue-role:top-level) - •
done-whenchecklist added to main issue body - •selected ticket strategy (single issue vs orchestration parent + children)
- •concise scope summary
- •execution checklist for implementer
- •explicit blockers/open questions
- •next command hint for user:
linear-implement <MAIN-ISSUE-ID>