New to Claude Skills? Learn how to install them →

davila7 on GitHub

AI Maestro Planning

Free

Structured task execution with markdown files.

Get this skill

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 source

1. Install with the skills CLI

npx skills add davila7/claude-code-templates/planning --agent claude-code

2. 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 davila7

AI 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):

FilePurposeUpdate When
task_plan.mdGoals, phases, decisions, errorsAfter each phase
findings.mdResearch, discoveries, resourcesDuring research
progress.mdSession log, test resultsThroughout 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

  1. Create plan first -- Never start complex work without task_plan.md
  2. Read before decide -- Re-read the plan before any major decision
  3. Update after act -- Mark phases complete, log what changed
  4. 2-action rule -- After every 2 search/browse operations, save findings to findings.md
  5. Log all errors -- Every error goes in the plan with attempt number and resolution
  6. Never repeat failures -- If an action failed, change your approach

The 3-Strike Protocol

StrikeAction
1Diagnose root cause, apply targeted fix
2Try a different approach entirely
3Question assumptions, search for similar issues
After 3Escalate to user with all attempts documented

The 5-Question Reboot

Lost? Answer these from your planning files:

  1. Where am I? (current phase in task_plan.md)
  2. Where am I going? (remaining phases)
  3. What's the goal? (goal section)
  4. What have I learned? (findings.md)
  5. 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