Technical Documentation: vudovn/antigravity-kit

ℹ️ Provenance: Multi-Tier Ingestion · CodeWiki Reference

Overview (`README.md`) Copy Section

AG KIT

Production profile Copy Chapter

AG Kit installs a complete .agents/ workspace contract. Antigravity is the supported production runtime for this release. Other tools may read the Markdown components, but runtime behavior outside Antigravity is not part of the production compatibility guarantee.

The native hook is deliberately narrow. It blocks root-filesystem deletion, drive formatting, and raw-disk overwrite patterns while allowing normal project cleanup such as deleting dist/ or node_modules/. It does not replace Antigravity permissions, workspace trust, sandboxing, or human approval.

Requirements Copy Chapter

• Node.js 22 or newer for repository-level Antigravity tooling.
• Python 3.10 or newer for AG Kit validators and utility scripts.
• A trusted Google Antigravity workspace.
• Git for safe update, review, and rollback workflows.

The published CLI currently supports Node.js 18 or newer; the Antigravity integration checks run on Node.js 22.

Quick start Copy Chapter

Install into a project Copy Section

npx @vudovn/ag-kit init

Or install the CLI globally:

npm install @vudovn/ag-kit
ag-kit init

Do not add .agents/ to the project .gitignore when Antigravity needs to index rules, skills, or workflows. To keep it local without disabling discovery, add .agents/ to .git/info/exclude instead.

Verify the workspace Copy Section

npm run check:agents
npm run check:antigravity
npm run test:antigravity

check:antigravity is read-only. The default MCP example contains YOUR_API_KEY, so the normal doctor reports a warning until the example is configured. Use strict mode only after all placeholders have been resolved:

node .agents/hooks/antigravity-doctor.mjs --strict

Open in Antigravity Copy Section

After opening the repository as a trusted workspace:

1. Confirm slash commands such as /plan, /coordinate, and /orchestrate are discovered.
2. Confirm relevant skills are selected from .agents/skills/.
3. Run a normal command such as npm test and confirm it is allowed.
4. Verify the safety hook with a mocked payload rather than executing a destructive command:

printf '%s' '{"tool_args":{"CommandLine":"rm -rf /"}}' \
  | node .agents/hooks/validate-tool-call.mjs

The command must exit non-zero and print BLOCKED by AG Kit.

Safe updates and rollback Copy Chapter

AG Kit updates are merge-aware. User-owned files and locally modified managed files are preserved by default.

ag-kit update --dry-run          # Preview the exact plan
ag-kit update                    # Merge safely and create a backup
ag-kit update --strategy replace # Explicit full replacement, still backed up
ag-kit rollback                  # Restore the newest pre-update backup

Update metadata is stored in .agents/.ag-kit/. Backups are stored in .ag-kit-backups/ outside the managed toolkit tree. Read MIGRATION.md before upgrading an existing installation to the Antigravity-native release.

Antigravity-native integration Copy Chapter

Runtime contract Copy Section

.agents/antigravity.json declares the six supported integration phases and the documented Antigravity CLI capabilities used by AG Kit. It avoids inventing a minimum semantic version when upstream documentation does not define one.

Native safety hook Copy Section

Antigravity loads .agents/hooks.json, which registers:

{
  "enabled": true,
  "PreToolUse": [
    {
      "matcher": "run_command",
      "command": "node .agents/hooks/validate-tool-call.mjs",
      "timeout": 10
    }
  ]
}

To temporarily disable the AG Kit hook while diagnosing a compatibility issue, set "enabled": false, reopen the workspace, and report the payload shape privately if it may contain sensitive data. Do not delete Antigravity's own permission controls.

MCP configuration Copy Section

Review the workspace MCP plan without writing to the home directory:

node .agents/hooks/sync-mcp.mjs --check
node .agents/hooks/sync-mcp.mjs --print

After replacing placeholders, explicitly apply to one supported target:

node .agents/hooks/sync-mcp.mjs --apply --target suite
node .agents/hooks/sync-mcp.mjs --apply --target cli

Existing servers with the same name are preserved unless --force is supplied. A timestamped backup is created before an existing target file is changed. Never commit real MCP credentials.

Build and inspect the plugin Copy Section

npm run build:antigravity-plugin

Review dist/antigravity-plugin/ before local installation. The bundle contains packaged skills, agents, rules, converted workflow commands, the native hook, an MCP example, and PLUGIN_CONTENTS.json with SHA-256 entries.

agy plugin install ./dist/antigravity-plugin
agy plugin list

Plugin installation is optional; the repository-native .agents/ workspace remains the source of truth for project development.

Included components Copy Chapter

Every agent, skill, workflow, and rule has a SemVer contract. .agents/manifest.json, .agents/manifest.lock.json, and .agents/DEPENDENCY_GRAPH.md make the managed toolkit reproducible and detect drift.

npm run generate:agents
npm run check:agents

Common workflows Copy Chapter

Release and production gates Copy Chapter

A release candidate is not production-approved until all automated checks and the hands-on Antigravity smoke test in PRODUCTION_CHECKLIST.md are complete.

Required GitHub checks:

• Toolkit validation
• CLI tests and package validation
• Web lint, typecheck, build, and audit
• Antigravity native contract
• Dependency Review

AG Kit never requires automatic merge, automatic deployment, or automatic MCP synchronization. Production changes should remain reviewable and reversible.

Documentation Copy Chapter

• Antigravity implementation details
• Migration guide
• Production release checklist
• Security policy and runtime threat model
• Agent flow architecture
• Toolkit architecture
• Changelog
• Release setup

References and attribution Copy Chapter

AG Kit is an original open-source implementation of Markdown-based agent engineering patterns. No proprietary source files are included. Runtime integration decisions are based on public Antigravity documentation and codelabs linked in .agents/hooks/README.md.

Support the project Copy Chapter

License Copy Chapter

Released under the MIT License © Vudovn.

Overview (`.agents/README.md`) Copy Section

AG Kit toolkit operator guide

AG Kit is a modular .agents/ toolkit for Google Antigravity. It routes software-engineering work to specialist roles, progressively loads focused skills, preserves durable project context, and verifies changes with executable checks.

Runtime contract Copy Chapter

Antigravity is the primary production runtime. The machine-readable contract is .agents/antigravity.json and covers six phases:

1. rules, skills, and workflow discovery;
2. MCP configuration and explicit synchronization;
3. native lifecycle hooks and command safety;
4. agent/subagent orchestration;
5. optional plugin packaging;
6. validation and production smoke testing.

See hooks/README.md for the implementation and security boundaries.

Quick start Copy Chapter

From the project root:

npm run check:agents
npm run check:antigravity
npm run test:antigravity

Open the repository as a trusted Antigravity workspace. The runtime should discover:

