
Planning With Files
This is a file-based planning system that creates three tracking files (task_plan.md, findings.md, progress.md) to help Claude manage complex work that'll take more than a handful of tool calls. It includes tamper detection using SHA256 hashes to prevent prompt injection attacks through plan files, which is a real concern when Claude is reading structured data that might contain instruction-like text. The hooks inject plan context before each prompt and remind Claude to update progress after file edits. It supports multiple concurrent plans in a .planning directory and can recover your session state after /clear. If you're doing research, breaking down a big refactor, or managing any multi-step project where you want persistent structure across a conversation, this gives you that scaffolding without reinventing it each time.
- skills.sh installs
- 143
- GitHub stars
- 848
- last updated
- Jun 3, 2026
Install
$ npx -y skills add guanyang/antigravity-skills --skill planning-with-files --agent claude-codeInstalls into .claude/skills of the current project.
Files
Planning with Files
Work like Manus: Use persistent markdown files as your "working memory on disk."
FIRST: Restore Project State
Before continuing, resolve the plan this task owns:
- Use the installed
scripts/resolve-plan-dir.sh(or.ps1) with the task'sPLAN_IDandPWF_PLAN_ROOT. Readtask_plan.md,progress.md, andfindings.mdfrom that one selected directory. A roottask_plan.mdmust not override a selected.planning/<id>/plan. - If an explicit selector is rejected, or multiple named plans exist without
PLAN_ID, stop plan recovery and correct the pin. Do not fall back to another task. Use the legacy project-root files only when no selector or named plan applies. - Run
git diff --statto see code changes that may not yet be recorded in the planning files.
All planning filenames below refer to this selected directory, even when the shell runs elsewhere. For parallel tasks, pin each host before starting it or use separate worktrees. A worker joining an existing task uses its assigned plan; it must not create or overwrite a competing root plan.
Sponsors
Details
- Repository
- github.com/guanyang/antigravity-skills
- Category
- Productivity & Planning
- First seen
- Jun 3, 2026