resolve-issue - SKILL.md Agent Skill

name: resolve-issue description: Resolve a GitHub issue end-to-end using sequential subagents argument-hint: allowed-tools: Task, Bash, Read, Glob, Grep, Write

Resolve Issue

Resolve a GitHub issue end-to-end by orchestrating the full workflow. Each step runs in a fresh subagent context via the Task tool so that no single context becomes overloaded.

Arguments

/resolve-issue <issue-number>

Workflow

Execute these steps sequentially. Each step uses the Task tool with subagent_type: "general-purpose" to spawn a fresh agent. Wait for each step to complete and verify its output before proceeding to the next.

Between steps, you (the orchestrator) handle verification and branch management directly.

Step 1: Analyze Issue

Spawn a subagent:

subagent_type: general-purpose
description: Analyze GitHub issue
prompt: Read the skill definition at .claude/skills/analyze-issue/SKILL.md and execute it fully. The issue number is $ARGUMENTS. The repository is gittower/git-flow-next.

Verify: Use Glob to confirm .ai/issue-$ARGUMENTS-*/analysis.md was created.

Step 2: Create Feature Branch

Run directly (no subagent needed):

Find the .ai/ folder created in step 1:
```
ls -d .ai/issue-$ARGUMENTS-*
```
Extract the slug from the folder name (e.g., issue-42-squash-merge → 42-squash-merge)

Create a feature branch:

go run main.go feature start <number>-<slug>

If that fails, fall back to:

git checkout -b feature/<number>-<slug> develop

Verify: Confirm current branch is the feature branch.

Save the .ai/ folder path and slug in variables for subsequent steps.

Step 3: Create Plan

Spawn a subagent:

subagent_type: general-purpose
description: Create implementation plan
prompt: Read the skill definition at .claude/skills/create-plan/SKILL.md and execute it fully. The current branch is feature/<slug> and the workflow folder is <ai-folder>. Read the analysis at <ai-folder>/analysis.md as input.

Verify: Use Glob to confirm <ai-folder>/plan.md was created.

Step 4: Validate Tests

Spawn a subagent:

subagent_type: general-purpose
description: Validate test approach
prompt: Read the skill definition at .claude/skills/validate-tests/SKILL.md and execute it fully. The workflow folder is <ai-folder>. The plan is at <ai-folder>/plan.md.

Verify: Read the plan.md to confirm the test section was reviewed or updated.

Step 5: Implement

Spawn a subagent:

subagent_type: general-purpose
description: Implement the plan
prompt: Read the skill definition at .claude/skills/implement/SKILL.md and execute it fully. Implement from <ai-folder>/plan.md. The current branch is feature/<slug>. Use the /commit skill (read .claude/skills/commit/SKILL.md) for creating commits.

Verify (run directly, not in subagent):

go build ./...
go test ./...

If either fails, report the error and ask user whether to retry or abort.

Step 6: Local Review

Spawn a subagent:

subagent_type: general-purpose
description: Review changes locally
prompt: Read the skill definition at .claude/skills/code-review/SKILL.md and execute it fully. Review all new commits on the current branch vs main. Write the review to <ai-folder>/.

Verify: Use Glob to confirm <ai-folder>/review-*.md was created.

Step 7: Implement Review Fixes

Read the review file from step 6. Check for blocking issues or warnings.

If issues found, spawn a subagent:

subagent_type: general-purpose
description: Implement review fixes
prompt: Read the skill definition at .claude/skills/implement/SKILL.md and execute it fully. Implement fixes from the review at <ai-folder>/review-*.md. The current branch is feature/<slug>. Use the /commit skill (read .claude/skills/commit/SKILL.md) for creating commits.

If no issues found, skip this step and report that the review was clean.

Verify (run directly):

go build ./...
go test ./...

Step 8: PR Summary

Spawn a subagent:

subagent_type: general-purpose
description: Generate PR summary
prompt: Read the skill definition at .claude/skills/pr-summary/SKILL.md and execute it fully. The current branch is feature/<slug> and the workflow folder is <ai-folder>.

Verify: Use Glob to confirm <ai-folder>/pr_summary.md was created.

Progress Reporting

After each step, report to the user:

Which step completed (e.g., "Step 3/8: Create Plan - Done")
Key output or findings
Path to any created files
Whether proceeding to next step

Error Handling

If any step fails:

Report the failure with details from the subagent
Ask the user whether to retry, skip, or abort
Do not automatically proceed past failures

Completion

When all steps complete, report:

Summary of all changes made (files modified, commits created)
Path to the PR summary file
The gh pr create command to create the PR
Remind to push the branch first if not yet pushed