Antigravity Coding Standards Guide

Overview

This document outlines the core set of rules and best practices intended to guide development within a project, acting as a foundational standard for code quality, repository management, and collaboration. It emphasizes pragmatic development over over-engineering.

Capabilities

• Code Structure Enforcement: Dictates guidelines for function length (<50 lines), cyclomatic complexity (<10), and line width (<100 characters).
• Workflow Management: Mandates a Trunk-Based Development approach, requiring specific branch naming conventions (feature/, fix/, etc.) and Conventional Commits.
• Quality Assurance: Sets high standards for testing coverage (>80%) focusing on business logic and edge cases.
• Security First: Stresses the importance of input validation, output sanitization, and never committing secrets.
• Documentation Governance: Defines where documentation should live (e.g., CHANGELOG, PR descriptions) to keep the root directory clean.

Example Use Cases

• Code Review Guideline: A developer can use these rules during a code review to ensure adherence to complexity limits and type safety (avoiding any).
• Onboarding New Team Members: This serves as an immediate, comprehensive checklist for new contributors joining the project.
• Project Refactoring Checklist: Before starting a major refactor, one can use these rules to ensure that the resulting code base meets all established quality gates.