Files
clean-architecture-backend-…/docs/work/reference/decisions.md
T
DongHyeonka 63c63413d1 docs(work): 지도와 작업 종류별 playbook으로 작업 매뉴얼을 만든다
문제: 이 repo의 진입 문서는 아키텍처 규칙을 길게 다시 쓴 CLAUDE.md(183줄)와
리뷰·수정만 다루는 옛 개선 매뉴얼(진입 717줄, 미병합)이었다. 이력 없는 세션이
"이 일이면 무엇을 읽나"를 알 수 없었고, 새 기능·조사·문서·운영·총괄의 절차는
없었다. 규칙도 서로 달랐다: 하위 에이전트(AGENTS.md는 권함, 소유자는 금지),
커밋(human-only와 브랜치 커밋 허용), 리뷰 멈춤 기준(거둔 기준이 남음).

고른 방법(2026-11-06 소유자 결정 D1, D2, D4, D12; 설계 design-docs
delegation-loop/02-design.md 4~6·10절):
- CLAUDE.md를 72줄 지도로 바꿨다: 이 repo, HARD-STOP 7개 한 줄씩(정본
  AGENTS.md), 일 → playbook 표, 검증 명령과 실행 위치, 코드만 보고는 헷갈리는
  곳, 소유자 환경 포인터. AGENTS.md를 요약하던 절은 지웠다. AGENTS.md에 없던
  내용은 옮겼다: messaging 예외는 지도 5절, 판단 보고 규칙은
  reference/review-criteria.md 11절, 위험 비례 원칙은 docs/work/README.md 2절.
- docs/work/: README(라우터·크기·공통 단계·커밋·막혔을 때·보고), playbook 6개
  (new-feature, improve, research-design, docs-writing, operate, delegate, 모두
  같은 9칸 뼈대), reference/ 4개(gates, review-criteria, defect-patterns,
  decisions), evidence.md. 옛 매뉴얼 03~06장은 reference/를 늘리지 않고
  review-criteria(점검 기준), defect-patterns(막는 기준), gates(성능 lane)에
  나눠 넣었다. 다섯 번째 reference 파일은 설계의 파일 구성과 달라 버렸고,
  improve.md 본문에 넣는 안은 150줄 상한을 넘어 버렸다.
- improve.md에 수정 보고의 「새로 가정하는 것」 칸(확인 리뷰가 여기서 시작)과
  수정 묶음 상한(영역 하나·발견 8건, 확인 리뷰당 추가 1,500줄)을 넣었다. 지난
  수정 커밋의 추가 줄과 다음 확인 리뷰 발견 수(+906→9, +1,877→7, +5,420→25,
  +13,479→29)가 근거다(evidence.md 3절). 멈춤 기준은 "발견 0"으로 하나만 둔다.
- 커밋: AGENTS.md human-only는 두고 "brief가 허용할 때만 자기 브랜치에" 예외를
  README 4절과 AGENTS.md에 같은 말로 적었다.
- 본문 이력 ID 0. 지난 리뷰 ID와 사건은 evidence.md와 두 색인
  (reference/decisions.md, reference/defect-patterns.md)에만 둔다.
- 연결: README.md(HARD-STOP을 "8개"로 잘못 적은 것도 7개로), docs/README.md,
  docs/manual/README.md(입구 연결), docs/manual/02-new-feature.md(지운
  CLAUDE.md 「Layer workflow」를 가리키던 줄).

위험·한계: 이 매뉴얼은 이력 없는 새 세션으로 시험(cold-read)하기 전이라
초안이다. 정식 시험은 총괄이 따로 한다. 작성 중 자가 점검(지도부터 읽어
docs-writing.md로 brief 하나를 써 봄)에서 막힌 네 곳은 고쳤다. docs/manual/
본문에는 아직 이력 ID 9줄이 남아 있다(범위 밖, 후속 작업). gates.md 5절의
성능 단언 속성 문장은 성능 게이트를 고치는 다른 작업과 겹친다.

검증
- python3 scripts/check-work-docs.py: rc=0. 지도 72/120, README 75/80,
  playbook 79~132/150, 진입 경로 최대 279/350, 본문 이력 ID 0줄
- python3 scripts/check-work-docs.py --links docs README.md CLAUDE.md
  AGENTS.md: 504파일, 상대 링크 447개, 깨진 것 0
