fix: resolve 11 antigravity implementation gaps found in audit

- generate.py: add workflow/extra-dir paths to _HARNESS_TARGETS and
  prune_orphans for complete --clean and orphan pruning
- antigravity.py: symmetric extra-writes (skills go to both .agent/skills/
  and .agents/skills/, matching workflow pattern)
- install_antigravity.py: add workflows to ARTIFACT_GLOBS
- validate_generated.py: add agent description non-empty check, add
  workflow frontmatter/body validation
- doc_gardener.py: add stale detection for .antigravity/workflows/ and
  all extra-write paths (.agent/workflows/, .agents/workflows/,
  .agents/skills/)
- capabilities.py: update notes to mention workflow emission
- docs/harnesses.md: fix agent separator (- -> __), add workflow output
  path, add install-antigravity/uninstall-antigravity to sections
- docs/round-trip-results.md: fix incorrect commands/ path,
  fix install description

Author: web-flow

docs/harnesses.md

@@ -15,7 +15,7 @@ as Claude Code markdown. Per-harness artifacts are generated by adapters under `
 | **Cursor** (2.5+) | supported | `.cursor-plugin/`, `.cursor/rules/` (curated) |
 | **OpenCode** (`sst/opencode`) | supported | `.opencode/agents/`, `.opencode/commands/`, `.opencode/skills/`, `opencode.json` |
 | **Gemini CLI** | supported | `skills/`, `agents/`, `commands/` (at extension root) |
-| **Antigravity CLI** | supported | `.antigravity/agents/`, `.antigravity/skills/` |
+| **Antigravity CLI** | supported | `.antigravity/agents/`, `.antigravity/skills/`, `.antigravity/workflows/` |
 
 ## Capability matrix
 
@@ -49,7 +49,7 @@ rules to write portable content.
 | `model: opus` (agent) | mapped to `gpt-5` | rewritten to `inherit` | rewritten to `anthropic/claude-opus-4-7` | mapped to `gemini-2.5-pro` | mapped to `gemini-2.5-pro` |
 | `TodoWrite` in body | no equivalent — leave as-is | no equivalent — leave as-is | works as-is | no equivalent | no equivalent |
 | Skill body > 8 KB | split into `references/details.md` | passed through | passed through | passed through | passed through |
-| Agent named `worker` | namespaced to `<plugin>__worker` | passed through | passed through | passed through | namespaced to `<plugin>-<agent>` |
+| Agent named `worker` | namespaced to `<plugin>__worker` | passed through | passed through | passed through | namespaced to `<plugin>__<agent>` |
 | Slash command (`commands/<x>.md`) | converted to skill | passed through | rewritten to `.opencode/commands/` | TOML at `commands/<plugin>/<x>.toml` | converted to skill |
 
 ## Output paths (all gitignored)
@@ -62,7 +62,7 @@ GEMINI.md, AGENTS.md*             # context files (committed/generated)
 .cursor-plugin/, .cursor/rules/   # generated by Cursor adapter
 .opencode/agents/, .opencode/commands/, .opencode/skills/, opencode.json   # generated by OpenCode adapter
 skills/, agents/, commands/       # generated by Gemini adapter (at extension root)
-.antigravity/agents/, .antigravity/skills/ # generated by Antigravity adapter
+.antigravity/agents/, .antigravity/skills/, .antigravity/workflows/ # generated by Antigravity adapter
 ```
 
 ## Regenerating
@@ -76,9 +76,11 @@ make generate HARNESS=antigravity
 # Or all at once:
 make generate-all
 
-# Optional global OpenCode install:
+# Optional global install:
 make install-opencode
+make install-antigravity
 make uninstall-opencode
+make uninstall-antigravity
 ```
 
 ## External Pensyve integrations
@@ -97,17 +99,21 @@ For generated harnesses, use Pensyve's upstream harness-native integration:
 
 ## Global install
 
-OpenCode and Copilot support installing generated artifacts globally for user-level discovery:
+OpenCode, Copilot, and Antigravity CLI support installing generated artifacts globally for user-level discovery:
 
 ```bash
-make install-opencode    # symlink .opencode/ → ~/.config/opencode/
+make install-opencode        # symlink .opencode/ → ~/.config/opencode/
 make uninstall-opencode
 
-make install-copilot     # symlink .copilot/ → ~/.copilot/
+make install-copilot         # symlink .copilot/ → ~/.copilot/
 make uninstall-copilot
 
