Google Antigravity IDE:
Лучшие практики настройки
для продуктивной разработки

markdownCopy
# Agent Identity & Role

You are a **Senior Full-Stack Engineer** specializing in React/TypeScript frontends
and Node.js backends. You approach tasks like John Carmack: systematic, elegant,
no unnecessary abstractions.

## Project Context

- **Stack:** React 19, TypeScript 5.4, Vite, TailwindCSS, shadcn/ui, Zustand
- **Backend:** Node.js + Fastify, PostgreSQL (Prisma ORM)
- **Testing:** Vitest + Playwright (e2e)
- **CI/CD:** GitHub Actions → Vercel

## Coding Standards

- TypeScript strict mode — never use `any`
- Functional components only, no class components
- Prefer named exports over default exports
- Co-locate tests with source: `Component.test.tsx` рядом с `Component.tsx`
- CSS: TailwindCSS utility-first; кастомные CSS только через `@layer`
- Коммит-сообщения: Conventional Commits (`feat:`, `fix:`, `chore:` и т.д.)

## Architecture Rules

- State management: Zustand для глобального, useState/useReducer для локального
- API calls только через `/src/api/` layer — никогда напрямую в компонентах
- Бизнес-логика в `/src/hooks/` или `/src/services/` — не в компонентах
- Компоненты в `/src/components/ui/` — pure/presentational
- Страницы в `/src/pages/` — только composition, без бизнес-логики

## Behavior Guidelines

1. **Plan before code:** для задач крупнее 50 строк — сначала опиши план в Artifact
2. **Closed-loop testing:** после написания кода — запусти тесты, убедись что проходят
3. **Debug with logs:** при отладке добавляй `console.log` с пометкой `[DEBUG]`
4. **Don't over-engineer:** YAGNI. Не добавляй абстракции "на будущее"
5. **Ask before destructive ops:** любое удаление файлов/БД — спроси подтверждение

## What to Avoid

- Не используй `var`, только `const`/`let`
- Не создавай inline styles в JSX
- Не импортируй из `node_modules` напрямую в компоненты
- Не коммить `.env` файлы

markdownCopy
# Global Agent Configuration

## My Development Philosophy

I value: correctness > simplicity > performance > cleverness.
Never sacrifice correctness for any other goal.

## Universal Standards (all projects)

- **Language:** Prefer TypeScript over JavaScript everywhere
- **Git:** Atomic commits, meaningful messages, feature branches
- **Security:** Never log secrets, always validate inputs, sanitize outputs
- **Documentation:** Update README when adding features

## My Tech Preferences

- Frontend: React + TypeScript (vite) or Next.js 15 (App Router)
- Backend: Node.js (Fastify) или Python (FastAPI)
- DB: PostgreSQL первый выбор, MongoDB если нужна гибкость схемы
- Deploy: Vercel (frontend), Railway/Fly.io (backend)

## My Working Style

- Я предпочитаю видеть план перед реализацией для больших задач
- Всегда объясняй нетривиальные решения в комментариях
- Если задача неоднозначна — уточни у меня, не угадывай
- Показывай diff до применения для рефакторингов

## Context Recovery

When starting a new conversation, read these files first:
1. `tasks.md` — текущие задачи и их статус
2. `ARCHITECTURE.md` — если есть
3. Recent git log: `git log --oneline -10`

textCopy
Глобальные скиллы (для всех проектов):
~/.gemini/antigravity/skills/
  └── brainstorming/
      └── SKILL.md
  └── code-review/
      └── SKILL.md
  └── git-commit/
      └── SKILL.md

Воркспейс-скиллы (для конкретного проекта):
.agent/skills/
  └── deploy-to-staging/
      └── SKILL.md
  └── generate-component/
      └── SKILL.md

bashCopy
# Глобальная установка (рекомендуется для старта)
npx antigravity-awesome-skills

# Или только для этого воркспейса
npx antigravity-awesome-skills --path .agent/skills

# Проверка установки
test -d ~/.gemini/antigravity/skills && echo "OK: skills installed"

# Обновление
git -C ~/.gemini/antigravity/skills pull

