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 legacy adapter files. Gemini models may read those files and follow stale or incompatible instructions. The clean workspace exposes only the Antigravity instruction stack plus optional Python utilities.

Required Directory Logic

Antigravity workspace files live 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.

Legacy or other-platform directories are not part of Antigravity native execution:

.agents/ is legacy compatibility for this repository's older adapter layout.
.codex/, .opencode/, .claude/, and .gemini/ are for other tools.
Antigravity native runs must ignore those directories unless the user explicitly asks to inspect them.

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 \
  .agent \
  docs/antigravity-clean-workspace.md \
  docs/platform-adapters.md \
  configs \
  scripts/dr.py \
  scripts/runtime \
  scripts/reporting \
  scripts/deploy_adapters.py \
  projects/.gitkeep
git checkout codex/v0.20-skill-driven-python-core

This checkout intentionally excludes .codex, .opencode, .claude, .gemini, .agents, archive, historical projects/**, and bundled platform templates.

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

Ignore .codex, .opencode, .claude, .gemini, and .agents if present.

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.3 KiB Raw Blame History