Implements Manus-style file-based planning for complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when starting complex multi-step tasks, research projects, or any task requiring >5 tool calls. Now with automatic session recovery after /clear.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Planning with Files
Work like Manus: Use persistent markdown files as your "working memory on disk."
## FIRST: Check for Previous Session (v2.2.0)
**Before starting work**, check for unsynced context from a previous session:
```bash
# Linux/macOS
$(command -v python3 || command -v python) ${CLAUDE_PLUGIN_ROOT}/scripts/session-catchup.py "$(pwd)"
```
```powershell
# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files\scripts\session-catchup.py" (Get-Location)
```
If catchup report shows unsynced context:
1. Run `git diff --stat` to see actual code changes
2. Read current planning files
3. Update planning files based on catchup + git diff
4. Then proceed with task
## Important: Where Files Go
- **Templates** are in `${CLAUDE_PLUGIN_ROOT}/templates/`
- **Your planning files** go in **your project directory**
| Location | What Goes There |
|----------|-----------------|
| Skill directory (`${CLAUDE_PLUGIN_ROOT}/`) | Templates, scripts, reference docs |
| Your project directory | `task_plan.md`, `findings.md`, `progress.md` |
## Quick Start
Before ANY complex task:
…
The line at the top of this page pins the label v2.10.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_y24tpi2u5aah64hp
GET https://markdownregistry.com/api/v1/resolve?ref=tdimino/claude-code-minoan/planning-with-files
GET https://markdownregistry.com/api/v1/blob/329c66cd6d659ebb73fb1da07384edf39c7abf87863b3c0ab4d6406e2f29ef28
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
tdimino/claude-code-minoan · skills/core-development/agents-md-manager/SKILL.md · This skill should be used when creating, auditing, or maintaining AGENTS.md files and Codex CLI configuration for any…
tdimino/claude-code-minoan · skills/core-development/autoresearch/SKILL.md · Scaffold and run Karpathy-style autoresearch loops in any git repo. This skill should be used when setting up…
tdimino/claude-code-minoan · skills/core-development/claude-md-manager/SKILL.md · Create, audit, and maintain CLAUDE.md documentation files that configure Claude Code for projects. Use this skill when…
tdimino/claude-code-minoan · skills/core-development/claude-usage/SKILL.md · Report ground-truth Claude token consumption and estimated cost by parsing JSONL session files directly. Use when…
tdimino/claude-code-minoan · skills/core-development/dag-typesafe/SKILL.md · Analyze a repository's type system and generate type-safe DAG execution pipelines with GraphSentry-style certificate…
tdimino/claude-code-minoan · skills/core-development/glossary/SKILL.md · Build or update a CONTEXT.md domain glossary for the current project. Establishes shared vocabulary with term…
tdimino/claude-code-minoan · skills/core-development/openrouter-usage/SKILL.md · Query OpenRouter API costs, credits, and usage breakdown by model, provider, and date for the last 30 days. Triggers on…
