Skip to content

Conversation

@Parveen-Birthaliya
Copy link

Summary

Add native support for Google Antigravity workflows, enabling CodeGuard security rules to be triggered on-demand in the Antigravity IDE using /codeguard-* commands.

  • Followed Same structure as other IDEs
  • Maintain consistency with existing IDE integrations

Architecture

Following the established BaseFormat pattern used by Cursor, Windsurf, and other IDE integrations:

class AntigravityFormat(BaseFormat):
    - Output directory: `.agent/rules/`
    - File extension: `.md`
    - Frontmatter: description + tags (minimal, per Antigravity spec)

Files to Create

  1. src/formats/antigravity.py - AntigravityFormat class

Files to Modify

  1. src/formats/__init__.py - Register AntigravityFormat
  2. src/convert_to_ide_formats.py - Add to conversion pipeline
  3. README.md - Update supported IDEs list
  4. docs/getting-started.md - Updated supported IDEs list ,Add documentation link

Test

  • Unit tests for AntigravityFormat class
  • Integration tests for rule conversion
  • Manual validation in Antigravity IDE

Below is the Secreen shot from atigravity IDE that shows proper working of rules :

image

Copilot AI review requested due to automatic review settings November 29, 2025 05:24
Copilot finished reviewing on behalf of Parveen-Birthaliya November 29, 2025 05:27
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds support for Google Antigravity IDE integration by implementing a new format converter that generates .md rule files compatible with Antigravity's workflow system.

Key changes:

  • New AntigravityFormat class following the established BaseFormat pattern used by other IDE integrations
  • Integration into the conversion pipeline alongside Cursor, Windsurf, Copilot, and Claude Code formats
  • Documentation updates in README and getting-started guide to include Antigravity in the list of supported IDEs

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 10 comments.

Show a summary per file
File Description
src/formats/antigravity.py New format implementation for Antigravity IDE that generates .md files with YAML frontmatter containing description and optional tags
src/formats/init.py Registers AntigravityFormat in the formats package exports
src/convert_to_ide_formats.py Adds AntigravityFormat to the list of formats generated during rule conversion
docs/getting-started.md Adds Antigravity to the prerequisites section and installation instructions with documentation link
README.md Updates the list of supported IDE formats to include Antigravity

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +21 to +22
Workflows are stored in .agent/workflows/ and can be triggered
on-demand with /workflow-name in the Antigravity interface.
Copy link

Copilot AI Nov 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The documentation comments refer to "workflows" but the code uses "rules". According to the get_output_subpath() method (line 35), files are stored in .agent/rules/, not .agent/workflows/. The comment should be updated to say "Rules are stored in .agent/rules/ and can be triggered on-demand with /rule-name in the Antigravity interface" or similar.

Copilot uses AI. Check for mistakes.
Comment on lines +60 to +65
# Optional: Add tags for categorization (if Antigravity supports it)
if rule.tags:
yaml_lines.append("tags:")
for tag in rule.tags:
yaml_lines.append(f"- {tag}")

Copy link

Copilot AI Nov 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The comment says "tags for categorization (if Antigravity supports it)" which suggests uncertainty about the feature support. Either verify that Antigravity supports tags and remove the conditional comment, or remove the tags implementation if support is unverified. Compare with other format implementations like ClaudeCodeFormat which don't include tags.

Suggested change
# Optional: Add tags for categorization (if Antigravity supports it)
if rule.tags:
yaml_lines.append("tags:")
for tag in rule.tags:
yaml_lines.append(f"- {tag}")
# (No tags: Antigravity does not support tags in frontmatter)

Copilot uses AI. Check for mistakes.

1. **Security rules** are written in unified markdown format (`sources/` directory)
2. **Conversion tools** translate rules to IDE-specific formats (Cursor, Windsurf, Copilot, Claude Code)
2. **Conversion tools** translate rules to IDE-specific formats (Cursor, Windsurf, Copilot, Claude Code,antigravity)
Copy link

Copilot AI Nov 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing comma in the list. The list should be "Cursor, Windsurf, Copilot, Claude Code, Antigravity" with a space after the comma before "antigravity". Additionally, "antigravity" should be capitalized to match the naming of other IDEs in the list.

Suggested change
2. **Conversion tools** translate rules to IDE-specific formats (Cursor, Windsurf, Copilot, Claude Code,antigravity)
2. **Conversion tools** translate rules to IDE-specific formats (Cursor, Windsurf, Copilot, Claude Code, Antigravity)

Copilot uses AI. Check for mistakes.
Comment on lines +16 to +22
Google Antigravity format implementation (.md workflow files).
Antigravity uses .md files with YAML frontmatter containing:
- description: Rule description (required by Antigravity spec)
Workflows are stored in .agent/workflows/ and can be triggered
on-demand with /workflow-name in the Antigravity interface.
Copy link

