planning

Manage complex tasks by creating and updating persistent markdown planning files.

8|2|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/23blocks-OS/ai-maestro-plugins --skill planning-23blocks-os
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning
Source: https://github.com/23blocks-OS/ai-maestro-plugins/tree/main/src/skills/planning
Command: npx skills add https://github.com/23blocks-OS/ai-maestro-plugins --skill planning-23blocks-os

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill solves the "execution problem" by preventing goal drift, lost progress, and repeated errors during complex, multi-step tasks by using persistent markdown files for planning and tracking.

Core Features & Use Cases

  • Persistent Task Planning: Creates and manages task_plan.md, findings.md, and progress.md to maintain focus.
  • Error Prevention: Logs errors and enforces a "never repeat failures" protocol.
  • Use Case: When embarking on a project to build a new authentication system, this Skill ensures you stay on track by defining phases, documenting research, and logging progress, preventing you from forgetting the original goal or repeating mistakes.

Quick Start

Use the planning skill to create task_plan.md, findings.md, and progress.md for your new project.

Frequently Asked Questions about planning

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

FAQPage Schema
How do I prevent goal drift during complex multi-step project management tasks?

To prevent goal drift in project management, use persistent markdown files like task_plan.md, findings.md, and progress.md to record plans, log actions, and track execution state. This enforces rules for reading before deciding and updating after acting to maintain focus.

What is the best way to track progress and log errors for long-running research projects?

The best way to track progress and log errors for research projects is by maintaining progress.md and findings.md files. This approach enforces a strict protocol to log errors and avoid repeated failures by persistently documenting task execution and research outcomes.

How do I set up persistent task planning for a new software engineering project?

To set up persistent task planning for software engineering, initialize task_plan.md, findings.md, and progress.md files. These markdown documents manage multi-step execution by defining phases, documenting research, and tracking milestones to prevent lost progress.

Does markdown-based task management work for preventing repeated execution errors?

Yes, markdown-based task management prevents repeated execution errors by enforcing a strict protocol that logs failures in progress.md. By reading previous error logs before deciding on the next action, you avoid duplicated mistakes during complex workflows.

When do I need persistent markdown files for workflow execution?

You need persistent markdown files for workflow execution when handling complex, multi-step tasks, research projects, or long-running processes. They prevent goal drift, lost progress, and repeated errors by maintaining a durable record of plans and actions.

What are the limitations of using markdown files for project management and task tracking?

A limitation of using markdown files for project management is the strict reliance on manual updates to task_plan.md and progress.md. If execution rules are not followed to log actions and read findings before deciding, the persistent tracking mechanism breaks down.