planning-with-files

Enforce a three-file pattern with task_plan.md, notes.md, and a deliverable.

1|Updated Oct 5, 2024
One-click install
npx skills add https://github.com/naps62/nixos-config --skill planning-with-files-naps62
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/naps62/nixos-config/tree/main/home/common/programs/opencode/skills/planning-with-files
Command: npx skills add https://github.com/naps62/nixos-config --skill planning-with-files-naps62

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transforms complex tasks into a repeatable, file-backed workflow by using a persistent three-file pattern (task_plan.md, notes.md, [deliverable].md) to anchor goals, research, and final outputs.

Core Features & Use Cases

  • Three-file pattern: Create and maintain task_plan.md, notes.md, and [deliverable].md to structure every non-trivial task.
  • Loop-based workflow: Guide planning, research, execution, and delivery with iterative plan updates after each phase.
  • Use Case: Ideal for multi-step projects, research tasks, and long-running tasks that require organized notes and a final deliverable.

Quick Start

Create task_plan.md with a goal and phases, then perform research and save findings to notes.md, and finally create the deliverable and update the plan.

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 multi-step research tasks without losing track of progress?

Multi-step research tasks are managed by enforcing a persistent three-file pattern: task_plan.md for goals, notes.md for findings, and a final deliverable file. This file-backed workflow anchors project phases and maintains progress updates after each execution step.

What's the best way to structure extended project workflows spanning multiple tool calls?

Structuring extended project workflows requires a loop-based approach using Markdown files. You create task_plan.md to define phases, save intermediate outputs to notes.md instead of context, and update the plan iteratively to guide planning, research, execution, and delivery.

When do I need a file-backed planning workflow for task management?

A file-backed planning workflow is needed for non-trivial, multi-step projects or long-running tasks. It is applicable when work spans multiple tool calls and requires storing large outputs in persistent Markdown files rather than temporary context to prevent data loss.

How do I organize task planning and deliverables using Markdown files?

Organize task planning by creating task_plan.md with a defined goal and phases, record research findings in notes.md, and compile the final output into a deliverable file. Update the task_plan.md after each phase to maintain a structured project workflow.

Can I use persistent Markdown files for organizing complex project deliverables?

Yes, persistent Markdown files organize complex project deliverables by separating goals, notes, and final outputs into a three-file pattern. This approach transforms complicated tasks into a repeatable workflow, ensuring deliverables and research are systematically tracked.

What are the limitations of using a three-file pattern for task planning?

The three-file pattern requires manual updates to task_plan.md after each project phase and strict adherence to saving large outputs to files. It is less suited for simple, single-step tasks that do not require organized notes or extended research tracking.