gemini-howto

Google Antigravity & Gemini: Practical How-To Guide

A visual, example-driven curriculum from everyday prompts to multi-agent /boost & /teamwork-preview orchestration, Generative UI artifacts, OS-sandboxed hooks, native plugins, and the Python SDK.

English | Tiếng Việt

Quick Start • Learning Roadmap • Quick Reference • Template Catalog • Concepts Guide • Topic Index

Why This Repository Exists

Most developers use only a fraction of Google Antigravity and Gemini—typing free-form chat prompts while missing the customization primitives and autonomous orchestration engines that turn Antigravity into a programmable engineering platform:

• Progressive-Disclosure Rules & Memory (GEMINI.md, AGENTS.md, .agents/rules/*.md with always_on, model_decision, glob, and manual triggers inside a 20,000-token budget)
• Dual-Mode Agent Skills (.agents/skills/<name>/SKILL.md that work simultaneously as /<name> slash commands and semantically auto-discovered capabilities)
• Worktree-Isolated Subagents (research, browser, self, and custom .agents/agents/*.md running in parallel across inherit, branch, or share workspaces)
• Deterministic Lifecycle Hooks (.agents/hooks.json intercepting SessionStart, PreToolUse, PostToolUse, PreInvocation, PostInvocation, and Stop)
• Rich Artifacts, Generative UI & Sidecars (Implementation Plans with inline review comments, theme-aware <agent-embed> HTML widgets, and sidecar.json cron automations)
• Frontier Multi-Agent Modes (/boost 3-phase deep reasoning, /teamwork-preview autonomous engineering teams with adversarial Critic/Challenger/Auditor gates, and /goal)

Every module in this repository includes Mermaid architecture diagrams, production-ready copy-paste templates, Do's and Don'ts, and interactive quizzes.

Interactive Self-Assessment & Quizzes (Built Into This Repo!)

When you open this repository in the Antigravity App or Antigravity CLI (agy), two interactive skills in .agents/skills/ are automatically available:

/self-assessment        # Take a 10-question diagnostic to get a personalized learning path
/lesson-quiz 01         # Test your mastery of any module (01 through 10) with a 5-question quiz

[!TIP] Both skills use Antigravity's native interactive ask_question UI modal—giving you clickable multiple-choice options and instant architectural explanations.

Ecosystem Architecture Overview

flowchart TB
    subgraph Surfaces["Multi-Surface Antigravity Ecosystem"]
        App["Antigravity App v2.24<br/>(Desktop & Web)"]
        CLI["Antigravity CLI v1.4<br/>(agy TUI & -p Headless)"]
        IDE["IDE Extensions & Antigravity IDE<br/>(VS Code, JetBrains, Zed, Xcode)"]
        SDK["Python SDK v0.1.22<br/>(google-antigravity)"]
    end

    subgraph Core["Agent Runtime & Frontier Models"]
        Models["Gemini 4 Argon • Gemini 3.8 Flash • Gemini 3.1 Pro • Nano Banana 2 • Gemma 4 (LiteRT)"]
        Modes["Execution Modes: Interactive • /plan • /goal • /boost (3-Phase) • /teamwork-preview (2-Phase)"]
    end

    subgraph Customizations["Workspace (.agents/) & Global (~/.gemini/config/) Customizations"]
        Rules["02. Rules & Memory<br/>GEMINI.md, AGENTS.md,<br/>.agents/rules/*.md"]
        Skills["01 & 03. Skills & /Commands<br/>.agents/skills/<name>/SKILL.md"]
        Agents["04. Subagents<br/>.agents/agents/*.md<br/>(inherit | branch | share)"]
        MCP["05. MCP Servers<br/>mcp_config.json<br/>(Stdio & Streamable HTTP)"]
        Hooks["06. Lifecycle Hooks<br/>.agents/hooks.json<br/>(6 Lifecycle Events)"]
        Plugins["07. Native Plugins<br/>plugin.json Bundles"]
    end

    subgraph StateAndSafety["State, Visual Output & Kernel Security"]
        Artifacts["08. Checkpoints, Implementation Plans,<br/>Generative UI (<agent-embed>) & Sidecars"]
        Sandbox["09. Permissions (Deny > Ask > Allow)<br/>& OS Sandbox (Seatbelt / nsjail / AppContainer)"]
    end

    Surfaces --> Core
    Core --> Customizations
    Core --> StateAndSafety

The 10-Module Curriculum

Coming from Claude Code? Quick Translation Matrix

If you previously used Claude Code (claude-howto), here is how every concept maps—and upgrades—in Google Antigravity & Gemini:

5-Minute Quick Start

1. Install Antigravity CLI (agy) & Python SDK

# macOS / Linux — Install Antigravity CLI (v1.4.0+)
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Windows (PowerShell)
irm https://antigravity.google/cli/install.ps1 | iex

# Optional: Install the Google Antigravity Python SDK (v0.1.22+)
pip install google-antigravity

2. Clone This Repository & Take the Diagnostic

git clone https://github.com/minhxuvi/gemini-howto.git
cd gemini-howto

# Launch Antigravity CLI in this workspace
agy

Inside the Antigravity prompt (App or CLI), run:

/self-assessment

3. Copy Your First Production Templates Into Your Own Project

# 1. Copy the workspace GEMINI.md & modular rules into your project
cp 02-memory/project-GEMINI.md /path/to/your-project/GEMINI.md
mkdir -p /path/to/your-project/.agents/rules
cp 02-memory/rules/*.md /path/to/your-project/.agents/rules/

# 2. Add a custom /optimize slash-command skill
mkdir -p /path/to/your-project/.agents/skills/optimize
cp 01-slash-commands/optimize.md /path/to/your-project/.agents/skills/optimize/SKILL.md

# 3. Add a read-only Security Reviewer subagent
mkdir -p /path/to/your-project/.agents/agents
cp 04-subagents/secure-reviewer.md /path/to/your-project/.agents/agents/

# 4. Enable secret-scanning & auto-formatting lifecycle hooks
cp 06-hooks/hooks.json /path/to/your-project/.agents/hooks.json
mkdir -p /path/to/your-project/.agents/hooks
cp 06-hooks/*.sh 06-hooks/*.py /path/to/your-project/.agents/hooks/
chmod +x /path/to/your-project/.agents/hooks/*.sh /path/to/your-project/.agents/hooks/*.py

Choose Your Learning Track

Not sure where to begin? Pick the track that matches your role, or see the full Learning Roadmap:

1. Track A — Everyday Productive Developer (~2 hours):
   • Module 01: Slash Commands → Module 02: Rules & Memory → Module 08: Checkpoints, Artifacts & Sidecars
2. Track B — Workflow & Team Automator (~3.5 hours):
   • Module 03: Agent Skills → Module 04: Subagents → Module 05: MCP → Module 06: Lifecycle Hooks
3. Track C — Staff / Platform Architect (~4 hours):
   • Module 07: Native Plugins → Module 09: Advanced Features (/boost, /teamwork-preview, Sandbox) → Module 10: CLI & Python SDK

Reference Guides in This Repository

• LEARNING-ROADMAP.md — Visual dependency graphs, time estimates, and milestone checklists.
• QUICK_REFERENCE.md — Single-page cheat sheet for every slash command, frontmatter field, hook JSON schema, permission rule, and CLI flag.
• CATALOG.md — Browse and copy all 50+ ready-to-use templates across Modules 01–10.
• gemini_concepts_guide.md — Deep architectural mental models: how Antigravity assembles the context window, when to choose a Rule vs Skill vs Subagent vs Hook vs Plugin, and how /boost and /teamwork-preview coordinate multi-agent verification.
• INDEX.md — Alphabetical and problem-oriented index ("How do I block git push --force?", "How do I run Gemma 4 offline?").

License

Distributed under the MIT License.