planning-with-files

Organize multi-step tasks into persistent Markdown planning and progress files.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/AnXueHua/auto-research --skill planning-with-files-anxuehua
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/AnXueHua/auto-research/tree/main/skills/planning-with-files
Command: npx skills add https://github.com/AnXueHua/auto-research --skill planning-with-files-anxuehua

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents context loss and disorganization during complex, multi-step tasks by using persistent Markdown files as an external working memory so goals, progress, and findings remain accessible across many steps and tool calls.

Core Features & Use Cases

  • Persistent Planning: Create and maintain a task_plan.md to define goals, phases, status, decisions, and error logs.
  • Structured Research: Save intermediate research and findings to notes.md to avoid stuffing large content into ephemeral context.
  • Deliverable Management: Produce a dedicated deliverable file for final outputs and update the plan as phases complete.
  • Use Cases: Research projects, feature development, bug fixes, long-running automation tasks, and any workflow requiring repeated tool calls or checkpoints.

Quick Start

Create a task_plan.md with a clear goal and phases, then iteratively read and update task_plan.md while writing findings to notes.md and producing the deliverable file.

Frequently Asked Questions about planning-with-files

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I maintain task progress and notes across a long multi-step research project?

To maintain progress across a multi-step research project, use persistent markdown files as external working memory. Create a task_plan.md to track goals and phases, and save intermediate findings to notes.md to prevent context loss during iterative tool calls.

What is the best way to organize complex feature development workflows using markdown?

The best way to organize complex feature development workflows is using phased markdown checklists. Define goals in a task_plan.md, log status changes and errors iteratively, and produce a dedicated deliverable file for the final output.

How does persistent file planning work for long-running bug fixes?

Persistent file planning for bug fixes works by re-reading your task_plan.md before decisions and logging errors to support iterative agent loops. This ensures goals remain accessible across many tool calls without relying on ephemeral context.

Can I use markdown planning files for iterative agent loops and automation tasks?

Yes, you can use markdown planning files for iterative agent loops and automation tasks. The workflow requires creating and updating task_plan.md, writing findings to notes.md, and logging status changes to support repeated tool calls and checkpoints.

Do I need any specific dependencies to manage structured research notes with markdown?

No specific dependencies are required to manage structured research notes with markdown. Only need to create task_plan.md and notes.md files to start organizing complex tasks into phased checklists and intermediate findings.

When should I avoid using persistent markdown files for workflow planning?

Avoid using persistent markdown files for workflow planning when tasks are simple enough to fit within ephemeral context. It is designed for complex, multi-step tasks that benefit from phased checklists and repeated tool calls.