planning-with-files

Structure multi-step tasks with task_plan.md, notes.md, and deliverable files.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cookabc/awesome-skills --skill planning-with-files-cookabc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/cookabc/awesome-skills/tree/main/planning-with-files
Command: npx skills add https://github.com/cookabc/awesome-skills --skill planning-with-files-cookabc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Planning large or multi-step tasks often loses structure across sessions. This skill introduces a persistent, three-file workflow to keep goals, research notes, and final outputs organized and up-to-date.

Core Features & Use Cases

  • 3-file pattern: Use task_plan.md for goals and phases, notes.md for findings, and [deliverable].md for the final output.
  • Persistent workspace: Keeps state between sessions to support long-running projects and research tasks.
  • Decision discipline: Encourages updating the plan after each phase, enabling clear traceability and progress tracking.
  • Use Case: Ideal for complex projects, research tasks, or any scenario requiring structured planning and documented outcomes.

Quick Start

  • Create task_plan.md in your working directory with a goal and clearly defined phases.
  • Create notes.md to store gathered findings and research notes.
  • Create [deliverable].md as the final output and update the plan after each phase.

Frequently Asked Questions about planning-with-files

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

FAQPage Schema
How do I structure a complex multi-step project to keep track of progress across sessions?

To structure a complex project, use a 3-file markdown pattern for persistent working memory: task_plan.md for goals and phases, notes.md for research findings, and a deliverable.md for final outputs. This keeps progress organized and up-to-date across sessions.

What is the best way to maintain research notes and task plans for long-running projects?

The best way to maintain research notes and task plans is using a persistent workspace with separate files for planning and findings. Logging progress and errors in task_plan.md and updating the plan before decisions ensures clear traceability for long-running projects.

Do I need any special software to manage project workflows with markdown files?

No special software is required to manage project workflows with markdown files. You only need a text editor to create and update the task_plan.md, notes.md, and deliverable.md files in your working directory to support structured planning and documented outcomes.

How do I create a structured task plan for complex research tasks?

To create a structured task plan for complex research, start by defining a goal and clearly defined phases in task_plan.md. Store gathered findings in notes.md, then generate your final output in a deliverable.md file, updating the plan after each phase.

When should I use a 3-file workflow system for project management?

Use a 3-file workflow system for project management when handling complex projects, research tasks, or any scenario requiring structured planning. It is ideal when you need to maintain state between sessions and ensure decision discipline through documented outcomes.