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.