Description
The antigravity engine is fully supported at runtime (listed in pkg/workflow/engine_definition.go:18,285 and used in .github/workflows/smoke-antigravity.md:37) but is missing from two key surfaces: the user-facing engine reference docs and the JSON schema's engine ID examples. This creates a confusing gap where users can successfully use an engine that the docs imply doesn't exist.
Suggested Changes
- Engine reference docs — Add
antigravity to the available engine table and descriptions in docs/src/content/docs/reference/engines.md
- JSON schema — Add
antigravity to built-in engine ID examples/descriptions in pkg/parser/schemas/main_workflow_schema.json wherever codex, claude, copilot, gemini, opencode, pi are listed
- Frontmatter reference — Add an
engine.extensions section to docs/src/content/docs/reference/frontmatter.md (field exists in schema at line 12517 and runtime at pkg/workflow/pi_engine.go:211,240 but is absent from the top-level frontmatter overview)
Files Affected
docs/src/content/docs/reference/engines.mdpkg/parser/schemas/main_workflow_schema.jsondocs/src/content/docs/reference/frontmatter.md
Success Criteria
Source
Extracted from [Schema Consistency] Schema Consistency Check - 2026-07-22
Priority
Medium — users can currently use an undocumented engine; fixing closes a trust gap in the docs.
🔍 Task mining by Discussion Task Miner - Code Quality Improvement Agent · sonnet46 49.7 AIC · ⌖ 5.61 AIC · ⊞ 7.1K · ◷
Description
The
antigravityengine is fully supported at runtime (listed inpkg/workflow/engine_definition.go:18,285and used in.github/workflows/smoke-antigravity.md:37) but is missing from two key surfaces: the user-facing engine reference docs and the JSON schema's engine ID examples. This creates a confusing gap where users can successfully use an engine that the docs imply doesn't exist.Suggested Changes
antigravityto the available engine table and descriptions indocs/src/content/docs/reference/engines.mdantigravityto built-in engine ID examples/descriptions inpkg/parser/schemas/main_workflow_schema.jsonwherevercodex,claude,copilot,gemini,opencode,piare listedengine.extensionssection todocs/src/content/docs/reference/frontmatter.md(field exists in schema at line 12517 and runtime atpkg/workflow/pi_engine.go:211,240but is absent from the top-level frontmatter overview)Files Affected
docs/src/content/docs/reference/engines.mdpkg/parser/schemas/main_workflow_schema.jsondocs/src/content/docs/reference/frontmatter.mdSuccess Criteria
antigravityappears in the engine reference table inengines.mdantigravityappears in schema built-in engine examples alongside the other built-insengine.extensionssection added tofrontmatter.mdwith link to Pi engine detailsmake recompilepasses (if any lock files affected)Source
Extracted from [Schema Consistency] Schema Consistency Check - 2026-07-22
Priority
Medium — users can currently use an undocumented engine; fixing closes a trust gap in the docs.