pi-planning-with-files

Implement a file-based planning system using markdown files for persistent memory.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/Shawn-Guo-CN/agentfoundry-plugin-marketplace --skill pi-planning-with-files-shawn-guo-cn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pi-planning-with-files
Source: https://github.com/Shawn-Guo-CN/agentfoundry-plugin-marketplace/tree/main/plugins/planning-with-files/.pi/skills/planning-with-files
Command: npx skills add https://github.com/Shawn-Guo-CN/agentfoundry-plugin-marketplace --skill pi-planning-with-files-shawn-guo-cn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and templates (resource) components.

What problem does it solve?

This skill addresses the common AI agent issues of volatile memory, goal drift, and hidden errors by implementing a robust file-based planning system.

Core Features & Use Cases

  • Persistent Memory: Utilizes task_plan.md, findings.md, and progress.md for long-term storage of plans, research, and session logs.
  • Structured Workflow: Enforces a clear planning pattern with phases, critical rules, and error protocols (e.g., 2-Action Rule, 3-Strike Error Protocol).
  • Use Case: When starting a complex multi-step task like building a new feature or conducting in-depth research, this skill ensures all progress, decisions, and findings are systematically recorded and easily retrievable, preventing context loss and maintaining focus.

Quick Start

Use the planning-with-files skill to help me with this task.

Frequently Asked Questions about pi-planning-with-files

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

FAQPage Schema
How do I maintain persistent memory for an AI agent during complex tasks?

Persistent memory for an AI agent is maintained by writing plans, findings, and progress logs to structured markdown files like task_plan.md, ensuring context is preserved across long sessions without drift.

What is file-based planning for agent workflows?

File-based planning uses markdown files to manage complex agent workflows through structured phases, progress tracking, and detailed error logging. It enforces critical rules and protocols to prevent hidden errors and goal drift.

How do I recover an AI agent session after an interruption or error?

Recover an interrupted AI agent session by reading the progress.md and findings.md files. The file-based planning system supports session recovery by logging detailed errors and tracking task completion systematically.

Can I use markdown files for context engineering in multi-step tasks?

Yes, you can use markdown files for context engineering by providing long-term storage for research and plans. They enforce a structured workflow with clear phases and error protocols suitable for complex multi-step tasks.

What is the best way to prevent goal drift in AI agent workflows?

Prevent goal drift in AI agent workflows by implementing a structured file-based planning system. It enforces clear planning patterns with critical rules, such as the 2-Action Rule, and maintains focus through systematic progress tracking in markdown files.

Why does my AI agent lose context during complex multi-step research?

AI agents lose context during complex research due to volatile memory. Implementing persistent memory with markdown files for task plans and findings mitigates this by systematically recording decisions and progress.