Planning with Files

Active
GitHub Python MIT

Description

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

Tags

agent workflow coding tools automation

Categories

🔄 Workflow

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
Visit GitHub

Related Projects