- CLAUDE.md를 읽는 테스트 DeveloperExperienceContractTest
  .guidanceNamesTheArchitectureSourceSetTask가 기대하는
  "./gradlew :app-bootstrap:architectureTest"를 지도에 남겼다. Gradle 게이트는
  이 커밋을 push한 뒤 desktop에서 돌린다
2026-11-06 19:58:44 +09:00

19 KiB

결정 색인

이미 정한 것을 한곳에서 찾는 색인이다. 결정의 원문은 「출처」 칸의 문서에 있고, 원문이 정본이다. 이 표와 원문이 다르면 원문이 맞고 이 표를 고친다. 이 문서는 지난 리뷰 ID와 결정 번호를 출처로 쓴다(매뉴얼 본문에는 쓰지 않는다).

작업 시작 ─> 이 색인에서 주제를 찾는다 ─> 있으면: 원문을 읽고 그대로 따른다
                                      └> 없으면: 소유자 몫인가? ─> 그렇다: 묻는다(3절)
                                                              └> 아니다: 정하고 기록한다(3절)

1. 결정을 다시 묻지 않는 규칙

  1. 작업을 시작하기 전에 이 색인과 원문을 읽는다. 표에 있는 주제면 그 결정대로 한다. brief에도 결정의 내용을 옮겨 적는다.
  2. 다시 열 수 있는 경우는 셋뿐이다.
    • 결정의 전제가 코드나 측정으로 틀렸다고 확인됐다.
    • 두 결정이 서로 충돌한다.
    • 결정이 AGENTS.md HARD-STOP과 충돌한다.
  3. 다시 열 때는 "다시 따져 본 것"과 권하는 안을 붙여 소유자에게 묻는다. 예: 2026-11-04 소유자가 수정 묶음의 기본값 셋을 다시 물었을 때, 총괄은 각각 근거를 다시 따져 적었고 소유자가 다시 정했다(docs/reviews/2026-11-03-rereview/README.md 15절).
  4. 위임·기본값으로 정한 것은 보고에 따로 적는다. 소유자가 뒤집을 수 있게 한다.
  5. 뒤집힌 결정은 원문에서 지우지 않는다. 취소선이나 "→ N절에서 바꿈"으로 새 위치를 가리킨다.
  6. 리뷰어는 정한 결정을 결함으로 다시 올리지 않는다.

2. 색인

「누가」 칸: 소유자는 소유자가 직접 정했다. 위임은 소유자가 "지금 정하고 진행하라"고 맡겨 총괄이 정했다(소유자가 뒤집을 수 있다). 기본값은 수정 묶음이 정하고 처리 표에 남겼다(소유자 확인 대상). 총괄 지시는 소유자 환경을 운영하려고 총괄 세션이 정한 작업 규칙이다. 정책은 AGENTS.md에 적힌 규칙이다.

「결정 N」은 docs/reviews/2026-09-25-review-followup-status.md 「소유자 결정」의 N번, 1101은 docs/reviews/2026-11-01-maturity-review/README.md, 1103은 docs/reviews/2026-11-03-rereview/README.md다.

2.1 작업 방식

