Rankings/planning-with-files

planning-with-files

OthmanAdi/planning-with-files

A plugin that teaches AI coding assistants to plan long-term tasks using Markdown files, preventing context loss in long chats, ideal for developers handling complex projects.

Claude Code skill implementing Manus-style persistent markdown planning — the workflow pattern behind the $2B acquisition.

Stars
19,064
Forks
1,707
Watchers
85
Issues
5
💡

A plugin that teaches AI coding assistants to plan long-term tasks using Markdown files, preventing context loss in long chats, ideal for developers handling complex projects.

📂 AI & Automation🤖 AI Related💻 Python📄 MIT

AI Summary

🔍

What This Project Does

Simply put, this is a "notebook" plugin for AI coding assistants (like Claude Code), teaching them to write plans in Markdown files instead of just chatting.

🔧

What Problems It Solves

It solves the issue of AI "forgetting" or losing context during long tasks, solidifying progress in files that can be reviewed and resumed anytime.

👥

Who It's For

Ideal for programmers using AI development tools like Claude Code or Cursor, and users needing AI help with complex multi-step tasks.

📋

Typical Use Cases

1. Letting AI plan the entire development flow of a small software project.

2. Asking AI to remember previous feedback and continue unfinished coding tasks.

3. Using files as intermediate records for humans to check AI thinking during team collaboration.

4. Running automated scripts where AI executes steps without interruption.

Key Strengths & Highlights

It's built on the workflow of Manus, a company acquired by Meta, with high community validation and security-audited code, making it more reliable than random scripts.

🚀

Getting Started Requirements

Requires configuring a Claude Code or Skill-supporting AI environment; no coding needed, just install via README instructions, but some AI tool experience is helpful.

🎯

Purpose

Suitable for scenarios requiring AI to complete multi-step complex tasks continuously, like project development or automation flows, not for simple one-off Q&A or chatting.

Project Info

Primary Language
Python
Default Branch
master
License
MIT
Homepage
Created
Jan 3, 2026
Last Commit
2 days ago
Last Push
2 days ago
Indexed
Apr 19, 2026