• rules/*.md as workspace constraints;
• skills/*/SKILL.md as progressively loaded domain context;
• workflows/*.md as slash commands;
• agent/*.md as specialist role definitions;
• memory/ as durable project context.

Use /coordinate for separable parallel research/review work and /orchestrate for plan approval followed by specialist implementation. Antigravity /agents and /tasks remain the runtime source of truth.

Native safety hook Copy Chapter

.agents/hooks.json registers a PreToolUse gate for run_command. The policy blocks only high-confidence root/disk destructive patterns. It does not replace Antigravity permissions, workspace trust, sandboxing, or user approval.

Test with mocked stdin only:

printf '%s' '{"tool_args":{"CommandLine":"rm -rf /"}}' \
  | node .agents/hooks/validate-tool-call.mjs

The process must exit non-zero. To diagnose a compatibility issue, set "enabled": false temporarily and reopen the workspace.

MCP setup Copy Chapter

mcp_config.json is a workspace example. Replace YOUR_API_KEY before enabling the server and keep real credentials outside version control.

node .agents/hooks/sync-mcp.mjs --check
node .agents/hooks/sync-mcp.mjs --print

No home-directory file is changed without --apply. Existing server names are preserved unless --force is explicit, and an existing target is backed up before writing.

Plugin bundle Copy Chapter

npm run build:antigravity-plugin

Review dist/antigravity-plugin/ and its PLUGIN_CONTENTS.json inventory before optional local installation. The repository .agents/ directory remains the source of truth.

Core concepts Copy Chapter

• Agents define role, boundaries, tools, and skill dependencies.
• Skills contain selectively loaded domain knowledge and optional executable scripts.
• Rules define workspace-wide precedence, safety, and routing behavior.
• Workflows provide reusable slash-command procedures.
• Memory stores durable project conventions, preferences, decisions, and feedback.
• Hooks supplement runtime permissions with narrow policy checks.
• Runtime scripts turn guidance into repeatable evidence.
• Manifest and lock make managed components and runtime tooling reproducible.

Validation Copy Chapter

Validate a target project:

python .agents/scripts/checklist.py .

Run full project verification when a preview URL exists:

python .agents/scripts/verify_all.py . --url http://localhost:3000

Verify AG Kit itself after editing agents, skills, rules, workflows, memory, runtime tooling, schemas, scripts, or links:

npm run generate:agents
npm run check:agents
npm run check:antigravity
npm run test:antigravity

Documentation Copy Chapter

• Architecture and inventory
• Antigravity integration
• Dependency graph
• Runtime scripts
• Root migration guide
• Production checklist
• Security policy
• Change history
• Quick routing reference

Overview (`cli/README.md`) Copy Section

AG Kit CLI

CLI for installing and safely updating AG Kit, a collection of agents, skills, workflows, rules, memory conventions, and validation tools for Google Antigravity.

Installation Copy Chapter

npx @vudovn/ag-kit init

Or install globally:

npm install @vudovn/ag-kit
ag-kit init

Commands Copy Chapter

Safe update model Copy Chapter

AG Kit records SHA-256 baselines in .agents/.ag-kit/manifest.json. During an update it compares the previous upstream version, the current local file, and the new upstream file.

• Clean managed files are updated automatically.
• Files changed only locally are preserved.
• User-created files are preserved.
• Files changed both locally and upstream are reported as conflicts.
• Incoming conflict copies are written under .agents/.ag-kit/conflicts/.
• A full pre-update backup is stored under .ag-kit-backups/ by default.

ag-kit update --dry-run
ag-kit update --strategy merge
ag-kit update --strategy replace
ag-kit rollback
ag-kit rollback --backup 20260712-090000-000

merge is the default strategy. replace is intentionally explicit and still creates a backup unless --no-backup is supplied.

Common options Copy Chapter

ag-kit init --path ./myapp
ag-kit init --branch dev
ag-kit update --force
ag-kit update --quiet --force
ag-kit update --conflict-report ./ag-kit-update.json
ag-kit rollback --dry-run

When --quiet is used against an existing installation, --force is required because the CLI cannot safely ask for confirmation.

Included toolkit Copy Chapter

• 20 specialist agents
• 47 skills
• 13 workflows
• Shared rules, persistent memory conventions, MCP configuration, and validation scripts

Exit codes Copy Chapter

License Copy Chapter

MIT

Overview (`web/README.md`) Copy Section

AG Kit - Web Application

⚡ Quick Start (Local Development) Copy Chapter

The web/ directory contains the official online documentation site and interactive dashboard portal built using Next.js 16 and React 19.

1. Install dependencies:

   bash Copy

   npm install

2. Run local development server:

   bash Copy

   npm run dev

3. Open browser:
   Navigate to http://localhost:3000 to view the documentation portal locally.

🏗️ Architecture & Stack Copy Chapter

• Framework: Next.js 16 (App Router)
• Library: React 19
• Styling: Tailwind CSS v4
• MDX: @next/mdx for seamless markdown integration
• Components: Built with @base-ui/react and Lucide React icons

📦 What gets installed by the CLI Copy Chapter

When downstream developers run npx @vudovn/ag-kit init, they install a .agents/ folder at their project root:

📚 Online Documentation Copy Chapter

• Official Documentation Portal
• GitHub Repository

☕ Support the Project Copy Chapter

If AG Kit has made your AI programming sessions more productive, consider supporting the project:

Vietnamese Bank (MBBank QR):

📄 License Copy Chapter

Released under the MIT License © Vudovn.

Overview (`.agents/hooks/README.md`) Copy Section

AG Kit — Antigravity Native Integration

AG Kit now treats Google Antigravity as its primary runtime. The integration is intentionally built from Antigravity's workspace-native conventions instead of a cross-runtime abstraction.

What is active Copy Chapter

Quick verification Copy Chapter

node .agents/hooks/antigravity-doctor.mjs
node --test .agents/hooks/tests/antigravity.test.mjs

The doctor checks the installed workspace without changing files. Use --json for machine-readable output and --strict to treat unresolved configuration placeholders as failures.

Native safety hook Copy Chapter

Antigravity reads .agents/hooks.json. AG Kit registers one native hook:

{
  "enabled": true,
  "PreToolUse": [
    {
      "matcher": "run_command",
      "command": "node .agents/hooks/validate-tool-call.mjs",
      "timeout": 10
    }
  ]
}

The policy blocks only high-confidence destructive operations such as deleting a filesystem root, formatting a drive, or overwriting a raw disk. It deliberately allows normal cleanup such as deleting dist/ or node_modules/.

The hook is not a sandbox and does not replace Antigravity's permission settings. Invalid or unknown payload shapes fail open with a warning to prevent a runtime-wide lockout after upstream payload changes.

MCP setup Copy Chapter

Antigravity CLI supports workspace MCP configuration at .agents/mcp_config.json. Antigravity IDE and the wider suite may also use a shared global configuration.

Inspect the merge plan:

node .agents/hooks/sync-mcp.mjs --check
node .agents/hooks/sync-mcp.mjs --print

Apply only after replacing placeholders such as YOUR_API_KEY:

node .agents/hooks/sync-mcp.mjs --apply --target suite
node .agents/hooks/sync-mcp.mjs --apply --target cli

The helper never overwrites an existing server with the same name unless --force is supplied. It creates a timestamped backup before writing.

Orchestration Copy Chapter

AG Kit uses the existing Antigravity-native workflows:

• /coordinate for parallel read/research and synthesis;
• /orchestrate for plan approval followed by specialist implementation;
• .agents/agent/*.md as role definitions;
• coordinator-mode, parallel-agents, intelligent-routing, and verify-changes as orchestration skills.

Antigravity's /agents and /tasks views remain the runtime source of truth for active work. AG Kit does not create a second scheduler.

Build a plugin bundle Copy Chapter

node .agents/hooks/build-plugin.mjs
# or
npm run build:antigravity-plugin

The generated dist/antigravity-plugin/ contains:

• a gemini-extension.json compatible manifest used by Antigravity CLI's plugin importer;
• packaged skills and specialist definitions;
• workflows converted into namespaced command TOML files;
• rules, native hooks, and an MCP example;
• PLUGIN_CONTENTS.json with deterministic SHA-256 inventory data.

Install the local build after reviewing it:

agy plugin install ./dist/antigravity-plugin
agy plugin list

Security boundaries Copy Chapter

• No MCP configuration is copied to the home directory without explicit --apply.
• Placeholder credentials block MCP application.
• The plugin builder does not include secrets from environment variables or home-directory configuration.
• The hook only reads one tool payload from stdin and performs no network calls.
• AG Kit does not weaken Antigravity permission prompts or workspace trust controls.

Release and operations Copy Chapter

• Root README — installation and production quick start.
• Migration guide — upgrade and rollback from earlier AG Kit versions.
• Production checklist — automated and hands-on release gates.
• Security policy — threat model, incident handling, and hook recovery.

Primary Antigravity references Copy Chapter

• Workspace rules and workflows: https://codelabs.developers.google.com/antigravity-ide
• Workspace skills: https://codelabs.developers.google.com/antigravity-skills
• Workspace MCP: https://codelabs.developers.google.com/antigravity-cli
• Native PreToolUse hooks: https://codelabs.developers.google.com/secure-agentic-coding
• Plugin installation: https://codelabs.developers.google.com/antigravity-cli-plugins and https://codelabs.developers.google.com/antigravity-conductor

Overview (`.agents/scripts/README.md`) Copy Section

AG Kit Runtime Scripts

Entry points Copy Chapter

`validate_kit.py` Copy Section

Self-validates the .agents/ package. It checks JSON, strict SemVer frontmatter, workflow/agent/skill references, manifest and lock synchronization, generated dependency docs, memory contracts, local Markdown links, Python syntax, referenced script paths, and documented inventory counts.

python .agents/scripts/validate_kit.py
python .agents/scripts/validate_kit.py --json

`generate_manifest.py` Copy Section

Builds deterministic manifest.json and manifest.lock.json files from component frontmatter. Use --check in CI to fail on registry drift.

python .agents/scripts/generate_manifest.py
python .agents/scripts/generate_manifest.py --check

`dependency_graph.py` Copy Section

Builds DEPENDENCY_GRAPH.md from workflow and agent dependencies. Use --check to verify that the generated graph is current.

python .agents/scripts/dependency_graph.py
python .agents/scripts/dependency_graph.py --check

`checklist.py` Copy Section

Runs the fast project validation path. URL checks are automatically skipped when --url is not supplied.

python .agents/scripts/checklist.py .
python .agents/scripts/checklist.py . --url http://localhost:3000
python .agents/scripts/checklist.py . --report .agents/reports/checklist.json

`verify_all.py` Copy Section

Runs the broad release suite. --no-runtime excludes Lighthouse and Playwright; --no-e2e excludes Playwright only.

python .agents/scripts/verify_all.py . --no-runtime
python .agents/scripts/verify_all.py . --url http://localhost:3000 --report verification.json

`session_manager.py` Copy Section

Prints project type, package metadata, feature hints, and file counts.

python .agents/scripts/session_manager.py status .

`auto_preview.py` Copy Section

Starts, stops, or inspects a detected local preview server.

python .agents/scripts/auto_preview.py start 3000
python .agents/scripts/auto_preview.py status
python .agents/scripts/auto_preview.py stop

Runtime prerequisites Copy Chapter

Most scripts use only the Python standard library. Optional checks require the corresponding project tools:

• Lighthouse: npm install lighthouse
• Playwright: pip install playwright && playwright install chromium
• Node lint/test commands: project package manager and configured scripts
• Python lint/test commands: project-configured tools such as Ruff, MyPy, or pytest

Missing URL-based tools produce a failed runtime check rather than a false pass. Missing non-applicable build outputs are reported as skipped/pass with an explanatory message.

Exit-code contract Copy Chapter

• 0: check passed or was not applicable
• 1: findings met the configured failure threshold
• 2: invalid command usage or missing input path

The master runners use subprocess exit codes as the source of truth and can emit a full JSON report with commands, durations, stdout, stderr, and status.

Regression tests Copy Chapter

Toolkit scripts include regression tests for self-validation, component SemVer, manifest/lock integrity, dependency graph synchronization, memory contracts, security scanning, dependency and bundle analysis, and toolkit-root discovery.

python -m unittest discover -s .agents/scripts/tests -v

Web Src App Docs Antigravity Content.En (`web/src/app/docs/antigravity/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, FeatureGrid, Feature } from '@/components/mdx'

Antigravity Runtime Integration

Google Antigravity is AG Kit's production runtime. Beyond rules, skills, and workflows, the kit ships a native integration layer inside .agents/.

The runtime layer Copy Chapter

Tool safety hook Copy Chapter

hooks.json registers a native PreToolUse gate for run_command. It is deliberately narrow — it blocks high-confidence destructive patterns only:

• Unix root-filesystem deletion (rm -rf / and equivalents)
• Filesystem formatting and raw-disk overwrite (mkfs, writing to /dev/sdX)
• Windows drive formatting and forced root deletion

Normal project cleanup (deleting dist/, node_modules/) passes through.

MCP synchronization Copy Chapter

.agents/mcp_config.json is the workspace source for MCP servers. The sync helper applies it explicitly — it refuses placeholder credentials, preserves conflicting entries by default, and backs up the target before writing:

Antigravity Doctor Copy Chapter

The Doctor checks discovery, MCP, hooks, orchestration, plugin packaging, and release readiness — read-only:

Plugin bundle Copy Chapter

For teams who prefer a packaged install, the plugin builder produces a local Antigravity plugin bundle with a deterministic SHA-256 content inventory:

Web Src App Docs Antigravity Content.Vi (`web/src/app/docs/antigravity/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, FeatureGrid, Feature } from '@/components/mdx'

Tích hợp Runtime Antigravity

Google Antigravity là runtime production của AG Kit. Ngoài rules, skills và workflows, kit đi kèm lớp tích hợp native bên trong .agents/.

Lớp runtime Copy Chapter

Hook an toàn công cụ Copy Chapter

hooks.json đăng ký cổng PreToolUse native cho run_command. Nó cố tình hẹp — chỉ chặn các mẫu phá hủy có độ tin cậy cao:

• Xóa root filesystem Unix (rm -rf / và tương đương)
• Format filesystem và ghi đè raw-disk (mkfs, ghi vào /dev/sdX)
• Format ổ đĩa Windows và xóa root cưỡng bức

Dọn dẹp dự án bình thường (xóa dist/, node_modules/) vẫn đi qua bình thường.

Đồng bộ MCP Copy Chapter

.agents/mcp_config.json là nguồn cấu hình MCP của workspace. Trình đồng bộ áp dụng nó một cách tường minh — từ chối credential giữ chỗ, giữ nguyên mục xung đột theo mặc định, và sao lưu đích trước khi ghi:

Antigravity Doctor Copy Chapter

Doctor kiểm tra discovery, MCP, hooks, orchestration, đóng gói plugin và mức sẵn sàng phát hành — chỉ đọc:

Gói plugin Copy Chapter

Với đội muốn cài dạng đóng gói, trình build plugin tạo bundle plugin Antigravity cục bộ với inventory nội dung SHA-256 xác định:

Web Src App Docs Updates Content.En (`web/src/app/docs/updates/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, FeatureGrid, Feature } from '@/components/mdx'

Managed Updates & Rollback

AG Kit installs .agents/ as a managed tree: every kit file is tracked in a manifest with SHA-256 hashes, so updates know exactly what is yours and what is the kit's.

How the managed tree works Copy Chapter

Files you add or modify are not kit-managed, so the default merge strategy preserves them. Only files whose hash matches the manifest are updated in place.

Updating safely Copy Chapter

Rolling back Copy Chapter

• Defaults to the newest backup; pick one with --backup .
• The current tree is backed up before restoring (disable with --no-keep-current).
• Preview with --dry-run.

Web Src App Docs Updates Content.Vi (`web/src/app/docs/updates/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, FeatureGrid, Feature } from '@/components/mdx'

Cập nhật được quản lý & Rollback

AG Kit cài .agents/ dưới dạng cây được quản lý: mọi file của kit được theo dõi trong manifest với hash SHA-256, nên khi cập nhật hệ thống biết chính xác file nào của bạn, file nào của kit.

Cây được quản lý hoạt động thế nào Copy Chapter

File bạn thêm hoặc sửa không thuộc quản lý của kit, nên chiến lược mặc định merge sẽ giữ nguyên chúng. Chỉ những file có hash khớp manifest mới được cập nhật.

Cập nhật an toàn Copy Chapter

Rollback Copy Chapter

• Mặc định dùng bản sao lưu mới nhất; chọn bản khác với --backup .
• Cây hiện tại được sao lưu trước khi khôi phục (tắt bằng --no-keep-current).
• Xem trước với --dry-run.

Web Src App Docs Guide Examples Brainstorm Content.En (`web/src/app/docs/guide/examples/brainstorm/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

Structured Brainstorming

Explore multiple approaches before writing code with the /brainstorm workflow.

Overview Copy Chapter

The /brainstorm command activates a structured ideation mode.
Instead of jumping straight to code, the agent explores at least 3 different approaches,
analyzes pros and cons, and helps you make an informed decision.

The Process Copy Chapter

```bash
/brainstorm authentication system for my SaaS app
```

Example Session Copy Chapter

Option A: React Hook Form + Zod
  
    ✅ Minimal re-renders, great DX
    ❌ Learning curve
    📊 Effort: Low
  


  Option B: Zustand
  
    ✅ Full control, persists across routes
    ❌ More boilerplate
    📊 Effort: Medium

Pro Tips Copy Chapter

Next Steps Copy Chapter

• Try /brainstorm for your next architecture decision
• After deciding, use Add New Feature to implement

Web Src App Docs Guide Examples Brainstorm Content.Ja (`web/src/app/docs/guide/examples/brainstorm/content.ja.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

構造化ブレインストーミング

/brainstorm ワークフローで、コードを書く前に複数のアプローチを検討しましょう。

概要 Copy Chapter

/brainstorm コマンドは構造化されたアイデア出しモードを起動します。
いきなりコードに飛びつくのではなく、エージェントが少なくとも 3 種類の異なるアプローチを検討し、
それぞれの長所と短所を分析して、納得のいく意思決定を後押しします。

プロセス Copy Chapter

```bash
/brainstorm authentication system for my SaaS app
```

セッション例 Copy Chapter

選択肢 A: React Hook Form + Zod
  
    ✅ 再レンダリングが最小限、開発体験が優秀
    ❌ 学習コストがある
    📊 工数: 低
  


  選択肢 B: Zustand
  
    ✅ 完全に制御可能、ルート間で状態を保持
    ❌ ボイラープレートが増える
    📊 工数: 中

実践のヒント Copy Chapter

次のステップ Copy Chapter

• 次のアーキテクチャ判断で /brainstorm を試してみましょう
• 決めたら、新機能の追加で実装しましょう

Web Src App Docs Guide Examples Brainstorm Content.Vi (`web/src/app/docs/guide/examples/brainstorm/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

Động não có cấu trúc

Khám phá nhiều hướng tiếp cận trước khi viết code với quy trình /brainstorm.

Tổng quan Copy Chapter

Lệnh /brainstorm kích hoạt một chế độ phát ý tưởng có cấu trúc.
Thay vì lao thẳng vào code, tác tử khám phá ít nhất 3 hướng tiếp cận khác nhau,
phân tích ưu nhược điểm và giúp bạn ra quyết định sáng suốt.

Quy trình Copy Chapter

```bash
/brainstorm authentication system for my SaaS app
```

Phiên làm việc ví dụ Copy Chapter

Phương án A: React Hook Form + Zod
  
    ✅ Ít re-render, DX tuyệt vời
    ❌ Có đường cong học tập
    📊 Công sức: Thấp
  


  Phương án B: Zustand
  
    ✅ Toàn quyền kiểm soát, giữ trạng thái qua các route
    ❌ Nhiều code khuôn mẫu hơn
    📊 Công sức: Trung bình

Mẹo hay Copy Chapter

Bước tiếp theo Copy Chapter

• Thử /brainstorm cho quyết định kiến trúc tiếp theo của bạn
• Sau khi quyết định, dùng Thêm tính năng mới để triển khai

Web Src App Docs Guide Examples Brainstorm Content.Zh (`web/src/app/docs/guide/examples/brainstorm/content.zh.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

结构化头脑风暴

使用 /brainstorm 工作流，在动手写代码之前先探索多种方案。

概述 Copy Chapter

/brainstorm 命令会启动一种结构化的构思模式。
与其直接动手写代码，智能体会探索至少 3 种不同的方案，
分析各自的优缺点，帮助你做出明智的决策。

流程 Copy Chapter

```bash
/brainstorm authentication system for my SaaS app
```

示例会话 Copy Chapter

方案 A：React Hook Form + Zod
  
    ✅ 重渲染极少，开发体验出色
    ❌ 有一定学习曲线
    📊 工作量：低
  


  方案 B：Zustand
  
    ✅ 完全可控，跨路由保持状态
    ❌ 样板代码更多
    📊 工作量：中

实用技巧 Copy Chapter

后续步骤 Copy Chapter

• 在你的下一个架构决策中试试 /brainstorm
• 决定之后，用添加新功能来实现

Web Src App Docs Guide Examples Create Content.En (`web/src/app/docs/guide/examples/create/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, StatusList, StatusItem } from '@/components/mdx'

Create New Application

Build complete applications from scratch with the /create wizard.

Overview Copy Chapter

The /create command is your application creation wizard.
It guides you through an interactive dialogue, understands your requirements,
plans the architecture, and orchestrates specialist agents to build your app.

The Process Copy Chapter

```bash
/create e-commerce site with product listing and cart
```

Example Session Copy Chapter

Pro Tips Copy Chapter

Next Steps Copy Chapter

• Run /create followed by your app idea
• Use Add New Feature to extend

Web Src App Docs Guide Examples Create Content.Ja (`web/src/app/docs/guide/examples/create/content.ja.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, StatusList, StatusItem } from '@/components/mdx'

新しいアプリの作成

/create ウィザードで、完全なアプリケーションをゼロから構築しましょう。

概要 Copy Chapter

/create コマンドはあなたのアプリケーション作成ウィザードです。
対話形式のやり取りを通じて案内し、要件を理解し、
アーキテクチャを計画して、各専門エージェントを編成しアプリを構築します。

プロセス Copy Chapter

```bash
/create e-commerce site with product listing and cart
```

セッション例 Copy Chapter

実践のヒント Copy Chapter

次のステップ Copy Chapter

• /create の後にアプリのアイデアを続けて実行しましょう
• 新機能の追加で拡張しましょう

Web Src App Docs Guide Examples Create Content.Vi (`web/src/app/docs/guide/examples/create/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, StatusList, StatusItem } from '@/components/mdx'

Tạo ứng dụng mới

Xây dựng ứng dụng hoàn chỉnh từ đầu với trình hướng dẫn /create.

Tổng quan Copy Chapter

Lệnh /create là trình hướng dẫn tạo ứng dụng của bạn.
Nó dẫn dắt bạn qua một cuộc hội thoại tương tác, hiểu yêu cầu của bạn,
lập kế hoạch kiến trúc và điều phối các tác tử chuyên biệt để dựng ứng dụng.

Quy trình Copy Chapter

```bash
/create e-commerce site with product listing and cart
```

Phiên làm việc ví dụ Copy Chapter

Mẹo hay Copy Chapter

Bước tiếp theo Copy Chapter

• Chạy /create kèm theo ý tưởng ứng dụng của bạn
• Dùng Thêm tính năng mới để mở rộng

Web Src App Docs Guide Examples Create Content.Zh (`web/src/app/docs/guide/examples/create/content.zh.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, StatusList, StatusItem } from '@/components/mdx'

创建新应用

使用 /create 向导从零构建完整的应用。

概述 Copy Chapter

/create 命令是你的应用创建向导。
它会通过一段交互式对话引导你，理解你的需求，
规划架构，并编排各个专家智能体来构建你的应用。

流程 Copy Chapter

```bash
/create e-commerce site with product listing and cart
```

示例会话 Copy Chapter

实用技巧 Copy Chapter

后续步骤 Copy Chapter

• 运行 /create 并附上你的应用想法
• 用添加新功能来扩展

Web Src App Docs Guide Examples Debugging Content.En (`web/src/app/docs/guide/examples/debugging/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

Systematic Debugging

Solve complex issues using the rigorous /debug workflow.

Overview Copy Chapter

The /debug workflow enforces a 4-phase investigation protocol (Discovery, Hypothesis, Verification, Resolution). It prevents guess-driven development by requiring evidence before code changes.

The Process Copy Chapter

```bash
/debug Login returns 403 even with correct credentials
```

Example Session Copy Chapter

1. `emailRef.current` is null on mount
  2. Event handler not bound correctly

Pro Tips Copy Chapter

Next Steps Copy Chapter

• Try /debug on an existing bug
• See Deployment to ship your fix

Web Src App Docs Guide Examples Debugging Content.Ja (`web/src/app/docs/guide/examples/debugging/content.ja.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

体系的なデバッグ

厳密な /debug ワークフローで、複雑な問題を解決しましょう。

概要 Copy Chapter

/debug ワークフローは4 段階の調査プロトコル（発見、仮説、検証、解決）を徹底させます。コードを変更する前に証拠を求めることで、当て推量に頼った開発を防ぎます。

プロセス Copy Chapter

```bash
/debug Login returns 403 even with correct credentials
```

セッション例 Copy Chapter

1. `emailRef.current` が mount 時に null
  2. イベントハンドラが正しくバインドされていない

実践のヒント Copy Chapter

次のステップ Copy Chapter

• 既存のバグで /debug を試してみましょう
• 修正を出荷するにはデプロイを参照しましょう

Web Src App Docs Guide Examples Debugging Content.Vi (`web/src/app/docs/guide/examples/debugging/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

Gỡ lỗi có hệ thống

Giải quyết các vấn đề phức tạp với quy trình /debug chặt chẽ.

Tổng quan Copy Chapter

Quy trình /debug áp dụng một giao thức điều tra 4 giai đoạn (Khám phá, Giả thuyết, Kiểm chứng, Khắc phục). Nó ngăn lối phát triển dựa trên phỏng đoán bằng cách yêu cầu có bằng chứng trước khi thay đổi code.

Quy trình Copy Chapter

```bash
/debug Login returns 403 even with correct credentials
```

Phiên làm việc ví dụ Copy Chapter

1. `emailRef.current` là null khi mount
  2. Trình xử lý sự kiện chưa được gắn đúng

Mẹo hay Copy Chapter

Bước tiếp theo Copy Chapter

• Thử /debug với một lỗi có sẵn
• Xem Triển khai để phát hành bản sửa của bạn

Web Src App Docs Guide Examples Debugging Content.Zh (`web/src/app/docs/guide/examples/debugging/content.zh.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

系统化调试

使用严谨的 /debug 工作流解决复杂问题。

概述 Copy Chapter

/debug 工作流强制执行一套四阶段调查协议（发现、假设、验证、解决）。它要求在改动代码之前先拿出证据，从而避免靠猜测驱动的开发。

流程 Copy Chapter

```bash
/debug Login returns 403 even with correct credentials
```

示例会话 Copy Chapter

1. `emailRef.current` 在 mount 时为 null
  2. 事件处理器绑定不正确

实用技巧 Copy Chapter

后续步骤 Copy Chapter

• 在一个现有的 bug 上试试 /debug
• 查看部署以发布你的修复

Web Src App Docs Guide Examples Deployment Content.En (`web/src/app/docs/guide/examples/deployment/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

Production Deployment

Ship with confidence using the safety-first /deploy workflow.

Overview Copy Chapter

The /deploy command is an Audit & Release Conductor.
It forces your code to pass a rigorous health check before deployment.

The Process Copy Chapter

```bash
/deploy
```

<h4 className="text-sm font-semibold mb-1">🛡️ Security</h4>
    Scans for vulnerabilities & secrets
  
  
    <h4 className="text-sm font-semibold mb-1">📋 Quality</h4>
    Enforces Linting & Type Safety

Example Session Copy Chapter

🔄 Security Scan... PASSED
  🔄 Lint Check... PASSED
  🔄 Type Validation... PASSED


✅ All checks passed!
Deploying to Vercel...

🌐 URL: https://my-app.vercel.app
  💚 Health Check: OK

Pro Tips Copy Chapter

Next Steps Copy Chapter

• Try /deploy check to run pre-flight checks
• Learn about Multi-Agent Orchestration

Web Src App Docs Guide Examples Deployment Content.Ja (`web/src/app/docs/guide/examples/deployment/content.ja.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

本番環境へのデプロイ

安全第一の /deploy ワークフローで、自信を持ってリリースしましょう。

概要 Copy Chapter

/deploy コマンドは監査とリリースの指揮官です。
デプロイ前に、コードへ厳格なヘルスチェックを強制的に通過させます。

プロセス Copy Chapter

```bash
/deploy
```

<h4 className="text-sm font-semibold mb-1">🛡️ セキュリティ</h4>
    脆弱性とシークレットをスキャン
  
  
    <h4 className="text-sm font-semibold mb-1">📋 品質</h4>
    Linting と型安全性を強制

セッション例 Copy Chapter

🔄 セキュリティスキャン…… PASSED
  🔄 Lint チェック…… PASSED
  🔄 型の検証…… PASSED


✅ すべてのチェックを通過しました！
Vercel へデプロイ中……

🌐 URL: https://my-app.vercel.app
  💚 ヘルスチェック: OK

実践のヒント Copy Chapter

次のステップ Copy Chapter

• /deploy check を試して出発前チェックを実行しましょう
• マルチエージェントのオーケストレーションについて学びましょう

Web Src App Docs Guide Examples Deployment Content.Vi (`web/src/app/docs/guide/examples/deployment/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

Triển khai production

Phát hành tự tin với quy trình /deploy đặt an toàn lên hàng đầu.

Tổng quan Copy Chapter

Lệnh /deploy là một Nhạc trưởng Kiểm toán & Phát hành.
Nó buộc code của bạn phải vượt qua một kiểm tra sức khỏe nghiêm ngặt trước khi triển khai.

Quy trình Copy Chapter

```bash
/deploy
```

<h4 className="text-sm font-semibold mb-1">🛡️ Bảo mật</h4>
    Quét lỗ hổng & secret
  
  
    <h4 className="text-sm font-semibold mb-1">📋 Chất lượng</h4>
    Áp dụng Linting & An toàn kiểu

Phiên làm việc ví dụ Copy Chapter

🔄 Quét bảo mật... PASSED
  🔄 Kiểm tra Lint... PASSED
  🔄 Xác thực kiểu... PASSED


✅ Tất cả kiểm tra đã qua!
Đang triển khai lên Vercel...

🌐 URL: https://my-app.vercel.app
  💚 Kiểm tra sức khỏe: OK

Mẹo hay Copy Chapter

Bước tiếp theo Copy Chapter

• Thử /deploy check để chạy các kiểm tra trước khi bay
• Tìm hiểu về Điều phối đa tác tử

Web Src App Docs Guide Examples Deployment Content.Zh (`web/src/app/docs/guide/examples/deployment/content.zh.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

生产环境部署

使用安全优先的 /deploy 工作流，从容发布。

概述 Copy Chapter

/deploy 命令是一位审计与发布指挥官。
它会强制你的代码在部署前通过一轮严格的健康检查。

流程 Copy Chapter

```bash
/deploy
```

<h4 className="text-sm font-semibold mb-1">🛡️ 安全</h4>
    扫描漏洞与密钥
  
  
    <h4 className="text-sm font-semibold mb-1">📋 质量</h4>
    强制 Linting 与类型安全

示例会话 Copy Chapter

🔄 安全扫描…… PASSED
  🔄 Lint 检查…… PASSED
  🔄 类型校验…… PASSED


✅ 所有检查均已通过！
正在部署到 Vercel……

🌐 URL: https://my-app.vercel.app
  💚 健康检查: OK

实用技巧 Copy Chapter

后续步骤 Copy Chapter

• 试试 /deploy check 来运行起飞前检查
• 了解多智能体编排

Web Src App Docs Guide Examples New Feature Content.En (`web/src/app/docs/guide/examples/new-feature/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature, StatusList, StatusItem } from '@/components/mdx'

Add a New Feature

Learn how to safely add complex features to an existing codebase using the /enhance workflow.

Overview Copy Chapter

The /enhance workflow is your day-to-day tool for iterative development.
Unlike /create which builds from scratch, /enhance focuses on surgically adding functionality without breaking existing code.

The Process Copy Chapter

```bash
/enhance Add an analytics dashboard for user activity
Requirements:
- Track daily active users and page views
- Visual charts using Recharts
- API endpoint to aggregate data
```

<FeatureGrid cols={4}>
  <Feature title="Database" />
  <Feature title="Backend" />
  <Feature title="Frontend" />
  <Feature title="Testing" />
</FeatureGrid>

Example Session Copy Chapter

Found: Tailwind CSS with no dark mode config
  Plan: Update tailwind.config, add ThemeProvider, create toggle component

Pro Tips Copy Chapter

Next Steps Copy Chapter

• Try /enhance in your project
• See Test Generation for coverage

Web Src App Docs Guide Examples New Feature Content.Ja (`web/src/app/docs/guide/examples/new-feature/content.ja.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature, StatusList, StatusItem } from '@/components/mdx'

新機能の追加

/enhance ワークフローで、既存のコードベースに複雑な機能を安全に追加する方法を学びましょう。

概要 Copy Chapter

/enhance ワークフローは、日々の反復開発に使うツールです。
ゼロから構築する /create とは違い、/enhance は既存コードを壊さずに、外科手術のように機能を追加することに集中します。

プロセス Copy Chapter

```bash
/enhance Add an analytics dashboard for user activity
Requirements:
- Track daily active users and page views
- Visual charts using Recharts
- API endpoint to aggregate data
```

<FeatureGrid cols={4}>
  <Feature title="Database" />
  <Feature title="Backend" />
  <Feature title="Frontend" />
  <Feature title="Testing" />
</FeatureGrid>

セッション例 Copy Chapter

発見：Tailwind CSS に dark mode の設定がありません
  計画：tailwind.config を更新し、ThemeProvider を追加し、toggle コンポーネントを作成

実践のヒント Copy Chapter

次のステップ Copy Chapter

• あなたのプロジェクトで /enhance を試してみましょう
• カバレッジについてはテスト生成を参照しましょう

Web Src App Docs Guide Examples New Feature Content.Vi (`web/src/app/docs/guide/examples/new-feature/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature, StatusList, StatusItem } from '@/components/mdx'

Thêm tính năng mới

Tìm hiểu cách thêm các tính năng phức tạp vào codebase có sẵn một cách an toàn với quy trình /enhance.

Tổng quan Copy Chapter

Quy trình /enhance là công cụ hằng ngày cho việc phát triển lặp.
Khác với /create (dựng từ đầu), /enhance tập trung thêm chức năng một cách phẫu thuật mà không phá vỡ code hiện có.

Quy trình Copy Chapter

```bash
/enhance Add an analytics dashboard for user activity
Requirements:
- Track daily active users and page views
- Visual charts using Recharts
- API endpoint to aggregate data
```

<FeatureGrid cols={4}>
  <Feature title="Database" />
  <Feature title="Backend" />
  <Feature title="Frontend" />
  <Feature title="Testing" />
</FeatureGrid>

Phiên làm việc ví dụ Copy Chapter

Phát hiện: Tailwind CSS chưa cấu hình dark mode
  Kế hoạch: Cập nhật tailwind.config, thêm ThemeProvider, tạo component toggle

Mẹo hay Copy Chapter

Bước tiếp theo Copy Chapter

• Thử /enhance trong dự án của bạn
• Xem Sinh kiểm thử để biết về độ phủ

Web Src App Docs Guide Examples New Feature Content.Zh (`web/src/app/docs/guide/examples/new-feature/content.zh.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature, StatusList, StatusItem } from '@/components/mdx'

添加新功能

学习如何使用 /enhance 工作流，安全地为现有代码库添加复杂功能。

概述 Copy Chapter

/enhance 工作流是你日常迭代开发的工具。
与从零构建的 /create 不同，/enhance 专注于像做手术一样精准地添加功能，而不破坏现有代码。

流程 Copy Chapter

```bash
/enhance Add an analytics dashboard for user activity
Requirements:
- Track daily active users and page views
- Visual charts using Recharts
- API endpoint to aggregate data
```

<FeatureGrid cols={4}>
  <Feature title="Database" />
  <Feature title="Backend" />
  <Feature title="Frontend" />
  <Feature title="Testing" />
</FeatureGrid>

示例会话 Copy Chapter

发现：Tailwind CSS 尚未配置 dark mode
  计划：更新 tailwind.config，添加 ThemeProvider，创建 toggle 组件

实用技巧 Copy Chapter

后续步骤 Copy Chapter

• 在你的项目中试试 /enhance
• 查看测试生成以了解覆盖率

Web Src App Docs Guide Examples Orchestration Content.En (`web/src/app/docs/guide/examples/orchestration/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature, StatusList, StatusItem } from '@/components/mdx'

Multi-Agent Orchestration

Build entire SaaS platforms by coordinating specialist agents with the /orchestrate workflow.

Overview Copy Chapter

Most AI interactions are 1-on-1. The orchestrator agent changes this by acting as a Project Manager.
It breaks down a large request (e.g., "Build a SaaS MVP") into tasks and assigns them to the best specialist for the job.

The Process Copy Chapter

```bash
/orchestrate Build a "Course Platform" MVP with:
- User Authentication (NextAuth)
- Stripe Payments
- Video Hosting (Mux)
- Dashboard for Instructors
```

...
  ### 2.1 Database Schema
  - Users (id, email, role)
  - Courses (id, title, price)
  ...

Example Session Copy Chapter

Pro Tips Copy Chapter

Next Steps Copy Chapter

• Learn about Systematic Debugging to maintain your complex app
• See Deployment to ship your MVP

Web Src App Docs Guide Examples Orchestration Content.Ja (`web/src/app/docs/guide/examples/orchestration/content.ja.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature, StatusList, StatusItem } from '@/components/mdx'

マルチエージェントのオーケストレーション

/orchestrate ワークフローで専門エージェントを連携させ、SaaS プラットフォーム全体を構築しましょう。

概要 Copy Chapter

ほとんどの AI とのやり取りは 1 対 1 です。orchestrator エージェントはプロジェクトマネージャーとして振る舞うことで、これを変えます。
大きなリクエスト（例：「SaaS の MVP を作る」）をタスクに分解し、その仕事に最適な専門家へ割り当てます。

プロセス Copy Chapter

```bash
/orchestrate Build a "Course Platform" MVP with:
- User Authentication (NextAuth)
- Stripe Payments
- Video Hosting (Mux)
- Dashboard for Instructors
```

...
  ### 2.1 Database Schema
  - Users (id, email, role)
  - Courses (id, title, price)
  ...

セッション例 Copy Chapter

実践のヒント Copy Chapter

次のステップ Copy Chapter

• 複雑なアプリを維持するために体系的なデバッグについて学びましょう
• MVP を出荷するにはデプロイを参照しましょう

Web Src App Docs Guide Examples Orchestration Content.Vi (`web/src/app/docs/guide/examples/orchestration/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature, StatusList, StatusItem } from '@/components/mdx'

Điều phối đa tác tử

Xây dựng cả nền tảng SaaS bằng cách điều phối các tác tử chuyên biệt với quy trình /orchestrate.

Tổng quan Copy Chapter

Hầu hết tương tác với AI đều là 1-đối-1. Tác tử orchestrator thay đổi điều này bằng cách đóng vai trò Quản lý dự án.
Nó phân rã một yêu cầu lớn (ví dụ "Xây dựng SaaS MVP") thành các tác vụ và giao cho chuyên gia phù hợp nhất với từng việc.

Quy trình Copy Chapter

```bash
/orchestrate Build a "Course Platform" MVP with:
- User Authentication (NextAuth)
- Stripe Payments
- Video Hosting (Mux)
- Dashboard for Instructors
```

...
  ### 2.1 Database Schema
  - Users (id, email, role)
  - Courses (id, title, price)
  ...

Phiên làm việc ví dụ Copy Chapter

Mẹo hay Copy Chapter

Bước tiếp theo Copy Chapter

• Tìm hiểu Gỡ lỗi có hệ thống để duy trì ứng dụng phức tạp
• Xem Triển khai để phát hành MVP của bạn

Web Src App Docs Guide Examples Orchestration Content.Zh (`web/src/app/docs/guide/examples/orchestration/content.zh.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature, StatusList, StatusItem } from '@/components/mdx'

多智能体编排

使用 /orchestrate 工作流，通过协调多个专家智能体来构建整个 SaaS 平台。

概述 Copy Chapter

大多数 AI 交互都是一对一的。orchestrator 智能体改变了这一点，它扮演项目经理的角色。
它会把一个庞大的需求（例如"构建一个 SaaS MVP"）拆解成多个任务，并分派给最擅长该任务的专家。

流程 Copy Chapter

```bash
/orchestrate Build a "Course Platform" MVP with:
- User Authentication (NextAuth)
- Stripe Payments
- Video Hosting (Mux)
- Dashboard for Instructors
```

...
  ### 2.1 Database Schema
  - Users (id, email, role)
  - Courses (id, title, price)
  ...

示例会话 Copy Chapter

实用技巧 Copy Chapter

后续步骤 Copy Chapter

• 了解系统化调试，以维护你的复杂应用
• 查看部署以发布你的 MVP

Web Src App Docs Guide Examples Plan Content.En (`web/src/app/docs/guide/examples/plan/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

Project Planning

Create detailed implementation plans before writing code with the /plan workflow.

Overview Copy Chapter

The /plan command activates planning-only mode.
It uses the project-planner agent to create a detailed plan file without writing any code.

The Process Copy Chapter

```bash
/plan e-commerce site with cart and checkout
```

Example Session Copy Chapter

1. What metrics? (users, revenue?)
  2. Real-time or daily?
  3. Charting library?

Pro Tips Copy Chapter

Next Steps Copy Chapter

• Run /plan for your next major feature
• After planning, use Create Application to implement

Web Src App Docs Guide Examples Plan Content.Ja (`web/src/app/docs/guide/examples/plan/content.ja.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

プロジェクトの計画

/plan ワークフローで、コードを書く前に詳細な実装計画を作成しましょう。

概要 Copy Chapter

/plan コマンドは計画専用モードを起動します。
project-planner エージェントを使い、コードを一切書かずに詳細な計画ファイルを作成します。

プロセス Copy Chapter

```bash
/plan e-commerce site with cart and checkout
```

セッション例 Copy Chapter

1. どの指標が必要ですか？（ユーザー、収益？）
  2. リアルタイムですか、それとも日次ですか？
  3. チャートライブラリは？

実践のヒント Copy Chapter

次のステップ Copy Chapter

• 次の大きな機能で /plan を実行しましょう
• 計画の後は、アプリの作成で実装しましょう

Web Src App Docs Guide Examples Plan Content.Vi (`web/src/app/docs/guide/examples/plan/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

Lập kế hoạch dự án

Tạo các kế hoạch triển khai chi tiết trước khi viết code với quy trình /plan.

Tổng quan Copy Chapter

Lệnh /plan kích hoạt chế độ chỉ lập kế hoạch.
Nó dùng tác tử project-planner để tạo một file kế hoạch chi tiết mà không viết bất kỳ dòng code nào.

Quy trình Copy Chapter

```bash
/plan e-commerce site with cart and checkout
```

Phiên làm việc ví dụ Copy Chapter

1. Các chỉ số nào? (người dùng, doanh thu?)
  2. Thời gian thực hay theo ngày?
  3. Thư viện biểu đồ?

Mẹo hay Copy Chapter

Bước tiếp theo Copy Chapter

• Chạy /plan cho tính năng lớn tiếp theo của bạn
• Sau khi lập kế hoạch, dùng Tạo ứng dụng để triển khai

Web Src App Docs Guide Examples Plan Content.Zh (`web/src/app/docs/guide/examples/plan/content.zh.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip } from '@/components/mdx'

项目规划

使用 /plan 工作流，在写代码之前先制定详细的实现计划。

概述 Copy Chapter

/plan 命令会启动仅规划模式。
它使用 project-planner 智能体创建一份详细的计划文件，而不写任何代码。

流程 Copy Chapter

```bash
/plan e-commerce site with cart and checkout
```

示例会话 Copy Chapter

1. 需要哪些指标？（用户、收入？）
  2. 实时还是按天？
  3. 用哪个图表库？

实用技巧 Copy Chapter

后续步骤 Copy Chapter

• 为你下一个重要功能运行 /plan
• 规划之后，用创建应用来实现

Web Src App Docs Guide Examples Preview Content.En (`web/src/app/docs/guide/examples/preview/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

Preview Management

Manage your local development server with the /preview workflow.

Overview Copy Chapter

The /preview command manages your local development server.
Start, stop, restart, or check the status with simple commands.

The Process Copy Chapter

Example Session Copy Chapter

Port: 3000
  Type: Next.js

Pro Tips Copy Chapter

Next Steps Copy Chapter

• Run /preview start to launch your dev server
• See Deployment to go live

Web Src App Docs Guide Examples Preview Content.Ja (`web/src/app/docs/guide/examples/preview/content.ja.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

プレビューの管理

/preview ワークフローで、ローカル開発サーバーを管理しましょう。

概要 Copy Chapter

/preview コマンドはローカル開発サーバーを管理します。
シンプルなコマンドで、起動、停止、再起動、状態の確認ができます。

プロセス Copy Chapter

セッション例 Copy Chapter

ポート: 3000
  タイプ: Next.js

実践のヒント Copy Chapter

次のステップ Copy Chapter

• /preview start を実行して開発サーバーを起動しましょう
• 公開するにはデプロイを参照しましょう

Web Src App Docs Guide Examples Preview Content.Vi (`web/src/app/docs/guide/examples/preview/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

Quản lý preview

Quản lý máy chủ phát triển cục bộ của bạn với quy trình /preview.

Tổng quan Copy Chapter

Lệnh /preview quản lý máy chủ phát triển cục bộ của bạn.
Khởi động, dừng, khởi động lại hoặc kiểm tra trạng thái bằng các lệnh đơn giản.

Quy trình Copy Chapter

Phiên làm việc ví dụ Copy Chapter

Cổng: 3000
  Loại: Next.js

Mẹo hay Copy Chapter

Bước tiếp theo Copy Chapter

• Chạy /preview start để khởi động máy chủ phát triển của bạn
• Xem Triển khai để đưa lên môi trường thật

Web Src App Docs Guide Examples Preview Content.Zh (`web/src/app/docs/guide/examples/preview/content.zh.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

预览管理

使用 /preview 工作流管理你的本地开发服务器。

概述 Copy Chapter

/preview 命令负责管理你的本地开发服务器。
用简单的命令即可启动、停止、重启或查看状态。

流程 Copy Chapter

示例会话 Copy Chapter

端口: 3000
  类型: Next.js

实用技巧 Copy Chapter

后续步骤 Copy Chapter

• 运行 /preview start 来启动你的开发服务器
• 查看部署以上线

Web Src App Docs Guide Examples Status Content.En (`web/src/app/docs/guide/examples/status/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

Project Status

Get a complete overview of your project with the /status workflow.

Overview Copy Chapter

The /status command gives you a complete dashboard view of your project.
See project info, tech stack, completed features, agent activity, and preview status.

The Process Copy Chapter

```bash
/status
```

Example Session Copy Chapter

📁 Project: my-ecommerce
  🏷️ Type: nextjs-ecommerce
  📄 Files: 73 created, 12 modified


=== Agent Status ===

  ✅ database-architect → Completed
  ✅ backend-specialist → Completed
  🔄 frontend-specialist → 60%


=== Preview ===

  🌐 URL: http://localhost:3000
  💚 Health: OK

Pro Tips Copy Chapter

Next Steps Copy Chapter

• Run /status to check project state
• See Deployment when ready to ship

Web Src App Docs Guide Examples Status Content.Ja (`web/src/app/docs/guide/examples/status/content.ja.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

プロジェクトの状態

/status ワークフローで、プロジェクトの全体像を把握しましょう。

概要 Copy Chapter

/status コマンドは、プロジェクトの完全なダッシュボードビューを提供します。
プロジェクト情報、技術スタック、完了した機能、エージェントの活動、プレビューの状態を確認できます。

プロセス Copy Chapter

```bash
/status
```

セッション例 Copy Chapter

📁 プロジェクト: my-ecommerce
  🏷️ タイプ: nextjs-ecommerce
  📄 ファイル: 73 件作成、12 件変更


=== Agent Status ===

  ✅ database-architect → 完了
  ✅ backend-specialist → 完了
  🔄 frontend-specialist → 60%


=== Preview ===

  🌐 URL: http://localhost:3000
  💚 健康状態: OK

実践のヒント Copy Chapter

次のステップ Copy Chapter

• /status を実行してプロジェクトの状態を確認しましょう
• 出荷の準備ができたらデプロイを参照しましょう

Web Src App Docs Guide Examples Status Content.Vi (`web/src/app/docs/guide/examples/status/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

Trạng thái dự án

Có cái nhìn tổng quan đầy đủ về dự án của bạn với quy trình /status.

Tổng quan Copy Chapter

Lệnh /status cho bạn một góc nhìn dashboard đầy đủ về dự án.
Xem thông tin dự án, tech stack, các tính năng đã xong, hoạt động của tác tử và trạng thái preview.

Quy trình Copy Chapter

```bash
/status
```

Phiên làm việc ví dụ Copy Chapter

📁 Dự án: my-ecommerce
  🏷️ Loại: nextjs-ecommerce
  📄 Tệp tin: 73 đã tạo, 12 đã sửa


=== Agent Status ===

  ✅ database-architect → Hoàn tất
  ✅ backend-specialist → Hoàn tất
  🔄 frontend-specialist → 60%


=== Preview ===

  🌐 URL: http://localhost:3000
  💚 Sức khỏe: OK

Mẹo hay Copy Chapter

Bước tiếp theo Copy Chapter

• Chạy /status để kiểm tra trạng thái dự án
• Xem Triển khai khi sẵn sàng phát hành

Web Src App Docs Guide Examples Status Content.Zh (`web/src/app/docs/guide/examples/status/content.zh.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

项目状态

使用 /status 工作流，全面掌握你项目的整体情况。

概述 Copy Chapter

/status 命令为你提供项目的完整仪表盘视图。
查看项目信息、技术栈、已完成的功能、智能体活动以及预览状态。

流程 Copy Chapter

```bash
/status
```

示例会话 Copy Chapter

📁 项目: my-ecommerce
  🏷️ 类型: nextjs-ecommerce
  📄 文件: 已创建 73 个，已修改 12 个


=== Agent Status ===

  ✅ database-architect → 已完成
  ✅ backend-specialist → 已完成
  🔄 frontend-specialist → 60%


=== Preview ===

  🌐 URL: http://localhost:3000
  💚 健康状况: OK

实用技巧 Copy Chapter

后续步骤 Copy Chapter

• 运行 /status 来查看项目状态
• 准备好发布时，查看部署

Web Src App Docs Guide Examples Test Content.En (`web/src/app/docs/guide/examples/test/content.en.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

Test Generation & Execution

Generate and run tests with the /test workflow.

Overview Copy Chapter

The /test command handles test generation and execution.
Analyze code, create test suites, run tests, or check coverage.

The Process Copy Chapter

Example Session Copy Chapter

Found 4 functions: login, register, verifyToken, resetPassword

Created: `tests/auth.test.ts`
  Test cases: 12
  Coverage: 95%

Pro Tips Copy Chapter

Next Steps Copy Chapter

• Run /test to execute your test suite
• See Deployment which runs tests automatically

Web Src App Docs Guide Examples Test Content.Ja (`web/src/app/docs/guide/examples/test/content.ja.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

テストの生成と実行

/test ワークフローで、テストを生成して実行しましょう。

概要 Copy Chapter

/test コマンドはテストの生成と実行を担います。
コードを分析し、テストスイートを作成し、テストを実行したり、カバレッジを確認したりします。

プロセス Copy Chapter

セッション例 Copy Chapter

4 つの関数を発見：login、register、verifyToken、resetPassword

作成: `tests/auth.test.ts`
  テストケース: 12
  カバレッジ: 95%

実践のヒント Copy Chapter

次のステップ Copy Chapter

• /test を実行してテストスイートを動かしましょう
• テストを自動で実行するデプロイを参照しましょう

Web Src App Docs Guide Examples Test Content.Vi (`web/src/app/docs/guide/examples/test/content.vi.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

Sinh và chạy kiểm thử

Sinh và chạy test với quy trình /test.

Tổng quan Copy Chapter

Lệnh /test lo việc sinh và chạy kiểm thử.
Phân tích code, tạo bộ test, chạy test hoặc kiểm tra độ phủ.

Quy trình Copy Chapter

Phiên làm việc ví dụ Copy Chapter

Tìm thấy 4 hàm: login, register, verifyToken, resetPassword

Đã tạo: `tests/auth.test.ts`
  Số ca kiểm thử: 12
  Độ phủ: 95%

Mẹo hay Copy Chapter

Bước tiếp theo Copy Chapter

• Chạy /test để thực thi bộ kiểm thử của bạn
• Xem Triển khai vốn tự động chạy test

Web Src App Docs Guide Examples Test Content.Zh (`web/src/app/docs/guide/examples/test/content.zh.mdx`) Copy Section

import { Callout, StepList, Step, Terminal, TerminalLine, TerminalBlock, ProTips, Tip, FeatureGrid, Feature } from '@/components/mdx'

测试生成与执行

使用 /test 工作流生成并运行测试。

概述 Copy Chapter

/test 命令负责测试的生成与执行。
分析代码、创建测试套件、运行测试或检查覆盖率。

流程 Copy Chapter

示例会话 Copy Chapter

找到 4 个函数：login、register、verifyToken、resetPassword

已创建: `tests/auth.test.ts`
  测试用例: 12
  覆盖率: 95%

实用技巧 Copy Chapter

后续步骤 Copy Chapter

• 运行 /test 来执行你的测试套件
• 查看部署，它会自动运行测试

--- METRICS ---

• Files Extracted: 50
• Estimated Token Budget: ~32462 tokens
• Canonical Reference: https://codewiki.google/github.com/vudovn/antigravity-kit