planning-with-files

Create and maintain task_plan.md, findings.md, and progress.md for multi-step tasks.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/yangyang-hub/reverse-turing-test-arena --skill planning-with-files-yangyang-hub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/yangyang-hub/reverse-turing-test-arena/tree/main/.agents/skills/planning-with-files
Command: npx skills add https://github.com/yangyang-hub/reverse-turing-test-arena --skill planning-with-files-yangyang-hub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Planning long-running, multi-step tasks without losing context is error-prone. This skill provides persistent, external memory by creating and maintaining task_plan.md, findings.md, and progress.md to organize goals, discoveries, and progress across sessions.

Core Features & Use Cases

  • Creates and maintains external planning files: task_plan.md for phase tracking, findings.md for research and decisions, and progress.md for session logs.
  • Supports automatic session recovery after interruptions, enabling seamless resumption with preserved goals and context.
  • Scales to tasks requiring many tool calls (5+), research projects, and complex workflows with templates and scripts to guide execution.

Quick Start

Run the init-session script to create task_plan.md, findings.md, and progress.md, then outline the task in task_plan.md and log discoveries in findings.md as you proceed.

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 context for long-running, multi-step tasks across sessions?

You can maintain context for long-running tasks by creating external planning files like task_plan.md, findings.md, and progress.md to persistently track goals, decisions, and session logs across interruptions.

What is the best way to plan complex workflows requiring many tool calls?

The best way to plan complex workflows with many tool calls is to use an external memory system that generates task_plan.md for phase tracking and progress.md for session logging, ensuring disciplined execution and traceable decisions.

How do I recover AI agent task progress after an interruption?

You can recover AI agent task progress after an interruption by maintaining an external memory file like progress.md, which logs session history and allows seamless resumption with preserved goals and context.

When do I need external memory files for AI agent planning?

You need external memory files for AI agent planning when executing long-running, multi-step tasks that require many tool calls, ensuring you preserve context, track phases, and maintain traceable decisions reliably.

Does this approach to task planning work without external dependencies?

Yes, this task planning approach works without external dependencies by using built-in scripts to initialize and manage local markdown files for phase tracking, research documentation, and progress logging.

What are the limitations of using markdown files for persistent task planning?

A limitation of using markdown files for persistent task planning is that managing task_plan.md, findings.md, and progress.md requires manual or scripted synchronization to ensure session logs and phase tracking remain consistently updated across complex workflows.