OthmanAdi/planning-with-files

A planning skill that keeps multi-step work in Markdown files — plans, progress, and handoffs — so an agent can survive context resets without losing the thread.

25.5k stars 2.2k forksLicense: MITUpdated 2026-07-14
Productivityplanningcontextfilesworkflow
View on GitHub

Why it matters

Long agent tasks routinely blow past the context window and forget what they were doing. Planning-with-files externalizes the plan and progress into durable files the agent re-reads, so a session can be interrupted, resumed, or handed to a fresh context and still finish coherently. It is a pragmatic answer to the single most common failure mode in long-running agent work.

Use cases

  • Persist a task plan and progress across context resets
  • Resume long-running work in a fresh session without losing state
  • Hand a topic off between sessions via structured files
  • Keep multi-step operations coherent from start to finish

Quickstart

npx skills add OthmanAdi/planning-with-files

Related repositories

JuliusBrusseeProductivity

caveman

A cross-agent skill that strips filler from Claude’s replies and answers in terse, token-lean prose while keeping code, commands, and error text byte-for-byte exact.

90.3k 5.1k
tokensoutputefficiencycross-agent
nidhinjsProductivity

prompt-master

A ready-to-clone library of reusable prompts and prompt patterns that installs directly into your Claude skills folder.

10.5k 1.3k
promptslibrarytemplatesbeginner

Maintain this repo? Submit an update.

Submit an update