docs(work): 저장소 정리 결정 중 색인에 없던 행을 더한다
문제: 소유자가 2026-11-07에 정한 저장소 정리 결정(design-docs `repo-structure/README.md` 3.1·3.2절) 중 문서 체계 결정이 결정 색인에 없다. 배치 결정 중 「업무 기능 하나가 끝까지 도는 별도 fixture를 두지 않는다」도 없다. 색인에 없으면 다음 세션이 이미 정한 것을 다시 묻는다. 고친 방법: 없는 결정만 「소유자」, 2026-11-07, 출처 3.1·3.2절로 더한다. - 2.1 작업 방식: 문서 체계, 한국어의 범위(상태 어휘 포함), 문서 검사, 학습 문서(지금 결정. 「학습 문서(지난 것)」 행은 그대로 둔다), 문서 규칙 정본, 레지스트리 yaml 설명 칸, 짝 프론트 적용 시점, README 필수 절. 비슷한 두 결정(목표 구조와 폴더 이름, 한국어 범위와 상태 어휘)은 한 행에 묶었다. - 2.2 구조·조립: 기능 끝까지 도는 fixture. 3.3절(CI·스크립트) 결정은 CI 재편 작업에 남긴다. 검증: check-work-docs.py rc=0(이력 ID 0), check-docs.py rc=0.
This commit is contained in:
@@ -57,6 +57,14 @@
|
||||
| 스킬 | 리뷰·수정에 알맞은 스킬을 쓴다 | 소유자 | 2026-11-05 | `1103` 2절 |
|
||||
| `@DisplayName` 언어 | 한국어(기본값 영어를 거부) | 소유자 | 2026-09-25 | 결정 5, `AGENTS.md` 테스트 작성 규칙 2 |
|
||||
| 학습 문서(지난 것) | 삭제된 코드를 설명하는 학습 문서(지금 `docs/history/study/*.ko.md`, `docs/history/packages/*-superpowers-package/`)는 현재 코드에 맞게 갱신 → 2026-11-07 갱신하지 않고 기록으로 보관(머리 블록만 단다)으로 바뀜 | 소유자 | 2026-09-25 | 결정 6, design-docs `repo-structure/README.md` 3.2절 |
|
||||
| 문서 체계 | 문서를 수명으로 나눈다. 살아 있는 문서는 제자리에 두고 한국어로 옮긴다. 기록은 `docs/history/`, 설계서는 `docs/design/`, 결정 기록은 `docs/adr/`에 둔다. 폴더 이름은 짝 프론트와 같이 쓴다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절, 적용은 `docs/README.md` |
|
||||
| 한국어의 범위 | 살아 있는 문서는 본문까지 한국어로 쓴다. 기록 문서는 맨 위에 한국어 머리 블록(상태·작성일·요약·현재 정본)을 달고 본문은 원문 그대로 둔다. 상태는 한국어 고정 어휘다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절 |
|
||||
| 문서 검사 | 언어·머리 블록·참조·숫자 검사를 PR에서 실패로 둔다(`scripts/check-docs.py`, workflow `docs-check`) | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절, `docs/README.md` 「문서 검사」 |
|
||||
| 학습 문서 | `docs/history/study/`에 기록으로 보관한다. 코드에 맞춰 갱신하지 않고 머리 블록만 단다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절 |
|
||||
| 문서 규칙 정본 | design-docs `conventions/docs-system.md`(두 템플릿 공통). 이 repo의 적용은 `docs/README.md`에 적는다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절 |
|
||||
| 레지스트리 yaml 설명 칸 | 번역한다. 그 칸을 읽는 테스트를 먼저 찾는다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절 |
|
||||
| 짝 프론트 문서 체계 적용 | 백엔드 번역을 끝낸 뒤 한다. 프론트 README와 `docs/README.md`만 먼저 같이 한다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절 |
|
||||
| README 필수 절 | 루트 README는 「프로젝트 구조」 절과 「문서 지도」 절을 둔다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절, `docs/README.md` |
|
||||
| client 오류 문구 | 한국어. `Category`별 문구 표 하나를 shared-contract에 | 소유자 | 2026-09-25 | 결정 11 |
|
||||
| 확인 리뷰 독립 리뷰어 둘 | 세 경우에 서로 결과를 보지 않는 리뷰어 둘이 같은 범위를 리뷰하고 총괄이 합친다: 반복을 멈추기 직전 확인 리뷰(리뷰어 하나가 0을 내면 두 번째가 본다), 수정 diff가 상한에 가까운 리뷰("가까움"은 추가 1,000줄 이상 — 기본값), Critical·Important를 고친 수정의 리뷰. 그 밖은 하나. 2~3라운드 두 리뷰의 겹침 비율을 기록하고 그 결과로 언제나 하나·언제나 둘로 옮길지 다시 본다 | 소유자 | 2026-11-07 | 2026-11-07 총괄 세션 전달(소유자 원문 "(c)로 받기"), `docs/work/improve.md` 4.1·4.5절, `docs/work/delegate.md` 4.1절 |
|
||||
|
||||
@@ -79,6 +87,7 @@
|
||||
| 개발 compose 파일 | 저장소 루트에 `compose.yaml` 하나. 뒷단 서비스는 capability 이름 profile로 고르고, 마운트하는 보조 파일은 `compose/`에 둔다. 테스트 lane fixture는 그 lane을 가진 leaf로 보낸다(compose lane → app-bootstrap `compose-lanes/`, Redis topology → redis-sdk, NFS → fileserver). `docker-compose.dev.yml`은 `dev` 배포 프로필이 뜨는지 보는 lane fixture로 app-bootstrap에 둔다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.3절 |
|
||||
| 인프라 실행 파일 | nginx 설정, Kubernetes PVC job, DB 역할 SQL은 이 repo에서 지우고, 기능이 운영 환경에 요구하는 조건만 그 기능 문서에 적는다. 아무도 쓰지 않는 infra 폴더 파일도 지운다. 지운 목록은 `docs/upgrade/2026-11-maturity-review.md` B-50 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.3절 |
|
||||
| 샘플 모듈 | 샘플 leaf와 샘플 전용 Dockerfile을 폴더째 지운다(지운 경로는 `docs/upgrade/2026-11-maturity-review.md` B-49). 역할은 옮기지 않는다. 샘플 안에만 있던 템플릿 검사(OpenAPI 스냅숏, Date 헤더, 가상 스레드 MDC)도 함께 지운다. 예시는 매뉴얼과 생성 명령 출력이 맡는다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.2절 |
|
||||
| 기능 끝까지 도는 fixture | 업무 기능 하나가 끝까지 도는 별도 fixture를 두지 않는다. durable operation 조립 테스트가 같은 경로를 실제 PostgreSQL로 본다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절 |
|
||||
|
||||
### 2.3 계약·오류
|
||||
|
||||
|
||||
Reference in New Issue
Block a user