
AI Maestro Planning
FreeStructured task execution with markdown files.
Free · Opens the source repo
What AI Maestro Planning does
AI Maestro Planning is designed to enhance your productivity during complex, multi-step tasks by providing a structured approach to planning and tracking. This skill utilizes persistent markdown files to maintain context, ensuring that you stay focused on your goals throughout the execution of intricate tasks. Whether you're managing a research project, developing a new feature, or executing a series of interconnected actions, this skill helps you document your progress and findings effectively.
The skill operates on a simple yet powerful three-file pattern. You create a task_plan.md to outline your goals, phases, decisions, and any errors encountered; a findings.md to log research discoveries and resources; and a progress.md to maintain a session log of your activities and test results. This organization allows you to easily refer back to what you've done and learned, minimizing the risk of losing context as you navigate through complex workflows.
AI Maestro Planning is particularly useful for developers and designers who often juggle multiple tasks and need a reliable way to track their progress. By following the six rules and three-strike protocol outlined in the skill, users can ensure that they maintain a clear path towards their objectives while avoiding common pitfalls that lead to goal drift. This structured approach not only helps in executing tasks efficiently but also encourages a disciplined methodology for problem-solving.
For those who are looking for a standalone solution, this skill can be used independently without the need for additional dependencies. However, for a more comprehensive experience, it can be integrated into the full AI Maestro platform, which offers additional functionalities such as memory search and agent messaging.
When to use it
Use this skill when working on multi-step tasks, research projects, or any task that requires structured tracking to maintain focus.
When not to use it
This skill may not be suitable for simple tasks or one-off actions that do not require extensive planning or tracking.
What you can build with it
Planning a Research Project
When embarking on a research project, use AI Maestro Planning to create a structured plan, log findings, and track progress.
Developing a New Feature
For feature development that involves multiple steps, this skill helps keep track of goals and decisions made throughout the process.
Managing Complex Tasks
Utilize this skill for any complex task that requires more than five tool calls, ensuring you remain focused and organized.
How to install AI Maestro Planning
View source1. Install with the skills CLI
npx skills add davila7/claude-code-templates/planning --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by davila7AI Maestro Planning
Solve the execution problem -- staying focused during complex, multi-step tasks. Uses persistent markdown files to track goals, findings, and progress so you never lose context. Part of the AI Maestro suite.
When to Use
- Multi-step tasks (3+ steps)
- Research projects
- Building features requiring >5 tool calls
- Any task where you might lose track of the goal
The 3-File Pattern
Create in docs_dev/ (or $AIMAESTRO_PLANNING_DIR):
| File | Purpose | Update When |
|---|---|---|
task_plan.md | Goals, phases, decisions, errors | After each phase |
findings.md | Research, discoveries, resources | During research |
progress.md | Session log, test results | Throughout session |
Quick Start
PLAN_DIR="${AIMAESTRO_PLANNING_DIR:-docs_dev}"
mkdir -p "$PLAN_DIR"
Then create task_plan.md with:
# Task: [Goal]
## Phases
- [ ] Phase 1: Research
- [ ] Phase 2: Design
- [ ] Phase 3: Implement
- [ ] Phase 4: Test
## Decisions
| Decision | Rationale | Date |
|----------|-----------|------|
## Errors Encountered
| Error | Attempt | Resolution |
|-------|---------|------------|
The 6 Rules
- Create plan first -- Never start complex work without
task_plan.md - Read before decide -- Re-read the plan before any major decision
- Update after act -- Mark phases complete, log what changed
- 2-action rule -- After every 2 search/browse operations, save findings to
findings.md - Log all errors -- Every error goes in the plan with attempt number and resolution
- Never repeat failures -- If an action failed, change your approach
The 3-Strike Protocol
| Strike | Action |
|---|---|
| 1 | Diagnose root cause, apply targeted fix |
| 2 | Try a different approach entirely |
| 3 | Question assumptions, search for similar issues |
| After 3 | Escalate to user with all attempts documented |
The 5-Question Reboot
Lost? Answer these from your planning files:
- Where am I? (current phase in
task_plan.md) - Where am I going? (remaining phases)
- What's the goal? (goal section)
- What have I learned? (
findings.md) - What have I done? (
progress.md)
Full AI Maestro Experience
This skill works standalone with no dependencies. For the complete experience including memory search, docs search, graph query, agent messaging, and agent management, install the full AI Maestro platform.
Frequently asked questions about AI Maestro Planning
Similar skills
Canva Creator
Streamline your content campaign from brief to HubSpot.
Cowork Plugin Customization
Tailor your Claude Code plugin to fit your organization.
Impediment Prioritization
Rank and prioritize impediments effectively.
Chronicle
Streamline your Copilot session analysis and reporting.
Idea Refine
Transform vague ideas into actionable concepts.
App Store Optimization
Optimize your mobile app's visibility and performance.