markdownCopy
---
name: generate-react-component
description: Generates a production-ready React component with TypeScript, tests, and Storybook story
version: 1.0.0
author: your-name
tags: [react, typescript, frontend, component]
---

# Skill: Generate React Component

## Purpose
Creates a complete React component package following the project's conventions.

## Input Parameters
- `component_name` (required): PascalCase component name (e.g., `UserCard`)
- `component_type` (optional): `ui` | `feature` | `layout` (default: `ui`)
- `with_tests` (optional): boolean, default `true`

## Process

1. **Analyze existing patterns**
   - Read similar components in the codebase for conventions
   - Check `/src/components/` structure

2. **Generate files:**
   ```
   src/components/{type}/{ComponentName}/
   ├── {ComponentName}.tsx          # Main component
   ├── {ComponentName}.test.tsx     # Vitest unit tests
   ├── {ComponentName}.stories.tsx  # Storybook story
   └── index.ts                    # Re-export
   ```

3. **Component template:**
   - TypeScript interface for props (named `{ComponentName}Props`)
   - Proper JSDoc comments
   - Accessibility attributes (aria-*)
   - Responsive Tailwind classes

4. **Test template:** render test, props validation, user interaction

5. **Verify:** Run `npx vitest run {ComponentName}` and confirm passing

## Output
Artifact with file listing and summary of what was created.

## Example Invocation
"Use @generate-react-component to create a ProductCard component with image, title, price, and add-to-cart button"

textCopy
@brainstorming         — планирование фич, SaaS-идей
@code-review           — код-ревью с actionable feedback
@refactor              — рефакторинг с объяснением
@lint-and-validate     — линтинг + TypeScript check
@generate-tests        — генерация тестов для существующего кода
@git-commit            — generate conventional commit message
@update-changelog      — обновление CHANGELOG.md
@security-audit        — проверка на уязвимости
@performance-analysis  — профилирование и оптимизация
@document-code         — генерация JSDoc/TSDoc комментариев

textCopy
┌─────────────────────────────────────┐
│           ORCHESTRATION LAYER        │
│  (ты как CTO — задаёшь направление) │
└─────────────────────────────────────┘
         │              │              │
         ▼              ▼              ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Antigravity  │ │ Claude Code  │ │ Codex Cloud  │
│ (Gemini 3)   │ │ (Sonnet 4.5) │ │ (GPT-OSS)    │
│              │ │              │ │              │
│ UI/UX tasks  │ │ Architecture │ │ Tests &      │
│ Browser auto │ │ Code review  │ │ Docs         │
│ Visual check │ │ Refactoring  │ │ Migrations   │
└──────────────┘ └──────────────┘ └──────────────┘
         │              │              │
         └──────────────┴──────────────┘
                        │
                        ▼
                  tasks.md / git
              (общий coordination layer)

textCopy
Воркспейс 1: my-blog
└── Агент: «Сдвинь дату публикации с 19-го на 21-е и переименуй файл»

Воркспейс 2: api-service
└── Агент: «Добавь README.md к папке /protocols, объясни примеры»

Воркспейс 3: frontend-app
└── Агент: «Добавь документацию и unit-тесты к Program.cs»

jsonCopy
{
  "terminal_execution": "always_proceed",
  "review_policy": "agent_decides",
  "js_execution": "always_proceed",
  "deny_list": [
    "rm -rf /",
    "sudo rm",
    "DROP TABLE",
    "git push --force",
    "npm publish",
    "curl | bash",
    "wget | bash"
  ],
  "allow_list": [
    "npm install",
    "npm run *",
    "npx *",
    "git *",
    "python *",
    "node *",
    "vitest *",
    "playwright *"
  ]
}

textCopy
┌─────────────────────────────────────────────────────┐
│                    AGENT MANAGER                     │
├─────────┬───────────────────────────────────────────┤
│         │  Inbox                                     │
│ Sidebar │  └── Все активные разговоры               │
│         │  └── Pending approvals                    │
│         │                                           │
│         │  Workspaces                               │
│         │  ├── project-alpha/ → Agent 1             │
│         │  ├── api-service/   → Agent 2             │
│         │  └── docs-site/     → Agent 3             │
│         │                                           │
│         │  Playground                               │
│         │  └── Scratch area (без привязки к репо)  │
└─────────┴───────────────────────────────────────────┘

