planning-with-files

Planning With Files is an open-source, file-based project planning framework designed to help AI coding agents (such as Cursor) manage tasks, maintain context, and execute structured development workflows. It uses plain markdown files to define plans, track progress, and provide agents with the right context at each step. The system is lightweight, version-control-friendly, and integrates naturally into any repository-based workflow.

• File-based planning — Store all project plans, tasks, and context as markdown files directly in your repository, making them readable by both humans and AI agents.
• Agent harness integration — Designed specifically for use with AI coding agents like Cursor; provides structured prompts and context files that guide agent behavior.
• Context engineering — Organizes information so agents receive only the relevant context needed for each task, reducing noise and improving output quality.
• Task tracking — Break down projects into discrete, trackable tasks using a simple markdown-based format that agents can read, update, and complete.
• Version control friendly — All planning artifacts are plain text files, making them easy to commit, diff, and review alongside your code.
• Cursor-specific documentation — Includes dedicated guidance (cursor.md) for configuring and using the system with the Cursor AI editor.
• No external dependencies — Runs entirely within your existing file system and repository; no additional services or accounts required.
• Open source — Freely available on GitHub under an open license, allowing full customization and community contributions.