docs(ai-character): OpenAPI 계약 반영

This commit is contained in:
Yu Sung
2026-07-28 03:33:16 +09:00
parent 2a5efb0f3e
commit dd30e36323
13 changed files with 1896 additions and 1164 deletions

View File

@@ -27,7 +27,7 @@
## 4. 문서 간 추적
- 제품 결정과 사용자 요구는 PRD가 소유한다.
- request/response/error와 endpoint 세부 계약은 `api-contract.md` 소유한다.
- request/response/error와 endpoint 세부 계약은 대상 기능의 실제 API Contract 파일(Markdown 또는 OpenAPI)이 소유한다.
- 구현 순서, Files, Interfaces, Task/Goal과 완료 증거는 `plan-task.md`가 소유한다.
- 모든 확정 요구사항을 API Contract section 또는 명시적인 contract 불필요 판정, 하나 이상의 Phase/Goal, 자동·수동 검증으로 연결한다.
- Open Question과 외부 의존을 혼합하지 않는다. 제품이 결정할 수 없는 backend 계약은 별도 외부 의존 ID로 관리한다.
@@ -47,6 +47,6 @@
- 사용자·권한·핵심 흐름과 라우팅 경계가 명확하다.
- 모든 요구사항 ID가 고유하고 상태·수용 기준을 가진다.
- 미결·외부 의존·제외 항목에 다음 행동과 담당 주체가 있다.
- API endpoint와 payload 규칙이 `api-contract.md`로 추적된다.
- API endpoint와 payload 규칙이 대상 API Contract 파일로 추적된다.
- 기능·UX·보안·성능 성공 기준이 자동 또는 수동 검증 가능한 표현이다.
- placeholder, 근거 없는 최대값과 추정 계약이 없다.