planning-with-files

Manage persistent task planning and notes with markdown files and TodoWrite.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/DxTa/dotfiles --skill planning-with-files-dxta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/DxTa/dotfiles/tree/main/opencode/skills/core/planning-with-files
Command: npx skills add https://github.com/DxTa/dotfiles --skill planning-with-files-dxta

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of maintaining context and progress on complex, multi-step tasks by providing a persistent, file-based system for planning, note-taking, and error tracking, ensuring recovery and continuity across sessions.

Core Features & Use Cases

  • Persistent Planning: Uses task_plan.md to store goals, phases, decisions, and errors, acting as a long-term memory.
  • Live Session Tracking: Integrates with TodoWrite for real-time task visibility within a session.
  • Research & Notes: Utilizes notes.md for capturing research findings and in-depth information, especially for Tier 3+ tasks.
  • Recovery & Continuity: Enables seamless resumption of work after context resets or session interruptions by re-reading task_plan.md.
  • Use Case: For a multi-day project, this Skill ensures that all research, decisions, encountered errors, and progress are meticulously logged in task_plan.md and notes.md, allowing you to pick up exactly where you left off, even after a system reboot or AI context reset.

Quick Start

Use the planning-with-files skill to create a new task plan for a project named 'website-redesign'.

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 task progress and notes for complex multi-step projects across sessions?

To maintain task progress across sessions, use a file-based planning system that stores goals, phases, and errors in markdown files like task_plan.md. This creates persistent long-term memory, ensuring work continuity and seamless recovery even after system reboots or context resets.

How does markdown task planning integrate with live session tracking?

Markdown task planning integrates with live session tracking by using task_plan.md for persistent storage and TodoWrite for real-time visibility. This dual approach syncs file templates with active session state, capturing decisions and errors while displaying current progress directly within the interface.

What is the best way to recover complex task context after an AI context reset?

The best way to recover complex task context after an AI context reset is by re-reading the task_plan.md file. This persistent markdown document logs all encountered errors, research findings, and progress, allowing you to pick up exactly where you left off without losing critical state information.

Can I use file-based note-taking for tiered task complexity management?

Yes, you can use file-based note-taking for tiered task complexity management by utilizing task_plan.md for standard tracking and notes.md for in-depth research. This supports tiered complexity from T1 to T3+, defining specific file persistence and content templates based on the task level.

Does persistent planning and note-taking work with Graphiti memory for knowledge transfer?

Yes, persistent planning and note-taking works with Graphiti memory by enabling knowledge transfer after task completion. The structured markdown files containing research, decisions, and progress logs can be exported to Graphiti memory systems to build long-term organizational knowledge.

When should I not use a markdown file system for project task management?

You should not use a markdown file system for project task management when dealing with simple, single-step tasks that do not require persistent recovery or multi-day tracking. For brief operations without context reset risks, the overhead of maintaining task_plan.md and notes.md is unnecessary.