One-click install
npx skills add https://github.com/XWIlluDelu/agent-share --skill planning-with-files-xwilludelu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/XWIlluDelu/agent-share/tree/main/lib/planning-with-files
Command: npx skills add https://github.com/XWIlluDelu/agent-share --skill planning-with-files-xwilludelu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

It prevents lost context and aimless execution on multi-step work by forcing the agent to keep goals, decisions, findings, and progress in persistent on-disk markdown files.

Core Features & Use Cases

  • Isolated file-based planning: Creates isolated plan directories under .planning/<plan-id>/ with task_plan.md, findings.md, and progress.md for separate concurrent workflows.
  • Context recovery after /clear: Detects prior-session unsynced context and prompts you to reconcile it with git diff and the planning files.
  • Safety against prompt injection via plan content: Supports optional SHA-256 attestation; when enabled, plan content tampering blocks plan injection and warns you.
  • Operational guardrails for tool use: Uses hooks to read the active plan before decisions and to treat plan contents as structured data (not instructions).

Quick Start

Tell the agent to initialize a plan, then proceed with a multi-step request by writing and updating task_plan.md, findings.md, and progress.md as work progresses.

Frequently Asked Questions about planning-with-files

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

FAQPage Schema
How do I preserve context for complex AI tasks across multiple sessions?▼

To preserve context for complex AI tasks, you can organize multi-step work into persistent markdown files like task_plan.md, findings.md, and progress.md. This file-based memory approach prevents lost context and aimless execution by keeping goals, decisions, and findings on disk.

What's the best way to recover context after clearing an AI chat session?▼

The best way to recover context after a session clear is using context management hooks that detect prior-session unsynced changes. The system prompts you to reconcile previous findings with git diff and existing planning files to restore your working state.

How do I manage concurrent multi-step research workflows without losing track of progress?▼

You can manage concurrent research workflows by creating isolated file-based planning directories under .planning/<plan-id>/. This ensures separate concurrent workflows maintain their own task plans, findings, and progress logs without cross-contamination.

How can I defend against prompt injection from external content used in AI planning?▼

You can defend against prompt injection by enabling optional SHA-256 plan attestation. This treats plan contents as structured data rather than instructions, blocking plan injection and warning you if content tampering is detected.

Does file-based task tracking work for iterative feature development?▼

Yes, file-based task tracking is designed specifically for iterative feature development and long-running execution workflows. It uses operational guardrails to read the active plan before decisions and enforces updates to progress files as work advances.