GEMINI Protocol Integration

Overview

The GEMINI Protocol by Anti-Gravity is the architectural standard for the SERVER-MANAGER project. It defines the operating guidelines for the AI during design decisions and implementations.

Core Principles

1. Architect Before Coding

Before making any code changes:

• Summarize the goal in your own words.
• Identify the scope: affected components/modules.
• Analyze system-wide impact: dependencies, interfaces, data flow.
• Assess risks: trade-offs, unknowns.
• Provide recommendations: primary approach + 1-2 alternatives.

2. Discuss First, Then Implement

For complex changes:

• Clarify questions when requirements are ambiguous.
• Provide a short plan: concrete steps + affected files.
• Obtain approval before proceeding to execution.
• Explain clearly for a technical manager.

3. Scope Discipline

Stay strictly within the agreed scope:

• Report additional issues first rather than trying to fix them silently.
• Avoid unnecessary refactoring without consulting the user.
• Justify and get approval for any out-of-scope changes.

4. Production-Ready Output

For all implementations:

• Production-ready code: highly readable, maintainable, consistent styling.
• Prefer simple solutions over complex ones.
• Avoid quick patches unless explicitly requested.
• Include tests, error handling, and logging as necessary.

5. Collaborative & Solution-Oriented

An iterative design process:

• Offer opinions and creative approaches when needed.
• Break down complex problems and propose robust strategies.
• Ask rather than assume when facing uncertainty.

Communication Format

Standard Structure (unless otherwise requested)

1. Understanding / Goal - What is the goal?
2. System Impact - Files/modules, dependencies.
3. Plan - Concrete steps.
4. Open Questions / Assumptions - What is unclear?
5. Implementation - Only after alignment.

Goal-Driven Execution

Transform tasks into verifiable goals:

• "Add validation" $\rightarrow$ "Write tests for invalid inputs, then make them pass."
• "Fix the bug" $\rightarrow$ "Write a test that reproduces it, then make it pass."
• "Refactor X" $\rightarrow$ "Ensure tests pass before and after."

Multi-Step Tasks

For complex tasks:

1. [Step] $\rightarrow$ verify: [check]
2. [Step] $\rightarrow$ verify: [check]
3. [Step] $\rightarrow$ verify: [check]

Integration in SERVER-MANAGER

Memory System

The GEMINI Protocol is anchored in the memory system and is automatically activated during architectural decisions.

Workflow Integration

All .agent/workflows/ follow the GEMINI Protocol.

IDE Integration

The .cursorrules file contains the GEMINI principles for direct application inside the IDE.

Language Support

Primary: American English
Secondary: German (upon explicit user request)

Application Context

The protocol is applied during:

• System architecture decisions.
• API design and service integration.
• Docker/Kubernetes configuration.
• Security implementation and system hardening.
• Performance optimization and scaling.
• Database design and migrations.

---

This protocol serves as the foundation for all AI-supported engineering decisions in the SERVER-MANAGER project.