diff --git a/.github/workflows/docs-check.yml b/.github/workflows/docs-check.yml new file mode 100644 index 00000000..932a3fa6 --- /dev/null +++ b/.github/workflows/docs-check.yml @@ -0,0 +1,28 @@ +name: docs-check + +# Document language, record head blocks, references and copied numbers (scripts/check-docs.py). +# It runs on every pull request, not on a docs/** path filter: deleting a file or a Gradle project +# in code is exactly what makes a living document point at nothing, and that change touches no +# document. The checker is plain Python outside Gradle, because the build does not parse documents. +on: + pull_request: + push: + branches: ["main"] + workflow_dispatch: + +permissions: + contents: read + +concurrency: + group: ${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: true + +jobs: + docs: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2 + - name: Test the document checker + run: python3 -m unittest discover -s scripts/tests + - name: Check documents + run: python3 scripts/check-docs.py diff --git a/.gitignore b/.gitignore index 8b8a6e09..f22be9da 100644 --- a/.gitignore +++ b/.gitignore @@ -18,3 +18,7 @@ src/.env.lane graphify-out/ src/graphify-out/ .playwright-mcp/ + +# Python bytecode from running scripts/ checks; never committed. +__pycache__/ +*.pyc diff --git a/AGENTS.md b/AGENTS.md index 63aa22c6..ce0f3085 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -169,8 +169,8 @@ Gradle 의존성 검증도 같은 registry를 읽는다. root 문서나 기억 1. 요구사항을 읽고 소유 계층을 판단한다. 2. 구조나 동작이 바뀌면 `superpowers:brainstorming`으로 설계를 먼저 확정한다. -3. 여러 단계의 작업이면 `docs/superpowers/specs/`에 설계 문서를 남긴다. -4. 구현 전 `docs/superpowers/plans/`에 실행 계획을 작성한다. +3. 여러 단계의 작업이면 `docs/design/`에 설계 문서를 남긴다. 맨 위에 머리 블록(상태·작성일·요약·현재 정본)을 단다. +4. 실행 계획이 필요하면 구현 전 `docs/history/plans/`에 둔다. 계획서도 머리 블록을 단다. 머리 블록 형식은 `docs/README.md`다. 5. 동작 변경은 테스트를 먼저 작성한다. 6. 새 비즈니스 개념은 `domain-core`에 먼저 둔다. 7. 유스케이스는 `application-core` command와 use case/service method로 표현한다. @@ -246,7 +246,7 @@ leaf의 `check`는 그 leaf만 검사한다. 저장소 전체 질문은 이름 Redis, Kafka, JPA 같은 부가 기능은 "의존성을 붙이면 켜지고, 떼면 사라지는 모듈"로 제공한다. 각 서비스는 `app-bootstrap/build.gradle`에 필요한 모듈만 `runtimeOnly` 한 줄로 고른다. -설계 근거는 `docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md`. +설계 근거는 `docs/design/2026-09-25-capability-module-packaging-design.md`. 템플릿 기본 조립은 web에서 쓰는 부분뿐이다: `adapter:inbound:web`, 운영 관측(actuator·metrics· tracing·로그), `domain-core`·`application-core`·`shared-contract`, `adapter:outbound:support`· diff --git a/CLAUDE.md b/CLAUDE.md index d9d9826a..6458871f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,7 +4,7 @@ ## 1. 이 repo -- Java 21 + Spring Boot 4.0.8 Gradle 멀티모듈 Clean Architecture 백엔드 템플릿이다. 서비스는 이 repo를 받아 도메인을 채운다. +- Java 21 + Spring Boot Gradle 멀티모듈(버전은 `src/gradle/libs.versions.toml`) Clean Architecture 백엔드 템플릿이다. 서비스는 이 repo를 받아 도메인을 채운다. - Gradle 루트는 `src/`다. Gradle 명령은 `src/`에서 실행한다. - 규칙의 정본은 `AGENTS.md`다. leaf 목록·경로·허용 의존의 정본은 `src/config/architecture/modules.json`(registry)이다. 각 leaf의 지역 규칙은 가장 가까운 `src/**/CLAUDE.md`가 정한다. @@ -51,6 +51,7 @@ brief(작업 지시문)가 있으면 brief의 범위·크기·완료 기준이 - 공개 경로 검사와 env 키 검사는 그 표면이 바뀌었을 때 돌린다. 전체 `test`·`check`·`ci`는 brief가 시킬 때 돌린다. - 게이트 목록(`ci`, `mainCheck`, `integrationCheck`, `performanceCheck`, `releaseCheck` 등)과 바꾼 것에 맞는 게이트는 [docs/work/reference/gates.md](docs/work/reference/gates.md)다. - `docs/work/`, 이 파일, `AGENTS.md`, `src/**/CLAUDE.md`를 고쳤으면 `python3 scripts/check-work-docs.py`를 돌린다(분량, 본문 이력 ID 0, 상대 링크). +- 문서(`.md`)나 문서가 가리키는 경로·Gradle 프로젝트를 바꿨으면 `python3 scripts/check-docs.py`를 돌린다(언어, 기록의 머리 블록, 참조, 복사한 숫자). PR마다 `docs-check` workflow가 같은 검사를 돈다. 규칙은 [docs/README.md](docs/README.md)다. ## 5. 코드만 보고는 헷갈리는 곳 @@ -64,7 +65,7 @@ brief(작업 지시문)가 있으면 brief의 범위·크기·완료 기준이 - **성능 lane에는 단언을 끄는 스위치가 없다.** convention이 상한을 매번 단언하고, `performance.assertions.enabled`에 `true` 아닌 값이 들어오거나 skip이 있으면 테스트 전에 실패한다. 손으로 돌리든 workflow든 같다(`AGENTS.md` 「Gradle 정책 권위」). - **저장소 파일을 읽는 테스트는 태그가 있다.** 문서와 대조하는 테스트는 `document-contract`(main 단계 `mainCheck`), 빌드 스크립트·workflow를 읽는 테스트는 `repository-contract`(PR)다. 문서를 고치면 그 문서를 읽는 테스트를 찾는다. - **커밋 정책은 `human-only`다.** brief가 허용한 것만 자기 브랜치에 한다. 커밋과 push는 따로 허용된다. 자세한 것은 [docs/work/README.md](docs/work/README.md) 4절이다. -- **문서 위치 규칙은 [docs/README.md](docs/README.md)다.** 설계서는 `docs/superpowers/specs/`, 결정 기록은 `docs/adr/`, 리뷰는 `docs/reviews/`, 파생 서비스용 변경 안내는 `docs/upgrade/`다. +- **문서 위치 규칙은 [docs/README.md](docs/README.md)다.** 설계서는 `docs/design/`, 결정 기록은 `docs/adr/`, 리뷰는 `docs/reviews/`, 고치지 않는 기록(계획서·납품 패키지·증거·학습)은 `docs/history/`, 파생 서비스용 변경 안내는 `docs/upgrade/`다. 기록은 맨 위 머리 블록만 고친다. ## 6. 소유자 환경 diff --git a/docs/README.md b/docs/README.md index eb2e413c..d098e065 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,7 +1,8 @@ # docs -저장소의 모든 문서는 이 디렉터리 아래에 있다. 어떤 문서를 어디에 두는지가 유일한 규칙이고, -파일 목록은 디렉터리를 직접 읽는다. 개수를 여기에 적으면 다음 문서가 추가되는 순간 틀린 글이 된다. +저장소의 모든 문서는 이 디렉터리 아래에 있다. 규칙은 둘이다: 어떤 문서를 어디에 두는지(아래 표), +문서의 수명에 따라 무엇을 어떤 언어로 고치는지(「문서 수명과 언어」). 파일 목록은 디렉터리를 직접 읽는다. +개수를 여기에 적으면 다음 문서가 추가되는 순간 틀린 글이 된다. ## 어댑터별 운영 문서 @@ -26,29 +27,119 @@ | `architecture/` | 공개 API 표면 스냅숏 | | `work/` | 작업 매뉴얼: 이 repo에서 하는 일(새 기능, 개선, 조사·설계, 문서 작성, 운영, 총괄)의 절차서. 루트 `CLAUDE.md` 다음에 읽는다 | | `manual/` | 개발 매뉴얼: 새 기능을 만드는 순서와 판단 지점, 생성 명령(`scripts/new-feature.sh`). 입구는 `work/new-feature.md` | -| `evidence/` | 작업 단계별 증거·체크포인트 | | `registries/` | env 키·에러 코드·메트릭·헤더 등 레지스트리 SSOT | | `reviews/` | 모듈 코드 리뷰 결과 | | `runbooks/` | 장애 코드별 대응 런북 (`template.md` 기준) | | `security/` | 공개 경로 스냅숏 | -## 설계와 계획 +## 설계와 기록 + +설계서와 기록은 쓴 때의 글이다. 지금 동작을 설명하지 않는다. 그래서 살아 있는 문서와 다른 폴더에 둔다. | 디렉터리 | 대상 | | --- | --- | -| `superpowers/specs/` | 설계서. `YYYY-MM-DD-<주제>-design.md` | -| `superpowers/plans/` | 구현·확장 계획서. `YYYY-MM-DD-<주제>-plan.md` | -| `superpowers/packages/` | 외부에서 납품된 설계 패키지의 README와 정적 검증 결과 | +| `design/` | 설계서. `YYYY-MM-DD-<주제>-design.md` | +| `history/plans/` | 구현·확장 계획서. `YYYY-MM-DD-<주제>-plan.md` | +| `history/packages/` | 외부에서 납품된 설계 패키지의 README와 정적 검증 결과 | +| `history/evidence/` | 작업 단계별 증거·체크포인트 | +| `history/study/` | 학습 문서. 쓴 때의 코드를 따라 읽은 기록이다 | -`superpowers/packages/<어댑터>/` 는 설계서가 처음 전달됐을 때의 안내와 `VALIDATION.md` 검증 이력을 -남긴 기록 보관소다. 설계서·계획서 본문은 전부 `specs/` 와 `plans/` 에 있으므로 이 디렉터리에서 +`history/packages/<어댑터>/` 는 설계서가 처음 전달됐을 때의 안내와 `VALIDATION.md` 검증 이력을 +남긴 기록 보관소다. 설계서·계획서 본문은 전부 `design/` 과 `history/plans/` 에 있으므로 이 디렉터리에서 문서를 찾을 필요는 없다. 각 README 상단의 보존 안내가 무엇이 옮겨졌고 무엇이 제거됐는지 밝힌다. +`history/packages/*-superpowers-package/` 셋은 납품된 묶음 그대로이고, 그 안의 `MANIFEST.sha256` 은 +납품 당시 바이트의 해시다. 계획서 본문에는 당시 계획한 경로와 명령이 그대로 남아 있다. 그중 일부는 실제 구현에서 다른 위치로 조정됐고, 저장소에 어떻게 대응시켰는지는 각 어댑터의 `repository-adaptation.md` 또는 `module-mapping.md` 가 기록한다. 계획서를 사후에 고치지 않는 이유는 그렇게 하면 계획의 기록이 아니라 결과를 계획처럼 보이게 만든 글이 되기 때문이다. +## 문서 수명과 언어 + +규칙의 정본은 design-docs `conventions/docs-system.md`다. 이 절은 이 repo에 적용한 내용이고, +이 템플릿을 받은 파생 서비스도 이 절을 따른다. + +| 수명 | 문서 | 위치 | 언어 | 고치는 법 | +| --- | --- | --- | --- | --- | +| 살아 있음 | README, `CLAUDE.md`, `AGENTS.md`, 매뉴얼(`manual/`, `work/`), 영역 운영 문서, `registries/`, `runbooks/`, `upgrade/` | 제자리 | 한국어 | 코드와 같은 변경에서 고친다 | +| 결정 | 결정 기록(ADR) | `adr/`, `notification/adr/` | 한국어 | 본문은 고치지 않는다. 일부가 바뀌면 상태를 「채택(보완)」으로 하고 보완 절을 덧붙인다. 크게 바뀌면 새 ADR을 쓰고 옛 ADR을 「대체됨」으로 한다 | +| 기록 | 설계서, 계획서, 납품 패키지, 증거, 학습 문서, 리뷰 | `design/`, `history/`, `reviews/` | 머리 블록은 한국어, 본문은 쓴 때의 원문 | 머리 블록의 칸만 고친다 | + +- 코드 식별자, 명령, 경로, 설정 키, 오류 코드, 로그·출력 인용, 제품 이름은 원문으로 둔다. +- 문체는 「~한다」다. 한 문서 안에서 「~합니다」와 섞지 않는다. +- 아직 한국어로 옮기지 않은 살아 있는 문서와 ADR은 문서 검사의 예외 목록에 있다(「문서 검사」). + +## 기록 문서의 머리 블록 + +`design/`, `history/`, `adr/`, `notification/adr/`의 `.md` 파일은 맨 위에 이 블록을 둔다. +블록을 빼면 원문 그대로다(옮길 때 깨진 상대 링크의 대상만 고쳤다). + +```text + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 구현됨 +- 작성일: 2026-08-11 +- 요약: 한국어 한 문장 +- 현재 정본: `docs/jpa/repository-adaptation.md` +- 대체됨: `docs/design/<대체한 문서>.md` + +``` + +- 종류는 폴더가 정하고 둘째 줄에 굵게 적는다: `design/` 설계서, `history/plans/` 계획서, + `history/evidence/`·`history/plans/evidence/` 증거, `history/packages/` 납품 패키지, + `history/study/` 학습 문서. ADR의 둘째 줄은 + `> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.`다. +- 상태는 종류마다 고정 어휘다. + + | 종류 | 상태 | + | --- | --- | + | 설계서 | 제안 · 채택 · 구현됨 · 보류 · 폐기 · 대체됨 · 확인 안 함 | + | 결정 기록 | 제안 · 채택 · 채택(보완) · 폐기 · 대체됨 | + | 계획서 | 실행 중 · 끝남 · 중단 · 대체됨 · 확인 안 함 | + | 납품 패키지 · 증거 · 학습 문서 | 보관 | + +- 「현재 정본」은 지금 동작을 설명하는 살아 있는 문서의 경로다. 여럿이면 쉼표로 잇고, 없으면 「없음 — 이유」로 쓴다. +- 「대체됨」은 상태가 대체됨일 때 대체한 문서의 경로다. 이 문서가 다른 문서를 대체했으면 「대체」 칸에 그 경로를 쓴다. +- 상태는 그 결정을 바꾼 변경이 같이 바꾼다. 기능을 지우는 커밋이 그 기능의 설계서를 「폐기」나 「대체됨」으로 바꾼다. +- 2026-11-07에 처음 단 상태는 문서의 원래 상태 줄을 바꾼 값이다: Accepted·Approved·확정·승인 → 채택, + Superseded → 대체됨, Proposed → 제안, implemented → 구현됨, 보완 메모가 있는 ADR → 채택(보완). + 상태 줄이 없던 설계서와 체크 상자가 모두 표시되지 않은 계획서는 「확인 안 함」이다. + `capability-status.md` 「제거된 코드」로 지운 것이 확인된 설계서 다섯은 「폐기」다. +- 리뷰(`reviews/`)는 아직 머리 블록을 요구하지 않는다. + +## 문서와 코드를 같은 변경에서 고친다 + +- 코드나 규칙을 바꾸는 변경이 그것을 설명하는 살아 있는 문서도 고친다. 찾는 법: + `grep -rn '<바꾼 이름>' docs src --include=*.md`. +- 살아 있는 문서는 지금 있는 것만 쓴다. 지운 타입·경로·태스크는 `capability-status.md` 「제거된 코드」나 + `upgrade/`에 쓴다. 살아 있는 문서 안에서 꼭 써야 하면 `> 이력` 으로 시작하는 인용 블록 안에 쓴다. +- 숫자·버전을 복사하지 않는다. Spring Boot 버전은 `src/gradle/libs.versions.toml`, leaf 목록과 개수는 + registry(`src/config/architecture/modules.json`)를 가리킨다. +- 루트 README는 「프로젝트 구조」(최상위 폴더와 `src/` 폴더가 하는 일)와 「문서 지도」(매뉴얼·계약·운영·결정·기록이 + 어디 있나) 절을 반드시 둔다. 전체 절 목록과 순서는 design-docs `conventions/docs-system.md` 6절이다. + +## 문서 검사 + +`python3 scripts/check-docs.py`가 위 규칙 중 기계로 볼 수 있는 넷을 본다. PR마다 workflow `docs-check`가 +돌리고, 하나라도 걸리면 실패한다. 경로 필터가 없다: 코드에서 파일이나 Gradle 프로젝트를 지우는 변경이 +문서를 낡게 만든다. + +| 검사 | 보는 것 | +| --- | --- | +| `language` | 살아 있는 문서와 ADR 본문이 한국어인가(코드·명령·경로·인용은 세지 않는다) | +| `head` | 기록과 ADR 맨 위의 머리 블록: 칸, 상태 어휘, 날짜, 한국어 요약, 현재 정본·대체됨 경로가 있는지 | +| `reference` | 살아 있는 문서의 인라인 코드 안 경로(`src/`, `docs/`, `scripts/`, `infra/`, `.github/`로 시작)와 Gradle 경로가 지금 트리·registry에 있는가. 코드 블록, `> 이력` 인용 블록, 제거 표, `upgrade/`는 보지 않는다 | +| `number` | 살아 있는 문서가 Spring Boot 버전이나 leaf 개수를 복사했는가 | + +- 하나만 돌리기: `python3 scripts/check-docs.py --only head`. +- 예외 목록 `scripts/check-docs-exceptions.txt`는 2026-11-07의 기준선이고 줄기만 한다. 문서를 번역하거나 고쳐서 + 더는 걸리지 않으면 그 줄을 지운다(남겨 두면 실패한다). 목록에 새 줄을 더하면 실패한다. 기준선을 늘리는 것은 + 규칙을 바꾸는 일이라 소유자 결정이 필요하다. +- 검사 자신의 시험: `python3 -m unittest discover -s scripts/tests`. +- 마크다운 상대 링크는 이 검사가 아니라 lychee(`link-check` workflow)와 `scripts/check-work-docs.py --links`가 본다. + ## 여기에 없는 것 - 실행되는 검증 스크립트는 문서가 아니다. `scripts/` 와 `.github/scripts/` 에 있다. diff --git a/docs/adr/ADR-BUILD-001-one-convention-for-shared-test-code.md b/docs/adr/ADR-BUILD-001-one-convention-for-shared-test-code.md index 8e722cca..2e109b0a 100644 --- a/docs/adr/ADR-BUILD-001-one-convention-for-shared-test-code.md +++ b/docs/adr/ADR-BUILD-001-one-convention-for-shared-test-code.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-09-07 +- 요약: 공유 테스트 코드는 java-test-fixtures 한 가지 방식으로 둔다는 결정이다. +- 현재 정본: `src/build-logic/README.md` + + # ADR-BUILD-001: `java-test-fixtures` is the standard for shared test code - Status: Accepted diff --git a/docs/adr/ADR-GQL-001-graphql-context-and-storage-ownership.md b/docs/adr/ADR-GQL-001-graphql-context-and-storage-ownership.md index cacb5f0f..57af5bc7 100644 --- a/docs/adr/ADR-GQL-001-graphql-context-and-storage-ownership.md +++ b/docs/adr/ADR-GQL-001-graphql-context-and-storage-ownership.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-24 +- 요약: GraphQL context는 inbound에 두고 객체 권한 판단은 application-core로 옮긴다는 결정이다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # ADR-GQL-001 — GraphQL context stays inbound; object authorization moves to application-core; the persisted-operation store stays an inbound SPI - Status: Accepted diff --git a/docs/adr/ADR-GRPC-001-platform-family-and-registry-shape.md b/docs/adr/ADR-GRPC-001-platform-family-and-registry-shape.md index f2eabfde..c45ff9c8 100644 --- a/docs/adr/ADR-GRPC-001-platform-family-and-registry-shape.md +++ b/docs/adr/ADR-GRPC-001-platform-family-and-registry-shape.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-30 +- 요약: gRPC 플랫폼을 adapter leaf 하나가 아니라 registry에 등록한 family로 낸다는 결정이다. +- 현재 정본: `docs/compatibility/grpc-support-matrix.md` + + # ADR-GRPC-001: The gRPC platform ships as a registered family, not as one adapter leaf - Status: accepted diff --git a/docs/adr/ADR-GRPC-002-schema-governance-without-protoc.md b/docs/adr/ADR-GRPC-002-schema-governance-without-protoc.md index 5e3b523e..82641867 100644 --- a/docs/adr/ADR-GRPC-002-schema-governance-without-protoc.md +++ b/docs/adr/ADR-GRPC-002-schema-governance-without-protoc.md @@ -1,3 +1,13 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 대체됨 +- 작성일: 2026-08-30 +- 요약: protoc와 Buf CLI 없이 스키마를 관리하려던 결정이다. 2026-09-28 Gradle protobuf plugin과 buf로 바뀌었다. +- 현재 정본: `docs/compatibility/grpc-support-matrix.md` +- 대체됨: `docs/capability-status.md` + + # ADR-GRPC-002: Schema governance runs without protoc and without the Buf CLI - Status: **superseded (2026-09-28)** by owner decision 18 of the 2026-09-25 review follow-up diff --git a/docs/adr/ADR-GRPC-003-three-axis-execution-evidence.md b/docs/adr/ADR-GRPC-003-three-axis-execution-evidence.md index e4f6d50d..9a944e96 100644 --- a/docs/adr/ADR-GRPC-003-three-axis-execution-evidence.md +++ b/docs/adr/ADR-GRPC-003-three-axis-execution-evidence.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-30 +- 요약: 전송·업무·스트림 증거를 서로 대신하지 않는 세 축으로 본다는 결정이다. +- 현재 정본: `docs/compatibility/grpc-support-matrix.md` + + # ADR-GRPC-003: Transport, business and stream evidence are three axes, and none implies another - Status: accepted diff --git a/docs/adr/ADR-GRPC-004-retry-ownership-and-durable-idempotency.md b/docs/adr/ADR-GRPC-004-retry-ownership-and-durable-idempotency.md index 78984639..00a03ed1 100644 --- a/docs/adr/ADR-GRPC-004-retry-ownership-and-durable-idempotency.md +++ b/docs/adr/ADR-GRPC-004-retry-ownership-and-durable-idempotency.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-30 +- 요약: 재시도 주인은 하나이고 키가 있는 변경은 영속 원장이 필요하다는 결정이다. +- 현재 정본: `docs/compatibility/grpc-support-matrix.md` + + # ADR-GRPC-004: One retry owner, and keyed mutations need a durable ledger - Status: accepted diff --git a/docs/adr/ADR-GRPC-005-server-streaming-single-writer-and-resume.md b/docs/adr/ADR-GRPC-005-server-streaming-single-writer-and-resume.md index b648be9e..712eddf8 100644 --- a/docs/adr/ADR-GRPC-005-server-streaming-single-writer-and-resume.md +++ b/docs/adr/ADR-GRPC-005-server-streaming-single-writer-and-resume.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-30 +- 요약: 서버 스트림은 writer 하나, 제한된 큐, 추측하지 않는 resume로 다룬다는 결정이다. +- 현재 정본: `docs/compatibility/grpc-support-matrix.md` + + # ADR-GRPC-005: One writer per stream, a bounded queue, and resume that refuses to guess - Status: accepted diff --git a/docs/adr/ADR-GRPC-006-stable-discovery-and-kubernetes-routing.md b/docs/adr/ADR-GRPC-006-stable-discovery-and-kubernetes-routing.md index 3be4e14a..17e677a6 100644 --- a/docs/adr/ADR-GRPC-006-stable-discovery-and-kubernetes-routing.md +++ b/docs/adr/ADR-GRPC-006-stable-discovery-and-kubernetes-routing.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-31 +- 요약: Stable discovery는 DNS와 정적 목록이고 Kubernetes에서는 누가 부하를 나누는지 profile이 정한다는 결정이다. +- 현재 정본: `docs/compatibility/grpc-support-matrix.md` + + # ADR-GRPC-006: Stable discovery is DNS and static, and a Kubernetes profile names who balances - Status: accepted diff --git a/docs/adr/ADR-GRPC-ADV-001-capability-promotion-is-per-capability.md b/docs/adr/ADR-GRPC-ADV-001-capability-promotion-is-per-capability.md index 041a85ab..63e6bfde 100644 --- a/docs/adr/ADR-GRPC-ADV-001-capability-promotion-is-per-capability.md +++ b/docs/adr/ADR-GRPC-ADV-001-capability-promotion-is-per-capability.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-30 +- 요약: gRPC 고급 기능마다 따로 플래그·등급·승격 기준을 둔다는 결정이다. +- 현재 정본: `docs/compatibility/grpc-advanced-support-matrix.md` + + # ADR-GRPC-ADV-001: Each advanced capability has its own flag, its own grade and its own promotion - Status: accepted diff --git a/docs/adr/ADR-JPA-001-domain-owns-persistence-model.md b/docs/adr/ADR-JPA-001-domain-owns-persistence-model.md index 835275e5..24a06a89 100644 --- a/docs/adr/ADR-JPA-001-domain-owns-persistence-model.md +++ b/docs/adr/ADR-JPA-001-domain-owns-persistence-model.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-11 +- 요약: 영속성 모델은 도메인이 소유한다는 결정이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # ADR-JPA-001 — The domain owns the persistence model - Status: Accepted diff --git a/docs/adr/ADR-JPA-002-full-transaction-retry.md b/docs/adr/ADR-JPA-002-full-transaction-retry.md index e10b4063..a2491bce 100644 --- a/docs/adr/ADR-JPA-002-full-transaction-retry.md +++ b/docs/adr/ADR-JPA-002-full-transaction-retry.md @@ -1,3 +1,13 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 대체됨 +- 작성일: 2026-08-11 +- 요약: 재시도는 유스케이스 전체를 다시 돌린다는 결정이다. 그 재시도 엔진은 2026-09-25에 지웠다. +- 현재 정본: `docs/jpa/transaction-guide.md` +- 대체됨: `docs/capability-status.md` + + # ADR-JPA-002 — Retry re-runs the whole use case - Status: Superseded (2026-09-25) — the retry engine this ADR describes diff --git a/docs/adr/ADR-JPA-003-completion-unknown.md b/docs/adr/ADR-JPA-003-completion-unknown.md index 4c1d5b1e..c283d6db 100644 --- a/docs/adr/ADR-JPA-003-completion-unknown.md +++ b/docs/adr/ADR-JPA-003-completion-unknown.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-08-11 +- 요약: commit 결과를 모르는 실패는 재시도하지 않는다는 결정이다. 2026-09-25 보완이 있다. +- 현재 정본: `docs/jpa/transaction-guide.md` + + # ADR-JPA-003 — Completion unknown is never retried - Status: Accepted; amended 2026-09-25 — `TransactionCompletionResolver`, `CommitFailureClassifier` diff --git a/docs/adr/ADR-JPA-004-flyway-schema-source-of-truth.md b/docs/adr/ADR-JPA-004-flyway-schema-source-of-truth.md index c063e5e0..63be96de 100644 --- a/docs/adr/ADR-JPA-004-flyway-schema-source-of-truth.md +++ b/docs/adr/ADR-JPA-004-flyway-schema-source-of-truth.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-11 +- 요약: 스키마의 정본은 Flyway라는 결정이다. +- 현재 정본: `docs/jpa/migration-guide.md` + + # ADR-JPA-004 — Flyway is the schema source of truth - Status: Accepted diff --git a/docs/adr/ADR-JPA-005-postgresql-real-contract.md b/docs/adr/ADR-JPA-005-postgresql-real-contract.md index 20d1806c..116d2487 100644 --- a/docs/adr/ADR-JPA-005-postgresql-real-contract.md +++ b/docs/adr/ADR-JPA-005-postgresql-real-contract.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-11 +- 요약: 영속성 계약은 실제 PostgreSQL에서 돌린다는 결정이다. +- 현재 정본: `docs/jpa/support-matrix.md` + + # ADR-JPA-005 — Contracts run against real PostgreSQL - Status: Accepted diff --git a/docs/adr/ADR-JPA-006-canonical-technical-audit.md b/docs/adr/ADR-JPA-006-canonical-technical-audit.md index cf3bd995..80aadd31 100644 --- a/docs/adr/ADR-JPA-006-canonical-technical-audit.md +++ b/docs/adr/ADR-JPA-006-canonical-technical-audit.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-24 +- 요약: 기술 감사 모델은 audit 하나뿐이라는 결정이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # ADR-JPA-006 — `audit` is the sole technical audit model - Status: Accepted diff --git a/docs/adr/ADR-MONGO-001-platform-boundary.md b/docs/adr/ADR-MONGO-001-platform-boundary.md index 43d3e45c..62358927 100644 --- a/docs/adr/ADR-MONGO-001-platform-boundary.md +++ b/docs/adr/ADR-MONGO-001-platform-boundary.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-13 +- 요약: MongoDB 플랫폼의 경계를 정한 결정이다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + # ADR-MONGO-001 — MongoDB platform boundary - **Status:** Accepted diff --git a/docs/adr/ADR-MONGO-002-bson-representation.md b/docs/adr/ADR-MONGO-002-bson-representation.md index 40f9f443..73e478a7 100644 --- a/docs/adr/ADR-MONGO-002-bson-representation.md +++ b/docs/adr/ADR-MONGO-002-bson-representation.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-13 +- 요약: BSON 표현을 고정한 목록으로 관리한다는 결정이다. +- 현재 정본: `docs/mongodb/bson-mapping-guide.md` + + # ADR-MONGO-002 — BSON representation is a pinned manifest - **Status:** Accepted diff --git a/docs/adr/ADR-MONGO-003-transaction-retry.md b/docs/adr/ADR-MONGO-003-transaction-retry.md index d5501285..7d675461 100644 --- a/docs/adr/ADR-MONGO-003-transaction-retry.md +++ b/docs/adr/ADR-MONGO-003-transaction-retry.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-13 +- 요약: 트랜잭션 본문 재시도와 commit 재시도를 다른 반복으로 둔다는 결정이다. +- 현재 정본: `docs/mongodb/consistency-transaction-guide.md` + + # ADR-MONGO-003 — Transaction body retry and commit retry are separate loops - **Status:** Accepted diff --git a/docs/adr/ADR-MONGO-004-index-schema-admin-plane.md b/docs/adr/ADR-MONGO-004-index-schema-admin-plane.md index f39fffa8..eeb2896c 100644 --- a/docs/adr/ADR-MONGO-004-index-schema-admin-plane.md +++ b/docs/adr/ADR-MONGO-004-index-schema-admin-plane.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-13 +- 요약: 인덱스와 스키마 변경은 관리 평면이 맡는다는 결정이다. +- 현재 정본: `docs/mongodb/schema-index-migration-guide.md` + + # ADR-MONGO-004 — Index and schema changes belong to the admin plane - **Status:** Accepted diff --git a/docs/adr/ADR-MONGO-ADV-001-capability-promotion.md b/docs/adr/ADR-MONGO-ADV-001-capability-promotion.md index a3b54030..9b3bc6b3 100644 --- a/docs/adr/ADR-MONGO-ADV-001-capability-promotion.md +++ b/docs/adr/ADR-MONGO-ADV-001-capability-promotion.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-08-13 +- 요약: MongoDB 고급 기능의 승격 기준을 정한 결정이다. 2026-09-25 보완이 있다. +- 현재 정본: `docs/mongodb/support-matrix.md` + + # ADR-MONGO-ADV-001 — Advanced capability promotion - **Status:** Accepted diff --git a/docs/adr/ADR-WEB-ADV-001-streaming-is-live-delivery.md b/docs/adr/ADR-WEB-ADV-001-streaming-is-live-delivery.md index e54311a0..8883fe61 100644 --- a/docs/adr/ADR-WEB-ADV-001-streaming-is-live-delivery.md +++ b/docs/adr/ADR-WEB-ADV-001-streaming-is-live-delivery.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-25 +- 요약: 스트리밍은 실시간 전달이고 web 모듈은 이력을 저장하지 않는다는 결정이다. +- 현재 정본: `docs/web/streaming-contract.md` + + # ADR-WEB-ADV-001: Streaming is live delivery, and the web module stores no history - Status: Accepted diff --git a/docs/adr/ADR-WEB-ADV-002-virtual-threads-do-not-remove-admission.md b/docs/adr/ADR-WEB-ADV-002-virtual-threads-do-not-remove-admission.md index e76ebc72..fafaeeae 100644 --- a/docs/adr/ADR-WEB-ADV-002-virtual-threads-do-not-remove-admission.md +++ b/docs/adr/ADR-WEB-ADV-002-virtual-threads-do-not-remove-admission.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-25 +- 요약: 가상 스레드는 스케줄링을 바꿀 뿐 동시성 예산을 없애지 않는다는 결정이다. +- 현재 정본: `docs/web/virtual-thread-profile.md` + + # ADR-WEB-ADV-002: Virtual threads change scheduling, not the concurrency budget - Status: Accepted diff --git a/docs/adr/ADR-WEB-ADV-003-openapi-32-remains-experimental.md b/docs/adr/ADR-WEB-ADV-003-openapi-32-remains-experimental.md index f91133d0..d850da30 100644 --- a/docs/adr/ADR-WEB-ADV-003-openapi-32-remains-experimental.md +++ b/docs/adr/ADR-WEB-ADV-003-openapi-32-remains-experimental.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-25 +- 요약: OpenAPI 3.2 문서는 나란히 만들고 실험 등급으로 둔다는 결정이다. +- 현재 정본: `docs/web/openapi-32-compatibility.md` + + # ADR-WEB-ADV-003: OpenAPI 3.2 is generated in parallel and stays experimental - Status: Accepted diff --git a/docs/adr/ADR-WS-001-platform-as-packages-and-its-boundaries.md b/docs/adr/ADR-WS-001-platform-as-packages-and-its-boundaries.md index 442ebee5..69cc7efb 100644 --- a/docs/adr/ADR-WS-001-platform-as-packages-and-its-boundaries.md +++ b/docs/adr/ADR-WS-001-platform-as-packages-and-its-boundaries.md @@ -1,3 +1,13 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 대체됨 +- 작성일: 2026-08-25 +- 요약: WebSocket 플랫폼을 leaf 하나의 패키지들로 내고 경계를 기계로 검사한다는 결정이다. 2026-09-25 플랫폼을 줄이면서 바뀌었다. +- 현재 정본: `src/adapter/inbound/websocket/README.md` +- 대체됨: `docs/capability-status.md` + + # ADR-WS-001: The WebSocket platform ships as packages in one leaf, with machine-checked boundaries - Status: Superseded 2026-09-25 — the eighteen-package platform was cut to the parts a Spring diff --git a/docs/adr/ADR-WS-002-resume-and-cluster.md b/docs/adr/ADR-WS-002-resume-and-cluster.md index 6f2be96e..6f089e9d 100644 --- a/docs/adr/ADR-WS-002-resume-and-cluster.md +++ b/docs/adr/ADR-WS-002-resume-and-cluster.md @@ -1,3 +1,13 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 대체됨 +- 작성일: 2026-08-25 +- 요약: resume·cluster 상태는 캐시로 다룬다는 결정이다. 그 기능은 2026-09-25에 지웠다. +- 현재 정본: `src/adapter/inbound/websocket/README.md` +- 대체됨: `docs/capability-status.md` + + # ADR-WS-002: Resume and cluster state are caches, and are treated as caches - Status: Superseded 2026-09-25 — `advanced.resume`, `advanced.cluster` and `advanced.presence` diff --git a/docs/adr/ADR-WS-003-stomp-and-broker-relay.md b/docs/adr/ADR-WS-003-stomp-and-broker-relay.md index 6f8aff4b..fab91a73 100644 --- a/docs/adr/ADR-WS-003-stomp-and-broker-relay.md +++ b/docs/adr/ADR-WS-003-stomp-and-broker-relay.md @@ -1,3 +1,13 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 대체됨 +- 작성일: 2026-08-25 +- 요약: STOMP를 목적지 목록이 있는 고급 어댑터로 둔다는 결정이다. 그 고급 STOMP는 2026-09-25에 지웠다. +- 현재 정본: `src/adapter/inbound/websocket/README.md` +- 대체됨: `docs/capability-status.md` + + # ADR-WS-003: STOMP is an Advanced adapter with a declared destination catalog - Status: Superseded 2026-09-25 — `advanced.stomp` and `advanced.stomp.rabbit` were removed; the diff --git a/docs/capability-status.md b/docs/capability-status.md index d8d41b98..d0e0bdb2 100644 --- a/docs/capability-status.md +++ b/docs/capability-status.md @@ -71,7 +71,7 @@ web 경로의 `W/`는 `src/adapter/inbound/web/src/main/java/dev/caskeleton/adap 복구가 필요하면 표의 커밋에서 경로를 꺼낸다(`git show <커밋>:<경로>`). -리뷰 후속 작업(2026-09-25~28, `docs/superpowers/plans/2026-09-25-review-followup.md`)에서 지운 것은 마지막으로 존재한 커밋이 `6d27356e`인 행으로 표 끝에 이어 붙였다. +리뷰 후속 작업(2026-09-25~28, `docs/history/plans/2026-09-25-review-followup.md`)에서 지운 것은 마지막으로 존재한 커밋이 `6d27356e`인 행으로 표 끝에 이어 붙였다. | 대상 | 경로 | 마지막으로 존재한 커밋 | 이유 | | --- | --- | --- | --- | diff --git a/docs/ci-cd/template-vs-consumer.md b/docs/ci-cd/template-vs-consumer.md index 76303394..715189bc 100644 --- a/docs/ci-cd/template-vs-consumer.md +++ b/docs/ci-cd/template-vs-consumer.md @@ -16,7 +16,7 @@ | 대상 | 무엇을 지키는가 | | --- | --- | -| `docs/superpowers/**` | 이 템플릿을 만든 과정의 설계/계획 기록 | +| `docs/design/**`, `docs/history/**` | 이 템플릿을 만든 과정의 설계서·계획서·납품 패키지·증거·학습 기록 | | `gradle/qualification/**` | 이 템플릿이 벤더링한 플랫폼(JPA, messaging)의 인증 체계 | | `*-certification.yml`, `*-qualification.yml`, `jpa-next-*.yml` | 템플릿이 광고하는 지원 매트릭스의 근거 | diff --git a/docs/superpowers/specs/2026-07-20-harness-policy-engine-design.md b/docs/design/2026-07-20-harness-policy-engine-design.md similarity index 94% rename from docs/superpowers/specs/2026-07-20-harness-policy-engine-design.md rename to docs/design/2026-07-20-harness-policy-engine-design.md index 7bec7e1e..de484796 100644 --- a/docs/superpowers/specs/2026-07-20-harness-policy-engine-design.md +++ b/docs/design/2026-07-20-harness-policy-engine-design.md @@ -1,3 +1,13 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 대체됨 +- 작성일: 2026-07-20 +- 요약: 중복된 하네스 규칙을 레지스트리 기반 정책 엔진으로 바꾸려던 설계다. +- 현재 정본: `src/config/architecture/modules.json` +- 대체됨: `docs/design/2026-07-25-harness-free-mode-b-amendment.md` + + > **SUPERSEDED — HISTORICAL PROVENANCE ONLY (2026-07-25):** The user-approved harness-free > Mode B amendment supersedes this design. Retain the body as historical provenance; it is not > executable instruction. diff --git a/docs/superpowers/specs/2026-07-25-application-outbox-failure-reporting-design.md b/docs/design/2026-07-25-application-outbox-failure-reporting-design.md similarity index 97% rename from docs/superpowers/specs/2026-07-25-application-outbox-failure-reporting-design.md rename to docs/design/2026-07-25-application-outbox-failure-reporting-design.md index ad582f0a..f74e9a57 100644 --- a/docs/superpowers/specs/2026-07-25-application-outbox-failure-reporting-design.md +++ b/docs/design/2026-07-25-application-outbox-failure-reporting-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-25 +- 요약: application-core에서 Spring·로깅 의존을 걷어내고 확정된 outbox 실패를 보고하는 방식을 정한 설계다. +- 현재 정본: `src/composition/outbox-relay/README.md` + + # Application Outbox Failure Reporting Refactoring Design - **Date:** 2026-07-25 diff --git a/docs/superpowers/specs/2026-07-25-application-outbox-failure-reporting-harness-free-design.md b/docs/design/2026-07-25-application-outbox-failure-reporting-harness-free-design.md similarity index 89% rename from docs/superpowers/specs/2026-07-25-application-outbox-failure-reporting-harness-free-design.md rename to docs/design/2026-07-25-application-outbox-failure-reporting-harness-free-design.md index 54f38f80..efb99afb 100644 --- a/docs/superpowers/specs/2026-07-25-application-outbox-failure-reporting-harness-free-design.md +++ b/docs/design/2026-07-25-application-outbox-failure-reporting-harness-free-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-25 +- 요약: 하네스 없이 application-core를 프레임워크·로깅 없이 두면서 outbox 실패를 구조화된 ERROR 한 줄로 남기는 설계다. +- 현재 정본: `src/composition/outbox-relay/README.md` + + # Application Outbox Failure Reporting — Harness-Free Design ## Context diff --git a/docs/superpowers/specs/2026-07-25-ci-control-plane-recovery-design.md b/docs/design/2026-07-25-ci-control-plane-recovery-design.md similarity index 97% rename from docs/superpowers/specs/2026-07-25-ci-control-plane-recovery-design.md rename to docs/design/2026-07-25-ci-control-plane-recovery-design.md index e34b294a..21d222ea 100644 --- a/docs/superpowers/specs/2026-07-25-ci-control-plane-recovery-design.md +++ b/docs/design/2026-07-25-ci-control-plane-recovery-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-25 +- 요약: 숨어 있던 CI 제어면을 저장소 안으로 되살려 Gradle·Docker 빌드와 의존성 자동화를 맞추는 설계다. +- 현재 정본: `docs/work/reference/gates.md` + + # CI Control Plane Recovery Design - **Date:** 2026-07-25 @@ -114,7 +123,7 @@ native provenance. **Mode B — controlled reconstruction.** The original source is unavailable or incomplete. The human records that fact and explicitly authorizes reconstruction from the approved [`2026-07-20-harness-policy-engine-design.md`](2026-07-20-harness-policy-engine-design.md), -[`2026-07-20-harness-policy-engine.md`](../plans/2026-07-20-harness-policy-engine.md), the tracked +[`2026-07-20-harness-policy-engine.md`](../history/plans/2026-07-20-harness-policy-engine.md), the tracked Gradle/module sources, and this design. Reconstructed artifacts receive new hashes and a `controlled-reconstruction` provenance record. Schema, renderer parity, mutation coverage, Gradle project discovery, and architecture dependency checks must pass before the new artifacts can act as diff --git a/docs/superpowers/specs/2026-07-25-harness-free-mode-b-amendment.md b/docs/design/2026-07-25-harness-free-mode-b-amendment.md similarity index 83% rename from docs/superpowers/specs/2026-07-25-harness-free-mode-b-amendment.md rename to docs/design/2026-07-25-harness-free-mode-b-amendment.md index 86c32ad5..f58fc5b9 100644 --- a/docs/superpowers/specs/2026-07-25-harness-free-mode-b-amendment.md +++ b/docs/design/2026-07-25-harness-free-mode-b-amendment.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-25 +- 요약: 하네스를 되살리지 않고 Gradle 부트스트랩과 의존 방향 검사를 복구하며 registry JSON을 정본으로 정한 범위 수정이다. +- 현재 정본: `src/config/architecture/modules.json` + + # Harness-Free Mode B Amendment - **Date:** 2026-07-25 diff --git a/docs/superpowers/specs/2026-07-25-harness-free-quality-security-ci-design.md b/docs/design/2026-07-25-harness-free-quality-security-ci-design.md similarity index 92% rename from docs/superpowers/specs/2026-07-25-harness-free-quality-security-ci-design.md rename to docs/design/2026-07-25-harness-free-quality-security-ci-design.md index e6b90784..b5a83880 100644 --- a/docs/superpowers/specs/2026-07-25-harness-free-quality-security-ci-design.md +++ b/docs/design/2026-07-25-harness-free-quality-security-ci-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-25 +- 요약: 하네스 없이 품질·의존성 보안 CI를 저장소 안에서 다시 세우는 설계다. +- 현재 정본: `docs/work/reference/gates.md` + + # Harness-Free Quality and Security CI Design - **Date:** 2026-07-25 diff --git a/docs/superpowers/specs/2026-07-25-module-gradle-hygiene-design.md b/docs/design/2026-07-25-module-gradle-hygiene-design.md similarity index 97% rename from docs/superpowers/specs/2026-07-25-module-gradle-hygiene-design.md rename to docs/design/2026-07-25-module-gradle-hygiene-design.md index 8e3e15ca..885c4ece 100644 --- a/docs/superpowers/specs/2026-07-25-module-gradle-hygiene-design.md +++ b/docs/design/2026-07-25-module-gradle-hygiene-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-25 +- 요약: leaf Gradle 의존 그래프를 Clean Architecture를 지키는 최소 모양으로 줄이는 정리 설계다. +- 현재 정본: `src/config/architecture/modules.json` + + # Module and Gradle Hygiene Refactoring Design - **Date:** 2026-07-25 diff --git a/docs/superpowers/specs/2026-07-25-module-gradle-hygiene-harness-free-design.md b/docs/design/2026-07-25-module-gradle-hygiene-harness-free-design.md similarity index 95% rename from docs/superpowers/specs/2026-07-25-module-gradle-hygiene-harness-free-design.md rename to docs/design/2026-07-25-module-gradle-hygiene-harness-free-design.md index a7a4435b..d043204a 100644 --- a/docs/superpowers/specs/2026-07-25-module-gradle-hygiene-harness-free-design.md +++ b/docs/design/2026-07-25-module-gradle-hygiene-harness-free-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-25 +- 요약: 같은 모듈·Gradle 정리를 하네스 없이 적용하는 설계다. +- 현재 정본: `src/config/architecture/modules.json` + + # Harness-Free Module and Gradle Hygiene Design - **Date:** 2026-07-25 diff --git a/docs/superpowers/specs/2026-07-26-fileserver-production-capability-design.md b/docs/design/2026-07-26-fileserver-production-capability-design.md similarity index 99% rename from docs/superpowers/specs/2026-07-26-fileserver-production-capability-design.md rename to docs/design/2026-07-26-fileserver-production-capability-design.md index fc0141c6..09b012fd 100644 --- a/docs/superpowers/specs/2026-07-26-fileserver-production-capability-design.md +++ b/docs/design/2026-07-26-fileserver-production-capability-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 폐기 +- 작성일: 2026-07-26 +- 요약: 파일 서버를 단계별로 운영 가능한 capability로 올리는 상세 설계다. 이 설계의 publication R1/R2 어댑터는 2026-09-25에 지웠다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver Production Capability Deep Design - 작성일: 2026-07-26 diff --git a/docs/superpowers/specs/2026-07-26-production-capability-platform-design.md b/docs/design/2026-07-26-production-capability-platform-design.md similarity index 98% rename from docs/superpowers/specs/2026-07-26-production-capability-platform-design.md rename to docs/design/2026-07-26-production-capability-platform-design.md index 2669121e..c80ca292 100644 --- a/docs/superpowers/specs/2026-07-26-production-capability-platform-design.md +++ b/docs/design/2026-07-26-production-capability-platform-design.md @@ -1,3 +1,13 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 대체됨 +- 작성일: 2026-07-26 +- 요약: 통합 지점 모음을 opt-in 운영 capability 플랫폼으로 키우는 전체 설계다. 스위치로 끄던 방식은 2026-09-25 capability 모듈 포장으로 바뀌었다. +- 현재 정본: `docs/capability-status.md` +- 대체됨: `docs/design/2026-09-25-capability-module-packaging-design.md` + + # Production Capability Platform Design - Date: 2026-07-26 @@ -952,7 +962,7 @@ and durable interfaces are explicit. The authoritative implementation-level design for this capability is [Object Storage Production Capability Deep Design](2026-07-28-objectstorage-production-capability-design.md). Its ordered RED–GREEN execution batches and promotion gates are in the -[Object Storage Production Capability Implementation Plan](../plans/2026-07-28-objectstorage-production-capability.md). +[Object Storage Production Capability Implementation Plan](../history/plans/2026-07-28-objectstorage-production-capability.md). This subsection is only the cross-capability baseline; the dedicated design governs when details differ. diff --git a/docs/superpowers/specs/2026-07-26-redis-production-capability-design.md b/docs/design/2026-07-26-redis-production-capability-design.md similarity index 99% rename from docs/superpowers/specs/2026-07-26-redis-production-capability-design.md rename to docs/design/2026-07-26-redis-production-capability-design.md index f43f6a66..3860ddcb 100644 --- a/docs/superpowers/specs/2026-07-26-redis-production-capability-design.md +++ b/docs/design/2026-07-26-redis-production-capability-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-26 +- 요약: Redis를 운영 가능한 capability로 올리는 단계별 상세 설계다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Production Capability Deep Design - Date: 2026-07-26 diff --git a/docs/superpowers/specs/2026-07-27-httpclient-production-capability-design.md b/docs/design/2026-07-27-httpclient-production-capability-design.md similarity index 99% rename from docs/superpowers/specs/2026-07-27-httpclient-production-capability-design.md rename to docs/design/2026-07-27-httpclient-production-capability-design.md index f70d714a..1b6e648e 100644 --- a/docs/superpowers/specs/2026-07-27-httpclient-production-capability-design.md +++ b/docs/design/2026-07-27-httpclient-production-capability-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-27 +- 요약: HTTP client를 운영 가능한 capability로 올리는 단계별 상세 설계다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + # HTTP Client Production Capability Deep Design - 작성일: 2026-07-27 diff --git a/docs/superpowers/specs/2026-07-28-fileserver-r2-control-plane-provider-selection-design.md b/docs/design/2026-07-28-fileserver-r2-control-plane-provider-selection-design.md similarity index 98% rename from docs/superpowers/specs/2026-07-28-fileserver-r2-control-plane-provider-selection-design.md rename to docs/design/2026-07-28-fileserver-r2-control-plane-provider-selection-design.md index 764d2b92..2c2b1bb8 100644 --- a/docs/superpowers/specs/2026-07-28-fileserver-r2-control-plane-provider-selection-design.md +++ b/docs/design/2026-07-28-fileserver-r2-control-plane-provider-selection-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 폐기 +- 작성일: 2026-07-28 +- 요약: 파일 서버 R2 제어면과 provider 선택을 정한 설계다. 이 R2 어댑터는 2026-09-25에 지웠다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver R2 Control Plane and Provider Selection Design - Date: 2026-07-28 diff --git a/docs/superpowers/specs/2026-07-28-jpa-production-capability-design.md b/docs/design/2026-07-28-jpa-production-capability-design.md similarity index 99% rename from docs/superpowers/specs/2026-07-28-jpa-production-capability-design.md rename to docs/design/2026-07-28-jpa-production-capability-design.md index d84ab5d9..8ac2384c 100644 --- a/docs/superpowers/specs/2026-07-28-jpa-production-capability-design.md +++ b/docs/design/2026-07-28-jpa-production-capability-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: JPA·PostgreSQL을 운영 가능한 capability로 올리는 상세 설계다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA/PostgreSQL Production Capability Deep Design - 작성일: 2026-07-28 diff --git a/docs/superpowers/specs/2026-07-28-messaging-production-capability-design.md b/docs/design/2026-07-28-messaging-production-capability-design.md similarity index 99% rename from docs/superpowers/specs/2026-07-28-messaging-production-capability-design.md rename to docs/design/2026-07-28-messaging-production-capability-design.md index 608c93f6..9d5f4759 100644 --- a/docs/superpowers/specs/2026-07-28-messaging-production-capability-design.md +++ b/docs/design/2026-07-28-messaging-production-capability-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: 메시징을 운영 가능한 capability로 올리는 상세 설계다. +- 현재 정본: `docs/messaging/support-matrix.md` + + # Messaging Production Capability Deep Design - 작성일: 2026-07-28 diff --git a/docs/superpowers/specs/2026-07-28-notification-production-capability-design.md b/docs/design/2026-07-28-notification-production-capability-design.md similarity index 99% rename from docs/superpowers/specs/2026-07-28-notification-production-capability-design.md rename to docs/design/2026-07-28-notification-production-capability-design.md index 956872d9..cf3e6165 100644 --- a/docs/superpowers/specs/2026-07-28-notification-production-capability-design.md +++ b/docs/design/2026-07-28-notification-production-capability-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: 알림을 운영 가능한 capability로 올리는 상세 설계다. +- 현재 정본: `docs/notification/support-matrix.md` + + # Notification Production Capability Deep Design - 작성일: 2026-07-28 @@ -15,7 +24,7 @@ 이 문서는 Notification capability의 승인된 상세 설계다. 2026-07-28에 §36의 다섯 gate를 사용자가 승인했으며, 실제 구현 순서는 -[Notification Production Capability Implementation Plan](../plans/2026-07-28-notification-production-capability.md)을 +[Notification Production Capability Implementation Plan](../history/plans/2026-07-28-notification-production-capability.md)을 정본으로 사용한다. 구현 및 production readiness는 아직 주장하지 않는다. 2026-07-28 현재 구현된 범위: @@ -4793,7 +4802,7 @@ COMPLETE 뒤 reverse가 필요하다면 canonical in-flight/intent backlog/provi inbound messaging/inbox architecture로 설계를 수정해야 한다. 사용자는 2026-07-28에 위 다섯 결정을 승인했다. 구현은 -[Notification Production Capability Implementation Plan](../plans/2026-07-28-notification-production-capability.md)의 +[Notification Production Capability Implementation Plan](../history/plans/2026-07-28-notification-production-capability.md)의 작은 TDD task, owner leaf, registry-derived Gradle path, focused test, architecture gate, real-provider evidence와 rollback point를 따른다. diff --git a/docs/superpowers/specs/2026-07-28-objectstorage-production-capability-design.md b/docs/design/2026-07-28-objectstorage-production-capability-design.md similarity index 99% rename from docs/superpowers/specs/2026-07-28-objectstorage-production-capability-design.md rename to docs/design/2026-07-28-objectstorage-production-capability-design.md index 2e805d4c..1846c917 100644 --- a/docs/superpowers/specs/2026-07-28-objectstorage-production-capability-design.md +++ b/docs/design/2026-07-28-objectstorage-production-capability-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: object storage를 운영 가능한 capability로 올리는 상세 설계와 batch 진행 기록이다. +- 현재 정본: `src/adapter/outbound/objectstorage/README.md` + + # Object Storage Production Capability Deep Design - 작성일: 2026-07-28 @@ -12,7 +21,7 @@ - 상위 문서: [Production Capability Platform Design](2026-07-26-production-capability-platform-design.md) - 구현 계획: - [Object Storage Production Capability Implementation Plan](../plans/2026-07-28-objectstorage-production-capability.md) + [Object Storage Production Capability Implementation Plan](../history/plans/2026-07-28-objectstorage-production-capability.md) - 참고 설계: [Redis Production Capability Deep Design](2026-07-26-redis-production-capability-design.md), [Fileserver Production Capability Deep Design](2026-07-26-fileserver-production-capability-design.md), @@ -78,11 +87,11 @@ create-only PUT/complete 조건을 무시하므로 managed/direct mutation profile을 `UNSUPPORTED`로 유지하며 readiness를 올리지 않는다. -증거는 [Batch A checkpoint](../../evidence/object-storage/batch-a-checkpoint.md), -[Batch B checkpoint](../../evidence/object-storage/batch-b-checkpoint.md), -[Batch C checkpoint](../../evidence/object-storage/batch-c-progress.md), -[Batch D checkpoint](../../evidence/object-storage/batch-d-checkpoint.md), -[Batch E pause checkpoint](../../evidence/object-storage/batch-e-pause-checkpoint.md)에 기록했다. +증거는 [Batch A checkpoint](../history/evidence/object-storage/batch-a-checkpoint.md), +[Batch B checkpoint](../history/evidence/object-storage/batch-b-checkpoint.md), +[Batch C checkpoint](../history/evidence/object-storage/batch-c-progress.md), +[Batch D checkpoint](../history/evidence/object-storage/batch-d-checkpoint.md), +[Batch E pause checkpoint](../history/evidence/object-storage/batch-e-pause-checkpoint.md)에 기록했다. 격리 브랜치에서는 private vault 경로를 잘못 선택해 capture가 차단됐지만, main 통합 작업은 사용자가 지정한 public vault의 @@ -4015,7 +4024,7 @@ authorization endpoint의 ephemeral response이며 stored object DTO에 영구 ## 37. 구현 계획 작성 전 확정 항목 정본 구현 순서와 아래 결정의 현재 freeze/approval gate는 -[Object Storage Production Capability Implementation Plan](../plans/2026-07-28-objectstorage-production-capability.md)에 +[Object Storage Production Capability Implementation Plan](../history/plans/2026-07-28-objectstorage-production-capability.md)에 기록한다. Tasks 1–24의 구현은 Batch E pause checkpoint까지 진행됐지만 Batch E 전체 combined/root gate는 아직 통과하지 않았다. Tasks 25–30은 미착수다. 이 구현 진행이나 계획 승인이 public API, scanner provider 또는 AWS/IaC 외부 변경 권한을 자동으로 부여하지 diff --git a/docs/superpowers/specs/2026-07-28-production-grade-test-architecture-environment-design.md b/docs/design/2026-07-28-production-grade-test-architecture-environment-design.md similarity index 99% rename from docs/superpowers/specs/2026-07-28-production-grade-test-architecture-environment-design.md rename to docs/design/2026-07-28-production-grade-test-architecture-environment-design.md index 50c570ca..51e4d1ef 100644 --- a/docs/superpowers/specs/2026-07-28-production-grade-test-architecture-environment-design.md +++ b/docs/design/2026-07-28-production-grade-test-architecture-environment-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 제안 +- 작성일: 2026-07-28 +- 요약: 운영 수준 테스트 구조와 테스트 환경(서비스 준비, 데이터 격리, CI·릴리스 환경)을 정하는 제안이다. +- 현재 정본: `docs/testing/TESTING_STRATEGY.md` + + # Production-grade test architecture and environment design - Status: proposed design; implementation not started diff --git a/docs/superpowers/specs/2026-07-28-redis-cache-resilience-design.md b/docs/design/2026-07-28-redis-cache-resilience-design.md similarity index 93% rename from docs/superpowers/specs/2026-07-28-redis-cache-resilience-design.md rename to docs/design/2026-07-28-redis-cache-resilience-design.md index dcadf83b..3edd97bb 100644 --- a/docs/superpowers/specs/2026-07-28-redis-cache-resilience-design.md +++ b/docs/design/2026-07-28-redis-cache-resilience-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: Redis 캐시에 cache-aside, 원본 보호, soft/hard TTL을 더하는 증분 설계다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Cache Resilience Increment Design **Status:** approved for implementation diff --git a/docs/superpowers/specs/2026-07-28-redis-distributed-rate-limit-design.md b/docs/design/2026-07-28-redis-distributed-rate-limit-design.md similarity index 92% rename from docs/superpowers/specs/2026-07-28-redis-distributed-rate-limit-design.md rename to docs/design/2026-07-28-redis-distributed-rate-limit-design.md index 4d2c42d6..9cfb040a 100644 --- a/docs/superpowers/specs/2026-07-28-redis-distributed-rate-limit-design.md +++ b/docs/design/2026-07-28-redis-distributed-rate-limit-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 구현됨 +- 작성일: 2026-07-28 +- 요약: Redis로 고를 수 있는 분산 rate-limit 알고리즘 셋을 제공하는 증분 설계다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Distributed Rate-Limit Increment Design **Status:** implemented as standalone R1 diff --git a/docs/superpowers/specs/2026-08-01-release-hygiene-refactoring-design.md b/docs/design/2026-08-01-release-hygiene-refactoring-design.md similarity index 94% rename from docs/superpowers/specs/2026-08-01-release-hygiene-refactoring-design.md rename to docs/design/2026-08-01-release-hygiene-refactoring-design.md index 3b564a4e..33dc50eb 100644 --- a/docs/superpowers/specs/2026-08-01-release-hygiene-refactoring-design.md +++ b/docs/design/2026-08-01-release-hygiene-refactoring-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-01 +- 요약: 릴리스 위생 경로(sample-off 게이트, wrapper 검증, Docker 캐시, SpotBugs)를 사실대로 맞추는 리팩터링 설계다. +- 현재 정본: `docs/work/reference/gates.md` + + # Release Hygiene Refactoring Design **Date:** 2026-08-01 diff --git a/docs/superpowers/specs/2026-08-02-client-safe-error-boundary-design.md b/docs/design/2026-08-02-client-safe-error-boundary-design.md similarity index 89% rename from docs/superpowers/specs/2026-08-02-client-safe-error-boundary-design.md rename to docs/design/2026-08-02-client-safe-error-boundary-design.md index 8ac709d1..b0807329 100644 --- a/docs/superpowers/specs/2026-08-02-client-safe-error-boundary-design.md +++ b/docs/design/2026-08-02-client-safe-error-boundary-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-02 +- 요약: 공개 HTTP 오류 응답에 허용한 문구와 안전한 값만 담게 하는 경계 설계다. +- 현재 정본: `docs/web/http-contract.md` + + # Client-Safe Error Boundary Design **Date:** 2026-08-02 diff --git a/docs/superpowers/specs/2026-08-02-conditional-inbound-transport-boundary-design.md b/docs/design/2026-08-02-conditional-inbound-transport-boundary-design.md similarity index 93% rename from docs/superpowers/specs/2026-08-02-conditional-inbound-transport-boundary-design.md rename to docs/design/2026-08-02-conditional-inbound-transport-boundary-design.md index e794e9e3..7d4cdba8 100644 --- a/docs/superpowers/specs/2026-08-02-conditional-inbound-transport-boundary-design.md +++ b/docs/design/2026-08-02-conditional-inbound-transport-boundary-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-02 +- 요약: GraphQL·gRPC·WebSocket 전송을 고를 때만 켜고 위험한 활성화는 실패시키는 경계 설계다. +- 현재 정본: `docs/web/http-contract.md` + + # Conditional Inbound Transport Boundary Design **Date:** 2026-08-02 diff --git a/docs/superpowers/specs/2026-08-02-p2-verification-governance-refactoring-design.md b/docs/design/2026-08-02-p2-verification-governance-refactoring-design.md similarity index 89% rename from docs/superpowers/specs/2026-08-02-p2-verification-governance-refactoring-design.md rename to docs/design/2026-08-02-p2-verification-governance-refactoring-design.md index 94d58c30..d6ba4b52 100644 --- a/docs/superpowers/specs/2026-08-02-p2-verification-governance-refactoring-design.md +++ b/docs/design/2026-08-02-p2-verification-governance-refactoring-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: 동작을 바꾸지 않고 남은 fail-open 검증 경로를 없애는 리팩터링 설계다. +- 현재 정본: `docs/work/reference/gates.md` + + # P2 Verification Governance Refactoring Design ## Goal diff --git a/docs/superpowers/specs/2026-08-02-redis-session-http-boundary-design.md b/docs/design/2026-08-02-redis-session-http-boundary-design.md similarity index 90% rename from docs/superpowers/specs/2026-08-02-redis-session-http-boundary-design.md rename to docs/design/2026-08-02-redis-session-http-boundary-design.md index 28d69df4..1f67bd7f 100644 --- a/docs/superpowers/specs/2026-08-02-redis-session-http-boundary-design.md +++ b/docs/design/2026-08-02-redis-session-http-boundary-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-02 +- 요약: Redis 세션과 HTTP 경계에서 브라우저 세션 보안이 유지되고 실패 시 닫히는지 증명하는 설계다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Session HTTP Boundary Design **Date:** 2026-08-02 diff --git a/docs/superpowers/specs/2026-08-02-verification-purity-refactoring-design.md b/docs/design/2026-08-02-verification-purity-refactoring-design.md similarity index 89% rename from docs/superpowers/specs/2026-08-02-verification-purity-refactoring-design.md rename to docs/design/2026-08-02-verification-purity-refactoring-design.md index dbc5c9be..8e8af585 100644 --- a/docs/superpowers/specs/2026-08-02-verification-purity-refactoring-design.md +++ b/docs/design/2026-08-02-verification-purity-refactoring-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-02 +- 요약: 파일을 고치던 검증 경로(stale JAR, 공개 경로)를 읽기 전용으로 바꾸는 설계다. +- 현재 정본: `docs/work/reference/gates.md` + + # Verification Purity Refactoring Design **Date:** 2026-08-02 diff --git a/docs/superpowers/specs/2026-08-02-warning-zero-build-design.md b/docs/design/2026-08-02-warning-zero-build-design.md similarity index 98% rename from docs/superpowers/specs/2026-08-02-warning-zero-build-design.md rename to docs/design/2026-08-02-warning-zero-build-design.md index 6c29407a..39c20254 100644 --- a/docs/superpowers/specs/2026-08-02-warning-zero-build-design.md +++ b/docs/design/2026-08-02-warning-zero-build-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-02 +- 요약: 컴파일러·정적 분석·테스트 출력 경고를 0으로 만드는 빌드 설계다. +- 현재 정본: `docs/work/reference/gates.md` + + # Warning-Zero Build Refactoring Design **Date:** 2026-08-02 diff --git a/docs/superpowers/specs/2026-08-02-web-security-boundary-design.md b/docs/design/2026-08-02-web-security-boundary-design.md similarity index 89% rename from docs/superpowers/specs/2026-08-02-web-security-boundary-design.md rename to docs/design/2026-08-02-web-security-boundary-design.md index 7f5849ed..c4c8a6c9 100644 --- a/docs/superpowers/specs/2026-08-02-web-security-boundary-design.md +++ b/docs/design/2026-08-02-web-security-boundary-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-02 +- 요약: JWT·JWKS와 CORS 필터 경계를 밀봉된 테스트와 릴리스 차단 검사로 고정하는 설계다. +- 현재 정본: `docs/web/http-contract.md` + + # Web Security Boundary Design **Date:** 2026-08-02 diff --git a/docs/superpowers/specs/2026-08-07-fileserver-platform-design.md b/docs/design/2026-08-07-fileserver-platform-design.md similarity index 99% rename from docs/superpowers/specs/2026-08-07-fileserver-platform-design.md rename to docs/design/2026-08-07-fileserver-platform-design.md index 4748d977..4fcc75dc 100644 --- a/docs/superpowers/specs/2026-08-07-fileserver-platform-design.md +++ b/docs/design/2026-08-07-fileserver-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-07 +- 요약: 업로드·다운로드를 넘어 저장·게시·전송을 나눈 공통 파일 서비스 플랫폼 설계다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver Platform 설계서 **문서 상태:** 설계 확정안 diff --git a/docs/superpowers/specs/2026-08-07-redis-wrapper-typed-api-design.md b/docs/design/2026-08-07-redis-wrapper-typed-api-design.md similarity index 99% rename from docs/superpowers/specs/2026-08-07-redis-wrapper-typed-api-design.md rename to docs/design/2026-08-07-redis-wrapper-typed-api-design.md index 0d1fe53e..1d2b4fa2 100644 --- a/docs/superpowers/specs/2026-08-07-redis-wrapper-typed-api-design.md +++ b/docs/design/2026-08-07-redis-wrapper-typed-api-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-07 +- 요약: Redis 자료구조와 명령을 위험도에 따라 Typed API와 통제된 Raw Gateway로 나눠 제공하는 설계다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Wrapper 및 Typed API 설계서 - **상태:** 구현 기준선 확정 diff --git a/docs/superpowers/specs/2026-08-08-httpclient-platform-design.md b/docs/design/2026-08-08-httpclient-platform-design.md similarity index 99% rename from docs/superpowers/specs/2026-08-08-httpclient-platform-design.md rename to docs/design/2026-08-08-httpclient-platform-design.md index ef10f00a..ae4bb718 100644 --- a/docs/superpowers/specs/2026-08-08-httpclient-platform-design.md +++ b/docs/design/2026-08-08-httpclient-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-08 +- 요약: 외부 HTTP 호출의 대상, 연결 자원, 시간 예산, 재시도 증거를 다루는 HTTP client 플랫폼 설계다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + # HTTP Client Platform 설계서 **문서 상태:** 구현 기준선 확정 diff --git a/docs/superpowers/specs/2026-08-10-messaging-platform-design.md b/docs/design/2026-08-10-messaging-platform-design.md similarity index 99% rename from docs/superpowers/specs/2026-08-10-messaging-platform-design.md rename to docs/design/2026-08-10-messaging-platform-design.md index af4a4587..2b281b94 100644 --- a/docs/superpowers/specs/2026-08-10-messaging-platform-design.md +++ b/docs/design/2026-08-10-messaging-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-10 +- 요약: 메시지 생성부터 브로커 수락, 소비자 정산까지 증거로 다루는 메시징 플랫폼 설계다. +- 현재 정본: `docs/messaging/support-matrix.md` + + # Messaging Platform 설계서 - **상태:** 구현 승인용 기준 설계 diff --git a/docs/superpowers/specs/2026-08-10-notification-platform-design.md b/docs/design/2026-08-10-notification-platform-design.md similarity index 99% rename from docs/superpowers/specs/2026-08-10-notification-platform-design.md rename to docs/design/2026-08-10-notification-platform-design.md index 4637cab6..25f83125 100644 --- a/docs/superpowers/specs/2026-08-10-notification-platform-design.md +++ b/docs/design/2026-08-10-notification-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-10 +- 요약: 요청·수신자·시도 수명주기와 provider 결과를 다루는 알림 전달 플랫폼 설계다. +- 현재 정본: `docs/notification/support-matrix.md` + + # Notification Delivery Platform 설계서 > 상태: 구현 기준 설계(Implementation-ready) diff --git a/docs/superpowers/specs/2026-08-11-jpa-persistence-platform-design.md b/docs/design/2026-08-11-jpa-persistence-platform-design.md similarity index 99% rename from docs/superpowers/specs/2026-08-11-jpa-persistence-platform-design.md rename to docs/design/2026-08-11-jpa-persistence-platform-design.md index a907c6b0..c52c39e8 100644 --- a/docs/superpowers/specs/2026-08-11-jpa-persistence-platform-design.md +++ b/docs/design/2026-08-11-jpa-persistence-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-11 +- 요약: JPA 관계형 영속성 플랫폼의 공개 계약, 모듈 경계, 트랜잭션 의미론을 정한 설계다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA 관계형 영속성 플랫폼 설계서 - 문서 상태: 구현 기준 설계 diff --git a/docs/superpowers/specs/2026-08-11-mongodb-document-persistence-platform-design.md b/docs/design/2026-08-11-mongodb-document-persistence-platform-design.md similarity index 98% rename from docs/superpowers/specs/2026-08-11-mongodb-document-persistence-platform-design.md rename to docs/design/2026-08-11-mongodb-document-persistence-platform-design.md index e79ff9f3..29d31789 100644 --- a/docs/superpowers/specs/2026-08-11-mongodb-document-persistence-platform-design.md +++ b/docs/design/2026-08-11-mongodb-document-persistence-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-11 +- 요약: 도메인이 MongoDB 문서와 repository를 소유하게 하는 문서 영속성 플랫폼 설계다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + # MongoDB 문서 영속성 플랫폼 설계서 - 문서 상태: 구현 기준 설계 diff --git a/docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md b/docs/design/2026-08-12-graphql-api-execution-platform-design.md similarity index 99% rename from docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md rename to docs/design/2026-08-12-graphql-api-execution-platform-design.md index 836c9d33..8047d655 100644 --- a/docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md +++ b/docs/design/2026-08-12-graphql-api-execution-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-12 +- 요약: SDL 계약이 인증·제한·실행·오류 계약을 거쳐 유스케이스에 닿게 하는 GraphQL 실행 플랫폼 설계다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # GraphQL API 실행 플랫폼 설계서 - **문서 상태:** 구현 기준선 확정 diff --git a/docs/superpowers/specs/2026-08-15-five-adapter-runtime-remediation-review-design.md b/docs/design/2026-08-15-five-adapter-runtime-remediation-review-design.md similarity index 99% rename from docs/superpowers/specs/2026-08-15-five-adapter-runtime-remediation-review-design.md rename to docs/design/2026-08-15-five-adapter-runtime-remediation-review-design.md index 53c45211..676795a1 100644 --- a/docs/superpowers/specs/2026-08-15-five-adapter-runtime-remediation-review-design.md +++ b/docs/design/2026-08-15-five-adapter-runtime-remediation-review-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-15 +- 요약: 다섯 어댑터를 한 bootJar에서 켜고 끌 수 있게 고치는 통합 리뷰와 개선 설계다. +- 현재 정본: `docs/capability-status.md` + + # 다섯 Adapter 최종 통합 리뷰 및 개선 설계 - 기준 일자: 2026-08-15 diff --git a/docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md b/docs/design/2026-08-30-grpc-platform-adaptation-design.md similarity index 96% rename from docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md rename to docs/design/2026-08-30-grpc-platform-adaptation-design.md index c7f2c244..55b23bb0 100644 --- a/docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md +++ b/docs/design/2026-08-30-grpc-platform-adaptation-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-30 +- 요약: 타입 안전 gRPC 실행 플랫폼 계획을 이 저장소의 구조와 게이트에 맞춘 설계다. +- 현재 정본: `docs/compatibility/grpc-support-matrix.md` + + # 타입 안전 gRPC 실행 플랫폼 — 이 저장소 규약으로의 어댑팅 설계 두 계획 문서를 이 저장소(`ca-skeleton`)의 실제 구조·정책·빌드 게이트에 맞춰 실행 가능한 형태로 diff --git a/docs/superpowers/specs/2026-09-16-verification-surface-reduction-design.md b/docs/design/2026-09-16-verification-surface-reduction-design.md similarity index 97% rename from docs/superpowers/specs/2026-09-16-verification-surface-reduction-design.md rename to docs/design/2026-09-16-verification-surface-reduction-design.md index c53ad772..3b12bc99 100644 --- a/docs/superpowers/specs/2026-09-16-verification-surface-reduction-design.md +++ b/docs/design/2026-09-16-verification-surface-reduction-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-16 +- 요약: 스켈레톤을 qualification framework에서 되돌려 검증 표면을 줄이는 설계다. +- 현재 정본: `docs/work/reference/gates.md` + + # 검증 표면 축소 설계 — 스켈레톤을 qualification framework에서 되돌리기 날짜: 2026-09-16 diff --git a/docs/superpowers/specs/2026-09-17-jpa-evidence-gradle-model-decoupling-design.md b/docs/design/2026-09-17-jpa-evidence-gradle-model-decoupling-design.md similarity index 93% rename from docs/superpowers/specs/2026-09-17-jpa-evidence-gradle-model-decoupling-design.md rename to docs/design/2026-09-17-jpa-evidence-gradle-model-decoupling-design.md index 90a7ebe4..d8a38df9 100644 --- a/docs/superpowers/specs/2026-09-17-jpa-evidence-gradle-model-decoupling-design.md +++ b/docs/design/2026-09-17-jpa-evidence-gradle-model-decoupling-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-17 +- 요약: JPA 증거 생성이 실행 시점에 Gradle 모델을 읽지 않게 떼어 내는 설계다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA Evidence Gradle Model Decoupling Design ## Context diff --git a/docs/superpowers/specs/2026-09-18-bootstrap-structured-log-fields.md b/docs/design/2026-09-18-bootstrap-structured-log-fields.md similarity index 80% rename from docs/superpowers/specs/2026-09-18-bootstrap-structured-log-fields.md rename to docs/design/2026-09-18-bootstrap-structured-log-fields.md index b9451d4b..999f2b0f 100644 --- a/docs/superpowers/specs/2026-09-18-bootstrap-structured-log-fields.md +++ b/docs/design/2026-09-18-bootstrap-structured-log-fields.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: app-bootstrap 경고 로그를 구조화된 필드로 모으는 작은 설계다. +- 현재 정본: `docs/observability/log-fields.md` + + # Bootstrap Structured Log Fields ## Goal diff --git a/docs/superpowers/specs/2026-09-18-bootstrap-structured-runtime-logging.md b/docs/design/2026-09-18-bootstrap-structured-runtime-logging.md similarity index 84% rename from docs/superpowers/specs/2026-09-18-bootstrap-structured-runtime-logging.md rename to docs/design/2026-09-18-bootstrap-structured-runtime-logging.md index d4b80fa6..72ddaaf3 100644 --- a/docs/superpowers/specs/2026-09-18-bootstrap-structured-runtime-logging.md +++ b/docs/design/2026-09-18-bootstrap-structured-runtime-logging.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: app-bootstrap에 남은 비구조 운영 로그를 구조화하는 작은 설계다. +- 현재 정본: `docs/observability/log-fields.md` + + # Bootstrap Structured Runtime Logging ## Goal diff --git a/docs/superpowers/specs/2026-09-18-configuration-namespace-disposition.md b/docs/design/2026-09-18-configuration-namespace-disposition.md similarity index 83% rename from docs/superpowers/specs/2026-09-18-configuration-namespace-disposition.md rename to docs/design/2026-09-18-configuration-namespace-disposition.md index bf5ef95a..8ed316ea 100644 --- a/docs/superpowers/specs/2026-09-18-configuration-namespace-disposition.md +++ b/docs/design/2026-09-18-configuration-namespace-disposition.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: 설정 이름공간을 어디에 둘지 정리한 처분 기록이다. +- 현재 정본: `docs/registries/env-keys.yaml` + + BOOT-001 disposition ==================== diff --git a/docs/superpowers/specs/2026-09-18-deployment-composition-reachability-remediation.md b/docs/design/2026-09-18-deployment-composition-reachability-remediation.md similarity index 96% rename from docs/superpowers/specs/2026-09-18-deployment-composition-reachability-remediation.md rename to docs/design/2026-09-18-deployment-composition-reachability-remediation.md index f1d86c11..a8e92fda 100644 --- a/docs/superpowers/specs/2026-09-18-deployment-composition-reachability-remediation.md +++ b/docs/design/2026-09-18-deployment-composition-reachability-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: 배포 조립에서 닿지 않던 구성 요소를 고치는 설계다. +- 현재 정본: `docs/capability-status.md` + + # Deployment Composition Reachability Remediation ## Goal diff --git a/docs/superpowers/specs/2026-09-18-httpclient-capability-composition-ownership.md b/docs/design/2026-09-18-httpclient-capability-composition-ownership.md similarity index 83% rename from docs/superpowers/specs/2026-09-18-httpclient-capability-composition-ownership.md rename to docs/design/2026-09-18-httpclient-capability-composition-ownership.md index 233eb2c7..9706f444 100644 --- a/docs/superpowers/specs/2026-09-18-httpclient-capability-composition-ownership.md +++ b/docs/design/2026-09-18-httpclient-capability-composition-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: HTTP client 조립을 app-bootstrap에서 그 capability leaf로 옮기는 설계다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + # HTTP Client Capability Composition Ownership ## Goal diff --git a/docs/superpowers/specs/2026-09-18-jpa-capability-composition-ownership.md b/docs/design/2026-09-18-jpa-capability-composition-ownership.md similarity index 87% rename from docs/superpowers/specs/2026-09-18-jpa-capability-composition-ownership.md rename to docs/design/2026-09-18-jpa-capability-composition-ownership.md index 5d31943a..0842c8bc 100644 --- a/docs/superpowers/specs/2026-09-18-jpa-capability-composition-ownership.md +++ b/docs/design/2026-09-18-jpa-capability-composition-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: 관계형 영속성 조립을 app-bootstrap에서 persistence-jpa로 옮기는 설계다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA Capability Composition Ownership ## Goal diff --git a/docs/superpowers/specs/2026-09-18-jpa-runtime-master-switch.md b/docs/design/2026-09-18-jpa-runtime-master-switch.md similarity index 81% rename from docs/superpowers/specs/2026-09-18-jpa-runtime-master-switch.md rename to docs/design/2026-09-18-jpa-runtime-master-switch.md index d7f8062a..de89b53b 100644 --- a/docs/superpowers/specs/2026-09-18-jpa-runtime-master-switch.md +++ b/docs/design/2026-09-18-jpa-runtime-master-switch.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: JPA 조립 후보 둘이 같은 스위치를 따르게 하는 설계다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA Runtime Master Switch ## Problem diff --git a/docs/superpowers/specs/2026-09-18-messaging-platform-bridge-design.md b/docs/design/2026-09-18-messaging-platform-bridge-design.md similarity index 90% rename from docs/superpowers/specs/2026-09-18-messaging-platform-bridge-design.md rename to docs/design/2026-09-18-messaging-platform-bridge-design.md index 7db72d14..52051b27 100644 --- a/docs/superpowers/specs/2026-09-18-messaging-platform-bridge-design.md +++ b/docs/design/2026-09-18-messaging-platform-bridge-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: 애플리케이션 전용 브로커 이음매를 메시징 플랫폼으로 가는 bridge 하나로 바꾸는 설계다. +- 현재 정본: `docs/messaging/support-matrix.md` + + # Messaging Platform Bridge Design ## Goal diff --git a/docs/superpowers/specs/2026-09-18-mongo-health-composition-ownership.md b/docs/design/2026-09-18-mongo-health-composition-ownership.md similarity index 82% rename from docs/superpowers/specs/2026-09-18-mongo-health-composition-ownership.md rename to docs/design/2026-09-18-mongo-health-composition-ownership.md index 19b4d0e4..059cf9ca 100644 --- a/docs/superpowers/specs/2026-09-18-mongo-health-composition-ownership.md +++ b/docs/design/2026-09-18-mongo-health-composition-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: Mongo health 조립을 persistence-mongo leaf로 옮기는 설계다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + # Mongo Health Composition Ownership ## Goal diff --git a/docs/superpowers/specs/2026-09-18-notification-capability-composition-ownership.md b/docs/design/2026-09-18-notification-capability-composition-ownership.md similarity index 86% rename from docs/superpowers/specs/2026-09-18-notification-capability-composition-ownership.md rename to docs/design/2026-09-18-notification-capability-composition-ownership.md index 6e390448..522ea5cf 100644 --- a/docs/superpowers/specs/2026-09-18-notification-capability-composition-ownership.md +++ b/docs/design/2026-09-18-notification-capability-composition-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: 알림 provider·런타임 조립을 app-bootstrap에서 알림 capability로 옮기는 설계다. +- 현재 정본: `docs/notification/support-matrix.md` + + # Notification Capability Composition Ownership ## Goal diff --git a/docs/superpowers/specs/2026-09-18-outbox-transport-only-cutover-design.md b/docs/design/2026-09-18-outbox-transport-only-cutover-design.md similarity index 94% rename from docs/superpowers/specs/2026-09-18-outbox-transport-only-cutover-design.md rename to docs/design/2026-09-18-outbox-transport-only-cutover-design.md index 4e7b41cc..4bf0c391 100644 --- a/docs/superpowers/specs/2026-09-18-outbox-transport-only-cutover-design.md +++ b/docs/design/2026-09-18-outbox-transport-only-cutover-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-09-18 +- 요약: 기존 outbox 저장소는 두고 발행 전송만 메시징 플랫폼으로 넘기는 설계다. +- 현재 정본: `src/composition/outbox-relay/README.md` + + # Outbox Transport-Only Cutover Design ## Status diff --git a/docs/superpowers/specs/2026-09-18-outbox-v2-canonical-storage-alignment.md b/docs/design/2026-09-18-outbox-v2-canonical-storage-alignment.md similarity index 94% rename from docs/superpowers/specs/2026-09-18-outbox-v2-canonical-storage-alignment.md rename to docs/design/2026-09-18-outbox-v2-canonical-storage-alignment.md index 0e4131d7..381e47dc 100644 --- a/docs/superpowers/specs/2026-09-18-outbox-v2-canonical-storage-alignment.md +++ b/docs/design/2026-09-18-outbox-v2-canonical-storage-alignment.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 폐기 +- 작성일: 2026-09-18 +- 요약: outbox V2 저장소를 canonical 이벤트에 맞추는 설계다. V2 세대는 2026-09-25에 지웠다. +- 현재 정본: `docs/capability-status.md` + + # Outbox V2 Canonical Storage Alignment ## Status diff --git a/docs/superpowers/specs/2026-09-18-outbox-v2-one-record-publication-policy.md b/docs/design/2026-09-18-outbox-v2-one-record-publication-policy.md similarity index 88% rename from docs/superpowers/specs/2026-09-18-outbox-v2-one-record-publication-policy.md rename to docs/design/2026-09-18-outbox-v2-one-record-publication-policy.md index 3a440a78..7fd1e415 100644 --- a/docs/superpowers/specs/2026-09-18-outbox-v2-one-record-publication-policy.md +++ b/docs/design/2026-09-18-outbox-v2-one-record-publication-policy.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 폐기 +- 작성일: 2026-09-18 +- 요약: outbox V2에서 기록 하나를 한 번 발행하는 정책 설계다. V2 세대는 2026-09-25에 지웠다. +- 현재 정본: `docs/capability-status.md` + + # Outbox V2 One-Record Publication Policy ## Status diff --git a/docs/superpowers/specs/2026-09-18-postgresql-idempotency-composition-ownership.md b/docs/design/2026-09-18-postgresql-idempotency-composition-ownership.md similarity index 82% rename from docs/superpowers/specs/2026-09-18-postgresql-idempotency-composition-ownership.md rename to docs/design/2026-09-18-postgresql-idempotency-composition-ownership.md index 57d10f20..1c686ba0 100644 --- a/docs/superpowers/specs/2026-09-18-postgresql-idempotency-composition-ownership.md +++ b/docs/design/2026-09-18-postgresql-idempotency-composition-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: PostgreSQL 멱등성 저장소 조립을 app-bootstrap에서 persistence-jpa로 옮기는 설계다. +- 현재 정본: `src/composition/idempotency/README.md` + + # PostgreSQL Idempotency Composition Ownership ## Goal diff --git a/docs/superpowers/specs/2026-09-18-runtime-environment-tracing-ssot.md b/docs/design/2026-09-18-runtime-environment-tracing-ssot.md similarity index 86% rename from docs/superpowers/specs/2026-09-18-runtime-environment-tracing-ssot.md rename to docs/design/2026-09-18-runtime-environment-tracing-ssot.md index bf8e0b32..19d65ed3 100644 --- a/docs/superpowers/specs/2026-09-18-runtime-environment-tracing-ssot.md +++ b/docs/design/2026-09-18-runtime-environment-tracing-ssot.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: tracing과 capability 검증이 런타임 profile 어휘 하나를 쓰게 하는 설계다. +- 현재 정본: `src/app-bootstrap/README.md` + + # Runtime Environment and Tracing SSOT ## Goal diff --git a/docs/superpowers/specs/2026-09-18-secret-source-port-ownership.md b/docs/design/2026-09-18-secret-source-port-ownership.md similarity index 85% rename from docs/superpowers/specs/2026-09-18-secret-source-port-ownership.md rename to docs/design/2026-09-18-secret-source-port-ownership.md index 78a72696..510578d7 100644 --- a/docs/superpowers/specs/2026-09-18-secret-source-port-ownership.md +++ b/docs/design/2026-09-18-secret-source-port-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: 시크릿 출처 포트를 application이 소유하고 구현을 adapter로 옮기는 설계다. +- 현재 정본: `docs/registries/env-keys.yaml` + + # Secret Source Port Ownership ## Goal diff --git a/docs/superpowers/specs/2026-09-18-startup-failure-log-context-state.md b/docs/design/2026-09-18-startup-failure-log-context-state.md similarity index 81% rename from docs/superpowers/specs/2026-09-18-startup-failure-log-context-state.md rename to docs/design/2026-09-18-startup-failure-log-context-state.md index 5c75371d..957fd089 100644 --- a/docs/superpowers/specs/2026-09-18-startup-failure-log-context-state.md +++ b/docs/design/2026-09-18-startup-failure-log-context-state.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: 기동 실패 로그 상태를 프로세스 전역이 아닌 logger context에 두는 설계다. +- 현재 정본: `docs/observability/log-fields.md` + + # Startup Failure Log Context State ## Goal diff --git a/docs/superpowers/specs/2026-09-18-test-architecture-phase2-provider-ownership.md b/docs/design/2026-09-18-test-architecture-phase2-provider-ownership.md similarity index 88% rename from docs/superpowers/specs/2026-09-18-test-architecture-phase2-provider-ownership.md rename to docs/design/2026-09-18-test-architecture-phase2-provider-ownership.md index 682fa981..f6094075 100644 --- a/docs/superpowers/specs/2026-09-18-test-architecture-phase2-provider-ownership.md +++ b/docs/design/2026-09-18-test-architecture-phase2-provider-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: provider 증거 테스트의 소유 leaf를 정리하는 테스트 구조 2단계 설계다. +- 현재 정본: `docs/testing/TESTING_STRATEGY.md` + + # Test Architecture Phase 2 — Provider Ownership ## Goal diff --git a/docs/superpowers/specs/2026-09-18-test-taxonomy-ssot-alignment.md b/docs/design/2026-09-18-test-taxonomy-ssot-alignment.md similarity index 87% rename from docs/superpowers/specs/2026-09-18-test-taxonomy-ssot-alignment.md rename to docs/design/2026-09-18-test-taxonomy-ssot-alignment.md index 767e4a17..e30c4669 100644 --- a/docs/superpowers/specs/2026-09-18-test-taxonomy-ssot-alignment.md +++ b/docs/design/2026-09-18-test-taxonomy-ssot-alignment.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: 테스트 전략 문서를 테스트 분류 정본에 맞추는 설계다. +- 현재 정본: `docs/testing/TESTING_STRATEGY.md` + + # Test Taxonomy SSOT Alignment ## Goal diff --git a/docs/superpowers/specs/2026-09-19-build-release-review-remediation-design.md b/docs/design/2026-09-19-build-release-review-remediation-design.md similarity index 80% rename from docs/superpowers/specs/2026-09-19-build-release-review-remediation-design.md rename to docs/design/2026-09-19-build-release-review-remediation-design.md index 66a85a6e..09d1dd23 100644 --- a/docs/superpowers/specs/2026-09-19-build-release-review-remediation-design.md +++ b/docs/design/2026-09-19-build-release-review-remediation-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-19 +- 요약: 빌드·CI 리뷰가 찾은 조립 결함을 고치는 설계다. +- 현재 정본: `docs/work/reference/gates.md` + + # Build / Release Review Remediation Design ## Source diff --git a/docs/superpowers/specs/2026-09-19-capability-dependency-validation-context.md b/docs/design/2026-09-19-capability-dependency-validation-context.md similarity index 86% rename from docs/superpowers/specs/2026-09-19-capability-dependency-validation-context.md rename to docs/design/2026-09-19-capability-dependency-validation-context.md index 0c7e80d6..bb5877fd 100644 --- a/docs/superpowers/specs/2026-09-19-capability-dependency-validation-context.md +++ b/docs/design/2026-09-19-capability-dependency-validation-context.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 폐기 +- 작성일: 2026-09-19 +- 요약: capability 의존 검증을 StartupValidationContext로 옮기는 설계다. capability 의존 검증기는 2026-09-25에 지웠다. +- 현재 정본: `docs/capability-status.md` + + # Capability Dependency Validation Context ## Goal diff --git a/docs/superpowers/specs/2026-09-19-env-contract-verifier-truth-surface.md b/docs/design/2026-09-19-env-contract-verifier-truth-surface.md similarity index 89% rename from docs/superpowers/specs/2026-09-19-env-contract-verifier-truth-surface.md rename to docs/design/2026-09-19-env-contract-verifier-truth-surface.md index 1496ceee..aecc69f2 100644 --- a/docs/superpowers/specs/2026-09-19-env-contract-verifier-truth-surface.md +++ b/docs/design/2026-09-19-env-contract-verifier-truth-surface.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-19 +- 요약: env 키 검사가 선언과 실제 사용을 구분하게 하는 설계다. +- 현재 정본: `docs/registries/env-keys.yaml` + + # Env Contract Verifier Truth Surface ## Goal diff --git a/docs/superpowers/specs/2026-09-19-fileserver-composition-decomposition.md b/docs/design/2026-09-19-fileserver-composition-decomposition.md similarity index 91% rename from docs/superpowers/specs/2026-09-19-fileserver-composition-decomposition.md rename to docs/design/2026-09-19-fileserver-composition-decomposition.md index 0064b703..9ac265b4 100644 --- a/docs/superpowers/specs/2026-09-19-fileserver-composition-decomposition.md +++ b/docs/design/2026-09-19-fileserver-composition-decomposition.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-19 +- 요약: 파일 서버 조립을 관심사별 설정 다섯 개로 나누는 설계다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver Composition Decomposition ## Goal diff --git a/docs/superpowers/specs/2026-09-19-fileserver-verification-read-failure-remediation.md b/docs/design/2026-09-19-fileserver-verification-read-failure-remediation.md similarity index 81% rename from docs/superpowers/specs/2026-09-19-fileserver-verification-read-failure-remediation.md rename to docs/design/2026-09-19-fileserver-verification-read-failure-remediation.md index e7945cb7..c20b4d3f 100644 --- a/docs/superpowers/specs/2026-09-19-fileserver-verification-read-failure-remediation.md +++ b/docs/design/2026-09-19-fileserver-verification-read-failure-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-19 +- 요약: 파일 검증이 읽기 실패를 빈 내용으로 오인하지 않게 고치는 설계다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver Verification Read Failure Remediation ## Source diff --git a/docs/superpowers/specs/2026-09-19-mongo-client-runtime-review-remediation.md b/docs/design/2026-09-19-mongo-client-runtime-review-remediation.md similarity index 90% rename from docs/superpowers/specs/2026-09-19-mongo-client-runtime-review-remediation.md rename to docs/design/2026-09-19-mongo-client-runtime-review-remediation.md index 5bfcf0ea..1d7f68d4 100644 --- a/docs/superpowers/specs/2026-09-19-mongo-client-runtime-review-remediation.md +++ b/docs/design/2026-09-19-mongo-client-runtime-review-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-19 +- 요약: Mongo client 런타임 리뷰의 Critical 둘을 고치는 설계다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + # Mongo Client Runtime Review Remediation ## Source diff --git a/docs/superpowers/specs/2026-09-19-multi-instance-runtime-contract.md b/docs/design/2026-09-19-multi-instance-runtime-contract.md similarity index 88% rename from docs/superpowers/specs/2026-09-19-multi-instance-runtime-contract.md rename to docs/design/2026-09-19-multi-instance-runtime-contract.md index 6299c006..8dce6bf9 100644 --- a/docs/superpowers/specs/2026-09-19-multi-instance-runtime-contract.md +++ b/docs/design/2026-09-19-multi-instance-runtime-contract.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-19 +- 요약: 가짜 조정 bean 없이 다중 인스턴스 런타임 계약을 세우는 설계다. +- 현재 정본: `src/app-bootstrap/README.md` + + # Multi-instance Runtime Contract ## Goal diff --git a/docs/superpowers/specs/2026-09-19-prod-secret-consumer-alignment.md b/docs/design/2026-09-19-prod-secret-consumer-alignment.md similarity index 84% rename from docs/superpowers/specs/2026-09-19-prod-secret-consumer-alignment.md rename to docs/design/2026-09-19-prod-secret-consumer-alignment.md index a88b9183..28d2830d 100644 --- a/docs/superpowers/specs/2026-09-19-prod-secret-consumer-alignment.md +++ b/docs/design/2026-09-19-prod-secret-consumer-alignment.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-19 +- 요약: 운영 기동이 실제로 쓰는 시크릿만 요구하게 맞추는 설계다. +- 현재 정본: `docs/registries/env-keys.yaml` + + # Prod Secret Consumer Alignment ## Goal diff --git a/docs/superpowers/specs/2026-09-19-runtime-profile-access-boundary.md b/docs/design/2026-09-19-runtime-profile-access-boundary.md similarity index 82% rename from docs/superpowers/specs/2026-09-19-runtime-profile-access-boundary.md rename to docs/design/2026-09-19-runtime-profile-access-boundary.md index 8c894318..64c1a780 100644 --- a/docs/superpowers/specs/2026-09-19-runtime-profile-access-boundary.md +++ b/docs/design/2026-09-19-runtime-profile-access-boundary.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-19 +- 요약: 운영 코드가 Spring active profile을 직접 읽지 않게 하는 경계 설계다. +- 현재 정본: `src/app-bootstrap/README.md` + + # Runtime Profile Access Boundary ## Goal diff --git a/docs/superpowers/specs/2026-09-19-startup-order-contract.md b/docs/design/2026-09-19-startup-order-contract.md similarity index 80% rename from docs/superpowers/specs/2026-09-19-startup-order-contract.md rename to docs/design/2026-09-19-startup-order-contract.md index 7c87a89f..bb478264 100644 --- a/docs/superpowers/specs/2026-09-19-startup-order-contract.md +++ b/docs/design/2026-09-19-startup-order-contract.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-19 +- 요약: 기동 순서를 실행 가능한 계약 테스트로 고정하는 설계다. +- 현재 정본: `src/app-bootstrap/README.md` + + # Startup Order Contract ## Goal diff --git a/docs/superpowers/specs/2026-09-19-test-support-ownership-closure.md b/docs/design/2026-09-19-test-support-ownership-closure.md similarity index 79% rename from docs/superpowers/specs/2026-09-19-test-support-ownership-closure.md rename to docs/design/2026-09-19-test-support-ownership-closure.md index 0c7b7a63..e0032e8d 100644 --- a/docs/superpowers/specs/2026-09-19-test-support-ownership-closure.md +++ b/docs/design/2026-09-19-test-support-ownership-closure.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-19 +- 요약: 공유 테스트 지원 코드의 소유 위치를 마무리하는 설계다. +- 현재 정본: `docs/testing/TESTING_STRATEGY.md` + + # Test Support Ownership Closure ## Goal diff --git a/docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md b/docs/design/2026-09-25-capability-module-packaging-design.md similarity index 95% rename from docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md rename to docs/design/2026-09-25-capability-module-packaging-design.md index bb7e8833..01e50d49 100644 --- a/docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md +++ b/docs/design/2026-09-25-capability-module-packaging-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-09-25 +- 요약: 부가 기능을 붙이면 켜지고 떼면 사라지는 capability 모듈로 바꾸고 기본 조립을 web으로 줄인 설계다. +- 현재 정본: `docs/capability-status.md` + + # 부가 기능(capability) 제공 방식과 리뷰 후속 정리 — 설계 초안 - 상태: **확정** (2026-09-25 소유자 결정 2건 반영 — 10절). 실행 계획: `docs/superpowers/plans/2026-09-25-capability-module-packaging.md` diff --git a/docs/superpowers/specs/2026-11-06-error-code-log-level-design.md b/docs/design/2026-11-06-error-code-log-level-design.md similarity index 97% rename from docs/superpowers/specs/2026-11-06-error-code-log-level-design.md rename to docs/design/2026-11-06-error-code-log-level-design.md index 4392d283..33b909c4 100644 --- a/docs/superpowers/specs/2026-11-06-error-code-log-level-design.md +++ b/docs/design/2026-11-06-error-code-log-level-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-11-06 +- 요약: 오류 코드 레지스트리에 log_level 칸을 두지 않고 실패 종류·경로가 레벨을 정하게 한 설계 메모다. +- 현재 정본: `docs/registries/error-codes.yaml` + + # `error-codes.yaml`의 `log_level` 칸 — 설계 메모 - 상태: **확정** (2026-11-06, 소유자 답 "권하는 안대로"). 결정은 10절이다. 아래 1~9절은 결정 전에 쓴 그대로 둔다. diff --git a/docs/evidence/object-storage/batch-a-checkpoint.md b/docs/history/evidence/object-storage/batch-a-checkpoint.md similarity index 89% rename from docs/evidence/object-storage/batch-a-checkpoint.md rename to docs/history/evidence/object-storage/batch-a-checkpoint.md index b350ee16..740b5eaa 100644 --- a/docs/evidence/object-storage/batch-a-checkpoint.md +++ b/docs/history/evidence/object-storage/batch-a-checkpoint.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-07-28 +- 요약: Object Storage 작업 Batch A의 체크포인트 기록이다. +- 현재 정본: `src/adapter/outbound/objectstorage/README.md` + + # Object Storage Batch A Checkpoint - Date: 2026-07-28 diff --git a/docs/evidence/object-storage/batch-b-checkpoint.md b/docs/history/evidence/object-storage/batch-b-checkpoint.md similarity index 93% rename from docs/evidence/object-storage/batch-b-checkpoint.md rename to docs/history/evidence/object-storage/batch-b-checkpoint.md index b7113d20..0bac6cd2 100644 --- a/docs/evidence/object-storage/batch-b-checkpoint.md +++ b/docs/history/evidence/object-storage/batch-b-checkpoint.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-07-28 +- 요약: Object Storage 작업 Batch B의 체크포인트 기록이다. +- 현재 정본: `src/adapter/outbound/objectstorage/README.md` + + # Object Storage Batch B Checkpoint - Date: 2026-07-28 diff --git a/docs/evidence/object-storage/batch-c-progress.md b/docs/history/evidence/object-storage/batch-c-progress.md similarity index 90% rename from docs/evidence/object-storage/batch-c-progress.md rename to docs/history/evidence/object-storage/batch-c-progress.md index 0a632d8d..95ee56f0 100644 --- a/docs/evidence/object-storage/batch-c-progress.md +++ b/docs/history/evidence/object-storage/batch-c-progress.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-07-28 +- 요약: Object Storage 작업 Batch C의 진행 기록이다. +- 현재 정본: `src/adapter/outbound/objectstorage/README.md` + + # Object Storage Batch C Checkpoint - Date: 2026-07-28 diff --git a/docs/evidence/object-storage/batch-d-checkpoint.md b/docs/history/evidence/object-storage/batch-d-checkpoint.md similarity index 91% rename from docs/evidence/object-storage/batch-d-checkpoint.md rename to docs/history/evidence/object-storage/batch-d-checkpoint.md index baa85bb2..cb48134c 100644 --- a/docs/evidence/object-storage/batch-d-checkpoint.md +++ b/docs/history/evidence/object-storage/batch-d-checkpoint.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-07-28 +- 요약: Object Storage 작업 Batch D의 체크포인트 기록이다. +- 현재 정본: `src/adapter/outbound/objectstorage/README.md` + + # Object Storage Batch D Checkpoint - Date: 2026-07-28 diff --git a/docs/evidence/object-storage/batch-e-pause-checkpoint.md b/docs/history/evidence/object-storage/batch-e-pause-checkpoint.md similarity index 90% rename from docs/evidence/object-storage/batch-e-pause-checkpoint.md rename to docs/history/evidence/object-storage/batch-e-pause-checkpoint.md index 914522cb..d5772fb5 100644 --- a/docs/evidence/object-storage/batch-e-pause-checkpoint.md +++ b/docs/history/evidence/object-storage/batch-e-pause-checkpoint.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-07-31 +- 요약: Object Storage 작업 Batch E를 멈춘 시점의 체크포인트 기록이다. +- 현재 정본: `src/adapter/outbound/objectstorage/README.md` + + # Object Storage Batch E Pause Checkpoint - Recorded: 2026-07-29 (Asia/Seoul) diff --git a/docs/evidence/object-storage/phase-0-inventory.md b/docs/history/evidence/object-storage/phase-0-inventory.md similarity index 90% rename from docs/evidence/object-storage/phase-0-inventory.md rename to docs/history/evidence/object-storage/phase-0-inventory.md index 9220594d..18645b9d 100644 --- a/docs/evidence/object-storage/phase-0-inventory.md +++ b/docs/history/evidence/object-storage/phase-0-inventory.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-07-31 +- 요약: Object Storage 작업을 시작하기 전 0단계 현황 조사다. +- 현재 정본: `src/adapter/outbound/objectstorage/README.md` + + # Object Storage Phase 0 Inventory - Captured: 2026-07-28 diff --git a/docs/superpowers/packages/fileserver/README.md b/docs/history/packages/fileserver/README.md similarity index 73% rename from docs/superpowers/packages/fileserver/README.md rename to docs/history/packages/fileserver/README.md index 95aca875..d483618e 100644 --- a/docs/superpowers/packages/fileserver/README.md +++ b/docs/history/packages/fileserver/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-11 +- 요약: 파일 서버 설계 패키지가 처음 납품됐을 때의 안내다. 본문 문서는 docs/design과 docs/history/plans에 있다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + > **보존 안내** — 이 파일은 저장소 루트 `fileserver-superpowers-package/` 에 있던 납품 패키지의 README다. > 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고, > 실행 불가 상태였던 `validate_fileserver_docs.py` 는 제거했다. diff --git a/docs/superpowers/packages/fileserver/VALIDATION.md b/docs/history/packages/fileserver/VALIDATION.md similarity index 83% rename from docs/superpowers/packages/fileserver/VALIDATION.md rename to docs/history/packages/fileserver/VALIDATION.md index 0b19a1d4..b4bdb35a 100644 --- a/docs/superpowers/packages/fileserver/VALIDATION.md +++ b/docs/history/packages/fileserver/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-11 +- 요약: 파일 서버 설계 패키지를 받을 때 한 정적 검증 결과다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver Superpowers 문서 검증 **결과:** PASS diff --git a/docs/graphql-superpowers-package/MANIFEST.sha256 b/docs/history/packages/graphql-superpowers-package/MANIFEST.sha256 similarity index 100% rename from docs/graphql-superpowers-package/MANIFEST.sha256 rename to docs/history/packages/graphql-superpowers-package/MANIFEST.sha256 diff --git a/docs/graphql-superpowers-package/README.md b/docs/history/packages/graphql-superpowers-package/README.md similarity index 74% rename from docs/graphql-superpowers-package/README.md rename to docs/history/packages/graphql-superpowers-package/README.md index 4eff19b3..adaf6d8b 100644 --- a/docs/graphql-superpowers-package/README.md +++ b/docs/history/packages/graphql-superpowers-package/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: GraphQL 설계 패키지 묶음의 안내다. 안의 MANIFEST.sha256는 머리 블록을 달기 전 납품 바이트의 해시다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # GraphQL Superpowers 설계 패키지 이 패키지는 `GraphQL API 실행 플랫폼 심층 리서치`를 구현 기준선으로 변환한 설계서와 실행 계획서다. diff --git a/docs/superpowers/packages/graphql/VALIDATION.md b/docs/history/packages/graphql-superpowers-package/VALIDATION.md similarity index 88% rename from docs/superpowers/packages/graphql/VALIDATION.md rename to docs/history/packages/graphql-superpowers-package/VALIDATION.md index 725a4b2a..30ab0b52 100644 --- a/docs/superpowers/packages/graphql/VALIDATION.md +++ b/docs/history/packages/graphql-superpowers-package/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: GraphQL 설계 패키지 묶음을 받을 때 한 정적 검증 결과다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # GraphQL Superpowers 문서 정적 검증 결과 - **검증 시각 기준:** 2026-08-12 diff --git a/docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md b/docs/history/packages/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md similarity index 99% rename from docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md rename to docs/history/packages/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md index 904319ae..eddb4a19 100644 --- a/docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md +++ b/docs/history/packages/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-12 +- 요약: GraphQL 실행 계획의 납품 원본이다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # GraphQL Advanced Capability Expansion Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md b/docs/history/packages/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md similarity index 99% rename from docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md rename to docs/history/packages/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md index 2f5204e1..7cb7e168 100644 --- a/docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md +++ b/docs/history/packages/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-12 +- 요약: GraphQL 실행 계획의 납품 원본이다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # GraphQL API 실행 플랫폼 Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/graphql-superpowers-package/docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md b/docs/history/packages/graphql-superpowers-package/docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md similarity index 99% rename from docs/graphql-superpowers-package/docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md rename to docs/history/packages/graphql-superpowers-package/docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md index 836c9d33..93a40c8a 100644 --- a/docs/graphql-superpowers-package/docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md +++ b/docs/history/packages/graphql-superpowers-package/docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-12 +- 요약: GraphQL 설계서의 납품 원본이다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # GraphQL API 실행 플랫폼 설계서 - **문서 상태:** 구현 기준선 확정 diff --git a/docs/graphql-superpowers-package/validate_graphql_docs.py b/docs/history/packages/graphql-superpowers-package/validate_graphql_docs.py similarity index 100% rename from docs/graphql-superpowers-package/validate_graphql_docs.py rename to docs/history/packages/graphql-superpowers-package/validate_graphql_docs.py diff --git a/docs/superpowers/packages/graphql/README.md b/docs/history/packages/graphql/README.md similarity index 79% rename from docs/superpowers/packages/graphql/README.md rename to docs/history/packages/graphql/README.md index 2a0e7212..6a8549b7 100644 --- a/docs/superpowers/packages/graphql/README.md +++ b/docs/history/packages/graphql/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: GraphQL 설계 패키지가 처음 납품됐을 때의 안내다. 본문 문서는 docs/design과 docs/history/plans에 있다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + > **보존 안내** — 이 파일은 저장소 루트 `graphql-superpowers-package/` 에 있던 납품 패키지의 README다. > 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고, > `validate_graphql_docs.py` 와 `MANIFEST.sha256` 은 제거했다. diff --git a/docs/graphql-superpowers-package/VALIDATION.md b/docs/history/packages/graphql/VALIDATION.md similarity index 88% rename from docs/graphql-superpowers-package/VALIDATION.md rename to docs/history/packages/graphql/VALIDATION.md index 725a4b2a..c080bdb3 100644 --- a/docs/graphql-superpowers-package/VALIDATION.md +++ b/docs/history/packages/graphql/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: GraphQL 설계 패키지를 받을 때 한 정적 검증 결과다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # GraphQL Superpowers 문서 정적 검증 결과 - **검증 시각 기준:** 2026-08-12 diff --git a/docs/superpowers/packages/httpclient/README.md b/docs/history/packages/httpclient/README.md similarity index 73% rename from docs/superpowers/packages/httpclient/README.md rename to docs/history/packages/httpclient/README.md index 3dbc997e..f371910a 100644 --- a/docs/superpowers/packages/httpclient/README.md +++ b/docs/history/packages/httpclient/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-11 +- 요약: HTTP client 설계 패키지가 처음 납품됐을 때의 안내다. 본문 문서는 docs/design과 docs/history/plans에 있다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + > **보존 안내** — 이 파일은 저장소 루트 `httpclient-superpowers-package/` 에 있던 납품 패키지의 README다. > 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고, > 실행 불가 상태였던 `validate_httpclient_docs.py` 는 제거했다. diff --git a/docs/superpowers/packages/httpclient/VALIDATION.md b/docs/history/packages/httpclient/VALIDATION.md similarity index 72% rename from docs/superpowers/packages/httpclient/VALIDATION.md rename to docs/history/packages/httpclient/VALIDATION.md index 4f534975..cf624b1d 100644 --- a/docs/superpowers/packages/httpclient/VALIDATION.md +++ b/docs/history/packages/httpclient/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-11 +- 요약: HTTP client 설계 패키지를 받을 때 한 정적 검증 결과다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + # HTTP Client Superpowers 문서 검증 **검증 결과:** PASS diff --git a/docs/superpowers/packages/jpa/README.md b/docs/history/packages/jpa/README.md similarity index 85% rename from docs/superpowers/packages/jpa/README.md rename to docs/history/packages/jpa/README.md index 20aed5ea..6064d255 100644 --- a/docs/superpowers/packages/jpa/README.md +++ b/docs/history/packages/jpa/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: JPA 설계 패키지가 처음 납품됐을 때의 안내다. 본문 문서는 docs/design과 docs/history/plans에 있다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + > **보존 안내** — 이 파일은 저장소 루트 `jpa-superpowers-package/` 에 있던 납품 패키지의 README다. > 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고, > `validate_jpa_docs.py` 와 `MANIFEST.sha256` 은 제거했다. diff --git a/docs/superpowers/packages/jpa/VALIDATION.md b/docs/history/packages/jpa/VALIDATION.md similarity index 99% rename from docs/superpowers/packages/jpa/VALIDATION.md rename to docs/history/packages/jpa/VALIDATION.md index e8d0b2fb..32bf2ac6 100644 --- a/docs/superpowers/packages/jpa/VALIDATION.md +++ b/docs/history/packages/jpa/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: JPA 설계 패키지를 받을 때 한 정적 검증 결과다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA Superpowers 문서 정적 검증 - 결과: **PASS** diff --git a/docs/superpowers/packages/messaging/README.md b/docs/history/packages/messaging/README.md similarity index 85% rename from docs/superpowers/packages/messaging/README.md rename to docs/history/packages/messaging/README.md index 627adc1b..f35c7a44 100644 --- a/docs/superpowers/packages/messaging/README.md +++ b/docs/history/packages/messaging/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: 메시징 설계 패키지가 처음 납품됐을 때의 안내다. 본문 문서는 docs/design과 docs/history/plans에 있다. +- 현재 정본: `docs/messaging/support-matrix.md` + + > **보존 안내** — 이 파일은 저장소 루트 `messaging-superpowers-package/` 에 있던 납품 패키지의 README다. > 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고, > `validate_messaging_docs.py` 와 `MANIFEST.sha256` 은 제거했다. diff --git a/docs/superpowers/packages/messaging/VALIDATION.md b/docs/history/packages/messaging/VALIDATION.md similarity index 97% rename from docs/superpowers/packages/messaging/VALIDATION.md rename to docs/history/packages/messaging/VALIDATION.md index d7029704..3ccec775 100644 --- a/docs/superpowers/packages/messaging/VALIDATION.md +++ b/docs/history/packages/messaging/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: 메시징 설계 패키지를 받을 때 한 정적 검증 결과다. +- 현재 정본: `docs/messaging/support-matrix.md` + + # Messaging Superpowers 문서 정적 검증 - 설계서: `messaging-platform-design.md` — 2,608행, 74,649 bytes diff --git a/docs/superpowers/packages/mongodb/README.md b/docs/history/packages/mongodb/README.md similarity index 78% rename from docs/superpowers/packages/mongodb/README.md rename to docs/history/packages/mongodb/README.md index 96bb42df..cb7bda75 100644 --- a/docs/superpowers/packages/mongodb/README.md +++ b/docs/history/packages/mongodb/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: MongoDB 설계 패키지가 처음 납품됐을 때의 안내다. 본문 문서는 docs/design과 docs/history/plans에 있다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + > **보존 안내** — 이 파일은 저장소 루트 `mongodb-superpowers-package/` 에 있던 납품 패키지의 README다. > 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고, > `validate_mongodb_docs.py` 와 `MANIFEST.sha256` 은 제거했다. diff --git a/docs/superpowers/packages/mongodb/VALIDATION.md b/docs/history/packages/mongodb/VALIDATION.md similarity index 98% rename from docs/superpowers/packages/mongodb/VALIDATION.md rename to docs/history/packages/mongodb/VALIDATION.md index 041c890f..1e534206 100644 --- a/docs/superpowers/packages/mongodb/VALIDATION.md +++ b/docs/history/packages/mongodb/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: MongoDB 설계 패키지를 받을 때 한 정적 검증 결과다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + # MongoDB Superpowers 문서 정적 검증 결과 ## 결과 diff --git a/docs/superpowers/packages/notification/README.md b/docs/history/packages/notification/README.md similarity index 85% rename from docs/superpowers/packages/notification/README.md rename to docs/history/packages/notification/README.md index 85dbebd2..c93d7311 100644 --- a/docs/superpowers/packages/notification/README.md +++ b/docs/history/packages/notification/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: 알림 설계 패키지가 처음 납품됐을 때의 안내다. 본문 문서는 docs/design과 docs/history/plans에 있다. +- 현재 정본: `docs/notification/support-matrix.md` + + > **보존 안내** — 이 파일은 저장소 루트 `notification-superpowers-package/` 에 있던 납품 패키지의 README다. > 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고, > 실행 불가 상태였던 `validate_notification_docs.py` 와 `MANIFEST.sha256` 은 제거했다. diff --git a/docs/superpowers/packages/notification/VALIDATION.md b/docs/history/packages/notification/VALIDATION.md similarity index 98% rename from docs/superpowers/packages/notification/VALIDATION.md rename to docs/history/packages/notification/VALIDATION.md index c063263f..1faf2ab7 100644 --- a/docs/superpowers/packages/notification/VALIDATION.md +++ b/docs/history/packages/notification/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: 알림 설계 패키지를 받을 때 한 정적 검증 결과다. +- 현재 정본: `docs/notification/support-matrix.md` + + # Notification Superpowers 문서 정적 검증 - 결과: **PASS** diff --git a/docs/superpowers/packages/redis/README.md b/docs/history/packages/redis/README.md similarity index 85% rename from docs/superpowers/packages/redis/README.md rename to docs/history/packages/redis/README.md index 17c31e58..8b41b5e0 100644 --- a/docs/superpowers/packages/redis/README.md +++ b/docs/history/packages/redis/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-11 +- 요약: Redis 설계 패키지가 처음 납품됐을 때의 안내다. 본문 문서는 docs/design과 docs/history/plans에 있다. +- 현재 정본: `docs/redis/support-matrix.md` + + > **보존 안내** — 이 파일은 저장소 루트 `redis-superpowers-package/` 에 있던 납품 패키지의 README다. > 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고, > 이 패키지에는 검증 스크립트가 없었다. diff --git a/docs/superpowers/packages/redis/VALIDATION.md b/docs/history/packages/redis/VALIDATION.md similarity index 82% rename from docs/superpowers/packages/redis/VALIDATION.md rename to docs/history/packages/redis/VALIDATION.md index a11631b0..826e364b 100644 --- a/docs/superpowers/packages/redis/VALIDATION.md +++ b/docs/history/packages/redis/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-11 +- 요약: Redis 설계 패키지를 받을 때 한 정적 검증 결과다. +- 현재 정본: `docs/redis/support-matrix.md` + + # 정적 검증 결과 - **결과:** PASS diff --git a/docs/web-superpowers-package/MANIFEST.sha256 b/docs/history/packages/web-superpowers-package/MANIFEST.sha256 similarity index 100% rename from docs/web-superpowers-package/MANIFEST.sha256 rename to docs/history/packages/web-superpowers-package/MANIFEST.sha256 diff --git a/docs/web-superpowers-package/README.md b/docs/history/packages/web-superpowers-package/README.md similarity index 78% rename from docs/web-superpowers-package/README.md rename to docs/history/packages/web-superpowers-package/README.md index 46fbdb8d..3063c885 100644 --- a/docs/web-superpowers-package/README.md +++ b/docs/history/packages/web-superpowers-package/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-28 +- 요약: 웹 inbound HTTP 설계 패키지 묶음의 안내다. 안의 MANIFEST.sha256는 머리 블록을 달기 전 납품 바이트의 해시다. +- 현재 정본: `docs/web/http-contract.md` + + # Web Superpowers Package Spring Boot 기반 **인바운드 HTTP API 실행 플랫폼 `web`**의 설계, Stable 구현 계획, Advanced 확장 계획, 원본 심층 리서치, 정적 검증 도구를 묶은 패키지입니다. diff --git a/docs/web-superpowers-package/VALIDATION.md b/docs/history/packages/web-superpowers-package/VALIDATION.md similarity index 91% rename from docs/web-superpowers-package/VALIDATION.md rename to docs/history/packages/web-superpowers-package/VALIDATION.md index 27a0f631..dcf2dc40 100644 --- a/docs/web-superpowers-package/VALIDATION.md +++ b/docs/history/packages/web-superpowers-package/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-28 +- 요약: 웹 inbound HTTP 설계 패키지 묶음을 받을 때 한 정적 검증 결과다. +- 현재 정본: `docs/web/http-contract.md` + + # Web Superpowers 문서 정적 검증 결과 검증 기준일: 2026-08-13 diff --git a/docs/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-advanced-capabilities-expansion-plan.md b/docs/history/packages/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-advanced-capabilities-expansion-plan.md similarity index 99% rename from docs/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-advanced-capabilities-expansion-plan.md rename to docs/history/packages/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-advanced-capabilities-expansion-plan.md index ee777f6a..a9f6dc6d 100644 --- a/docs/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-advanced-capabilities-expansion-plan.md +++ b/docs/history/packages/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-advanced-capabilities-expansion-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: 웹 inbound HTTP 실행 계획의 납품 원본이다. +- 현재 정본: `docs/web/http-contract.md` + + # 인바운드 HTTP API 실행 플랫폼 `web` Advanced Capability 확장 계획서 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-inbound-http-api-execution-platform-implementation-plan.md b/docs/history/packages/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-inbound-http-api-execution-platform-implementation-plan.md similarity index 99% rename from docs/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-inbound-http-api-execution-platform-implementation-plan.md rename to docs/history/packages/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-inbound-http-api-execution-platform-implementation-plan.md index 9e19b680..c0e9dfb8 100644 --- a/docs/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-inbound-http-api-execution-platform-implementation-plan.md +++ b/docs/history/packages/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-inbound-http-api-execution-platform-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: 웹 inbound HTTP 실행 계획의 납품 원본이다. +- 현재 정본: `docs/web/http-contract.md` + + # 인바운드 HTTP API 실행 플랫폼 `web` 구현 계획서 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/web-superpowers-package/docs/superpowers/specs/2026-08-13-web-inbound-http-api-execution-platform-design.md b/docs/history/packages/web-superpowers-package/docs/superpowers/specs/2026-08-13-web-inbound-http-api-execution-platform-design.md similarity index 98% rename from docs/web-superpowers-package/docs/superpowers/specs/2026-08-13-web-inbound-http-api-execution-platform-design.md rename to docs/history/packages/web-superpowers-package/docs/superpowers/specs/2026-08-13-web-inbound-http-api-execution-platform-design.md index 9a1dce60..e67d614f 100644 --- a/docs/web-superpowers-package/docs/superpowers/specs/2026-08-13-web-inbound-http-api-execution-platform-design.md +++ b/docs/history/packages/web-superpowers-package/docs/superpowers/specs/2026-08-13-web-inbound-http-api-execution-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-13 +- 요약: 웹 inbound HTTP 설계서의 납품 원본이다. +- 현재 정본: `docs/web/http-contract.md` + + # 인바운드 HTTP API 실행 플랫폼 `web` 설계서 > 기준일: 2026-08-13 diff --git a/docs/web-superpowers-package/research/source-web-deep-research.md b/docs/history/packages/web-superpowers-package/research/source-web-deep-research.md similarity index 99% rename from docs/web-superpowers-package/research/source-web-deep-research.md rename to docs/history/packages/web-superpowers-package/research/source-web-deep-research.md index a270ca2b..fe16866a 100644 --- a/docs/web-superpowers-package/research/source-web-deep-research.md +++ b/docs/history/packages/web-superpowers-package/research/source-web-deep-research.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-28 +- 요약: 웹 inbound HTTP 설계의 입력이 된 심층 조사 원문이다. +- 현재 정본: `docs/web/http-contract.md` + + # 인바운드 HTTP API 실행 플랫폼 `web` 심층 리서치 본 조사에서 `web`은 Spring MVC 설정 묶음이나 공통 `ControllerAdvice`가 아니라, **HTTP 요청이 신뢰 경계를 통과해 Application Use Case에 진입하고, 그 실행 결과가 HTTP 의미론으로 다시 외부에 노출되는 전 과정을 통제하는 플랫폼**으로 정의하는 것이 적절합니다. diff --git a/docs/web-superpowers-package/validate_web_docs.py b/docs/history/packages/web-superpowers-package/validate_web_docs.py similarity index 100% rename from docs/web-superpowers-package/validate_web_docs.py rename to docs/history/packages/web-superpowers-package/validate_web_docs.py diff --git a/docs/websocket-superpowers-package/MANIFEST.sha256 b/docs/history/packages/websocket-superpowers-package/MANIFEST.sha256 similarity index 100% rename from docs/websocket-superpowers-package/MANIFEST.sha256 rename to docs/history/packages/websocket-superpowers-package/MANIFEST.sha256 diff --git a/docs/websocket-superpowers-package/README.md b/docs/history/packages/websocket-superpowers-package/README.md similarity index 65% rename from docs/websocket-superpowers-package/README.md rename to docs/history/packages/websocket-superpowers-package/README.md index 3cc4a682..86e828c7 100644 --- a/docs/websocket-superpowers-package/README.md +++ b/docs/history/packages/websocket-superpowers-package/README.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-28 +- 요약: WebSocket 설계 패키지 묶음의 안내다. 안의 MANIFEST.sha256는 머리 블록을 달기 전 납품 바이트의 해시다. +- 현재 정본: `src/adapter/inbound/websocket/README.md` + + # WebSocket Superpowers Package 이 패키지는 WebSocket 실시간 양방향 연결 실행 플랫폼의 설계서, Stable 구현 계획, Advanced 확장 계획, 요구사항 원본과 정적 검증 도구를 포함한다. diff --git a/docs/websocket-superpowers-package/VALIDATION.md b/docs/history/packages/websocket-superpowers-package/VALIDATION.md similarity index 78% rename from docs/websocket-superpowers-package/VALIDATION.md rename to docs/history/packages/websocket-superpowers-package/VALIDATION.md index b1980389..dafaaf07 100644 --- a/docs/websocket-superpowers-package/VALIDATION.md +++ b/docs/history/packages/websocket-superpowers-package/VALIDATION.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-28 +- 요약: WebSocket 설계 패키지 묶음을 받을 때 한 정적 검증 결과다. +- 현재 정본: `src/adapter/inbound/websocket/README.md` + + # WebSocket Superpowers 문서 정적 검증 결과 - **검증일:** 2026-08-14 diff --git a/docs/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-advanced-capabilities-expansion-plan.md b/docs/history/packages/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-advanced-capabilities-expansion-plan.md similarity index 99% rename from docs/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-advanced-capabilities-expansion-plan.md rename to docs/history/packages/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-advanced-capabilities-expansion-plan.md index 2680dd4a..a30e1e74 100644 --- a/docs/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-advanced-capabilities-expansion-plan.md +++ b/docs/history/packages/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-advanced-capabilities-expansion-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-14 +- 요약: WebSocket 실행 계획의 납품 원본이다. +- 현재 정본: `src/adapter/inbound/websocket/README.md` + + # WebSocket Advanced Capability Expansion Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-realtime-connection-platform-implementation-plan.md b/docs/history/packages/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-realtime-connection-platform-implementation-plan.md similarity index 99% rename from docs/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-realtime-connection-platform-implementation-plan.md rename to docs/history/packages/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-realtime-connection-platform-implementation-plan.md index 6ee91e05..51d0fa4b 100644 --- a/docs/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-realtime-connection-platform-implementation-plan.md +++ b/docs/history/packages/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-realtime-connection-platform-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-14 +- 요약: WebSocket 실행 계획의 납품 원본이다. +- 현재 정본: `src/adapter/inbound/websocket/README.md` + + # WebSocket 실시간 양방향 연결 실행 플랫폼 Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/websocket-superpowers-package/docs/superpowers/specs/2026-08-14-websocket-realtime-connection-platform-design.md b/docs/history/packages/websocket-superpowers-package/docs/superpowers/specs/2026-08-14-websocket-realtime-connection-platform-design.md similarity index 99% rename from docs/websocket-superpowers-package/docs/superpowers/specs/2026-08-14-websocket-realtime-connection-platform-design.md rename to docs/history/packages/websocket-superpowers-package/docs/superpowers/specs/2026-08-14-websocket-realtime-connection-platform-design.md index 09edbef4..6c9115f8 100644 --- a/docs/websocket-superpowers-package/docs/superpowers/specs/2026-08-14-websocket-realtime-connection-platform-design.md +++ b/docs/history/packages/websocket-superpowers-package/docs/superpowers/specs/2026-08-14-websocket-realtime-connection-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-14 +- 요약: WebSocket 설계서의 납품 원본이다. +- 현재 정본: `src/adapter/inbound/websocket/README.md` + + # WebSocket 실시간 양방향 연결 실행 플랫폼 설계서 - **문서 상태:** 구현 기준선 확정 diff --git a/docs/websocket-superpowers-package/research/source-websocket-deep-research.md b/docs/history/packages/websocket-superpowers-package/research/source-websocket-deep-research.md similarity index 99% rename from docs/websocket-superpowers-package/research/source-websocket-deep-research.md rename to docs/history/packages/websocket-superpowers-package/research/source-websocket-deep-research.md index 5be010bd..d60eb5d1 100644 --- a/docs/websocket-superpowers-package/research/source-websocket-deep-research.md +++ b/docs/history/packages/websocket-superpowers-package/research/source-websocket-deep-research.md @@ -1,3 +1,12 @@ + +> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-28 +- 요약: WebSocket 설계의 입력이 된 심층 조사 원문이다. +- 현재 정본: `src/adapter/inbound/websocket/README.md` + + # WebSocket 실시간 양방향 연결 실행 플랫폼 심층 리서치 ## 결론과 기술 기준선 diff --git a/docs/websocket-superpowers-package/validate_websocket_docs.py b/docs/history/packages/websocket-superpowers-package/validate_websocket_docs.py similarity index 100% rename from docs/websocket-superpowers-package/validate_websocket_docs.py rename to docs/history/packages/websocket-superpowers-package/validate_websocket_docs.py diff --git a/docs/superpowers/plans/2026-07-20-harness-policy-engine.md b/docs/history/plans/2026-07-20-harness-policy-engine.md similarity index 91% rename from docs/superpowers/plans/2026-07-20-harness-policy-engine.md rename to docs/history/plans/2026-07-20-harness-policy-engine.md index 40535a51..7352cf64 100644 --- a/docs/superpowers/plans/2026-07-20-harness-policy-engine.md +++ b/docs/history/plans/2026-07-20-harness-policy-engine.md @@ -1,3 +1,13 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 대체됨 +- 작성일: 2026-07-20 +- 요약: 하네스 규칙을 레지스트리 기반 정책 엔진으로 바꾸려던 실행 계획이다. +- 현재 정본: `src/config/architecture/modules.json` +- 대체됨: `docs/history/plans/2026-07-25-harness-free-mode-b-amendment.md` + + > **SUPERSEDED — HISTORICAL PROVENANCE ONLY (2026-07-25):** The user-approved harness-free > Mode B amendment supersedes this plan. Retain the body as historical provenance; it is not > executable instruction. diff --git a/docs/superpowers/plans/2026-07-25-application-outbox-failure-reporting-harness-free.md b/docs/history/plans/2026-07-25-application-outbox-failure-reporting-harness-free.md similarity index 93% rename from docs/superpowers/plans/2026-07-25-application-outbox-failure-reporting-harness-free.md rename to docs/history/plans/2026-07-25-application-outbox-failure-reporting-harness-free.md index 91d1f8f0..5977f41a 100644 --- a/docs/superpowers/plans/2026-07-25-application-outbox-failure-reporting-harness-free.md +++ b/docs/history/plans/2026-07-25-application-outbox-failure-reporting-harness-free.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-25 +- 요약: 하네스 없이 application-core의 outbox 실패 보고를 프레임워크 없이 만드는 실행 계획이다. +- 현재 정본: `src/composition/outbox-relay/README.md` + + # Application Outbox Failure Reporting Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development diff --git a/docs/superpowers/plans/2026-07-25-application-outbox-failure-reporting.md b/docs/history/plans/2026-07-25-application-outbox-failure-reporting.md similarity index 99% rename from docs/superpowers/plans/2026-07-25-application-outbox-failure-reporting.md rename to docs/history/plans/2026-07-25-application-outbox-failure-reporting.md index a985e2e0..9417cd11 100644 --- a/docs/superpowers/plans/2026-07-25-application-outbox-failure-reporting.md +++ b/docs/history/plans/2026-07-25-application-outbox-failure-reporting.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-25 +- 요약: application-core에서 Spring·로깅 결합을 걷어내고 outbox 실패를 보고하는 실행 계획이다. +- 현재 정본: `src/composition/outbox-relay/README.md` + + # Application Outbox Failure Reporting Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-07-25-ci-control-plane-recovery.md b/docs/history/plans/2026-07-25-ci-control-plane-recovery.md similarity index 99% rename from docs/superpowers/plans/2026-07-25-ci-control-plane-recovery.md rename to docs/history/plans/2026-07-25-ci-control-plane-recovery.md index 9ba0c491..66fc2666 100644 --- a/docs/superpowers/plans/2026-07-25-ci-control-plane-recovery.md +++ b/docs/history/plans/2026-07-25-ci-control-plane-recovery.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-25 +- 요약: CI 제어면을 되살려 Gradle·Docker 빌드를 맞추는 실행 계획이다. +- 현재 정본: `docs/work/reference/gates.md` + + # CI Control Plane Recovery Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-07-25-harness-free-mode-b-amendment.md b/docs/history/plans/2026-07-25-harness-free-mode-b-amendment.md similarity index 89% rename from docs/superpowers/plans/2026-07-25-harness-free-mode-b-amendment.md rename to docs/history/plans/2026-07-25-harness-free-mode-b-amendment.md index b4da4907..252dbc9b 100644 --- a/docs/superpowers/plans/2026-07-25-harness-free-mode-b-amendment.md +++ b/docs/history/plans/2026-07-25-harness-free-mode-b-amendment.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-25 +- 요약: 하네스 없이 Gradle 부트스트랩과 의존 방향 검사를 되살리는 실행 계획이다. +- 현재 정본: `src/config/architecture/modules.json` + + # Harness-Free Mode B Amendment Implementation Plan > **For agentic workers:** Execute this plan task-by-task with diff --git a/docs/superpowers/plans/2026-07-25-harness-free-quality-security-ci.md b/docs/history/plans/2026-07-25-harness-free-quality-security-ci.md similarity index 92% rename from docs/superpowers/plans/2026-07-25-harness-free-quality-security-ci.md rename to docs/history/plans/2026-07-25-harness-free-quality-security-ci.md index eb6d6c70..221815ee 100644 --- a/docs/superpowers/plans/2026-07-25-harness-free-quality-security-ci.md +++ b/docs/history/plans/2026-07-25-harness-free-quality-security-ci.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-25 +- 요약: 하네스 없는 품질·의존성 보안 CI를 다시 세우는 실행 계획이다. +- 현재 정본: `docs/work/reference/gates.md` + + # Harness-Free Quality and Security CI Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:executing-plans` to implement this diff --git a/docs/superpowers/plans/2026-07-25-module-gradle-hygiene-harness-free.md b/docs/history/plans/2026-07-25-module-gradle-hygiene-harness-free.md similarity index 92% rename from docs/superpowers/plans/2026-07-25-module-gradle-hygiene-harness-free.md rename to docs/history/plans/2026-07-25-module-gradle-hygiene-harness-free.md index 411ac783..d7056358 100644 --- a/docs/superpowers/plans/2026-07-25-module-gradle-hygiene-harness-free.md +++ b/docs/history/plans/2026-07-25-module-gradle-hygiene-harness-free.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-25 +- 요약: 하네스 없이 leaf 의존·경계 정리를 적용하는 실행 계획이다. +- 현재 정본: `src/config/architecture/modules.json` + + # Harness-Free Module and Gradle Hygiene Implementation Plan **Goal:** Apply the approved 19-leaf dependency and boundary cleanup without `.harness`. diff --git a/docs/superpowers/plans/2026-07-25-module-gradle-hygiene.md b/docs/history/plans/2026-07-25-module-gradle-hygiene.md similarity index 99% rename from docs/superpowers/plans/2026-07-25-module-gradle-hygiene.md rename to docs/history/plans/2026-07-25-module-gradle-hygiene.md index a95af829..806cc850 100644 --- a/docs/superpowers/plans/2026-07-25-module-gradle-hygiene.md +++ b/docs/history/plans/2026-07-25-module-gradle-hygiene.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-25 +- 요약: leaf Gradle 그래프를 최소로 줄이는 리팩터링 실행 계획이다. +- 현재 정본: `src/config/architecture/modules.json` + + # Module and Gradle Hygiene Refactoring Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-07-28-fileserver-durable-recovery.md b/docs/history/plans/2026-07-28-fileserver-durable-recovery.md similarity index 88% rename from docs/superpowers/plans/2026-07-28-fileserver-durable-recovery.md rename to docs/history/plans/2026-07-28-fileserver-durable-recovery.md index 5b1ed10d..acc73a4d 100644 --- a/docs/superpowers/plans/2026-07-28-fileserver-durable-recovery.md +++ b/docs/history/plans/2026-07-28-fileserver-durable-recovery.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-07-28 +- 요약: 파일 서버 로컬 publication provider가 재시작에도 완료·봉인 상태를 지키게 하는 실행 계획이다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver Durable Recovery Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this diff --git a/docs/superpowers/plans/2026-07-28-fileserver-production-capability-foundation.md b/docs/history/plans/2026-07-28-fileserver-production-capability-foundation.md similarity index 95% rename from docs/superpowers/plans/2026-07-28-fileserver-production-capability-foundation.md rename to docs/history/plans/2026-07-28-fileserver-production-capability-foundation.md index 6750df8d..72110157 100644 --- a/docs/superpowers/plans/2026-07-28-fileserver-production-capability-foundation.md +++ b/docs/history/plans/2026-07-28-fileserver-production-capability-foundation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-28 +- 요약: 파일 서버 CSV 예제를 프레임워크 없는 publication 계약과 단계형 로컬 provider로 바꾸는 실행 계획이다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver Production Capability Foundation Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-07-28-fileserver-r2-control-plane-provider-selection.md b/docs/history/plans/2026-07-28-fileserver-r2-control-plane-provider-selection.md similarity index 98% rename from docs/superpowers/plans/2026-07-28-fileserver-r2-control-plane-provider-selection.md rename to docs/history/plans/2026-07-28-fileserver-r2-control-plane-provider-selection.md index 801794c9..945e425a 100644 --- a/docs/superpowers/plans/2026-07-28-fileserver-r2-control-plane-provider-selection.md +++ b/docs/history/plans/2026-07-28-fileserver-r2-control-plane-provider-selection.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-07-28 +- 요약: 파일 서버 R2 제어면과 provider 선택을 넣는 실행 계획이다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver R2 Control Plane and Provider Selection Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use diff --git a/docs/superpowers/plans/2026-07-28-httpclient-canonical-zero-binding.md b/docs/history/plans/2026-07-28-httpclient-canonical-zero-binding.md similarity index 93% rename from docs/superpowers/plans/2026-07-28-httpclient-canonical-zero-binding.md rename to docs/history/plans/2026-07-28-httpclient-canonical-zero-binding.md index 8b129d76..5f90a26d 100644 --- a/docs/superpowers/plans/2026-07-28-httpclient-canonical-zero-binding.md +++ b/docs/history/plans/2026-07-28-httpclient-canonical-zero-binding.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-07-28 +- 요약: HTTP client 활성화를 명시적인 조립 결정으로 만드는 실행 계획이다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + # HTTP Client Canonical Zero-Binding Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use diff --git a/docs/superpowers/plans/2026-07-28-httpclient-production-capability-foundation.md b/docs/history/plans/2026-07-28-httpclient-production-capability-foundation.md similarity index 91% rename from docs/superpowers/plans/2026-07-28-httpclient-production-capability-foundation.md rename to docs/history/plans/2026-07-28-httpclient-production-capability-foundation.md index 18cd7483..5d61060a 100644 --- a/docs/superpowers/plans/2026-07-28-httpclient-production-capability-foundation.md +++ b/docs/history/plans/2026-07-28-httpclient-production-capability-foundation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-07-28 +- 요약: HTTP client의 호출 예산과 typed operation·target 기반을 세우는 실행 계획이다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + # HTTP Client Production Capability Foundation Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development diff --git a/docs/superpowers/plans/2026-07-28-httpclient-total-deadline.md b/docs/history/plans/2026-07-28-httpclient-total-deadline.md similarity index 87% rename from docs/superpowers/plans/2026-07-28-httpclient-total-deadline.md rename to docs/history/plans/2026-07-28-httpclient-total-deadline.md index 40e0d080..2f88342c 100644 --- a/docs/superpowers/plans/2026-07-28-httpclient-total-deadline.md +++ b/docs/history/plans/2026-07-28-httpclient-total-deadline.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-07-28 +- 요약: HTTP 논리 호출 전체(재시도 대기 포함)에 호출 예산을 강제하는 실행 계획이다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + # HTTP Client Total Deadline Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this diff --git a/docs/superpowers/plans/2026-07-28-jpa-production-capability.md b/docs/history/plans/2026-07-28-jpa-production-capability.md similarity index 97% rename from docs/superpowers/plans/2026-07-28-jpa-production-capability.md rename to docs/history/plans/2026-07-28-jpa-production-capability.md index b3024afd..16e890b5 100644 --- a/docs/superpowers/plans/2026-07-28-jpa-production-capability.md +++ b/docs/history/plans/2026-07-28-jpa-production-capability.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-28 +- 요약: JPA·PostgreSQL을 운영 capability로 올리는 실행 계획이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA/PostgreSQL Production Capability Implementation Plan > 상태: Phase 0~3 기반과 Phase 4의 idempotency/outbox polling/inbox 후보 구현 및 전체 diff --git a/docs/superpowers/plans/2026-07-28-messaging-first-r2-polling-producer.md b/docs/history/plans/2026-07-28-messaging-first-r2-polling-producer.md similarity index 99% rename from docs/superpowers/plans/2026-07-28-messaging-first-r2-polling-producer.md rename to docs/history/plans/2026-07-28-messaging-first-r2-polling-producer.md index a28aa914..3516ae5a 100644 --- a/docs/superpowers/plans/2026-07-28-messaging-first-r2-polling-producer.md +++ b/docs/history/plans/2026-07-28-messaging-first-r2-polling-producer.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-28 +- 요약: typed 통합 이벤트에서 시작하는 첫 운영 기준 메시징 경로(R2 polling producer)를 만드는 실행 계획이다. +- 현재 정본: `docs/messaging/support-matrix.md` + + # Messaging First R2 Polling Producer Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use @@ -26,7 +35,7 @@ Testcontainers Kafka/PostgreSQL, Micrometer. - 작성일: 2026-07-28 - 상태: 실행 계획 작성·독립 검토 완료, 모든 task 미착수 - 설계 정본: - [Messaging Production Capability Deep Design](../specs/2026-07-28-messaging-production-capability-design.md) + [Messaging Production Capability Deep Design](../../design/2026-07-28-messaging-production-capability-design.md) - 구현 범위: P0–P4의 first R2 polling producer tuple - 명시적 비범위: inbound Kafka consumer, inbox, retry topic, DLT/replay, Kafka EOS, Debezium/Kafka Connect CDC, Avro/Protobuf/schema registry, alternate broker, multi-cluster diff --git a/docs/superpowers/plans/2026-07-28-notification-production-capability.md b/docs/history/plans/2026-07-28-notification-production-capability.md similarity index 99% rename from docs/superpowers/plans/2026-07-28-notification-production-capability.md rename to docs/history/plans/2026-07-28-notification-production-capability.md index 3266922d..0eaac617 100644 --- a/docs/superpowers/plans/2026-07-28-notification-production-capability.md +++ b/docs/history/plans/2026-07-28-notification-production-capability.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-28 +- 요약: 알림을 운영 capability로 올리는 실행 계획이다. +- 현재 정본: `docs/notification/support-matrix.md` + + # Notification Production Capability Implementation Plan > **Execution workflow:** 구현 시 `superpowers:subagent-driven-development`, @@ -15,7 +24,7 @@ provider/runtime 범위는 미착수다. 아래 isolated-worktree 검증 기록과 main 통합 검증 결과는 서로 다른 증거로 구분한다. - 설계 정본: - [Notification Production Capability Deep Design](../specs/2026-07-28-notification-production-capability-design.md) + [Notification Production Capability Deep Design](../../design/2026-07-28-notification-production-capability-design.md) - 비교한 실행 계획: [Redis Foundation](2026-07-28-redis-production-capability-foundation.md), [Redis Runtime](2026-07-28-redis-runtime-cache.md), diff --git a/docs/superpowers/plans/2026-07-28-objectstorage-production-capability.md b/docs/history/plans/2026-07-28-objectstorage-production-capability.md similarity index 99% rename from docs/superpowers/plans/2026-07-28-objectstorage-production-capability.md rename to docs/history/plans/2026-07-28-objectstorage-production-capability.md index f6b61b94..d1011294 100644 --- a/docs/superpowers/plans/2026-07-28-objectstorage-production-capability.md +++ b/docs/history/plans/2026-07-28-objectstorage-production-capability.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-28 +- 요약: 호출자 키·byte[] 예제를 프레임워크 없는 object storage 계약으로 바꾸는 실행 계획이다. +- 현재 정본: `src/adapter/outbound/objectstorage/README.md` + + # Object Storage Production Capability Implementation Plan - 작성일: 2026-07-28 @@ -32,7 +41,7 @@ multi-module verification, JUnit 5, AssertJ, jqwik `1.9.1`, AWS SDK for Java v2 Toxiproxy, PostgreSQL/Flyway for the sample workflow, Micrometer/Actuator. **Authoritative design:** -[Object Storage Production Capability Deep Design](../specs/2026-07-28-objectstorage-production-capability-design.md). +[Object Storage Production Capability Deep Design](../../design/2026-07-28-objectstorage-production-capability-design.md). When this plan and that design differ, stop and amend the design before implementing. Module edges remain governed only by `src/config/architecture/modules.json`. @@ -51,13 +60,13 @@ single upload/download cards remain R1; every direct, multipart, quarantine, ret production reconciliation card remains R0. The exhaustive R2 fault/race matrices named by unchecked steps remain follow-up evidence, not implied completion. The legacy provider and Poster consumer remain isolated behind explicit sample-local/test activation. Evidence: -[Batch A](../../evidence/object-storage/batch-a-checkpoint.md), -[Batch B](../../evidence/object-storage/batch-b-checkpoint.md), and -[Batch C](../../evidence/object-storage/batch-c-progress.md), -[Batch D](../../evidence/object-storage/batch-d-checkpoint.md). +[Batch A](../evidence/object-storage/batch-a-checkpoint.md), +[Batch B](../evidence/object-storage/batch-b-checkpoint.md), and +[Batch C](../evidence/object-storage/batch-c-progress.md), +[Batch D](../evidence/object-storage/batch-d-checkpoint.md). Batch E의 개별 focused fix 증거는 -[Batch E pause checkpoint](../../evidence/object-storage/batch-e-pause-checkpoint.md)에 기록됐다. +[Batch E pause checkpoint](../evidence/object-storage/batch-e-pause-checkpoint.md)에 기록됐다. 당시 Batch E combined/root gate는 재실행되지 않았으므로 Batch E 전체 완료나 R2를 주장하지 않는다. 격리 브랜치에서 잘못 선택했던 private vault 경로 대신, main 통합 작업은 사용자가 캡처했다. diff --git a/docs/superpowers/plans/2026-07-28-redis-cache-resilience.md b/docs/history/plans/2026-07-28-redis-cache-resilience.md similarity index 82% rename from docs/superpowers/plans/2026-07-28-redis-cache-resilience.md rename to docs/history/plans/2026-07-28-redis-cache-resilience.md index fd4974fe..8e187285 100644 --- a/docs/superpowers/plans/2026-07-28-redis-cache-resilience.md +++ b/docs/history/plans/2026-07-28-redis-cache-resilience.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-28 +- 요약: Redis 캐시 회복력(cache-aside, 원본 보호, TTL) 설계를 구현하는 실행 계획이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Cache Resilience Implementation Plan > Repository commit policy is human-only. Do not stage, commit, amend or push. diff --git a/docs/superpowers/plans/2026-07-28-redis-distributed-rate-limit.md b/docs/history/plans/2026-07-28-redis-distributed-rate-limit.md similarity index 83% rename from docs/superpowers/plans/2026-07-28-redis-distributed-rate-limit.md rename to docs/history/plans/2026-07-28-redis-distributed-rate-limit.md index ddb47b89..87a0e9f9 100644 --- a/docs/superpowers/plans/2026-07-28-redis-distributed-rate-limit.md +++ b/docs/history/plans/2026-07-28-redis-distributed-rate-limit.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-28 +- 요약: Redis 분산 rate-limit 알고리즘을 구현하는 실행 계획이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Distributed Rate-Limit Implementation Plan > Repository commit policy is human-only. Do not stage, commit, amend or push. diff --git a/docs/superpowers/plans/2026-07-28-redis-production-capability-foundation.md b/docs/history/plans/2026-07-28-redis-production-capability-foundation.md similarity index 92% rename from docs/superpowers/plans/2026-07-28-redis-production-capability-foundation.md rename to docs/history/plans/2026-07-28-redis-production-capability-foundation.md index 03cef9c0..93352bc8 100644 --- a/docs/superpowers/plans/2026-07-28-redis-production-capability-foundation.md +++ b/docs/history/plans/2026-07-28-redis-production-capability-foundation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-07-28 +- 요약: Redis 캐시 이음매를 프레임워크 없는 의미 캐시 계약으로 바꾸는 실행 계획이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Production Capability Foundation Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development diff --git a/docs/superpowers/plans/2026-07-28-redis-runtime-cache.md b/docs/history/plans/2026-07-28-redis-runtime-cache.md similarity index 89% rename from docs/superpowers/plans/2026-07-28-redis-runtime-cache.md rename to docs/history/plans/2026-07-28-redis-runtime-cache.md index ef4b8943..4c5b2ac1 100644 --- a/docs/superpowers/plans/2026-07-28-redis-runtime-cache.md +++ b/docs/history/plans/2026-07-28-redis-runtime-cache.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-07-28 +- 요약: opt-in Lettuce 런타임과 Lua 기반 의미 캐시를 넣는 실행 계획이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Runtime And Semantic Cache Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this diff --git a/docs/superpowers/plans/2026-07-29-redis-production-capability-completion.md b/docs/history/plans/2026-07-29-redis-production-capability-completion.md similarity index 98% rename from docs/superpowers/plans/2026-07-29-redis-production-capability-completion.md rename to docs/history/plans/2026-07-29-redis-production-capability-completion.md index 480d9344..9a3250d0 100644 --- a/docs/superpowers/plans/2026-07-29-redis-production-capability-completion.md +++ b/docs/history/plans/2026-07-29-redis-production-capability-completion.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-29 +- 요약: Redis 운영 capability 설계의 1~5단계를 capability별로 마무리하는 계획이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Production Capability Completion Plan > **Scope:** Redis를 먼저 완료한다. 현재 실행 단위는 deep design Phase 5 전체가 아니라 diff --git a/docs/superpowers/plans/2026-07-30-redis-lab-strict-kubeconfig-renderer.md b/docs/history/plans/2026-07-30-redis-lab-strict-kubeconfig-renderer.md similarity index 95% rename from docs/superpowers/plans/2026-07-30-redis-lab-strict-kubeconfig-renderer.md rename to docs/history/plans/2026-07-30-redis-lab-strict-kubeconfig-renderer.md index 1021b1a6..76a47efa 100644 --- a/docs/superpowers/plans/2026-07-30-redis-lab-strict-kubeconfig-renderer.md +++ b/docs/history/plans/2026-07-30-redis-lab-strict-kubeconfig-renderer.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-07-30 +- 요약: Redis 실험 환경의 kubeconfig를 엄격한 렌더러로 만드는 실행 계획이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Lab Strict Kubeconfig Renderer Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use diff --git a/docs/superpowers/plans/2026-08-01-release-hygiene-refactoring.md b/docs/history/plans/2026-08-01-release-hygiene-refactoring.md similarity index 98% rename from docs/superpowers/plans/2026-08-01-release-hygiene-refactoring.md rename to docs/history/plans/2026-08-01-release-hygiene-refactoring.md index c15722da..4878e2a7 100644 --- a/docs/superpowers/plans/2026-08-01-release-hygiene-refactoring.md +++ b/docs/history/plans/2026-08-01-release-hygiene-refactoring.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-01 +- 요약: 릴리스 위생 경로를 사실대로 맞추는 리팩터링 실행 계획이다. +- 현재 정본: `docs/work/reference/gates.md` + + # Release Hygiene Refactoring Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-02-client-safe-error-boundary.md b/docs/history/plans/2026-08-02-client-safe-error-boundary.md similarity index 90% rename from docs/superpowers/plans/2026-08-02-client-safe-error-boundary.md rename to docs/history/plans/2026-08-02-client-safe-error-boundary.md index d1c02c5b..16b63143 100644 --- a/docs/superpowers/plans/2026-08-02-client-safe-error-boundary.md +++ b/docs/history/plans/2026-08-02-client-safe-error-boundary.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-08-02 +- 요약: 공개 HTTP 오류 응답에 허용 문구만 담게 하는 실행 계획이다. +- 현재 정본: `docs/web/http-contract.md` + + # Client-Safe Error Boundary Implementation Plan > **Execution:** Follow `superpowers:test-driven-development`; request an independent code review diff --git a/docs/superpowers/plans/2026-08-02-conditional-inbound-transport-boundary.md b/docs/history/plans/2026-08-02-conditional-inbound-transport-boundary.md similarity index 90% rename from docs/superpowers/plans/2026-08-02-conditional-inbound-transport-boundary.md rename to docs/history/plans/2026-08-02-conditional-inbound-transport-boundary.md index 49f9f44a..a1749094 100644 --- a/docs/superpowers/plans/2026-08-02-conditional-inbound-transport-boundary.md +++ b/docs/history/plans/2026-08-02-conditional-inbound-transport-boundary.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: GraphQL·gRPC·WebSocket을 고를 때만 켜고 위험한 활성화를 막는 실행 계획이다. +- 현재 정본: `docs/web/http-contract.md` + + # Conditional Inbound Transport Boundary Implementation Plan > **Execution:** Apply TDD independently per transport, then run exact no-skip qualification and an diff --git a/docs/superpowers/plans/2026-08-02-p2-verification-governance-refactoring.md b/docs/history/plans/2026-08-02-p2-verification-governance-refactoring.md similarity index 97% rename from docs/superpowers/plans/2026-08-02-p2-verification-governance-refactoring.md rename to docs/history/plans/2026-08-02-p2-verification-governance-refactoring.md index 74fdd3cc..d0d32b58 100644 --- a/docs/superpowers/plans/2026-08-02-p2-verification-governance-refactoring.md +++ b/docs/history/plans/2026-08-02-p2-verification-governance-refactoring.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: 남은 fail-open 검증 경로를 없애는 리팩터링 계획이다. +- 현재 정본: `docs/work/reference/gates.md` + + # P2 Verification Governance Refactoring Plan ## Batch 1 — strict owner-local qualification diff --git a/docs/superpowers/plans/2026-08-02-redis-session-http-boundary.md b/docs/history/plans/2026-08-02-redis-session-http-boundary.md similarity index 89% rename from docs/superpowers/plans/2026-08-02-redis-session-http-boundary.md rename to docs/history/plans/2026-08-02-redis-session-http-boundary.md index b3e11cb2..1f81cffb 100644 --- a/docs/superpowers/plans/2026-08-02-redis-session-http-boundary.md +++ b/docs/history/plans/2026-08-02-redis-session-http-boundary.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-08-02 +- 요약: Redis 세션과 HTTP 경계의 보안을 실제 Spring Session으로 증명하는 실행 계획이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Session HTTP Boundary Implementation Plan > **Execution:** Follow test-driven development and request an independent read-only review before diff --git a/docs/superpowers/plans/2026-08-02-verification-purity-refactoring.md b/docs/history/plans/2026-08-02-verification-purity-refactoring.md similarity index 92% rename from docs/superpowers/plans/2026-08-02-verification-purity-refactoring.md rename to docs/history/plans/2026-08-02-verification-purity-refactoring.md index de4d0504..fec243af 100644 --- a/docs/superpowers/plans/2026-08-02-verification-purity-refactoring.md +++ b/docs/history/plans/2026-08-02-verification-purity-refactoring.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-08-02 +- 요약: 검증 경로를 읽기 전용으로 바꾸는 실행 계획이다. +- 현재 정본: `docs/work/reference/gates.md` + + # Verification Purity Refactoring Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-02-warning-zero-build-refactoring.md b/docs/history/plans/2026-08-02-warning-zero-build-refactoring.md similarity index 98% rename from docs/superpowers/plans/2026-08-02-warning-zero-build-refactoring.md rename to docs/history/plans/2026-08-02-warning-zero-build-refactoring.md index 62626953..3ec33f4c 100644 --- a/docs/superpowers/plans/2026-08-02-warning-zero-build-refactoring.md +++ b/docs/history/plans/2026-08-02-warning-zero-build-refactoring.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: 빌드 경고를 0으로 만드는 리팩터링 실행 계획이다. +- 현재 정본: `docs/work/reference/gates.md` + + # Warning-Zero Build Refactoring Implementation Plan > **For Codex:** REQUIRED SUB-SKILLS: use `superpowers:subagent-driven-development` for the diff --git a/docs/superpowers/plans/2026-08-02-web-security-boundary.md b/docs/history/plans/2026-08-02-web-security-boundary.md similarity index 87% rename from docs/superpowers/plans/2026-08-02-web-security-boundary.md rename to docs/history/plans/2026-08-02-web-security-boundary.md index 1b6f8a21..a8e4fa09 100644 --- a/docs/superpowers/plans/2026-08-02-web-security-boundary.md +++ b/docs/history/plans/2026-08-02-web-security-boundary.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-08-02 +- 요약: JWT·JWKS·CORS 필터 경계를 밀봉 테스트로 고정하는 실행 계획이다. +- 현재 정본: `docs/web/http-contract.md` + + # Web Security Boundary Implementation Plan > **Execution:** Follow test-driven development and request an independent read-only review before diff --git a/docs/superpowers/plans/2026-08-07-fileserver-platform-implementation-plan.md b/docs/history/plans/2026-08-07-fileserver-platform-implementation-plan.md similarity index 99% rename from docs/superpowers/plans/2026-08-07-fileserver-platform-implementation-plan.md rename to docs/history/plans/2026-08-07-fileserver-platform-implementation-plan.md index 93932a62..730de6aa 100644 --- a/docs/superpowers/plans/2026-08-07-fileserver-platform-implementation-plan.md +++ b/docs/history/plans/2026-08-07-fileserver-platform-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-07 +- 요약: 파일 서버 플랫폼(streaming 업로드, 상태 기반 게시, Range 다운로드, tus)을 만드는 실행 계획이다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver Platform Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-07-redis-wrapper-typed-api-implementation-plan.md b/docs/history/plans/2026-08-07-redis-wrapper-typed-api-implementation-plan.md similarity index 99% rename from docs/superpowers/plans/2026-08-07-redis-wrapper-typed-api-implementation-plan.md rename to docs/history/plans/2026-08-07-redis-wrapper-typed-api-implementation-plan.md index dfb103bd..f1389891 100644 --- a/docs/superpowers/plans/2026-08-07-redis-wrapper-typed-api-implementation-plan.md +++ b/docs/history/plans/2026-08-07-redis-wrapper-typed-api-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-07 +- 요약: Redis 자료구조 전체를 Typed API와 Raw Gateway로 제공하는 SDK 실행 계획이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Wrapper and Typed API Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-07-redis-wrapper-typed-api-status.md b/docs/history/plans/2026-08-07-redis-wrapper-typed-api-status.md similarity index 99% rename from docs/superpowers/plans/2026-08-07-redis-wrapper-typed-api-status.md rename to docs/history/plans/2026-08-07-redis-wrapper-typed-api-status.md index 28ac923e..ca1b5738 100644 --- a/docs/superpowers/plans/2026-08-07-redis-wrapper-typed-api-status.md +++ b/docs/history/plans/2026-08-07-redis-wrapper-typed-api-status.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-07 +- 요약: Redis Wrapper·Typed API를 이 저장소에 맞춘 방법과 납품 상태 기록이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Wrapper and Typed API — repository adaptation and delivery status - **Design:** `docs/superpowers/specs/2026-08-07-redis-wrapper-typed-api-design.md` diff --git a/docs/superpowers/plans/2026-08-08-httpclient-platform-implementation-plan.md b/docs/history/plans/2026-08-08-httpclient-platform-implementation-plan.md similarity index 99% rename from docs/superpowers/plans/2026-08-08-httpclient-platform-implementation-plan.md rename to docs/history/plans/2026-08-08-httpclient-platform-implementation-plan.md index d00adfa8..1345a332 100644 --- a/docs/superpowers/plans/2026-08-08-httpclient-platform-implementation-plan.md +++ b/docs/history/plans/2026-08-08-httpclient-platform-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-08 +- 요약: HTTP client 플랫폼(Typed Service Client, 재시도, OAuth2·TLS, SSRF 방어)을 만드는 실행 계획이다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + # HTTP Client Platform Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-10-httpclient-platform-activation-and-env-ssot.md b/docs/history/plans/2026-08-10-httpclient-platform-activation-and-env-ssot.md similarity index 99% rename from docs/superpowers/plans/2026-08-10-httpclient-platform-activation-and-env-ssot.md rename to docs/history/plans/2026-08-10-httpclient-platform-activation-and-env-ssot.md index e6172474..d5fd6336 100644 --- a/docs/superpowers/plans/2026-08-10-httpclient-platform-activation-and-env-ssot.md +++ b/docs/history/plans/2026-08-10-httpclient-platform-activation-and-env-ssot.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-10 +- 요약: HTTP client 플랫폼을 켤 때만 있는 capability로 만들고 env 정본을 정하는 실행 계획이다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + # HTTP Client Platform — Activation Boundary and ENV SSOT Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-10-messaging-platform-implementation-plan.md b/docs/history/plans/2026-08-10-messaging-platform-implementation-plan.md similarity index 99% rename from docs/superpowers/plans/2026-08-10-messaging-platform-implementation-plan.md rename to docs/history/plans/2026-08-10-messaging-platform-implementation-plan.md index 56cd6f22..0ebc3715 100644 --- a/docs/superpowers/plans/2026-08-10-messaging-platform-implementation-plan.md +++ b/docs/history/plans/2026-08-10-messaging-platform-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-10 +- 요약: 메시징 플랫폼(증거 기반 발행, 중복 안전 소비, Kafka·RabbitMQ, outbox·inbox)을 만드는 실행 계획이다. +- 현재 정본: `docs/messaging/support-matrix.md` + + # Messaging Platform Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-10-notification-platform-implementation-plan.md b/docs/history/plans/2026-08-10-notification-platform-implementation-plan.md similarity index 99% rename from docs/superpowers/plans/2026-08-10-notification-platform-implementation-plan.md rename to docs/history/plans/2026-08-10-notification-platform-implementation-plan.md index d79ae00a..07c44362 100644 --- a/docs/superpowers/plans/2026-08-10-notification-platform-implementation-plan.md +++ b/docs/history/plans/2026-08-10-notification-platform-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-10 +- 요약: 알림 전달 플랫폼(수명주기, provider 결과, 예약, callback 원장, 채널 어댑터)을 만드는 실행 계획이다. +- 현재 정본: `docs/notification/support-matrix.md` + + # Notification Delivery Platform Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-10-redis-optionality-and-composition.md b/docs/history/plans/2026-08-10-redis-optionality-and-composition.md similarity index 97% rename from docs/superpowers/plans/2026-08-10-redis-optionality-and-composition.md rename to docs/history/plans/2026-08-10-redis-optionality-and-composition.md index 260eec6b..ccfdc7a1 100644 --- a/docs/superpowers/plans/2026-08-10-redis-optionality-and-composition.md +++ b/docs/history/plans/2026-08-10-redis-optionality-and-composition.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-10 +- 요약: Redis를 끄면 정말 아무것도 싣지 않게 하는 선택성·조립 실행 계획이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Optionality and Composition Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development diff --git a/docs/superpowers/plans/2026-08-11-jpa-persistence-experimental-expansion-plan.md b/docs/history/plans/2026-08-11-jpa-persistence-experimental-expansion-plan.md similarity index 98% rename from docs/superpowers/plans/2026-08-11-jpa-persistence-experimental-expansion-plan.md rename to docs/history/plans/2026-08-11-jpa-persistence-experimental-expansion-plan.md index bc9c1ae1..5e43c356 100644 --- a/docs/superpowers/plans/2026-08-11-jpa-persistence-experimental-expansion-plan.md +++ b/docs/history/plans/2026-08-11-jpa-persistence-experimental-expansion-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-11 +- 요약: Stable JPA 플랫폼을 건드리지 않고 multi-tenancy·RLS·read replica 등 실험 기능을 더하는 계획이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA Experimental Expansion Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-11-jpa-persistence-platform-implementation-plan.md b/docs/history/plans/2026-08-11-jpa-persistence-platform-implementation-plan.md similarity index 99% rename from docs/superpowers/plans/2026-08-11-jpa-persistence-platform-implementation-plan.md rename to docs/history/plans/2026-08-11-jpa-persistence-platform-implementation-plan.md index 43d000df..2816b2a6 100644 --- a/docs/superpowers/plans/2026-08-11-jpa-persistence-platform-implementation-plan.md +++ b/docs/history/plans/2026-08-11-jpa-persistence-platform-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-11 +- 요약: JPA 관계형 영속성 플랫폼을 만드는 실행 계획이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA 관계형 영속성 플랫폼 Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-11-mongodb-advanced-capabilities-expansion-plan.md b/docs/history/plans/2026-08-11-mongodb-advanced-capabilities-expansion-plan.md similarity index 99% rename from docs/superpowers/plans/2026-08-11-mongodb-advanced-capabilities-expansion-plan.md rename to docs/history/plans/2026-08-11-mongodb-advanced-capabilities-expansion-plan.md index 3990a179..0d731a20 100644 --- a/docs/superpowers/plans/2026-08-11-mongodb-advanced-capabilities-expansion-plan.md +++ b/docs/history/plans/2026-08-11-mongodb-advanced-capabilities-expansion-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-11 +- 요약: MongoDB 문서 영속성 플랫폼에 sharding·암호화·검색 등 고급 기능을 더하는 계획이다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + # MongoDB Advanced Capabilities Expansion Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-11-mongodb-document-persistence-platform-implementation-plan.md b/docs/history/plans/2026-08-11-mongodb-document-persistence-platform-implementation-plan.md similarity index 99% rename from docs/superpowers/plans/2026-08-11-mongodb-document-persistence-platform-implementation-plan.md rename to docs/history/plans/2026-08-11-mongodb-document-persistence-platform-implementation-plan.md index 76f6399b..711366a7 100644 --- a/docs/superpowers/plans/2026-08-11-mongodb-document-persistence-platform-implementation-plan.md +++ b/docs/history/plans/2026-08-11-mongodb-document-persistence-platform-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-11 +- 요약: MongoDB 문서 영속성 플랫폼을 만드는 실행 계획이다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + # MongoDB 문서 영속성 플랫폼 Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md b/docs/history/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md similarity index 99% rename from docs/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md rename to docs/history/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md index 904319ae..cd5b86e2 100644 --- a/docs/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md +++ b/docs/history/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-12 +- 요약: GraphQL 실행 플랫폼에 persisted operation·subscription·federation 등을 더하는 계획이다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # GraphQL Advanced Capability Expansion Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md b/docs/history/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md similarity index 99% rename from docs/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md rename to docs/history/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md index 2f5204e1..17ef84f0 100644 --- a/docs/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md +++ b/docs/history/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-12 +- 요약: GraphQL API 실행 플랫폼을 만드는 실행 계획이다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # GraphQL API 실행 플랫폼 Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-08-15-five-adapter-runtime-remediation-index.md b/docs/history/plans/2026-08-15-five-adapter-runtime-remediation-index.md similarity index 97% rename from docs/superpowers/plans/2026-08-15-five-adapter-runtime-remediation-index.md rename to docs/history/plans/2026-08-15-five-adapter-runtime-remediation-index.md index 35341719..36b98c51 100644 --- a/docs/superpowers/plans/2026-08-15-five-adapter-runtime-remediation-index.md +++ b/docs/history/plans/2026-08-15-five-adapter-runtime-remediation-index.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-15 +- 요약: 다섯 어댑터 런타임 개선 계획 묶음의 목차다. +- 현재 정본: `docs/capability-status.md` + + # Five-Adapter Runtime Remediation — Plan Index > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development @@ -25,7 +34,7 @@ dependency closure and fail closed at startup rather than at first request. JUnit 5 + AssertJ, ArchUnit 1.3.0, Testcontainers, Flyway, PostgreSQL 16–18, MongoDB, Kafka/RabbitMQ, Keycloak, MinIO, Docker Compose 5.4.0 (spec floor: 2.24.4). -**Spec:** [`docs/superpowers/specs/2026-08-15-five-adapter-runtime-remediation-review-design.md`](../specs/2026-08-15-five-adapter-runtime-remediation-review-design.md) +**Spec:** [`docs/superpowers/specs/2026-08-15-five-adapter-runtime-remediation-review-design.md`](../../design/2026-08-15-five-adapter-runtime-remediation-review-design.md) --- diff --git a/docs/superpowers/plans/2026-08-15-wave0-red-baseline.md b/docs/history/plans/2026-08-15-wave0-red-baseline.md similarity index 99% rename from docs/superpowers/plans/2026-08-15-wave0-red-baseline.md rename to docs/history/plans/2026-08-15-wave0-red-baseline.md index 3655e44c..6ad30ceb 100644 --- a/docs/superpowers/plans/2026-08-15-wave0-red-baseline.md +++ b/docs/history/plans/2026-08-15-wave0-red-baseline.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-15 +- 요약: 개선 설계가 지목한 실패를 먼저 실패하는 테스트로 고정하는 0단계 계획이다. +- 현재 정본: `docs/capability-status.md` + + # Wave 0 — Red Baseline and Evidence Pinning Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development @@ -22,7 +31,7 @@ report the exact remaining red set at any point during Waves 1–4. + `SpringApplication` process harness, Gradle 9 custom `Test` lanes, `docker compose config` as a subprocess. -**Spec:** [`docs/superpowers/specs/2026-08-15-five-adapter-runtime-remediation-review-design.md`](../specs/2026-08-15-five-adapter-runtime-remediation-review-design.md) +**Spec:** [`docs/superpowers/specs/2026-08-15-five-adapter-runtime-remediation-review-design.md`](../../design/2026-08-15-five-adapter-runtime-remediation-review-design.md) (§2, §3.1, §4, §11 Wave 0, §12.2) --- diff --git a/docs/superpowers/plans/2026-08-15-wave1-activation-ssot.md b/docs/history/plans/2026-08-15-wave1-activation-ssot.md similarity index 99% rename from docs/superpowers/plans/2026-08-15-wave1-activation-ssot.md rename to docs/history/plans/2026-08-15-wave1-activation-ssot.md index 2ee6ec62..6d46a217 100644 --- a/docs/superpowers/plans/2026-08-15-wave1-activation-ssot.md +++ b/docs/history/plans/2026-08-15-wave1-activation-ssot.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-15 +- 요약: 어댑터마다 활성화 정본 하나와 classpath를 정하는 1단계 계획이다. +- 현재 정본: `docs/capability-status.md` + + # Wave 1 — Activation SSOT and Classpath Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development @@ -28,7 +37,7 @@ capability roots whose conditions are computed from the same dependency closure. `AutoConfigurationImportFilter`, `EnvironmentPostProcessor`), Gradle 9 project dependencies, the architecture registry, JUnit 5 + `ApplicationContextRunner` + `@SpringBootTest`. -**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../specs/2026-08-15-five-adapter-runtime-remediation-review-design.md) +**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../../design/2026-08-15-five-adapter-runtime-remediation-review-design.md) (§4, §5, §6.1 JPA-INT-001/004, §6.2 MNG-INT-001/005, §6.3 MSG-INT-001, §6.4 NTF-INT-005, §6.5 GQL-INT-001, §11 Wave 1) diff --git a/docs/superpowers/plans/2026-08-15-wave2-module-on-path.md b/docs/history/plans/2026-08-15-wave2-module-on-path.md similarity index 98% rename from docs/superpowers/plans/2026-08-15-wave2-module-on-path.md rename to docs/history/plans/2026-08-15-wave2-module-on-path.md index edbf7aae..f9f1f87b 100644 --- a/docs/superpowers/plans/2026-08-15-wave2-module-on-path.md +++ b/docs/history/plans/2026-08-15-wave2-module-on-path.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-15 +- 요약: 스위치를 켜면 실제로 동작하게 모듈별 막힘을 푸는 2단계 계획이다. +- 현재 정본: `docs/capability-status.md` + + # Wave 2 — Module On-Path Blockers Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development @@ -22,7 +31,7 @@ through the real request path. **Tech Stack:** Testcontainers (PostgreSQL 16/17/18, MongoDB replica set, Kafka, RabbitMQ, Mailpit), Spring GraphQL, Spring Security OAuth2 resource server, Flyway, Micrometer. -**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../specs/2026-08-15-five-adapter-runtime-remediation-review-design.md) +**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../../design/2026-08-15-five-adapter-runtime-remediation-review-design.md) (§6 in full, §11 Wave 2, §12.2, §12.3) --- diff --git a/docs/superpowers/plans/2026-08-15-wave3-environment-and-infra.md b/docs/history/plans/2026-08-15-wave3-environment-and-infra.md similarity index 97% rename from docs/superpowers/plans/2026-08-15-wave3-environment-and-infra.md rename to docs/history/plans/2026-08-15-wave3-environment-and-infra.md index c0393113..ad67ff3a 100644 --- a/docs/superpowers/plans/2026-08-15-wave3-environment-and-infra.md +++ b/docs/history/plans/2026-08-15-wave3-environment-and-infra.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-15 +- 요약: 예제 설정과 운영 입력을 나누고 인프라 smoke를 세우는 3단계 계획이다. +- 현재 정본: `docs/capability-status.md` + + # Wave 3 — Environment Separation and Infrastructure Smoke Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development @@ -24,7 +33,7 @@ secret files, sanitized evidence, and a `trap`-driven teardown scoped to that pr **Tech Stack:** Docker Compose ≥ 2.24.4 (this machine: 5.4.0), PostgreSQL 16 with TLS, MongoDB replica set, Kafka, Mailpit, MinIO + `mc`, Keycloak with `--import-realm`, Bash. -**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../specs/2026-08-15-five-adapter-runtime-remediation-review-design.md) +**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../../design/2026-08-15-five-adapter-runtime-remediation-review-design.md) (§7 in full, §11 Wave 3, §12.4) --- diff --git a/docs/superpowers/plans/2026-08-15-wave4-warning-zero.md b/docs/history/plans/2026-08-15-wave4-warning-zero.md similarity index 96% rename from docs/superpowers/plans/2026-08-15-wave4-warning-zero.md rename to docs/history/plans/2026-08-15-wave4-warning-zero.md index 1374c4b5..a3486487 100644 --- a/docs/superpowers/plans/2026-08-15-wave4-warning-zero.md +++ b/docs/history/plans/2026-08-15-wave4-warning-zero.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-15 +- 요약: local·dev·prod 기동 로그의 WARN·ERROR를 0으로 만드는 4단계 계획이다. +- 현재 정본: `docs/capability-status.md` + + # Wave 4 — Runtime Warning and IDE Error Zero Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development @@ -21,7 +30,7 @@ warning gate itself is the Wave 0 recorder, promoted from characterization to a **Tech Stack:** Micrometer `MeterRegistryCustomizer`/`MeterFilter`, Spring `ObjectProvider`, Logback `springProfile`, Eclipse JDT preferences, Spring Tools LS settings. -**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../specs/2026-08-15-five-adapter-runtime-remediation-review-design.md) +**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../../design/2026-08-15-five-adapter-runtime-remediation-review-design.md) (§9 in full, §11 Wave 4) --- diff --git a/docs/superpowers/plans/2026-08-15-wave5-gradle-build-logic.md b/docs/history/plans/2026-08-15-wave5-gradle-build-logic.md similarity index 95% rename from docs/superpowers/plans/2026-08-15-wave5-gradle-build-logic.md rename to docs/history/plans/2026-08-15-wave5-gradle-build-logic.md index 9f177163..7d7ae9a4 100644 --- a/docs/superpowers/plans/2026-08-15-wave5-gradle-build-logic.md +++ b/docs/history/plans/2026-08-15-wave5-gradle-build-logic.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-15 +- 요약: 중복된 Gradle 빌드 로직을 convention으로 뽑는 5단계 계획이다. +- 현재 정본: `docs/capability-status.md` + + # Wave 5 — Gradle Build Logic Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development @@ -21,7 +30,7 @@ reporting green for work it no longer does. **Tech Stack:** Gradle 9 included builds, precompiled script plugins (`build-logic/src/main/groovy`), Gradle TestKit. -**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../specs/2026-08-15-five-adapter-runtime-remediation-review-design.md) +**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../../design/2026-08-15-five-adapter-runtime-remediation-review-design.md) (§10 in full, §11 Wave 5, §14 closing paragraph) --- diff --git a/docs/superpowers/plans/2026-08-15-wave6-final-qualification.md b/docs/history/plans/2026-08-15-wave6-final-qualification.md similarity index 95% rename from docs/superpowers/plans/2026-08-15-wave6-final-qualification.md rename to docs/history/plans/2026-08-15-wave6-final-qualification.md index 5d0d11a2..b0cead3e 100644 --- a/docs/superpowers/plans/2026-08-15-wave6-final-qualification.md +++ b/docs/history/plans/2026-08-15-wave6-final-qualification.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-15 +- 요약: 모든 차단 게이트와 활성화 매트릭스, 환경 smoke를 돌리는 마지막 단계 계획이다. +- 현재 정본: `docs/capability-status.md` + + # Wave 6 — Final Qualification and Documentation Sync Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans (this wave is @@ -15,7 +24,7 @@ backed by a command and its output stored under `docs/superpowers/plans/evidence/2026-08-15-wave6-final/`. A checkbox without attached evidence stays unticked, and a gate that could not run is reported as not-run with its reason — never as passing. -**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../specs/2026-08-15-five-adapter-runtime-remediation-review-design.md) +**Spec:** [`2026-08-15-five-adapter-runtime-remediation-review-design.md`](../../design/2026-08-15-five-adapter-runtime-remediation-review-design.md) (§12 in full, §13, §11 Wave 6) --- diff --git a/docs/superpowers/plans/2026-08-30-grpc-platform-implementation.md b/docs/history/plans/2026-08-30-grpc-platform-implementation.md similarity index 93% rename from docs/superpowers/plans/2026-08-30-grpc-platform-implementation.md rename to docs/history/plans/2026-08-30-grpc-platform-implementation.md index cee058e1..e30b43b1 100644 --- a/docs/superpowers/plans/2026-08-30-grpc-platform-implementation.md +++ b/docs/history/plans/2026-08-30-grpc-platform-implementation.md @@ -1,6 +1,15 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-08-30 +- 요약: 타입 안전 gRPC 실행 플랫폼의 실행 계획과 실행 결과다. +- 현재 정본: `docs/compatibility/grpc-support-matrix.md` + + # 타입 안전 gRPC 실행 플랫폼 — 실행 계획과 실행 결과 -설계 SSOT: [docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md](../specs/2026-08-30-grpc-platform-adaptation-design.md) +설계 SSOT: [docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md](../../design/2026-08-30-grpc-platform-adaptation-design.md) 원본: - `docs/2026-08-13-grpc-type-safe-rpc-platform-implementation-plan.md` (Stable, Task 1–53) diff --git a/docs/superpowers/plans/2026-09-16-ci-stage-separation.md b/docs/history/plans/2026-09-16-ci-stage-separation.md similarity index 96% rename from docs/superpowers/plans/2026-09-16-ci-stage-separation.md rename to docs/history/plans/2026-09-16-ci-stage-separation.md index 6071e627..6c93273e 100644 --- a/docs/superpowers/plans/2026-09-16-ci-stage-separation.md +++ b/docs/history/plans/2026-09-16-ci-stage-separation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-16 +- 요약: CI를 단계별로 나누고 컨테이너 릴리스를 들여오는 계획이다. +- 현재 정본: `docs/work/reference/gates.md` + + # CI 단계 분리 + 컨테이너 릴리스 도입 - 작성: 2026-09-16 diff --git a/docs/superpowers/plans/2026-09-17-jpa-evidence-gradle-model-decoupling.md b/docs/history/plans/2026-09-17-jpa-evidence-gradle-model-decoupling.md similarity index 92% rename from docs/superpowers/plans/2026-09-17-jpa-evidence-gradle-model-decoupling.md rename to docs/history/plans/2026-09-17-jpa-evidence-gradle-model-decoupling.md index 76a13192..e4294732 100644 --- a/docs/superpowers/plans/2026-09-17-jpa-evidence-gradle-model-decoupling.md +++ b/docs/history/plans/2026-09-17-jpa-evidence-gradle-model-decoupling.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-17 +- 요약: JPA 증거 생성에서 실행 시점 Gradle 모델 접근을 없애는 실행 계획이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA Evidence Gradle Model Decoupling Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-09-17-jpa-leaf-verification-java.md b/docs/history/plans/2026-09-17-jpa-leaf-verification-java.md similarity index 86% rename from docs/superpowers/plans/2026-09-17-jpa-leaf-verification-java.md rename to docs/history/plans/2026-09-17-jpa-leaf-verification-java.md index 443ecb1a..d118144f 100644 --- a/docs/superpowers/plans/2026-09-17-jpa-leaf-verification-java.md +++ b/docs/history/plans/2026-09-17-jpa-leaf-verification-java.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-17 +- 요약: JPA leaf 검증 로직을 Groovy에서 Java로 옮기는 실행 계획이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA Leaf Verification Java Migration Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-09-17-jpa-test-lanes-java.md b/docs/history/plans/2026-09-17-jpa-test-lanes-java.md similarity index 73% rename from docs/superpowers/plans/2026-09-17-jpa-test-lanes-java.md rename to docs/history/plans/2026-09-17-jpa-test-lanes-java.md index 503cddc1..304a61b1 100644 --- a/docs/superpowers/plans/2026-09-17-jpa-test-lanes-java.md +++ b/docs/history/plans/2026-09-17-jpa-test-lanes-java.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-17 +- 요약: JPA 테스트 lane 정의를 Java record convention으로 옮기는 계획이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA Test Lanes Java Convention Plan **Goal:** Remove the remaining Map-driven JPA lane factories from Groovy and make lane metadata compile-time checked Java records. diff --git a/docs/superpowers/plans/2026-09-17-mongo-gradle-verification-java.md b/docs/history/plans/2026-09-17-mongo-gradle-verification-java.md similarity index 90% rename from docs/superpowers/plans/2026-09-17-mongo-gradle-verification-java.md rename to docs/history/plans/2026-09-17-mongo-gradle-verification-java.md index a6aa6758..478f7c55 100644 --- a/docs/superpowers/plans/2026-09-17-mongo-gradle-verification-java.md +++ b/docs/history/plans/2026-09-17-mongo-gradle-verification-java.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-17 +- 요약: Mongo 빌드 검증 알고리즘을 Groovy에서 Java 빌드 도구로 옮기는 실행 계획이다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + # Mongo Gradle Verification Java Migration Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-09-17-redis-topology-lane-java.md b/docs/history/plans/2026-09-17-redis-topology-lane-java.md similarity index 80% rename from docs/superpowers/plans/2026-09-17-redis-topology-lane-java.md rename to docs/history/plans/2026-09-17-redis-topology-lane-java.md index c04763e0..aacbfec2 100644 --- a/docs/superpowers/plans/2026-09-17-redis-topology-lane-java.md +++ b/docs/history/plans/2026-09-17-redis-topology-lane-java.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-17 +- 요약: Redis topology 검증 lane을 Java convention plugin으로 옮기는 실행 계획이다. +- 현재 정본: `docs/redis/support-matrix.md` + + # Redis Topology Lane Java Migration Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. diff --git a/docs/superpowers/plans/2026-09-18-bootstrap-structured-log-fields.md b/docs/history/plans/2026-09-18-bootstrap-structured-log-fields.md similarity index 60% rename from docs/superpowers/plans/2026-09-18-bootstrap-structured-log-fields.md rename to docs/history/plans/2026-09-18-bootstrap-structured-log-fields.md index f242c41d..916bbade 100644 --- a/docs/superpowers/plans/2026-09-18-bootstrap-structured-log-fields.md +++ b/docs/history/plans/2026-09-18-bootstrap-structured-log-fields.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: app-bootstrap 경고 로그를 구조화 필드로 모으는 계획이다. +- 현재 정본: `docs/observability/log-fields.md` + + # Bootstrap Structured Log Fields — Plan - [x] Centralize meter/fallback warning shapes in RuntimeWarnings diff --git a/docs/superpowers/plans/2026-09-18-bootstrap-structured-runtime-logging.md b/docs/history/plans/2026-09-18-bootstrap-structured-runtime-logging.md similarity index 58% rename from docs/superpowers/plans/2026-09-18-bootstrap-structured-runtime-logging.md rename to docs/history/plans/2026-09-18-bootstrap-structured-runtime-logging.md index 4420bc87..36285e86 100644 --- a/docs/superpowers/plans/2026-09-18-bootstrap-structured-runtime-logging.md +++ b/docs/history/plans/2026-09-18-bootstrap-structured-runtime-logging.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: app-bootstrap의 남은 운영 로그를 구조화하는 계획이다. +- 현재 정본: `docs/observability/log-fields.md` + + # Bootstrap Structured Runtime Logging — Plan - [x] Add structured fields to FileserverCleanupWorker success/failure logs diff --git a/docs/superpowers/plans/2026-09-18-deployment-composition-reachability-remediation.md b/docs/history/plans/2026-09-18-deployment-composition-reachability-remediation.md similarity index 83% rename from docs/superpowers/plans/2026-09-18-deployment-composition-reachability-remediation.md rename to docs/history/plans/2026-09-18-deployment-composition-reachability-remediation.md index e2e22b2f..b715ce17 100644 --- a/docs/superpowers/plans/2026-09-18-deployment-composition-reachability-remediation.md +++ b/docs/history/plans/2026-09-18-deployment-composition-reachability-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: 배포 조립에서 닿지 않던 구성 요소를 고치는 계획이다. +- 현재 정본: `docs/capability-status.md` + + # Deployment Composition Reachability Remediation — Plan ## Stage 0 — global Clock diff --git a/docs/superpowers/plans/2026-09-18-httpclient-capability-composition-ownership.md b/docs/history/plans/2026-09-18-httpclient-capability-composition-ownership.md similarity index 70% rename from docs/superpowers/plans/2026-09-18-httpclient-capability-composition-ownership.md rename to docs/history/plans/2026-09-18-httpclient-capability-composition-ownership.md index 637e1c83..527e80d5 100644 --- a/docs/superpowers/plans/2026-09-18-httpclient-capability-composition-ownership.md +++ b/docs/history/plans/2026-09-18-httpclient-capability-composition-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: HTTP client 조립을 capability leaf로 옮기는 계획이다. +- 현재 정본: `docs/httpclient/support-matrix.md` + + # HTTP Client Capability Composition Ownership — Plan - [x] Add generic capability startup-validation failure support and reporter coverage diff --git a/docs/superpowers/plans/2026-09-18-jpa-capability-composition-ownership.md b/docs/history/plans/2026-09-18-jpa-capability-composition-ownership.md similarity index 78% rename from docs/superpowers/plans/2026-09-18-jpa-capability-composition-ownership.md rename to docs/history/plans/2026-09-18-jpa-capability-composition-ownership.md index 9f499c49..7725ec70 100644 --- a/docs/superpowers/plans/2026-09-18-jpa-capability-composition-ownership.md +++ b/docs/history/plans/2026-09-18-jpa-capability-composition-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: 관계형 영속성 조립을 persistence-jpa로 옮기는 계획이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA Capability Composition Ownership — Plan - [x] Add package-private leaf Boot roots under the JPA master switch diff --git a/docs/superpowers/plans/2026-09-18-jpa-runtime-master-switch.md b/docs/history/plans/2026-09-18-jpa-runtime-master-switch.md similarity index 56% rename from docs/superpowers/plans/2026-09-18-jpa-runtime-master-switch.md rename to docs/history/plans/2026-09-18-jpa-runtime-master-switch.md index 2f666ff7..511c55cb 100644 --- a/docs/superpowers/plans/2026-09-18-jpa-runtime-master-switch.md +++ b/docs/history/plans/2026-09-18-jpa-runtime-master-switch.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: JPA 조립 후보가 같은 스위치를 따르게 하는 계획이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # JPA Runtime Master Switch — Plan - [x] Change the focused runtime fixture so normal runtime tests explicitly enable JPA diff --git a/docs/superpowers/plans/2026-09-18-messaging-platform-bridge.md b/docs/history/plans/2026-09-18-messaging-platform-bridge.md similarity index 91% rename from docs/superpowers/plans/2026-09-18-messaging-platform-bridge.md rename to docs/history/plans/2026-09-18-messaging-platform-bridge.md index 7a562665..51c669a2 100644 --- a/docs/superpowers/plans/2026-09-18-messaging-platform-bridge.md +++ b/docs/history/plans/2026-09-18-messaging-platform-bridge.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: 통합 이벤트 발행 경계를 메시징 플랫폼 bridge에 잇는 실행 계획이다. +- 현재 정본: `docs/messaging/support-matrix.md` + + # Messaging Platform Bridge Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-09-18-mongo-health-composition-ownership.md b/docs/history/plans/2026-09-18-mongo-health-composition-ownership.md similarity index 62% rename from docs/superpowers/plans/2026-09-18-mongo-health-composition-ownership.md rename to docs/history/plans/2026-09-18-mongo-health-composition-ownership.md index 83c12524..33c35ff5 100644 --- a/docs/superpowers/plans/2026-09-18-mongo-health-composition-ownership.md +++ b/docs/history/plans/2026-09-18-mongo-health-composition-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: Mongo health 조립을 persistence-mongo로 옮기는 계획이다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + # Mongo Health Composition Ownership — Plan - [x] Add spring-boot-health to persistence-mongo diff --git a/docs/superpowers/plans/2026-09-18-notification-capability-composition-ownership.md b/docs/history/plans/2026-09-18-notification-capability-composition-ownership.md similarity index 78% rename from docs/superpowers/plans/2026-09-18-notification-capability-composition-ownership.md rename to docs/history/plans/2026-09-18-notification-capability-composition-ownership.md index 3038684b..010adffb 100644 --- a/docs/superpowers/plans/2026-09-18-notification-capability-composition-ownership.md +++ b/docs/history/plans/2026-09-18-notification-capability-composition-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: 알림 조립을 알림 capability로 옮기는 계획이다. +- 현재 정본: `docs/notification/support-matrix.md` + + # Notification Capability Composition Ownership — Plan - [x] Replace bootstrap StartupFailures dependency in notification secrets with capability startup validation diff --git a/docs/superpowers/plans/2026-09-18-outbox-transport-only-cutover.md b/docs/history/plans/2026-09-18-outbox-transport-only-cutover.md similarity index 91% rename from docs/superpowers/plans/2026-09-18-outbox-transport-only-cutover.md rename to docs/history/plans/2026-09-18-outbox-transport-only-cutover.md index 9b13bc4b..85a7b9e6 100644 --- a/docs/superpowers/plans/2026-09-18-outbox-transport-only-cutover.md +++ b/docs/history/plans/2026-09-18-outbox-transport-only-cutover.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: outbox 저장소는 두고 발행 전송만 메시징 플랫폼으로 넘기는 실행 계획이다. +- 현재 정본: `src/composition/outbox-relay/README.md` + + # Outbox Transport-Only Cutover Implementation Plan **Goal:** Preserve canonical integration-event bytes and metadata inside the existing legacy `outbox_event` authority, then route canonical claimed rows through the messaging platform while legacy rows keep the current broker path. diff --git a/docs/superpowers/plans/2026-09-18-outbox-v2-canonical-storage-alignment.md b/docs/history/plans/2026-09-18-outbox-v2-canonical-storage-alignment.md similarity index 81% rename from docs/superpowers/plans/2026-09-18-outbox-v2-canonical-storage-alignment.md rename to docs/history/plans/2026-09-18-outbox-v2-canonical-storage-alignment.md index 4b53ff43..b1171c53 100644 --- a/docs/superpowers/plans/2026-09-18-outbox-v2-canonical-storage-alignment.md +++ b/docs/history/plans/2026-09-18-outbox-v2-canonical-storage-alignment.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: outbox V2 저장소를 canonical 이벤트에 맞추는 계획이다. V2 세대는 2026-09-25에 지웠다. +- 현재 정본: `docs/capability-status.md` + + # Outbox V2 Canonical Storage Alignment — Plan - [x] Make NewOutboxEventV2 wrap ValidatedIntegrationEvent only diff --git a/docs/superpowers/plans/2026-09-18-outbox-v2-one-record-publication-policy.md b/docs/history/plans/2026-09-18-outbox-v2-one-record-publication-policy.md similarity index 72% rename from docs/superpowers/plans/2026-09-18-outbox-v2-one-record-publication-policy.md rename to docs/history/plans/2026-09-18-outbox-v2-one-record-publication-policy.md index e1db876f..e09af053 100644 --- a/docs/superpowers/plans/2026-09-18-outbox-v2-one-record-publication-policy.md +++ b/docs/history/plans/2026-09-18-outbox-v2-one-record-publication-policy.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-18 +- 요약: outbox V2 기록 하나를 한 번 발행하는 정책 계획이다. V2 세대는 2026-09-25에 지웠다. +- 현재 정본: `docs/capability-status.md` + + # Outbox V2 One-Record Publication Policy — Plan - [ ] Add DB event/delivery created-at facts to ClaimedOutboxDelivery diff --git a/docs/superpowers/plans/2026-09-18-postgresql-idempotency-composition-ownership.md b/docs/history/plans/2026-09-18-postgresql-idempotency-composition-ownership.md similarity index 64% rename from docs/superpowers/plans/2026-09-18-postgresql-idempotency-composition-ownership.md rename to docs/history/plans/2026-09-18-postgresql-idempotency-composition-ownership.md index 9b4a976b..e820456d 100644 --- a/docs/superpowers/plans/2026-09-18-postgresql-idempotency-composition-ownership.md +++ b/docs/history/plans/2026-09-18-postgresql-idempotency-composition-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: PostgreSQL 멱등성 저장소 조립을 persistence-jpa로 옮기는 계획이다. +- 현재 정본: `src/composition/idempotency/README.md` + + # PostgreSQL Idempotency Composition Ownership — Plan - [x] Add package-private PostgreSQL idempotency store composition to persistence-jpa diff --git a/docs/superpowers/plans/2026-09-18-runtime-environment-tracing-ssot.md b/docs/history/plans/2026-09-18-runtime-environment-tracing-ssot.md similarity index 64% rename from docs/superpowers/plans/2026-09-18-runtime-environment-tracing-ssot.md rename to docs/history/plans/2026-09-18-runtime-environment-tracing-ssot.md index 15cc2f9e..a4e76b03 100644 --- a/docs/superpowers/plans/2026-09-18-runtime-environment-tracing-ssot.md +++ b/docs/history/plans/2026-09-18-runtime-environment-tracing-ssot.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: tracing과 capability 검증이 런타임 profile 어휘 하나를 쓰게 하는 계획이다. +- 현재 정본: `src/app-bootstrap/README.md` + + # Runtime Environment and Tracing SSOT — Plan - [x] Make TracingSampleRateResolver depend on RuntimeEnvironment, not string switch literals diff --git a/docs/superpowers/plans/2026-09-18-secret-source-port-ownership.md b/docs/history/plans/2026-09-18-secret-source-port-ownership.md similarity index 67% rename from docs/superpowers/plans/2026-09-18-secret-source-port-ownership.md rename to docs/history/plans/2026-09-18-secret-source-port-ownership.md index f71b429a..39d76e5d 100644 --- a/docs/superpowers/plans/2026-09-18-secret-source-port-ownership.md +++ b/docs/history/plans/2026-09-18-secret-source-port-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: 시크릿 출처 포트를 application으로 옮기는 계획이다. +- 현재 정본: `docs/registries/env-keys.yaml` + + # Secret Source Port Ownership — Plan - [x] Add application-owned SecretSourcePort under application.outbound diff --git a/docs/superpowers/plans/2026-09-18-startup-failure-log-context-state.md b/docs/history/plans/2026-09-18-startup-failure-log-context-state.md similarity index 57% rename from docs/superpowers/plans/2026-09-18-startup-failure-log-context-state.md rename to docs/history/plans/2026-09-18-startup-failure-log-context-state.md index af97c610..47deec54 100644 --- a/docs/superpowers/plans/2026-09-18-startup-failure-log-context-state.md +++ b/docs/history/plans/2026-09-18-startup-failure-log-context-state.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: 기동 실패 로그 상태를 logger context로 옮기는 계획이다. +- 현재 정본: `docs/observability/log-fields.md` + + # Startup Failure Log Context State — Plan - [x] Replace static AtomicBoolean with LoggerContext object-map state diff --git a/docs/superpowers/plans/2026-09-18-test-architecture-phase2-provider-ownership.md b/docs/history/plans/2026-09-18-test-architecture-phase2-provider-ownership.md similarity index 80% rename from docs/superpowers/plans/2026-09-18-test-architecture-phase2-provider-ownership.md rename to docs/history/plans/2026-09-18-test-architecture-phase2-provider-ownership.md index c166ed41..675f2cd0 100644 --- a/docs/superpowers/plans/2026-09-18-test-architecture-phase2-provider-ownership.md +++ b/docs/history/plans/2026-09-18-test-architecture-phase2-provider-ownership.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: provider 증거 테스트를 소유 leaf로 옮기는 실행 계획이다. +- 현재 정본: `docs/testing/TESTING_STRATEGY.md` + + # Test Architecture Phase 2 Provider Ownership — Implementation Plan ## Slice A — PostgreSQL migration/idempotency ownership diff --git a/docs/superpowers/plans/2026-09-18-test-taxonomy-ssot-alignment.md b/docs/history/plans/2026-09-18-test-taxonomy-ssot-alignment.md similarity index 65% rename from docs/superpowers/plans/2026-09-18-test-taxonomy-ssot-alignment.md rename to docs/history/plans/2026-09-18-test-taxonomy-ssot-alignment.md index f48bba0f..fa75b6bc 100644 --- a/docs/superpowers/plans/2026-09-18-test-taxonomy-ssot-alignment.md +++ b/docs/history/plans/2026-09-18-test-taxonomy-ssot-alignment.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-18 +- 요약: 테스트 전략 문서를 테스트 분류 정본에 맞추는 계획이다. +- 현재 정본: `docs/testing/TESTING_STRATEGY.md` + + # Test Taxonomy SSOT Alignment — Plan - [x] Rewrite TESTING_STRATEGY around TEST / INTEGRATION / SYSTEM / ARCHITECTURE / PERFORMANCE diff --git a/docs/superpowers/plans/2026-09-19-build-release-review-remediation.md b/docs/history/plans/2026-09-19-build-release-review-remediation.md similarity index 89% rename from docs/superpowers/plans/2026-09-19-build-release-review-remediation.md rename to docs/history/plans/2026-09-19-build-release-review-remediation.md index 41c9f75f..16b9252e 100644 --- a/docs/superpowers/plans/2026-09-19-build-release-review-remediation.md +++ b/docs/history/plans/2026-09-19-build-release-review-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: 빌드·CI 리뷰의 조립 결함을 고치는 실행 계획이다. +- 현재 정본: `docs/work/reference/gates.md` + + # Build / Release Review Remediation Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [x]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-09-19-capability-dependency-validation-context.md b/docs/history/plans/2026-09-19-capability-dependency-validation-context.md similarity index 60% rename from docs/superpowers/plans/2026-09-19-capability-dependency-validation-context.md rename to docs/history/plans/2026-09-19-capability-dependency-validation-context.md index c7ebf75a..833cf066 100644 --- a/docs/superpowers/plans/2026-09-19-capability-dependency-validation-context.md +++ b/docs/history/plans/2026-09-19-capability-dependency-validation-context.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: capability 의존 검증을 StartupValidationContext로 옮기는 계획이다. +- 현재 정본: `docs/capability-status.md` + + # Capability Dependency Validation Context — Plan - [x] Replace raw capability dependency ArrayList with StartupValidationContext diff --git a/docs/superpowers/plans/2026-09-19-env-contract-verifier-truth-surface.md b/docs/history/plans/2026-09-19-env-contract-verifier-truth-surface.md similarity index 67% rename from docs/superpowers/plans/2026-09-19-env-contract-verifier-truth-surface.md rename to docs/history/plans/2026-09-19-env-contract-verifier-truth-surface.md index 315ee494..136f3b8c 100644 --- a/docs/superpowers/plans/2026-09-19-env-contract-verifier-truth-surface.md +++ b/docs/history/plans/2026-09-19-env-contract-verifier-truth-surface.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: env 키 검사가 선언과 사용을 구분하게 하는 계획이다. +- 현재 정본: `docs/registries/env-keys.yaml` + + # Env Contract Verifier Truth Surface — Plan - [x] Add RED test: .env.example presence does not make an untyped Redis key consumed diff --git a/docs/superpowers/plans/2026-09-19-fileserver-composition-decomposition.md b/docs/history/plans/2026-09-19-fileserver-composition-decomposition.md similarity index 66% rename from docs/superpowers/plans/2026-09-19-fileserver-composition-decomposition.md rename to docs/history/plans/2026-09-19-fileserver-composition-decomposition.md index bfb0ec20..545bc1d0 100644 --- a/docs/superpowers/plans/2026-09-19-fileserver-composition-decomposition.md +++ b/docs/history/plans/2026-09-19-fileserver-composition-decomposition.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: 파일 서버 조립을 관심사별로 나누는 계획이다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver Composition Decomposition — Plan - [x] Split platform bean families into five package-private concern configurations diff --git a/docs/superpowers/plans/2026-09-19-fileserver-verification-read-failure-remediation.md b/docs/history/plans/2026-09-19-fileserver-verification-read-failure-remediation.md similarity index 59% rename from docs/superpowers/plans/2026-09-19-fileserver-verification-read-failure-remediation.md rename to docs/history/plans/2026-09-19-fileserver-verification-read-failure-remediation.md index 6902dd64..3a818fb7 100644 --- a/docs/superpowers/plans/2026-09-19-fileserver-verification-read-failure-remediation.md +++ b/docs/history/plans/2026-09-19-fileserver-verification-read-failure-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: 파일 검증의 읽기 실패 처리를 고치는 계획이다. +- 현재 정본: `docs/fileserver/support-matrix.md` + + # Fileserver Verification Read Failure Remediation — Plan - [x] Add RED production-reader test: missing staging content must not look like empty content diff --git a/docs/superpowers/plans/2026-09-19-mongo-client-runtime-review-remediation.md b/docs/history/plans/2026-09-19-mongo-client-runtime-review-remediation.md similarity index 67% rename from docs/superpowers/plans/2026-09-19-mongo-client-runtime-review-remediation.md rename to docs/history/plans/2026-09-19-mongo-client-runtime-review-remediation.md index eb0dfbef..0c9d6b43 100644 --- a/docs/superpowers/plans/2026-09-19-mongo-client-runtime-review-remediation.md +++ b/docs/history/plans/2026-09-19-mongo-client-runtime-review-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: Mongo client 런타임 리뷰 결함을 고치는 계획이다. +- 현재 정본: `docs/mongodb/repository-adaptation.md` + + # Mongo Client Runtime Review Remediation — Plan - [x] Add RED startup dependency tests for missing Mongo connection source diff --git a/docs/superpowers/plans/2026-09-19-multi-instance-runtime-contract.md b/docs/history/plans/2026-09-19-multi-instance-runtime-contract.md similarity index 63% rename from docs/superpowers/plans/2026-09-19-multi-instance-runtime-contract.md rename to docs/history/plans/2026-09-19-multi-instance-runtime-contract.md index 9f3964ca..3660fa20 100644 --- a/docs/superpowers/plans/2026-09-19-multi-instance-runtime-contract.md +++ b/docs/history/plans/2026-09-19-multi-instance-runtime-contract.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: 다중 인스턴스 런타임 계약을 세우는 계획이다. +- 현재 정본: `src/app-bootstrap/README.md` + + # Multi-instance Runtime Contract — Plan - [x] Make shipped distributed-lock system proof RED by removing fake sibling coordination beans diff --git a/docs/superpowers/plans/2026-09-19-prod-secret-consumer-alignment.md b/docs/history/plans/2026-09-19-prod-secret-consumer-alignment.md similarity index 59% rename from docs/superpowers/plans/2026-09-19-prod-secret-consumer-alignment.md rename to docs/history/plans/2026-09-19-prod-secret-consumer-alignment.md index f0ed3a08..4879ca7b 100644 --- a/docs/superpowers/plans/2026-09-19-prod-secret-consumer-alignment.md +++ b/docs/history/plans/2026-09-19-prod-secret-consumer-alignment.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: 운영 기동이 쓰는 시크릿만 요구하게 하는 계획이다. +- 현재 정본: `docs/registries/env-keys.yaml` + + # Prod Secret Consumer Alignment — Plan - [x] Remove three consumerless secrets from REQUIRED_PROD_SECRETS diff --git a/docs/superpowers/plans/2026-09-19-runtime-profile-access-boundary.md b/docs/history/plans/2026-09-19-runtime-profile-access-boundary.md similarity index 59% rename from docs/superpowers/plans/2026-09-19-runtime-profile-access-boundary.md rename to docs/history/plans/2026-09-19-runtime-profile-access-boundary.md index ffa9f293..2e6e432e 100644 --- a/docs/superpowers/plans/2026-09-19-runtime-profile-access-boundary.md +++ b/docs/history/plans/2026-09-19-runtime-profile-access-boundary.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: 운영 코드가 active profile을 직접 읽지 않게 하는 계획이다. +- 현재 정본: `src/app-bootstrap/README.md` + + # Runtime Profile Access Boundary — Plan - [x] Add immutable Spring-aware RuntimeProfileSnapshot diff --git a/docs/history/plans/2026-09-19-startup-order-contract.md b/docs/history/plans/2026-09-19-startup-order-contract.md new file mode 100644 index 00000000..0f923341 --- /dev/null +++ b/docs/history/plans/2026-09-19-startup-order-contract.md @@ -0,0 +1,18 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: 기동 순서를 계약 테스트로 고정하는 계획이다. +- 현재 정본: `src/app-bootstrap/README.md` + + +# Startup Order Contract — Plan + +- [x] Add spring.factories-driven EnvironmentPostProcessor ordering test +- [x] Prove every registered processor implements Ordered +- [x] Pin each shipped processor to its StartupOrder constant +- [x] Prove readiness and validator/defaulting bands are strictly ordered +- [x] Run focused ordering test +- [x] Run app-bootstrap full TEST/ARCHITECTURE regressions +- [x] git diff --check diff --git a/docs/history/plans/2026-09-19-test-support-ownership-closure.md b/docs/history/plans/2026-09-19-test-support-ownership-closure.md new file mode 100644 index 00000000..58af9af9 --- /dev/null +++ b/docs/history/plans/2026-09-19-test-support-ownership-closure.md @@ -0,0 +1,18 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-19 +- 요약: 공유 테스트 지원 코드의 위치를 마무리하는 계획이다. +- 현재 정본: `docs/testing/TESTING_STRATEGY.md` + + +# Test Support Ownership Closure — Plan + +- [x] Move AdapterActivationInventory from test to systemTest +- [x] Prove no TEST source consumes AdapterActivationInventory +- [x] Prove custom testkit publisher/source-set declarations are absent +- [x] Preserve taxonomy positive-control fixture placement +- [x] Run systemTest compile/focused consumers +- [x] Run app-bootstrap TEST and ARCHITECTURE regressions +- [x] git diff --check diff --git a/docs/superpowers/plans/2026-09-23-app-bootstrap-build-composition-plan.md b/docs/history/plans/2026-09-23-app-bootstrap-build-composition-plan.md similarity index 97% rename from docs/superpowers/plans/2026-09-23-app-bootstrap-build-composition-plan.md rename to docs/history/plans/2026-09-23-app-bootstrap-build-composition-plan.md index 33520ffa..2f2cd183 100644 --- a/docs/superpowers/plans/2026-09-23-app-bootstrap-build-composition-plan.md +++ b/docs/history/plans/2026-09-23-app-bootstrap-build-composition-plan.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-23 +- 요약: app-bootstrap 빌드 조립을 정리하는 실행 계획이다. +- 현재 정본: `src/app-bootstrap/README.md` + + # App Bootstrap Build Composition — implementation plan Design authority: the 2026-09-23 "App Bootstrap Build Composition 설계 작업 문서". diff --git a/docs/superpowers/plans/2026-09-25-capability-module-packaging.md b/docs/history/plans/2026-09-25-capability-module-packaging.md similarity index 99% rename from docs/superpowers/plans/2026-09-25-capability-module-packaging.md rename to docs/history/plans/2026-09-25-capability-module-packaging.md index 419f3174..3f224e04 100644 --- a/docs/superpowers/plans/2026-09-25-capability-module-packaging.md +++ b/docs/history/plans/2026-09-25-capability-module-packaging.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-25 +- 요약: 부가 기능을 capability 모듈로 포장하고 기본 조립을 web으로 줄이는 실행 계획이다. +- 현재 정본: `docs/capability-status.md` + + # 부가 기능(capability) 모듈 포장 — 실행 계획 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/2026-09-25-review-followup-tools/agent-brief.md b/docs/history/plans/2026-09-25-review-followup-tools/agent-brief.md similarity index 93% rename from docs/superpowers/plans/2026-09-25-review-followup-tools/agent-brief.md rename to docs/history/plans/2026-09-25-review-followup-tools/agent-brief.md index 175fba54..3777b14b 100644 --- a/docs/superpowers/plans/2026-09-25-review-followup-tools/agent-brief.md +++ b/docs/history/plans/2026-09-25-review-followup-tools/agent-brief.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-25 +- 요약: 리뷰 후속 작업에서 구현 에이전트에게 준 공통 지시다. +- 현재 정본: `docs/work/delegate.md` + + # 구현 에이전트 공통 지시 (리뷰 후속) 당신은 구현 에이전트다. 프롬프트가 지정한 묶음(`P<번호>`)을 끝까지 구현·검증·커밋한다. diff --git a/docs/superpowers/plans/2026-09-25-review-followup-tools/apply_results.py b/docs/history/plans/2026-09-25-review-followup-tools/apply_results.py similarity index 100% rename from docs/superpowers/plans/2026-09-25-review-followup-tools/apply_results.py rename to docs/history/plans/2026-09-25-review-followup-tools/apply_results.py diff --git a/docs/superpowers/plans/2026-09-25-review-followup-tools/by_area.py b/docs/history/plans/2026-09-25-review-followup-tools/by_area.py similarity index 100% rename from docs/superpowers/plans/2026-09-25-review-followup-tools/by_area.py rename to docs/history/plans/2026-09-25-review-followup-tools/by_area.py diff --git a/docs/superpowers/plans/2026-09-25-review-followup.md b/docs/history/plans/2026-09-25-review-followup.md similarity index 98% rename from docs/superpowers/plans/2026-09-25-review-followup.md rename to docs/history/plans/2026-09-25-review-followup.md index c508cbd5..aa0c01fe 100644 --- a/docs/superpowers/plans/2026-09-25-review-followup.md +++ b/docs/history/plans/2026-09-25-review-followup.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-25 +- 요약: 2026-09-24 리뷰의 남은 항목을 모두 닫는 실행 계획이다. +- 현재 정본: `docs/reviews/2026-09-25-review-followup-status.md` + + # 2026-09-24 리뷰 남은 항목 전부 반영 — 실행 계획 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave0-baseline.md b/docs/history/plans/evidence/2026-08-15-wave0-baseline.md similarity index 98% rename from docs/superpowers/plans/evidence/2026-08-15-wave0-baseline.md rename to docs/history/plans/evidence/2026-08-15-wave0-baseline.md index a6e141e6..4505f2ef 100644 --- a/docs/superpowers/plans/evidence/2026-08-15-wave0-baseline.md +++ b/docs/history/plans/evidence/2026-08-15-wave0-baseline.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-15 +- 요약: 개선 0단계에서 실패 기준선을 잡은 증거다. +- 현재 정본: `docs/capability-status.md` + + # Wave 0 — Red Baseline Evidence - Repository HEAD at capture: `2f5d2fc21954286213c1474d19935f571ef896ea` diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave2-decisions.md b/docs/history/plans/evidence/2026-08-15-wave2-decisions.md similarity index 99% rename from docs/superpowers/plans/evidence/2026-08-15-wave2-decisions.md rename to docs/history/plans/evidence/2026-08-15-wave2-decisions.md index 2fc843eb..f6ce58fa 100644 --- a/docs/superpowers/plans/evidence/2026-08-15-wave2-decisions.md +++ b/docs/history/plans/evidence/2026-08-15-wave2-decisions.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-15 +- 요약: 개선 2단계에서 고른 선택과 그 증거다. +- 현재 정본: `docs/capability-status.md` + + # Wave 2 — decisions and evidence Required by the Wave 2 exit criteria. One entry per task that made a choice a reader could diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-architecture-gates.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task1-architecture-gates.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-architecture-gates.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task1-architecture-gates.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-check.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task1-check.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-check.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task1-check.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-compile.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task1-compile.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-compile.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task1-compile.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-test.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task1-test.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-test.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task1-test.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-wave0-red-set.md b/docs/history/plans/evidence/2026-08-15-wave6-final/task1-wave0-red-set.md similarity index 85% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-wave0-red-set.md rename to docs/history/plans/evidence/2026-08-15-wave6-final/task1-wave0-red-set.md index 8e562c96..73889497 100644 --- a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-wave0-red-set.md +++ b/docs/history/plans/evidence/2026-08-15-wave6-final/task1-wave0-red-set.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-15 +- 요약: 0단계 실패 묶음이 비었고 그 lane을 지웠다는 증거다. +- 현재 정본: `docs/capability-status.md` + + # Task 1 — the Wave 0 red set is empty, and the lanes are removed ## Command diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-wave0RedReport.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task1-wave0RedReport.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task1-wave0RedReport.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task1-wave0RedReport.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-b5-ghost-release-lanes.md b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-b5-ghost-release-lanes.md similarity index 86% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-b5-ghost-release-lanes.md rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-b5-ghost-release-lanes.md index c8c47be3..6cd8f93b 100644 --- a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-b5-ghost-release-lanes.md +++ b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-b5-ghost-release-lanes.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-15 +- 요약: 실체 없던 Mongo 릴리스 lane 셋을 처리한 증거다. +- 현재 정본: `docs/capability-status.md` + + # Task 2 — Wave 2 Task B5, the three ghost release lanes Wave 2 offered two outcomes for `mongoShardedTest`, `mongoAtlasTest` and `mongoKmsTest`: implement diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-focused-module-tests.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-focused-module-tests.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-focused-module-tests.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-focused-module-tests.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification-NOT-RUN.md b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification-NOT-RUN.md similarity index 87% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification-NOT-RUN.md rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification-NOT-RUN.md index 86942f93..62de081b 100644 --- a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification-NOT-RUN.md +++ b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification-NOT-RUN.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-15 +- 요약: GraphQL bootJar JWT 검증을 돌리지 못한 이유를 남긴 기록이다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # NOT RUN — the GraphQL bootJar JWT qualification Recorded as not-run with its reason, per this wave's rule that a gate which could not run is never diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-graphql-stable-and-transport.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-graphql-stable-and-transport.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-graphql-stable-and-transport.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-graphql-stable-and-transport.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-first-run-failed.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-first-run-failed.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-first-run-failed.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-first-run-failed.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg16.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg16.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg16.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg16.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg17.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg17.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg17.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg17.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg18.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg18.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg18.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg18.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-messaging-certification.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-messaging-certification.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-messaging-certification.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-messaging-certification.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-messaging-live-broker.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-messaging-live-broker.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-messaging-live-broker.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-messaging-live-broker.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-compatibility.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-compatibility.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-compatibility.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-compatibility.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-failover.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-failover.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-failover.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-failover.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-lanes-first-run-failed.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-lanes-first-run-failed.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-lanes-first-run-failed.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-lanes-first-run-failed.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-lanes.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-lanes.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-lanes.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-lanes.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-migration.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-migration.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-migration.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-migration.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-performance.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-performance.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-performance.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-performance.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-replicaset.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-replicaset.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-replicaset.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-replicaset.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-security.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-security.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-mongo-security.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-mongo-security.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-release-manifest-arbiter.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task2-release-manifest-arbiter.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task2-release-manifest-arbiter.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task2-release-manifest-arbiter.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task3-activation-matrix.md b/docs/history/plans/evidence/2026-08-15-wave6-final/task3-activation-matrix.md similarity index 93% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task3-activation-matrix.md rename to docs/history/plans/evidence/2026-08-15-wave6-final/task3-activation-matrix.md index 6478f7f7..d7f4fe09 100644 --- a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task3-activation-matrix.md +++ b/docs/history/plans/evidence/2026-08-15-wave6-final/task3-activation-matrix.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-15 +- 요약: 활성화 매트릭스 열 줄과 각 줄의 증거 위치다. +- 현재 정본: `docs/capability-status.md` + + # Task 3 — the ten-row activation matrix Every row below names where its evidence is, and nothing is ticked from reasoning about the code. diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task3-matrix-to-lane-map.md b/docs/history/plans/evidence/2026-08-15-wave6-final/task3-matrix-to-lane-map.md similarity index 82% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task3-matrix-to-lane-map.md rename to docs/history/plans/evidence/2026-08-15-wave6-final/task3-matrix-to-lane-map.md index 1f47c6a8..0d96463e 100644 --- a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task3-matrix-to-lane-map.md +++ b/docs/history/plans/evidence/2026-08-15-wave6-final/task3-matrix-to-lane-map.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-15 +- 요약: 활성화 매트릭스 줄이 어느 lane의 증거로 이어지는지 적은 표다. +- 현재 정본: `docs/capability-status.md` + + # Task 3 — the activation matrix, and where each row's evidence comes from The plan's matrix is ten rows; the Compose contract is fifteen lanes; the in-process activation diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task3-row8-dependency-error.log b/docs/history/plans/evidence/2026-08-15-wave6-final/task3-row8-dependency-error.log similarity index 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task3-row8-dependency-error.log rename to docs/history/plans/evidence/2026-08-15-wave6-final/task3-row8-dependency-error.log diff --git a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task6-p0-reconciliation.md b/docs/history/plans/evidence/2026-08-15-wave6-final/task6-p0-reconciliation.md similarity index 96% rename from docs/superpowers/plans/evidence/2026-08-15-wave6-final/task6-p0-reconciliation.md rename to docs/history/plans/evidence/2026-08-15-wave6-final/task6-p0-reconciliation.md index af9bc2eb..131e75ef 100644 --- a/docs/superpowers/plans/evidence/2026-08-15-wave6-final/task6-p0-reconciliation.md +++ b/docs/history/plans/evidence/2026-08-15-wave6-final/task6-p0-reconciliation.md @@ -1,3 +1,12 @@ + +> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-15 +- 요약: 다섯 리뷰의 P0 발견을 맞춰 본 결과다. +- 현재 정본: `docs/capability-status.md` + + # Task 6 — the five reviews' P0 findings, reconciled The remediation design this wave executed never referenced a review id (`grep -c` over it: zero). diff --git a/docs/study/graphql-walkthrough.ko.md b/docs/history/study/graphql-walkthrough.ko.md similarity index 99% rename from docs/study/graphql-walkthrough.ko.md rename to docs/history/study/graphql-walkthrough.ko.md index b8b7f532..bf0df1d1 100644 --- a/docs/study/graphql-walkthrough.ko.md +++ b/docs/history/study/graphql-walkthrough.ko.md @@ -1,3 +1,12 @@ + +> **기록 · 학습 문서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-09-16 +- 요약: GraphQL 기능을 쓴 때의 코드로 따라 읽은 학습 기록이다. 2026-09-25 이후 지운 코드를 설명하는 절이 있다. +- 현재 정본: `src/adapter/inbound/graphql/README.md` + + # GraphQL 인바운드 모듈 완전 해부 > **2026-09-25 이후 달라진 점**: `moduleboundary/`, `architecture/`, `compat/`, `release/`, @@ -15,9 +24,9 @@ > 되어 있는가"를 정리한 글이다. > > SSOT는 여전히 `src/config/architecture/modules.json`, 모듈 -> [CLAUDE.md](../../src/adapter/inbound/graphql/CLAUDE.md), -> [README.md](../../src/adapter/inbound/graphql/README.md), -> [ADR-GQL-001](../adr/ADR-GQL-001-graphql-context-and-storage-ownership.md)이다. +> [CLAUDE.md](../../../src/adapter/inbound/graphql/CLAUDE.md), +> [README.md](../../../src/adapter/inbound/graphql/README.md), +> [ADR-GQL-001](../../adr/ADR-GQL-001-graphql-context-and-storage-ownership.md)이다. > 이 문서와 그것들이 어긋나면 그쪽이 맞다 — **단, §28에 적은 것들은 예외다. 거기 적힌 것은 > 문서 쪽이 코드와 어긋나 있는 항목이고, 코드가 맞다.** > diff --git a/docs/study/postgresql-jpa-walkthrough.ko.md b/docs/history/study/postgresql-jpa-walkthrough.ko.md similarity index 99% rename from docs/study/postgresql-jpa-walkthrough.ko.md rename to docs/history/study/postgresql-jpa-walkthrough.ko.md index a812ae35..e48f504c 100644 --- a/docs/study/postgresql-jpa-walkthrough.ko.md +++ b/docs/history/study/postgresql-jpa-walkthrough.ko.md @@ -1,3 +1,12 @@ + +> **기록 · 학습 문서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 보관 +- 작성일: 2026-08-24 +- 요약: PostgreSQL·JPA 기능을 쓴 때의 코드로 따라 읽은 학습 기록이다. +- 현재 정본: `docs/jpa/repository-adaptation.md` + + # PostgreSQL / JPA 모듈 완전 해부 > **성격**: 정책 문서가 아니라 **읽기 기록**이다. `adapter:outbound:persistence-jpa` leaf와 diff --git a/docs/httpclient/repository-adaptation.md b/docs/httpclient/repository-adaptation.md index 95c397a3..4b7c9476 100644 --- a/docs/httpclient/repository-adaptation.md +++ b/docs/httpclient/repository-adaptation.md @@ -1,7 +1,7 @@ # HTTP Client Platform — Repository Adaptation Contract -**Design source:** `docs/superpowers/specs/2026-08-08-httpclient-platform-design.md` -**Plan source:** `docs/superpowers/plans/2026-08-08-httpclient-platform-implementation-plan.md` +**Design source:** `docs/design/2026-08-08-httpclient-platform-design.md` +**Plan source:** `docs/history/plans/2026-08-08-httpclient-platform-implementation-plan.md` The design package states its own adaptation rule: diff --git a/docs/jpa/repository-adaptation.md b/docs/jpa/repository-adaptation.md index 1da52e12..1c13cde8 100644 --- a/docs/jpa/repository-adaptation.md +++ b/docs/jpa/repository-adaptation.md @@ -1,8 +1,8 @@ # JPA Relational Persistence Platform — Repository Adaptation Contract -**Design source:** `docs/superpowers/specs/2026-08-11-jpa-persistence-platform-design.md` -**Stable plan source:** `docs/superpowers/plans/2026-08-11-jpa-persistence-platform-implementation-plan.md` -**Experimental plan source:** `docs/superpowers/plans/2026-08-11-jpa-persistence-experimental-expansion-plan.md` +**Design source:** `docs/design/2026-08-11-jpa-persistence-platform-design.md` +**Stable plan source:** `docs/history/plans/2026-08-11-jpa-persistence-platform-implementation-plan.md` +**Experimental plan source:** `docs/history/plans/2026-08-11-jpa-persistence-experimental-expansion-plan.md` The design package states its own adaptation rule (§3.2): the assumed package paths and Gradle structure are explicit implementation *assumptions* made because the real Backend Skeleton diff --git a/docs/manual/10-capabilities.md b/docs/manual/10-capabilities.md index e5c20061..31140b5c 100644 --- a/docs/manual/10-capabilities.md +++ b/docs/manual/10-capabilities.md @@ -18,7 +18,7 @@ app-bootstrap/build.gradle ``` 정본: `AGENTS.md` 「부가 기능(capability) 모듈 규칙」(완료 기준 7개), -`docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md`, 현황은 `docs/capability-status.md`. +`docs/design/2026-09-25-capability-module-packaging-design.md`, 현황은 `docs/capability-status.md`. ## 켜기 diff --git a/docs/mongodb/repository-adaptation.md b/docs/mongodb/repository-adaptation.md index 9061ff42..e50c4795 100644 --- a/docs/mongodb/repository-adaptation.md +++ b/docs/mongodb/repository-adaptation.md @@ -1,8 +1,8 @@ # MongoDB Document Persistence Platform — Repository Adaptation Contract -**Design source:** `docs/superpowers/specs/2026-08-11-mongodb-document-persistence-platform-design.md` -**Stable plan:** `docs/superpowers/plans/2026-08-11-mongodb-document-persistence-platform-implementation-plan.md` -**Advanced plan:** `docs/superpowers/plans/2026-08-11-mongodb-advanced-capabilities-expansion-plan.md` +**Design source:** `docs/design/2026-08-11-mongodb-document-persistence-platform-design.md` +**Stable plan:** `docs/history/plans/2026-08-11-mongodb-document-persistence-platform-implementation-plan.md` +**Advanced plan:** `docs/history/plans/2026-08-11-mongodb-advanced-capabilities-expansion-plan.md` The design package declares its own module root (`modules/mongodb`) and root package (`io.backend.skeleton.mongodb`) as *implementation assumptions*, not as contract. This file is the diff --git a/docs/notification/adr/NOTIF-ADR-001-durable-acceptance.md b/docs/notification/adr/NOTIF-ADR-001-durable-acceptance.md index e3d6e92c..fb7d5f2f 100644 --- a/docs/notification/adr/NOTIF-ADR-001-durable-acceptance.md +++ b/docs/notification/adr/NOTIF-ADR-001-durable-acceptance.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-14 +- 요약: 알림 submit()은 영속적으로 받아들였다는 뜻이라는 결정이다. +- 현재 정본: `docs/notification/support-matrix.md` + + # NOTIF-ADR-001 — `submit()` means durable acceptance ## Status diff --git a/docs/notification/adr/NOTIF-ADR-002-event-ledger-projection.md b/docs/notification/adr/NOTIF-ADR-002-event-ledger-projection.md index c7d990e7..67afe419 100644 --- a/docs/notification/adr/NOTIF-ADR-002-event-ledger-projection.md +++ b/docs/notification/adr/NOTIF-ADR-002-event-ledger-projection.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-14 +- 요약: 알림 상태를 덧붙이기만 하는 이벤트 원장과 채널별 projector로 둔다는 결정이다. +- 현재 정본: `docs/notification/support-matrix.md` + + # NOTIF-ADR-002 — append-only event ledger with channel projectors ## Status diff --git a/docs/notification/adr/NOTIF-ADR-003-ambiguous-submission.md b/docs/notification/adr/NOTIF-ADR-003-ambiguous-submission.md index 71730392..c38e6184 100644 --- a/docs/notification/adr/NOTIF-ADR-003-ambiguous-submission.md +++ b/docs/notification/adr/NOTIF-ADR-003-ambiguous-submission.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-14 +- 요약: 결과가 모호한 제출을 정식 상태로 둔다는 결정이다. +- 현재 정본: `docs/notification/support-matrix.md` + + # NOTIF-ADR-003 — ambiguous submission is a first-class state ## Status diff --git a/docs/notification/adr/NOTIF-ADR-004-fcm-fid-primary.md b/docs/notification/adr/NOTIF-ADR-004-fcm-fid-primary.md index dd6bc2b1..e7b84c67 100644 --- a/docs/notification/adr/NOTIF-ADR-004-fcm-fid-primary.md +++ b/docs/notification/adr/NOTIF-ADR-004-fcm-fid-primary.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-08-14 +- 요약: FCM 대상은 installation id를 먼저 쓴다는 결정이다. +- 현재 정본: `docs/notification/provider-runbooks.md` + + # NOTIF-ADR-004 — FCM installation id is the primary target ## Status diff --git a/docs/notification/adr/NOTIF-ADR-005-canonical-namespace.md b/docs/notification/adr/NOTIF-ADR-005-canonical-namespace.md index 41e11c10..299363ac 100644 --- a/docs/notification/adr/NOTIF-ADR-005-canonical-namespace.md +++ b/docs/notification/adr/NOTIF-ADR-005-canonical-namespace.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-08-15 +- 요약: 어느 알림 API가 canonical인지 정한 결정이다. R1 타입은 2026-09-25에 지웠다. +- 현재 정본: `docs/notification/module-mapping.md` + + # NOTIF-ADR-005 — 어느 notification API가 canonical인가 ## 상태 diff --git a/docs/notification/module-mapping.md b/docs/notification/module-mapping.md index ba7edb5e..13dd4e5e 100644 --- a/docs/notification/module-mapping.md +++ b/docs/notification/module-mapping.md @@ -1,8 +1,8 @@ # Notification Delivery Platform — module mapping -> Source design: `docs/superpowers/specs/2026-08-10-notification-platform-design.md` +> Source design: `docs/design/2026-08-10-notification-platform-design.md` > -> Source plan: `docs/superpowers/plans/2026-08-10-notification-platform-implementation-plan.md` +> Source plan: `docs/history/plans/2026-08-10-notification-platform-implementation-plan.md` ## Why a mapping exists diff --git a/docs/redis/support-matrix.md b/docs/redis/support-matrix.md index 973fc9b5..9a7bb58a 100644 --- a/docs/redis/support-matrix.md +++ b/docs/redis/support-matrix.md @@ -4,8 +4,8 @@ This file is a gate, not a summary. `RedisSupportMatrixTest` parses the tables b the SDK grows a package or a capability that is not listed, so a module cannot ship without someone stating its minimum version, its topology support, and what it does not do. -Design: `docs/superpowers/specs/2026-08-07-redis-wrapper-typed-api-design.md`. -Delivery status and the decisions behind each module: `docs/superpowers/plans/2026-08-07-redis-wrapper-typed-api-status.md`. +Design: `docs/design/2026-08-07-redis-wrapper-typed-api-design.md`. +Delivery status and the decisions behind each module: `docs/history/plans/2026-08-07-redis-wrapper-typed-api-status.md`. ## Modules diff --git a/docs/registries/error-codes.yaml b/docs/registries/error-codes.yaml index 6b29101f..821c32c1 100644 --- a/docs/registries/error-codes.yaml +++ b/docs/registries/error-codes.yaml @@ -30,7 +30,7 @@ # 4xx carrier는 남기지 않는다. IllegalArgumentException(BAD_PARAMETER)은 WARN. # web AuthErrorResponseWriter — 보안 필터. 5xx는 ERROR, 4xx는 WARN. # 행에 log_level을 두면 OperationalErrorRegistryContractTest가 실패한다. -# 결정: docs/superpowers/specs/2026-11-06-error-code-log-level-design.md 7·10절. +# 결정: docs/design/2026-11-06-error-code-log-level-design.md 7·10절. errors: diff --git a/docs/superpowers/plans/2026-09-19-startup-order-contract.md b/docs/superpowers/plans/2026-09-19-startup-order-contract.md deleted file mode 100644 index 686de418..00000000 --- a/docs/superpowers/plans/2026-09-19-startup-order-contract.md +++ /dev/null @@ -1,9 +0,0 @@ -# Startup Order Contract — Plan - -- [x] Add spring.factories-driven EnvironmentPostProcessor ordering test -- [x] Prove every registered processor implements Ordered -- [x] Pin each shipped processor to its StartupOrder constant -- [x] Prove readiness and validator/defaulting bands are strictly ordered -- [x] Run focused ordering test -- [x] Run app-bootstrap full TEST/ARCHITECTURE regressions -- [x] git diff --check diff --git a/docs/superpowers/plans/2026-09-19-test-support-ownership-closure.md b/docs/superpowers/plans/2026-09-19-test-support-ownership-closure.md deleted file mode 100644 index 564cb162..00000000 --- a/docs/superpowers/plans/2026-09-19-test-support-ownership-closure.md +++ /dev/null @@ -1,9 +0,0 @@ -# Test Support Ownership Closure — Plan - -- [x] Move AdapterActivationInventory from test to systemTest -- [x] Prove no TEST source consumes AdapterActivationInventory -- [x] Prove custom testkit publisher/source-set declarations are absent -- [x] Preserve taxonomy positive-control fixture placement -- [x] Run systemTest compile/focused consumers -- [x] Run app-bootstrap TEST and ARCHITECTURE regressions -- [x] git diff --check diff --git a/docs/superpowers/plans/2026-09-25-review-followup-tools/__pycache__/by_area.cpython-312.pyc b/docs/superpowers/plans/2026-09-25-review-followup-tools/__pycache__/by_area.cpython-312.pyc deleted file mode 100644 index a3bd502f..00000000 Binary files a/docs/superpowers/plans/2026-09-25-review-followup-tools/__pycache__/by_area.cpython-312.pyc and /dev/null differ diff --git a/docs/testing/TESTING_STRATEGY.md b/docs/testing/TESTING_STRATEGY.md index d2f5e7c7..6858520b 100644 --- a/docs/testing/TESTING_STRATEGY.md +++ b/docs/testing/TESTING_STRATEGY.md @@ -4,7 +4,7 @@ - 상태: **활성 SSOT** - 기계 기준: `build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/TestLaneCategory.java` - 관련 리뷰: `docs/reviews/2026-09-07-app-bootstrap-module-code-review.md` BOOT-014~016 -- 후속 결정: `docs/superpowers/specs/2026-09-16-verification-surface-reduction-design.md` +- 후속 결정: `docs/design/2026-09-16-verification-surface-reduction-design.md` ## 1. 공식 테스트 분류는 다섯 개뿐이다 diff --git a/docs/upgrade/2026-11-docs-records.md b/docs/upgrade/2026-11-docs-records.md new file mode 100644 index 00000000..0357e710 --- /dev/null +++ b/docs/upgrade/2026-11-docs-records.md @@ -0,0 +1,32 @@ +# 업그레이드 안내 — 2026-11 기록 문서 위치 + +- 범위: 템플릿 `docs/`의 설계서·계획서·납품 패키지·증거·학습 문서를 옮긴 변경 하나 +- 근거: `docs/README.md` 「설계와 기록」, design-docs `conventions/docs-system.md` + +## 1. 누가 읽나 + +이 템플릿을 `upstream` remote로 두고 merge해 받는 파생 서비스가 읽는다. 코드·설정·빌드는 바뀌지 않았다. +문서 경로만 바뀌었다. + +## 2. 옮긴 경로 + +| 전 | 지금 | +| --- | --- | +| `docs/superpowers/specs/` | `docs/design/` | +| `docs/superpowers/plans/` | `docs/history/plans/` | +| `docs/superpowers/packages/<어댑터>/` | `docs/history/packages/<어댑터>/` | +| `docs/graphql-superpowers-package/` | `docs/history/packages/graphql-superpowers-package/` | +| `docs/web-superpowers-package/` | `docs/history/packages/web-superpowers-package/` | +| `docs/websocket-superpowers-package/` | `docs/history/packages/websocket-superpowers-package/` | +| `docs/evidence/` | `docs/history/evidence/` | +| `docs/study/` | `docs/history/study/` | + +`docs/superpowers/plans/2026-09-25-review-followup-tools/__pycache__/`의 `.pyc`는 실행 산출물이라 지웠다. + +## 3. 할 일 + +1. 서비스 문서·코드 주석이 위 「전」 경로를 가리키면 「지금」 경로로 바꾼다. + `git grep -n -e docs/superpowers -e superpowers-package -e docs/evidence -e docs/study`로 찾는다. +2. 서비스가 이 기록을 지웠다면 merge에서 「삭제 대 이름 바꿈」 충돌이 난다. 지운 쪽을 고르면 된다. +3. 옮긴 기록 파일과 ADR 맨 위에 한국어 머리 블록(상태·작성일·요약·현재 정본)을 달았다. 본문은 원문 그대로다. + 서비스가 그 파일을 고쳤다면 맨 위 몇 줄에서 충돌이 날 수 있다. 형식은 `docs/README.md` 「기록 문서의 머리 블록」이다. diff --git a/docs/upgrade/2026-11-maturity-review.md b/docs/upgrade/2026-11-maturity-review.md index 5a5f3ebf..1464f703 100644 --- a/docs/upgrade/2026-11-maturity-review.md +++ b/docs/upgrade/2026-11-maturity-review.md @@ -269,7 +269,7 @@ V21 실패의 분류는 `docs/runbooks/migration-failed.md` "Classify the failur | Flyway 잠금 | Flyway의 PostgreSQL 마이그레이션 잠금을 트랜잭션 대신 세션에 둔다. Spring Boot의 Flyway는 module-defaults `spring.flyway.postgresql.transactional-lock: false`, 템플릿이 직접 만드는 Flyway(멱등성·알림·sample stream, schema-per-tenant, testkit `MigrationContractRunner`)는 `FlywaySchemaPolicy.configure()`, messaging inbox stream은 같은 값을 직접 넣는다. 운영 코드의 `Flyway.configure()` 직접 호출과 설정 객체 직접 생성(`new FluentConfiguration()`·`new ClassicConfiguration()`·그 하위 클래스, round7 RR7-03-06)은 `JpaProductionArchitectureTest`가 거부한다 | Flyway 기본값에서는 동시 인덱스 마이그레이션이 Flyway 자신의 열린 트랜잭션을 기다려 끝나지 않았다. 이제 끝난다. 마이그레이션은 잠금을 잡은 연결 하나로 돈다. transaction 모드 PgBouncer 뒤에서는 잠금 해제가 다른 서버 연결로 가 다음 배포가 기다릴 수 있으니 마이그레이션은 직접 연결이나 session 모드 pool로 돌린다. 배포 도구는 이 repo 밖이라 2절 15번으로 맞춘다 | 재리뷰 round6 RR6-03-01 · `persistence-jpa.yml`, `.../migration/FlywaySchemaPolicy.java`, `docs/jpa/migration-guide.md` "Who may change the schema"·"Concurrent index builds" | | 실패한 동시 인덱스 마이그레이션 복구 | `docs/runbooks/migration-failed.md`에 「Recover a failed concurrent index migration」을 더했다: 진행 중인 빌드가 없는지 보고, 원인(중복 행, 문장을 붙잡던 열린 트랜잭션)을 정리하고, 실패한 빌드·재빌드가 남긴 무효 인덱스를 `DROP INDEX CONCURRENTLY`로 지우고, 그 버전의 실패 이력 행(`success = false`)만 지운 뒤 다시 배포한다. 실패한 문장이 `DROP INDEX CONCURRENTLY`면 남은 무효 인덱스는 지우지 않는다. 그 마이그레이션이 지우려던 인덱스라 다시 배포한 같은 문장이 지운다. 「Do not」의 이력 수정 금지에 이 한 가지 예외를 적었다. `flyway repair`는 계속 쓰지 않는다 | 전에는 안내가 "`DROP INDEX` 하나"였고, 그대로 하면 남은 실패 이력 때문에 다음 배포가 validate에서 다시 멈췄다. 실패한 drop의 인덱스를 손으로 지우면 다시 배포한 문장이 `42704`(없는 인덱스)로 또 실패한다. 동시 인덱스 마이그레이션을 쓰는 서비스의 운영자는 이 절차로 복구한다 | 재리뷰 round7 RR7-03-03, round8 RR8-03-01, 소유자 결정 2026-11-06 · `docs/jpa/migration-guide.md` "Concurrent index builds", `PostgreSqlConcurrentIndexMigrationIntegrationTest` | | 성능 lane(HTTP client·Mongo) | httpclient `LargeBodyResourceTest`의 힙 상한(32 MiB 스트리밍 중 힙 증가 16 MiB 미만)을 매번 단언한다. 전에는 `-Pperformance.assertions.enabled=true`일 때만 단언하고 아니면 건너뛴다는 줄만 찍었다. Mongo `MongoResourceBudgetLaneTest`는 표준 gate 전체(p99 500ms, pool 대기 250ms, 힙 512 MiB, examined/returned 10, spill 금지)를 Gradle 밖 실행에서도 단언한다(B-43) | 손으로 돌린 `performanceCheck`가 상한을 실제로 재므로, 전에는 통과하던 느린 기계에서 실패할 수 있다 | B4(2026-11-06) · `LargeBodyResourceTest`, `MongoResourceBudgetLaneTest` | -| 보안 필터 로그 레벨 | 보안 필터(`AuthErrorResponseWriter`)의 `security failure` 줄을 5xx(`AUTH_JWKS_UNAVAILABLE` 503, `INTERNAL_AUTH_MISCONFIGURATION` 500)면 ERROR, 4xx면 WARN으로 남긴다. 전에는 모두 WARN이었다. 다른 경로가 5xx를 ERROR로 남기는 규칙(`ServerFailureLog`)과 같아졌다 | ERROR로 거르는 로그 경보·대시보드에 JWKS 장애와 인증 설정 오류가 새로 잡힌다. 401·403은 그대로 WARN | 설계 메모 2026-11-06 7절 결정 2 · `src/adapter/inbound/web/.../auth/AuthErrorResponseWriter.java`, `docs/superpowers/specs/2026-11-06-error-code-log-level-design.md` | +| 보안 필터 로그 레벨 | 보안 필터(`AuthErrorResponseWriter`)의 `security failure` 줄을 5xx(`AUTH_JWKS_UNAVAILABLE` 503, `INTERNAL_AUTH_MISCONFIGURATION` 500)면 ERROR, 4xx면 WARN으로 남긴다. 전에는 모두 WARN이었다. 다른 경로가 5xx를 ERROR로 남기는 규칙(`ServerFailureLog`)과 같아졌다 | ERROR로 거르는 로그 경보·대시보드에 JWKS 장애와 인증 설정 오류가 새로 잡힌다. 401·403은 그대로 WARN | 설계 메모 2026-11-06 7절 결정 2 · `src/adapter/inbound/web/.../auth/AuthErrorResponseWriter.java`, `docs/design/2026-11-06-error-code-log-level-design.md` | ## 6. 따라오는 순서 diff --git a/docs/web/repository-adaptation.md b/docs/web/repository-adaptation.md index 18458797..8e233558 100644 --- a/docs/web/repository-adaptation.md +++ b/docs/web/repository-adaptation.md @@ -1,7 +1,7 @@ # Web platform — repository adaptation The inbound HTTP API execution platform design -(`docs/web-superpowers-package/docs/superpowers/specs/2026-08-13-web-inbound-http-api-execution-platform-design.md`) +(`docs/history/packages/web-superpowers-package/docs/superpowers/specs/2026-08-13-web-inbound-http-api-execution-platform-design.md`) was written against a standalone repository. Four of its assumptions do not hold here, and this document records what each became and why, so a reader comparing the design to the tree is not left guessing whether a difference is a decision or a mistake. diff --git a/docs/work/improve.md b/docs/work/improve.md index d6022009..5918448e 100644 --- a/docs/work/improve.md +++ b/docs/work/improve.md @@ -71,7 +71,7 @@ - 리팩터링: 지킬 동작·타입·실패·진단을 "보존 조건"으로 적는다. 그 조건을 지키는 테스트가 지금 통과하는지 먼저 본다. 리팩터링과 동작 변경을 한 커밋에 섞지 않는다. - 복사본을 합칠 때: 정본 하나를 정하고 나머지를 지운다. 못 지우면 이유를 가까운 `CLAUDE.md`에 적고, 두 벌이 같은지 보는 대조 테스트를 둔다. - 성능: 숫자 없이 시작하지 않는다. 기준선 측정 → 원인 좁히기 → 변경 하나 → 같은 조건으로 재측정 → 회귀 테스트로 고정. 조건은 review-criteria.md 「성능 측정」, 지난 기준선은 [evidence.md](evidence.md)다. 지난 숫자는 현재 커밋에서 다시 잰다. -- 구조 변경: 설계서(`docs/superpowers/specs/`)와 계획서(`docs/superpowers/plans/`)를 먼저 둔다. review-criteria.md 「leaf 변경 체크리스트」를 따른다. ArchUnit 규칙을 바꾸면 잡혀야 할 위반 fixture와 통과해야 할 허용 fixture를 둘 다 둔다. +- 구조 변경: 설계서(`docs/design/`)와 계획서(`docs/history/plans/`)를 먼저 둔다. review-criteria.md 「leaf 변경 체크리스트」를 따른다. ArchUnit 규칙을 바꾸면 잡혀야 할 위반 fixture와 통과해야 할 허용 fixture를 둘 다 둔다. - 테스트 구조: 지금 테스트가 증명하는 것(이름, 단언, skip 수)을 적는다. 고친 뒤 지키려는 production 코드를 일부러 망가뜨려 테스트가 실패하는지(변이) 본다. 옮겼으면 lane별 테스트 수를 전후로 비교한다. ### 4.4 수정 묶음의 크기 diff --git a/docs/work/reference/decisions.md b/docs/work/reference/decisions.md index f083fff2..9e3ae30c 100644 --- a/docs/work/reference/decisions.md +++ b/docs/work/reference/decisions.md @@ -56,7 +56,7 @@ | 개선 매뉴얼을 먼저(지난 것) | 다음 개선 작업 전에 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 | +| 학습 문서(지난 것) | 삭제된 코드를 설명하는 학습 문서(지금 `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절 | | 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절 | @@ -95,7 +95,7 @@ | GraphQL DataLoader 키 실패 | 등록된 `ApiErrorCode`만 노출 | 소유자 | 결정 25 | | Draft-12 offset 불일치 | problem 문서는 프로토콜 예외로 유지 | 소유자 | 결정 12 | | 알림 category 생략 | 거부(400), 판정은 유스케이스 | 소유자 | 결정 13 | -| 오류 코드 로그 레벨 | `error-codes.yaml`에 `log_level` 칸을 두지 않는다. 레벨은 실패 종류·경로가 정한다(`ServerFailureLog`, 보안 필터 `AuthErrorResponseWriter`). 칸이 다시 생기면 `OperationalErrorRegistryContractTest`가 실패한다. 보안 필터는 5xx(`AUTH_JWKS_UNAVAILABLE`·`INTERNAL_AUTH_MISCONFIGURATION`)를 ERROR, 4xx를 WARN으로 남긴다. 401 서명·issuer·audience 불일치는 WARN | 소유자 | 2026-11-06, `docs/superpowers/specs/2026-11-06-error-code-log-level-design.md` 10절 | +| 오류 코드 로그 레벨 | `error-codes.yaml`에 `log_level` 칸을 두지 않는다. 레벨은 실패 종류·경로가 정한다(`ServerFailureLog`, 보안 필터 `AuthErrorResponseWriter`). 칸이 다시 생기면 `OperationalErrorRegistryContractTest`가 실패한다. 보안 필터는 5xx(`AUTH_JWKS_UNAVAILABLE`·`INTERNAL_AUTH_MISCONFIGURATION`)를 ERROR, 4xx를 WARN으로 남긴다. 401 서명·issuer·audience 불일치는 WARN | 소유자 | 2026-11-06, `docs/design/2026-11-06-error-code-log-level-design.md` 10절 | | 감싼 carrier를 전송이 읽는 법 | web·GraphQL·STOMP·gRPC 네 전송 모두 원인 사슬의 첫 carrier를 본다. 감싼 carrier의 응답이 500 `INTERNAL_ERROR` 대신 그 carrier의 코드가 된다. 그보다 먼저 답하는 것은 아래 「GraphQL 판정 순서」(등록 매핑)와 「인자 변환 단계의 감싼 carrier」 두 행이다 | 소유자 | `1103` 18.4절(RR7-01-05), 2026-11-06 | | GraphQL 판정 순서 | 플랫폼 거부 → 실패 자신이 carrier → 등록된 application 매핑 → 원인 사슬의 첫 carrier → 거부된 인자(`IllegalArgumentException`, 인자 binder의 `BindException`) → 가림(`INTERNAL_ERROR`). 앱이 등록한 실패는 carrier를 원인으로 들어도 등록한 코드로 답한다(web에서 앱의 도메인 advice가 먼저 받는 것과 같다). 실패 자신이 carrier인 타입(예: `LockAcquisitionTimeoutException`)을 등록한 매핑은 쓰이지 않는다. 로그 줄은 어느 단계가 답하든 원인 사슬의 첫 carrier로 정한다 — 등록 매핑이 답해도 그 안의 서버 쪽 carrier 줄은 남는다 | 소유자(2026-11-07). 로그 줄도 소유자(2026-11-07, 기본값 확인) | `1103` 19.4절 ①(RR8-01-01), 2026-11-07 총괄 세션 전달 | | 인자 변환 단계의 감싼 carrier | 「감싼 carrier를 전송이 읽는 법」은 인자 변환 단계를 덮지 않는다. web `MethodArgumentTypeMismatchException`·`HttpMessageNotReadableException`과 GraphQL `@Argument` binder 실패는 원인에 carrier가 있어도 `BAD_PARAMETER`·`VALIDATION_FAILED`다. STOMP는 `@DestinationVariable`·`@Header`의 `ConversionFailedException`과 받은 메시지가 실린 `MessageConversionException`을 원인 사슬의 carrier보다 먼저 거부로 보고 WARN 한 줄(타입만)을 남긴다. 요청 형식 오류의 코드는 전송이 정한다 | 소유자(2026-11-07) | `1103` 19.4절 ④(round8/01 「Declined to judge」), 2026-11-07 총괄 세션 전달 | diff --git a/docs/work/research-design.md b/docs/work/research-design.md index 1b7ba181..406489b5 100644 --- a/docs/work/research-design.md +++ b/docs/work/research-design.md @@ -24,7 +24,7 @@ - 이 repo의 내부 선례를 찾는 곳: - [reference/decisions.md](reference/decisions.md)와 그 출처 문서 - `docs/reviews/`의 리뷰 README 「결정」 절과 영역 문서의 「Declined to judge」 - - `docs/adr/`(되돌리기 비싼 선택), `docs/superpowers/specs/`(설계서), `docs/superpowers/plans/`(계획서) + - `docs/adr/`(되돌리기 비싼 선택), `docs/design/`(설계서), `docs/history/plans/`(계획서) - `git log --oneline -- <경로>`와 커밋 본문의 "고른 방법과 버린 대안" - 가장 가까운 `src/**/CLAUDE.md`와 모듈 README - 외부 선례: 쓰는 라이브러리의 공식 문서와 릴리스 노트(Spring Boot, Flyway, Hibernate 등), 같은 문제를 다룬 공개 저장소. 직접 쓴 글(1차)인지 정리한 글(2차)인지 표시한다. @@ -39,7 +39,7 @@ 5. 대안을 비교한다. 실제로 다른 대안 2~5개(크기에 맞게), 기준(효과, 비용, 되돌리기, 파생 서비스 영향, 기존 결정과 충돌), 권하는 안과 이유. 의존 순서가 있는 변경은 의존 그래프 순서로 따진다. 파생 서비스 영향은 파생 서비스 repo에서 바꿀 이름(키, 칸, 타입)을 `git grep`해 쓰는 곳을 센다. 소유자 환경의 파생 서비스 위치는 design-docs `conventions/delegation-loop.md` 11절이다. 6. 반증할 수 있는 가정을 적는다: "이 안이 틀렸다면 어디서 드러나나". 반론과 답도 적는다. 7. 산출물을 둔다. - - 이 repo에만 해당: 설계서 `docs/superpowers/specs/-<주제>-design.md`, 되돌리기 비싼 선택이면 `docs/adr/ADR-<영역>-<번호>-<제목>.md`(기존 번호를 잇는다). + - 이 repo에만 해당: 설계서 `docs/design/-<주제>-design.md`, 되돌리기 비싼 선택이면 `docs/adr/ADR-<영역>-<번호>-<제목>.md`(기존 번호를 잇는다). 둘 다 맨 위에 머리 블록을 단다(`docs/README.md`). - 여러 repo나 소유자 운영에 걸침: design-docs. 템플릿 `docs/`는 파생 서비스로 복사되므로 로드맵·운영 설계는 여기에 두지 않는다. - 짧은 설계 메모는 보고 본문으로 충분하다(brief가 파일을 요구하지 않으면). 8. 소유자 결정 목록을 쓴다: 항목 · 선택지 · 권하는 안과 이유 · 정할 사람. 한 번에 묻는다. diff --git a/scripts/check-docs-exceptions.txt b/scripts/check-docs-exceptions.txt new file mode 100644 index 00000000..a40b3255 --- /dev/null +++ b/scripts/check-docs-exceptions.txt @@ -0,0 +1,228 @@ +# scripts/check-docs.py의 예외 목록. 2026-11-07 기준선이고 줄기만 한다. +# +# - 이 목록에 새 줄을 더하면 검사가 실패한다. 줄마다 check-docs.py의 FROZEN에 지문이 있어야 한다. +# - 번역하거나 고쳐서 더는 걸리지 않는 줄은 지운다. 남겨 두면 검사가 실패한다. +# - 형식: <검사><탭><경로>[<탭><걸린 값>]. 「#」으로 시작하는 줄과 빈 줄은 읽지 않는다. + +# 언어: 아직 한국어로 옮기지 않은 살아 있는 문서와 ADR. 다음 단계(살아 있는 문서 번역, ADR 번역)에서 지운다. +language .github/dependency-vulnerability-policy.md +language .github/pull_request_template.md +language docs/adr/ADR-BUILD-001-one-convention-for-shared-test-code.md +language docs/adr/ADR-GQL-001-graphql-context-and-storage-ownership.md +language docs/adr/ADR-GRPC-001-platform-family-and-registry-shape.md +language docs/adr/ADR-GRPC-002-schema-governance-without-protoc.md +language docs/adr/ADR-GRPC-003-three-axis-execution-evidence.md +language docs/adr/ADR-GRPC-004-retry-ownership-and-durable-idempotency.md +language docs/adr/ADR-GRPC-005-server-streaming-single-writer-and-resume.md +language docs/adr/ADR-GRPC-006-stable-discovery-and-kubernetes-routing.md +language docs/adr/ADR-GRPC-ADV-001-capability-promotion-is-per-capability.md +language docs/adr/ADR-JPA-001-domain-owns-persistence-model.md +language docs/adr/ADR-JPA-002-full-transaction-retry.md +language docs/adr/ADR-JPA-003-completion-unknown.md +language docs/adr/ADR-JPA-004-flyway-schema-source-of-truth.md +language docs/adr/ADR-JPA-005-postgresql-real-contract.md +language docs/adr/ADR-JPA-006-canonical-technical-audit.md +language docs/adr/ADR-MONGO-001-platform-boundary.md +language docs/adr/ADR-MONGO-002-bson-representation.md +language docs/adr/ADR-MONGO-003-transaction-retry.md +language docs/adr/ADR-MONGO-004-index-schema-admin-plane.md +language docs/adr/ADR-MONGO-ADV-001-capability-promotion.md +language docs/adr/ADR-WEB-ADV-001-streaming-is-live-delivery.md +language docs/adr/ADR-WEB-ADV-002-virtual-threads-do-not-remove-admission.md +language docs/adr/ADR-WEB-ADV-003-openapi-32-remains-experimental.md +language docs/adr/ADR-WS-001-platform-as-packages-and-its-boundaries.md +language docs/adr/ADR-WS-002-resume-and-cluster.md +language docs/adr/ADR-WS-003-stomp-and-broker-relay.md +language docs/compatibility/grpc-advanced-support-matrix.md +language docs/compatibility/grpc-support-matrix.md +language docs/fileserver/configuration.md +language docs/fileserver/design-deviations.md +language docs/fileserver/http-contract.md +language docs/fileserver/operations.md +language docs/fileserver/security.md +language docs/fileserver/storage-certification.md +language docs/fileserver/support-matrix.md +language docs/fileserver/upgrade-guide.md +language docs/httpclient/configuration-reference.md +language docs/httpclient/operations.md +language docs/httpclient/performance-baseline.md +language docs/httpclient/release-checklist.md +language docs/httpclient/repository-adaptation.md +language docs/httpclient/retry-and-ambiguity.md +language docs/httpclient/security.md +language docs/httpclient/streaming.md +language docs/httpclient/support-matrix.md +language docs/jpa/batch-write-guide.md +language docs/jpa/entity-mapping-guide.md +language docs/jpa/experimental-promotion-checklist.md +language docs/jpa/experimental-support-matrix.md +language docs/jpa/migration-guide.md +language docs/jpa/observability.md +language docs/jpa/postgresql-extensions.md +language docs/jpa/query-fetch-guide.md +language docs/jpa/repository-adaptation.md +language docs/jpa/runbooks.md +language docs/jpa/security.md +language docs/jpa/support-matrix.md +language docs/jpa/transaction-guide.md +language docs/mongodb/advanced/encryption.md +language docs/mongodb/advanced/multi-tenancy.md +language docs/mongodb/advanced/sharding.md +language docs/mongodb/advanced/signoff/README.md +language docs/mongodb/bson-mapping-guide.md +language docs/mongodb/consistency-transaction-guide.md +language docs/mongodb/document-modeling-guide.md +language docs/mongodb/query-aggregation-guide.md +language docs/mongodb/repository-adaptation.md +language docs/mongodb/runbooks/failover.md +language docs/mongodb/runbooks/unknown-commit.md +language docs/mongodb/schema-index-migration-guide.md +language docs/mongodb/security-observability.md +language docs/mongodb/support-matrix.md +language docs/notification/adr/NOTIF-ADR-001-durable-acceptance.md +language docs/notification/adr/NOTIF-ADR-002-event-ledger-projection.md +language docs/notification/adr/NOTIF-ADR-003-ambiguous-submission.md +language docs/notification/adr/NOTIF-ADR-004-fcm-fid-primary.md +language docs/notification/at-rest-threat-model.md +language docs/notification/callback-reconciliation.md +language docs/notification/configuration-reference.md +language docs/notification/delivery-evidence.md +language docs/notification/migration-guide.md +language docs/notification/module-mapping.md +language docs/notification/operations.md +language docs/notification/provider-runbooks.md +language docs/notification/security-privacy.md +language docs/notification/support-matrix.md +language docs/observability/log-fields.md +language docs/redis/command-policy.md +language docs/redis/operations.md +language docs/redis/support-matrix.md +language docs/redis/upgrade-guide.md +language docs/runbooks/adapter-adapter-disabled.md +language docs/runbooks/auth-audience-mismatch.md +language docs/runbooks/auth-claim-mapping-failed.md +language docs/runbooks/auth-issuer-mismatch.md +language docs/runbooks/auth-jwks-unavailable.md +language docs/runbooks/auth-kid-unknown.md +language docs/runbooks/auth-public-path-misconfiguration.md +language docs/runbooks/auth-token-expired.md +language docs/runbooks/auth-token-invalid-signature.md +language docs/runbooks/auth-token-malformed.md +language docs/runbooks/auth-token-missing.md +language docs/runbooks/authz-insufficient-permission.md +language docs/runbooks/authz-tenant-mismatch.md +language docs/runbooks/cache-stampede-lock-timeout.md +language docs/runbooks/cache-unavailable.md +language docs/runbooks/db-deadlock.md +language docs/runbooks/db-idle-in-tx-timeout.md +language docs/runbooks/db-query-canceled.md +language docs/runbooks/db-serialization-failure.md +language docs/runbooks/db-unavailable.md +language docs/runbooks/dependency-4xx-client.md +language docs/runbooks/dependency-5xx-server.md +language docs/runbooks/dependency-circuit-open.md +language docs/runbooks/dependency-connect-failed.md +language docs/runbooks/dependency-dns-failed.md +language docs/runbooks/dependency-timeout.md +language docs/runbooks/file-download-streaming-failure.md +language docs/runbooks/grpc-advanced-capabilities.md +language docs/runbooks/grpc-platform-operations.md +language docs/runbooks/idempotency-unavailable.md +language docs/runbooks/lock-acquisition-timeout.md +language docs/runbooks/management-actuator-forbidden.md +language docs/runbooks/migration-failed.md +language docs/runbooks/runtime-jvm-oom.md +language docs/runbooks/startup-profile-mismatch.md +language docs/runbooks/startup-required-adapter-disabled.md +language docs/runbooks/startup-validation-failed.md +language docs/runbooks/template.md +language docs/storage-capability-boundary.md +language docs/web/advanced-capabilities.md +language docs/web/openapi-32-compatibility.md +language docs/web/patch-contract.md +language docs/web/repository-adaptation.md +language docs/web/runbook.md +language docs/web/streaming-contract.md +language docs/web/virtual-thread-profile.md +language docs/websocket/runbook.md +language infra/httpclient/README.md +language infra/httpclient/oauth2/README.md +language infra/httpclient/proxy/README.md +language infra/httpclient/tls/README.md +language infra/jpa/postgres/README.md +language infra/keycloak/README.md +language infra/messaging/tls/README.md +language infra/redis-sdk/README.md +language infra/redis-sdk/acl/README.md +language src/adapter/inbound/messaging/CLAUDE.md +language src/adapter/inbound/web-advanced/CLAUDE.md +language src/adapter/inbound/web/CLAUDE.md +language src/adapter/inbound/websocket/CLAUDE.md +language src/adapter/outbound/cache-redis/CLAUDE.md +language src/adapter/outbound/cache-redis/README.md +language src/adapter/outbound/fileserver/CLAUDE.md +language src/adapter/outbound/fileserver/README.md +language src/adapter/outbound/httpclient/CLAUDE.md +language src/adapter/outbound/httpclient/README.md +language src/adapter/outbound/identifier/CLAUDE.md +language src/adapter/outbound/messaging-kafka/CLAUDE.md +language src/adapter/outbound/messaging/CLAUDE.md +language src/adapter/outbound/notification/CLAUDE.md +language src/adapter/outbound/objectstorage/CLAUDE.md +language src/adapter/outbound/objectstorage/README.md +language src/adapter/outbound/persistence-fileserver/CLAUDE.md +language src/adapter/outbound/persistence-jpa/CLAUDE.md +language src/adapter/outbound/persistence-mongo/CLAUDE.md +language src/adapter/outbound/persistence-notification/CLAUDE.md +language src/adapter/outbound/redis-sdk/README.md +language src/adapter/outbound/support/CLAUDE.md +language src/app-bootstrap/CLAUDE.md +language src/app-bootstrap/src/test/resources/developer-experience/broken-readme.md +language src/application-core/CLAUDE.md +language src/build-logic/README.md +language src/composition/outbox-relay/CLAUDE.md +language src/config/architecture/README.md +language src/domain-core/CLAUDE.md +language src/optional-platforms/README.md +language src/sample-portfolio/CLAUDE.md +language src/shared-contract/CLAUDE.md + +# 참조: 지금 트리·registry에 없는 경로. 고치거나 「> 이력」 인용 블록으로 옮기면 지운다. +reference AGENTS.md src/build-tools/ +reference docs/mongodb/consumer-leaf-guide.md :adapter:outbound:persistence-note:check +reference docs/web/http-contract.md docs/architecture/backend-api-and-server-state-contract.md +reference docs/work/operate.md :a:test +reference docs/work/operate.md :b:test +reference src/README.md .github/ci-gate-matrix.yml +reference src/README.md .github/scripts/verify-gate-matrix.sh + +# 숫자: 정본(src/gradle/libs.versions.toml, registry)이 정하는 값을 복사한 곳. 정본을 가리키게 고치면 지운다. +number docs/compatibility/grpc-support-matrix.md Spring Boot 4.0.8 +number docs/httpclient/repository-adaptation.md 19 leaf +number docs/httpclient/repository-adaptation.md Spring Boot 4.0.8 +number docs/jpa/repository-adaptation.md 19 leaf +number docs/jpa/repository-adaptation.md Spring Boot 4.0.8 +number docs/manual/01-generator.md 5 leaf +number docs/mongodb/repository-adaptation.md 19 leaf +number docs/mongodb/repository-adaptation.md Spring Boot 4.0.8 +number src/adapter/inbound/graphql/CLAUDE.md Spring Boot 4.0.0 +number src/adapter/inbound/graphql/README.md 19개 leaf +number src/adapter/inbound/graphql/README.md 24개 leaf +number src/adapter/inbound/graphql/README.md 43개 leaf +number src/adapter/inbound/grpc/CLAUDE.md Spring Boot 4.0.0 +number src/adapter/inbound/web/CLAUDE.md Spring Boot 4.0.0 +number src/adapter/inbound/websocket/CLAUDE.md Spring Boot 4.0.8 +number src/adapter/outbound/cache-redis/CLAUDE.md Spring Boot 4.0.0 +number src/adapter/outbound/fileserver/CLAUDE.md Spring Boot 4.0.0 +number src/adapter/outbound/httpclient/CLAUDE.md Spring Boot 4.0.0 +number src/adapter/outbound/identifier/CLAUDE.md Spring Boot 4.0.8 +number src/adapter/outbound/messaging/CLAUDE.md Spring Boot 4.0.8 +number src/adapter/outbound/notification/CLAUDE.md Spring Boot 4.0.0 +number src/adapter/outbound/objectstorage/CLAUDE.md Spring Boot 4.0.0 +number src/adapter/outbound/persistence-jpa/CLAUDE.md Spring Boot 4.0.0 +number src/adapter/outbound/persistence-mongo/CLAUDE.md Spring Boot 4.0.0 +number src/adapter/outbound/support/CLAUDE.md Spring Boot 4.0.0 +number src/app-bootstrap/CLAUDE.md Spring Boot 4.0.0 +number src/domain-core/CLAUDE.md Spring Boot 4.0.0 +number src/sample-portfolio/CLAUDE.md Spring Boot 4.0.0 +number src/shared-contract/CLAUDE.md Spring Boot 4.0.0 diff --git a/scripts/check-docs.py b/scripts/check-docs.py new file mode 100755 index 00000000..1b83b9f1 --- /dev/null +++ b/scripts/check-docs.py @@ -0,0 +1,543 @@ +#!/usr/bin/env python3 +"""문서 검사 넷: 언어, 기록의 머리 블록, 참조, 복사한 숫자. 하나라도 걸리면 rc=1이다. + +규칙의 정본은 design-docs `conventions/docs-system.md`이고, 이 repo의 적용은 `docs/README.md` +「문서 수명과 언어」다. 이 스크립트는 그 규칙 중 기계로 볼 수 있는 것만 본다. + + language 살아 있는 문서(기록이 아닌 .md)는 한국어다. 판정은 보고 언어 훅 H11과 같다: + 코드·명령·인용·링크·URL·경로·파일 이름을 빼고, 영어 낱말이 3개 이상이고 + 한글 덩어리 비율이 0.3 미만이면 영어다. + head 기록(docs/design, docs/history, docs/adr, docs/notification/adr)의 .md는 맨 위에 + 머리 블록이 있다. 상태는 종류별 고정 어휘, 작성일은 날짜, 요약은 한국어, 현재 + 정본과 대체됨이 가리키는 경로는 지금 있다. + reference 살아 있는 문서의 인라인 코드 안 repo 경로(src/, docs/, scripts/, infra/, .github/로 + 시작)와 Gradle 경로(:a:b)가 지금 트리와 registry에 있다. 코드 블록과 「이력」으로 + 시작하는 인용 블록은 건너뛴다. 마크다운 링크는 lychee와 check-work-docs.py --links가 본다. + number 살아 있는 문서가 정본이 정하는 숫자를 복사하지 않는다: Spring Boot 버전, leaf 개수. + +예외 목록(scripts/check-docs-exceptions.txt)은 줄기만 한다. + - 목록의 줄은 아래 FROZEN(2026-11-07 기준선의 지문)에 있어야 한다. 목록에 새 줄을 더하면 실패한다. + - 목록의 줄이 더는 걸리지 않으면(번역했거나 고쳤으면) 그 줄을 지우라고 실패한다. + - FROZEN을 늘리는 것은 규칙을 바꾸는 일이다. 소유자 결정 없이 하지 않는다. 파일을 옮겨 경로만 + 바뀐 줄은 FROZEN에서 옛 지문을 새 지문으로 바꾼다. 지문은 그 줄(탭 포함)의 sha256 앞 16자다: + python3 -c 'import hashlib,sys; print(hashlib.sha256(sys.argv[1].encode()).hexdigest()[:16])' "<줄>" + + python3 scripts/check-docs.py # 넷 모두 + python3 scripts/check-docs.py --only head # 하나만 (language, head, reference, number) + python3 -m unittest discover -s scripts/tests # 이 검사의 시험 + +Gradle 밖에 둔다. 빌드는 문서를 파싱하지 않는다(AGENTS.md 「Gradle 정책 권위」). +""" + +from __future__ import annotations + +import datetime +import hashlib +import json +import re +import subprocess +import sys +from dataclasses import dataclass +from pathlib import Path + +REPO_ROOT = Path(__file__).resolve().parent.parent +EXCEPTIONS_FILE = "scripts/check-docs-exceptions.txt" +REGISTRY_FILE = "src/config/architecture/modules.json" +CHECKS = ("language", "head", "reference", "number") + +# 기록: 본문은 쓴 때의 원문이다. 머리 블록만 고친다. 종류는 폴더가 정한다. +RECORD_KINDS = [ + ("docs/design/", "설계서"), + ("docs/history/plans/evidence/", "증거"), + ("docs/history/plans/", "계획서"), + ("docs/history/packages/", "납품 패키지"), + ("docs/history/evidence/", "증거"), + ("docs/history/study/", "학습 문서"), + ("docs/adr/", "결정 기록"), + ("docs/notification/adr/", "결정 기록"), +] +# 리뷰도 기록이다. 머리 블록은 아직 요구하지 않는다(docs/README.md). +NOT_LIVING = ("docs/design/", "docs/history/", "docs/reviews/") +DECISION_PREFIXES = ("docs/adr/", "docs/notification/adr/") +# 살아 있는 문서 중 지운 것을 일부러 적는 곳: 제거 표, 파생 서비스용 변경 안내, 매뉴얼 규칙의 근거 기록. +# 참조·숫자 검사는 이 문서들을 보지 않는다(docs/README.md 「문서와 코드를 같은 변경에서 고친다」). +HISTORY_HOLDERS = ("docs/capability-status.md", "docs/upgrade/", "docs/work/evidence.md") + +STATUS = { + "설계서": ("제안", "채택", "구현됨", "보류", "폐기", "대체됨", "확인 안 함"), + "결정 기록": ("제안", "채택", "채택(보완)", "폐기", "대체됨"), + "계획서": ("실행 중", "끝남", "중단", "대체됨", "확인 안 함"), + "납품 패키지": ("보관",), + "증거": ("보관",), + "학습 문서": ("보관",), +} +HEAD_START = "" +HEAD_END = "" +RECORD_LABEL = "> **기록 · {kind}** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다." +DECISION_LABEL = "> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다." +HEAD_FIELDS = ("상태", "작성일", "요약", "현재 정본") +HEAD_OPTIONAL = ("대체", "대체됨") +HEAD_SEARCH_LINES = 20 + +# 2026-11-07 기준선. 예외 목록의 줄마다 sha256 앞 16자. 늘리지 않는다(맨 위 설명). +FROZEN: frozenset[str] = frozenset({ + "0176963415821bbe", "01984fd96d72b997", "02810bf817c5098f", "02f77e3cc483fa7b", "05fff3c3ff8a5c9a", + "06ea362843468b89", "0767d62996355ba0", "077f1849fe8bebcc", "07f88b24645a4899", "09f6eb7c3c494379", + "0a929e243076b4cb", "0d60ec2d41d698e3", "0d9db88d1d98c32b", "0f84458cb40e7c5e", "10894a287a405274", + "110ff8adc628d4e9", "115eed80f3bb629c", "14121ef25eb4aa46", "150219e901d062f4", "199044717780f929", + "1adc480d397a24fc", "1aedb5c86be16e62", "1ef3eec4c410622e", "1f3199d6bef7b3ab", "20a46563da0c570d", + "234a0dffc4f308bf", "23aa784e28c7f730", "24e61cd8377137f1", "26cdb5786cd3cef8", "26f59b7362b9e68d", + "29fa254236927dae", "2a0c27bb25080cdb", "2aa755121374e148", "2bcc75d4e1ebaa5d", "2e77660bd44c1d2c", + "2e7d24cb488ae4f9", "30c75a928243de75", "354c37493e90b01b", "3e867d0b440f18f5", "3fe449c9eca66d87", + "3ff905af6cc2df16", "4053b182a2b89223", "41f268d8aa836143", "4347c5b0dd84ec9b", "449fc1cac0f9380f", + "457310fef9d100a6", "4611a0bfd81bf42c", "462a63de89507bc6", "468248c165ce65f0", "47c9a2b490ceae84", + "4866a2abc9be3133", "48ca99496ac8265e", "494b23454cfaf902", "49d560912ccd3bd6", "49ee572590d74921", + "4c3afe5f9f4265d3", "4cef6042d25d7ce2", "4f4516913c6de5d6", "4f9b0fa57d925ddc", "50cecf0fd2f1ed1f", + "511ed51b27f98b9c", "52879b9f3cbdd66f", "52d9b8b42edf92c5", "52dd5ae3e9bfef22", "53f304d4f21e321e", + "5503b8002ae2673f", "55397a6480705e90", "561988b22b65f79f", "5640b6d1a24b9ad6", "56d9c8bc2e2d7a01", + "570b7b7be5396079", "57603aa52f880d03", "57c4df2758097604", "59e238f79e31e3db", "5acb4cacd9aa7a71", + "5b1f0d60cdd91b33", "5b783704ccce90b9", "5b833f85df94c6fd", "5caaf9a02506595e", "5cd2de3ab18314a9", + "5cda11b0371e8b48", "5e17fde0e8281e0b", "61241c19f875d528", "614d8160fecebe42", "62ac6e83f597894a", + "62ae3935928ec875", "62ae5138ca3f54bf", "62e6864d5d950d57", "63887df3233e4e7f", "63bbbd89d07abcc5", + "63d3556d23363430", "6407c8198a2ce80f", "6669b8199b2f15be", "6710e607f9ae6ba2", "6c60928d93ca7831", + "6e57bc847800e849", "6f2fef4ed95b870d", "70f8b4b8cb326639", "7227a51a80d75567", "728afb0024d5da55", + "745fabbdac49b041", "74622ec18c9f9985", "74eab10487ee91a4", "7548695a3a57c058", "76030078f4c446ec", + "7698729bcfd126f7", "77ed807b2db1bdb4", "782bc48fcd75361c", "7846dce0563bde1f", "78b5bea3cfb3f84f", + "7a41c841fa3c71c3", "7b3944471a209cdc", "7ba95fb426152c3b", "814a101266f1e722", "8232460887910a0e", + "82b97043efd185d0", "83b56cb713adb544", "84ebb93c8c137862", "8559d433706ac279", "85e199be8e5a5df5", + "86c327f4147ec696", "8c3417a9291e07cf", "9031db861c91b202", "90697a358931eba2", "9084568d44e608c3", + "945be2a3aaccbb2c", "94c5248d3fe6f83f", "95feaea41a059d9a", "966dd5354d327ba4", "97c036827ae94466", + "97fed7ecb0c23137", "982773d6151ae295", "993631c9efdbaa48", "999cc41aeaa485d9", "9b976d47e8cca045", + "9db89af226707449", "9e9437780d412b86", "9ee05526226dd121", "9f6cb144b5b0013d", "a14aae022e52cabd", + "a2db3c73eea72747", "a6e2e42521f27aa8", "a7b7a83d8e7b5914", "a84c5847e6bc413a", "a9cdf0e474dfa4ca", + "ab9a1c81f4d00b17", "ac208a7edf8e6b9e", "ac524f5b860f4b73", "af6bfc4105841865", "b25dfdea45b42ece", + "b2ee46983b09686b", "b6c96aabf4daba15", "b99ef0dca48e547c", "bc89c106ed0333da", "bd2e62413d04468c", + "bd2edda7ff995e5a", "c0f36dd22b6d1df4", "c1cbe5ed9ccaf41a", "c2e62316bf302721", "c30f7e945ca5204b", + "c446b7882073d116", "c555077d0a4ca6dc", "c5556985dac877fb", "c66938fdb57ac8bd", "c7d3f2a6e0e819c7", + "c86415926ea888fb", "c9147167591ac87f", "c9682c8986bdfa3f", "c9f15a774cbbb296", "c9f895250a7f6b1f", + "ca9ac59c7e4dd0dd", "ccfd7af308666817", "cde221c994e186e9", "d1c59fa1e5fd22ca", "d2c0d56090ffb617", + "d3a72db1fb71eaf6", "d58784f8ae176897", "d88381653e2c64f9", "d934528c9e7966f7", "da73ed73f0ec1dd9", + "da8381da9de5df66", "dd4f9524437dcc45", "dd6384bc82ce9677", "df5a6c2edc20af59", "e076b4232fc136e9", + "e1ada69597a5d6cd", "e1d8a4d6d6bbfb2e", "e2af4a0f5b0957d5", "e313fbfdd61fba0c", "e347453420828b08", + "e368dfa3ca97d4c7", "e3cc20cbd63d0adb", "e4435ba963a1fbef", "e5182c24f72e2747", "e660a27969605244", + "e7dad258cbc844a0", "e97d1ef509983caa", "e997a8c038464efb", "eb66b6c389ec09e4", "ed7764b9ec0265a0", + "ee8e568418c22e81", "ef22d97e0a67bed8", "f0baa883ab5f959d", "f12cb9b454600534", "f135bd1f9697ad4c", + "f166b8797656c86e", "f191a6842f342b74", "f3ea04dd3a66f76a", "f4c93c2e841f1c68", "f4d7edfeee65b0c3", + "f6528fa83345165e", "fa4172e085723211", "fc0c07879a70ce33", "fd706bf633a51444", "fd793c8cfa94f318", + "fe800048b661a783", "ff9a9a9da9aced39", +}) + +# --- 언어 판정: ~/.claude/hooks/guard_report.py의 H11과 같은 규칙(design-docs conventions/delegation-loop.md 11절) +MIN_ENGLISH = 3 +MIN_KOREAN_SHARE = 0.3 +HANGUL = re.compile(r"[가-힣]+") +FENCE = re.compile(r"^[ \t]*(`{3,}|~{3,})") +INLINE = re.compile(r"(`+)(?:(?!\1).)+?\1", re.S) +MDLINK = re.compile(r"\[[^\]\n]*\]\([^)\s]*\)") +URL = re.compile(r"(?:\b[a-z][a-z0-9+.-]*://|\bwww\.)\S+", re.I) +PATHLIKE = re.compile(r"[^\s가-힣]*[/\\][^\s가-힣]*") +FILELIKE = re.compile(r"[^\s가-힣]+\.[A-Za-z]{1,10}(?::\d+)*(?![A-Za-z])") +QUOTED = re.compile(r"\"[^\"\n]*\"|“[^”\n]*”") +TOKEN = re.compile(r"[^\s가-힣]+") +WORD = re.compile(r"^[(\[\"'“‘*_]*[A-Za-z][a-z]*(?:['’][a-z]+)?(?:-[a-z]+)*[)\]\"'”’*_.,;:!?…]*$") + +# --- 참조 +PATH_ROOTS = ("src/", "docs/", "scripts/", "infra/", ".github/") +PLACEHOLDER = re.compile(r"[*?<>{}\[\]$…]|\.\.\.|YYYY|NNN|[가-힣]") +LINE_SUFFIX = re.compile(r"(?::\d+(?:[-,]\d+)*)+$") +# 모든 leaf에 있는 소스 세트 이름(src/test, src/main/java)은 어느 leaf의 것인지 문장이 정한다. +SOURCE_SET = re.compile(r"^src/[A-Za-z]+(?:/(?:java|resources|proto|kotlin|groovy))?/?$") +GRADLE_PATH = re.compile(r"^:[A-Za-z][\w-]*(?::[A-Za-z][\w-]*)+$") +HISTORY_QUOTE = re.compile(r"^\s*>\s*(?:\*\*)?이력") + +# --- 복사한 숫자 +COPIED_NUMBERS = [ + ("Spring Boot 버전", re.compile(r"Spring Boot \d+\.\d+\.\d+")), + ("leaf 개수", re.compile(r"\b\d+\s*개의?\s*leaf|\bleaf\s*\d+\s*개|\b\d+\s+(?:registered\s+)?lea(?:f|ves)\b", + re.I)), +] + + +@dataclass(frozen=True) +class Problem: + check: str + path: str + key: str + message: str + line: int = 0 + + def exception_line(self) -> str: + return "\t".join(part for part in (self.check, self.path, self.key) if part) + + def render(self) -> str: + where = f"{self.path}:{self.line}" if self.line else self.path + return f"[{self.check}] {where}: {self.message}" + + +def fingerprint(line: str) -> str: + return hashlib.sha256(line.encode("utf-8")).hexdigest()[:16] + + +def tracked_markdown(root: Path) -> list[str]: + """Markdown files git knows or would add: tracked plus untracked files that are not ignored.""" + result = subprocess.run( + ["git", "-C", str(root), "ls-files", "-z", "--cached", "--others", "--exclude-standard", "--", "*.md"], + capture_output=True, check=True) + names = {name for name in result.stdout.decode("utf-8").split("\0") if name} + return sorted(name for name in names if (root / name).is_file()) + + +def record_kind(path: str) -> str | None: + for prefix, kind in RECORD_KINDS: + if path.startswith(prefix): + return kind + return None + + +def is_living(path: str) -> bool: + return not path.startswith(NOT_LIVING) + + +def strip_head_block(lines: list[str]) -> list[str]: + if lines and lines[0] == HEAD_START and HEAD_END in lines[:HEAD_SEARCH_LINES]: + return lines[lines.index(HEAD_END) + 1:] + return lines + + +def strip_front_matter(lines: list[str]) -> list[str]: + if lines and lines[0].strip() == "---": + for index in range(1, len(lines)): + if lines[index].strip() == "---": + return lines[index + 1:] + return lines + + +def body_lines(text: str) -> list[str]: + return strip_front_matter(strip_head_block(text.split("\n"))) + + +def prose(text: str) -> str: + """판정에서 뺄 것(코드·명령·인용·링크·URL·경로·파일 이름)을 지운 글. H11의 prose()와 같다.""" + lines, fence = [], None + for line in text.split("\n"): + match = FENCE.match(line) + if fence: + if match and match.group(1)[0] == fence[0] and len(match.group(1)) >= len(fence): + fence = None + continue + if match: + fence = match.group(1) + continue + if not line.lstrip().startswith(("$ ", ">")): + lines.append(line) + text = "\n".join(lines) + for pattern in (INLINE, MDLINK, URL, QUOTED, PATHLIKE, FILELIKE): + text = pattern.sub(" ", text) + return text + + +def language_counts(text: str) -> tuple[int, int]: + cleaned = prose(text) + korean = len(HANGUL.findall(cleaned)) + english = sum(1 for token in TOKEN.findall(cleaned) if WORD.match(token)) + return korean, english + + +def is_english(text: str) -> bool: + korean, english = language_counts(text) + return english >= MIN_ENGLISH and korean / (korean + english) < MIN_KOREAN_SHARE + + +def check_language(root: Path, files: list[str]) -> list[Problem]: + problems = [] + for path in files: + if not is_living(path): + continue + body = "\n".join(body_lines((root / path).read_text(encoding="utf-8"))) + if is_english(body): + korean, english = language_counts(body) + problems.append(Problem("language", path, "", + f"영어 문서다(한글 {korean}, 영어 낱말 {english}). 한국어로 쓴다")) + return problems + + +def head_block(lines: list[str]) -> tuple[list[str], int] | None: + if not lines or lines[0] != HEAD_START: + return None + window = lines[:HEAD_SEARCH_LINES] + if HEAD_END not in window: + return None + end = window.index(HEAD_END) + return lines[1:end], end + + +def backticked_paths(value: str) -> list[str]: + return re.findall(r"`([^`]+)`", value) + + +def check_head(root: Path, files: list[str]) -> list[Problem]: + problems = [] + for path in files: + kind = record_kind(path) + if kind is None: + continue + + def fail(message: str, line: int = 1) -> None: + problems.append(Problem("head", path, "", message, line)) + + lines = (root / path).read_text(encoding="utf-8").split("\n") + found = head_block(lines) + if found is None: + fail(f"맨 위에 머리 블록이 없다. 첫 줄은 `{HEAD_START}`, 블록은 `{HEAD_END}`로 닫는다") + continue + block, _ = found + label = DECISION_LABEL if kind == "결정 기록" else RECORD_LABEL.format(kind=kind) + if not block or block[0] != label: + fail(f"머리 블록 둘째 줄은 「{label}」이다", 2) + fields: dict[str, tuple[str, int]] = {} + for offset, line in enumerate(block[1:], start=3): + if not line.strip(): + continue + match = re.match(r"^- ([^:]+): (.+)$", line) + if not match: + fail(f"머리 블록의 줄은 `- 칸: 값`이다: {line!r}", offset) + continue + name, value = match.group(1).strip(), match.group(2).strip() + if name not in HEAD_FIELDS + HEAD_OPTIONAL: + fail(f"머리 블록에 없는 칸이다: {name}", offset) + elif name in fields: + fail(f"칸이 두 번 나온다: {name}", offset) + else: + fields[name] = (value, offset) + for name in HEAD_FIELDS: + if name not in fields: + fail(f"「{name}」 칸이 없다") + status, at = fields.get("상태", ("", 1)) + if "상태" in fields and status not in STATUS[kind]: + fail(f"{kind}의 상태는 {' · '.join(STATUS[kind])} 중 하나다: {status!r}", at) + written, at = fields.get("작성일", ("", 1)) + if "작성일" in fields: + try: + datetime.date.fromisoformat(written) + except ValueError: + fail(f"작성일은 YYYY-MM-DD다: {written!r}", at) + summary, at = fields.get("요약", ("", 1)) + if "요약" in fields and (not HANGUL.search(summary) or is_english(summary)): + fail("요약은 한국어 한 문장이다", at) + canonical, at = fields.get("현재 정본", ("", 1)) + if "현재 정본" in fields: + targets = backticked_paths(canonical) + if not canonical.startswith("없음") and not targets: + fail("현재 정본은 `경로`(여럿이면 쉼표) 또는 「없음 — 이유」다", at) + for target in targets: + if not (root / target).exists(): + fail(f"현재 정본 경로가 없다: {target}", at) + if status == "대체됨" and "대체됨" not in fields: + fail("상태가 대체됨이면 「대체됨」 칸에 대체한 문서를 적는다") + for name in HEAD_OPTIONAL: + if name in fields: + value, at = fields[name] + targets = backticked_paths(value) + if not targets: + fail(f"「{name}」 칸은 `경로`를 적는다", at) + for target in targets: + if not (root / target).exists(): + fail(f"「{name}」 경로가 없다: {target}", at) + return problems + + +def inline_spans(lines: list[str]) -> list[tuple[int, str]]: + """(줄 번호, 인라인 코드) — 코드 블록과 「이력」 인용 블록 밖에서만.""" + spans, fence, history = [], None, False + for number, line in enumerate(lines, start=1): + match = FENCE.match(line) + if fence: + if match and match.group(1)[0] == fence[0] and len(match.group(1)) >= len(fence): + fence = None + continue + if match: + fence = match.group(1) + continue + quoted = line.lstrip().startswith(">") + if quoted and HISTORY_QUOTE.match(line): + history = True + elif not quoted: + history = False + if history: + continue + for found in INLINE.finditer(line): + spans.append((number, found.group(0).strip("`").strip())) + return spans + + +def registry_projects(root: Path) -> set[str]: + registry = root / REGISTRY_FILE + if not registry.is_file(): + return set() + modules = json.loads(registry.read_text(encoding="utf-8")).get("modules", []) + projects: set[str] = set() + for module in modules: + parts = module["gradle_path"].split(":")[1:] + for end in range(1, len(parts) + 1): + projects.add(":" + ":".join(parts[:end])) + return projects + + +def path_candidate(token: str) -> str | None: + token = token.strip().strip("'\"()[],;") + if token.startswith("./"): + token = token[2:] + if not token.startswith(PATH_ROOTS) or PLACEHOLDER.search(token) or "://" in token: + return None + token = LINE_SUFFIX.sub("", token.split("#", 1)[0]).rstrip(".:") + return token or None + + +def resolves(root: Path, document: str, target: str) -> bool: + if (root / target).exists(): + return True + # src/main/... in a leaf document is written relative to that leaf. + folder = (root / document).parent + while folder != root and root in folder.parents: + if (folder / target).exists(): + return True + folder = folder.parent + return False + + +def ignored(root: Path, paths: set[str]) -> set[str]: + if not paths: + return set() + result = subprocess.run(["git", "-C", str(root), "check-ignore", "--no-index", "--stdin"], + input="\n".join(sorted(paths)).encode("utf-8"), capture_output=True) + return set(result.stdout.decode("utf-8").split("\n")) - {""} + + +def checked_for_drift(path: str) -> bool: + return is_living(path) and not path.startswith(DECISION_PREFIXES) and not path.startswith(HISTORY_HOLDERS) + + +def path_suffixes(root: Path) -> set[str]: + """Every trailing part of every file and folder git knows: `src/test/resources/x.sha256` written in a + manual about any leaf resolves when some leaf has it.""" + result = subprocess.run( + ["git", "-C", str(root), "ls-files", "-z", "--cached", "--others", "--exclude-standard"], + capture_output=True, check=True) + suffixes: set[str] = set() + for name in result.stdout.decode("utf-8").split("\0"): + parts = name.split("/") + for end in range(1, len(parts) + 1): + for start in range(end): + suffixes.add("/".join(parts[start:end])) + return suffixes + + +def check_reference(root: Path, files: list[str]) -> list[Problem]: + projects = registry_projects(root) + missing: list[tuple[str, int, str]] = [] + problems = [] + for path in files: + if not checked_for_drift(path): + continue + lines = body_lines((root / path).read_text(encoding="utf-8")) + offset = len((root / path).read_text(encoding="utf-8").split("\n")) - len(lines) + seen: set[str] = set() + for number, span in inline_spans(lines): + for token in span.split(): + gradle = token.strip(".,;'\"()") + if GRADLE_PATH.match(gradle): + parent = gradle.rsplit(":", 1)[0] + if projects and gradle not in projects and parent not in projects and gradle not in seen: + seen.add(gradle) + problems.append(Problem("reference", path, gradle, + f"registry에 없는 Gradle 경로다: {gradle}", number + offset)) + continue + target = path_candidate(token) + if target and SOURCE_SET.match(target): + continue + if target and target not in seen and not resolves(root, path, target): + seen.add(target) + missing.append((path, number + offset, target)) + skip = ignored(root, {target for _, _, target in missing}) + if missing: + skip |= path_suffixes(root) + for path, number, target in missing: + if target.rstrip("/") not in skip and target not in skip: + problems.append(Problem("reference", path, target, f"없는 경로다: {target}", number)) + return problems + + +def check_number(root: Path, files: list[str]) -> list[Problem]: + problems = [] + for path in files: + if not checked_for_drift(path): + continue + seen: set[str] = set() + for number, line in enumerate((root / path).read_text(encoding="utf-8").split("\n"), start=1): + for label, pattern in COPIED_NUMBERS: + for match in pattern.finditer(line): + text = match.group(0) + if text not in seen: + seen.add(text) + problems.append(Problem("number", path, text, + f"{label}를 복사했다: {text!r}. 정본을 가리킨다", number)) + return problems + + +RUNNERS = {"language": check_language, "head": check_head, "reference": check_reference, "number": check_number} + + +def read_exceptions(text: str) -> list[str]: + return [line for line in text.split("\n") if line.strip() and not line.startswith("#")] + + +def run(root: Path, only: tuple[str, ...] = CHECKS, exceptions: str | None = None, + frozen: frozenset[str] = FROZEN) -> tuple[list[str], list[str]]: + """(실패 줄, 보고 줄). 예외 목록을 적용한 뒤의 결과다.""" + if exceptions is None: + exceptions_path = root / EXCEPTIONS_FILE + exceptions = exceptions_path.read_text(encoding="utf-8") if exceptions_path.is_file() else "" + allowed = read_exceptions(exceptions) + files = tracked_markdown(root) + errors: list[str] = [] + report: list[str] = [] + for entry in allowed: + if fingerprint(entry) not in frozen: + errors.append(f"[exceptions] {EXCEPTIONS_FILE}: 기준선에 없는 예외다. 예외 목록은 늘지 않는다: {entry!r}") + allowed_set = set(allowed) + for check in only: + problems = RUNNERS[check](root, files) + hit = {problem.exception_line() for problem in problems} + unexcused = [problem for problem in problems if problem.exception_line() not in allowed_set] + stale = [entry for entry in allowed if entry.split("\t", 1)[0] == check and entry not in hit] + errors += [problem.render() for problem in unexcused] + errors += [f"[exceptions] {EXCEPTIONS_FILE}: 더는 걸리지 않는다. 이 줄을 지운다: {entry!r}" for entry in stale] + excused = len(problems) - len(unexcused) + report.append(f"{check}: 걸림 {len(problems)}, 예외 {excused}, 실패 {len(unexcused)}") + return errors, report + + +def main(argv: list[str]) -> int: + only = CHECKS + if argv[:1] == ["--only"]: + if len(argv) != 2 or argv[1] not in CHECKS: + print(f"usage: check-docs.py [--only {'|'.join(CHECKS)}]", file=sys.stderr) + return 2 + only = (argv[1],) + elif argv: + print(f"usage: check-docs.py [--only {'|'.join(CHECKS)}]", file=sys.stderr) + return 2 + errors, report = run(REPO_ROOT, only) + for line in report: + print(line) + if errors: + print(f"\nFAILED: {len(errors)}", file=sys.stderr) + for error in errors: + print(f" {error}", file=sys.stderr) + return 1 + print("\nOK") + return 0 + + +if __name__ == "__main__": + sys.exit(main(sys.argv[1:])) diff --git a/scripts/tests/test_check_docs.py b/scripts/tests/test_check_docs.py new file mode 100644 index 00000000..1f9702f4 --- /dev/null +++ b/scripts/tests/test_check_docs.py @@ -0,0 +1,252 @@ +"""scripts/check-docs.py의 시험. 고장 낸 입력에서 실패하고, 맞는 입력에서 통과하는지 본다. + + python3 -m unittest discover -s scripts/tests +""" + +from __future__ import annotations + +import importlib.util +import json +import subprocess +import sys +import tempfile +import unittest +from pathlib import Path + +SCRIPTS = Path(__file__).resolve().parent.parent +_spec = importlib.util.spec_from_file_location("check_docs", SCRIPTS / "check-docs.py") +check_docs = importlib.util.module_from_spec(_spec) +sys.modules["check_docs"] = check_docs +_spec.loader.exec_module(check_docs) + +KOREAN = "이 문서는 한국어로 쓴 살아 있는 문서다. 코드와 같은 변경에서 고친다.\n" +ENGLISH = "This document is written in English and explains how the module works in detail.\n" + + +def head(kind: str = "설계서", status: str = "구현됨", written: str = "2026-08-11", + summary: str = "한국어로 쓴 요약 한 문장이다.", canonical: str = "`docs/live.md`", + extra: str = "", label: str | None = None) -> str: + if label is None: + label = check_docs.DECISION_LABEL if kind == "결정 기록" else check_docs.RECORD_LABEL.format(kind=kind) + lines = [check_docs.HEAD_START, label, "", f"- 상태: {status}", f"- 작성일: {written}", + f"- 요약: {summary}", f"- 현재 정본: {canonical}"] + if extra: + lines.append(extra) + lines += [check_docs.HEAD_END, ""] + return "\n".join(lines) + "\n" + + +class Repository: + """A throwaway git working tree with a registry, so the checker sees what git sees.""" + + def __init__(self) -> None: + self._directory = tempfile.TemporaryDirectory() + self.root = Path(self._directory.name) + subprocess.run(["git", "init", "-q", str(self.root)], check=True) + self.write("docs/live.md", KOREAN) + self.write(check_docs.REGISTRY_FILE, json.dumps({"modules": [ + {"id": "app", "gradle_path": ":app", "source_path": "src/app"}, + {"id": "adapter-web", "gradle_path": ":adapter:inbound:web", "source_path": "src/adapter/inbound/web"}, + ]})) + + def write(self, path: str, text: str) -> None: + target = self.root / path + target.parent.mkdir(parents=True, exist_ok=True) + target.write_text(text, encoding="utf-8") + + def run(self, only: tuple[str, ...] = check_docs.CHECKS, exceptions: str = "", + frozen: frozenset[str] | None = None) -> list[str]: + if frozen is None: + frozen = frozenset(check_docs.fingerprint(line) for line in check_docs.read_exceptions(exceptions)) + errors, _ = check_docs.run(self.root, only, exceptions=exceptions, frozen=frozen) + return errors + + def close(self) -> None: + self._directory.cleanup() + + +class RepositoryTestCase(unittest.TestCase): + def setUp(self) -> None: + self.repo = Repository() + self.addCleanup(self.repo.close) + + def assertFailsWith(self, errors: list[str], fragment: str) -> None: + self.assertTrue(any(fragment in error for error in errors), f"no error with {fragment!r}: {errors}") + + +class LanguageTest(RepositoryTestCase): + def test_an_english_living_document_fails(self) -> None: + self.repo.write("docs/guide.md", "# Guide\n\n" + ENGLISH * 3) + self.assertFailsWith(self.repo.run(("language",)), "docs/guide.md: 영어 문서다") + + def test_a_korean_living_document_passes(self) -> None: + self.repo.write("src/app/README.md", "# 앱\n\n" + KOREAN * 3) + self.assertEqual(self.repo.run(("language",)), []) + + def test_code_commands_and_paths_do_not_make_a_korean_document_english(self) -> None: + code = "```bash\n" + "./gradlew :app:test --console=plain and many more english words here\n" * 20 + "```\n" + self.repo.write("docs/guide.md", "# 안내\n\n" + KOREAN + code + "`src/app/Foo.java`를 본다.\n") + self.assertEqual(self.repo.run(("language",)), []) + + def test_a_record_body_keeps_its_original_language(self) -> None: + self.repo.write("docs/design/2026-08-11-x-design.md", head() + "# Design\n\n" + ENGLISH * 3) + self.assertEqual(self.repo.run(("language",)), []) + + def test_an_english_decision_record_body_fails(self) -> None: + self.repo.write("docs/adr/ADR-X-001.md", head(kind="결정 기록", status="채택") + "# ADR\n\n" + ENGLISH * 3) + self.assertFailsWith(self.repo.run(("language",)), "docs/adr/ADR-X-001.md: 영어 문서다") + + +class ExceptionListTest(RepositoryTestCase): + LINE = "language\tdocs/guide.md" + + def test_a_frozen_exception_excuses_its_document(self) -> None: + self.repo.write("docs/guide.md", ENGLISH * 3) + self.assertEqual(self.repo.run(("language",), exceptions=self.LINE + "\n"), []) + + def test_adding_a_line_to_the_exception_list_fails(self) -> None: + self.repo.write("docs/guide.md", ENGLISH * 3) + errors = self.repo.run(("language",), exceptions=self.LINE + "\n", frozen=frozenset()) + self.assertFailsWith(errors, "기준선에 없는 예외다") + + def test_an_exception_that_no_longer_fails_must_be_removed(self) -> None: + self.repo.write("docs/guide.md", KOREAN * 3) + self.assertFailsWith(self.repo.run(("language",), exceptions=self.LINE + "\n"), "더는 걸리지 않는다") + + def test_an_exception_for_one_check_does_not_excuse_another(self) -> None: + self.repo.write("docs/guide.md", "`docs/gone.md`를 본다. " + KOREAN) + errors = self.repo.run(("reference",), exceptions="number\tdocs/guide.md\tdocs/gone.md\n") + self.assertFailsWith(errors, "없는 경로다: docs/gone.md") + + def test_every_line_of_the_real_exception_list_is_in_the_frozen_baseline(self) -> None: + text = (SCRIPTS.parent / check_docs.EXCEPTIONS_FILE).read_text(encoding="utf-8") + outside = [line for line in check_docs.read_exceptions(text) + if check_docs.fingerprint(line) not in check_docs.FROZEN] + self.assertEqual(outside, []) + + def test_a_new_line_in_the_real_exception_list_is_not_in_the_frozen_baseline(self) -> None: + self.assertNotIn(check_docs.fingerprint("language\tdocs/brand-new-english.md"), check_docs.FROZEN) + + +class HeadBlockTest(RepositoryTestCase): + PATH = "docs/design/2026-08-11-x-design.md" + + def errors_for(self, text: str) -> list[str]: + self.repo.write(self.PATH, text + "# Original\n\nbody\n") + return self.repo.run(("head",)) + + def test_a_complete_head_block_passes(self) -> None: + self.assertEqual(self.errors_for(head()), []) + + def test_canonical_none_with_a_reason_passes(self) -> None: + self.assertEqual(self.errors_for(head(canonical="없음 — 지운 기능이다")), []) + + def test_a_record_without_a_head_block_fails(self) -> None: + self.assertFailsWith(self.errors_for(""), "맨 위에 머리 블록이 없다") + + def test_a_status_outside_the_vocabulary_fails(self) -> None: + self.assertFailsWith(self.errors_for(head(status="Accepted")), "설계서의 상태는") + + def test_a_plan_status_on_a_decision_record_fails(self) -> None: + self.repo.write("docs/adr/ADR-X-001.md", head(kind="결정 기록", status="끝남") + "# ADR\n") + self.assertFailsWith(self.repo.run(("head",)), "결정 기록의 상태는") + + def test_a_malformed_date_fails(self) -> None: + self.assertFailsWith(self.errors_for(head(written="2026-13-01")), "작성일은 YYYY-MM-DD다") + + def test_an_english_summary_fails(self) -> None: + self.assertFailsWith(self.errors_for(head(summary="A design for the module boundary.")), "요약은 한국어") + + def test_a_canonical_path_that_does_not_exist_fails(self) -> None: + self.assertFailsWith(self.errors_for(head(canonical="`docs/missing.md`")), "현재 정본 경로가 없다") + + def test_a_canonical_value_without_a_path_fails(self) -> None: + self.assertFailsWith(self.errors_for(head(canonical="jpa 문서")), "현재 정본은") + + def test_superseded_without_its_replacement_fails(self) -> None: + self.assertFailsWith(self.errors_for(head(status="대체됨")), "「대체됨」 칸에 대체한 문서") + + def test_superseded_with_its_replacement_passes(self) -> None: + self.assertEqual(self.errors_for(head(status="대체됨", extra="- 대체됨: `docs/live.md`")), []) + + def test_a_wrong_kind_label_fails(self) -> None: + self.assertFailsWith(self.errors_for(head(label="> **기록 · 계획서** 다른 종류다.")), "머리 블록 둘째 줄은") + + def test_an_unknown_field_fails(self) -> None: + self.assertFailsWith(self.errors_for(head(extra="- 담당: 누군가")), "머리 블록에 없는 칸이다") + + def test_the_kind_follows_the_folder(self) -> None: + self.repo.write("docs/history/plans/evidence/x.md", head(kind="증거", status="보관") + "# Evidence\n") + self.assertEqual(self.repo.run(("head",)), []) + + +class ReferenceTest(RepositoryTestCase): + def errors_for(self, text: str, path: str = "docs/guide.md") -> list[str]: + self.repo.write(path, KOREAN + text) + return self.repo.run(("reference",)) + + def test_a_missing_repository_path_fails(self) -> None: + self.assertFailsWith(self.errors_for("`docs/gone.md`를 읽는다.\n"), "없는 경로다: docs/gone.md") + + def test_an_existing_path_with_a_line_number_passes(self) -> None: + self.assertEqual(self.errors_for("`docs/live.md:12`를 읽는다.\n"), []) + + def test_a_path_inside_a_command_is_checked(self) -> None: + self.assertFailsWith(self.errors_for("`python3 scripts/gone.py --all`을 돌린다.\n"), "scripts/gone.py") + + def test_fenced_code_is_skipped(self) -> None: + self.assertEqual(self.errors_for("```text\n`docs/gone.md`\n```\n"), []) + + def test_a_history_quote_is_skipped(self) -> None: + self.assertEqual(self.errors_for("> 이력: `docs/gone.md`는 2026-09-25에 지웠다.\n> `src/gone/` 도.\n"), []) + + def test_a_placeholder_path_is_skipped(self) -> None: + self.assertEqual(self.errors_for("`docs/reviews/<폴더>`와 `src/**/CLAUDE.md`를 본다.\n"), []) + + def test_a_leaf_relative_source_path_resolves_through_some_leaf(self) -> None: + self.repo.write("src/app/src/test/resources/contracts/x.sha256", "x") + self.assertEqual(self.errors_for("각 leaf의 `src/test/resources/contracts/x.sha256`을 본다.\n"), []) + + def test_a_source_set_name_every_leaf_has_is_skipped(self) -> None: + self.assertEqual(self.errors_for("테스트는 각 leaf의 `src/test`와 `src/main/java/` 옆에 둔다.\n"), []) + + def test_a_gradle_path_outside_the_registry_fails(self) -> None: + self.assertFailsWith(self.errors_for("`./gradlew :sample:check`를 돌린다.\n"), "registry에 없는 Gradle 경로다: :sample:check") + + def test_a_task_of_a_registered_project_passes(self) -> None: + self.assertEqual(self.errors_for("`./gradlew :adapter:inbound:web:test`와 `:app:check`를 돌린다.\n"), []) + + def test_the_removal_table_is_not_checked(self) -> None: + self.assertEqual(self.errors_for("`src/gone/Old.java`를 지웠다.\n", path="docs/capability-status.md"), []) + + def test_a_record_is_not_checked(self) -> None: + self.repo.write("docs/design/2026-08-11-x-design.md", head() + "`docs/gone.md`\n") + self.assertEqual(self.repo.run(("reference",)), []) + + +class NumberTest(RepositoryTestCase): + def errors_for(self, text: str) -> list[str]: + self.repo.write("src/app/CLAUDE.md", KOREAN + text) + return self.repo.run(("number",)) + + def test_a_copied_spring_boot_version_fails(self) -> None: + self.assertFailsWith(self.errors_for("Runtime baseline: Spring Boot 4.0.8.\n"), "'Spring Boot 4.0.8'") + + def test_a_major_version_passes(self) -> None: + self.assertEqual(self.errors_for("Spring Boot 4 위에서 돈다.\n"), []) + + def test_a_copied_leaf_count_fails(self) -> None: + self.assertFailsWith(self.errors_for("registry는 leaf 65개를 가진다.\n"), "leaf 개수") + self.assertFailsWith(self.errors_for("declares exactly 19 leaf identities.\n"), "leaf 개수") + + def test_a_word_count_of_leaves_passes(self) -> None: + self.assertEqual(self.errors_for("leaf 하나를 고른다.\n"), []) + + +class CommandLineTest(unittest.TestCase): + def test_an_unknown_check_is_a_usage_error(self) -> None: + self.assertEqual(check_docs.main(["--only", "spelling"]), 2) + + +if __name__ == "__main__": + unittest.main() diff --git a/src/README.md b/src/README.md index 4e35f4f9..d51064ec 100644 --- a/src/README.md +++ b/src/README.md @@ -42,7 +42,7 @@ Checkstyle은 **포매터가 표현할 수 없는 것만** — 네이밍과 몇 수백 줄짜리 커스텀 YAML 파서), `verifyReadmeCommands`·`verifyDocumentedLeafCount`· `verifyRunbookReferences`·`verifyTestSourceSetRegistry`(문서 파서), `verifyConfigurationPropertiesProcessor`(`ca.spring-config` convention plugin이 대체). -근거는 `docs/superpowers/specs/2026-09-16-verification-surface-reduction-design.md`. +근거는 `docs/design/2026-09-16-verification-surface-reduction-design.md`. ### Local bootstrap diff --git a/src/adapter/inbound/web/README.md b/src/adapter/inbound/web/README.md index 2fdd88d3..134acd95 100644 --- a/src/adapter/inbound/web/README.md +++ b/src/adapter/inbound/web/README.md @@ -118,7 +118,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML - **로그 레벨.** 4xx(토큰 누락·만료·서명·issuer·audience·kid 실패, 권한 부족)는 호출자 쪽 실패라 WARN이다. 5xx(`AUTH_JWKS_UNAVAILABLE` 503, `INTERNAL_AUTH_MISCONFIGURATION` 500)는 서버 쪽 고장이라 ERROR다. 다른 경로가 5xx를 ERROR로 남기는 규칙(shared-contract `ServerFailureLog`)과 같다. 레벨은 오류 코드 레지스트리의 - 칸이 아니라 이 코드가 정한다(설계 메모 `docs/superpowers/specs/2026-11-06-error-code-log-level-design.md`). + 칸이 아니라 이 코드가 정한다(설계 메모 `docs/design/2026-11-06-error-code-log-level-design.md`). - **WWW-Authenticate(RFC 9110 §15.5.2).** 401 응답은 반드시 WWW-Authenticate 헤더를 갖되, `error_description` 으로 issuer/token 세부가 새지 않도록 최소한으로 유지한다. diff --git a/src/adapter/outbound/cache-redis/CLAUDE.md b/src/adapter/outbound/cache-redis/CLAUDE.md index 9f56d803..79842ed2 100644 --- a/src/adapter/outbound/cache-redis/CLAUDE.md +++ b/src/adapter/outbound/cache-redis/CLAUDE.md @@ -53,9 +53,9 @@ nothing of the SDK (`RedisRuntimePackageBoundaryTest` in the runtime holds that in `META-INF/spring.factories` as the runtime's `RedisCorrectnessRequirement`. The typed SDK described in -`docs/superpowers/specs/2026-08-07-redis-wrapper-typed-api-design.md` remains an optional library +`docs/design/2026-08-07-redis-wrapper-typed-api-design.md` remains an optional library rather than part of the shipped semantic Redis adapter. Delivery status and adaptation history are -in `docs/superpowers/plans/2026-08-07-redis-wrapper-typed-api-status.md`. +in `docs/history/plans/2026-08-07-redis-wrapper-typed-api-status.md`. - `sdk.api..` is the public contract. It must never import Spring, Lettuce, Micrometer, or any SDK implementation package; Reactor is confined to `sdk.api.reactive`. diff --git a/src/adapter/outbound/httpclient/CLAUDE.md b/src/adapter/outbound/httpclient/CLAUDE.md index 57de8c0c..2a9a3149 100644 --- a/src/adapter/outbound/httpclient/CLAUDE.md +++ b/src/adapter/outbound/httpclient/CLAUDE.md @@ -13,7 +13,7 @@ Package root: `dev.caskeleton.adapter.outbound.httpclient`. ## Design authority The implementation follows -`httpclient-superpowers-package/docs/superpowers/specs/2026-08-08-httpclient-platform-design.md`. +`docs/design/2026-08-08-httpclient-platform-design.md`. The design assumes 19 separate Gradle modules; this repository's fail-closed registry outranks that layout, so those modules are **packages** here. The mapping, and every other deliberate substitution, is recorded in `docs/httpclient/repository-adaptation.md`. Read it before diff --git a/src/adapter/outbound/httpclient/README.md b/src/adapter/outbound/httpclient/README.md index 4130afdc..a0d50646 100644 --- a/src/adapter/outbound/httpclient/README.md +++ b/src/adapter/outbound/httpclient/README.md @@ -5,7 +5,7 @@ HTTP. It is not a wrapper around `RestClient` — it owns the target, the connec time budget, the evidence of what actually executed, retry safety, authentication, TLS, SSRF defence, and observability. -Design: `httpclient-superpowers-package/docs/superpowers/specs/2026-08-08-httpclient-platform-design.md` +Design: `docs/design/2026-08-08-httpclient-platform-design.md` Adaptation to this repository: `docs/httpclient/repository-adaptation.md` ## Choosing a surface diff --git a/src/adapter/outbound/httpclient/build.gradle b/src/adapter/outbound/httpclient/build.gradle index 2e4041d9..2673999a 100644 --- a/src/adapter/outbound/httpclient/build.gradle +++ b/src/adapter/outbound/httpclient/build.gradle @@ -7,7 +7,7 @@ plugins { // Shared test code as a Gradle test-fixtures variant — ADR-BUILD-001. // Outbound HTTP Client Platform leaf — see -// docs/superpowers/specs/2026-08-08-httpclient-platform-design.md (design package) and +// docs/design/2026-08-08-httpclient-platform-design.md (design package) and // docs/httpclient/repository-adaptation.md (how the design's 19 library modules map here). // // The design models the platform as 19 separate Gradle modules. This repository's fail-closed diff --git a/src/adapter/outbound/objectstorage/README.md b/src/adapter/outbound/objectstorage/README.md index 24602ad6..0e85a8ba 100644 --- a/src/adapter/outbound/objectstorage/README.md +++ b/src/adapter/outbound/objectstorage/README.md @@ -7,7 +7,7 @@ records behind the application boundary. The allowed production dependencies are owned by `src/config/architecture/modules.json`. Module rules live in [CLAUDE.md](CLAUDE.md), the full design -in `docs/superpowers/specs/2026-07-28-objectstorage-production-capability-design.md`, and exact +in `docs/design/2026-07-28-objectstorage-production-capability-design.md`, and exact evidence claims in `docs/registries/object-storage-readiness.yaml`. For when to use this capability rather than the HTTP Fileserver platform, see diff --git a/src/adapter/outbound/persistence-jpa/CLAUDE.md b/src/adapter/outbound/persistence-jpa/CLAUDE.md index 2508abee..bf3622e6 100644 --- a/src/adapter/outbound/persistence-jpa/CLAUDE.md +++ b/src/adapter/outbound/persistence-jpa/CLAUDE.md @@ -20,7 +20,7 @@ adapters implement application/domain ports directly and must not depend on this ## JPA relational persistence platform -The platform in `docs/superpowers/specs/2026-08-11-jpa-persistence-platform-design.md` is +The platform in `docs/design/2026-08-11-jpa-persistence-platform-design.md` is implemented here. The design models it as 18 Stable library modules; this repository's fail-closed registry outranks that layout, so those modules are **packages** in this leaf and `docs/jpa/repository-adaptation.md` records the mapping. Read it before moving a type between diff --git a/src/adapter/outbound/persistence-jpa/build.gradle b/src/adapter/outbound/persistence-jpa/build.gradle index e1d40ba0..2484ee71 100644 --- a/src/adapter/outbound/persistence-jpa/build.gradle +++ b/src/adapter/outbound/persistence-jpa/build.gradle @@ -11,7 +11,7 @@ plugins { // implementations, and the vendor-neutral SPI interfaces (OutboxClaimRepository / // SqlStateErrorMapping). The PostgreSQL driver, flyway-database-postgresql dialect, and vendor // Flyway migrations live only under the .postgresql subpackage (ArchUnit keeps the base neutral). -// The JPA relational persistence platform (docs/superpowers/specs/2026-08-11-jpa-persistence- +// The JPA relational persistence platform (docs/design/2026-08-11-jpa-persistence- // platform-design.md) models itself as 18 Stable library modules. This repository's fail-closed // module registry outranks that layout, so those modules are packages here and // JpaModuleBoundaryTest enforces the design's module dependency table. The full mapping is in diff --git a/src/adapter/outbound/persistence-mongo/README.md b/src/adapter/outbound/persistence-mongo/README.md index b2e8303a..105f6310 100644 --- a/src/adapter/outbound/persistence-mongo/README.md +++ b/src/adapter/outbound/persistence-mongo/README.md @@ -5,7 +5,7 @@ document/repository/mapper와 application 또는 domain port 구현을 추가할 수 있는 구성 경계와 플랫폼 정책을 제공한다. -설계 원본은 `mongodb-superpowers-package/docs/superpowers/specs/`이고, 이 저장소로 어떻게 +설계 원본은 `docs/design/`이고, 이 저장소로 어떻게 매핑했는지는 [docs/mongodb/repository-adaptation.md](../../../../docs/mongodb/repository-adaptation.md)가 단일 기록이다. diff --git a/src/adapter/outbound/persistence-mongo/build.gradle b/src/adapter/outbound/persistence-mongo/build.gradle index 2b68b247..c894cb2a 100644 --- a/src/adapter/outbound/persistence-mongo/build.gradle +++ b/src/adapter/outbound/persistence-mongo/build.gradle @@ -8,7 +8,7 @@ plugins { // Shared test code as a Gradle test-fixtures variant — ADR-BUILD-001. Applied here rather than // from the root, the way the GraphQL leaf does: only a leaf that has shared test code needs it. // MongoDB Document Persistence Platform leaf — see -// docs/superpowers/specs/2026-08-11-mongodb-document-persistence-platform-design.md (design package) +// docs/design/2026-08-11-mongodb-document-persistence-platform-design.md (design package) // and docs/mongodb/repository-adaptation.md (how the design's 19 stable + 12 advanced library // modules map here). // diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/OperationalErrorRegistryContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/OperationalErrorRegistryContractTest.java index e0676bf4..2e80b2ed 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/OperationalErrorRegistryContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/OperationalErrorRegistryContractTest.java @@ -106,7 +106,7 @@ class OperationalErrorRegistryContractTest { * The log level is not a registry column. The failure's kind and path decide it — {@code * ServerFailureLog} on every transport, {@code AuthErrorResponseWriter} in the security filter — * not the code, so a per-row value can only drift from what is logged, as the column that was - * removed did (docs/superpowers/specs/2026-11-06-error-code-log-level-design.md). + * removed did (docs/design/2026-11-06-error-code-log-level-design.md). */ @Test void noRegistryRowCarriesALogLevel() { diff --git a/src/platforms/grpc/CLAUDE.md b/src/platforms/grpc/CLAUDE.md index 39ec8872..190f58d1 100644 --- a/src/platforms/grpc/CLAUDE.md +++ b/src/platforms/grpc/CLAUDE.md @@ -11,7 +11,7 @@ Root 정책(`CLAUDE.md` / `AGENTS.md`)과 충돌하면 root가 이긴다. `adapter:inbound:grpc`를 통해 라이브러리로서 도달한다. 설계 근거와 원본 계획 대비 deviation은 -[docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md](../../../docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md)가 SSOT다. +[docs/design/2026-08-30-grpc-platform-adaptation-design.md](../../../docs/design/2026-08-30-grpc-platform-adaptation-design.md)가 SSOT다. ## Family와 framework 규칙