p

planning-with-files

Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn r

open-sourcecoding-agents
27.2k
Stars
+2267
Stars/month
237
Commits (90d)
10
Releases (6m)

Star Growth

+6.8k (33.3%)estimated from velocity
20.0k23.9k27.7kJul 2Sep 30

Overview

A skill that maintains task_plan.md, findings.md, and progress.md files on disk for AI coding agents. It provides persistent planning that survives context loss, /clear commands, crashes, and compaction through lifecycle hooks that re-inject planning context each turn. It installs across 60+ agents via the Agent Skills standard with native plugins for Claude Code, Codex CLI, and other platforms.

Deep Analysis

Key Differentiator

File-based planning that persists on disk and re-injects every turn, unlike context-window-dependent to-do lists that disappear with memory resets.

⚡ Capabilities

  • • Persistent file-based planning
  • • Session recovery after /clear and crashes
  • • Per-turn context re-injection
  • • Deterministic completion gates
  • • Multi-agent support
  • • Parallel task isolation

🔗 Integrations

Claude CodeCodex CLIPiHermes AgentOpenCodeDeepSeek Harness60+ agents via Agent Skills standard

✓ Best For

  • ✓ Long-running AI coding agent tasks
  • ✓ Projects requiring crash recovery
  • ✓ Maintaining planning context across sessions
  • ✓ Multi-agent coordination

✗ Not Ideal For

  • ✗ End-user AI applications
  • ✗ Non-coding agent workflows
  • ✗ Simple one-off tasks

⚠ Known Limitations

  • ⚠ Requires explicit catchup mode for reading same-project local agent session records
  • ⚠ File-based approach may not suit all workflow preferences

Alternatives

See all 8 planning-with-files alternatives →

Works with planning-with-files

Tools that integrate with planning-with-files, often used together in the same stack.

Compare planning-with-files

Maintain planning-with-files?

Show your live rank in your README, or put planning-with-files in front of every visitor to AgentoolRank.