aif-plan

Generates structured implementation plans with optional git branch and worktree setup.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Starting a new feature without a clear plan leads to scope creep, missed edge cases, and inconsistent code. This Skill turns a short feature description into a structured, task-by-task implementation plan grounded in your project's architecture, conventions, and roadmap. ## Core Features & Use Cases - Two planning modes: Fast mode produces a quick single-file plan, while Full mode asks about tests, logging, and docs preferences, then writes a richer plan with phases, dependencies, and commit checkpoints. - Git-aware workflow: Optionally creates a feature branch or a parallel git worktree, with sequential plan numbering and worktree list/cleanup subcommands. - Project context integration: Reads project description, architecture, roadmap, and research artifacts so tasks follow existing conventions and can link to roadmap milestones. - Use Case: Run the full mode with a description like "Add user authentication with OAuth" to get a phased plan with test and logging requirements saved under your plans directory, ready for implementation. ## Quick Start Ask the assistant to plan a new feature in full mode, for example: plan the implementation of user authentication with OAuth.

Frequently Asked Questions about aif-plan

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

FAQPage Schema
How do I create an implementation plan for a new feature?

Invoke the skill with a mode keyword and description, such as full mode followed by your feature text. Full mode asks about tests, logging, and docs preferences, explores the codebase, and saves a phased plan file under the configured plans directory.

What is the difference between fast mode and full mode planning?

Fast mode writes a quick plan to a single configured plan file with no branch creation. Full mode asks more preference questions, performs deeper codebase exploration, supports commit checkpoints, and can create a git branch or parallel worktree.

Can I run feature planning in a parallel git worktree?

Yes, pass the parallel flag in full mode when git is enabled and branch creation is allowed. The skill creates a worktree, copies project context files into it, and writes the plan there so implementation can proceed in isolation.

Does the planning skill work without a git repository?

Yes, when git is disabled in the project configuration or the directory is not a git work tree, the skill skips all branch and worktree commands and saves full-mode plans under the configured plans directory using a description slug.

Why is my plan filename missing a sequential number prefix?

Sequential numbering only applies when workflow.plan_id_format is set to sequential in the project config. It is also force-disabled when a Handoff-prepared branch is active, in which case the filename matches the branch name.