---
title: Google Antigravity Hooks
source_type: official-doc
url: https://antigravity.google/docs/hooks
archive_url:
related_branches: [chore-harness-policy-engine-alignment]
related_projects: [ca-skeleton]
tags: [official-doc, ca-skeleton, integration, build-tooling]
created: 2026-07-20
---

# Google Antigravity Hooks

> Layer: `raw/official-docs/` — Antigravity JSON hook의 구성과 stdin/stdout 계약을 확인한 공식 문서 기록.

## 활용 branch

| Branch | 이 자료가 정당화하는 결정 |
|---|---|
| [[raw/branch-notes/chore-harness-policy-engine-alignment]] | D3 — Antigravity PreToolUse/Stop 어댑터가 공식 JSON·camelCase·decision 계약을 따르도록 한 결정 |

## 출처

- 원본 URL: https://antigravity.google/docs/hooks
- 아카이브 URL: 없음
- 저자 / 조직: Google
- 발행일: 문서에 명시되지 않음
- 마지막 확인일: 2026-07-20

## 왜 저장했는지

Claude용 훅을 그대로 복제하지 않고 Antigravity의 실제 이벤트 이름, camelCase 입력, JSON decision 출력을 맞추기 위한 외부 계약 근거로 저장했다.

## 핵심 인용

> [Input/Output Contract] “Hooks receive input via stdin as JSON and should return output via stdout as JSON. Field names use camelCase.”

## 추출된 주장

| Claim ID | Claim | Evidence quote | Strength | Applies to | Does not prove |
|---|---|---|---|---|---|
| GOOGLE-ANTIGRAVITY-HOOKS-C1 | Hook 입력과 출력은 JSON이며 공통 필드 이름은 camelCase다. | 위 핵심 인용 | `official-vendor-doc` | Antigravity hook adapter의 이벤트 정규화와 직렬화 | Claude/Codex의 hook 형식이 같다는 것 |
| GOOGLE-ANTIGRAVITY-HOOKS-C2 | PreToolUse는 tool name matcher를 사용하고 decision으로 allow/deny/ask/force_ask를 반환한다. Stop은 continue decision으로 실행 루프 재진입을 요청한다. | 공식 문서의 PreToolUse·Stop schema 표 | `official-vendor-doc` | import gate와 completion gate의 Antigravity 출력 매핑 | ca-tmpl 정책 자체의 타당성이나 실제 인증 런타임 E2E 성공 |

## 적용 경계

- 직접 증명: Antigravity hook 파일 구조, 이벤트별 입력 필드, decision 출력 vocabulary.
- 증명하지 않음: 로컬 ca-tmpl 정책이 올바르다는 것, Claude/Codex parity, 실제 로그인된 Antigravity 제품에서의 end-to-end 실행 성공.
- 추가 확인: 인증된 Antigravity 환경에서 seeded mutation과 Stop evidence lifecycle을 실제 실행해야 한다.

## 메모

- workspace-local `hooks.json`과 plugin hook wiring은 공식 schema에 맞춰 정적 검증했다.
- 실제 외부 제품 실행은 branch D3의 후속 `needs-confirmation`으로 남겼다.

## 관련

- [[raw/branch-notes/chore-harness-policy-engine-alignment]]