planning-with-files

Initialize and track multi-step work in persistent markdown planning files.

14|3|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/kevinlin/cowork-z --skill planning-with-files-kevinlin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/kevinlin/cowork-z/tree/main/src-tauri/resources/skill-templates/planning-with-files
Command: npx skills add https://github.com/kevinlin/cowork-z --skill planning-with-files-kevinlin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill enables Manus-style file-based planning to organize and track progress on large tasks by creating and maintaining on-disk artifacts (task_plan.md, findings.md, progress.md) that survive restarts and provide resilient context.

Core Features & Use Cases

  • Persistent planning memory: stores goals, phases, decisions, and progress in markdown files that can be recovered later.
  • Phase-driven workflow: guidance to structure work into phases with status tracking and templates.
  • Automatic session recovery: scripts and conventions to resume work after breaks or /clear.
  • On-demand templates and resources: ready-to-use skeletons for planning, findings, and progress.

Quick Start

Create a new planning session by running the init-session script, then begin by editing task_plan.md to define goals and phases.

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 context across multiple agent sessions?

Persistent task planning across agent sessions is maintained by writing goals, phases, and progress to on-disk markdown files that survive restarts and provide resilient context recovery.

What is file-based project management for complex agent workflows?

File-based project management organizes multi-step agent workflows by creating task_plan.md, findings.md, and progress.md artifacts to track phases, decisions, and progress on disk.

How do I recover context after an agent session restart or clear?

Context recovery after a session restart or clear uses dedicated scripts and conventions to automatically resume work by reading the persistent planning files stored on disk.

When do I need on-disk planning files for task management?

On-disk planning files are needed for complex scenarios involving many tool calls where you must track phases, recover context across sessions, and maintain a persistent record of decisions.

Can I use markdown templates for project management phase tracking?

Yes, template-driven planning provides ready-to-use markdown skeletons for structuring work into phases with status tracking, ensuring consistent project management documentation.

What are the limitations of file-based context management for agents?

File-based context management requires manual editing of markdown files and relies on script initialization, making it less suited for lightweight tasks that do not need persistent cross-session recovery.