planning-with-files

Featured

Manus-style persistent file-based planning for AI coding agents: keeps task_plan.md, findings.md, and progress.md on disk so work survives context loss and /clear. Use when asked to plan out, break down, or organize a multi-step project, research task, or any work requiring 5+ tool calls. Hermes adaptation with minimal notes.

AI & Automation 25,800 stars 2162 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 96/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

> Hermes note: lifecycle automation for this skill is provided by the Hermes adapter plugin in `.hermes/plugins/planning-with-files/`. # Planning with Files Work like Manus: Use persistent markdown files as your "working memory on disk." ## FIRST: Restore Context (v2.2.0) **Before doing anything else**, check if planning files exist and read them: 1. If `task_plan.md` exists, read `task_plan.md`, `progress.md`, and `findings.md` immediately. 2. Then check for unsynced context from a previous session: ```bash # Linux/macOS — auto-detects skill directory (Hermes env or default install path) SKILL_DIR="${HERMES_HOME:-$HOME/.hermes}/skills/planning-with-files" $(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" "$(pwd)" ``` ```powershell # Windows PowerShell $HermesDir = if ($env:HERMES_HOME) { $env:HERMES_HOME } else { "$env:USERPROFILE\.hermes" } & (Get-Command python -ErrorAction SilentlyContinue).Source "$HermesDir\skills\planning-with-files\scripts\session-catchup.py" (Get-Location) ``` If catchup report shows unsynced context: 1. Run `git diff --stat` to see actual code changes 2. Read current planning files 3. Update planning files based on catchup + git diff 4. Then proceed with task ## Hermes Notes - Keep the original workflow below unchanged whenever possible. - In Hermes, the adapter plugin approximates lifecycle automation with `pre_llm_call` and `post_tool_call`. - Hermes currently has no full equivalent for the original `Pr...

Details

Author
OthmanAdi
Repository
OthmanAdi/planning-with-files
Created
6 months ago
Last Updated
3 days ago
Language
Python
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category