Modul 1: Produktivitas SDLC 75 menit¶

Sesi Antigravity CLI nyata pertama Anda. Modul ini mencakup alur kerja utama sehari-hari — memahami kode, melakukan refactoring, membuat pengujian, dan meninjau perubahan — ditambah cara memperluas CLI dengan plugin untuk toolchain tim Anda.

1.0 — Sesi Interaktif Pertama 5 menit¶

Luncurkan Antigravity CLI di direktori proyek lokakarya Anda:

cd agy-cli-field-workshop
agy

Anda akan masuk ke prompt interaktif. Coba:

> What files are in this project and what does each one do?

Perhatikan bagaimana agy membaca ruang kerja Anda — ia mengindeks repositori git, membaca isi file, dan merespons dengan konteks. Ini otomatis: tidak ada konfigurasi, tidak ada prompt yang harus ditulis terlebih dahulu.

1.1 — Pemahaman Kode 10 menit¶

Pola: Jelaskan Sebelum Anda Menyentuh — pahami kode sebelum mengubahnya.

Latihan: Memetakan Basis Kode yang Belum Dikenal¶

# -i seeds the session with an initial prompt and stays interactive
agy -i "Give me a high-level architecture overview of this project. What are the main components and how do they connect?"

Kemudian tindak lanjuti secara interaktif:

> Which file handles the entry point?
> What external dependencies does this project have?
> Are there any obvious code smells or tech debt?

1.2 — Refactoring 10 min¶

Pola: Usulkan, Tinjau, Terapkan — jangan pernah menerapkan perubahan yang belum Anda baca.

Latihan: Refactoring Bertarget¶

agy

> I want to refactor the error handling in this project. First, show me all the places where errors are currently caught or returned — don't change anything yet.

Tinjau temuan tersebut. Kemudian:

> Now propose a refactored version of [specific function] using a consistent error handling pattern. Show me the diff before applying.

Terapkan hanya setelah Anda membaca perubahan yang diusulkan.

Model Izin¶

agy memiliki model izin 3 tingkat yang mengontrol bagaimana ia menangani persetujuan alat:

Gunakan perintah garis miring /permissions untuk melihat atau mengubah tingkat saat ini. Anda juga dapat menetapkan aturan terperinci di settings.json:

{
  "permissions": {
    "allow": ["command(git)", "read_file"],
    "deny": ["command(rm -rf)"]
  }
}

📖 Detail lengkap: Dokumentasi Izin · Dokumentasi Mode Ketat

1.3 — Pembuatan Pengujian 10 min¶

Pola: Uji Apa yang Ada — buat pengujian untuk kode nyata, bukan hipotetis.

Latihan: Buat Pengujian Unit¶

agy

> Look at [specific function or file]. Generate a comprehensive unit test suite for it. Include happy path, edge cases, and error conditions. Use the testing framework already in this project.

Kemudian:

> Run the tests and fix any that fail.

1.4 — Tinjauan Kode 10 min¶

Pola: Tinjauan Pra-Komit — gunakan agy sebagai peninjau senior sebelum setiap push.

Latihan: Tinjau Perubahan Anda¶

# Stage some changes (or use an existing branch)
git add -p

# Start agy and review what's staged
agy

> Review my staged changes for: (1) correctness, (2) security issues, (3) missing test coverage, (4) anything that would block a PR. Be direct — don't soften findings.

Varian Headless (untuk pembuatan skrip)¶

# Review changes non-interactively — useful in pre-commit hooks or CI
git diff --cached | agy --print "Review these changes. Flag any bugs, security issues, or missing tests. Output as markdown."

1.5 — Konteks Proyek dengan AGENTS.md 5 menit¶

Pola: Konteks Persisten — beri tahu agy sekali, ia akan mengingatnya di setiap sesi.

agy membaca file konteks saat sesi dimulai. Buat satu di root proyek:

cat > AGENTS.md << 'EOF'
# Project Context

This is a Node.js REST API built with Express and TypeScript.

## Key Conventions
- Language: TypeScript (strict mode, no `any`)
- Testing: Jest with 80% coverage minimum; run `npm test` to validate
- Style: ESLint + Prettier; run `npm run lint` before committing
- DO NOT modify `src/db/migrations/` — those are append-only
- DO NOT use `console.log` in production code; use the `logger` utility

