gabrielmoreira/agent-skills-mirror/plan-to-issue

Plan to Issue

Create a plan collaboratively with the user, then convert the approved plan into a GitHub issue.

Arguments

• $ARGUMENTS: Brief description of what you want to plan (e.g., "add dark mode support", "refactor authentication system")

Instructions

1. Enter plan mode:

Use EnterPlanMode to begin the planning process. Explore the codebase to understand the current implementation and design an approach for: $ARGUMENTS

1. Create a comprehensive plan:

Your plan should include:

• Summary: Brief description of the goal
• Current state: What exists today (based on codebase exploration)
• Proposed changes: What needs to be implemented
• Files to modify: List of files that will need changes
• Implementation steps: Ordered list of specific tasks
• Testing approach: What tests should be added
• Open questions: Any decisions that need user input

1. Iterate with the user:

Use ExitPlanMode to present your plan for approval. The user may:

• Approve the plan as-is
• Request modifications
• Ask clarifying questions

Continue iterating until the user approves the plan.

1. Create the GitHub issue:

Once the plan is approved, create a GitHub issue using gh issue create:

``` gh issue create --title "<concise title>" --body "$(cat <<'EOF' ## Summary <1-2 sentence description of the goal>

## Background <Current state and why this change is needed>

## Implementation Plan

### Files to Modify

• path/to/file1.ts - <what changes>
• path/to/file2.ts - <what changes>

### Tasks

• [ ] <Task 1>
• [ ] <Task 2>
• [ ] <Task 3>

...

### Testing

• [ ] <Test requirement 1>
• [ ] <Test requirement 2>

## Notes <Any additional context, constraints, or open questions>

This issue was created from a planning session with Claude Code. EOF )" ```

1. Report the result:

Provide the user with:

• The issue URL
• A brief confirmation of what was created