When should I use the AI Maestro Planning skill?

Use this skill for any multi-step task (3+ steps), research projects, or any development task requiring more than 5 tool calls where focus is critical.

How does the 3-strike protocol improve AI coding?

The protocol forces a root-cause diagnosis after the first error, an entirely new approach after the second, and a full assumption check after the third, preventing repetitive failures.

What is the 3-file pattern in AI Maestro Planning?

The 3-file pattern utilizes task_plan.md for goals and phases, findings.md for research data, and progress.md for session logs to ensure Claude never loses context.

Where are the planning files stored in my project?

Files are created in the docs_dev/ directory by default, but can be customized using the AIMAESTRO_PLANNING_DIR environment variable.

Does this skill require external dependencies?

No, the planning skill works standalone within Claude Code, though it can be integrated into the full AI Maestro platform for advanced capabilities.

AI Maestro Planning

Name: AI Maestro Planning
Author: davila7

bydavila7

•

23,611

•

生产力与工作流

Orchestrates complex coding tasks through structured markdown planning and persistent progress tracking.

AI Maestro Planning is a specialized Claude Code skill designed to solve the execution problem during multi-step development tasks. By implementing a persistent three-file markdown pattern—comprising task plans, research findings, and session progress—this skill prevents context loss and 'goal drift' during long-running operations. It enforces rigorous workflows like the 3-strike error protocol and the 2-action rule for findings, ensuring that Claude remains focused, organized, and transparent when handling complex feature builds, deep-dive research, or architectural refactors.

主要功能

01Structured 3-file pattern (Plan, Findings, Progress) for persistent context management.

02Built-in 3-strike error protocol for systematic troubleshooting and assumption validation.

03Self-correction reboot protocol to quickly regain focus during long sessions.

0423,611 GitHub stars

05Phase-based execution tracking to prevent goal drift in multi-step tasks.

06Standardized markdown templates for decisions, error logging, and research discovery.

使用场景

01Executing complex feature migrations requiring more than 5 consecutive tool calls.

02Conducting deep-dive research projects that require documented evidence and resource tracking.

03Maintaining continuity and focus during long-running debugging sessions and refactoring tasks.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add davila7/claude-code-templates ai-maestro

For use in Claude.ai and ChatGPT

Download Skill