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
- Gather context using read-only operations first.
- 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.
- 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.