textCopy
.agent/workflows/
├── commit.md          # Generate commit message
├── changelog.md       # Update CHANGELOG.md
├── pr-review.md       # Подготовить PR description
├── deploy-staging.md  # Деплой на staging
└── daily-review.md    # Утренний обзор задач

Глобальные workflows: ~/.gemini/antigravity/workflows/

markdownCopy
# Workflow: Git Commit

## Trigger
Run when user asks to commit current changes.

## Steps

1. Run `git diff --staged` to see staged changes
2. If nothing staged, run `git status` and ask which files to stage
3. Analyze the diff and generate a conventional commit message:
   - Format: `type(scope): description`
   - Types: feat, fix, refactor, style, test, docs, chore, perf
   - Keep description under 72 chars
   - Use imperative mood ("add" not "added")
4. Show the proposed message to user
5. If approved, run `git commit -m "message"`
6. Optional: push if user confirms

## Output
Confirm what was committed with the message used.

markdownCopy
# Workflow: Update Changelog

## Trigger
After completing a feature or fix.

## Steps

1. Run `git log --oneline $(git describe --tags --abbrev=0)..HEAD`
   to get commits since last tag
2. Categorize commits:
   - ### Added (feat:)
   - ### Fixed (fix:)
   - ### Changed (refactor:, perf:)
   - ### Removed
3. Update CHANGELOG.md at the top, adding new section:
   ```
   ## [Unreleased] - YYYY-MM-DD
   ### Added
   - ...
   ```
4. Show diff to user before applying

markdownCopy
# Workflow: Prepare PR

## Steps

1. Run `git log main..HEAD --oneline` to list commits
2. Run `git diff main...HEAD --stat` for changed files overview
3. Generate PR description with:
   - **What:** 2-3 sentence summary
   - **Why:** motivation/problem solved
   - **How:** key implementation decisions
   - **Testing:** how it was tested
   - **Screenshots:** if UI changes, remind user to add
4. Output as copyable Markdown block

markdownCopy
# Workflow: Daily Review

## Steps

1. Read `tasks.md` in the workspace root
2. Run `git log --since="24 hours ago" --oneline`
3. Check for failing tests: `npm run test -- --reporter=dot 2>&1 | tail -5`
4. Generate morning briefing:
   - ✅ Завершено вчера
   - 🔄 В работе сегодня
   - ⚠️ Блокеры
   - 📋 Следующие приоритеты
5. Update tasks.md статусы

markdownCopy
# Workflow: Deploy to Staging

## Pre-flight checks

1. Run `npm run build` — должна быть без ошибок
2. Run `npm run test` — все тесты зелёные
3. Run `npm run lint` — нет ошибок
4. Confirm: `git status` — нет unstaged changes

## Deploy

5. Run `git push origin HEAD`
6. Check CI status: open GitHub Actions URL
7. If using Vercel: preview URL появится автоматически

## Post-deploy

8. Open staging URL in browser agent
9. Verify key pages load correctly
10. Report: staging URL + screenshot в Artifact

markdownCopy
# Project Tasks

**Last updated:** 2026-02-23 | **Active agent:** Antigravity/Gemini-3-Pro

---

## 🔴 In Progress

### TASK-042: Add user authentication
**Status:** Implementation (60%)
**Agent:** Antigravity-Session-7
**Started:** 2026-02-22
**Branch:** `feat/auth-system`

**Completed steps:**
- [x] Login form component (LoginForm.tsx)
- [x] JWT token storage (useAuth hook)
- [x] Protected route wrapper

**Remaining:**
- [ ] Register form
- [ ] Password reset flow
- [ ] Session refresh logic

**Blockers:** None

**Context for next agent:**
> JWT stored in httpOnly cookie via `/api/auth/login` endpoint.
> User state in Zustand store (`/src/stores/authStore.ts`).
> Protected routes use `<ProtectedRoute>` wrapper in router config.

---

## 🟡 Ready to Start

