Planning with Files
ActiveDescription
Claude Code skill implementing Manus-style persistent markdown planning — the structured workflow pattern for agent task management.
Key Features
- Manus-style markdown planning — decompose agent tasks into structured plans in persistent markdown files
- Cross-session task persistence — plan files survive across sessions, agents resume anytime
- Plan file locking mechanism — atomic writes and flock mutex to prevent concurrency conflicts
- Subtask and progress tracking — each plan file records subtask status (pending/in_progress/completed)
- Claude Code native integration — seamless skill integration, no extra framework needed
- Multi-IDE compatibility — supports OpenCode, Cursor, Continue SKILL.md variants
Use Cases
💡 Managing complex coding tasks requiring multi-step long-running execution
💡 Resuming agent work progress after interruption
💡 Adding Manus-style task management to Claude Code
💡 Parallel execution of independent subtasks with progress tracking
💡 Building file-based agent workflow orchestration systems
Strengths & Limitations
✅ Strengths
- • Actively maintained, recent updates
- • High community interest (26.6k stars)
- • Permissive open-source license (MIT)
- • Responsive to issues, low backlog
Tags
Categories
Quick Start
npx skills add othmanadi/planning-with-files/planning-with-files
# Use in Claude Code
# 1. Define a goal
/plan-goal "Refactor auth module to support OAuth2"
# 2. Loop through the plan
/plan-loop
# Plan files are saved under plans/ in current directory
# Agent automatically reads and updates plan status