All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog.
- CI/CD Reliability: Fixed critical
.gitignorecollision excluding thesrc/directory. - Test Matrix: Added
PyYAMLto exact test dependency matrix to fix missing modules on GitHub Runners. - Coverage Artifacts: Fixed
pytest-covreporting missing SQLite.coveragefiles by generating and uploading standardcoverage.xml.
- Protocol v3.0.0: Upgraded agent manifest structure with lifecycle awareness.
- Declarative Governance: Added
.agent/tools.jsonfor explicit agent tool control. - Semantic Mapping: Added
AGENT_MAP.yamlfor pre-computed repository summaries. - Autonomic Compaction: Implemented state-reduction protocols in self-learning rules.
- Atomic Documentation: Standardized machine-readable header IDs across all templates.
- Neural Bridge: Enhanced global knowledge discovery via
KNOWLEDGE_LAKE_DIR.
- Conditional Rules: Rules are now stack-aware and load dynamically.
- Skill Chaining: Automated dependency resolution for executable agent skills.
- Personality Packs: Added
startupandenterprisedevelopment personas. - Health Badges: Added automated SVG project health badge generation.
- Project Lockdown: Achieved 100% test coverage and lint compliance.
- Community Blueprint Marketplace: Expanded
--blueprintsupport.- New Built-ins: Added
nextjs,fastapi,go-fiber, andrust-axumproject templates. - Remote Fetching: Added support for git URLs (e.g.,
--blueprint https://github.com/user/repo). - Discovery: Added
--list-blueprintsflag to show available templates.
- New Built-ins: Added
- CLI Presets: Added
--save-presetand--presetto save/load project configurations.
- Architectural Overhaul: Refactored 2,200+ line monolith into a modular Python package (
src/antigravity_architect/). - New CLI Tool: The project is now an installable tool (
pip install -e .) with theantigravity-architectglobal command. - Refactoring: significantly reduced cognitive complexity in
generate_projectby extracting logic intocore.builder. - Roadmap: Updated roadmap to reflect completed milestones.
- Coverage: Increased to 91% (806/883 lines).
- Refactoring: Renamed and organized test files.
- Robustness: Validated 106 tests (100% passing).
- Markdown Linting: Fixed formatting issues in documentation files.
- Code Duplication: Resolved repeated string literals across the new package structure.
- None
- Dogfooding: The Antigravity Architect project itself now follows the Standardized Agent Protocol (v2.0.0).
- Manifest: Real
.agent/manifest.jsonadded to the repository. - Protocol Headers: All
.agent/rules/updated with machine-readable layer/type/priority metadata. - Modernized Bootstrap:
BOOTSTRAP_INSTRUCTIONS.mdupdated to reflect the new agent workflows. - CLI Presets: Added
--save-presetand--presetto save/load project configurations. - Refactoring: Significantly reduced cognitive complexity in
generate_projectandbuild_tech_deep_dive.
- Standardized Agent API: Formalized
.agent/into a machine-readable protocol (v2.0.0). - Protocol Manifest: Automated generation of
manifest.jsonfor every new project. - Layered Rules: All agent rules now include YAML frontmatter with priority and layer metadata.
- Extended Test Suite: New tests for CLI, Doctor mode, and Interactive mode.
- 70% -> 86% Coverage: Increased test coverage by 16% through exhaustive edge-case testing.
- Windows File Locking: Implemented robust logging cleanup in test suites to prevent WinError 32.
- LF Line-Ending Enforcement: Added
.gitattributesto guarantee consistent formatting between Windows and Linux CI environments. - Local Quality Enforcement (Pre-commit): Added
.pre-commit-config.yamlto automate Ruff formatting, linting, and safety checks locally. - AI Development Transparency: Added prominent
[!CAUTION]disclaimer toREADME.mddetailing the Gemini/Claude hybrid development and audit workflow. - Comprehensive Project Maps: Expanded
README.mdto show the full 45+ item directory tree of the generated Living Repository. - Integrated Knowledge Links: Added direct hyperlinks to Open WebUI and Antigravity Architect in all core documentation.
- Hardened Commit Workflow: Mandated
ruff format .andpytestin the/commitworkflow to prevent CI drift and regression. - Sentinel Mode (Self-Protection): Introduced proactive security auditing for critical files via
scripts/sentinel.py. - Autonomous Evolution: Added background refactoring framework (Rule 10) for systematic tech debt reduction.
- Documentation Genie: Automated deep-dive
TECH_STACK.mdgeneration during project configuration. - Multi-Repo Context Bridge: Automated sibling repository discovery and architectural synchronization.
- CI Formatting Drift: Resolved recurring
ruff format --checkfailures by standardizing onLFline endings project-wide. - Naming Inconsistency: Resolved
AttributeErrorforSENTINEL_PYconstant reference mismatch. - Generator Integrity: Fixed duplicated bootstrap file writing logic in
generate_project. - Markdown Standards Compliance: Fixed 40+ linting errors (MD022, MD030, MD031, MD032, MD040) in
README.mdand workflows. - Cognitive Complexity: Significantly reduced script complexity by refactoring monolithic generation logic into modular static methods.
- Code Refactor: Replaced brittle literal string filenames for agent rules with robust class constants (
RULE_ARCHITECTURE,RULE_SECURITY, etc.). - Tech Stack Mandate: Updated Rule 01 to strictly mandate
ruff formatandmypyas pre-commit requirements. - Test Suite Growth: Expanded verification suite to 68+ passing tests with 100% regression-free status.
- Dynamic Rule Evolution: Enabled self-correcting AI behavior.
- Multi-Agent Persona Orchestra: Added Architect, UX, and Security specialists.
- Project Ancestry: Added global rule inheritance from
~/.antigravity. - Dependency Graveyard: Added tracking for failed implementations.
- Doctor-Led Audits: Added
/doctorcommand for automated health checks. - Semantic RAG Pre-Optimization: Automatic indexing of imported docs.
- Integrated Skill Bridge: Standardized skill runner for AI agents.
- Blueprint Marketplace: Added
--blueprintflag for specialized stacks. - Visual Context Mapping: Generated Mermaid architecture diagrams.
- Time-Travel Memory: Git-integrated session history.
- Gitea Focus: Added a dedicated "Gitea Support" section to
README.md. - Template Update: Updated
PROFESSIONAL_README_TEMPLATEto highlight Gitea capabilities. - Badge: Added Gitea badge to
README.md.
- Updated
README.md"Generated Architecture" to include.gitea/and.github/structures. - Updated
PROFESSIONAL_README_TEMPLATEto reference platform configuration directories.
- Applied
ruff formatto ensure stylistic consistency.
- Fixed whitespace lints (W293) in
antigravity_master_setup.py. - Corrected f-string placeholders in dry-run report.
- Gitea Support: Added native support for Gitea (local versioning) including auto-generation of
.gitea/directories and issue templates. - Enhanced Platform Support: Improved cross-platform support for local development environments.
- Full Project Audit: Completed a line-by-line professional audit (AUDIT.md) to ensure 100/100 production readiness.
- Version Bump: Synchronized versioning across all core files to v1.5.0.
- Streamlined Architecture: Stripped out support for non-core environments (Cursor, Windsurf) and languages (Rust, Go, PHP, etc.) to focus exclusively on GitHub, VS Code, and Antigravity workflows.
- Focused Support:
GITIGNORE_MAP,NIX_PACKAGE_MAP, andVSCODE_EXTENSIONS_MAPnow only support Python, Node.js/Web, and essential tools (Docker). - Refactoring: Removed unused constants and templates (
CURSOR_RULES,WINDSURF_RULES) to reduce script size and complexity.
- VS Code Integration: Auto-generates
.vscode/directory with:extensions.json(detected tech stack recommendations)settings.json(formatter config, exclusions)launch.jsonandtasks.jsonplaceholders
- Refactoring: Reduced cognitive complexity in
doctor_projectandrun_cli_mode - Helper Functions: Added
_doctor_check_dirand_doctor_check_file
- Cleaner Code: Removed duplicate string literals via
AntigravityResourcesconstants - Linting: Fixed nested
ifand redundant types to satisfy stricter linting rules
- Doctor Regeneration:
--doctorwith--fixnow regenerates missing/empty required files - Safe Brain Dumps: Introduced
slugify_titlefor safer assimilated filenames - Verbose Dry Run: Expanded
--dry-runoutput to show every file generated
- Final Polish: Designated as definitive single-file architecture
- Version synchronization across all project files
- Documentation consistency improvements
- AI IDE Compatibility: Auto-generates
.cursorrulesand.windsurfrulesfor maximum compatibility- Cursor IDE support with dedicated rules file and Composer mode guidance
- Windsurf IDE support with Cascade AI-specific workflows and memory integration
- Comprehensive instructions tailored to each IDE's unique features
- GitHub Copilot Instructions: Auto-generates
.github/copilot-instructions.mdfor all new projects- Provides comprehensive AI agent guidance with project context
- Includes development workflows, coding standards, and commit conventions
- Documents common tasks, integration points, and key file references
- Template dynamically includes detected tech stack
- Universal AI Assistant Support: Projects now work seamlessly across multiple AI coding tools
- GitHub Copilot (VS Code, Visual Studio, JetBrains)
- Cursor IDE with AI Composer
- Windsurf with Cascade AI agent
- Google Gemini CLI / Project IDX
- Generic AI assistants via .agent/ structure
- GitHub Templates: AI instruction files now part of standard scaffolding
- Documentation: Updated README with AI IDE compatibility matrix
- Test Coverage: Added tests for .cursorrules and .windsurfrules generation
- All 62+ tests passing (100% regression-free)
- Zero external dependencies added
- Single-file portability preserved
- Script size: ~1,700 lines, 62KB
- GitHub Templates: Auto-generates
.github/with professional templates- Issue templates: bug report, feature request, question
- Pull request template with checklist
- FUNDING.yml for sponsorship links
- Issue config.yml for template configuration
- Versioning Automation: Added bump2version configuration to pyproject.toml
- Auto-updates VERSION in script, pyproject.toml, and README badge
- Creates git commit and tag automatically
- Major Refactoring: Transformed script into hybrid class-based architecture
- Created
AntigravityResourcesclass for all templates, constants, and mappings - Created
AntigravityEngineclass for file system operations and validation - Created
AntigravityBuilderclass for dynamic configuration generators - Created
AntigravityAssimilatorclass for brain dump parsing logic - Created
AntigravityGeneratorclass for project generation orchestration
- Created
- Architecture: Reorganized ~800+ lines into 5 focused, maintainable classes
- Compatibility: Maintained 100% backward compatibility via module-level function aliases
- CONTRIBUTING.md: Expanded with full guidelines, architecture docs, and versioning info
- All 59 tests passing (100% regression-free)
- Zero external dependencies added
- Single-file portability preserved
- Script size: 1,393 lines, 48.3KB
- CLI Mode: Full command-line interface with argparse.
--name,--stack,--brain-dump,--safefor scripted project creation.--dry-runto preview actions without creating files.--templatesfor custom template directories.--versionflag.
- Doctor Mode: Validate existing projects with
--doctor ./path.- Reports missing directories, files, and empty files.
--fixflag to auto-repair issues.
- License Selection: Added
--licenseflag (mit, apache, gpl) and interactive choice. - Community Standards Expansion: Auto-generation of
SECURITY.mdandCODE_OF_CONDUCT.md. - Aesthetics: Added GitHub badges for Ruff, Black, and Python support to README.
- Doctor Improvements: Expanded health check to validate all 16 core files/folders.
- CLI Project Creation: Added
--licensecommand. - Bug Fix: Resolved
argparseaction type error.
generate_project()now acceptssafe_modeandcustom_templatesparameters.- Interactive mode preserved for backwards compatibility (run with no arguments).
- Version number now embedded in script as
VERSION = "1.3.0".
- Core Script: Single-file
antigravity_master_setup.pywith zero external dependencies. - Knowledge Assimilation: Intelligent parsing of "Brain Dumps" into Rules/Workflows/Docs.
- Agent Architecture: Auto-generation of
.agent/structure (Memory, Skills, Rules, Workflows). - Privacy Controls: Automatic
.gitignoreof.agent/andcontext/directories. - Model Dispatch Protocol: "Context Handoff" system for switching between Logic/Reasoning models.
- Safe Update Mode: Non-destructive updates for existing projects.
- Community Standards: Auto-generation of
CHANGELOG.md,CONTRIBUTING.md, andAUDIT.md. - Production Engineering:
- CI/CD workflows (GitHub Actions).
- Ruff linting and Black formatting.
- Pytest test suite (59 tests, cross-platform).
- MyPy type checking.
- Cloud-Ready:
.idx/dev.nixfor Google IDX and.devcontainer/for VS Code/Codespaces. - Polyglot Support: Python, Node.js, Rust, Go, Java, PHP, Ruby, Docker, SQL.