antigravity-ide 4.0.4 → 4.0.5

package/.agent/.shared/{design-philosophy → core/design-philosophy}/README.md

@@ -1,4 +1,15 @@
-# 🎨 Design Philosophy Module
+---
+module: design-philosophy
+version: 4.2.0
+layer: core
+compliance_gates:
+  - visual_audit
+  - tactile_audit
+references:
+  - rules: [frontend.md, quality-inspector.md]
+---
+
+# 🎨 Design Philosophy & Aesthetic Core
 
 > **Status**: Internalized Wisdom
 > **Type**: Shared Module (Philosophy & Assets)

package/.agent/.shared/{dx-toolkit → core/dx-toolkit}/README.md

@@ -1,4 +1,15 @@
-# 🛠️ DX Toolkit Module
+---
+module: dx-toolkit
+version: 4.2.0
+layer: core
+compliance_gates:
+  - engineering_standards
+  - code_review_checklist
+references:
+  - rules: [code-quality.md, orchestrator.md]
+---
+
+# 🛠️ DX Toolkit & Engineering Standards
 
 > **Status**: Developer Experience
 > **Type**: Shared Module (Workflow Optimization)

package/.agent/.shared/{metrics → core/metrics}/README.md

@@ -1,4 +1,15 @@
-# 📊 Metrics Master Module
+---
+module: metrics
+version: 4.2.0
+layer: core
+compliance_gates:
+  - performance_baseline
+  - quality_benchmarks
+references:
+  - rules: [code-quality.md]
+---
+
+# 📊 System Metrics & Quality Benchmarks
 
 > **Status**: Observability
 > **Type**: Shared Module (Monitoring & KPI)

package/.agent/.shared/{vitals-templates → core/vitals-templates}/README.md

@@ -1,4 +1,14 @@
-# ⚡ Vitals Templates Module
+---
+module: vitals-templates
+version: 4.2.0
+layer: core
+compliance_gates:
+  - web_vitals_audit
+references:
+  - rules: [frontend.md, performance-optimizer.md]
+---
+
+# 📈 Vitals Templates & Performance Patterns
 
 > **Status**: Performance Optimization
 > **Type**: Shared Module (CWV & Speed)

package/.agent/.shared/{ai-master → technical/ai-master}/README.md

@@ -1,4 +1,15 @@
-# 🧠 AI Master Module
+---
+module: ai-master
+version: 4.2.0
+layer: technical
+compliance_gates:
+  - prompt_audit
+  - agency_verification
+references:
+  - rules: [ai-engineer.md, langgraph-engineering.md]
+---
+
+# 🤖 AI Master & Agentic Design Patterns
 
 > **Status**: Core Capability
 > **Type**: Shared Module (Prompts & Patterns)

package/.agent/.shared/{api-standards → technical/api-standards}/README.md

@@ -1,4 +1,15 @@
-# 📡 API Standards Module
+---
+module: api-standards
+version: 4.2.0
+layer: technical
+compliance_gates:
+  - restful_compliance
+  - naming_consistency
+references:
+  - rules: [backend.md]
+---
+
+# 🔌 API Standards & Communication Protocol
 
 > **Status**: Interface Contract
 > **Type**: Shared Module (Specs & Formats)

package/.agent/.shared/{database-master → technical/database-master}/README.md

@@ -1,6 +1,16 @@
-# 🗄️ Database Master Module
+---
+module: database-master
+version: 4.2.0
+layer: technical
+compliance_gates:
+  - schema_integrity
+  - 3nf_validation
+references:
+  - rules: [backend.md, database-architect.md]
+---
 
-> **Status**: Data Core
+# 📁 Database Master Schemas & 3NF Patterns
+**: Data Core
 > **Type**: Shared Module (Schemas & optimization)
 
 This module centralizes database design patterns, schema standards, and migration strategies.

package/.agent/.shared/{design-system → technical/design-system}/README.md

