planning-with-files

Plan and track multi-step tasks using a three-file plan system.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing long-running tasks across sessions is hard; teams lose context when the workspace resets, causing duplicated effort and missed steps. Planning with Files provides a persistent, three-file system (task_plan.md, findings.md, progress.md) to capture roadmaps, decisions, and execution logs so work can be recovered and audited.

Core Features & Use Cases

  • Three-file planning system: task_plan.md tracks phases and tasks, findings.md records decisions and learnings, and progress.md logs execution and status.
  • Supports multi-session work and session recovery across context resets.
  • Facilitates replanning with a clear audit trail and dependency tracking.

Quick Start

Create plans/ at the project root, then initialize plans/task_plan.md, plans/findings.md, and plans/progress.md and begin by outlining Phase 1 tasks.

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 multi-step project planning across multiple sessions?

You can maintain task management context across sessions by implementing a three-file structure—task_plan.md, findings.md, and progress.md—that logs phases, decisions, and execution status to prevent duplicated effort.

What is the best way to recover project context after a workspace reset?

The best way to recover project context is using a persistent file-based plan system that records decisions and execution logs, enabling you to resume multi-step work without losing prior findings or task progress.

How do I set up file-based task management for complex projects?

Set up file-based task management by creating a plans directory at the project root, then initializing task_plan.md, findings.md, and progress.md to outline phases, record decisions, and log execution status.

Can I enforce dependency ordering and phase-based tasks using markdown files?

Yes, a structured markdown planning system can enforce dependency ordering and phase-based tasks by maintaining a durable task_plan.md file that outlines phases and tracks changes within a dedicated plans directory.

When do I need a durable plan system with decision logs for task tracking?

A durable plan system with decision logs is needed for long-running, multi-step tasks spanning multiple sessions, where tracking dependencies, replanning with an audit trail, and recovering context are essential.