othmanadi/planning-with-files

This is a skill add-on for Claude Code, the command-line coding assistant, that gives the AI a structured way to plan work in plain markdown files that live alongside your project. The pattern it follows is called Manus-style persistent planning, after the AI agent company by the same name that, according to the project's own description, was acquired by Meta for two billion dollars. The basic idea is to stop relying on the assistant's short-term memory and instead write the plan down. The skill installs hook scripts that fire on session start, when you submit a prompt, before and after the assistant uses a tool, and when the session stops. These hooks read and update a planning file in the repository, typically called task_plan.md, so the plan survives across separate chat sessions, restarts, and the /clear command. A recent version added a hash attestation feature that locks the plan file with a SHA-256 checksum and refuses to apply changes if the file has been tampered with. People reach for this when they want longer, multi-session coding work to stay on track without the agent forgetting earlier decisions or wandering off scope. The skill works across several IDE and agent environments listed in the release notes, including GitHub Copilot, Codex, Gemini, Mastra Code, BoxLite, Kiro, and Hermes, and has been translated into Arabic, German, Spanish, and Traditional Chinese. It is written in Python, licensed under MIT, and is currently at version 2.37.0.