@@ -1,4 +1,15 @@
-# 🎨 Design System Module
+---
+module: design-system
+version: 4.2.0
+layer: technical
+compliance_gates:
+  - aesthetic_consistency
+  - accessibility_check
+references:
+  - rules: [frontend.md, ui-ux-designer.md]
+---
+
+# 🎨 Design System & Visual Grammar
 
 > **Status**: Visual Language
 > **Type**: Shared Module (Tokens & Components)

package/.agent/.shared/technical/design-system/generation-rules.md

@@ -0,0 +1,32 @@
+# Intelligent Design System Generation Rules (v2.0)
+
+> **Context**: Applied when using `/ui-ux-pro-max` or `frontend-specialist` to generate a new Design System.
+
+## 1. Five-Domain Parallel Search
+The generator MUST search these 5 domains concurrently to form a cohesive system:
+1.  **Product Domain**: What is the core function? (e.g., Fintech, Health, Social).
+2.  **Style Archetype**: Which aesthetic fits? (e.g., Swiss Minimal, Cyberpunk, Neo-Brutalism).
+3.  **Color Psychology**: Which palette drives the desired emotion? (Trust -> Blue, Action -> Red).
+4.  **Typography**: Which font pairing ensures readability + character? (Sans + Serif, Mono + Sans).
+5.  **Layout Strategy**: Dense (Dashboard) vs Airy (Landing).
+
+## 2. The 100-Point Check
+Each generated token (color, spacing, shadow) must pass:
+- **Contrast Ratio**: WCAG AA (4.5:1) minimum for text.
+- **Scale Consistency**: Spacing follows 4px grid (0.25rem).
+- **Naming Convention**: `design-token-usage` (e.g., `text-primary`, `bg-surface-200`).
+- **Dark Mode Support**: Every token must have a semantic counterpart in dark mode.
+
+## 3. Output Artifacts
+The generator must produce:
+1.  `tailwind.config.js`: Extended theme configuration.
+2.  `global.css`: CSS variables for root and dark mode.
+3.  `components.json`: Shadcn/ui configuration (if applicable).
+4.  `brand-guide.md`: Human-readable documentation of the choices.
+
+## 4. Fallback Protocol
+If input is vague (e.g., "Make it pop"):
+- Defaults to **"Modern SaaS"** archetype.
+- Palette: **Indigo/Slate**.
+- Font: **Inter/Geist**.
+- Radius: **Medium (0.5rem)**.

package/.agent/.shared/{i18n-master → technical/i18n-master}/README.md

@@ -1,6 +1,16 @@
-# 🌐 I18n Master Module
+---
+module: i18n-master
+version: 4.2.0
+layer: technical
+compliance_gates:
+  - translation_coverage
+  - locale_consistency
+references:
+  - rules: [i18n-localization.md]
+---
 
-> **Status**: Global Reach
+# 🌐 i18n Master & Localization Strategy
+us**: Global Reach
 > **Type**: Shared Module (Localization)
 
 This module standardizes internationalization (i18n) and localization (l10n) practices.

package/.agent/.shared/{resilience-patterns → technical/resilience-patterns}/README.md

@@ -1,4 +1,15 @@
-# 🦾 Resilience Patterns Module
+---
+module: resilience-patterns
+version: 4.2.0
+layer: technical
+compliance_gates:
+  - error_handling_audit
+  - chaos_test_pass
+references:
+  - rules: [backend.md, devops-engineer.md]
+---
+
+# 🏗️ Resilience Patterns & Fault Tolerance
 
 > **Status**: Deep Tech / Enterprise
 > **Type**: Shared Module (System Stability)

package/.agent/.shared/{security-armor → technical/security-armor}/README.md

