Skip to content

Planning with Files

by Ahmad Othman Ammar AdiSkillGet organised

Makes your AI agent keep its plan, notes and progress in files so long tasks stay on track

View on GitHub

The problem it solves

An hour into a long task your agent loses track, repeats work it already did, and you have to explain everything again.

For People running long agent tasksResearchers using AI agentsDevelopers

Before
You keep the plan in your head and re-brief the agent each time its memory resets.
After
The agent keeps a plan, findings and progress log in your project and reads them to pick up where it stopped.
Stars
★ 28k
License
MIT
Cost
Free
Level
Intermediate
Contents
Includes scripts

Overview

This skill has your AI agent write three plain Markdown files in your project: a task plan with phases and checkboxes, a findings file for research notes and decisions, and a progress log. Hooks remind the agent of the plan as it works, so after a context reset, a crash or a new session it reads the files and picks up at the current phase. It suits anyone who hands an agent research or multi-step work that runs longer than one conversation.

The plan lives on disk as files you can open and edit, so you can see exactly where a long task stands and correct it.

Try these first

Start with the first one: it is a small task you can check easily.

  1. Plan this three-step research task in files first: [describe task]. Show me task_plan.md before you start.First try · writes files

  2. Where does the current task stand? Read the planning files and list what is done and what is next.

  3. Add what you learned about [topic] to findings.md, with the source for each point.writes files

Example prompts written by Agent Flows Hub.

What you get

From the creator's documentation.

OutputWhat it isReads
Task plantask_plan.md with phases and checkboxes, the resume point after a resetYour project folder
Findings filefindings.md for research notes and decisions, added to as it goesYour project folder
Progress logprogress.md recording each session and test resultsYour project folder
Plan remindersHook scripts put the current plan back in front of the agent on each turnRuns scripts
Parallel plansSeparate named plan folders for tasks that run side by sideYour project folder

Good to know

You give an agent a research or build task that takes many steps and may outlast one session. The skill keeps task_plan.md, findings.md and progress.md on disk so the agent can resume from the current phase.

Limits

  • The skill installs hook scripts that run on each prompt and tool call; they need a shell, and Python for the faster path.
  • Planning files are written into your project folder. Several tasks in one folder need separate named plans, or the agent stops rather than guess.

Notes by (original project name: planning-with-files), written from the creator's documentation, not from running it ourselves. planning-with-files README and install · planning-with-files SKILL.md

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

Other skills

  • PM Resume Review Gives point-by-point feedback on a product manager resume, with suggested rewrites
  • PPT Master Turns a document or a topic into a PowerPoint deck you can keep editing
  • PRD Writer Writes a short product requirements document from your idea, users and success measure
  • Product Deep-Dive Report Researches a product, company or idea online and writes a long PDF report in Chinese
  • Product Listing Writer Writes titles, bullet points, descriptions and keywords for your online shop listings
  • Prompt Master Rewrites a rough idea into a clear prompt for the AI tool you name

See all 140 skills · A skill is installed but not loading

GitHub