planning-with-files

Manage complex tasks using markdown files for planning and progress tracking.

1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/run6270/skill --skill planning-with-files-run6270
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/run6270/skill/tree/main/planning-with-files
Command: npx skills add https://github.com/run6270/skill --skill planning-with-files-run6270

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured, file-based approach to managing complex, multi-step tasks, ensuring progress is tracked, findings are recorded, and errors are systematically addressed.

Core Features & Use Cases

  • Persistent Working Memory: Utilizes markdown files (task_plan.md, findings.md, progress.md) to maintain context and state across a session.
  • Structured Planning: Enforces creation of a task_plan.md with clear phases and acceptance criteria before task execution.
  • Error Handling: Implements a 3-strike protocol for errors and a reboot test to re-orient the AI.
  • Use Case: When embarking on a project that requires significant research, multiple coding iterations, and careful tracking of progress, this Skill ensures a methodical approach, preventing loss of context and reducing repetitive mistakes.

Quick Start

Before starting any complex task, create a task_plan.md file to outline phases and acceptance criteria.

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 and track progress for multi-step coding projects?

You can maintain context for multi-step coding projects by using a file-based planning approach with persistent markdown files like task_plan.md, findings.md, and progress.md to log state and track development across sessions.

What is the best way to handle repetitive errors during iterative development?

To handle repetitive errors during iterative development, implement a structured error handling protocol like a 3-strike rule, which systematically logs issues and uses a reboot test to re-orient the AI and prevent recurring mistakes.

How do I create a structured task plan for complex project management?

You create a structured task plan for complex project management by defining a task_plan.md file that enforces clear project phases and sets specific acceptance criteria before any actual task execution begins.

When do I need persistent file-based planning for software engineering tasks?

You need persistent file-based planning for software engineering tasks when embarking on projects that require significant research, multiple coding iterations, and careful tracking of progress to prevent loss of context.

Does file-based workflow planning work without external project management dependencies?

Yes, file-based workflow planning works without external dependencies by relying solely on markdown files and defined protocols to maintain working memory, log findings, and systematically resolve issues.

What are the limitations of using markdown files for complex task management?

A limitation of using markdown files for complex task management is that maintaining state requires strict adherence to defined protocols for logging progress and findings, otherwise context may be lost during iterative development.