planning-with-files

Maintain persistent on-disk planning artifacts with task_plan.md, findings.md, and progress.md.

26.1k|2.2k|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/OthmanAdi/planning-with-files --skill planning-with-files-othmanadi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/OthmanAdi/planning-with-files/tree/main/.cursor/skills/planning-with-files
Command: npx skills add https://github.com/OthmanAdi/planning-with-files --skill planning-with-files-othmanadi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Planning complex tasks often loses goals across many tool calls. This Skill provides a persistent on-disk memory to capture plans, discoveries, and progress, preventing loss of state.

Core Features & Use Cases

  • Create and manage phase-based task plans via task_plan.md, findings.md, and progress.md.
  • Automatic session recovery after /clear to restore prior context.
  • Templates and scripts that support multi-step research, planning, and execution.

Quick Start

Start by creating a planning skeleton in your project with a plan that defines phases and logging files, then begin your work by updating the plan before 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 maintain task planning state across multiple tool calls for complex research projects?▼

You can maintain task planning state by using persistent on-disk memory files like task_plan.md, findings.md, and progress.md to capture plans, discoveries, and phase tracking across multiple tool calls. This prevents losing your goals and context during long-running research tasks.

What is the best way to recover task planning context after a session clear?▼

Session recovery after a clear is handled automatically through on-disk working memory. The Skill uses recovery scripts and persistent markdown templates to restore prior context, plans, and progress so you can resume your multi-step tasks seamlessly.

Can I use markdown templates to track progress for long-running multi-phase tasks?▼

Yes, you can use markdown templates to track progress for multi-phase tasks. The Skill enforces the creation of task_plan.md, findings.md, and progress.md, allowing you to log discoveries and update your task plan before beginning each new phase.

How do I create a planning skeleton for phase-based task execution?▼

To create a planning skeleton, start by defining phases in a task_plan.md file within your project, alongside findings.md and progress.md. You then update this plan before each phase to log progress and maintain a structured workflow throughout execution.

Why does complex task planning lose goals across many tool calls and how to prevent it?▼

Complex task planning loses goals because intermediate state is not persisted. You prevent this by maintaining a persistent on-disk working memory of planning artifacts, ensuring your plans, findings, and progress are safely captured across all tool calls.

Do I need any dependencies to manage workflows with on-disk working memory?▼

No dependencies are required to manage workflows with on-disk working memory. The Skill operates independently using scripts to create and maintain task_plan.md, findings.md, and progress.md files for your project planning and session recovery.