aif-fix

Diagnose and fix codebase bugs with plan-first or immediate-fix workflows, logging, and regression tests.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/1t1sCooL/zazyvala-bot --skill aif-fix-1t1scool
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aif-fix
Source: https://github.com/1t1sCooL/zazyvala-bot/tree/main/.cursor/skills/aif-fix
Command: npx skills add https://github.com/1t1sCooL/zazyvala-bot --skill aif-fix-1t1scool

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging and fixing bugs often lacks structure: fixes get applied without root-cause analysis, without logging for verification, and without tests to prevent regressions. This Skill provides a disciplined bug-fix workflow that investigates the root cause, applies minimal fixes with mandatory logging, suggests test coverage, and records a self-improvement patch so the same class of bug is easier to handle next time. ## Core Features & Use Cases - Two Fix Modes: Choose "Fix now" for immediate investigation and repair, or "Plan first" to generate a reviewable FIX_PLAN.md before any code changes. - Plan Execution: Detects an existing FIX_PLAN.md and executes it step by step, then cleans it up after a successful fix. - Parallel Codebase Investigation: Launches Explore agents to locate the problem area, map affected callers, and find similar past patterns. - Mandatory Logging & Tests: Every fix includes [FIX]-prefixed logging and a suggested regression test the user can approve. - Self-Improvement Patches: Each fix produces a timestamped patch file capturing problem, root cause, solution, and prevention guidance. - Use Case: Paste an error like "TypeError: Cannot read property 'name' of undefined in UserProfile" and get a root-cause fix with logging, a test suggestion, and a knowledge-base patch. ## Quick Start Ask the assistant to fix a bug by describing the error or pasting the stack trace, for example: fix the bug where /api/orders returns an empty array for authenticated users.

Frequently Asked Questions about aif-fix

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

FAQPage Schema
How do I fix a bug with a structured AI workflow?

Provide the bug description or paste the error message as arguments. The skill investigates the codebase with parallel exploration agents, identifies the root cause, applies a minimal fix with logging, and suggests a regression test.

What is the difference between fix now and plan first mode?

Fix now investigates and applies the fix immediately. Plan first creates a FIX_PLAN.md with analysis, fix steps, affected files, and risks, then stops so you can review it before any code changes are made.

Can I execute an existing fix plan automatically?

Yes. If a FIX_PLAN.md exists at the configured path, running the skill without arguments executes the plan step by step, verifies the fix, and deletes the plan file after successful completion.

Does the bug fix workflow add tests and logging?

Yes, both are mandatory. Every fix includes [FIX]-prefixed logging of inputs, outputs, and errors, and the skill always suggests a regression test covering the edge case that caused the bug.

What is a self-improvement patch in a bug fix workflow?

A patch is a timestamped Markdown file recording the problem, root cause, solution, and prevention guidance for each fix. Future runs read recent patches to recognize recurring patterns and avoid repeated mistakes.