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.