docs(agents)!: 루트 AGENTS.md를 40줄 정본으로 줄이고 CLAUDE.md가 가져온다
루트에 CLAUDE.md와 AGENTS.md가 둘 다 있으면 Claude Code 기본 설정은 AGENTS.md를 읽지 않는다. 그래서 344줄 정본은 세션이 스스로 열 때만 닿았고, HARD-STOP은 CLAUDE.md 요약으로만 실렸다. 두 문서가 같은 규칙을 아홉 군데 따로 적었다. 소유자가 2026-11-07에 루트 정본은 AGENTS.md 20~40줄, CLAUDE.md는 `@AGENTS.md`로 정했다(design-docs harness/01-harness-design.md 13절 Q1·Q2·Q3). - AGENTS.md(37줄): 무엇인가, HARD-STOP 7, 지도, 맡은 일, 검증, 일하는 방식. CLAUDE.md(6줄): `@AGENTS.md`와 Claude 전용 줄. - 옛 절의 새 자리: Gradle 정책 권위 → src/build-logic/AGENTS.md(새), 테스트 작성 규칙 → .claude/rules/java-tests.md(paths: 테스트 소스), 계층별 테스트 기준·family 책임 → 각 core AGENTS.md와 새 src/adapter/inbound·outbound/AGENTS.md, composition 조립 규칙 → src/composition/AGENTS.md(새), capability 규칙·완료 기준 → docs/manual/10-capabilities.md(이제 정본), 설정·Docker 규칙 → .claude/rules/settings-and-runtime.md, 문서 편집 규칙 → .claude/rules/docs.md, 템플릿 재사용 체크리스트 → README 「새 서비스로 시작하기」. Superpowers 목록·강제 수준·금지된 지름길· 작업 보고 규칙은 HARD-STOP과 전역 규칙의 중복이라 지웠다. - 살아 있는 문서의 옛 절 참조를 새 자리로 바꿨다. 결정 색인은 옛 행에 취소선을 긋고 「지침 배치」 행을 더했다. - check-work-docs.py: 지도를 AGENTS.md로, 상한 40(CLAUDE.md 10), 진입 경로에 CLAUDE.md를 더하고, CLAUDE.md 첫 줄이 가져오기인지, .claude/rules·skills·agents 문서의 이력 ID와 링크를 본다. - DeveloperExperienceContractTest는 루트 안내 명령을 AGENTS.md에서 읽는다. 단언은 그대로다. 버린 대안: 루트 120줄(설계 권함, 소유자가 자료 쪽으로 정함), CLAUDE.md만 두기(다른 에이전트가 못 읽음), 심볼릭 링크. 위험: 폴더를 가로지르는 규칙(.claude/rules/)은 Claude Code만 자동으로 읽는다. 다른 에이전트용으로 AGENTS.md 지도에 위치 한 줄을 뒀다. 검증: check-work-docs.py(AGENTS.md 37/40, CLAUDE.md 6/10), check-docs.py, unittest, check-repo-layout.py 모두 rc=0. Java 테스트 변경은 마지막 트리에서 desktop documentContractTest로 확인한다. BREAKING CHANGE: 루트 AGENTS.md의 절 이름이 바뀌고 내용이 위 자리로 옮겨 갔다. docs/upgrade/2026-11-harness.md 2절 2·3행.
This commit is contained in:
+2
-2
@@ -1,7 +1,7 @@
|
||||
# src — 빌드 스크립트 / 환경 변수 참조
|
||||
|
||||
`src/` 는 Gradle 멀티모듈 루트다. 모듈 경계·의존 방향 규칙은 루트 [CLAUDE.md](../CLAUDE.md)
|
||||
와 [AGENTS.md](../AGENTS.md), 모듈별 규칙은 각 모듈의 `AGENTS.md` 가 SSOT이다.
|
||||
`src/` 는 Gradle 멀티모듈 루트다. 모듈 경계·의존 방향 규칙은 루트 [AGENTS.md](../AGENTS.md),
|
||||
모듈별 규칙은 각 모듈의 `AGENTS.md` 가 SSOT이다.
|
||||
|
||||
이 문서는 [build.gradle](build.gradle) 과 [.env.example](.env.example)(복사해 `.env` 로 씀) 의 코드 주석에서 덜어낸 **설정 항목 설명과
|
||||
결정 근거**를 모아둔 참조용 기록이다. 두 파일에는 짧은 기능 주석과 "자세한 내용은 README 참조"
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
# adapter:inbound:* — inbound adapter family 공통 규칙
|
||||
|
||||
모든 inbound leaf에 같은 규칙만 적는다. leaf마다 자기 폴더의 `AGENTS.md`가 그 leaf의 자세한 규칙(등록 정보, 허용·금지, 테스트 명령)을 둔다. 루트 `AGENTS.md` HARD-STOP이 이 문서와 leaf 문서보다 먼저다.
|
||||
|
||||
## 책임
|
||||
|
||||
- HTTP·gRPC·GraphQL·WebSocket·메시지 수신 같은 transport, 요청·응답 DTO, 입력 검증, 인증·인가 매핑, 오류 매핑.
|
||||
- 요청 DTO를 `application-core`의 command·query로 바꿔 유스케이스를 부른다. 엔드포인트는 얇게 둔다.
|
||||
|
||||
## 금지
|
||||
|
||||
- repository·Spring Data interface·persistence entity를 직접 쓴다(HARD-STOP 2).
|
||||
- inbound DTO를 `application-core`·`domain-core`로 넘긴다(HARD-STOP 3).
|
||||
- 업무 정책을 controller·mapper·filter에 둔다(HARD-STOP 4).
|
||||
- registry `allowed_dependencies`에 없는 leaf에 기댄다(HARD-STOP 5).
|
||||
|
||||
## 테스트
|
||||
|
||||
- transport 검증, 인증·인가 매핑, 상태 코드와 응답 계약을 검증한다.
|
||||
- 작성 규칙은 `.claude/rules/java-tests.md`다.
|
||||
@@ -0,0 +1 @@
|
||||
@AGENTS.md
|
||||
@@ -344,7 +344,7 @@ resolver 마다 deadline 을 검사하게 하는 방법은 adopter 가 기억해
|
||||
|
||||
아래 타입은 auto-configuration 이 빈으로 만들지 않는다. 서비스가 자기 GraphQL 어댑터 leaf 에서
|
||||
`implementation project(':adapter:inbound:graphql')` 로 받아 resolver 안에서 직접 생성·호출한다
|
||||
(AGENTS.md capability 규칙의 라이브러리형 예외). 켜는 설정 키는 없다.
|
||||
(`docs/manual/10-capabilities.md` 「판단」의 라이브러리형 예외). 켜는 설정 키는 없다.
|
||||
|
||||
| 기능 | 진입점 | 테스트 |
|
||||
| --- | --- | --- |
|
||||
|
||||
@@ -16,7 +16,7 @@ implementation project(':adapter:inbound:web-advanced')
|
||||
|
||||
registry(`src/config/architecture/modules.json`)의 그 leaf `allowed_dependencies` 에
|
||||
`adapter-inbound-web-advanced` 를 더한다. 서비스 코드가 타입을 직접 부르므로 `runtimeOnly` 로는 안 된다
|
||||
(AGENTS.md capability 규칙의 라이브러리형 예외).
|
||||
(`docs/manual/10-capabilities.md` 「판단」의 라이브러리형 예외).
|
||||
|
||||
## 제공하는 것
|
||||
|
||||
|
||||
@@ -107,7 +107,7 @@ simple broker는 한 프로세스 안의 best-effort 전달이다. 영속·트
|
||||
## 라이브러리 API — 서비스의 어댑터 leaf에서 직접 조립
|
||||
|
||||
설정 키도 자동 설정도 없다. 서비스의 어댑터 leaf가 `implementation project(':adapter:inbound:websocket')`로
|
||||
받아 아래 타입을 직접 만든다(AGENTS.md capability 규칙의 라이브러리형 예외).
|
||||
받아 아래 타입을 직접 만든다(`docs/manual/10-capabilities.md` 「판단」의 라이브러리형 예외).
|
||||
|
||||
| 진입점 | 역할 |
|
||||
| --- | --- |
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
# adapter:outbound:* — outbound adapter family 공통 규칙
|
||||
|
||||
모든 outbound leaf에 같은 규칙만 적는다. leaf마다 자기 폴더의 `AGENTS.md`가 그 leaf의 자세한 규칙(등록 정보, 허용·금지, 테스트 명령)을 둔다. 루트 `AGENTS.md` HARD-STOP이 이 문서와 leaf 문서보다 먼저다.
|
||||
|
||||
## 책임
|
||||
|
||||
- `persistence-*`: JPA·PostgreSQL 또는 MongoDB 영속 구현과 mapping, migration·vendor 동작.
|
||||
- 그 밖의 leaf: support, messaging, cache, notification, object storage, file server, HTTP client, identifier 능력을 application이 가진 port 뒤에서 구현한다.
|
||||
|
||||
## 금지
|
||||
|
||||
- 유스케이스 정책을 adapter에 둔다(HARD-STOP 4).
|
||||
- registry `allowed_dependencies`에 없는 adapter끼리의 edge(HARD-STOP 5). 허용 edge는 registry만 정한다.
|
||||
- 이미 적용된 migration 파일을 고친다. 새 버전 파일을 더하고 `persistence-jpa`의 `src/test/resources/db/applied-migrations.sha256`에 한 줄을 더한다.
|
||||
|
||||
## 테스트
|
||||
|
||||
- `persistence-*`: persistence mapping, repository adapter, vendor·migration 동작을 실제 DB로 검증한다.
|
||||
- 그 밖의 leaf: port 계약(fake와 adapter가 같은 추상 계약 테스트를 상속)과 외부 능력 adapter 계약을 검증한다.
|
||||
- 작성 규칙은 `.claude/rules/java-tests.md`다.
|
||||
@@ -0,0 +1 @@
|
||||
@AGENTS.md
|
||||
@@ -83,4 +83,4 @@ transport 포트(`BlockingTransportProvider`)에는 test fixtures에 추상 계
|
||||
`testkit/BlockingTransportProviderContract`가 있다. engine은 실제 socket 위에서 그것을 통과하고
|
||||
(`StableTransportProviderContractTest`, 계약 lane, 고른 transport마다 한 번), gateway 시험이 딛고 서는 각본
|
||||
fake는 기본 lane에서 그것을 통과한다(`ScriptedTransportContractTest`). 새 transport나 `ScriptedTransport`의
|
||||
변경은 사본이 아니라 같은 클래스를 상속한다(AGENTS.md 규칙 6).
|
||||
변경은 사본이 아니라 같은 클래스를 상속한다(`.claude/rules/java-tests.md` 규칙 6).
|
||||
|
||||
@@ -133,7 +133,7 @@ generation 준비, traffic 전환, 옛 lease 비우기, 닫기 — 는 `MongoCli
|
||||
`MongoAdvancedCapabilityFlags`와 guard를 만든다. Stable 자동 구성은 `..advanced..` 아래의 어떤 것도 참조하면 안
|
||||
된다.
|
||||
- 이 leaf가 바인딩하는 모든 설정 키는 동작을 바꿔야 한다. 아무것도 읽지 않는 키나, 효과가 기동 실패뿐인 키는
|
||||
문서로 남기지 않고 지운다(AGENTS.md capability 규칙 3). `docs/capability-status.md`가 무엇을 왜 지웠는지 적는다.
|
||||
문서로 남기지 않고 지운다(`docs/manual/10-capabilities.md` 기준 3). `docs/capability-status.md`가 무엇을 왜 지웠는지 적는다.
|
||||
- 인터페이스는 이 leaf 안에 구현이 있을 때만 싣는다. Search, vector, time series, GridFS는 계약만 있었고
|
||||
2026-09-25에 지웠다.
|
||||
- observation tag는 `MongoObservationConvention`의 허용 목록으로 제한한다.
|
||||
|
||||
@@ -147,7 +147,7 @@ Mongo auto-configuration 이름을 Boot 자신의 등록 파일에서 읽어 배
|
||||
## 라이브러리 API — 서비스의 어댑터 leaf에서 `implementation`으로 받아 직접 호출
|
||||
|
||||
bean으로 등록되지 않고 설정 키도 없다. 서비스의 Mongo 어댑터 leaf가 이 leaf를 `implementation`으로
|
||||
받아 생성자로 만든다(AGENTS.md capability 규칙의 라이브러리형 예외). 테스트 열은 그 진입점을 검증하는 이 leaf의 테스트다.
|
||||
받아 생성자로 만든다(`docs/manual/10-capabilities.md` 「판단」의 라이브러리형 예외). 테스트 열은 그 진입점을 검증하는 이 leaf의 테스트다.
|
||||
|
||||
소비 leaf를 만드는 절차(레지스트리 edge, Gradle 줄, collection profile 등록, 예외 변환, 정책을 우회하는
|
||||
경로)는 [`docs/mongodb/consumer-leaf-guide.md`](../../../../docs/mongodb/consumer-leaf-guide.md)에 있다.
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
|
||||
**capability가 아니라 라이브러리다.** 이 leaf가 classpath에 있다고 켜지는 것은 없다: `AutoConfiguration.imports`가
|
||||
없고, bean을 만들지 않고, 자기 `enabled` 스위치가 없다. 서비스 코드가 그 타입을 직접 부르므로 `runtimeOnly`로
|
||||
받을 수 없다(AGENTS.md, capability 규칙의 라이브러리 타입 예외).
|
||||
받을 수 없다(`docs/manual/10-capabilities.md` 「판단」의 라이브러리형 예외).
|
||||
|
||||
## 더하기
|
||||
|
||||
|
||||
@@ -114,6 +114,9 @@
|
||||
|
||||
## 테스트
|
||||
|
||||
- `settings` 패키지: 설정 바인딩, 값 검증, 로깅 설정을 검증한다. 새 settings 클래스에는 바인딩·검증 테스트를 더한다.
|
||||
- 설정·런타임·Docker 규칙은 `.claude/rules/settings-and-runtime.md`다.
|
||||
|
||||
```bash
|
||||
cd src
|
||||
./gradlew :app-bootstrap:test
|
||||
|
||||
+1
-1
@@ -309,7 +309,7 @@ class DeveloperExperienceContractTest {
|
||||
@DisplayName("루트 안내 문서는 아키텍처 suite를 그 source set의 태스크 이름으로 안내한다")
|
||||
void guidanceNamesTheArchitectureSourceSetTask() throws IOException {
|
||||
// when
|
||||
String guidance = read("CLAUDE.md");
|
||||
String guidance = read("AGENTS.md");
|
||||
|
||||
// then
|
||||
assertThat(guidance)
|
||||
|
||||
@@ -326,6 +326,9 @@ hikari.maximumPoolSize >= (concurrent_threads × (1 + max_inNew_depth)) + 1
|
||||
|
||||
## 테스트
|
||||
|
||||
- fake·in-memory 포트로 유스케이스 흐름을 검증한다. Spring context를 띄우지 않는다.
|
||||
- 포트마다 fake 하나와 추상 계약 테스트(`*Contract`)를 이 모듈 testFixtures에 둔다. 작성 규칙은 `.claude/rules/java-tests.md`다.
|
||||
|
||||
```bash
|
||||
cd src
|
||||
./gradlew :application-core:test
|
||||
|
||||
@@ -0,0 +1,38 @@
|
||||
# build-logic — Gradle 정책 권위
|
||||
|
||||
registry, settings, build-logic, 루트 라이프사이클이 정하는 것을 적는다. `src/build-logic/`, `src/settings.gradle`, `src/build.gradle`, `src/config/architecture/modules.json`을 고칠 때 읽는다. 루트 `AGENTS.md` HARD-STOP 5가 이 문서보다 먼저다. 게이트 고르기와 실행 위치는 `docs/work/reference/gates.md`다.
|
||||
|
||||
## 정본 넷
|
||||
|
||||
- `src/config/architecture/modules.json`: 등록된 모든 leaf의 ID, repository-relative 소스 경로, Gradle path, 허용 production project dependency edge. runtime membership 목록은 없다. 조립 루트가 받을 수 있는 모듈은 `allowed_dependencies`가 정하고, 방향 게이트가 그 밖의 edge를 막는다. leaf 목록과 그 개수의 정본은 registry다. 문서는 개수를 적지 않는다. 산문에 적힌 숫자는 leaf가 더해지는 순간 틀린다. 그 숫자를 강제하던 태스크(`verifyDocumentedLeafCount`)는 지웠다. 문서에 적힌 수가 틀린 것은 결함이지만 빌드를 실패시킬 사유는 아니고, 그 태스크는 모든 지역 문서와 `build.gradle`을 정규식으로 훑는 파서였다.
|
||||
- `src/settings.gradle`: `ca.architecture-registry` 설정 플러그인이 registry를 읽어 project를 include·mapping한다. registry가 project 목록이 될 수 없는 경우(중복 ID, 저장소 밖 경로, 없는 디렉터리)만 여기서 실패한다. 허용되지 않는 edge 같은 아키텍처 규칙은 `verifyCleanArchitectureDependencies`가 답한다. settings에서 죽으면 실행할 수 있는 태스크가 하나도 없다.
|
||||
- `src/build-logic/`: 아키텍처 코어(registry, 방향·순수성 task), 컨벤션, 테스트 레인 하나(`strictTestLanes`). leaf는 `ca.java-library`·`ca.spring-library`·`ca.platform-module` 중 자기 성격을 선언하고, 그 플러그인이 toolchain·락·정적분석·테스트 기본값을 준다. `ca.architecture`가 아키텍처 검증 태스크를 가진다. 기능별 검사(notification·mongo·messaging·graphql·JPA readiness 등)는 build-logic이 아니라 그 leaf의 테스트다.
|
||||
- `src/build.gradle`: 루트 라이프사이클(`ci`, `mainCheck`, `integrationCheck`, `performanceCheck`, `releaseCheck`, `qualityCheck`, `configContractCheck`)과 버전·리비전.
|
||||
|
||||
## 저장소 파일을 읽는 테스트
|
||||
|
||||
- 테스트가 저장소 파일을 읽으면 그 파일을 그 leaf의 test task `inputs`로 선언한다.
|
||||
- 저장소 문서와 대조하는 테스트는 `mainStage()` 레인(`document-contract` 태그)으로 leaf `mainCheck`에서 돈다.
|
||||
- 문서가 아닌 저장소 파일(빌드 스크립트, workflow, Compose, 다른 leaf 소스)을 읽어야 merge 전에 막을 수 있는 계약은 그 파일만 입력으로 둔 별도 레인(app-bootstrap `repository-contract`)에 둔다.
|
||||
- 저장소 루트(`ca.repository.root`)는 이 두 레인에만 준다. 그래서 태그 없이 저장소를 읽는 테스트는 `test`에서 실패한다.
|
||||
- 문서를 파싱해 대조하는 Gradle 검사는 두지 않는다. 문서 검사는 Gradle 밖 `scripts/check-docs.py`·`scripts/check-work-docs.py`다.
|
||||
|
||||
## lane 캐시와 성능 lane
|
||||
|
||||
- `TEST`·`ARCHITECTURE` lane은 입력이 같으면 up-to-date·build cache를 쓴다. `INTEGRATION`·`SYSTEM`·`PERFORMANCE` lane과 `mainStage()` lane은 이미지·네트워크·시간·문서처럼 입력으로 잡히지 않는 것에 기대므로 매번 다시 돈다. hermetic lane이 저장소 파일을 읽으면 그 파일을 입력으로 선언해야 캐시가 거짓 통과를 내지 않는다.
|
||||
- `PERFORMANCE` lane은 상한을 매번 단언한다. 끄는 스위치가 없다. convention이 테스트 JVM에 `performance.assertions.enabled=true`를 넣고, 빌드(`-P`·`GRADLE_OPTS`)나 lane이 다른 값을 주면 테스트 전에 실패한다. skip된 테스트가 하나라도 있어도 실패한다(`rejectSkipped`를 따로 쓰지 않아도). 사람이 손으로 돌리는 `./gradlew performanceCheck`와 workflow가 같은 상한을 단언한다.
|
||||
- `verifyEnvKeys`는 app-bootstrap 태스크로 유지한다(2026-09-25 소유자 결정). 구현은 build-logic의 `ca.config-contract`다.
|
||||
|
||||
## `verifyStrictLaneStages`가 세는 명령
|
||||
|
||||
`verifyStrictLaneStages --dry-run`(PR 게이트)은 그 빌드에서 `explicitOnly`가 아닌 strict lane이 workflow가 실제로 실행하는 단계(main 빌드: `ci`·`mainCheck`·`integrationCheck`·`performanceCheck`·`releaseCheck`, optional-platforms 빌드: `-p platforms/optional-build`로 부르는 `ci`·`integrationCheck`·`performanceCheck`·`releaseCheck`) 중 하나에 들어 있는지, 그리고 workflow의 접힌(`>`) run 블록이 빈 줄 때문에 옵션을 별개 명령으로 떼어 내지 않는지 검사한다. 두 빌드가 각자 검사를 돌린다. `-x`로 뺀 lane(Gradle처럼 축약 이름도 맞춰 본다)은 덮이지 않는다. Gradle이 작업을 돌리지 않는 명령(`--dry-run`·`-m`·`-v`·`--help`·`--status`·`--stop`·`--foreground`, 묶음 `-qm`·`-qv` 포함)과 Gradle이 거부하는 짧은 옵션 묶음(`-mx`), 다른 빌드를 실행하는 명령은 세지 않는다. 그 밖에 세지 않는 명령은 이유가 셋이다.
|
||||
|
||||
1. 실패해도 단계가 실패하지 않을 수 있다: `|| exit <0 아닌 값>` 밖의 `||`(`|| true` 등), pipefail 없는 파이프 왼쪽, `!`, `&`, `if`·`while` 조건, 스크립트 마지막이 아닌 `&&` 목록의 앞쪽, `set +e` 뒤, `exit 0` 하는 `EXIT`·`ERR` trap 뒤, `continue-on-error`.
|
||||
2. 돌지 않을 수 있다: `||` 뒤, 마지막이 아닌 `&&` 목록의 뒤쪽, `if`·`while`·`for`·`case`·함수 본문 안, 최상위 `exit`·`exec`·`set -n` 뒤, 조건부이거나 부른 함수 안의 `exit 0`(인자 없는 `exit`, 값을 모르는 `exit` 포함)·`exec`·`set -n` 뒤, 상태 함수(`always()`·`success()`·`!cancelled()`)가 아닌 `if:` 아래, 요청으로만 시작하는 workflow(`workflow_dispatch`·`repository_dispatch`·`issue_comment` 등), `paths`·`paths-ignore` 필터가 붙은 change trigger로만 시작하는 workflow(그 경로 밖 변경에는 돌지 않는다), 태그 push(`branches` 없는 `tags`)나 `release`로만 시작하는 workflow(`releaseCheck` 밖의 단계), 세는 job이 부르지 않는 `workflow_call` 재사용 workflow, 조건부이거나 `continue-on-error`인 job을 `needs`로 기다리는 job.
|
||||
3. 실패하면 단계도 실패하지만 검사가 읽지 않는다: `|| exit 1`, `{ }`·`( )`·`$( )`·`bash -c` 안, 다른 명령의 인자인 `gradlew`, 따라갈 수 없는 `cd`(`cd "$VAR"`·`cd -`·`pushd`·조건부·서브셸 등) 뒤, `bash`·`sh`가 아닌 `shell:`, Windows일 수 있는 runner의 기본 셸(`pwsh`).
|
||||
|
||||
실패 메시지는 명령마다 이유를 적고 단계 명령을 혼자 한 줄로 두라고 안내한다. 명령이 어느 빌드를 실행하는지는 `working-directory`에서 시작해 같은 셸이 그 앞에서 확실히 실행한 `cd <상대 경로>`를 따라간 뒤 `-p`를 합친 디렉터리로 정한다.
|
||||
|
||||
## 테스트
|
||||
|
||||
- `./gradlew -p build-logic test --console=plain`(`src/`에서). build-logic은 Spotless 대상이 아니다.
|
||||
@@ -0,0 +1 @@
|
||||
@AGENTS.md
|
||||
@@ -0,0 +1,12 @@
|
||||
# composition:* — 조립 leaf family 공통 규칙
|
||||
|
||||
`composition:*` leaf는 조립만 한다. outbox relay, 멱등성 executor, durable operation, 알림·파일 서버 플랫폼, 서비스 실행 환경처럼 `app-bootstrap`에서 떼어 낸 조립이다. 서비스는 `src/app-bootstrap/build.gradle`에서 필요한 것만 `runtimeOnly` 한 줄로 고른다. leaf마다 자기 폴더의 `AGENTS.md`나 README가 자세한 규칙을 둔다.
|
||||
|
||||
## 금지
|
||||
|
||||
- 업무 규칙과 SQL. 조립에 필요한 타입만 쓴다.
|
||||
- registry `allowed_dependencies`에 없는 edge. 어떤 adapter를 아는지는 그 leaf의 registry 행이 정한다. outbox relay·멱등성은 포트만 알고, 알림·파일 서버 플랫폼은 자기 adapter를 함께 조립한다.
|
||||
|
||||
## 테스트
|
||||
|
||||
- 설정 바인딩, 기동 거절 조건, 종료 순서처럼 조립이 가진 것만 검증한다. 업무 동작은 core와 adapter의 테스트가 맡는다.
|
||||
@@ -0,0 +1 @@
|
||||
@AGENTS.md
|
||||
@@ -32,6 +32,9 @@
|
||||
|
||||
## 테스트
|
||||
|
||||
- Spring 없이 순수 unit test로 도메인 규칙과 불변식을 검증한다.
|
||||
- 도메인이 가진 포트의 fake와 추상 계약 테스트(`*Contract`)는 이 모듈 testFixtures에 둔다. 작성 규칙은 `.claude/rules/java-tests.md`다.
|
||||
|
||||
```bash
|
||||
cd src
|
||||
./gradlew :domain-core:test
|
||||
|
||||
Reference in New Issue
Block a user