DEVOURED
Planning-with-files (GitHub Repo)
The 'planning-with-files' project brings persistent, crash-proof markdown planning to AI coding agents, mirroring the architectural approach of the acquired agent startup Manus.
What: Ahmad Othman Ammar Adi released version 3.0.0 of 'planning-with-files,' an open-source tool that forces AI coding agents (Claude Code, Cursor, etc.) to use persistent markdown files on disk for task plans and progress tracking. The latest release introduces autonomous modes and completion gates that prevent agents from abandoning multi-step tasks when context windows reset.
Why it matters: This addresses the 'goal drift' and memory loss inherent in current LLM-based coding agents by shifting 'working memory' from volatile context windows to durable local files.
Takeaway: Install the tool via 'npx skills add OthmanAdi/planning-with-files' if you are performing complex, multi-day coding tasks with agents to maintain state continuity.
Deep dive
- 3-File Pattern: Stores progress in
task_plan.md,findings.md, andprogress.md. - Persistence: Survives
/clearcommands, crashes, and context window overflow. - Autonomous Modes: Supports new gated modes that prevent agents from completing until defined phases are actually verified.
- Compatibility: Supports over 60+ platforms including Claude Code, Cursor, and Codex CLI using the SKILL.md standard.
- Manus Inspiration: Implements the same context-engineering design pattern reported to be the core value driver behind Meta's acquisition of agent startup Manus.
Decoder
- Context Engineering: The practice of optimizing how information is fed into an LLM, specifically moving durable or long-term state out of the limited RAM-like context window and into persistent storage.
- SKILL.md: An open-source specification for packaging tools and behaviors for AI agents so they can be easily shared and installed across different coding environments.
Original article
Full article content is not available for inline reading.
Explore all 67 articles in today's digest
Fresh dev news, AI-digested daily. Never miss a trend at devoured.fyi