planning-with-files

Organize complex work into persistent markdown planning files and track progress.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Takfes/indie-scaffolder --skill planning-with-files-takfes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/Takfes/indie-scaffolder/tree/main/components/agent-skills-commands/.agents/skills/planning-with-files
Command: npx skills add https://github.com/Takfes/indie-scaffolder --skill planning-with-files-takfes

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill keeps complex tasks from collapsing under context loss by moving plans, findings, and progress into persistent markdown files.

Core Features & Use Cases

  • Persistent Planning: Creates and maintains task_plan.md, findings.md, and progress.md as durable working memory.
  • Session Recovery: Restores context after a clear, restart, or long break by reading existing planning files and recent updates.
  • Progress Tracking: Records phases, decisions, discoveries, and errors for research, coding, and multi-step project work.

Quick Start

Ask this skill to initialize the planning files for your current project and keep them updated as you work.

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 project context and recover from a session loss in long coding tasks?

Persistent planning maintains project context by creating durable markdown files like task_plan.md, findings.md, and progress.md. You can restore context after a restart or clear by reading existing planning files and recent updates to deterministically continue work.

What is the best way to track progress for multi-step research assignments?

Tracking progress for multi-step research assignments involves recording phases, decisions, discoveries, and errors in durable markdown files. This creates persistent working memory that survives context loss and enables deterministic continuation across sessions.

How do I organize complex work into persistent planning files for build-and-debug sessions?

Organize complex work by initializing and maintaining task_plan.md, findings.md, and progress.md files. These durable markdown files act as working memory to track phases, log errors, and preserve context throughout build-and-debug sessions.

Does context engineering with markdown files work for multi-step project management?

Yes, context engineering with markdown files works for multi-step project management by moving plans, findings, and progress into durable files. It prevents complex tasks from collapsing under context loss by reading prior planning state before making decisions.

Do I need orjson to use persistent markdown planning for complex tasks?

Yes, orjson is a required dependency for this persistent markdown planning approach. The scripts component relies on it to organize complex work and track progress across long tasks requiring session recovery.