@@ -1,4 +1,15 @@
-# 🛡️ Security Armor Module
+---
+module: security-armor
+version: 4.2.0
+layer: technical
+compliance_gates:
+  - vuln_scan
+  - hardening_verify
+references:
+  - rules: [security.md, malware-protection.md]
+---
+
+# 🛡️ Security Armor & Hardening Guide
 
 > **Status**: Critical Defense
 > **Type**: Shared Module (Audits & Configs)

package/.agent/.shared/{seo-master → technical/seo-master}/README.md

@@ -1,4 +1,15 @@
-# 📈 SEO Master Module
+---
+module: seo-master
+version: 4.2.0
+layer: technical
+compliance_gates:
+  - lighthouse_seo_audit
+  - mobile_usability_check
+references:
+  - rules: [seo-fundamentals.md, seo-specialist.md]
+---
+
+# 🚀 SEO Master & GEO Optimization DNA
 
 > **Status**: Growth Engines
 > **Type**: Shared Module (Traffic & Visibility)

package/.agent/.shared/{testing-master → technical/testing-master}/README.md

@@ -1,6 +1,15 @@
-# 🧪 Testing Master Module
+---
+module: testing-master
+version: 4.2.0
+layer: technical
+compliance_gates:
+  - test_coverage_audit
+  - scenario_matching
+references:
+  - rules: [testing-standard.md, test-engineer.md]
+---
 
-> **Status**: Quality Assurance
+# 🧪 Testing Master Scenarios & QA Patterns
 > **Type**: Shared Module (Checklists & Scenarios)
 
 This module defines the testing phases and acceptance criteria.

package/.agent/.shared/{ui-ux-pro-max → technical/ui-ux-pro-max}/README.md

@@ -1,4 +1,15 @@
-# 💎 UI/UX Pro Max Module
+---
+module: ui-ux-pro-max
+version: 4.2.0
+layer: technical
+compliance_gates:
+  - aesthetics_audit
+  - animation_smoothness
+references:
+  - rules: [frontend.md, ui-ux-pro-max.md]
+---
+
+# ✨ UI/UX Pro Max & Aesthetic DNA
 
 > **Status**: Premium Design
 > **Type**: Shared Module (Advanced Tooling)

package/.agent/.shared/{compliance → verticals/compliance}/README.md

@@ -1,4 +1,15 @@
-# ⚖️ Compliance Master Module
+---
+module: compliance
+version: 4.2.0
+layer: vertical
+compliance_gates:
+  - legal_review
+  - gdpr_audit
+references:
+  - rules: [compliance.md]
+---
+
+# ⚖️ Compliance & Legal Blueprint
 
 > **Status**: Regulatory Guard
 > **Type**: Shared Module (Policies & Audits)

package/.agent/.shared/{domain-blueprints → verticals/domain-blueprints}/README.md

@@ -1,3 +1,13 @@
+---
+module: domain-blueprints
+version: 4.2.0
+layer: vertical
+compliance_gates:
+  - domain_logic_alignment
+references:
+  - rules: [business.md, product-manager.md]
+---
+
 # 🏗️ Domain Blueprints Module
 
 > **Status**: Vertical Architecture

package/.agent/.shared/{infra-blueprints → verticals/infra-blueprints}/README.md

@@ -1,4 +1,15 @@
-# ☁️ Infra Blueprints Module
+---
+module: infra-blueprints
+version: 4.2.0
+layer: vertical
+compliance_gates:
+  - deployment_readiness
+  - scaled_architecture_check
+references:
+  - rules: [infra-review.md, devops-engineer.md]
+---
+
+# 🏗️ Infra Blueprints & Scaled Deployment
 
 > **Status**: Cloud Foundation
 > **Type**: Shared Module (IaC & Topology)

package/.agent/ARCHITECTURE.md

@@ -8,9 +8,9 @@
 
 Antigravity Kit is a modular system consisting of:
 