## Architecture
Three-layer: `routes/` → `services/` → `repositories/`. All DB access goes through the repository layer. External HTTP calls go through `src/clients/`.

## Common Commands
- `npm run dev` — start local dev server on :3000
- `npm test` — run full test suite
- `npm run db:migrate` — apply pending DB migrations
EOF

Sekarang mulai sesi baru:

agy --print "What do you know about this project?"

agy akan memasukkan AGENTS.md Anda ke dalam setiap sesi berikutnya secara otomatis.

Sumber Konteks Tambahan¶

Selain AGENTS.md, agy juga memuat:

• .agents/rules.md (atau .agents/rules/*.md) — aturan tingkat proyek yang disuntikkan sebagai arahan prompt sistem. Gunakan ini untuk persyaratan mutlak seperti "jangan pernah menghapus file migrasi" atau "selalu gunakan mode ketat TypeScript."
• .gemini/ — untuk kompatibilitas Gemini CLI, agy membaca direktori .gemini/ bersama dengan .agents/.
• ~/.gemini/config/rules.md — aturan global yang diterapkan ke semua sesi.

📖 Detail lengkap: Dokumentasi Aturan & Alur Kerja

Contoh Definisi Agen (di samples/agents/)¶

1.6 — Navigasi Interaktif 5 min¶

Pola: Kelancaran Terminal — ketahui pintasan yang membuat sesi agy menjadi cepat. 📖 Referensi lengkap: Menggunakan Antigravity CLI

Perintah Slash Utama¶

📖 Referensi lengkap perintah slash: Fitur CLI

Tips Cepat¶

📖 Referensi lengkap keybinding: Menggunakan Antigravity CLI

1.7 — Perluas dengan Plugin 15 menit¶

Pola: Bawa Toolchain Anda — plugin menambahkan skill, server MCP, agen, dan aturan ke agy. Instal sekali, tersedia di setiap sesi.

Sistem plugin Antigravity CLI melakukan sesuatu yang unik: sistem ini dapat mengimpor plugin yang telah Anda instal di Gemini CLI — tanpa perlu menginstal ulang atau mengonfigurasi ulang. Investasi Anda yang sudah ada akan terbawa.

Lihat Apa yang Aktif¶

agy plugin list

Menampilkan nama setiap plugin, sumber, tanggal impor, dan komponen (skill, perintah, mcpServers, agen).

Impor dari Gemini CLI¶

agy plugin import gemini

agy memindai instalasi Gemini CLI lokal Anda, menemukan semua plugin yang terinstal, dan menyiapkan komponennya ke dalam ~/.gemini/antigravity/. Output:

  [ok]    code-review
          ✔ skills      : 3 processed
          ✔ commands    : 2 processed
          - mcpServers  : skipped (not found)
  [ok]    gemini-deep-research
          ✔ commands    : 1 processed
          ✔ mcpServers  : 1 processed
  [skip]  superpowers (already imported)

agy plugin import gemini --force

What Gets Imported¶

Enable / Disable Per-Project¶

Not every plugin is appropriate for every codebase:

# Nonaktifkan untuk proyek ini
agy plugin disable gemini-deep-research

# Aktifkan kembali
agy plugin enable gemini-deep-research

Plugin Locations¶

Building a Custom Plugin¶

A valid agy plugin needs a plugin.json manifest:

my-plugin/
├── plugin.json          ← wajib
├── mcp_config.json      ← definisi server MCP (opsional)
├── hooks.json           ← penangan peristiwa hook (opsional)
├── skills/              ← berkas SKILL.md (opsional)
│   └── my-skill/
│       └── SKILL.md
├── agents/              ← definisi sub-agen (opsional)
└── rules/               ← berkas aturan (opsional)
    └── my-rules.md

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "Plugin agy kustom saya",
  "components": ["skills"]
}

Validate it before shipping:

agy plugin validate ./my-plugin
# ✔ Manifes plugin valid

📖 Referensi lengkap: Plugin · Panduan Migrasi

Latihan Modul 1¶

Modul Selanjutnya¶

→ Modul 2: Modernisasi Basis Kode Legacy — mode ketat, orientasi mandiri agen, sub-agen, dan /rewind sebagai jaring pengaman Anda.