planning-with-files

Manage task_plan.md, findings.md, and progress.md as living planning documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Enables persistent, structured planning for complex, multi-step tasks by placing planning artifacts in your project workspace (task_plan.md, findings.md, progress.md) and guiding phase-based work.

Core Features & Use Cases

  • Persistent planning files: task_plan.md, findings.md, and progress.md live in your project folder and evolve with the task.
  • Phase-driven execution: Provides a clear phase/state model to coordinate 2-3+ tool interactions and team input.
  • Template-driven bootstrap: Ships ready-to-use templates and a reference set to standardize planning workflow.

Quick Start

Create the planning files in your project directory using the provided templates and start by defining a task plan in task_plan.md.

Frequently Asked Questions about planning-with-files

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

FAQPage Schema
How do I maintain task state and progress for complex multi-phase projects?

You can maintain task state for complex multi-phase projects by using persistent markdown files like task_plan.md, findings.md, and progress.md as living documents that track phases, decisions, and updates within your workspace.

What is the best way to manage task planning files for long-running research projects?

Managing task planning files for long-running research projects is best handled by applying a phase-driven execution model to markdown documents. This uses provided templates to bootstrap task_plan.md and log updates continuously, keeping state and progress intact across many tool interactions.

When do I need persistent markdown planning documents for project workflows?

You need persistent markdown planning documents when working on complex, multi-step tasks requiring 2-3 or more tool interactions, long-running research efforts, or multi-phase projects where tracking state and team input across sessions is essential.

How do I start structured task planning with markdown templates?

To start structured task planning with markdown templates, create the planning files in your project directory using the provided bootstrap templates, then define your initial multi-phase task plan in the task_plan.md file before making project decisions.

Can I use on-disk planning files for team-based project management?

Yes, you can use on-disk planning files for team-based project management because the persistent markdown documents act as external memory. They coordinate phase-based work and team input by enforcing a structured pattern of reading the plan before decisions and logging updates.

Why does complex task management require a phase-driven execution model?

Complex task management requires a phase-driven execution model because multi-step workflows involve many tool interactions and team coordination. Structuring work into clear phases ensures planning files remain synchronized with actual project state and progress.