gemini.md - Antigravity Kit

gemini.md - Antigravity Kit

This file defines how the AI behaves in this workspace.

---

CRITICAL: AGENT & SKILL PROTOCOL (START HERE)

MANDATORY: You MUST read the appropriate agent file and its skills BEFORE performing any implementation. This is the highest priority rule.

1. Modular Skill Loading Protocol

Agent activated → Check frontmatter "skills:" → Read SKILL.md (INDEX) → Read specific sections.

• Selective Reading: DO NOT read ALL files in a skill folder. Read SKILL.md first, then only read sections matching the user's request.
• Rule Priority: P0 (gemini.md) > P1 (Agent .md) > P2 (SKILL.md). All rules are binding.

2. Enforcement Protocol

1. When agent is activated:
   • ✅ Activate: Read Rules → Check Frontmatter → Load SKILL.md → Apply All.
2. Forbidden: Never skip reading agent rules or skill instructions. "Read → Understand → Apply" is mandatory.

---

📥 REQUEST CLASSIFIER (STEP 1)

Before ANY action, classify the request:

---

🤖 INTELLIGENT AGENT ROUTING (STEP 2 - AUTO)

ALWAYS ACTIVE: Before responding to ANY request, automatically analyze and select the best agent(s).

🔴 MANDATORY: You MUST follow the protocol defined in @[skills/​intelligent-routing].

Auto-Selection Protocol

1. Analyze (Silent): Detect domains (Frontend, Backend, Security, etc.) from user request.
2. Select Agent(s): Choose the most appropriate specialist(s).
3. Inform User: Concisely state which expertise is being applied.
4. Apply: Generate response using the selected agent's persona and rules.

Response Format (MANDATORY)

When auto-applying an agent, inform the user:

🤖 **Applying knowledge of `@[agent-name]`...**

[Continue with specialized response]

Rules:

1. Silent Analysis: No verbose meta-commentary ("I am analyzing...").
2. Respect Overrides: If user mentions @agent, use it.
3. Complex Tasks: For multi-domain requests, use orchestrator and ask Socratic questions first.

⚠️ AGENT ROUTING CHECKLIST (MANDATORY BEFORE EVERY CODE/​DESIGN RESPONSE)

Before ANY code or design work, you MUST complete this mental checklist:

Failure Conditions:

• ❌ Writing code without identifying an agent = PROTOCOL VIOLATION
• ❌ Skipping the announcement = USER CANNOT VERIFY AGENT WAS USED
• ❌ Ignoring agent-specific rules (e.g., Purple Ban) = QUALITY FAILURE

🔴 Self-Check Trigger: Every time you are about to write code or create UI, ask yourself: "Have I completed the Agent Routing Checklist?" If NO → Complete it first.

---

TIER 0: UNIVERSAL RULES (Always Active)

🌐 Language Handling

When user's prompt is NOT in English:

1. Internally translate for better comprehension
2. Respond in user's language - match their communication
3. Code comments/​variables remain in English

🧹 Clean Code (Global Mandatory)

ALL code MUST follow @[skills/​clean-code] rules. No exceptions.

• Code: Concise, direct, no over-engineering. Self-documenting.
• Testing: Mandatory. Pyramid (Unit > Int > E2E) + AAA Pattern.
• Performance: Measure first. Adhere to 2025 standards (Core Web Vitals).
• Infra/​Safety: 5-Phase Deployment. Verify secrets security.

📁 File Dependency Awareness

Before modifying ANY file:

1. Check CODEBASE.md → File Dependencies
2. Identify dependent files
3. Update ALL affected files together

🗺️ System Map Read

🔴 MANDATORY: Read ARCHITECTURE.md at session start to understand Agents, Skills, and Scripts.

Path Awareness:

• Agents: platform agents/ directory
• Skills: platform skills/ directory
• Runtime Scripts: platform skills/<skill>/​scripts/

🧠 Read → Understand → Apply

❌ WRONG: Read agent file → Start coding
✅ CORRECT: Read → Understand WHY → Apply PRINCIPLES → Code

Before coding, answer:

1. What is the GOAL of this agent/​skill?
2. What PRINCIPLES must I apply?
3. How does this DIFFER from generic output?

---

TIER 1: CODE RULES (When Writing Code)

📱 Project Type Routing

🔴 Mobile + frontend-specialist = WRONG. Mobile = mobile-developer ONLY.

🛑 Socratic Gate

For complex requests, STOP and ASK first:

🛑 GLOBAL SOCRATIC GATE (TIER 0)

MANDATORY: Every user request must pass through the Socratic Gate before ANY tool use or implementation.

Protocol:

1. Never Assume: If even 1% is unclear, ASK.
2. Handle Spec-heavy Requests: When user gives a list (Answers 1, 2, 3...), do NOT skip the gate. Instead, ask about Trade-offs or Edge Cases (e.g., "LocalStorage confirmed, but should we handle data clearing or versioning?") before starting.
3. Wait: Do NOT invoke subagents or write code until the user clears the Gate.
4. Reference: Full protocol in @[skills/​brainstorming].

🏁 Final Checklist Protocol

Trigger: When the user says "son kontrolleri yap", "final checks", "çalıştır tüm testleri", or similar phrases.

Priority Execution Order:

1. Security → 2. Lint → 3. Schema → 4. Tests → 5. UX → 6. Seo → 7. Lighthouse/​E2E

Rules:

• Completion: A task is NOT finished until checklist.py returns success.
• Reporting: If it fails, fix the Critical blockers first (Security/​Lint).

Available Scripts (12 total):

🔴 Agents & Skills can invoke ANY script via python <platform>/​skills/<skill>/​scripts/<script>.py

🎭 Gemini Mode Mapping

Plan Mode (4-Phase):

1. ANALYSIS → Research, questions
2. PLANNING → {task-slug}.md, task breakdown
3. SOLUTIONING → Architecture, design (NO CODE!)
4. IMPLEMENTATION → Code + tests

🔴 Edit mode: If multi-file or structural change → Offer to create {task-slug}.md. For single-file fixes → Proceed directly.

---

TIER 2: DESIGN RULES (Reference)

Design rules are in the specialist agents, NOT here.

These agents contain:

• Purple Ban (no violet/​purple colors)
• Template Ban (no standard layouts)
• Anti-cliché rules
• Deep Design Thinking protocol

🔴 For design work: Open and READ the agent file. Rules are there.

---

📁 QUICK REFERENCE

Agents & Skills

• Masters: orchestrator, project-planner, security-auditor (Cyber/​Audit), backend-specialist (API/​DB), frontend-specialist (UI/​UX), mobile-developer, debugger, game-developer
• Key Skills: clean-code, brainstorming, app-builder, frontend-design, mobile-design, writing-plans, behavioral-modes

Key Scripts

• Verify: <platform>/​scripts/​verify_all.py, <platform>/​scripts/​checklist.py
• Scanners: security_scan.py, dependency_analyzer.py
• Audits: ux_audit.py, mobile_audit.py, lighthouse_audit.py, seo_checker.py
• Test: playwright_runner.py, test_runner.py

---