planning-with-files

Create and update task_plan.md, findings.md, and progress.md files for multi-step task planning.

7|2|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/SJTU-IPADS/SkVM-data --skill planning-with-files-sjtu-ipads
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/SJTU-IPADS/SkVM-data/tree/main/skills/planning-with-files
Command: npx skills add https://github.com/SJTU-IPADS/SkVM-data --skill planning-with-files-sjtu-ipads

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Planning complex, multi-step tasks often breaks down as context is lost between sessions or tool calls. This skill provides a disciplined pattern using persistent files to capture goals, decisions, and progress so you can resume exactly where you left off.

Core Features & Use Cases

  • Creates and maintains three core files: task_plan.md, findings.md, and progress.md to store plan, research, and session logs.
  • Supports automatic session recovery after /clear and re-reading the plan before tool use to maintain focus.
  • Suitable for planning tasks that require multiple tool calls, research, and iterative decision logging.

Quick Start

Create task_plan.md, findings.md, and progress.md in your project directory to begin a planning session.

Frequently Asked Questions about planning-with-files

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist task planning context across multiple sessions?

To persist task planning context, create on-disk files like task_plan.md, findings.md, and progress.md. These files store goals, research, and session logs so you can resume exactly where you left off after context loss.

What's the best way to recover a multi-step project plan after clearing context?

Recovering a multi-step project plan after clearing context requires on-disk session recovery. The workflow automatically re-reads your task_plan.md and progress.md files to restore focus and continue iterative decision logging without losing prior steps.

How do I track progress and log decisions for complex research tasks?

Track progress and log decisions for complex research tasks by maintaining dedicated markdown files. The workflow enforces phase-based updates to task_plan.md for goals, findings.md for research, and progress.md for session logs to capture iterative decisions.

When do I need on-disk notes for workflow context management?

On-disk notes for workflow context management are needed for multi-step projects requiring numerous tool interactions. Persistent memory matters when tasks span multiple sessions, ensuring automatic session recovery and preventing focus loss between tool calls.

Does this planning workflow work without external dependencies?

This planning workflow operates without external dependencies. It relies solely on creating and updating local markdown files in your project directory to manage task plans, log findings, and enforce phase-based progress tracking.

How to start a planning session for a multi-step project?

To start a planning session for a multi-step project, create task_plan.md, findings.md, and progress.md in your project directory. These files establish the persistent on-disk structure needed for automatic session recovery and progress tracking.