skills.rest
lucaswall
lucaswallCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

plan-fix

Generate structured fix plans and Linear issues from bug findings.

Updated Feb 4, 2026
Search Tags:#debugging#TDD#Linear#plan#issue-tracking#bug-investigation#PLANS.md
One-click install
npx skills add https://github.com/lucaswall/food-scanner --skill plan-fix
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-fix
Source: https://github.com/lucaswall/food-scanner/tree/main/.claude/skills/plan-fix
Command: npx skills add https://github.com/lucaswall/food-scanner --skill plan-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers manage bug investigations by generating structured fix plans and Linear issues from findings.

Core Features & Use Cases

  • TDD-driven Fix Plans: Generate structured PLANS.md detailing tests, scenarios, and acceptance criteria.
  • Linear Issue Creation: Create Linear Todo items to track fixes with clear scope and prioritization.
  • Documentation & Debugging Aid: Reference CLAUDE.md MCPs for debugging context and logs when available.

Quick Start

Start from a bug report and run the plan-generation flow to produce a PLANS.md and a linked Linear issue. Then implement the fix following the plan.

Frequently Asked Questions about plan-fix

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

FAQPage Schema
How do I create structured bug fix plans from investigation findings?▼

Structured bug fix plans are generated as a PLANS.md file detailing tests, scenarios, and acceptance criteria from investigation findings. This enforces a TDD approach to guide the implementation.

How do I track bug investigations in Linear automatically?▼

Track bug investigations in Linear by creating Todo items with clear scope and prioritization. This links your structured fix plans directly to your issue tracking workflow.

What types of bugs are supported by TDD-driven fix plans?▼

TDD-driven fix plans support code bugs, deployment failures, data issues, and UI problems. They structure investigation findings into actionable tests and acceptance criteria.

Can I use CLAUDE.md MCPs for debugging context during issue tracking?▼

Yes, you can reference CLAUDE.md MCPs for debugging context and logs during issue tracking. This provides necessary environmental data when generating structured fix plans.

Do I need a bug report to start generating a PLANS.md file?▼

Yes, you start from a bug report to run the plan-generation flow. This produces a PLANS.md file and a linked Linear issue to guide your implementation.

Related Skills

Explore More Software Engineering Skills→
son-nguyen-301son-nguyen-301

read-debug-findings

Retrieve complete debug findings reports by path or ID.

Community
Intermediate
Brite-NitesBrite-Nites

verification-before-completion

Enforce multi-level build, test, acceptance, and integration verification before task completion.

Official
Advanced
crystal-peakcrystal-peak
1

linear-sync

Synchronize Linear issues with GitHub via GraphQL API and CLI.

Official
Advanced
TheNordicOneTheNordicOne
9

triage-issue

Investigate codebase root causes and generate a test-driven fix plan.

Community
Intermediate