guanyang avatar

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-code

Installs 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:

  1. Use the installed scripts/resolve-plan-dir.sh (or .ps1) with the task's PLAN_ID and PWF_PLAN_ROOT. Read task_plan.md, progress.md, and findings.md from that one selected directory. A root task_plan.md must not override a selected .planning/<id>/ plan.
  2. 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.
  3. Run git diff --stat to 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

More from guanyang/antigravity-skills

All 8
1openai avatarcreate-planopenai/skillsCreate a concise plan. Use when a user explicitly asks for a plan related to a coding task.118skills.sh installs
2breaking-brake avatarjira-driven-planningbreaking-brake/cc-wf-studioJiraチケットの要件とConfluenceの関連ドキュメントを基に、Frontend/Backend/Infrastructureに分割した実装計画を策定するプランニングスキル。Jiraチケット情報とConfluence検索結果が前段で取得済みであることを前提とし、構造化された実装計画を出力する。「プランニング」「実0skills.sh installs
3hoangnguyen0403 avatarbrainstorm-featurehoangnguyen0403/agent-skills-standardClarify a rough product or engineering idea into a BRD-lite brief (Why) with measurable business value.0skills.sh installs
4openraiser avatarnanoresearch-planningopenraiser/nanoresearchProduce an experiment blueprint from a research hypothesis0skills.sh installs
5TencentCloudBase avatarplanning-workflowsTencentCloudBase/CloudBase-AI-ToolkitSpec and no-spec planning workflows derived from local slash commands (requirements, design, tasks).0skills.sh installs
6lllllllama avatarrepo-intake-and-planlllllllama/rigorpilot-skillsRigor Intake helper for README-first deep learning repo reproduction. Use when the task is specifically to scan a repository, read the README and common project492.5Kskills.sh installs