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.