plan-with-files

Creates .plans directories with task_plan.md, findings.md, progress.md for file-based task management.

2|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/tizee/skills --skill plan-with-files-tizee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-with-files
Source: https://github.com/tizee/skills/tree/main/skills/plan-with-files
Command: npx skills add https://github.com/tizee/skills --skill plan-with-files-tizee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps teams coordinate and preserve strategy for multi-step tasks by maintaining a persistent external plan and progress log, preventing goal drift across many tool interactions.

Core Features & Use Cases

  • Manus-style file-based planning: creates and maintains a dedicated workspace at .plans/<feature-name>-yymmdd/ with task_plan.md, findings.md, and progress.md.
  • Session scaffolding: templates and scripts to initialize and manage planning files, enabling rapid start for complex tasks.
  • Suitable for research projects, large features, and workflows that require >5 tool calls, collaboration, or iterative decision-making.

Quick Start

Run the init-session script to create planning templates and start a new .plans directory for your feature.

Frequently Asked Questions about plan-with-files

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

FAQPage Schema
How do I maintain task alignment and prevent goal drift in multi-step projects?

Maintain task alignment in multi-step projects by using file-based planning that stores task plans, findings, and progress logs on disk, serving as persistent working memory across many tool interactions.

What is file-based planning and when should I use it for complex workflows?

File-based planning creates on-disk artifacts like task_plan.md and progress.md to track project phases. Use it for complex workflows requiring over five tool calls, iterative decision-making, or extensive research tasks.

How do I set up a persistent planning workspace for a new project feature?

Set up a persistent planning workspace by running an initialization script that creates a dedicated .plans directory with templates for task_plan.md, findings.md, and progress.md to scaffold your feature.

Can I use persistent planning templates for research tasks with iterative decision-making?

Yes, persistent planning templates support research tasks by maintaining a findings.md file to log discoveries and a progress.md file to track iterative decisions, ensuring strategy is preserved across sessions.

Does file-based project management work without external dependencies?

Yes, file-based project management works without external dependencies because it relies solely on on-disk markdown files and internal scripts to structure your task plan, findings, and progress tracking.

Why does my project strategy drift during long workflows with many tool interactions?

Project strategy drifts during long workflows because there is no persistent external plan. File-based planning solves this by maintaining an on-disk progress log and task plan to keep goals aligned.