planning-with-files

Manage complex tasks with persistent markdown planning files.

41|3|Updated Jan 2, 2026
One-click install
npx skills add https://github.com/tdimino/claude-code-minoan --skill planning-with-files-tdimino
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/tdimino/claude-code-minoan/tree/main/skills/planning-productivity/planning-with-files
Command: npx skills add https://github.com/tdimino/claude-code-minoan --skill planning-with-files-tdimino

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a robust framework for managing complex, multi-step tasks by leveraging persistent markdown files as an external memory, preventing information loss and ensuring task completion.

Core Features & Use Cases

  • File-Based Planning: Utilizes task_plan.md, findings.md, and progress.md for structured task management.
  • Session Recovery: Automatically checks for and helps reconcile unsynced context from previous sessions.
  • Error Management: Implements a 3-strike protocol for errors and encourages logging all encountered issues.
  • Use Case: When starting a large research project or developing a new feature, use this Skill to meticulously plan phases, log discoveries, track progress, and ensure no critical detail is lost due to context window limitations.

Quick Start

Initialize planning files for your project by running the init-session.sh script.

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 progress and research findings across multiple sessions?

Persistent planning uses markdown files like task_plan.md, findings.md, and progress.md to store task phases and logs, preventing information loss across context windows and enabling automatic session recovery.

What is file-based planning for complex software engineering tasks?

File-based planning leverages markdown files as external memory to manage multi-step tasks. It structures task phases, research discoveries, and progress logs to ensure meticulous tracking and task completion.

How do I recover lost context when a long task session is interrupted?

Automatic session recovery checks for and reconciles unsynced context from previous sessions. It reads persistent markdown files to restore your task phase, findings, and progress logs seamlessly.

Does this file-based planning approach work with standard shell scripts and markdown?

Yes, the approach utilizes shell scripts to initialize sessions and markdown files for persistent memory. It supports standard tools including Read, Write, Edit, Bash, Glob, Grep, WebFetch, and WebSearch.

How are errors handled during complex multi-step task management?

Error handling implements a 3-strike protocol for recurring issues and encourages logging all encountered problems directly into the persistent markdown files for later review and resolution.

When do I need persistent markdown files for task management?

You need persistent markdown files when working on large research projects or developing new features where context window limitations risk losing critical details, phases, and research findings.