106 lines
3.8 KiB
Markdown
106 lines
3.8 KiB
Markdown
# 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.
|