planning-with-files

Persist task plans, findings, and progress in markdown files.

Updated Aug 30, 2024
One-click install
npx skills add https://github.com/jfrometa/esquizo --skill planning-with-files-jfrometa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/jfrometa/esquizo/tree/main/.agent/skills/planning-with-files
Command: npx skills add https://github.com/jfrometa/esquizo --skill planning-with-files-jfrometa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables planning complex, multi-step tasks by using on-disk memory to persist planning data such as task plans, findings, and progress.

Core Features & Use Cases

  • Three-file planning pattern: creates and maintains task_plan.md, findings.md, and progress.md to structure work.
  • Task-oriented workflows: ideal for research projects, long-running analyses, and tasks requiring many tool calls.
  • Templates & references: provides starting templates and references to guide planning discipline.

Quick Start

  • Before starting a complex task, create the three files in your workspace: task_plan.md, findings.md, progress.md.
  • Review the references/ templates for initial structure and guidance.
  • Begin the task by updating the plan and logging progress as you proceed.

Frequently Asked Questions about planning-with-files

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

FAQPage Schema
How do I plan complex tasks that require many tool calls and phases?

To plan complex tasks, use an on-disk memory approach that persists planning data in structured artifacts like task_plan.md, findings.md, and progress.md, providing a disciplined workflow with templates to track phases and log errors.

What is on-disk memory for project management and how does it work?

On-disk memory for project management persists planning data by maintaining structured files such as task_plan.md, findings.md, and progress.md, updating them to log progress, track errors, and structure work across phases.

How do I set up task planning templates for long-running research projects?

Set up task planning templates by creating task_plan.md, findings.md, and progress.md in your workspace. Review the provided references for initial structure and guidance, then begin logging progress as you proceed.

Does this three-file planning pattern work for multi-step research workflows?

Yes, the three-file planning pattern is ideal for multi-step research workflows, maintaining task plans, logging findings, and tracking progress on disk to satisfy disciplined task management across many phases and tool calls.

What's the best way to maintain context engineering discipline in complex projects?

The best way to maintain context engineering discipline is using on-disk memory with a defined file structure, emphasizing learning through logging and error tracking in dedicated progress and findings files throughout the project lifecycle.

Why does my multi-phase project lose track of findings and progress without on-disk memory?

Multi-phase projects lose track of findings without on-disk memory because planning data is not persisted across tool calls; maintaining structured artifacts like progress.md and findings.md ensures data persists and errors are tracked.