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.