Antigravity Clean Workspace

Use a clean workspace for Antigravity. Do not open the full multi-platform repository unless you are debugging adapters.

The full repository contains Codex, OpenCode, Claude Code, Gemini CLI, archived projects, and platform adapter source templates. Gemini models may read irrelevant files and follow stale or incompatible instructions. The clean workspace exposes only the Antigravity instruction stack plus optional Python utilities.

Recommended Update Flow

From the full repository:

python scripts/update_platform_envs.py --platform antigravity

This command first runs git pull --ff-only, then rebuilds platform_envs/antigravity. Open platform_envs/antigravity in Antigravity.

If you already pulled the repo yourself:

python scripts/update_platform_envs.py --platform antigravity --skip-pull

Required Directory Logic

Antigravity source templates live in platform_adapters/antigravity/agent/. The generated Antigravity workspace receives them under .agent/:

.agent/agents.md defines roles only.
.agent/rules/*.md defines persistent workspace constraints.
.agent/skills/*/SKILL.md defines reusable procedures.
.agent/workflows/*.md defines slash-style workflows.

Other platforms are built into their own generated environments under platform_envs/. They are not part of Antigravity native execution.

Sparse Checkout From Gitea

Use this when preparing an Antigravity-only checkout:

git clone --filter=blob:none --no-checkout http://192.168.50.45:3000/kai/deep_research.git deep_research_antigravity
cd deep_research_antigravity
git sparse-checkout init --no-cone
git sparse-checkout set \
  AGENTS.md \
  GEMINI.md \
  README.md \
  docs/antigravity-clean-workspace.md \
  docs/platform-adapters.md \
  configs \
  platform_adapters/antigravity \
  scripts/dr.py \
  scripts/runtime \
  scripts/reporting \
  scripts/deploy_adapters.py \
  scripts/update_platform_envs.py \
  scripts/export_antigravity_workspace.py \
  projects/.gitkeep
git checkout codex/v0.20-skill-driven-python-core
python scripts/update_platform_envs.py --platform antigravity --skip-pull

This checkout intentionally excludes Codex/OpenCode/Claude/Gemini adapter templates, archive, historical projects/**, and generated platform_envs/**.

Export From A Full Checkout

If you already have a full checkout, export a clean Antigravity workspace:

python scripts/export_antigravity_workspace.py --target /path/to/deep_research_antigravity --force

Open /path/to/deep_research_antigravity in Antigravity, not the full repository.

Startup Prompt

Paste this as the first message in Antigravity:

You are running Antigravity native Deep Research.

First, read only these files:
1. AGENTS.md
2. GEMINI.md
3. .agent/agents.md
4. .agent/rules/deep-research-antigravity.md
5. .agent/skills/antigravity-surface-adapter/SKILL.md
6. .agent/skills/method-selection/SKILL.md
7. .agent/skills/research-quality-gates/SKILL.md
8. .agent/workflows/deep-research-native.md

This is a generated clean workspace. Do not inspect parent repository adapter templates unless I explicitly ask.

Use Gemini 3 Flash only as Surface Manager. Do not write report content or invent completed searches. Ask me to switch models at the workflow gates.

Research topic: <topic>
Slug: <slug>
Report purpose: <purpose>
Target reader: <reader>
Decision supported by the report: <decision>

Start with Step 1 of .agent/workflows/deep-research-native.md. Stop after Phase 1 artifacts are created and ask for approval.

Failure Stop Rule

If the model claims it searched, cleared old files, wrote a chapter, ran a pipeline, or verified evidence without producing the corresponding artifact paths and receipts, stop the run. Restart with the startup prompt above and require it to show the loaded file list first.

3.8 KiB Raw Blame History