Copilot AI Nov 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The class docstring mentions "Google Antigravity format implementation (.md workflow files)" but should say ".md rule files" to be consistent with the actual implementation. The output path is .agent/rules and other IDEs refer to these as "rules", not "workflows".

Suggested change
Google Antigravity format implementation (.md workflow files).
Antigravity uses .md files with YAML frontmatter containing:
- description: Rule description (required by Antigravity spec)
Workflows are stored in .agent/workflows/ and can be triggered
on-demand with /workflow-name in the Antigravity interface.
Google Antigravity format implementation (.md rule files).
Antigravity uses .md files with YAML frontmatter containing:
- description: Rule description (required by Antigravity spec)
Rules are stored in .agent/rules/ and can be triggered
on-demand with /rule-name in the Antigravity interface.

Copilot uses AI. Check for mistakes.
"""
Antigravity Format Implementation
Generates .md workflow files for Google Antigravity with YAML frontmatter.
Copy link

Copilot AI Nov 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The module docstring says "Generates .md workflow files for Google Antigravity" but should say "rule files" instead of "workflow files" to match the actual implementation and be consistent with other IDE format implementations.

Suggested change
Generates .md workflow files for Google Antigravity with YAML frontmatter.
Generates .md rule files for Google Antigravity with YAML frontmatter.

Copilot uses AI. Check for mistakes.
Comment on lines +53 to +64
yaml_lines = []

# Add description (required by Antigravity spec)
desc = self._format_yaml_field("description", rule.description)
if desc:
yaml_lines.append(desc)

# Optional: Add tags for categorization (if Antigravity supports it)
if rule.tags:
yaml_lines.append("tags:")
for tag in rule.tags:
yaml_lines.append(f"- {tag}")
Copy link

Copilot AI Nov 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing version field in the YAML frontmatter. All other IDE format implementations (CursorFormat, WindsurfFormat, CopilotFormat, ClaudeCodeFormat) include a version field using self.version. Consider adding yaml_lines.append(f"version: {self.version}") for consistency, unless Antigravity specifically doesn't support version metadata.

Copilot uses AI. Check for mistakes.
Antigravity uses .md files with YAML frontmatter containing:
- description: Rule description (required by Antigravity spec)
Copy link

Copilot AI Nov 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Incomplete frontmatter documentation. The docstring lists only description in the frontmatter (lines 18-20), but the implementation also includes tags (lines 60-64). Update the docstring to document all fields that may be included in the YAML frontmatter.

Suggested change
- tags: Optional list of tags for categorization (if present)

Copilot uses AI. Check for mistakes.
Comment on lines +48 to +51
Note:
Antigravity workflows use simple markdown with description-only
frontmatter. Language/glob information is not needed as workflows
are triggered manually by the user.
Copy link

Copilot AI Nov 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Inconsistent terminology: the docstring says "Antigravity workflows use simple markdown" but the actual implementation is generating "rules" (as evidenced by the output path .agent/rules). Consider changing "workflows" to "rules" throughout the documentation to match the implementation.

Copilot uses AI. Check for mistakes.

1. **Security rules** are written in unified markdown format (`sources/` directory)
2. **Conversion tools** translate rules to IDE-specific formats (Cursor, Windsurf, Copilot, Claude Code)
2. **Conversion tools** translate rules to IDE-specific formats (Cursor, Windsurf, Copilot, Claude Code,antigravity)
Copy link

Copilot AI Nov 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Inconsistent capitalization: the code uses "antigravity" (lowercase) in README.md but "AntiGravity" in docs/getting-started.md. This should be standardized across all documentation. Use consistent casing (either "Antigravity" or "AntiGravity") throughout.

Suggested change
2. **Conversion tools** translate rules to IDE-specific formats (Cursor, Windsurf, Copilot, Claude Code,antigravity)
2. **Conversion tools** translate rules to IDE-specific formats (Cursor, Windsurf, Copilot, Claude Code, AntiGravity)

Copilot uses AI. Check for mistakes.
Comment on lines +34 to +38
=== "Google AntiGravity"
Google AntiGravity uses `.agent/rules` for rule configuration.

:material-book-open-page-variant: [Google AntiGravity Instructions](https://codelabs.developers.google.com/getting-started-google-antigravity#6)

Copy link

Copilot AI Nov 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The URL https://codelabs.developers.google.com/getting-started-google-antigravity#6 appears to be a placeholder or non-existent resource. Google Antigravity is not a known/documented Google product or IDE. This appears to be either a fictional product (possibly referencing the Google "antigravity" Easter egg) or a placeholder for a future product. Please verify this is a real, publicly available product and update with the correct documentation URL.

Suggested change
=== "Google AntiGravity"
Google AntiGravity uses `.agent/rules` for rule configuration.
:material-book-open-page-variant: [Google AntiGravity Instructions](https://codelabs.developers.google.com/getting-started-google-antigravity#6)

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant