# OthmanAdi/planning-with-files

Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60+ agents.

Repository: https://github.com/OthmanAdi/planning-with-files
Canonical: https://ross.abutalabs.com/products/planning-with-files
Homepage: https://www.skills.sh/othmanadi/planning-with-files/planning-with-files
Language: Shell
License: MIT
License Family: permissive
Topics: claude, claude-code, claude-skills, manus, agent-skills, planning, autonomous-agents, codex, cursor, multi-agent-systems, coding-agent, context-engineering, github-copilot, llm-agents, long-running-agents, claude-code-skills, context-rot, session-recovery, hermes-plugin, hermes-skill
Last push: 2026-08-22T11:09:40+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 17
- inputs: {"age_days": 242, "days_push": 11, "days_rel": 11, "gap_med": 1.0, "n_releases_24m": 89}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 26376, forks 2210 (observed 2026-08-28T04:11:46.895091+00:00)

## What it is
A persistent file-based planning skill/plugin for AI coding agents that maintains task_plan.md, findings.md, and progress.md on disk and re-injects them every turn. It survives context loss, /clear, crashes, and compaction, with hooks, session recovery scripts, and an opt-in completion gate, installable across 60+ agents via the Agent Skills standard.

## Use cases
- keep my coding agent's plan alive across /clear and context compaction
- recover an agent session after a crash or context reset
- stop my LLM agent from losing track of long multi-step tasks
- add persistent working memory to Claude Code or Cursor
- enforce structured planning and progress tracking for autonomous agents
- prevent context rot during long-running agent tasks

## When to choose
- you run long or multi-step tasks with AI coding agents like Claude Code, Codex, or Cursor
- your agent loses its plan after /clear, compaction, or crashes
- you want Manus-style file-based working memory with per-turn re-injection
- you want a deterministic completion gate before an agent declares a task done

## When to avoid
- you only run short single-turn prompts where persistent planning adds overhead
- you don't want hooks that execute scripts automatically on agent events
- your agent doesn't support the Agent Skills standard or Claude-style hooks

## Facets
- artifact type: plugin
- maturity: active
- function: agent-framework, prompt-engineering, workflow-automation, developer-tools
- domain: large-language-models, developer-tools
- platform: cli, cross-platform
- tags: claude-code, agent-skills, context-engineering, session-recovery, manus-style, planning-files, context-rot, coding-agents, hooks, markdown, ai-agents, automation, nodejs

## Member repositories
- OthmanAdi/planning-with-files (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:46.895091+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:55:52.891166+00:00, confidence not recorded.
  - readme: https://github.com/OthmanAdi/planning-with-files (fetched 2026-08-28T04:11:46.895091+00:00, sha 93cdc4983646)
  - homepage: https://www.skills.sh/othmanadi/planning-with-files/planning-with-files (fetched 2026-08-29T07:52:16.876615+00:00, sha d2fb741b5fbb)
  - site_page: https://www.skills.sh/docs (fetched 2026-08-29T07:52:16.885788+00:00, sha 31de1ab39323)
  - site_page: https://www.skills.sh/docs/cli (fetched 2026-08-29T07:52:16.887592+00:00, sha 9a31957cdc16)
  - site_page: https://www.skills.sh/docs/customize (fetched 2026-08-29T07:52:16.889105+00:00, sha 18b425b78010)
  - site_page: https://www.skills.sh/docs/api (fetched 2026-08-29T07:52:16.890729+00:00, sha beb413506f8e)
  - site_page: https://www.skills.sh/docs/faq (fetched 2026-08-29T07:52:16.892548+00:00, sha a21fcc5038e4)
  - site_page: https://www.skills.sh/about (fetched 2026-08-29T07:52:16.894114+00:00, sha 129b9e1b4d9d)
- Data as of 2026-08-30T08:39:29.467469+00:00.