Skill Detail

Preserve agent plans across context resets with Planning With Files

Gives coding agents a repeatable file-backed planning workflow using task_plan.md, findings.md, and progress.md so long-running work survives /clear, compaction, crashes, and handoffs.

Developer ToolsMulti-Framework
Developer Tools Multi-Framework Security Reviewed
โญ 25.8k GitHub stars โฌ‡ 508/wk npm
COPY SKILL INSTRUCTIONS (OPTIONAL)
npx skills add agentskillexchange/skills --skill preserve-agent-plans-across-context-resets-with-planning-with-files Copy
Uses the third-party skills CLI, not an ASE-owned installer. Check your agent’s compatibility. This copies instructions; complete the upstream tool setup below separately.
At a glance
Tools required
Planning With Files skill/plugin, filesystem access, Git when plans should be versioned, and a supported coding agent such as Claude Code, Codex, Cursor, Gemini CLI, OpenCode, or OpenClaw
Install & setup
Claude Code plugin route: /plugin marketplace add OthmanAdi/planning-with-files, then /plugin install planning-with-files@planning-with-files. Agent Skills route: npx skills add OthmanAdi/planning-with-files –skill planning-with-files -g.
Author
OthmanAdi
Publisher
Independent
Last updated
Jul 27, 2026
Quick brief

## What the agent does
The agent installs and invokes Planning With Files when a coding task is large enough to need persistent state. It creates or reuses task_plan.md, findings.md, and progress.md, runs the documented lifecycle hooks, records findings as work proceeds, validates phase completion, and uses the repository’s instructions to re-inject the plan on each turn.

How it works

What this skill actually does

## When to use it
Use this when an agent is doing multi-step implementation, investigation, migration, or repair work where context loss would be expensive. It is especially useful before /clear, after compaction, when a session is resumed by another agent, or when a task needs an auditable completion gate.

## Operator actions
The repeatable agent workflow is to run planning setup, validate whether the work needs persistent files, review the active plan before each phase, automate context recovery through hooks, and manage completion without losing the task boundary.

## Scope boundary
This is not a general project-management app, a generic notes convention, or a broad planning framework. The workflow is specifically bounded to agent-operated planning files, recovery after context resets, lifecycle hook reminders, and deterministic progress tracking inside coding-agent sessions.

## Source evidence
The upstream repository documents the three-file pattern, lifecycle hooks, session catchup behavior, completion gates, command names, benchmark notes, and installation routes across Claude Code, Codex, Cursor, Gemini CLI, OpenCode, OpenClaw, and other Agent Skills-compatible runtimes.