planning-with-files

Plan complex tasks with persistent file-based artifacts in task_plan.md, findings.md, and progress.md.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill addresses the challenge of keeping complex tasks organized across many steps by providing a persistent file-based planning system that stores key artifacts on disk.

Core Features & Use Cases

  • Plan everything upfront: Create and maintain task_plan.md to outline phases and goals.
  • Capture findings and progress: Use findings.md and progress.md to log research and session activity.
  • Use case: For a research project with multiple tool calls, generate a plan, accumulate findings, and log progress to avoid losing context.

Quick Start

To start a planning session, run the included scripts to initialize planning files, then begin updating task_plan.md and findings.md 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 task context for multi-step research projects?

You can maintain task context by using a persistent file-based planning workflow that stores artifacts like task plans and findings on disk, preventing context loss across multiple tool calls.

What is the best way to plan complex tasks that require multiple tool calls?

The best way to plan complex tasks is to initialize on-disk templates that manage task_plan.md, findings.md, and progress.md, ensuring you outline phases and log session activity systematically.

Do I need a Bash environment to use file-based task planning?

Yes, you need a Bash-enabled environment to run the included scripts that initialize and manage the persistent planning files required for this workflow.

How do I track progress and research findings during long sessions?

You track progress and research findings by logging session activity and accumulated results directly into findings.md and progress.md files stored on disk.

Can I use these planning templates for software engineering workflows?

Yes, you can use these planning templates for software engineering workflows to organize complex tasks, outline project phases, and avoid losing context during multi-step development efforts.