planning-with-files

Plan complex tasks using persistent markdown files in a _plans directory.

2|Updated Aug 26, 2025
One-click install
npx skills add https://github.com/NikiforovAll/dotfiles2 --skill planning-with-files-nikiforovall
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/NikiforovAll/dotfiles2/tree/main/dot_agents/skills/planning-with-files
Command: npx skills add https://github.com/NikiforovAll/dotfiles2 --skill planning-with-files-nikiforovall

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use persistent markdown files as external memory for complex tasks. Files survive context limits and session boundaries.

Core Features & Use Cases

  • Use TodoWrite to decompose phases into executable tasks.
  • Use Question to confirm findings, decisions, and deliverables before closing session.
  • Directory convention: all planning files go in _plans/ with date-prefixed task folders.

Quick Start

Create the _plans/ directory and start a plan.md to begin organizing a complex task.

Additional Practices

  • Options to add plan.md, research.md, decisions.md, scratch.md as task demands.

Frequently Asked Questions about planning-with-files

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

FAQPage Schema
How do I manage complex task planning across multiple sessions?

To manage complex task planning across multiple sessions, use persistent markdown files as external memory. Files survive context limits and session boundaries, allowing you to maintain a structured _plans directory for continuous execution.

What is the best way to organize external memory files for task management?

Organize external memory files for task management by placing them in a _plans directory with date-prefixed task folders. Create a core plan.md file and add optional research.md, decisions.md, and scratch.md files as the task demands.

Can I use TodoWrite to decompose complex tasks within persistent notes?

Yes, you can use TodoWrite to decompose phases into executable tasks within persistent notes. This approach allows you to break down complex workflows while maintaining traceable decisions in your markdown files.

How do I ensure traceable decisions before closing a planning session?

To ensure traceable decisions before closing a planning session, use Question to confirm findings, decisions, and deliverables. Record these outcomes in decisions.md to maintain a verifiable history of your task progress.

When should I create a scratch.md file for my planning workflow?

Create a scratch.md file for your planning workflow when a complex task demands temporary notes or intermediate research. It supplements your core plan.md by holding transient information that does not belong in final deliverables.