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.