fix-planner

Generate a detailed fix plan from a bug investigation report.

1|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/VIPER-Metrics/claude-code-skills --skill fix-planner-viper-metrics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-planner
Source: https://github.com/VIPER-Metrics/claude-code-skills/tree/main/skills/fix-planner
Command: npx skills add https://github.com/VIPER-Metrics/claude-code-skills --skill fix-planner-viper-metrics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill generates a clear, actionable plan from a completed bug investigation report, helping teams align on fixes.

Core Features & Use Cases

  • Extract root cause, affected files, in-scope changes, out-of-scope boundaries, and testing requirements from the investigation.
  • Produce a detailed, executable fix plan including file changes, validation steps, and risk assessment.
  • Save the plan to a wiki path and prep it for PR and rollout.

Quick Start

/fix-planner {issue_number}

Frequently Asked Questions about fix-planner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a bug fix plan from a GitHub issue investigation?

You can generate an actionable fix plan by providing the issue number, which extracts root cause, affected files, scope, and testing requirements from an existing investigation report and saves the plan to wiki/issues/$ARGUMENTS/fix-plan.md.

What is included in a bug fix plan for a software engineering issue?

A bug fix plan includes root cause analysis, affected files, in-scope changes, out-of-scope boundaries, testing requirements, validation steps, data remediation, and risk assessment extracted from the investigation report.

Do I need an investigation report before creating a fix plan?

Yes, an investigation report from @investigate-bug must exist on the issue before generating a fix plan, as the tool extracts root cause and affected files from that report.

How do I define out-of-scope boundaries when planning code changes for a bug?

Out-of-scope boundaries are defined by extracting them from the investigation report, ensuring the fix plan clearly separates in-scope code changes from out-of-scope boundaries.

Can I use this approach to plan data remediation for a single issue?

Yes, you can plan data remediation for a single issue as the fix plan includes data remediation steps alongside file changes and validation steps when needed.

What's the best way to document testing strategy in a fix plan?

The best way to document testing strategy is to extract testing requirements from the investigation report and include them in the fix plan as validation steps, ensuring the testing strategy aligns with the root cause and affected files.