planning-with-files

Manage multi-step AI agent tasks with persistent markdown planning files.

196|20|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/xiaoyuge886/aigc --skill planning-with-files-xiaoyuge886
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/xiaoyuge886/aigc/tree/main/.claude/skills/planning-with-files
Command: npx skills add https://github.com/xiaoyuge886/aigc --skill planning-with-files-xiaoyuge886

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill solves the problem of context loss in long-running AI tasks by offloading planning, research, and progress tracking to persistent files on your disk, ensuring the AI never loses track of its goals or findings.

Core Features & Use Cases

  • Persistent Working Memory: Uses task_plan.md, findings.md, and progress.md to maintain state across sessions.
  • Error Recovery Protocol: Implements a structured 3-strike error protocol to prevent repetitive failures and force adaptive problem-solving.
  • Use Case: Ideal for complex research projects or multi-step software development tasks that require dozens of tool calls and need to survive context window resets.

Quick Start

Initialize your project workspace by running the session initialization script to create the required planning files in your current directory.

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 complex AI agent tasks across session resets?

To maintain context for complex AI agent tasks, you can offload planning, research findings, and progress logs to persistent local markdown files like task_plan.md and progress.md. This ensures long-term state retention survives context window resets.

What is persistent file-based state management for multi-step workflows?

Persistent file-based state management for multi-step workflows involves saving goals and session logs to local markdown files. This mechanism prevents the AI from losing track of findings during long-running tasks that require dozens of tool calls.

How do I implement error recovery to prevent repetitive failures in AI automation?

To implement error recovery in AI automation, use a structured 3-strike error protocol. This forces adaptive problem-solving by limiting repetitive failure attempts during complex workflows, ensuring the agent changes its approach after repeated errors.

Do I need Python to run session management scripts for persistent task planning?

Yes, you need Python3 installed to execute the session management scripts required for persistent task planning. You also need a bash or powershell environment to initialize the workspace and verify task completion.

What's the best way to track progress for long-running software development tasks?

The best way to track progress for long-running software development tasks is using dedicated markdown files like progress.md. This approach creates a persistent working memory that survives across sessions without relying on the native context window.

Why does my AI agent lose research findings during multi-step workflows?

Your AI agent loses research findings during multi-step workflows because native context windows reset over long sessions. Offloading findings to local files like findings.md provides persistent storage to prevent this data loss.