### TASK-043: Dashboard analytics widgets
**Priority:** High
**Estimate:** ~4 hours agent work
**Dependencies:** TASK-042 (auth) must be complete

**Acceptance criteria:**
- 3 metric cards (DAU, Revenue, Conversions)
- Line chart for 30-day trend (using Recharts)
- Real data from `/api/analytics/summary` endpoint
- Loading skeletons while fetching
- Responsive: works on mobile

**Technical notes:**
> API endpoint documented in `/docs/api/analytics.md`
> Design reference: Figma link https://figma.com/...
> Use existing `<MetricCard>` component

---

## ✅ Completed

### TASK-041: Setup project structure ✅
Completed 2026-02-21. See commit `feat: initial project scaffold (a3f8c21)`

### TASK-040: Configure CI/CD pipeline ✅
GitHub Actions → Vercel. See `.github/workflows/deploy.yml`

---

## 📋 Backlog

- TASK-050: Dark mode support
- TASK-051: Export data to CSV
- TASK-052: Email notifications
- TASK-053: Admin panel

---

## 🔧 Technical Debt

- Refactor: API layer нужен error boundary
- Performance: lazy load тяжёлых dashboard-компонентов
- Testing: coverage в data layer < 40%, нужно поднять до 80%

---

## 📝 Agent Instructions

**При начале работы:**
1. Прочитай этот файл полностью
2. Возьми первую задачу из "Ready to Start" с учётом зависимостей
3. Обнови статус на "In Progress" с указанием своей сессии
4. По завершении: отметь как Done, добавь commit hash

**При окончании сессии:**
1. Запиши "Remaining" — что осталось сделать
2. Запиши "Context for next agent" — всё что важно знать
3. Обнови Last updated

textCopy
1. Обсуди идею с Gemini/ChatGPT в отдельном чате
   → получи product description для CPO и CTO

2. Попроси Gemini скомпилировать Mission Brief из этого описания
   → структурированный документ с целями, ограничениями, метриками успеха

3. Вставь Mission Brief в tasks.md / GEMINI.md нового проекта

4. Запускай агента в Antigravity с задачами из Brief

5. Периодически суммаризируй прогресс и отправляй в Gemini
   → проверяй соответствие исходному направлению

markdownCopy
## Session Start Protocol

1. Read `tasks.md` — understand current state
2. Run `git log --oneline -10` — see recent changes
3. Run `git status` — check for uncommitted work
4. Check for failing tests before starting new work
5. Then: pick next task from tasks.md "Ready to Start"

markdownCopy
## Session End Protocol

Before closing:
1. Commit all completed work with meaningful message
2. Update tasks.md (mark done, add context for next agent)
3. Run tests — ensure everything still passes
4. If blocked: document the blocker in tasks.md

jsonCopy
{
  "servers": [
    {
      "name": "github",
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" },
      "enabled": true
    },
    {
      "name": "filesystem",
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"],
      "enabled": true
    },
    {
      "name": "postgres",
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": { "POSTGRES_URL": "${DATABASE_URL}" },
      "enabled": false
    }
  ]
}

bashCopy
# Готовый production-grade шаблон
git clone https://github.com/study8677/antigravity-workspace-template.git my-project
cd my-project
./install.sh

bashCopy
# 1. Установить Antigravity
# Скачать с https://antigravity.google/download

# 2. Настроить глобальный GEMINI.md
mkdir -p ~/.gemini
cat > ~/.gemini/GEMINI.md << 'EOF'
# Global Rules
[вставь свою конфигурацию из раздела 1]
EOF

# 3. Установить skills
npx antigravity-awesome-skills

# 4. Для нового проекта — создать структуру
mkdir -p .agent/{skills,workflows}
touch .agent/GEMINI.md tasks.md

# 5. Настройки Antigravity
# Settings → Terminal: Agent Decides (или Always Proceed для dev)
# Settings → Review: Agent Decides
# ОБЯЗАТЕЛЬНО: Quick Settings Panel → включи те же настройки!

# 6. Deny list (минимальный набор)
# Добавь в Settings → Deny List:
# rm -rf /
# sudo rm
# git push --force
# npm publish

# 7. Проверка
agy --version  # CLI команда для открытия Antigravity