planning-with-files

Create and maintain task_plan.md, findings.md, and progress.md planning files.

278|26|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ninehills/skills --skill planning-with-files-ninehills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/ninehills/skills/tree/main/skills/planning-with-files
Command: npx skills add https://github.com/ninehills/skills --skill planning-with-files-ninehills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manus-style planning introduces cognitive overhead for multi-step tasks; this skill provides a structured system of persistent planning files to keep goals and decisions accessible across sessions.

Core Features & Use Cases

  • Create and maintain 3 planning files in your project directory: task_plan.md, findings.md, and progress.md to store phases, discoveries, and session logs.
  • Templates and helper scripts (init-session.sh, check-complete.sh) to bootstrap and verify completion.
  • Works for research projects, software development tasks, and any long-running activity with many tool calls.

Quick Start

Create a new task_plan.md in your project and begin outlining the phases, then document findings in findings.md and progress.md as you execute.

Frequently Asked Questions about planning-with-files

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

FAQPage Schema
How do I track complex multi-step tasks across multiple sessions?

Track complex multi-step tasks across sessions by using persistent planning files like task_plan.md, findings.md, and progress.md to store phases, log discoveries, and preserve history.

What is on-disk memory for project management?

On-disk memory for project management is a structured system of persistent files that enforces creating a task_plan.md first, updates phase statuses, and logs discoveries to keep goals accessible across long-running activities.

How do I manage workflow planning for research projects spanning many tool calls?

Manage workflow planning for research projects by maintaining task_plan.md, findings.md, and progress.md files to document phases, track progress, and log discoveries throughout the activity.

Does this task planning approach work for software development tasks?

Yes, this task planning approach works for software development tasks by using helper scripts to initialize planning files and verify completion, ensuring goals and decisions remain accessible across sessions.

What's the best way to preserve task history and decisions for long-running activities?

The best way to preserve task history is by enforcing the creation of a task_plan.md first, then updating phase statuses and logging discoveries in findings.md and progress.md throughout the workflow.

How do I initialize and verify task plan completion using templates?

Initialize and verify task plan completion by running helper scripts like init-session.sh to bootstrap planning files and check-complete.sh to verify that all phases and tasks are finished.