+make install-antigravity     # symlink .antigravity/ → ~/.gemini/antigravity-cli/
+make uninstall-antigravity
+
 # Force-replace conflicting symlinks:
 make install-copilot FORCE=1
+make install-antigravity FORCE=1
 ```
 
 > Copilot discovers agents from `.copilot/agents/` and skills from `.copilot/skills/` at the repo level, and from `~/.copilot/agents/` and `~/.copilot/skills/` at the user level. The adapter emits to `.copilot/`; use `make install-copilot` for user-level discovery.

docs/round-trip-results.md

@@ -111,12 +111,12 @@ make generate HARNESS=antigravity
 make validate
 
 # Verify artifact tree
-ls .antigravity/agents/   # 191 agent.json profiles
-ls .antigravity/skills/   # 155 skill dirs (each with SKILL.md)
-ls .antigravity/commands/ # 25 command SKILL.md files
+ls .antigravity/agents/    # 191 agent.json profiles
+ls .antigravity/skills/    # 155 skill dirs (each with SKILL.md) + command-derived skills
+ls .antigravity/workflows/ # 25 workflow .md files (command-as-workflow)
 
 # Global install (optional)
-make install-antigravity   # symlinks .antigravity/ -> ~/.antigravity/
+make install-antigravity   # symlinks artifacts to ~/.gemini/antigravity-cli/
 ```
 
 Antigravity CLI currently lacks a CLI verification tool. Manual testing requires

tools/adapters/antigravity.py

@@ -153,10 +153,11 @@ def _emit_command_as_skill(self, plugin: PluginSource, command: CommandSource, r
         content = _antigravity_frontmatter(fm) + "\n\n" + body
         result.written.append(self.write(skill_dir / "SKILL.md", content))
 
-        # Also write to workspace-level .agents/skills/ for IDE/2.0 discovery
-        # (mirrors the workflow approach which writes to both .antigravity/ and .agent/.agents/)
-        agents_skill_dir = Path(".agents") / "skills" / skill_id
-        result.written.append(self.write(agents_skill_dir / "SKILL.md", content))
+        # Also write to workspace-level .agent/skills/ and .agents/skills/ for IDE/2.0 discovery
+        # (mirrors the workflow approach which writes to both .agent/ and .agents/)
+        for skill_parent in (Path(".agent"), Path(".agents")):
+            extra_skill_dir = skill_parent / "skills" / skill_id
+            result.written.append(self.write(extra_skill_dir / "SKILL.md", content))
 
     def _emit_command_as_workflow(self, plugin: PluginSource, command: CommandSource, result: EmitResult) -> None:
         """Emit one command as an Antigravity workflow (``.md``) for IDE/2.0 slash command support."""

tools/adapters/capabilities.py

@@ -187,7 +187,7 @@ class Capability:
         skill_body_max_bytes=_NO_CAP,
         tool_name_case="lowercase",
         bare_model_aliases=False,
-        notes="Emits agent.json to .antigravity/agents/<name>/ and SKILL.md to .antigravity/skills/<name>/.",
+        notes="Emits agent.json to .antigravity/agents/<name>/, SKILL.md to .antigravity/skills/<name>/, and workflow .md to .antigravity/workflows/ (plus extra-writes to .agent/ and .agents/ for IDE/2.0 discovery).",
     ),
 }
 

tools/doc_gardener.py

@@ -268,6 +268,36 @@ def check_stale_artifacts(report: Report) -> None:
                             pairs.append((src, skill_md))
                             break
 
+    antigravity_workflows = antigravity_root / "workflows"
+    if antigravity_workflows.is_dir():
+        for workflow_md in antigravity_workflows.glob("*.md"):
+            name = workflow_md.stem
+            for plugin_name in list_plugins():
+                if name.startswith(f"{plugin_name}-"):
+                    cmd_name = name[len(plugin_name) + 1 :]
+                    src = PLUGINS_DIR / plugin_name / "commands" / f"{cmd_name}.md"
+                    if src.is_file():
+                        pairs.append((src, workflow_md))
+                    break
+
+    # Stale detection for extra-write paths (.agent/workflows/, .agents/workflows/, .agents/skills/)
+    for extra_root in (WORKTREE / ".agent", WORKTREE / ".agents"):
+        for sub in ("workflows", "skills"):
+            extra_dir = extra_root / sub
+            if not extra_dir.is_dir():
+                continue
+            for f in extra_dir.rglob("*"):
+                if not f.is_file():
+                    continue
+                name = f.stem if sub == "workflows" else f.parent.name
+                for plugin_name in list_plugins():
+                    if name.startswith(f"{plugin_name}-"):
+                        cmd_name = name[len(plugin_name) + 1 :]
+                        src = PLUGINS_DIR / plugin_name / "commands" / f"{cmd_name}.md"
+                        if src.is_file():
+                            pairs.append((src, f))
+                        break
+
     for src, gen in pairs:
         if src.stat().st_mtime > gen.stat().st_mtime + 1:  # 1s grace
             # Derive the plugin name correctly regardless of source layout.