주제 결정 누가 날짜 출처
커밋 정책 기본 human-only. 에이전트는 stage·commit·amend·push하지 않는다 정책 — AGENTS.md 「Gradle 정책 권위」 끝
커밋 예외 brief가 허용하면 그 작업의 자기 브랜치에만 커밋·push한다. main 병합·다른 브랜치 push·force push는 하지 않는다 소유자 2026-11-06 design-docs conventions/delegation-loop.md 11절, docs/work/README.md 4절
커밋 예외(지난 것) refactor/review-followup에 Wave마다 커밋(2026-09-25), 리뷰 수정을 refactor/maturity-review-2026-11에 커밋·push(2026-11-03) 소유자 2026-09-25, 2026-11-03 결정 1, 1101 17절
리뷰 발견 처리 Minor도 기록만 하지 않고 고친다. 보고할 때 남은 문제가 0이어야 한다. 수정이 새 결함을 만들면 리뷰·수정을 0까지 반복한다 소유자 2026-11-05 1103 16절
옛 멈춤 기준 "새 Important 0이면 멈춤", "Minor는 기록만" — 거둠 위임 → 소유자가 거둠 2026-11-05 1103 9.1·11.1·16절
두 repo의 종료 조건 각자 유지한다. 백엔드는 발견이 0이 될 때까지, 짝 프론트는 자기 매뉴얼의 조건 소유자 2026-11-05 2026-11-05 총괄 세션 전달(소유자 원문 "각자 유지")
무거운 실행 위치 노트북에서 Gradle·Docker를 돌리지 않는다. desktop에서 브랜치를 받아 돌린다 소유자 2026-11-05 1103 17.1절
desktop 공유 잠금 desktop의 Gradle·Docker 실행은 flock /tmp/claude-gates/heavy.lock으로 감싼다. 프론트와 부하·포트(4173·4174)가 겹치지 않게 총괄 지시 2026-11-05 2026-11-05 총괄 세션 brief, design-docs conventions/delegation-loop.md 11절
세션 분업 총괄 세션은 지휘만, 실제 작업은 하위 세션 소유자 2026-11-05 design-docs conventions/delegation-loop.md 2절
하위 에이전트 Agent 도구(세션 안의 하위 에이전트)를 쓰지 않는다. 막는 장치는 두 템플릿 repo의 프로젝트 설정(.claude/settings.json) 소유자 2026-11-06 design-docs delegation-loop/02-design.md 13절 D5
매뉴얼 체계 짧은 지도(CLAUDE.md) + 작업 종류별 playbook(docs/work/) + 예외 없는 규칙은 훅·게이트. repo 스킬 없이 시작 소유자 2026-11-06 같은 문서 D1, D4
크기별 생략 작음·중간·큼으로 사고 순서 단계를 줄인다. 크기는 맡기는 쪽이 정하고 맡은 쪽은 올리기만 한다 소유자 2026-11-06 같은 문서 D2, design-docs conventions/work-thinking-order.md
매뉴얼 검사 장치 이력 ID·분량 검사와 리뷰 색인 검사는 Gradle 밖 scripts/(check-work-docs.py, check-review-index.py) 소유자 2026-11-06 같은 문서 D6
규칙 ID 규칙마다 ID(R-…)는 아직 붙이지 않는다. 원장이 생길 때 붙인다 소유자 2026-11-06 같은 문서 D7
옛 개선 매뉴얼 브랜치 claude/improvement-manual-6ae516은 병합하지 않고 재료로만 쓴다 소유자 2026-11-06 같은 문서 D12
개선 매뉴얼을 먼저(지난 것) 다음 개선 작업 전에 repo마다 개선 매뉴얼을 만든다 → 2026-11-06 「매뉴얼 체계」로 바뀜 소유자 2026-11-05 2026-11-05 총괄 세션 brief
스킬 리뷰·수정에 알맞은 스킬을 쓴다 소유자 2026-11-05 1103 2절
@DisplayName 언어 한국어(기본값 영어를 거부) 소유자 2026-09-25 결정 5, AGENTS.md 테스트 작성 규칙 2
학습 문서 삭제된 코드를 설명하는 학습 문서(docs/study/*.ko.md, docs/*-superpowers-package/)는 현재 코드에 맞게 갱신 소유자 2026-09-25 결정 6
client 오류 문구 한국어. Category별 문구 표 하나를 shared-contract에 소유자 2026-09-25 결정 11

2.2 구조·조립

주제 결정 누가 출처
outbox relay·멱등성 executor 조립 app-bootstrap이 아니라 별도 composition:* 모듈 소유자 결정 3
새 leaf composition:durable-operation, adapter:inbound:messaging 등록 승인 위임 1101 15절
edge 없는 복사본 템플릿 leaf는 shared-contract edge를 더해 정본을 쓴다. vendored(messaging:*·grpc:*)는 복사본을 두고 family CLAUDE.md에 이유 위임 1101 15절(01-11)
caller 트랜잭션 guard persistence-notification·persistence-fileserver → persistence-jpa edge, CallerTransaction 하나 소유자 결정 33
id 포트 notification·fileserver id 포트를 domain IdFactory로 옮기지 않음(보류) 소유자 결정 34
소비자 없는 필드 principal tenant, GraphQL Spring Security resolver, 가명화 키 분리는 하지 않음(보류) 소유자 결정 35
notification TenantId 통합하지 않음. 차이와 이유는 그 타입 Javadoc 위임 1101 15절(01-03)
생성 명령 JPA adapter를 만들지 않음(서비스 전용 persistence leaf가 기본), 생성된 쓰기 API는 역할 매핑 전 403 위임 1101 15절(r2-10)
@SystemInvoked bean으로 등록돼 있으면 기동 실패, inbound adapter가 직접 부르지 못하게 ArchUnit 위임 1103 4절(RR-01-02)
시스템 호출 경로 사용자가 닿는 전송(web·GraphQL·gRPC·WebSocket)만 @SystemInvoked에 닿지 못한다. 메시지 소비자·스케줄러는 @SystemCaller(reason) 표시로 허용 위임 1103 9.1절(RR-01-12), 10절 r5-b

2.3 계약·오류

주제 결정 누가 출처
HTTP 오류 응답 Envelope 하나. fileserver problem+json도 Envelope로, tus 프로토콜 헤더만 유지 소유자 결정 2
처리 중 409 IDEMPOTENT_IN_FLIGHT는 retryable=true + Retry-After: 2, 계약 문서에 고정 소유자 1101 5절(02-01), 15절
Envelope null 필드 백엔드가 생략(NON_NULL) 소유자 1101 5절(02-02)
INTERNAL_ERROR retryable false. 일시적 실패는 전용 코드가 retryable을 가진다 소유자 결정 28
새 오류 코드 소유 코드를 쓰는 leaf의 enum. 계약은 docs/web/http-contract.md §4 위임 1101 15절
correlation ID 규칙 밖이면 서버가 새 값으로 교체 위임 1101 15절(02-11)
JSON 아닌 본문 상한 전역 상한 없음. 엔드포인트가 직접 둔다 위임 1101 15절(02-09)
GraphQL 복잡도 크기 미선언 list = 20, first·last 둘 다면 큰 쪽, per-parent 경고 임계 10 위임 1101 15절(03-01·03-03)
GraphQL DataLoader 키 실패 등록된 ApiErrorCode만 노출 소유자 결정 25
Draft-12 offset 불일치 problem 문서는 프로토콜 예외로 유지 소유자 결정 12
알림 category 생략 거부(400), 판정은 유스케이스 소유자 결정 13

2.4 멱등성

주제 결정 누가 출처
complete 단계 연결 포화 UNAVAILABLE 현재 동작 유지 + 문서화 소유자 결정 24
complete 단계 저장소 실패 "결과 불명"으로 따로 알린다(실행 전 503과 구분). 같은 키 재전송은 서버가 판정 위임 1103 4절(RR-02-03)
lease 지난 실행 중 기록 PostgreSQL·Redis store가 같은 계약: 작업을 다시 돌리지 않고 "회복 필요" 위임 1103 9.1절(RR-01-11)
Redis key TTL claim·renew 모두 key TTL ≥ max(replay TTL, processing lease), 설정 검사 위임 1103 9.1절(RR-03-11)
늦은 완료 늦게 끝난 첫 시도의 완료는 기록한다(묶음 기본값 "버린다"를 뒤집음). 다시 실행은 여전히 하지 않음 소유자 1103 15절 ①
보존 기간 관계 failure-retention < replay-ttl이면 기동 실패 소유자 1103 15절 ③
같은 attempt 재claim lease 지난 CLAIMED·FAILED_RETRYABLE을 넘겨받는다. 같은 attempt를 두 호출이 동시에 쓰는 것은 호출자 계약 기본값 1103 17절 r10-02
다른 핸들의 시작 답 PostgreSQL도 Redis와 같게 NOT_OWNER/NOT_CLAIMED로 답한다 기본값 1103 17절 r10-02
Redis 연결 예산 캐시 조건부 쓰기는 멱등성·lease와 다른 연결 예산(SCRIPT lane) 위임 1103 4절(RR-04-02)

2.5 영속성

주제 결정 누가 출처
JPA 기본값 트랜잭션 제한 30초, JDBC batch 50, H2 운영 jar 제거, 격리 수준 Hikari 고정, upsert DO NOTHING 후 갱신 위임 1101 15절(04)
포트 시그니처 claim에 lease·claimFence, fileserver claimDue·markAbandoned·claimToken 위임 1101 15절
마이그레이션 번호 스트림별 순번. 샘플은 운영 스트림과 합쳐 도는 테스트가 있어 V8_1. notification은 V13 위임 1101 15절
V21 유일 인덱스 기존 중복이 있으면 마이그레이션 실패. runbook에 확인 쿼리 위임 1101 15절
순서 번호 seed counter가 없으면 전역 floor부터 위임 1103 4절(RR-03-02)
마이그레이션 잠금 강한 잠금을 거는 마이그레이션은 SET LOCAL lock_timeout, 같은 모양의 lane 테스트 위임 1103 9.1절(RR-02-09)
Flyway PostgreSQL 잠금 세션 수준(transactional-lock: false). 전제: Hikari 직접 연결. transaction-mode PgBouncer 뒤에서는 깨진다 기본값 1103 17절 r10-03(RR6-03-01)
persistence-jpa 설정 prefix 플랫폼 자체는 app.persistence-jpa.*, 공유 기능은 기능 트리(app.outbox·app.lock·app.realtime.replay) 소유자 결정 36
분산 lock·lease 둘 다 capability로 유지, 공통 계약 테스트 소유자 결정 8

2.6 샘플·메시징·보안·설정

주제 결정 누가 출처
포스터 업로드 abort·reconcile 경합 먼저 끝난 쪽이 이김(이미 게시됐으면 abort는 409) 소유자 결정 22
work log 권한·batch 관리자도 남의 work log 수정 불가, batchCreate 상한 1000·한 트랜잭션 위임 1101 15절(09)
이벤트 tenant·오류 코드 이벤트 tenant 범위 global, WORKLOG_INVALID·OPERATION_NOT_FOUND 위임 1101 15절(01)
outbox append 모델 canonical(OutboxAppendPort)로 통일, legacy 포트·legacy Kafka 발행 경로 삭제 소유자 결정 7
Kafka 소비 지원. MessageHandler<T> 하나 + starter-kafka가 consumer 조립 소유자 결정 10
decode 타입 등록 handler bean이 선언한 타입으로 decode 목록을 만든다 위임 1101 15절(06-08 후속)
relay 재시도 재시도 가능 거부는 무한 재시도(5분 간격), 예산 설정 키 없음, 인증 오류는 경보로 위임 1101 15절(06-01·06-03)
끝나지 않는 재시도 bridge가 원인 코드를 행에 남기고, 오래 재시도 중인 행 수·나이를 지표로, runbook에 park·재개 절차와 테스트된 SQL 위임 1103 4절(RR-05-03)
카드 검증기 YAML messaging leaf 테스트에서만 snakeyaml(main 금지) 소유자 결정 29
JWT audience·role audience 필수, 자기 client role만(기존 배포는 env 하나를 채움) 소유자 1101 5절(02-03), 15절
데모 계정 local·test·demo 프로필이 명시적으로 켜졌을 때만(허용 목록). 각 프로필은 sample이 실제로 뜨는 프로필 위임 1103 4절(RR-07-02), 9.1절(RR2-04-02)
fixture- 값 거부 비밀로 분류된 키(docs/registries/secrets-classification.yaml)만 검사 위임 1103 9.1절(RR2-04-01)
파일 서버 인가 역할 검사(file:* 권한)와 소유자·tenant 검사(ownerPrincipalId)를 둘 다 소유자 결정 14, 결정 32
cross-origin redirect 호출자 헤더 전부 제거, 안전한 헤더만 유지 소유자 결정 23
개발 compose Redis lane Redis에 ACL 계정, "기동 WARN 없음" 검사 유지 위임 1101 15절(r3-J)
서블릿 오류 디스패치 보안 체인이 ERROR 디스패치만 허용 기본값 1103 6절 r4-b, 8절
설정 prefix app.*로 통일, APP_* env 키 유지 소유자 결정 16
Redis prefix 예외 app.redis.*·app.capabilities.*·app.rate-limit.* 세 트리 유지, 네 번째 금지 위임 1101 15절(05-18), AGENTS.md capability 기준 4
로그 설정 logback이 app.logging.*을 읽음, APP_CACHE_REDIS_TTL_JITTER deprecated 위임 1101 15절(07)
빈 env 값 선택 숫자 설정의 빈 값은 "미설정". 오타·모르는 키 거부는 그대로 위임 1101 15절
APP_FLYWAY_ENABLED dev·prod에도 적용 위임 1101 15절(r3-F)
전송 상한 기본값 gRPC 스레드 32·큐 256·동시 100·deadline 10s·drain 2s, ledger claimTtl 5m·보존 24h, WebSocket max-connections 1000(초과 시 1013) 위임 1101 15절(03-06·03-09·03-10)

2.7 빌드·게이트·capability

주제 결정 누가 출처
빌드 게이트 verifyEnvKeys는 app-bootstrap 태스크로 유지(구현은 build-logic ca.config-contract), JPA evidence manifest는 폐기하고 leaf 테스트로, redis topology lane 유지 소유자 결정 4
API surface 단계 PR(leaf check 안) 소유자 결정 20
PR ci 범위 변경 모듈만 돌리지 않음. 전체 실행 + Gradle 캐시(보류) 소유자 결정 30
의존성 checksum 추가 안 함(보류) 소유자 결정 19
build-logic 의존성 잠금 잠그지 않음 + 문서화(보류) 소유자 결정 27
릴리스 이미지 서명 cosign keyless, tag 릴리스에서 서명·검증 소유자 결정 31
gRPC .proto protobuf Gradle 플러그인 + Buf(CI) 소유자 결정 18
SpotBugs 신뢰도 MEDIUM으로 내림. 패턴 단위 제외는 이유를 단다 위임 1101 15절(08-07)
테스트 코드 정적 분석 testQualityCheck는 main 빌드 mainCheck, optional 빌드 ci 위임 1103 14절
lane 정책과 캐시 lane 정책 값(rejectSkipped 등)은 모두 캐시 입력 위임 1103 4절(RR-06-02)
workflow 명령의 빌드 판정 같은 셸의 cd <상대 경로>도 따라간다 소유자 1103 15절 ②
문서 파싱 검사 문서를 파싱해 대조하는 Gradle 검사를 두지 않는다(verifyDocumentedLeafCount 등 삭제). 문서와 코드 대조는 leaf의 document-contract lane 정책 AGENTS.md 「Gradle 정책 권위」
MinIO 이미지 pgsty/minio digest 위임 1101 15절(05-09)
Jackson 2 기본 jar에 남김(logstash encoder·springdoc 요구) 위임 1101 15절(09-11)
httpclient reactive 삭제 소유자 결정 9
SES 연동 AWS SDK(sesv2) 소유자 결정 17
durable operation HTTP 어댑터 추가, 설계 4개(서버 생성 id, payload 지문으로 재제출 판정, 고정 event type, 1일 보존) 승인 소유자 결정 15, 결정 26
알림 provider profile 소실 일반 재시도 정책 후 FAILED 소유자 결정 21
notification INGEST_ONLY runtime 없이도 accept 때 route 이름 기록 위임 1101 15절(r3-I)
파일 서버 쿼터 상한 미설정 = 무제한, 동시 예약은 상한을 넘을 수 있음, 정리 worker 기본 켜짐 위임 1101 15절(r2-05a)
objectstorage provider type 하나 추가 위임 1101 15절(05-16)
에이전트가 원칙에서 바로 정한 것 Kafka 주소 키 하나, composition이 persistence-jpa를 함께 가져옴 등 7건 기본값 docs/reviews/2026-09-25-review-followup-status.md 「소유자 결정」 끝 목록
묶음별 기본값 각 라운드 처리 표의 「결정」 칸(예: SES replay 창 1h, Retry-After 30) 기본값 1101 13·14·16절, 1103 6·10·12·15·16·17절 표

3. 새 결정을 기록하는 법

누가 정하나

소유자에게 묻는다 직접 정하고 기록한다
공개 계약·wire 형식 변경, 파생 서비스 동작을 바꾸는 기본값, 보안 정책, 새 leaf, 커밋 정책, 되돌리기 비싼 선택, 비용이 드는 외부 일 기존 원칙에서 바로 따라 나오는 것, 결함 수정의 구현 방법, 문서 위치

묻는 법: 항목 · 선택지 · 권하는 안과 이유 · 정할 사람을 한 표로 쓴다.

어디에 쓰나

결정의 종류 위치
리뷰 라운드에서 나온 결정 그 라운드 README의 「결정」 절. 항목 · 결정 · 이유 · 버린 대안
수정 묶음의 구현 기본값 처리 표의 「결정」 칸
되돌리기 비싼 아키텍처 선택 docs/adr/ADR-<영역>-<번호>-<제목>.md(기존 번호를 잇는다)
매뉴얼을 만들거나 고치며 정한 것 이 색인 + 근거는 docs/work/evidence.md
여러 repo와 소유자 운영에 걸친 결정 design-docs

기록한 뒤: 이 색인에 한 줄(주제 · 결정 · 누가 · 날짜 · 출처)을 더한다.