planning-with-files

Organizes complex multi-step tasks using persistent markdown planning files on disk.

209|5|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/junevm/splathash --skill planning-with-files-junevm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/junevm/splathash/tree/main/.github/skills/planning-with-files
Command: npx skills add https://github.com/junevm/splathash --skill planning-with-files-junevm

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Long tasks with many tool calls cause AI agents to lose track of goals, repeat failed actions, and forget earlier findings. This Skill stores plans, findings, and progress in markdown files so context survives long sessions and even session resets. ## Core Features & Use Cases - File-Based Planning: Creates task_plan.md, findings.md, and progress.md in your project directory to track phases, decisions, and errors. - Session Recovery: A session-catchup script detects unsynced context from a previous session so work can resume after /clear. - Error Discipline: Enforces a 3-strike error protocol and logs every failure to prevent repeating failed actions. - Use Case: When asked to research a topic, fix a bug, or build a feature spanning many steps, the agent writes a phase plan first, updates it after each phase, and re-reads it before major decisions. ## Quick Start Plan out this multi-step project using planning files and track progress as you work through 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 keep an AI agent on track during long multi-step tasks?▼

Write the goal and phases to a task_plan.md file and re-read it before major decisions. This keeps objectives in the model's recent attention window even after dozens of tool calls.

What files does the planning-with-files skill create?▼

It creates three markdown files in your project directory: task_plan.md for phases and decisions, findings.md for research and discoveries, and progress.md for session logs and test results.

Can planning files survive a session reset or /clear?▼

Yes. Because plans live on disk rather than in context, they persist across sessions. The session-catchup.py script analyzes the previous session transcript to find context not yet synced into the planning files.

When should I not use file-based planning?▼

Skip it for simple questions, single-file edits, and quick lookups. The pattern is designed for tasks with three or more steps, research work, or anything spanning many tool calls.

How does the skill handle repeated errors during a task?▼

It enforces a 3-strike protocol: diagnose and fix, try an alternative approach, then rethink assumptions. Every error is logged in the plan file, and after three failures the agent escalates to the user.