planning-with-files

Anchor goals in goal.md and persist findings in findings.md across sessions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/huanlongAI/tzh-Harness --skill planning-with-files-huanlongai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/huanlongAI/tzh-Harness/tree/main/cowork-skills/planning-with-files
Command: npx skills add https://github.com/huanlongAI/tzh-Harness --skill planning-with-files-huanlongai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Long-running AI tasks often lose context as multiple tools and sessions are used. This skill anchors the objective in a lightweight goal.md and stores persistent findings in findings.md to prevent drift and preserve important reasoning.

Core Features & Use Cases

  • Goal anchoring: Injects the current objective into the attention window before tool usage, ensuring continuity across steps.
  • External memory: Persists research findings and decision rationale in findings.md for cross-session reference.
  • 2-Action rule: Enforces updates after two relevant actions to avoid memory gaps, especially after browsing or viewing multimodal content.
  • Pre-tool refresh: Uses PreToolUse hooks to refresh the target before each operation.
  • TodoWrite collaboration: Works with the platform's TodoWrite to separate progress tracking from memory.
  • Use case: For multi-step projects that span days, such as planning a complex feature and recording decisions.

Quick Start

Create a goal.md with a concise objective and constraints in your project, then add findings.md to persist research and let the hook inject the goal before each tool use.

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 long-running AI workflows across multiple sessions?

To maintain task context for long-running AI workflows, you anchor the objective in a goal.md file and store persistent findings in findings.md to prevent context drift across sessions.

How does pre-tool refresh hook external memory into AI task planning?

Pre-tool refresh uses PreToolUse hooks to inject the current objective from goal.md into the attention window before each tool invocation, ensuring continuity across multi-step planning workflows.

What is the 2-action rule for persisting research findings in task management?

The 2-action rule for persisting research findings enforces updates to findings.md after two relevant actions, preventing memory gaps especially after browsing or viewing multimodal content.

Can I use TodoWrite with goal.md for progress tracking and external memory?

Yes, you can use TodoWrite with goal.md for progress tracking, as this approach separates progress tracking from external memory, allowing findings.md to store decision rationale independently.

When do I need external memory files for multi-step project planning?

You need external memory files for multi-step project planning when tasks span multiple days and require preserving important reasoning and research findings across tool invocations and sessions.