planning-with-files

Installation
Summary

Persistent markdown-based planning system for organizing complex multi-step tasks and research projects.

  • Creates three working files (task_plan.md, findings.md, progress.md) in your project directory to serve as persistent "working memory" across agent commands
  • Enforces the 2-Action Rule: save key findings to disk immediately after viewing/searching to prevent multimodal information loss
  • Includes a 3-Strike Error Protocol for systematic debugging: diagnose and fix on attempt 1, try alternative approaches on attempt 2, rethink assumptions on attempt 3, then escalate
  • Provides templates and helper scripts for initializing planning files and tracking phase completion, errors, and discoveries throughout a session
SKILL.md

Planning with Files

Work like Manus: Use persistent markdown files as your "working memory on disk."

Important: Where Files Go

When using this skill:

  • Templates are stored in the skill directory at ${CLAUDE_PLUGIN_ROOT}/templates/
  • Your planning files (task_plan.md, findings.md, progress.md) should be created in your project directory — the folder where you're working
Location What Goes There
Skill directory (${CLAUDE_PLUGIN_ROOT}/) Templates, scripts, reference docs
Your project directory task_plan.md, findings.md, progress.md

This ensures your planning files live alongside your code, not buried in the skill installation folder.

Quick Start

Related skills
Installs
545
GitHub Stars
37.3K
First Seen
Jan 19, 2026