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

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```text
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.
