Files
clean-architecture-frontend…/docs/manual/reference/done-criteria.md
T
DongHyeonka ee5e19f47f docs(manual): SPEC.md의 공통 완료 기준을 매뉴얼의 완료 기준으로 옮긴다
문제: 2026-09-25 리뷰 수정 라운드의 요구사항 SPEC.md는 라운드가
0.2.0으로 끝난 기록인데, 그 안의 「공통 완료 기준」(RED→GREEN, 변이
확인, 게이트, INVENTORY, kernel 위치, 포트 추가만, 커밋 하나, 문서
주장의 코드 위치)은 지금도 쓰는 규칙이다. 기록으로 옮기면 규칙이
지울 수 있는 이력 안에만 남는다(소유자 결정 D5, 2026-11-07).

고른 방법: docs/manual/reference/done-criteria.md로 옮기고 매뉴얼
README 표에 더한다. 게이트 여덟 개를 적은 원문 3·4번은 매뉴얼 규칙
(원칙 8, 목록을 복사하지 않음)에 맞춰 정본 config/ci/gates.json과
`ci:gate`를 가리키게 바꿨다. 작업 매뉴얼(docs/work/)은 하네스 세션이
만드는 중이라 이 변경은 개발 매뉴얼에 둔다.

위험: 하네스 세션이 docs/work/에 같은 기준을 두면 둘 중 하나를
가리키게 정리해야 한다.

검증: 문서만 바뀐다. 경로는 뒤의 verify:documentation 실행에서 본다.
2026-11-08 17:25:41 +09:00

2.3 KiB

완료 기준

기능을 더하거나 결함·리뷰 발견을 고친 변경을 "끝났다"고 하기 전에 맞춰 보는 기준이다. 2026-09-25 리뷰 수정 라운드의 공통 완료 기준을 그 라운드 밖에서도 쓰도록 옮겼다. 옮기기 전 원문은 그 라운드의 요구사항(docs/history/plans/2026-09-25-review-fix-round/SPEC.md)에 있다. 게이트 목록은 여기에 적지 않고 정본을 가리킨다(원칙 8).

테스트

  1. 동작을 바꾸는 변경은 재현 테스트가 먼저 실패하고(RED), 고친 뒤 통과한다(GREEN).
    • 브라우저 없이 재현할 수 없는 조건은 fake나 fixture로 만든다.
    • 브라우저에서만 드러나는 동작이면 Playwright spec을 하나 더한다.
  2. 테스트가 결함을 잡지 못한 것(변이가 살아남음)이 문제였으면, 그 변이를 다시 넣었을 때 새 테스트가 실패하는지까지 본다.

게이트

  1. 변경마다 merge 단계 게이트가 모두 통과한다.
    • 목록과 각 게이트가 부르는 명령은 config/ci/gates.json이 정본이다.
    • 로컬에서는 corepack pnpm ci:gate -- <게이트 ID>로 하나씩 돌린다. 돌리는 법은 루트 README.md의 「검증」 절에 있다.
  2. 여러 변경을 합칠 때(병렬 작업을 통합할 때)는 3에 더해 corepack pnpm build와 corepack pnpm test:sample-removal도 돌린다.

구조와 계약

  1. src/adapters/ 아래 파일을 더하거나 옮기면 docs/reviews/adapters/INVENTORY.md를 같은 변경에서 고친다. corepack pnpm check:adapter-inventory가 대조한다.
  2. 여러 adapter가 같이 쓰는 로직은 src/adapters/platform/(kernel)이나 src/contracts/에 둔다. 새 파일 단위 예외 규칙은 만들지 않는다(.dependency-cruiser.json).
  3. 공개 포트는 더하기만 한다. 기존 시그니처를 깨야 하면 결정 기록(docs/adr/)을 남기고 CHANGELOG.md에 BREAKING으로 적는다.

커밋과 문서

  1. 논리적 변경 하나에 커밋 하나다. 리뷰 발견을 고친 커밋은 메시지에 발견 ID를 적는다. 그 변경이 바꾼 파일만 스테이징한다.
  2. 문서를 바꾸는 변경은 문서의 주장마다 코드 위치를 가리키는지로 확인한다. 문서와 코드가 다르면 코드가 맞다.