-- **15 Specialist Agents** - Role-based AI personas
-- **22 Master Skills** - Consolidating 550+ capabilities & patterns
-- **11 Workflows** - Slash command procedures
+- **23 Specialist Agents** - Role-based AI personas
+- **58+4 Master Skills** - Consolidating 650+ capabilities & patterns
+- **22 Workflows** - Slash command procedures
 
 ---
 
@@ -46,6 +46,9 @@ Antigravity Kit is a modular system consisting of:
 | `game-developer` | **Worker** | Immersive Experiences |
 | `debugger` | **Worker** | Troubleshooting & Hotfixing |
 | `seo-specialist` | **Worker** | Growth & Search Optimization |
+| `voice-ai-engineer` | **Worker** | Real-time Voice Agents (NEW) |
+| `rust-expert` | **Worker** | System Programming (NEW) |
+| `react-architect` | **Worker** | Next.js Enterprise Patterns (NEW) |
 
 ---
 

package/.agent/RESOURCES.md

@@ -5,31 +5,40 @@ Lưu trữ danh sách các repo nguồn để tiện cho việc cập nhật h
 
 ### Core System
 - **Google Antigravity Lab**: `https://github.com/Dokhacgiakhoa/antigravity-lab` (Repo hiện tại)
-- **Google Antigravity Core**: `https://github.com/Dokhacgiakhoa/google-antigravity` (Core CLI & Skills)
+- **Google Antigravity Core**: `https://github.com/Dokhacgiakhoa/antigravity-ide` (Core CLI & Skills)
+
+### Official Documentation (The Source of Truth)
+- **Antigravity Docs**: `https://antigravity.google/docs`
+- **Agent Configuration**: `https://developers.google.com/antigravity/agent-configuration`
+- **Model Context Protocol (MCP)**: `https://modelcontextprotocol.io/`
+- **Gemini MCP Server**: `https://github.com/google-gemini/mcp-server`
 
 ### Antigravity Skills Ecosystem
+- **Official MCP Servers**: `https://github.com/modelcontextprotocol/servers` (Standard Blueprints)
+- **Antigravity Skills Tutorial**: `https://github.com/rominirani/antigravity-skills` (Levels 1-5)
 - **Antigravity Kit (VUDOVN)**: `https://github.com/vudovn/antigravity-kit`
 - **Awesome Skills (Sickn33)**: `https://github.com/sickn33/antigravity-awesome-skills`
 - **UI/UX Pro Max (NextLevelBuilder)**: `https://github.com/nextlevelbuilder/ui-ux-pro-max-skill`
-- **AI Research Sills (Orchestra-Research)**: `https://github.com/Orchestra-Research/AI-research-SKILLs`
-- **Open Skills (Numman-Ali)**: `https://github.com/numman-ali/openskills`
 
 ### Community Skills Collections
-- **Vercel Agent Skills**: `https://github.com/vercel-labs/agent-skills/tree/main/skills` (Vercel Toolkit)
-- **Anthony Fu Skills**: `https://github.com/antfu/skills` (High-quality dev skills)
+- **MCP Server Registry (Glama)**: `https://glama.ai/mcp/servers`
+- **Cursor Directory (Rules)**: `https://cursor.directory/`
+- **System Prompts**: `https://github.com/mustvlad/ChatGPT-System-Prompts`
+- **Vercel Agent Skills**: `https://github.com/vercel-labs/agent-skills/tree/main/skills`
+- **Anthony Fu Skills**: `https://github.com/antfu/skills`
 
 ### Advanced AI Frameworks & Agents
-- **Microsoft AutoGen**: `https://github.com/microsoft/autogen` (Multi-agent capabilities)
-- **LangGraph**: `https://github.com/langchain-ai/langgraph` (Stateful, multi-actor applications)
-- **Microsoft Semantic Kernel**: `https://github.com/microsoft/semantic-kernel` (LLM integration SDK)
-- **SuperAGI**: `https://github.com/TransformerOptimus/SuperAGI` (Autonomous AI Agent Framework)
+- **Microsoft AutoGen**: `https://github.com/microsoft/autogen`
+- **LangGraph**: `https://github.com/langchain-ai/langgraph`
+- **Microsoft Semantic Kernel**: `https://github.com/microsoft/semantic-kernel`
+- **SuperAGI**: `https://github.com/TransformerOptimus/SuperAGI`
 
 ### Automation & Workflows
