plan-fix

Installation
SKILL.md

/plan-fix — Plan and Implement a Fix

Input

Read .ai/issue-analysis-<issue_number>.md for the root cause analysis and reproduction details. NOTE: If the analysis artifact say the issue is already fixed or not reproducible, do not proceed with the fix. Report and stop

Steps

  1. Identify the target repo from the issue analysis. If the repo is not already cloned in the current workspace, clone it here.

  2. Checkout the correct source version. Before making ANY code changes, you MUST checkout the source repo to the exact version that matches the jars in the product pack. Follow the "Checkout the matching source version" instructions in CLAUDE.md:

    • Find the jar version in the product pack's plugins/ directory
    • Find the matching git tag
    • Checkout that tag and create a working branch (fix/issue-<number>)
    • Only then proceed to make code changes
  3. Plan the fix based on the root cause analysis. Keep the change minimal.

Related skills
Installs
18
First Seen
Mar 30, 2026