aif-improve

Refines existing implementation plans by re-analyzing the codebase for gaps and dependency errors.

31|2|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/letuhao/lore-weave --skill aif-improve-letuhao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aif-improve
Source: https://github.com/letuhao/lore-weave/tree/main/.cursor/skills/aif-improve
Command: npx skills add https://github.com/letuhao/lore-weave --skill aif-improve-letuhao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Initial implementation plans often miss tasks, contain vague descriptions, or have wrong dependency ordering. This Skill performs a second-pass review of an existing plan against the actual codebase, surfacing gaps, redundancies, and out-of-scope work before implementation begins. ## Core Features & Use Cases - Deep Plan Audit: Re-analyzes the codebase to find missing tasks (migrations, config updates, edge cases), vague task descriptions, wrong dependencies, and duplicate or out-of-scope tasks. - Optional Validation Pass: The +check flag dispatches a fresh-context subagent that verifies each finding against the repository, dropping invented items and correcting inaccurate ones. - Plan Discovery Modes: Use --list for read-only plan discovery, @<path> to target a specific plan file, or automatic branch-based resolution with slug or sequential naming. - Use Case: After generating a feature plan with /aif-plan, run /aif-improve to catch that the plan forgot a database migration task and that Task #5 should depend on Task #2, then apply the approved fixes directly to the plan file. ## Quick Start Ask the AI to run /aif-improve on the current plan to find missing tasks and fix dependencies before implementation.

Frequently Asked Questions about aif-improve

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

FAQPage Schema
How do I improve an existing implementation plan?

Run /aif-improve after creating a plan with /aif-plan or /aif-fix. It re-analyzes the codebase, reports missing tasks, task quality issues, and dependency fixes, then applies only the changes you approve.

How do I review a plan without modifying it?

Use /aif-improve --list to see all available plans in read-only mode, or run a normal refinement and choose "No, keep the plan as is" when asked to apply improvements. No files are modified without your confirmation.

What does the +check flag do in plan refinement?

The +check flag dispatches a fresh-context validator subagent that re-reads cited files and verifies each finding. It drops invented items, corrects partially wrong ones, and recomputes dependencies on the filtered list.

Can I target a specific plan file for refinement?

Yes, pass @<path> to override automatic discovery, for example /aif-improve @my-plan.md. Without it, the skill resolves the plan from the current git branch, the plans directory, or the fast and fix plan paths.

What happens if no plan file is found?

The skill stops and tells you to create a plan first using /aif-plan full, /aif-plan fast, or /aif-fix. It never proceeds with refinement when no plan exists at any configured location.