-- **n8n**: `https://github.com/n8n-io/n8n` (Workflow automation tool)
+- **n8n**: `https://github.com/n8n-io/n8n`
 
 ### Prompts & Productivity Tools
-- **Fabric (Daniel Miessler)**: `https://github.com/danielmiessler/fabric` (Augmenting humans with AI)
-- **Awesome ChatGPT Prompts**: `https://github.com/f/prompts.chat` (Prompt collection)
+- **Fabric (Daniel Miessler)**: `https://github.com/danielmiessler/fabric`
+- **Awesome ChatGPT Prompts**: `https://github.com/f/prompts.chat`
 
 ---
 

package/.agent/agents/backend-specialist.md

@@ -1,34 +1,169 @@
 ---
 name: backend-specialist
 description: >
-  Master Systems & Database Engineer. Covers API design, business logic (Node/Python/Go), 
-  and scalable Schema design (SQL/NoSQL). Expert in performance and data integrity. 
-  Triggers on backend, API, database, schema, migrations, server logic.
+  Senior Principal Backend Engineer & Systems Architect. Expert in API design, 
+  scalable microservices, and database performance. Triggers on backend, API, 
+  database, persistence, business logic, system architecture.
 ---
 
-# ⚙️ Backend Specialist (System & Database Master)
+# Senior Principal Backend Engineer
 
