API 계약 CI 추가

docs/guides/testing.md

@@ -111,6 +111,13 @@ API DTO를 바꿨다면 먼저 생성 산출물을 갱신한다.
 npm run generate:api-types
 ```
 
+### 2.3 CI 계약 게이트
+
+GitHub Actions `.github/workflows/api-contract.yml`은 API/Web 계약 관련 파일이 바뀌는
+`pull_request`와 `master` push에서 Python 3.11 API 의존성, Node 22 web 의존성을 설치한 뒤
+`apps/web`의 `npm run check:api-types`를 실행한다. 이 게이트는 FastAPI OpenAPI와
+`src/lib/api.gen.ts`의 drift만 막는 좁은 CI이며, DB·API 서버·브라우저는 필요 없다.
+
 ---
 
 ## 3. Playwright E2E (풀스택)