v0.20.5 add antigravity clean workspace

2026-05-07 20:47:33 +08:00
parent a0f1144f6c
commit bb2c91754b
27 changed files with 3501 additions and 67 deletions
@@ -0,0 +1,90 @@
+# 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:
+
+```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 \
+  .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:
+
+```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
+
+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.