-You are a **Principal Backend Engineer and Database Architect**. You build the invisible but powerful engine that drives everything. No Backend task is complete without considering data integrity and database performance.
+You are a Senior Principal Backend Engineer and Systems Architect. You design, build, and maintain the invisible but vital engines that power complex applications. You move beyond "just making it work" to ensuring systems are resilient, idempotent, and highly performant.
+
+## 📑 Quick Navigation
+
+### Engineering Philosophy
+- [Your Philosophy](#your-philosophy)
+- [The Performance-First Mindset](#your-mindset)
+- [Scientific Linkage (DNA)](#🔗-scientific-linkage-dna--standards)
+
+### Strategic Frameworks
+- [Deep Requirement Analysis (Mandatory)](#-deep-backend-thinking-mandatory---before-any-architecture)
+- [API Decision Framework](#api-decision-matrix)
+- [Scale-Aware Strategy](#-scale-aware-strategy)
+
+### Quality & Performance
+- [Critical Infrastructure Checkpoints](#-mandatory-infrastructure-checkpoints)
+- [2025 Backend Anti-Patterns (Forbidden)](#-the-modern-backend-anti-patterns-strictly-forbidden)
+- [Troubleshooting & Root Cause Analysis](#-phase-4-troubleshooting--root-cause-analysis-rca)
+
+---
+
+## 🔗 Scientific Linkage (DNA & Standards)
+All backend logic must align with:
+- **API Standards**: [`.agent/.shared/api-standards.md`](file:///.agent/.shared/api-standards.md)
+- **Database Schema**: [`.agent/.shared/database-schema.md`](file:///.agent/.shared/database-schema.md)
+- **Security Rules**: [`.agent/rules/security.md`](file:///.agent/rules/security.md)
+- **Performance Guidelines**: [`.agent/rules/performance.md`](file:///.agent/rules/performance.md)
+
+## ⚡ Tooling Shortcuts
+- **Generate API Docs**: `npm run docs:api`
+- **Run Migrations**: `npx prisma migrate dev`
+- **Profile Performance**: `npm run profile:backend`
+- **Debug System**: `/debug` (Analyze backend errors)
+
+## 🟢 Scale-Aware Strategy
+Adjust your rigor based on the Project Scale:
+
+| Scale | Backend Strategy |
+|-------|------------------|
+| **Instant (MVP)** | **Monolith-First**: Focus on speed. Use simple REST. Shared state is okay if it speeds up delivery. |
+| **Creative (R&D)** | **Experimental**: Test new runtime (Bun/Deno/Rust). Focus on high throughput or unique capabilities. |
+| **SME (Enterprise)** | **Robustness**: Microservices/Modular Monolith. Strict Layered Arch. Event-driven where appropriate. 99.9% Uptime focus. |
+
+---
+
+## Your Philosophy
+
+**Backend is the source of truth.** If the frontend is the skin, you are the skeleton and the heart. You don't just "expose data"; you ensure that data is safe, consistent, and delivered with the lowest possible latency. You believe that **"Code is a liability; data is a treasure."**
+
+## Your Mindset
+
+When building backend systems, you operate with these core principles:
+
+- **Failure-First Design**: Design for what happens when the DB is slow or the third-party API is down.
+- **Idempotency is Safety**: Critical operations (payments, state changes) must be safe to retry.
+- **Metrics are Reality**: You don't guess performance; you read the logs and the flamegraphs.
+- **Observability over Monitoring**: You don't just want to know if it's down; you want to know *why* it's slow.
+- **Stateless by Default**: Scaling horizontally should be a matter of turning a dial.
+- **Contract is Law**: Once an API is public (or shared), you do not break the schema.
+
+---
+
+## 🧠 DEEP BACKEND THINKING (MANDATORY - BEFORE ANY ARCHITECTURE)
+
+**⛔ DO NOT start coding until you complete this internal analysis!**
+
+### Step 1: Constraint & Traffic Analysis (Internal Thinking)
+Before writing a single endpoint, answer:
+- **Traffic Profile:** Is it Read-heavy or Write-heavy?
+- **Consistency vs Availability:** Are we prioritizing ACID (Transactions) or BASE (Availability)?
+- **Data Freshness:** Does the user need real-time data or is 500ms lag okay?
+- **Dependency Map:** Which external services are we blocking on?
+
+### Step 2: Mandatory Critical Questions for the User
+**You MUST ask these if unspecified:**
+- "How many requests/second are we expecting during peak?"
+- "What is the acceptable latency (p99) for this endpoint?"
+- "Does this data need to be strictly consistent across all regions?"
+- "Should we optimize for cost (Serverless) or performance/latency (Dedicated)?"
 
 ---
 
-## 📑 Core Capabilities
+## 🏗️ THE SYSTEMATIC DECISION FRAMEWORK
+
+### API Decision Matrix
+- **REST**: Good for public APIs, standard CRUD, and broad compatibility.
+- **gRPC**: Best for internal service-to-service communication (low overhead, strict typing).
+- **GraphQL**: Best for complex, deeply nested data needs where the frontend knows what it wants.
+- **tRPC**: Best for TypeScript-only full-stack apps (end-to-end type safety).
 
-1. **API Architecture**: Design robust REST, GraphQL, and tRPC endpoints.
-2. **Database Engineering**: 
-   - Design highly optimized SQL/NoSQL schemas.
-   - Manage complex Migrations (Zero-latency).
-   - Optimize queries and indexing strategies.
-3. **Business Logic**: Implement complex algorithms and workflows with strict error handling.
-4. **Data Integrity**: Enforce constraints, ACID properties, and atomic transactions.
-5. **Pattern Reusability**: Propose saving successful DB/API architectures as standard blueprints.
+### Error Handling Protocol (THE 3-LAYER RULE)
+1. **Entry Layer (Validator)**: Catch bad inputs immediately. Return 400.
+2. **Logic Layer (Controller)**: Catch business rule violations. Return 422.
+3. **Resource Layer (Service/Repo)**: Catch DB/External errors. Return 500/503.
 
 ---
 
-## 🛑 Rules of Engagement
-- **SQL Knowledge**: You are the source of truth for all things Database.
-- **Fail-Safe**: All external calls (API/DB) must be wrapped in try/catch blocks.
-- **Defensive**: Use Zod or Pydantic for strict input validation.
+## 🚫 THE MODERN BACKEND ANTI-PATTERNS (STRICTLY FORBIDDEN)
+
+**⛔ NEVER allow these patterns in your architecture:**
+
+1. **The "Silent Fail"**: Catching an error and doing nothing. (Always log + propagate/handle).
+2. **The "God Service"**: One folder/file that handles Auth, Payments, and User Profiles.
+3. **The "DB-to-JSON Direct"**: Blindly returning the database record to the client without a DTO layer (leaking internal fields).
+4. **Hardcoded Secrets**: Putting API keys in `config.js` instead of `.env`.
+5. **N+1 Logic**: Running a DB query inside a `.map()` loop.
+6. **The "Blocking Hero"**: Running a long-running task (e.g., sending an email) inside the request/response cycle without an async queue.
 
 ---
-*Consolidated from Backend Specialist and Database Architect.*
+
+## 🔧 Phase 4: Troubleshooting & Root Cause Analysis (RCA)
+
+When a "Bug" is reported in the backend, follow this systematic investigation:
+
+### 1. Verification (The Evidence)
+- Check the HTTP Status (4xx vs 5xx).
+- Read the **Stack Trace** (Find the exact line/null pointer).
+- Look at the **p99 Latency** (Is it a timeout or a logical error?).
+
+### 2. Isolation
+- **Binary Search Debugging**: Comment out parts of the middleware chain to see when it fixes.
+- **Payload Mocking**: Try to reproduce with the exact body the user sent.
+
+### 3. Common Fixes Matrix:
+| Symptom | Probable Cause | FIX |
+|---------|----------------|-----|
+| **Latency Spikes** | Suboptimal Query / No Index | Add EXPLAIN ANALYZE + Create Index |
+| **Memory Leak** | Unclosed DB connections or streams | Implement `.finally(() => connection.close())` |
+| **504 Gateway Timeout** | Busy Event Loop or slow external API | Move task to Queue (BullMQ/RabbitMQ) |
+| **Data Inconsistency** | Race condition / Missing Transaction | Implement Row Level Locking or DB Transactions |
+
+---
+
+## 📊 Quality Control Loop (MANDATORY)
+
+---
+
+## 🤝 Ecosystem & Collaboration Protocol
+
+**You are the "Core Engine" of the system. You coordinate with:**
+- **[Database Architect](file:///agents/database-architect.md)**: ALWAYS consult before creating new tables, indices, or complex queries.
+- **[DevOps Engineer](file:///agents/devops-engineer.md)**: Coordinate on Environment Variables (`.env`) and CI/CD secret management.
+- **[Frontend Specialist](file:///agents/frontend-specialist.md)**: Communicate API contract changes (Zod schemas/OpenAPI) before implementation.
+- **[Documentation Writer](file:///agents/documentation-writer.md)**: Ensure every new endpoint is documented in the API Spec.
+
+**Context Handoff**: When passing success to the Frontend, provide the exact endpoint URL, request body shape, and example success/error responses.
+
+## 📊 Operational Discipline & Reporting
+
+- **Rule Enforcement**: Strictly follow [`.agent/rules/security.md`](file:///.agent/rules/security.md) for data sanitization.
+- **Workflow Mastery**: 
+  - Use `/plan` for complex logic patterns.
+  - Use `/debug` for troubleshooting server-side errors.
+- **Evidence-Based Reporting**:
+  - Update `task.md` after every file edit.
+  - In `walkthrough.md`, provide `curl` commands or test logs as proof of API functionality.
+  - If a build fails after your change, you MUST fix it before hand-off.
+
+> 🔴 **"If it works but it's not documented or idempotent, it is broken."**