tools/generate.py

@@ -34,7 +34,7 @@
     "cursor": [".cursor", ".cursor-plugin"],
     "opencode": [".opencode", "opencode.json"],
     "gemini": ["commands", "agents", "skills"],
-    "antigravity": [".antigravity/agents", ".antigravity/skills"],
+    "antigravity": [".antigravity/agents", ".antigravity/skills", ".antigravity/workflows", ".agent/workflows", ".agents/workflows", ".agents/skills"],
     "copilot": [".copilot/agents", ".copilot/skills", ".copilot/commands"],
 }
 
@@ -166,10 +166,15 @@ def prune_orphans(harness_id: str, output_root: Path, written: set[Path]) -> lis
             if d.is_dir():
                 candidates.extend(p for p in d.rglob("*") if p.is_file())
     elif harness_id == "antigravity":
-        for sub in ("agents", "skills"):
+        for sub in ("agents", "skills", "workflows"):
             d = output_root / ".antigravity" / sub
             if d.is_dir():
                 candidates.extend(p for p in d.rglob("*") if p.is_file())
+        for extra in (".agent", ".agents"):
+            for sub in ("workflows", "skills"):
+                d = output_root / extra / sub
+                if d.is_dir():
+                    candidates.extend(p for p in d.rglob("*") if p.is_file())
     elif harness_id == "copilot":
         for sub in ("agents", "skills"):
             d = output_root / ".copilot" / sub

tools/install_antigravity.py

@@ -13,6 +13,7 @@
 ARTIFACT_GLOBS = {
     "agents": "*",
     "skills": "*",
+    "workflows": "*.md",
 }
 
 
@@ -54,6 +55,8 @@ def _generated_artifacts(repo_root: Path) -> list[tuple[str, Path]]:
         for src in sorted(source_dir.glob(pattern)):
             if subdir in {"agents", "skills"} and not src.is_dir():
                 continue
+            if subdir == "workflows" and not src.is_file():
+                continue
             artifacts.append((subdir, src.resolve()))
     if not artifacts:
         raise FileNotFoundError(

tools/validate_generated.py

@@ -729,6 +729,16 @@ def validate_antigravity(report: Report) -> None:
                         remediation=f"Add a `{key}` field to the custom agent config.",
                     )
 
+            desc = data.get("description")
+            if desc is not None and (not isinstance(desc, str) or not desc.strip()):
+                report.add(
+                    severity="error",
+                    harness="antigravity",
+                    path=agent_json_path,
+                    message="`description` must be a non-empty string",
+                    remediation="Set a non-empty description in agent.json.",
+                )
+
             if "name" in data and data["name"] != agent_json_path.parent.name:
                 report.add(
                     severity="error",
@@ -788,6 +798,38 @@ def validate_antigravity(report: Report) -> None:
                     remediation="Antigravity uses Gemini models (e.g. 'gemini-2.5-pro').",
                 )
 
+    workflows_dir = WORKTREE / ".antigravity" / "workflows"
+    if workflows_dir.is_dir():
+        for workflow_md in workflows_dir.glob("*.md"):
+            content = workflow_md.read_text(encoding="utf-8")
+            fm, body = parse_frontmatter(content)
+            if not fm:
+                report.add(
+                    severity="error",
+                    harness="antigravity",
+                    path=workflow_md,
+                    message="missing or invalid frontmatter",
+                    remediation="Regenerate via `make generate HARNESS=antigravity`.",
+                )
+                continue
+            description = fm.get("description")
+            if not isinstance(description, str) or not description.strip():
+                report.add(
+                    severity="error",
+                    harness="antigravity",
+                    path=workflow_md,
+                    message="missing required `description` field in frontmatter",
+                    remediation="Antigravity workflow files need a non-empty description.",
+                )
+            if not body.strip():
+                report.add(
+                    severity="warning",
+                    harness="antigravity",
+                    path=workflow_md,
+                    message="workflow body is empty",
+                    remediation="Keep the prompt body in the source command markdown.",
+                )
+
 _VALIDATORS = {
     "antigravity": validate_antigravity,
     "codex": validate_codex,