# 용어 이 repo가 영어 그대로 쓰는 말과, 한국어로 정한 말의 뜻이다. 문서는 처음 나올 때 이 표기를 쓴다. 용어 순서(자연스러운 한국어 → 한국어(영어) → 영어 그대로)의 정본은 design-docs `conventions/docs-system.md` 3절이다. | 표기 | 뜻 | | --- | --- | | leaf | registry(`src/config/architecture/modules.json`)에 등록된 Gradle 프로젝트 하나. 경계의 단위다 | | family | 이름 앞부분이 같은 leaf 묶음(`adapter:inbound:*`, `messaging:*`). 공통 규칙은 그 폴더의 `AGENTS.md`다 | | registry | leaf 목록·경로·허용 의존의 정본 파일 `src/config/architecture/modules.json` | | capability | `runtimeOnly` 한 줄로 켜고 끄는 부가 기능 모듈(`docs/manual/10-capabilities.md`) | | 조립(composition) | 기능을 엮기만 하는 leaf(`src/composition/*`)나 `app-bootstrap`의 배선 | | lane | 같은 조건(실 DB, 컨테이너, 시간)으로 묶어 돌리는 테스트 실행 단위. strict lane은 build-logic `strictTestLanes`가 정의한 것 | | 단계 | workflow가 게이트를 도는 때: PR, main, nightly, 태그 | | 개발 환경 | 루트 `compose.yaml` 하나로 띄우는 로컬 스택(앱 컨테이너의 Spring 프로필은 `local`). `src/app-bootstrap/compose-lanes/`의 overlay는 테스트 lane fixture다. 그중 `dev.yaml`·`prod-smoke.yaml`은 앱을 Spring 프로필 `dev`·`prod`로 띄워 그 프로필의 기동을 보는 lane이고, 개발 환경이 아니다 | | 게이트 | 통과해야 병합·릴리스하는 검사(`docs/work/reference/gates.md`) | | outbox | 트랜잭션 안에 남긴 이벤트를 relay가 나중에 발행하는 방식 | | HARD-STOP | 어기면 동작해도 완료가 아닌 일곱 조건(루트 `AGENTS.md`) | | brief | 다른 세션에 일을 맡기는 지시문(`docs/work/delegate.md`) | | 총괄 | 일을 나누고 brief를 쓰고 결과를 대조하는 세션 | | 하위 세션 | 총괄이 띄운 별도 세션. 파일을 바꾸는 위임을 맡는다. 소유자가 열어 보고 멈출 수 있다 | | 서브에이전트 | 한 세션 안에서 Agent 도구로 띄우는 도우미(`.claude/agents/`). 결과만 돌려준다 | | 훅, 넛지 | 훅은 Claude Code가 정해진 때 대신 돌리는 명령(`scripts/hooks/`). 넛지는 막지 않고 알리기만 하는 훅이다 | | 탐침 | 의심 결함을 보려고 버릴 worktree에서 잠깐 돌리는 테스트(`docs/work/reference/gates.md` 2절) | | RED, GREEN | 수정 전 실패를 실행으로 본 것, 수정 뒤 통과를 본 것 | | 살아 있는 문서, 기록 | 코드와 같이 고치는 문서, 쓴 때의 글로 두고 머리 블록만 고치는 문서(`docs/README.md`) |