planning-with-files
OthmanAdi
Crash-proof markdown planning for AI coding agents - persists task state across context loss and /clear.
What is planning-with-files?
planning-with-files installs a SKILL.md-based planning harness that keeps three persistent markdown files (task_plan, findings, progress) on disk, so an agent can recover full task state after a crash or context loss by re-reading them. It supports autonomous and gated completion modes and 60+ agents via SKILL.md.
Pros & Cons
Pros
- Zero infrastructure - pure markdown files, works with any SKILL.md agent
- Crash recovery and context-loss resilience are core design principles
- Active development with frequent releases and broad platform support
Cons
- Single-developer project with a high star count from a young repo - watch star authenticity
- Benchmark claims are self-reported with no linked test harness
- File-based state is fragile for concurrent multi-agent use without locking
License
MIT (OSI-open)
When it is interesting
Long-running, multi-step coding tasks in Claude Code, Cursor or Codex that frequently hit context limits or need session recovery.
When it is too early
Short, single-session tasks, or teams already using an agent-integrated task system.
This repo featured in the 2026-07 edition of the Open-Source AI Radar.
RTK
rtk-ai
CLI proxy that compresses shell command output before your AI coding assistant sees it, cutting tokens 60-90%.
TOON
toon-format
Token-Oriented Object Notation - a compact serialization format that uses ~40% fewer tokens than JSON.