This repository provides custom instruction files (.windsurfrules, .agent) designed to optimize AI agent behavior within the Windsurf and Antigravity development environments. It offers tailored rules for coding assistance, commit message formatting, PR generation, and testing strategies, benefiting users seeking more structured and efficient AI-powered development workflows.

How It Works

The project ports and adapts cursorrules into custom instruction sets optimized for Windsurf and Antigravity. It leverages adaptive reasoning for efficient task execution, particularly for models like GPT-5.1 and Opus 4.5. A key design element is a 3-tier task classification system (lightweight, standard, critical) to apply optimal processing, alongside support for parallel execution of independent tasks to enhance throughput. Comprehensive guardrails are integrated, covering commit/PR conventions, test strategies, and prompt injection defense.

Quick Start & Requirements

To use the rules, clone the repository and copy the appropriate .windsurf (for Windsurf) or .agent (for Antigravity) directory into your project's root. Alternatively, rules can be pasted directly via the editor's settings. Specific rule files (v5-en/.windsurfrules for full control, v1-en/.windsurfrules for standard implementation) are available. Japanese and English versions are provided.

• Primary install/run command: git clone https://github.com/kinopeee/windsurf-antigravity-rules.git followed by copying relevant files.
• Prerequisites: Windsurf or Antigravity installed.
• Links:
  • Repository: https://github.com/kinopeee/windsurf-antigravity-rules
  • Documentation: en/README.md or ja/README.md within the cloned repository.

Highlighted Details

• Optimized for GPT-5.1 & Opus 4.5, leveraging adaptive reasoning.
• Features a 3-tier task classification for efficient processing.
• Supports parallel execution of independent tasks for improved speed.
• Includes comprehensive guardrails: commit/PR conventions, test strategy, prompt injection defense, and planning mode guard (Antigravity specific).
• Available in both Japanese and English.

Maintenance & Community

This repository does not offer official support, but feedback is welcomed. For AI-related updates, follow @kinopee_ai on X (Twitter).

Licensing & Compatibility

The project is released under the MIT License, which is permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

The project provides no official support. The "Planning Mode Guard" feature is specific to Antigravity. Users should consult the detailed documentation for specific rule file configurations and usage.