planning-with-files
Uses persistent markdown files for general planning, progress tracking, and knowledge storage (Manus-style workflow). Use for multi-step tasks, research projects, or general organization WITHOUT mentioning PRD. For PRD-specific work, use prd-planner skill instead.
By zhaono1 · 1,159 installs
npx skills add zhaono1/agent-playbook --skill planning-with-files
Source repository · Upstream listing
Planning with Files
"Work like Manus" — Uses persistent markdown files for planning, progress tracking, and knowledge storage.
Description
A skill that transforms your workflow to use persistent markdown files for planning and progress tracking.
The Problem
Claude Code (and most AI agents) suffer from:
Volatile memory — TodoWrite tool disappears on context reset
Goal drift — Original goals get forgotten after many tool calls
Hidden errors — Failures aren't tracked, mistakes repeat
Context stuffing — Everything crammed into context instead of stored
The Solution: 3 File Pattern
For every complex task, create THREE files:
The Workflow Loop
When to Use
Use this pattern for:
Multi step tasks (3+ steps)
Research tasks
Building/creating projects
Tasks spanning many tool calls
Anything requiring organization
Skip for:
Simple questions
Single file edits
Quick lookups
Installation
This skill is typically installed globally at ~/.claude/skills/planning with files/ .
From this repository:
If you prefer the standalone workflow, see the upstream repository in the Links section.
The Manus Principles
Principle Implementation
Filesystem as memory Store in files, not context
Attention manipulation Re read plan before decisions
Error persistence Log failures in plan file
Goal tracking Checkboxes show progress
Append only context Never modify history
Example
You: "Research the benefits of TypeScript and write a summary"
Claude creates:
Links
[GitHub Repository](https://github.com/OthmanAdi/planning with files)
[Context Engineering for AI Agents](https://manus.im/de/blog/Context Engineering for AI Agents Lessons from Building Manus)