planning-with-files

Record goals, phases, and decisions in external markdown plan files.

Updated Nov 3, 2025
One-click install
npx skills add https://github.com/ablassejr/dotfiles --skill planning-with-files-ablassejr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/ablassejr/dotfiles/tree/main/dot_claude/skills/private_planning-with-files
Command: npx skills add https://github.com/ablassejr/dotfiles --skill planning-with-files-ablassejr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you manage complex tasks by using persistent markdown files as your working memory, enabling clear planning, progress tracking, and knowledge storage.

Core Features & Use Cases

  • 3-file pattern: task_plan.md for goals and phases, notes.md for research, and [deliverable].md for the final output.
  • Read-before-decide workflow: continuously refresh goals from the plan to guide decisions.
  • Versioned progress: update the plan after each phase with status and decisions.

Quick Start

Create a task_plan.md in your working directory and outline the goal and four phases.

Frequently Asked Questions about planning-with-files

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

FAQPage Schema
How do I track progress for multi-step project tasks across multiple tool calls?

Task planning for multi-step projects uses persistent markdown files as working memory. By recording goals, phases, and decisions in a task_plan.md file, progress is tracked traceably across tool calls through read-before-decide workflows.

What is the best way to organize research notes and deliverables for complex tasks?

Organizing research notes and deliverables is best handled through a standardized 3-file pattern. This includes task_plan.md for goals, notes.md for research data, and a specific deliverable.md file for the final output.

How do I maintain goals and decisions during structured project planning?

Maintaining goals during structured project planning requires a read-before-decide workflow. You continuously refresh goals from the external plan file to guide current decisions, then write versioned updates with status changes after each phase.

Can I use markdown files for knowledge management in research tasks?

Markdown files support knowledge management for research tasks by acting as persistent external storage. The notes.md file captures ongoing research data, while task_plan.md records decisions, ensuring knowledge is stored traceably.

Does task planning with external plan files work for multi-step research workflows?

Task planning with external plan files is explicitly applicable to multi-step research workflows. It supports structured planning and progress tracking by reading goals before actions and writing updates to plan files.

When should I not use a 3-file pattern for task planning?

The 3-file pattern for task planning is unnecessary for simple, single-step tasks. It is designed for complex projects requiring structured planning, persistent working memory, and traceable progress tracking across multiple phases.