docs/antigravity.md
Using planning-with-files with Google Antigravity.
Antigravity auto-discovers skills from .agent/skills/ directories. Two installation methods:
Share the skill with your entire team by adding it to your repository:
# In your project repository
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files
# Copy the Antigravity skill to your repo
cp -r /tmp/planning-with-files/.agent .
# Commit to share with team
git add .agent/
git commit -m "Add planning-with-files skill for Antigravity"
git push
# Clean up
rm -rf /tmp/planning-with-files
Now everyone on your team using Antigravity will have access to the skill!
Install just for yourself:
# Clone the repo
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files
# Copy to your personal Antigravity skills folder
mkdir -p ~/.gemini/antigravity/skills
cp -r /tmp/planning-with-files/.agent/skills/planning-with-files ~/.gemini/antigravity/skills/
# Clean up
rm -rf /tmp/planning-with-files
Restart your Antigravity session, then the skill will auto-activate when you work on complex tasks.
No slash command needed - Antigravity automatically invokes skills based on your task description!
Antigravity scans your task and automatically activates the skill when you:
Increase auto-activation likelihood by using these phrases:
I need to build a REST API with authentication,
database integration, and comprehensive testing.
This is a complex multi-step project that will
require careful planning.
Antigravity will automatically invoke planning-with-files and create the three planning files.
Once activated, the skill creates:
| File | Purpose | Location |
|---|---|---|
task_plan.md | Phases, progress, decisions | Your project root |
findings.md | Research, discoveries | Your project root |
progress.md | Session log, test results | Your project root |
The skill includes starter templates in .agent/skills/planning-with-files/references/:
task_plan.md — Phase tracking templatefindings.md — Research storage templateprogress.md — Session logging templateDescribe your task with complexity indicators:
I'm building a user authentication system.
This is a multi-phase project requiring database
setup, API endpoints, testing, and documentation.
Antigravity invokes planning-with-files and creates the planning files.
The AI will:
task_plan.md with phasesfindings.mdprogress.mdAll important information gets written to disk, not lost in context window.
When errors occur, the AI:
After every 2 search/view operations, findings are saved to findings.md.
Prevents losing visual/multimodal information.
Before major decisions, the AI re-reads planning files to refresh goals.
Prevents goal drift in long sessions.
With workspace installation (.agent/skills/):
With personal installation (~/.gemini/antigravity/skills/):
This pattern is why Manus AI (acquired by Meta for $2 billion) succeeded:
"Markdown is my 'working memory' on disk. Since I process information iteratively and my active context has limits, Markdown files serve as scratch pads for notes, checkpoints for progress, building blocks for final deliverables." — Manus AI
Key insight: Context window = RAM (volatile). Filesystem = Disk (persistent).
Write important information to disk, not context.
Check:
Templates are in:
.agent/skills/planning-with-files/references/~/.gemini/antigravity/skills/planning-with-files/references/Copy them to your project root and customize.
Edit .agent/skills/planning-with-files/SKILL.md to customize:
Place custom templates in:
.agent/skills/planning-with-files/references/
Antigravity will reference them automatically.
This skill follows the Agent Skills Specification, an open standard for AI coding assistants.
The same skill format works across: