From 630f9b860a401807e9e89f9be6b3004fddcb2904 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 12:12:21 +0900 Subject: [PATCH] =?UTF-8?q?docs(records):=20=EC=84=A4=EA=B3=84=EC=84=9C?= =?UTF-8?q?=EC=99=80=20=EA=B8=B0=EB=A1=9D=20=EB=AC=B8=EC=84=9C=EB=A5=BC=20?= =?UTF-8?q?docs/design=C2=B7docs/history=EB=A1=9C=20=EC=98=AE=EA=B8=B4?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: docs/ 바로 아래에 매뉴얼·운영 문서와 쓴 때의 기록(계획서·설계서· 납품 패키지·증거·학습)이 같은 층에 섞여 있다. 기록이라는 표시도 없어 읽는 사람이 지금 동작을 설명하는 문서와 구분하지 못한다. 고른 방법: 2026-11-07 소유자가 승인한 수명 기준 분리를 따른다. - docs/superpowers/specs → docs/design/ - docs/superpowers/plans → docs/history/plans/ - docs/superpowers/packages/* → docs/history/packages/* - docs/{graphql,web,websocket}-superpowers-package → docs/history/packages/<같은 이름>/ (packages/graphql과 겹치지 않게 원래 폴더 이름을 둔다) - docs/evidence → docs/history/evidence/, docs/study → docs/history/study/ - git에 들어가 있던 __pycache__ .pyc를 지우고 .gitignore에 더한다. 옮긴 경로를 가리키는 줄을 같은 커밋에서 고쳤다: 살아 있는 문서의 인라인 경로, AGENTS.md·CLAUDE.md, 빌드 스크립트·테스트 주석, docs/README.md 위치 표, 파생 서비스용 docs/upgrade/2026-11-docs-records.md. 기록 본문은 고치지 않고, 이동으로 깨진 마크다운 상대 링크 32개의 대상만 고쳤다(lychee와 check-work-docs.py --links가 docs/** 전체를 본다). 이동만 따로 두면 그 커밋에서 링크 검사가 실패하므로 한 커밋으로 묶었다. 대부분 R100이라 이름 바뀜은 그대로 보인다. 위험·한계: 기록 본문과 docs/reviews/** 안의 인라인 코드 경로는 옛 경로로 남는다(기록은 고치지 않는다). 실험용 Flyway 파일 db/experimental-rls/V1__tenant_rls.sql의 주석은 체크섬이 바뀌므로 두었다. 납품 패키지 셋의 MANIFEST.sha256과 validate_*.py는 패키지 안 상대 경로라 이동 뒤에도 그대로다. 검증: python3 scripts/check-work-docs.py rc=0, --links(gates.md 범위 + CLAUDE.md·AGENTS.md) 581개 파일 깨진 링크 0, --history docs/manual rc=0. --- .gitignore | 4 +++ AGENTS.md | 6 ++-- CLAUDE.md | 2 +- docs/README.md | 19 +++++++---- docs/capability-status.md | 2 +- docs/ci-cd/template-vs-consumer.md | 2 +- ...2026-07-20-harness-policy-engine-design.md | 0 ...ication-outbox-failure-reporting-design.md | 0 ...x-failure-reporting-harness-free-design.md | 0 ...-07-25-ci-control-plane-recovery-design.md | 2 +- ...026-07-25-harness-free-mode-b-amendment.md | 0 ...harness-free-quality-security-ci-design.md | 0 ...2026-07-25-module-gradle-hygiene-design.md | 0 ...dule-gradle-hygiene-harness-free-design.md | 0 ...fileserver-production-capability-design.md | 0 ...6-production-capability-platform-design.md | 2 +- ...7-26-redis-production-capability-design.md | 0 ...httpclient-production-capability-design.md | 0 ...control-plane-provider-selection-design.md | 0 ...-07-28-jpa-production-capability-design.md | 0 ...-messaging-production-capability-design.md | 0 ...tification-production-capability-design.md | 4 +-- ...ectstorage-production-capability-design.md | 14 ++++---- ...de-test-architecture-environment-design.md | 0 ...026-07-28-redis-cache-resilience-design.md | 0 ...-28-redis-distributed-rate-limit-design.md | 0 ...8-01-release-hygiene-refactoring-design.md | 0 ...08-02-client-safe-error-boundary-design.md | 0 ...ional-inbound-transport-boundary-design.md | 0 ...ification-governance-refactoring-design.md | 0 ...8-02-redis-session-http-boundary-design.md | 0 ...-verification-purity-refactoring-design.md | 0 .../2026-08-02-warning-zero-build-design.md | 0 ...2026-08-02-web-security-boundary-design.md | 0 .../2026-08-07-fileserver-platform-design.md | 0 ...26-08-07-redis-wrapper-typed-api-design.md | 0 .../2026-08-08-httpclient-platform-design.md | 0 .../2026-08-10-messaging-platform-design.md | 0 ...2026-08-10-notification-platform-design.md | 0 ...6-08-11-jpa-persistence-platform-design.md | 0 ...db-document-persistence-platform-design.md | 0 ...2-graphql-api-execution-platform-design.md | 0 ...apter-runtime-remediation-review-design.md | 0 ...6-08-30-grpc-platform-adaptation-design.md | 0 ...6-verification-surface-reduction-design.md | 0 ...evidence-gradle-model-decoupling-design.md | 0 ...6-09-18-bootstrap-structured-log-fields.md | 0 ...18-bootstrap-structured-runtime-logging.md | 0 ...-18-configuration-namespace-disposition.md | 0 ...nt-composition-reachability-remediation.md | 0 ...client-capability-composition-ownership.md | 0 ...18-jpa-capability-composition-ownership.md | 0 .../2026-09-18-jpa-runtime-master-switch.md | 0 ...-09-18-messaging-platform-bridge-design.md | 0 ...9-18-mongo-health-composition-ownership.md | 0 ...cation-capability-composition-ownership.md | 0 ...18-outbox-transport-only-cutover-design.md | 0 ...8-outbox-v2-canonical-storage-alignment.md | 0 ...outbox-v2-one-record-publication-policy.md | 0 ...resql-idempotency-composition-ownership.md | 0 ...-09-18-runtime-environment-tracing-ssot.md | 0 ...2026-09-18-secret-source-port-ownership.md | 0 ...09-18-startup-failure-log-context-state.md | 0 ...-architecture-phase2-provider-ownership.md | 0 ...2026-09-18-test-taxonomy-ssot-alignment.md | 0 ...build-release-review-remediation-design.md | 0 ...apability-dependency-validation-context.md | 0 ...-19-env-contract-verifier-truth-surface.md | 0 ...19-fileserver-composition-decomposition.md | 0 ...r-verification-read-failure-remediation.md | 0 ...mongo-client-runtime-review-remediation.md | 0 ...6-09-19-multi-instance-runtime-contract.md | 0 ...26-09-19-prod-secret-consumer-alignment.md | 0 ...6-09-19-runtime-profile-access-boundary.md | 0 .../2026-09-19-startup-order-contract.md | 0 ...26-09-19-test-support-ownership-closure.md | 0 ...9-25-capability-module-packaging-design.md | 0 .../2026-11-06-error-code-log-level-design.md | 0 .../object-storage/batch-a-checkpoint.md | 0 .../object-storage/batch-b-checkpoint.md | 0 .../object-storage/batch-c-progress.md | 0 .../object-storage/batch-d-checkpoint.md | 0 .../batch-e-pause-checkpoint.md | 0 .../object-storage/phase-0-inventory.md | 0 .../packages/fileserver/README.md | 0 .../packages/fileserver/VALIDATION.md | 0 .../MANIFEST.sha256 | 0 .../graphql-superpowers-package/README.md | 0 .../graphql-superpowers-package/VALIDATION.md | 0 ...ql-advanced-capabilities-expansion-plan.md | 0 ...-execution-platform-implementation-plan.md | 0 ...2-graphql-api-execution-platform-design.md | 0 .../validate_graphql_docs.py | 0 .../packages/graphql/README.md | 0 .../packages/graphql/VALIDATION.md | 0 .../packages/httpclient/README.md | 0 .../packages/httpclient/VALIDATION.md | 0 .../packages/jpa/README.md | 0 .../packages/jpa/VALIDATION.md | 0 .../packages/messaging/README.md | 0 .../packages/messaging/VALIDATION.md | 0 .../packages/mongodb/README.md | 0 .../packages/mongodb/VALIDATION.md | 0 .../packages/notification/README.md | 0 .../packages/notification/VALIDATION.md | 0 .../packages/redis/README.md | 0 .../packages/redis/VALIDATION.md | 0 .../web-superpowers-package/MANIFEST.sha256 | 0 .../web-superpowers-package/README.md | 0 .../web-superpowers-package/VALIDATION.md | 0 ...eb-advanced-capabilities-expansion-plan.md | 0 ...-execution-platform-implementation-plan.md | 0 ...ound-http-api-execution-platform-design.md | 0 .../research/source-web-deep-research.md | 0 .../validate_web_docs.py | 0 .../MANIFEST.sha256 | 0 .../websocket-superpowers-package/README.md | 0 .../VALIDATION.md | 0 ...et-advanced-capabilities-expansion-plan.md | 0 ...connection-platform-implementation-plan.md | 0 ...ket-realtime-connection-platform-design.md | 0 .../source-websocket-deep-research.md | 0 .../validate_websocket_docs.py | 0 .../plans/2026-07-20-harness-policy-engine.md | 0 ...n-outbox-failure-reporting-harness-free.md | 0 ...25-application-outbox-failure-reporting.md | 0 .../2026-07-25-ci-control-plane-recovery.md | 0 ...026-07-25-harness-free-mode-b-amendment.md | 0 ...-07-25-harness-free-quality-security-ci.md | 0 ...7-25-module-gradle-hygiene-harness-free.md | 0 .../plans/2026-07-25-module-gradle-hygiene.md | 0 .../2026-07-28-fileserver-durable-recovery.md | 0 ...server-production-capability-foundation.md | 0 ...ver-r2-control-plane-provider-selection.md | 0 ...07-28-httpclient-canonical-zero-binding.md | 0 ...client-production-capability-foundation.md | 0 .../2026-07-28-httpclient-total-deadline.md | 0 .../2026-07-28-jpa-production-capability.md | 0 ...-28-messaging-first-r2-polling-producer.md | 2 +- ...7-28-notification-production-capability.md | 2 +- ...-28-objectstorage-production-capability.md | 12 +++---- .../2026-07-28-redis-cache-resilience.md | 0 ...2026-07-28-redis-distributed-rate-limit.md | 0 ...-redis-production-capability-foundation.md | 0 .../plans/2026-07-28-redis-runtime-cache.md | 0 ...-redis-production-capability-completion.md | 0 ...30-redis-lab-strict-kubeconfig-renderer.md | 0 .../2026-08-01-release-hygiene-refactoring.md | 0 .../2026-08-02-client-safe-error-boundary.md | 0 ...-conditional-inbound-transport-boundary.md | 0 ...-p2-verification-governance-refactoring.md | 0 .../2026-08-02-redis-session-http-boundary.md | 0 ...6-08-02-verification-purity-refactoring.md | 0 ...26-08-02-warning-zero-build-refactoring.md | 0 .../plans/2026-08-02-web-security-boundary.md | 0 ...fileserver-platform-implementation-plan.md | 0 ...s-wrapper-typed-api-implementation-plan.md | 0 ...26-08-07-redis-wrapper-typed-api-status.md | 0 ...httpclient-platform-implementation-plan.md | 0 ...client-platform-activation-and-env-ssot.md | 0 ...-messaging-platform-implementation-plan.md | 0 ...tification-platform-implementation-plan.md | 0 ...08-10-redis-optionality-and-composition.md | 0 ...persistence-experimental-expansion-plan.md | 0 ...ersistence-platform-implementation-plan.md | 0 ...db-advanced-capabilities-expansion-plan.md | 0 ...ersistence-platform-implementation-plan.md | 0 ...ql-advanced-capabilities-expansion-plan.md | 0 ...-execution-platform-implementation-plan.md | 0 ...-five-adapter-runtime-remediation-index.md | 2 +- .../plans/2026-08-15-wave0-red-baseline.md | 2 +- .../plans/2026-08-15-wave1-activation-ssot.md | 2 +- .../plans/2026-08-15-wave2-module-on-path.md | 2 +- .../2026-08-15-wave3-environment-and-infra.md | 2 +- .../plans/2026-08-15-wave4-warning-zero.md | 2 +- .../2026-08-15-wave5-gradle-build-logic.md | 2 +- .../2026-08-15-wave6-final-qualification.md | 2 +- ...2026-08-30-grpc-platform-implementation.md | 2 +- .../plans/2026-09-16-ci-stage-separation.md | 0 ...17-jpa-evidence-gradle-model-decoupling.md | 0 .../2026-09-17-jpa-leaf-verification-java.md | 0 .../plans/2026-09-17-jpa-test-lanes-java.md | 0 ...26-09-17-mongo-gradle-verification-java.md | 0 .../2026-09-17-redis-topology-lane-java.md | 0 ...6-09-18-bootstrap-structured-log-fields.md | 0 ...18-bootstrap-structured-runtime-logging.md | 0 ...nt-composition-reachability-remediation.md | 0 ...client-capability-composition-ownership.md | 0 ...18-jpa-capability-composition-ownership.md | 0 .../2026-09-18-jpa-runtime-master-switch.md | 0 .../2026-09-18-messaging-platform-bridge.md | 0 ...9-18-mongo-health-composition-ownership.md | 0 ...cation-capability-composition-ownership.md | 0 ...026-09-18-outbox-transport-only-cutover.md | 0 ...8-outbox-v2-canonical-storage-alignment.md | 0 ...outbox-v2-one-record-publication-policy.md | 0 ...resql-idempotency-composition-ownership.md | 0 ...-09-18-runtime-environment-tracing-ssot.md | 0 ...2026-09-18-secret-source-port-ownership.md | 0 ...09-18-startup-failure-log-context-state.md | 0 ...-architecture-phase2-provider-ownership.md | 0 ...2026-09-18-test-taxonomy-ssot-alignment.md | 0 ...-09-19-build-release-review-remediation.md | 0 ...apability-dependency-validation-context.md | 0 ...-19-env-contract-verifier-truth-surface.md | 0 ...19-fileserver-composition-decomposition.md | 0 ...r-verification-read-failure-remediation.md | 0 ...mongo-client-runtime-review-remediation.md | 0 ...6-09-19-multi-instance-runtime-contract.md | 0 ...26-09-19-prod-secret-consumer-alignment.md | 0 ...6-09-19-runtime-profile-access-boundary.md | 0 .../2026-09-19-startup-order-contract.md | 0 ...26-09-19-test-support-ownership-closure.md | 0 ...23-app-bootstrap-build-composition-plan.md | 0 .../2026-09-25-capability-module-packaging.md | 0 .../agent-brief.md | 0 .../apply_results.py | 0 .../by_area.py | 0 .../plans/2026-09-25-review-followup.md | 0 .../evidence/2026-08-15-wave0-baseline.md | 0 .../evidence/2026-08-15-wave2-decisions.md | 0 .../task1-architecture-gates.log | 0 .../2026-08-15-wave6-final/task1-check.log | 0 .../2026-08-15-wave6-final/task1-compile.log | 0 .../2026-08-15-wave6-final/task1-test.log | 0 .../task1-wave0-red-set.md | 0 .../task1-wave0RedReport.log | 0 .../task2-b5-ghost-release-lanes.md | 0 .../task2-focused-module-tests.log | 0 ...2-graphql-runtime-qualification-NOT-RUN.md | 0 .../task2-graphql-runtime-qualification.log | 0 .../task2-graphql-stable-and-transport.log | 0 ...ask2-jpa-release-gate-first-run-failed.log | 0 .../task2-jpa-release-gate-pg16.log | 0 .../task2-jpa-release-gate-pg17.log | 0 .../task2-jpa-release-gate-pg18.log | 0 .../task2-jpa-release-gate.log | 0 .../task2-messaging-certification.log | 0 .../task2-messaging-live-broker.log | 0 .../task2-mongo-compatibility.log | 0 .../task2-mongo-failover.log | 0 .../task2-mongo-lanes-first-run-failed.log | 0 .../task2-mongo-lanes.log | 0 .../task2-mongo-migration.log | 0 .../task2-mongo-performance.log | 0 .../task2-mongo-replicaset.log | 0 .../task2-mongo-security.log | 0 .../task2-release-manifest-arbiter.log | 0 .../task3-activation-matrix.md | 0 .../task3-matrix-to-lane-map.md | 0 .../task3-row8-dependency-error.log | 0 .../task6-p0-reconciliation.md | 0 .../study/graphql-walkthrough.ko.md | 6 ++-- .../study/postgresql-jpa-walkthrough.ko.md | 0 docs/httpclient/repository-adaptation.md | 4 +-- docs/jpa/repository-adaptation.md | 6 ++-- docs/manual/10-capabilities.md | 2 +- docs/mongodb/repository-adaptation.md | 6 ++-- docs/notification/module-mapping.md | 4 +-- docs/redis/support-matrix.md | 4 +-- docs/registries/error-codes.yaml | 2 +- .../__pycache__/by_area.cpython-312.pyc | Bin 6575 -> 0 bytes docs/testing/TESTING_STRATEGY.md | 2 +- docs/upgrade/2026-11-docs-records.md | 30 ++++++++++++++++++ docs/upgrade/2026-11-maturity-review.md | 2 +- docs/web/repository-adaptation.md | 2 +- docs/work/improve.md | 2 +- docs/work/reference/decisions.md | 4 +-- docs/work/research-design.md | 4 +-- src/README.md | 2 +- src/adapter/inbound/web/README.md | 2 +- src/adapter/outbound/cache-redis/CLAUDE.md | 4 +-- src/adapter/outbound/httpclient/CLAUDE.md | 2 +- src/adapter/outbound/httpclient/README.md | 2 +- src/adapter/outbound/httpclient/build.gradle | 2 +- src/adapter/outbound/objectstorage/README.md | 2 +- .../outbound/persistence-jpa/CLAUDE.md | 2 +- .../outbound/persistence-jpa/build.gradle | 2 +- .../outbound/persistence-mongo/README.md | 2 +- .../outbound/persistence-mongo/build.gradle | 2 +- .../OperationalErrorRegistryContractTest.java | 2 +- src/grpc/CLAUDE.md | 2 +- 282 files changed, 119 insertions(+), 80 deletions(-) rename docs/{superpowers/specs => design}/2026-07-20-harness-policy-engine-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-25-application-outbox-failure-reporting-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-25-application-outbox-failure-reporting-harness-free-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-25-ci-control-plane-recovery-design.md (99%) rename docs/{superpowers/specs => design}/2026-07-25-harness-free-mode-b-amendment.md (100%) rename docs/{superpowers/specs => design}/2026-07-25-harness-free-quality-security-ci-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-25-module-gradle-hygiene-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-25-module-gradle-hygiene-harness-free-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-26-fileserver-production-capability-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-26-production-capability-platform-design.md (99%) rename docs/{superpowers/specs => design}/2026-07-26-redis-production-capability-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-27-httpclient-production-capability-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-28-fileserver-r2-control-plane-provider-selection-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-28-jpa-production-capability-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-28-messaging-production-capability-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-28-notification-production-capability-design.md (99%) rename docs/{superpowers/specs => design}/2026-07-28-objectstorage-production-capability-design.md (99%) rename docs/{superpowers/specs => design}/2026-07-28-production-grade-test-architecture-environment-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-28-redis-cache-resilience-design.md (100%) rename docs/{superpowers/specs => design}/2026-07-28-redis-distributed-rate-limit-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-01-release-hygiene-refactoring-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-02-client-safe-error-boundary-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-02-conditional-inbound-transport-boundary-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-02-p2-verification-governance-refactoring-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-02-redis-session-http-boundary-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-02-verification-purity-refactoring-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-02-warning-zero-build-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-02-web-security-boundary-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-07-fileserver-platform-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-07-redis-wrapper-typed-api-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-08-httpclient-platform-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-10-messaging-platform-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-10-notification-platform-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-11-jpa-persistence-platform-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-11-mongodb-document-persistence-platform-design.md (100%) rename docs/{graphql-superpowers-package/docs/superpowers/specs => design}/2026-08-12-graphql-api-execution-platform-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-15-five-adapter-runtime-remediation-review-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-30-grpc-platform-adaptation-design.md (100%) rename docs/{superpowers/specs => design}/2026-09-16-verification-surface-reduction-design.md (100%) rename docs/{superpowers/specs => design}/2026-09-17-jpa-evidence-gradle-model-decoupling-design.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-bootstrap-structured-log-fields.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-bootstrap-structured-runtime-logging.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-configuration-namespace-disposition.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-deployment-composition-reachability-remediation.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-httpclient-capability-composition-ownership.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-jpa-capability-composition-ownership.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-jpa-runtime-master-switch.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-messaging-platform-bridge-design.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-mongo-health-composition-ownership.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-notification-capability-composition-ownership.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-outbox-transport-only-cutover-design.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-outbox-v2-canonical-storage-alignment.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-outbox-v2-one-record-publication-policy.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-postgresql-idempotency-composition-ownership.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-runtime-environment-tracing-ssot.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-secret-source-port-ownership.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-startup-failure-log-context-state.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-test-architecture-phase2-provider-ownership.md (100%) rename docs/{superpowers/specs => design}/2026-09-18-test-taxonomy-ssot-alignment.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-build-release-review-remediation-design.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-capability-dependency-validation-context.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-env-contract-verifier-truth-surface.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-fileserver-composition-decomposition.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-fileserver-verification-read-failure-remediation.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-mongo-client-runtime-review-remediation.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-multi-instance-runtime-contract.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-prod-secret-consumer-alignment.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-runtime-profile-access-boundary.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-startup-order-contract.md (100%) rename docs/{superpowers/specs => design}/2026-09-19-test-support-ownership-closure.md (100%) rename docs/{superpowers/specs => design}/2026-09-25-capability-module-packaging-design.md (100%) rename docs/{superpowers/specs => design}/2026-11-06-error-code-log-level-design.md (100%) rename docs/{ => history}/evidence/object-storage/batch-a-checkpoint.md (100%) rename docs/{ => history}/evidence/object-storage/batch-b-checkpoint.md (100%) rename docs/{ => history}/evidence/object-storage/batch-c-progress.md (100%) rename docs/{ => history}/evidence/object-storage/batch-d-checkpoint.md (100%) rename docs/{ => history}/evidence/object-storage/batch-e-pause-checkpoint.md (100%) rename docs/{ => history}/evidence/object-storage/phase-0-inventory.md (100%) rename docs/{superpowers => history}/packages/fileserver/README.md (100%) rename docs/{superpowers => history}/packages/fileserver/VALIDATION.md (100%) rename docs/{ => history/packages}/graphql-superpowers-package/MANIFEST.sha256 (100%) rename docs/{ => history/packages}/graphql-superpowers-package/README.md (100%) rename docs/{ => history/packages}/graphql-superpowers-package/VALIDATION.md (100%) rename docs/{ => history/packages}/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md (100%) rename docs/{ => history/packages}/graphql-superpowers-package/docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md (100%) rename docs/{ => history/packages/graphql-superpowers-package/docs}/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md (100%) rename docs/{ => history/packages}/graphql-superpowers-package/validate_graphql_docs.py (100%) rename docs/{superpowers => history}/packages/graphql/README.md (100%) rename docs/{superpowers => history}/packages/graphql/VALIDATION.md (100%) rename docs/{superpowers => history}/packages/httpclient/README.md (100%) rename docs/{superpowers => history}/packages/httpclient/VALIDATION.md (100%) rename docs/{superpowers => history}/packages/jpa/README.md (100%) rename docs/{superpowers => history}/packages/jpa/VALIDATION.md (100%) rename docs/{superpowers => history}/packages/messaging/README.md (100%) rename docs/{superpowers => history}/packages/messaging/VALIDATION.md (100%) rename docs/{superpowers => history}/packages/mongodb/README.md (100%) rename docs/{superpowers => history}/packages/mongodb/VALIDATION.md (100%) rename docs/{superpowers => history}/packages/notification/README.md (100%) rename docs/{superpowers => history}/packages/notification/VALIDATION.md (100%) rename docs/{superpowers => history}/packages/redis/README.md (100%) rename docs/{superpowers => history}/packages/redis/VALIDATION.md (100%) rename docs/{ => history/packages}/web-superpowers-package/MANIFEST.sha256 (100%) rename docs/{ => history/packages}/web-superpowers-package/README.md (100%) rename docs/{ => history/packages}/web-superpowers-package/VALIDATION.md (100%) rename docs/{ => history/packages}/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-advanced-capabilities-expansion-plan.md (100%) rename docs/{ => history/packages}/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-inbound-http-api-execution-platform-implementation-plan.md (100%) rename docs/{ => history/packages}/web-superpowers-package/docs/superpowers/specs/2026-08-13-web-inbound-http-api-execution-platform-design.md (100%) rename docs/{ => history/packages}/web-superpowers-package/research/source-web-deep-research.md (100%) rename docs/{ => history/packages}/web-superpowers-package/validate_web_docs.py (100%) rename docs/{ => history/packages}/websocket-superpowers-package/MANIFEST.sha256 (100%) rename docs/{ => history/packages}/websocket-superpowers-package/README.md (100%) rename docs/{ => history/packages}/websocket-superpowers-package/VALIDATION.md (100%) rename docs/{ => history/packages}/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-advanced-capabilities-expansion-plan.md (100%) rename docs/{ => history/packages}/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-realtime-connection-platform-implementation-plan.md (100%) rename docs/{ => history/packages}/websocket-superpowers-package/docs/superpowers/specs/2026-08-14-websocket-realtime-connection-platform-design.md (100%) rename docs/{ => history/packages}/websocket-superpowers-package/research/source-websocket-deep-research.md (100%) rename docs/{ => history/packages}/websocket-superpowers-package/validate_websocket_docs.py (100%) rename docs/{superpowers => history}/plans/2026-07-20-harness-policy-engine.md (100%) rename docs/{superpowers => history}/plans/2026-07-25-application-outbox-failure-reporting-harness-free.md (100%) rename docs/{superpowers => history}/plans/2026-07-25-application-outbox-failure-reporting.md (100%) rename docs/{superpowers => history}/plans/2026-07-25-ci-control-plane-recovery.md (100%) rename docs/{superpowers => history}/plans/2026-07-25-harness-free-mode-b-amendment.md (100%) rename docs/{superpowers => history}/plans/2026-07-25-harness-free-quality-security-ci.md (100%) rename docs/{superpowers => history}/plans/2026-07-25-module-gradle-hygiene-harness-free.md (100%) rename docs/{superpowers => history}/plans/2026-07-25-module-gradle-hygiene.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-fileserver-durable-recovery.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-fileserver-production-capability-foundation.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-fileserver-r2-control-plane-provider-selection.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-httpclient-canonical-zero-binding.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-httpclient-production-capability-foundation.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-httpclient-total-deadline.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-jpa-production-capability.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-messaging-first-r2-polling-producer.md (99%) rename docs/{superpowers => history}/plans/2026-07-28-notification-production-capability.md (99%) rename docs/{superpowers => history}/plans/2026-07-28-objectstorage-production-capability.md (99%) rename docs/{superpowers => history}/plans/2026-07-28-redis-cache-resilience.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-redis-distributed-rate-limit.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-redis-production-capability-foundation.md (100%) rename docs/{superpowers => history}/plans/2026-07-28-redis-runtime-cache.md (100%) rename docs/{superpowers => history}/plans/2026-07-29-redis-production-capability-completion.md (100%) rename docs/{superpowers => history}/plans/2026-07-30-redis-lab-strict-kubeconfig-renderer.md (100%) rename docs/{superpowers => history}/plans/2026-08-01-release-hygiene-refactoring.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-client-safe-error-boundary.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-conditional-inbound-transport-boundary.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-p2-verification-governance-refactoring.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-redis-session-http-boundary.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-verification-purity-refactoring.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-warning-zero-build-refactoring.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-web-security-boundary.md (100%) rename docs/{superpowers => history}/plans/2026-08-07-fileserver-platform-implementation-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-07-redis-wrapper-typed-api-implementation-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-07-redis-wrapper-typed-api-status.md (100%) rename docs/{superpowers => history}/plans/2026-08-08-httpclient-platform-implementation-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-10-httpclient-platform-activation-and-env-ssot.md (100%) rename docs/{superpowers => history}/plans/2026-08-10-messaging-platform-implementation-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-10-notification-platform-implementation-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-10-redis-optionality-and-composition.md (100%) rename docs/{superpowers => history}/plans/2026-08-11-jpa-persistence-experimental-expansion-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-11-jpa-persistence-platform-implementation-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-11-mongodb-advanced-capabilities-expansion-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-11-mongodb-document-persistence-platform-implementation-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md (100%) rename docs/{superpowers => history}/plans/2026-08-15-five-adapter-runtime-remediation-index.md (99%) rename docs/{superpowers => history}/plans/2026-08-15-wave0-red-baseline.md (99%) rename docs/{superpowers => history}/plans/2026-08-15-wave1-activation-ssot.md (99%) rename docs/{superpowers => history}/plans/2026-08-15-wave2-module-on-path.md (99%) rename docs/{superpowers => history}/plans/2026-08-15-wave3-environment-and-infra.md (99%) rename docs/{superpowers => history}/plans/2026-08-15-wave4-warning-zero.md (99%) rename docs/{superpowers => history}/plans/2026-08-15-wave5-gradle-build-logic.md (99%) rename docs/{superpowers => history}/plans/2026-08-15-wave6-final-qualification.md (99%) rename docs/{superpowers => history}/plans/2026-08-30-grpc-platform-implementation.md (98%) rename docs/{superpowers => history}/plans/2026-09-16-ci-stage-separation.md (100%) rename docs/{superpowers => history}/plans/2026-09-17-jpa-evidence-gradle-model-decoupling.md (100%) rename docs/{superpowers => history}/plans/2026-09-17-jpa-leaf-verification-java.md (100%) rename docs/{superpowers => history}/plans/2026-09-17-jpa-test-lanes-java.md (100%) rename docs/{superpowers => history}/plans/2026-09-17-mongo-gradle-verification-java.md (100%) rename docs/{superpowers => history}/plans/2026-09-17-redis-topology-lane-java.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-bootstrap-structured-log-fields.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-bootstrap-structured-runtime-logging.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-deployment-composition-reachability-remediation.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-httpclient-capability-composition-ownership.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-jpa-capability-composition-ownership.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-jpa-runtime-master-switch.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-messaging-platform-bridge.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-mongo-health-composition-ownership.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-notification-capability-composition-ownership.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-outbox-transport-only-cutover.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-outbox-v2-canonical-storage-alignment.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-outbox-v2-one-record-publication-policy.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-postgresql-idempotency-composition-ownership.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-runtime-environment-tracing-ssot.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-secret-source-port-ownership.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-startup-failure-log-context-state.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-test-architecture-phase2-provider-ownership.md (100%) rename docs/{superpowers => history}/plans/2026-09-18-test-taxonomy-ssot-alignment.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-build-release-review-remediation.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-capability-dependency-validation-context.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-env-contract-verifier-truth-surface.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-fileserver-composition-decomposition.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-fileserver-verification-read-failure-remediation.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-mongo-client-runtime-review-remediation.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-multi-instance-runtime-contract.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-prod-secret-consumer-alignment.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-runtime-profile-access-boundary.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-startup-order-contract.md (100%) rename docs/{superpowers => history}/plans/2026-09-19-test-support-ownership-closure.md (100%) rename docs/{superpowers => history}/plans/2026-09-23-app-bootstrap-build-composition-plan.md (100%) rename docs/{superpowers => history}/plans/2026-09-25-capability-module-packaging.md (100%) rename docs/{superpowers => history}/plans/2026-09-25-review-followup-tools/agent-brief.md (100%) rename docs/{superpowers => history}/plans/2026-09-25-review-followup-tools/apply_results.py (100%) rename docs/{superpowers => history}/plans/2026-09-25-review-followup-tools/by_area.py (100%) rename docs/{superpowers => history}/plans/2026-09-25-review-followup.md (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave0-baseline.md (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave2-decisions.md (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task1-architecture-gates.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task1-check.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task1-compile.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task1-test.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task1-wave0-red-set.md (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task1-wave0RedReport.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-b5-ghost-release-lanes.md (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-focused-module-tests.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification-NOT-RUN.md (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-graphql-runtime-qualification.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-graphql-stable-and-transport.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-first-run-failed.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg16.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg17.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate-pg18.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-jpa-release-gate.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-messaging-certification.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-messaging-live-broker.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-mongo-compatibility.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-mongo-failover.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-mongo-lanes-first-run-failed.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-mongo-lanes.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-mongo-migration.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-mongo-performance.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-mongo-replicaset.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-mongo-security.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task2-release-manifest-arbiter.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task3-activation-matrix.md (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task3-matrix-to-lane-map.md (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task3-row8-dependency-error.log (100%) rename docs/{superpowers => history}/plans/evidence/2026-08-15-wave6-final/task6-p0-reconciliation.md (100%) rename docs/{ => history}/study/graphql-walkthrough.ko.md (99%) rename docs/{ => history}/study/postgresql-jpa-walkthrough.ko.md (100%) delete mode 100644 docs/superpowers/plans/2026-09-25-review-followup-tools/__pycache__/by_area.cpython-312.pyc create mode 100644 docs/upgrade/2026-11-docs-records.md 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 26d2371b..316eb8ef 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -171,8 +171,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로 표현한다. @@ -249,7 +249,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 86356844..3014839f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -63,7 +63,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..35a624a2 100644 --- a/docs/README.md +++ b/docs/README.md @@ -26,23 +26,28 @@ | `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` 또는 diff --git a/docs/capability-status.md b/docs/capability-status.md index b70e0120..523c02dd 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 964e2552..9841f290 100644 --- a/docs/ci-cd/template-vs-consumer.md +++ b/docs/ci-cd/template-vs-consumer.md @@ -19,7 +19,7 @@ | `:app-bootstrap:sampleOffTest`, `ci-quality-gates.yml`의 `sample-off` job | sample 픽스처를 지워도 애플리케이션이 빌드·부팅되는가 | | `sample-portfolio` leaf 전체 | 참조 구현 | | `Dockerfile.sample`, `docker-compose.*` 중 sample 관련 | 위와 동일 | -| `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 100% 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 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 100% 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 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 100% 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 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 99% 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..62964ad6 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 @@ -114,7 +114,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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 99% 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..f5e3cf26 100644 --- a/docs/superpowers/specs/2026-07-26-production-capability-platform-design.md +++ b/docs/design/2026-07-26-production-capability-platform-design.md @@ -952,7 +952,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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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..1f7fa87a 100644 --- a/docs/superpowers/specs/2026-07-28-notification-production-capability-design.md +++ b/docs/design/2026-07-28-notification-production-capability-design.md @@ -15,7 +15,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 +4793,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..0a21d2a3 100644 --- a/docs/superpowers/specs/2026-07-28-objectstorage-production-capability-design.md +++ b/docs/design/2026-07-28-objectstorage-production-capability-design.md @@ -12,7 +12,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 +78,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 +4015,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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/specs/2026-08-07-fileserver-platform-design.md rename to docs/design/2026-08-07-fileserver-platform-design.md 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 100% 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 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 100% rename from docs/superpowers/specs/2026-08-08-httpclient-platform-design.md rename to docs/design/2026-08-08-httpclient-platform-design.md 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 100% rename from docs/superpowers/specs/2026-08-10-messaging-platform-design.md rename to docs/design/2026-08-10-messaging-platform-design.md 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 100% rename from docs/superpowers/specs/2026-08-10-notification-platform-design.md rename to docs/design/2026-08-10-notification-platform-design.md 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 100% 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 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 100% 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 diff --git a/docs/graphql-superpowers-package/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 100% rename from docs/graphql-superpowers-package/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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/specs/2026-09-18-configuration-namespace-disposition.md rename to docs/design/2026-09-18-configuration-namespace-disposition.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/specs/2026-09-19-fileserver-composition-decomposition.md rename to docs/design/2026-09-19-fileserver-composition-decomposition.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/specs/2026-09-19-startup-order-contract.md rename to docs/design/2026-09-19-startup-order-contract.md 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 100% 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 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 100% 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 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 100% 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 diff --git a/docs/evidence/object-storage/batch-a-checkpoint.md b/docs/history/evidence/object-storage/batch-a-checkpoint.md similarity index 100% rename from docs/evidence/object-storage/batch-a-checkpoint.md rename to docs/history/evidence/object-storage/batch-a-checkpoint.md diff --git a/docs/evidence/object-storage/batch-b-checkpoint.md b/docs/history/evidence/object-storage/batch-b-checkpoint.md similarity index 100% rename from docs/evidence/object-storage/batch-b-checkpoint.md rename to docs/history/evidence/object-storage/batch-b-checkpoint.md diff --git a/docs/evidence/object-storage/batch-c-progress.md b/docs/history/evidence/object-storage/batch-c-progress.md similarity index 100% rename from docs/evidence/object-storage/batch-c-progress.md rename to docs/history/evidence/object-storage/batch-c-progress.md diff --git a/docs/evidence/object-storage/batch-d-checkpoint.md b/docs/history/evidence/object-storage/batch-d-checkpoint.md similarity index 100% rename from docs/evidence/object-storage/batch-d-checkpoint.md rename to docs/history/evidence/object-storage/batch-d-checkpoint.md 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 100% rename from docs/evidence/object-storage/batch-e-pause-checkpoint.md rename to docs/history/evidence/object-storage/batch-e-pause-checkpoint.md diff --git a/docs/evidence/object-storage/phase-0-inventory.md b/docs/history/evidence/object-storage/phase-0-inventory.md similarity index 100% rename from docs/evidence/object-storage/phase-0-inventory.md rename to docs/history/evidence/object-storage/phase-0-inventory.md diff --git a/docs/superpowers/packages/fileserver/README.md b/docs/history/packages/fileserver/README.md similarity index 100% rename from docs/superpowers/packages/fileserver/README.md rename to docs/history/packages/fileserver/README.md diff --git a/docs/superpowers/packages/fileserver/VALIDATION.md b/docs/history/packages/fileserver/VALIDATION.md similarity index 100% rename from docs/superpowers/packages/fileserver/VALIDATION.md rename to docs/history/packages/fileserver/VALIDATION.md 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 100% rename from docs/graphql-superpowers-package/README.md rename to docs/history/packages/graphql-superpowers-package/README.md diff --git a/docs/graphql-superpowers-package/VALIDATION.md b/docs/history/packages/graphql-superpowers-package/VALIDATION.md similarity index 100% rename from docs/graphql-superpowers-package/VALIDATION.md rename to docs/history/packages/graphql-superpowers-package/VALIDATION.md diff --git a/docs/graphql-superpowers-package/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 100% rename from docs/graphql-superpowers-package/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 diff --git a/docs/graphql-superpowers-package/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 100% rename from docs/graphql-superpowers-package/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 diff --git a/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 100% rename from 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 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 100% rename from docs/superpowers/packages/graphql/README.md rename to docs/history/packages/graphql/README.md diff --git a/docs/superpowers/packages/graphql/VALIDATION.md b/docs/history/packages/graphql/VALIDATION.md similarity index 100% rename from docs/superpowers/packages/graphql/VALIDATION.md rename to docs/history/packages/graphql/VALIDATION.md diff --git a/docs/superpowers/packages/httpclient/README.md b/docs/history/packages/httpclient/README.md similarity index 100% rename from docs/superpowers/packages/httpclient/README.md rename to docs/history/packages/httpclient/README.md diff --git a/docs/superpowers/packages/httpclient/VALIDATION.md b/docs/history/packages/httpclient/VALIDATION.md similarity index 100% rename from docs/superpowers/packages/httpclient/VALIDATION.md rename to docs/history/packages/httpclient/VALIDATION.md diff --git a/docs/superpowers/packages/jpa/README.md b/docs/history/packages/jpa/README.md similarity index 100% rename from docs/superpowers/packages/jpa/README.md rename to docs/history/packages/jpa/README.md diff --git a/docs/superpowers/packages/jpa/VALIDATION.md b/docs/history/packages/jpa/VALIDATION.md similarity index 100% rename from docs/superpowers/packages/jpa/VALIDATION.md rename to docs/history/packages/jpa/VALIDATION.md diff --git a/docs/superpowers/packages/messaging/README.md b/docs/history/packages/messaging/README.md similarity index 100% rename from docs/superpowers/packages/messaging/README.md rename to docs/history/packages/messaging/README.md diff --git a/docs/superpowers/packages/messaging/VALIDATION.md b/docs/history/packages/messaging/VALIDATION.md similarity index 100% rename from docs/superpowers/packages/messaging/VALIDATION.md rename to docs/history/packages/messaging/VALIDATION.md diff --git a/docs/superpowers/packages/mongodb/README.md b/docs/history/packages/mongodb/README.md similarity index 100% rename from docs/superpowers/packages/mongodb/README.md rename to docs/history/packages/mongodb/README.md diff --git a/docs/superpowers/packages/mongodb/VALIDATION.md b/docs/history/packages/mongodb/VALIDATION.md similarity index 100% rename from docs/superpowers/packages/mongodb/VALIDATION.md rename to docs/history/packages/mongodb/VALIDATION.md diff --git a/docs/superpowers/packages/notification/README.md b/docs/history/packages/notification/README.md similarity index 100% rename from docs/superpowers/packages/notification/README.md rename to docs/history/packages/notification/README.md diff --git a/docs/superpowers/packages/notification/VALIDATION.md b/docs/history/packages/notification/VALIDATION.md similarity index 100% rename from docs/superpowers/packages/notification/VALIDATION.md rename to docs/history/packages/notification/VALIDATION.md diff --git a/docs/superpowers/packages/redis/README.md b/docs/history/packages/redis/README.md similarity index 100% rename from docs/superpowers/packages/redis/README.md rename to docs/history/packages/redis/README.md diff --git a/docs/superpowers/packages/redis/VALIDATION.md b/docs/history/packages/redis/VALIDATION.md similarity index 100% rename from docs/superpowers/packages/redis/VALIDATION.md rename to docs/history/packages/redis/VALIDATION.md 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 100% rename from docs/web-superpowers-package/README.md rename to docs/history/packages/web-superpowers-package/README.md diff --git a/docs/web-superpowers-package/VALIDATION.md b/docs/history/packages/web-superpowers-package/VALIDATION.md similarity index 100% rename from docs/web-superpowers-package/VALIDATION.md rename to docs/history/packages/web-superpowers-package/VALIDATION.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/websocket-superpowers-package/README.md rename to docs/history/packages/websocket-superpowers-package/README.md diff --git a/docs/websocket-superpowers-package/VALIDATION.md b/docs/history/packages/websocket-superpowers-package/VALIDATION.md similarity index 100% rename from docs/websocket-superpowers-package/VALIDATION.md rename to docs/history/packages/websocket-superpowers-package/VALIDATION.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/plans/2026-07-20-harness-policy-engine.md rename to docs/history/plans/2026-07-20-harness-policy-engine.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/plans/2026-07-25-module-gradle-hygiene.md rename to docs/history/plans/2026-07-25-module-gradle-hygiene.md 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 100% rename from docs/superpowers/plans/2026-07-28-fileserver-durable-recovery.md rename to docs/history/plans/2026-07-28-fileserver-durable-recovery.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/plans/2026-07-28-httpclient-total-deadline.md rename to docs/history/plans/2026-07-28-httpclient-total-deadline.md 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 100% rename from docs/superpowers/plans/2026-07-28-jpa-production-capability.md rename to docs/history/plans/2026-07-28-jpa-production-capability.md 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..58b240bf 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 @@ -26,7 +26,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..9022b3cc 100644 --- a/docs/superpowers/plans/2026-07-28-notification-production-capability.md +++ b/docs/history/plans/2026-07-28-notification-production-capability.md @@ -15,7 +15,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..389866e9 100644 --- a/docs/superpowers/plans/2026-07-28-objectstorage-production-capability.md +++ b/docs/history/plans/2026-07-28-objectstorage-production-capability.md @@ -32,7 +32,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 +51,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 100% rename from docs/superpowers/plans/2026-07-28-redis-cache-resilience.md rename to docs/history/plans/2026-07-28-redis-cache-resilience.md 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/plans/2026-07-28-redis-runtime-cache.md rename to docs/history/plans/2026-07-28-redis-runtime-cache.md 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/plans/2026-08-01-release-hygiene-refactoring.md rename to docs/history/plans/2026-08-01-release-hygiene-refactoring.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/plans/2026-08-02-verification-purity-refactoring.md rename to docs/history/plans/2026-08-02-verification-purity-refactoring.md 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 100% 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 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 100% rename from docs/superpowers/plans/2026-08-02-web-security-boundary.md rename to docs/history/plans/2026-08-02-web-security-boundary.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 diff --git a/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 100% rename from 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 diff --git a/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 100% rename from 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 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 99% 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..780f745e 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 @@ -25,7 +25,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..bc3bcc9d 100644 --- a/docs/superpowers/plans/2026-08-15-wave0-red-baseline.md +++ b/docs/history/plans/2026-08-15-wave0-red-baseline.md @@ -22,7 +22,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..f0620d85 100644 --- a/docs/superpowers/plans/2026-08-15-wave1-activation-ssot.md +++ b/docs/history/plans/2026-08-15-wave1-activation-ssot.md @@ -28,7 +28,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 99% 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..f722f2dd 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 @@ -22,7 +22,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 99% 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..c77297a4 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 @@ -24,7 +24,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 99% 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..7564e89e 100644 --- a/docs/superpowers/plans/2026-08-15-wave4-warning-zero.md +++ b/docs/history/plans/2026-08-15-wave4-warning-zero.md @@ -21,7 +21,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 99% 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..6bafb2f4 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 @@ -21,7 +21,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 99% 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..2f699a1a 100644 --- a/docs/superpowers/plans/2026-08-15-wave6-final-qualification.md +++ b/docs/history/plans/2026-08-15-wave6-final-qualification.md @@ -15,7 +15,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 98% 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..8020accc 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,6 @@ # 타입 안전 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 100% rename from docs/superpowers/plans/2026-09-16-ci-stage-separation.md rename to docs/history/plans/2026-09-16-ci-stage-separation.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/plans/2026-09-18-messaging-platform-bridge.md rename to docs/history/plans/2026-09-18-messaging-platform-bridge.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% rename from docs/superpowers/plans/2026-09-19-fileserver-composition-decomposition.md rename to docs/history/plans/2026-09-19-fileserver-composition-decomposition.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 diff --git a/docs/superpowers/plans/2026-09-19-startup-order-contract.md b/docs/history/plans/2026-09-19-startup-order-contract.md similarity index 100% rename from docs/superpowers/plans/2026-09-19-startup-order-contract.md rename to docs/history/plans/2026-09-19-startup-order-contract.md diff --git a/docs/superpowers/plans/2026-09-19-test-support-ownership-closure.md b/docs/history/plans/2026-09-19-test-support-ownership-closure.md similarity index 100% rename from docs/superpowers/plans/2026-09-19-test-support-ownership-closure.md rename to docs/history/plans/2026-09-19-test-support-ownership-closure.md 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 100% 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 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 100% rename from docs/superpowers/plans/2026-09-25-capability-module-packaging.md rename to docs/history/plans/2026-09-25-capability-module-packaging.md 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 100% 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 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 100% rename from docs/superpowers/plans/2026-09-25-review-followup.md rename to docs/history/plans/2026-09-25-review-followup.md 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 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave0-baseline.md rename to docs/history/plans/evidence/2026-08-15-wave0-baseline.md 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 100% rename from docs/superpowers/plans/evidence/2026-08-15-wave2-decisions.md rename to docs/history/plans/evidence/2026-08-15-wave2-decisions.md 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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 100% 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 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..d350dbd4 100644 --- a/docs/study/graphql-walkthrough.ko.md +++ b/docs/history/study/graphql-walkthrough.ko.md @@ -15,9 +15,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 100% rename from docs/study/postgresql-jpa-walkthrough.ko.md rename to docs/history/study/postgresql-jpa-walkthrough.ko.md 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 4e6973b0..7a67508c 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/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 f90fcfe8..f09734b8 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-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 a3bd502f9322d28c68ba07b867698e501e637967..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6575 zcmb_geQ*>p_hr!RVOtyUg>4wcIc zX1W-RFdIW%NPDtfEIbV{L!9g4;>Io`qWxUV6gPL75yLWq85=)9E3F9W}IDic$NT93G`Dw3vf8$y%^fp;-HPZQ5T!mhFA2O{?e3KM zkZ{PI98|($VxPNbFhD!1lY{PaUT-WSEAG?2*Bjlw_D0`%+7!X^6D{}XqE32P)m$&8 z5{e+Hb}aPrshENzLB)eq?i8w^r+^L#3#cSVvh?z*_aZE3*L~F z3_f=Cz~0FUbb4hzo{R~qH7>}oMUg~EHTI+;G3;@w$fu&$R8+5`1{F1`=!lA%RCH8D z%_=&kq81e$SJ4R-om5e)%2C}th4-jw-D4>+P{L7Sq{KvtnGy>nR!XRy-?LNVprnA3 zLLeTehn1*VrfYNSB7J;sA5X-T(j#6ZC$!}XNBIPf2@*M#>VZQHw+k|y2|3|!^1=jE zSgIDtlUqu@d}r(rKl^*q-Q#ccclVH_B=$$JAi4K{dHqMkFUbB>GAY6Au>CLxU2EE# zKLr>ECI;ggB)(Vi?%7LH$(YDvas&>lU4SFRFp4Ud_I&NU$jTeosCIl*{yv!IL?qGN z3M0VJnY45DxJVN{wze3wQ-4qIqK8I8?WgJqoT@Aa`virY7JB?EHGfCziBqJz8dOn4 z7(+KSZPzS=oS^mrZFGOrMVgtAc4{mn27Vzx58d?i_PphgqhLh!nh{YMtF=~NN(t`; zc6wy#j-(*T;50%aD0smRL7QWze4x%Ts2_<94)B8{9szBr5fhw}_@0@VWp)t z*AN3uU~+o)=@uUIN$|0nNTLV44cCCqRBtbj`*{$EK^nY*w8lig5QACiI!{R=$cU5r z)^uB06UUpGx;l}= zfI%4Q3Gl?ALa-R;BZ<{MutHH%2$*Jq;sMyWKg{ple}KHk2m8d{UILrXClo@53Q3qK zp@5_4dW2T`8EJF=?SDVh%8Cgar9S*r$;VM?{S!LrQTz#RY$izG zGl|6(KZC7)<{M_U=~_r=(EbfPjwg5ulw6E&V9r-EOgEg)ka5WL{526%eoZnO+eC~( z7QyLo%wVC%c`|Kq*SIBm&S_iKIiI)nyvN&(rLDBVdb07fx2hZO@}v#^ectq|e;U9L zh*Lo&(l0;-M!aYn{!<8#MRT{LEuhjWRfz zqOuT8jd5NHhE-crdu!*Z0FCadF(iqpq-uyjkhH)mS6Xclk|jkRh$vyzBnvz^vTA8* zJbSvey}|D>s|G28RZbBuDk>Kicq| z)L;PN@Sq?jYA9^TN$}X3V3=3Dp`@a@Ke#>MT~NeA4}fw_5U@GnrE7>Numvee@b-Y$ z3kmF11PIr>Lg$23LrwvLCdC0j;~HpAJU8jkkgO)3`KTOCfutr_?+*CO{|RK6S+W<7 z9~?b6(V4YxnDQ;!D~21E9fjjZM~_aNpKZuGJj0EjnH|f{byM4}?wZ~;%U`Kpbb2xt z&$7)iUNu@ZQ8!zfwQV1+|IBO~lPC6FJ~(-Bs_pH%tkeC|ql?bn%g(YH!&Lp%=ILe_ zdpuk2S#<8qSavR%?SJv+_urgI-8OGpuH1ZeaC$J~iDeSf?Mius+-Df8j|G}W+5=wn z0sXhl6-&;w`s=`Lb0xekuiN~9VU6XZ1tZ)@XxUz%DRp`Z-?495Dk=NRmitENy>DV1 z#ScMmCP;~1XpEys`taufhAj*NU{v%zCYpo3Toa=wtx=lkJXQ2QaJ;_;r=t){P2{PP zhghlT8#vg!Lyv7&Xkwz3Xb$@H76xSKyx4%b^-KdZj)H8639{z_2!;?rQ5yE2D*8$% z*|Aa%Kz;}*IYj@kF*^~iiW5^{9x|OcgG}9kkNqcF>(W- znEV~Sj!wU71%JT-4Fqf&#>BvHW$9($R*n8s$D2E(16mzY>j*$hOh{<%rE*a*lJFQ* zjt)>!P&EdHSWK3wDFIYSN9ZVy-dm*Cq52a1%}0Y(gX4lCxy|&Cxffl-tg&bKEbT?>jTKZ``g5EICS-w|d@dxz;kzWw-91 z=NH(_)|WnY)lFTPD7suWS@zDljH_o41X<7s zyvQ)b5tcBkUQ<8}L|ZNRMaj3ULQA%=Nz=`#VKbGjYY*N~`^UXk7;FJfO%n{s z#Cir=Y|vt-W1+=CTi(rm41ihAQJ=~uK>4Idmo#L2rmkzB(A7kY#6Tqw_9FZ=S!^26 zCTIw?(=@W(={A_~h^eCSEOhBn2E> z!%=)-uOsYwCa+zee-iz|^jCoNN)C;PF}g;dGyl|27#IDJ`I}-Lm*Bk9t4Wn%$dcCz zlHDAF=I6lQq!lD)kXo1NoWw%3{nOX@Obv3WIcU3C*ETEFTb0(MUij~W|BLY7uSKkT^u7Qowy5y2U=EC- zje;9zEFTwMp>3iz1(3RG6w{lF`i0~uz16q3y$Mzux`f?!T+f9%#<& zZysi(qtFQx8~TJn)!5P6;XCeeN^Q^xq6cM~2Z#E#z^fXQ65IS@pj0+R@s#hNjRh^SYVf)$nw9 z_QG^u#{24G#jDF}$}gXpJTt{lp8M&R_o}W{&F#6iYXpyQ%Nr`M9DuCB+JQz}Mtma| zCblg(T@wwL2B+F)w_Z8BT(b6Z?PTqgZ}O$t9k)t6%cYRv&!Xw7cUr%IYUk{p=`&Nu zW`lFv=F$6A^DoZV&sAqU2N%k3Y`cj*s=E2&&H5YF8DCpwefynK|9v|Zbl<^Poy(50 z8FSX*9&TJNDSI21fQ;)#%_C@J&j`O{DH!2LEfYnT>=PFjE#+hO`v&O#+_4k5IqS&w z@!g}lC#0-xeTHk9-}dRI+PStV{%UACG|Rsmy|t+pniqEb+WVpRCdwW) z{@&#G-X2=q*?ik|jLQ2i8s(_KWh!nwG#Z-dxzv}j1QynOy7BP5Z^l1cG`r_o>6Nor z1Ji-IwmX|@Zf!ga{U4Wn?7vy`yYkcp`K<4a+m--b?03-@ zj*?5w!;MP?#pB(h-Iv~=63a&r=r-;cbxgGV*h%@yzW{x9jC)7DQ*73@A;U!$QlC~p zCN(3^?w>2VR(oY=HSgMUr*i+Tibml0SpKJdH&eeOza^jidA8+^Y*XNFld#w%WO_r{ zrtobp^5{VUQ*rRo=Nk_{dSGEHk06=)?Z?jY=9g{%cxdY})^T(5)?;RyY6%3WH3b5m zV$~c7z~wOzkp2vKr3et!9)vH`aMOgZb+Tsnng?ii+Hfq=BhhP(bewXU>Gv-9)G4*n zrh}AFB#;hM(nJYOU^T0yLh02w5O{yZ1vRql_plKzZ#LINVy!DT<=|)ePqtN#8Q8`;4>v=*WEo K!>!kV<$nO+@;hMw 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..90600bf5 --- /dev/null +++ b/docs/upgrade/2026-11-docs-records.md @@ -0,0 +1,30 @@ +# 업그레이드 안내 — 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에서 「삭제 대 이름 바꿈」 충돌이 난다. 지운 쪽을 고르면 된다. diff --git a/docs/upgrade/2026-11-maturity-review.md b/docs/upgrade/2026-11-maturity-review.md index b0398c6c..e9410aad 100644 --- a/docs/upgrade/2026-11-maturity-review.md +++ b/docs/upgrade/2026-11-maturity-review.md @@ -256,7 +256,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 c3b43f84..e7804687 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 76ae945c..a2c8588d 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절 | @@ -90,7 +90,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/src/README.md b/src/README.md index 77e93d41..970dbbb8 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 b09e83d4..52fbefee 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 f8094a64..81ff7846 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 ed713659..dcc8ed78 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 7aebdf5d..38c16d66 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 4329176e..f1bd90da 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 c33c1752..3f125370 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/grpc/CLAUDE.md b/src/grpc/CLAUDE.md index dbaaccd0..7893494a 100644 --- a/src/grpc/CLAUDE.md +++ b/src/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 규칙