Plan-Issue Skill

Use This Skill When

• The user asks to plan implementation.
• The user asks for scope, sequencing, risks, or rollout strategy.
• The task is non-trivial and would change files, infra, or workflows.

Proactive Trigger Matrix

Use /plan proactively when any of these apply:

• New feature implementation with non-obvious design choices.
• Multiple valid approaches exist and tradeoff selection matters.
• Changes are likely to touch more than 2-3 files.
• Existing behavior/architecture will change.
• Requirements are partially unclear and need repo exploration first.
• User preference materially affects implementation direction.

Skip /plan for:

• Trivial typo or obvious one-line fixes.
• Small deterministic edits with no architectural impact.
• Pure information lookup requests (no implementation intent).

Required Workflow

1. Gather context using read-only operations first.
2. Build a concrete implementation plan that includes:

• Goal and acceptance criteria.
• In-scope and out-of-scope.
• Step-by-step execution plan.
• Assumptions and risks/failure modes.
• Test/validation checklist.
• At least one alternative with tradeoffs.

3. End with a hard gate:

• Reply APPROVE to execute this plan.

Hard Limits

• No file writes.
• No package installation.
• No commits, PRs, or system-changing commands.
• If the user requests immediate implementation, still provide the plan unless they explicitly say to skip planning.

Command Alias

/plan is a channel alias for this skill.

Handoff Contract

At the end of every plan response, include:

• Reply APPROVE to execute this plan.

If the user sends APPROVE in the same conversation context, execution may proceed via coding-agent.