docs: write down the adapter barrel boundary and its three exceptions

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-16 18:55:01 +09:00
parent 27ab17d6d6
commit eb40bc9611
2 changed files with 42 additions and 0 deletions
@@ -133,3 +133,15 @@ listener/timer 정리, first-terminal-owner, late rejection 관찰, late native
 - cleanup 실패를 observation만 남기고 success로 바꾸지 않는다.
 - schema/database version을 downgrade하거나 broad prefix/root/database 전체 삭제를 rollback으로 사용하지 않는다.
 - SSE↔WebSocket, Connect↔gRPC-Web↔REST를 장애 중 자동 전환하지 않는다.
+
+## 테스트의 어댑터 import
+
+`tests/` 아래 어댑터 import는 배럴로 일괄 이관하지 않는다. `check:architecture`는
+`src`만 스캔하므로 강제되지 않고, 단위 테스트의 상당수가 배럴에 없는 내부
+심볼을 의도적으로 겨눈다.
+
+어떤 테스트 파일을 **다른 이유로** 수정하거나 분할할 때, 그 파일이 쓰는
+심볼이 해당 그룹 배럴에 있으면 그 파일 안에서만 배럴 경로로 바꾼다.
+배럴에 없는 심볼이면 깊은 경로를 유지한다. 배럴에 추가하고 싶으면 그 심볼이
+공개 표면임을 먼저 논증한다 — 테스트 편의로 배럴을 키우면 배럴이 경계가
+아니라 재수출 덤프가 된다.