From 99e76e87220e4c6d9f8e683025a2cf2a516b10fa Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 8 Nov 2026 16:56:47 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=EA=B8=B0=EB=A1=9D=C2=B7=EC=84=A4?= =?UTF-8?q?=EA=B3=84=EC=84=9C=C2=B7=EA=B2=B0=EC=A0=95=20=EA=B8=B0=EB=A1=9D?= =?UTF-8?q?=EC=9D=84=20docs/history=C2=B7docs/design=C2=B7docs/adr?= =?UTF-8?q?=EB=A1=9C=20=EC=98=AE=EA=B8=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 프론트 docs/는 지금 동작을 설명하는 문서와 쓴 때의 기록이 한 폴더에 섞여 있다. docs/architecture/에는 현재 계약 10개와 목표 설계 14개, 결정 기록 VD 23개가 같이 있고, 설계서·계획서는 플러그인 이름 폴더(docs/superpowers/)에 있다. 문서 체계 규칙(design-docs conventions/docs-system.md v1, 2026-11-07 소유자 결정)은 수명으로 나누고 폴더 이름을 백엔드와 같게 하라고 정한다. 고른 방법: 내용 변경 없이 git mv만 담는다. git이 이름 바뀜을 알아보고 리뷰어가 이동과 내용 변경을 따로 볼 수 있게 하려는 것이다. 참조 수정과 머리 블록은 다음 커밋들이 한다. - docs/superpowers/specs → docs/design/, plans → docs/history/plans/ - docs/architecture/ 목표 설계 13개와 styling·testing의 목표 설계 2개 → docs/design/<작성일>-<이름>-design.md (2026-07-30 결정 정본은 이름 그대로) - docs/architecture/decisions/VD-* → docs/adr/ (번호 유지) 위험: 이 커밋만으로는 옮긴 문서를 가리키는 링크와 경로가 깨진다. 다음 커밋이 고친다. 게이트가 읽는 파일(review-ledger.json, review-evidence.md, adapter-remediation-ledger.md, INVENTORY.md)은 옮기지 않았다. docs/history/는 복사한 프로젝트가 지워도 된다는 약속 (tests/unit/deletable-history-documents.test.ts)이 있어서 코드가 읽는 파일을 둘 수 없다. SPEC.md는 공통 완료 기준을 매뉴얼로 옮긴 뒤 따로 옮긴다. 검증: git status가 이름 바뀜(R) 66개만 보인다. --- .../decisions => adr}/VD-01-typescript-lint-tooling.md | 0 .../decisions => adr}/VD-03-react-router-data-mode.md | 0 docs/{architecture/decisions => adr}/VD-04-native-form-facade.md | 0 .../{architecture/decisions => adr}/VD-05-icon-and-headless-ui.md | 0 .../decisions => adr}/VD-06-intl-typed-message-catalog.md | 0 .../decisions => adr}/VD-07-diagnostics-and-telemetry-exporter.md | 0 .../decisions => adr}/VD-08-storybook-and-visual-evidence.md | 0 .../decisions => adr}/VD-09-supply-chain-evidence.md | 0 .../decisions => adr}/VD-10-optional-capability-recipes.md | 0 .../decisions => adr}/VD-11-browser-file-and-origin-storage.md | 0 .../decisions => adr}/VD-12-presigned-transfer-and-image-cdn.md | 0 .../decisions => adr}/VD-13-client-cache-scope-and-persistence.md | 0 .../VD-14-resumable-download-and-background-transfer.md | 0 .../VD-15-origin-storage-lifecycle-and-migration.md | 0 .../VD-16-browser-transfer-composition-and-image-delivery.md | 0 .../VD-23-api-transport-selection-and-rest-execution.md | 0 .../decisions => adr}/VD-24-runtime-schema-and-boundary-mapper.md | 0 .../decisions => adr}/VD-25-server-state-cache-lifecycle.md | 0 .../decisions => adr}/VD-26-persisted-graphql-operation.md | 0 .../decisions => adr}/VD-27-grpc-web-unary-and-server-stream.md | 0 .../VD-28-realtime-events-web-push-and-bounded-polling.md | 0 .../VD-29-connect-web-and-browser-protobuf-runtime.md | 0 .../decisions => adr}/VD-30-protobuf-contract-and-rest-gateway.md | 0 .../2026-07-26-design-system-platform-design.md} | 0 .../2026-07-26-frontend-platform-capability-review-design.md} | 0 ...2026-07-26-frontend-platform-implementation-roadmap-design.md} | 0 .../2026-07-26-frontend-platform-testing-strategy-design.md} | 0 .../2026-07-26-frontend-ports-adapters-and-boundaries-design.md} | 0 .../2026-07-26-routing-pages-and-patterns-design.md} | 0 .../2026-07-26-typescript-state-and-data-flow-design.md} | 0 .../2026-07-27-browser-file-and-origin-storage-design.md} | 0 ...6-07-28-api-contract-schema-mapper-and-server-state-design.md} | 0 .../2026-07-28-client-cache-and-storage-design.md} | 0 ...6-07-28-protobuf-browser-transport-and-rest-gateway-design.md} | 0 .../2026-07-28-server-file-capability-infrastructure-design.md} | 0 ...026-07-30-browser-data-capability-completion-ledger-design.md} | 0 ...bility-repository-aligned-implementation-closed-deep-design.md | 0 .../2026-07-30-presigned-transfer-and-image-cdn-design.md} | 0 ...-07-30-realtime-events-web-push-and-bounded-polling-design.md} | 0 .../specs => design}/2026-07-31-platform-overview-page-design.md | 0 .../2026-08-01-refactoring-review-remediation-design.md | 0 .../2026-08-01-runtime-integrity-refactor-design.md | 0 ...026-08-02-platform-owned-frontend-assurance-delivery-design.md | 0 .../specs => design}/2026-08-02-provider-raw-guardian-design.md | 0 .../2026-08-02-v8-coverage-counter-contract-design.md | 0 .../specs => design}/2026-09-16-adapter-barrel-boundary-design.md | 0 .../2026-09-16-indexeddb-kernel-promotion-design.md | 0 .../2026-09-20-memento-frontend-template-bootstrap-design.md | 0 .../plans/2026-07-31-platform-overview-completion.md | 0 .../plans/2026-08-01-http-worker-adapter-remediation.md | 0 .../plans/2026-08-01-quality-architecture-remediation.md | 0 .../plans/2026-08-01-release-boot-integrity.md | 0 .../plans/2026-08-01-release-evidence-remediation.md | 0 .../plans/2026-08-01-runtime-correctness-remediation.md | 0 .../plans/2026-08-01-scope-owned-server-state.md | 0 .../plans/2026-08-02-cicd-frontend-assurance-delivery.md | 0 .../plans/2026-08-02-counter-bearing-coverage-provenance.md | 0 .../plans/2026-08-02-frontend-platform-consumer-migration.md | 0 .../plans/2026-08-02-promotion-security-review-fixes.md | 0 .../plans/2026-08-02-provider-raw-guardian.md | 0 .../plans/2026-08-02-security-finalizer.md | 0 .../plans/2026-08-02-test-assurance-frontend-capabilities.md | 0 .../plans/2026-08-02-v8-coverage-counter-contract.md | 0 .../plans/2026-08-13-adapter-remediation.md | 0 .../plans/2026-09-16-adapter-barrel-boundary.md | 0 .../plans/2026-09-16-indexeddb-kernel-promotion.md | 0 66 files changed, 0 insertions(+), 0 deletions(-) rename docs/{architecture/decisions => adr}/VD-01-typescript-lint-tooling.md (100%) rename docs/{architecture/decisions => adr}/VD-03-react-router-data-mode.md (100%) rename docs/{architecture/decisions => adr}/VD-04-native-form-facade.md (100%) rename docs/{architecture/decisions => adr}/VD-05-icon-and-headless-ui.md (100%) rename docs/{architecture/decisions => adr}/VD-06-intl-typed-message-catalog.md (100%) rename docs/{architecture/decisions => adr}/VD-07-diagnostics-and-telemetry-exporter.md (100%) rename docs/{architecture/decisions => adr}/VD-08-storybook-and-visual-evidence.md (100%) rename docs/{architecture/decisions => adr}/VD-09-supply-chain-evidence.md (100%) rename docs/{architecture/decisions => adr}/VD-10-optional-capability-recipes.md (100%) rename docs/{architecture/decisions => adr}/VD-11-browser-file-and-origin-storage.md (100%) rename docs/{architecture/decisions => adr}/VD-12-presigned-transfer-and-image-cdn.md (100%) rename docs/{architecture/decisions => adr}/VD-13-client-cache-scope-and-persistence.md (100%) rename docs/{architecture/decisions => adr}/VD-14-resumable-download-and-background-transfer.md (100%) rename docs/{architecture/decisions => adr}/VD-15-origin-storage-lifecycle-and-migration.md (100%) rename docs/{architecture/decisions => adr}/VD-16-browser-transfer-composition-and-image-delivery.md (100%) rename docs/{architecture/decisions => adr}/VD-23-api-transport-selection-and-rest-execution.md (100%) rename docs/{architecture/decisions => adr}/VD-24-runtime-schema-and-boundary-mapper.md (100%) rename docs/{architecture/decisions => adr}/VD-25-server-state-cache-lifecycle.md (100%) rename docs/{architecture/decisions => adr}/VD-26-persisted-graphql-operation.md (100%) rename docs/{architecture/decisions => adr}/VD-27-grpc-web-unary-and-server-stream.md (100%) rename docs/{architecture/decisions => adr}/VD-28-realtime-events-web-push-and-bounded-polling.md (100%) rename docs/{architecture/decisions => adr}/VD-29-connect-web-and-browser-protobuf-runtime.md (100%) rename docs/{architecture/decisions => adr}/VD-30-protobuf-contract-and-rest-gateway.md (100%) rename docs/{styling/design-system-platform.md => design/2026-07-26-design-system-platform-design.md} (100%) rename docs/{architecture/frontend-platform-capability-review.md => design/2026-07-26-frontend-platform-capability-review-design.md} (100%) rename docs/{architecture/frontend-platform-implementation-roadmap.md => design/2026-07-26-frontend-platform-implementation-roadmap-design.md} (100%) rename docs/{testing/frontend-platform-testing-strategy.md => design/2026-07-26-frontend-platform-testing-strategy-design.md} (100%) rename docs/{architecture/frontend-ports-adapters-and-boundaries.md => design/2026-07-26-frontend-ports-adapters-and-boundaries-design.md} (100%) rename docs/{architecture/routing-pages-and-patterns.md => design/2026-07-26-routing-pages-and-patterns-design.md} (100%) rename docs/{architecture/typescript-state-and-data-flow.md => design/2026-07-26-typescript-state-and-data-flow-design.md} (100%) rename docs/{architecture/browser-file-and-origin-storage.md => design/2026-07-27-browser-file-and-origin-storage-design.md} (100%) rename docs/{architecture/api-contract-schema-mapper-and-server-state.md => design/2026-07-28-api-contract-schema-mapper-and-server-state-design.md} (100%) rename docs/{architecture/client-cache-and-storage.md => design/2026-07-28-client-cache-and-storage-design.md} (100%) rename docs/{architecture/protobuf-browser-transport-and-rest-gateway.md => design/2026-07-28-protobuf-browser-transport-and-rest-gateway-design.md} (100%) rename docs/{architecture/server-file-capability-infrastructure.md => design/2026-07-28-server-file-capability-infrastructure-design.md} (100%) rename docs/{architecture/browser-data-capability-completion-ledger.md => design/2026-07-30-browser-data-capability-completion-ledger-design.md} (100%) rename docs/{architecture => design}/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md (100%) rename docs/{architecture/presigned-transfer-and-image-cdn.md => design/2026-07-30-presigned-transfer-and-image-cdn-design.md} (100%) rename docs/{architecture/realtime-events-web-push-and-bounded-polling.md => design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md} (100%) rename docs/{superpowers/specs => design}/2026-07-31-platform-overview-page-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-01-refactoring-review-remediation-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-01-runtime-integrity-refactor-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-02-platform-owned-frontend-assurance-delivery-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-02-provider-raw-guardian-design.md (100%) rename docs/{superpowers/specs => design}/2026-08-02-v8-coverage-counter-contract-design.md (100%) rename docs/{superpowers/specs => design}/2026-09-16-adapter-barrel-boundary-design.md (100%) rename docs/{superpowers/specs => design}/2026-09-16-indexeddb-kernel-promotion-design.md (100%) rename docs/{superpowers/specs => design}/2026-09-20-memento-frontend-template-bootstrap-design.md (100%) rename docs/{superpowers => history}/plans/2026-07-31-platform-overview-completion.md (100%) rename docs/{superpowers => history}/plans/2026-08-01-http-worker-adapter-remediation.md (100%) rename docs/{superpowers => history}/plans/2026-08-01-quality-architecture-remediation.md (100%) rename docs/{superpowers => history}/plans/2026-08-01-release-boot-integrity.md (100%) rename docs/{superpowers => history}/plans/2026-08-01-release-evidence-remediation.md (100%) rename docs/{superpowers => history}/plans/2026-08-01-runtime-correctness-remediation.md (100%) rename docs/{superpowers => history}/plans/2026-08-01-scope-owned-server-state.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-cicd-frontend-assurance-delivery.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-counter-bearing-coverage-provenance.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-frontend-platform-consumer-migration.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-promotion-security-review-fixes.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-provider-raw-guardian.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-security-finalizer.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-test-assurance-frontend-capabilities.md (100%) rename docs/{superpowers => history}/plans/2026-08-02-v8-coverage-counter-contract.md (100%) rename docs/{superpowers => history}/plans/2026-08-13-adapter-remediation.md (100%) rename docs/{superpowers => history}/plans/2026-09-16-adapter-barrel-boundary.md (100%) rename docs/{superpowers => history}/plans/2026-09-16-indexeddb-kernel-promotion.md (100%) diff --git a/docs/architecture/decisions/VD-01-typescript-lint-tooling.md b/docs/adr/VD-01-typescript-lint-tooling.md similarity index 100% rename from docs/architecture/decisions/VD-01-typescript-lint-tooling.md rename to docs/adr/VD-01-typescript-lint-tooling.md diff --git a/docs/architecture/decisions/VD-03-react-router-data-mode.md b/docs/adr/VD-03-react-router-data-mode.md similarity index 100% rename from docs/architecture/decisions/VD-03-react-router-data-mode.md rename to docs/adr/VD-03-react-router-data-mode.md diff --git a/docs/architecture/decisions/VD-04-native-form-facade.md b/docs/adr/VD-04-native-form-facade.md similarity index 100% rename from docs/architecture/decisions/VD-04-native-form-facade.md rename to docs/adr/VD-04-native-form-facade.md diff --git a/docs/architecture/decisions/VD-05-icon-and-headless-ui.md b/docs/adr/VD-05-icon-and-headless-ui.md similarity index 100% rename from docs/architecture/decisions/VD-05-icon-and-headless-ui.md rename to docs/adr/VD-05-icon-and-headless-ui.md diff --git a/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md b/docs/adr/VD-06-intl-typed-message-catalog.md similarity index 100% rename from docs/architecture/decisions/VD-06-intl-typed-message-catalog.md rename to docs/adr/VD-06-intl-typed-message-catalog.md diff --git a/docs/architecture/decisions/VD-07-diagnostics-and-telemetry-exporter.md b/docs/adr/VD-07-diagnostics-and-telemetry-exporter.md similarity index 100% rename from docs/architecture/decisions/VD-07-diagnostics-and-telemetry-exporter.md rename to docs/adr/VD-07-diagnostics-and-telemetry-exporter.md diff --git a/docs/architecture/decisions/VD-08-storybook-and-visual-evidence.md b/docs/adr/VD-08-storybook-and-visual-evidence.md similarity index 100% rename from docs/architecture/decisions/VD-08-storybook-and-visual-evidence.md rename to docs/adr/VD-08-storybook-and-visual-evidence.md diff --git a/docs/architecture/decisions/VD-09-supply-chain-evidence.md b/docs/adr/VD-09-supply-chain-evidence.md similarity index 100% rename from docs/architecture/decisions/VD-09-supply-chain-evidence.md rename to docs/adr/VD-09-supply-chain-evidence.md diff --git a/docs/architecture/decisions/VD-10-optional-capability-recipes.md b/docs/adr/VD-10-optional-capability-recipes.md similarity index 100% rename from docs/architecture/decisions/VD-10-optional-capability-recipes.md rename to docs/adr/VD-10-optional-capability-recipes.md diff --git a/docs/architecture/decisions/VD-11-browser-file-and-origin-storage.md b/docs/adr/VD-11-browser-file-and-origin-storage.md similarity index 100% rename from docs/architecture/decisions/VD-11-browser-file-and-origin-storage.md rename to docs/adr/VD-11-browser-file-and-origin-storage.md diff --git a/docs/architecture/decisions/VD-12-presigned-transfer-and-image-cdn.md b/docs/adr/VD-12-presigned-transfer-and-image-cdn.md similarity index 100% rename from docs/architecture/decisions/VD-12-presigned-transfer-and-image-cdn.md rename to docs/adr/VD-12-presigned-transfer-and-image-cdn.md diff --git a/docs/architecture/decisions/VD-13-client-cache-scope-and-persistence.md b/docs/adr/VD-13-client-cache-scope-and-persistence.md similarity index 100% rename from docs/architecture/decisions/VD-13-client-cache-scope-and-persistence.md rename to docs/adr/VD-13-client-cache-scope-and-persistence.md diff --git a/docs/architecture/decisions/VD-14-resumable-download-and-background-transfer.md b/docs/adr/VD-14-resumable-download-and-background-transfer.md similarity index 100% rename from docs/architecture/decisions/VD-14-resumable-download-and-background-transfer.md rename to docs/adr/VD-14-resumable-download-and-background-transfer.md diff --git a/docs/architecture/decisions/VD-15-origin-storage-lifecycle-and-migration.md b/docs/adr/VD-15-origin-storage-lifecycle-and-migration.md similarity index 100% rename from docs/architecture/decisions/VD-15-origin-storage-lifecycle-and-migration.md rename to docs/adr/VD-15-origin-storage-lifecycle-and-migration.md diff --git a/docs/architecture/decisions/VD-16-browser-transfer-composition-and-image-delivery.md b/docs/adr/VD-16-browser-transfer-composition-and-image-delivery.md similarity index 100% rename from docs/architecture/decisions/VD-16-browser-transfer-composition-and-image-delivery.md rename to docs/adr/VD-16-browser-transfer-composition-and-image-delivery.md diff --git a/docs/architecture/decisions/VD-23-api-transport-selection-and-rest-execution.md b/docs/adr/VD-23-api-transport-selection-and-rest-execution.md similarity index 100% rename from docs/architecture/decisions/VD-23-api-transport-selection-and-rest-execution.md rename to docs/adr/VD-23-api-transport-selection-and-rest-execution.md diff --git a/docs/architecture/decisions/VD-24-runtime-schema-and-boundary-mapper.md b/docs/adr/VD-24-runtime-schema-and-boundary-mapper.md similarity index 100% rename from docs/architecture/decisions/VD-24-runtime-schema-and-boundary-mapper.md rename to docs/adr/VD-24-runtime-schema-and-boundary-mapper.md diff --git a/docs/architecture/decisions/VD-25-server-state-cache-lifecycle.md b/docs/adr/VD-25-server-state-cache-lifecycle.md similarity index 100% rename from docs/architecture/decisions/VD-25-server-state-cache-lifecycle.md rename to docs/adr/VD-25-server-state-cache-lifecycle.md diff --git a/docs/architecture/decisions/VD-26-persisted-graphql-operation.md b/docs/adr/VD-26-persisted-graphql-operation.md similarity index 100% rename from docs/architecture/decisions/VD-26-persisted-graphql-operation.md rename to docs/adr/VD-26-persisted-graphql-operation.md diff --git a/docs/architecture/decisions/VD-27-grpc-web-unary-and-server-stream.md b/docs/adr/VD-27-grpc-web-unary-and-server-stream.md similarity index 100% rename from docs/architecture/decisions/VD-27-grpc-web-unary-and-server-stream.md rename to docs/adr/VD-27-grpc-web-unary-and-server-stream.md diff --git a/docs/architecture/decisions/VD-28-realtime-events-web-push-and-bounded-polling.md b/docs/adr/VD-28-realtime-events-web-push-and-bounded-polling.md similarity index 100% rename from docs/architecture/decisions/VD-28-realtime-events-web-push-and-bounded-polling.md rename to docs/adr/VD-28-realtime-events-web-push-and-bounded-polling.md diff --git a/docs/architecture/decisions/VD-29-connect-web-and-browser-protobuf-runtime.md b/docs/adr/VD-29-connect-web-and-browser-protobuf-runtime.md similarity index 100% rename from docs/architecture/decisions/VD-29-connect-web-and-browser-protobuf-runtime.md rename to docs/adr/VD-29-connect-web-and-browser-protobuf-runtime.md diff --git a/docs/architecture/decisions/VD-30-protobuf-contract-and-rest-gateway.md b/docs/adr/VD-30-protobuf-contract-and-rest-gateway.md similarity index 100% rename from docs/architecture/decisions/VD-30-protobuf-contract-and-rest-gateway.md rename to docs/adr/VD-30-protobuf-contract-and-rest-gateway.md diff --git a/docs/styling/design-system-platform.md b/docs/design/2026-07-26-design-system-platform-design.md similarity index 100% rename from docs/styling/design-system-platform.md rename to docs/design/2026-07-26-design-system-platform-design.md diff --git a/docs/architecture/frontend-platform-capability-review.md b/docs/design/2026-07-26-frontend-platform-capability-review-design.md similarity index 100% rename from docs/architecture/frontend-platform-capability-review.md rename to docs/design/2026-07-26-frontend-platform-capability-review-design.md diff --git a/docs/architecture/frontend-platform-implementation-roadmap.md b/docs/design/2026-07-26-frontend-platform-implementation-roadmap-design.md similarity index 100% rename from docs/architecture/frontend-platform-implementation-roadmap.md rename to docs/design/2026-07-26-frontend-platform-implementation-roadmap-design.md diff --git a/docs/testing/frontend-platform-testing-strategy.md b/docs/design/2026-07-26-frontend-platform-testing-strategy-design.md similarity index 100% rename from docs/testing/frontend-platform-testing-strategy.md rename to docs/design/2026-07-26-frontend-platform-testing-strategy-design.md diff --git a/docs/architecture/frontend-ports-adapters-and-boundaries.md b/docs/design/2026-07-26-frontend-ports-adapters-and-boundaries-design.md similarity index 100% rename from docs/architecture/frontend-ports-adapters-and-boundaries.md rename to docs/design/2026-07-26-frontend-ports-adapters-and-boundaries-design.md diff --git a/docs/architecture/routing-pages-and-patterns.md b/docs/design/2026-07-26-routing-pages-and-patterns-design.md similarity index 100% rename from docs/architecture/routing-pages-and-patterns.md rename to docs/design/2026-07-26-routing-pages-and-patterns-design.md diff --git a/docs/architecture/typescript-state-and-data-flow.md b/docs/design/2026-07-26-typescript-state-and-data-flow-design.md similarity index 100% rename from docs/architecture/typescript-state-and-data-flow.md rename to docs/design/2026-07-26-typescript-state-and-data-flow-design.md diff --git a/docs/architecture/browser-file-and-origin-storage.md b/docs/design/2026-07-27-browser-file-and-origin-storage-design.md similarity index 100% rename from docs/architecture/browser-file-and-origin-storage.md rename to docs/design/2026-07-27-browser-file-and-origin-storage-design.md diff --git a/docs/architecture/api-contract-schema-mapper-and-server-state.md b/docs/design/2026-07-28-api-contract-schema-mapper-and-server-state-design.md similarity index 100% rename from docs/architecture/api-contract-schema-mapper-and-server-state.md rename to docs/design/2026-07-28-api-contract-schema-mapper-and-server-state-design.md diff --git a/docs/architecture/client-cache-and-storage.md b/docs/design/2026-07-28-client-cache-and-storage-design.md similarity index 100% rename from docs/architecture/client-cache-and-storage.md rename to docs/design/2026-07-28-client-cache-and-storage-design.md diff --git a/docs/architecture/protobuf-browser-transport-and-rest-gateway.md b/docs/design/2026-07-28-protobuf-browser-transport-and-rest-gateway-design.md similarity index 100% rename from docs/architecture/protobuf-browser-transport-and-rest-gateway.md rename to docs/design/2026-07-28-protobuf-browser-transport-and-rest-gateway-design.md diff --git a/docs/architecture/server-file-capability-infrastructure.md b/docs/design/2026-07-28-server-file-capability-infrastructure-design.md similarity index 100% rename from docs/architecture/server-file-capability-infrastructure.md rename to docs/design/2026-07-28-server-file-capability-infrastructure-design.md diff --git a/docs/architecture/browser-data-capability-completion-ledger.md b/docs/design/2026-07-30-browser-data-capability-completion-ledger-design.md similarity index 100% rename from docs/architecture/browser-data-capability-completion-ledger.md rename to docs/design/2026-07-30-browser-data-capability-completion-ledger-design.md diff --git a/docs/architecture/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md b/docs/design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md similarity index 100% rename from docs/architecture/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md rename to docs/design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md diff --git a/docs/architecture/presigned-transfer-and-image-cdn.md b/docs/design/2026-07-30-presigned-transfer-and-image-cdn-design.md similarity index 100% rename from docs/architecture/presigned-transfer-and-image-cdn.md rename to docs/design/2026-07-30-presigned-transfer-and-image-cdn-design.md diff --git a/docs/architecture/realtime-events-web-push-and-bounded-polling.md b/docs/design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md similarity index 100% rename from docs/architecture/realtime-events-web-push-and-bounded-polling.md rename to docs/design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md diff --git a/docs/superpowers/specs/2026-07-31-platform-overview-page-design.md b/docs/design/2026-07-31-platform-overview-page-design.md similarity index 100% rename from docs/superpowers/specs/2026-07-31-platform-overview-page-design.md rename to docs/design/2026-07-31-platform-overview-page-design.md diff --git a/docs/superpowers/specs/2026-08-01-refactoring-review-remediation-design.md b/docs/design/2026-08-01-refactoring-review-remediation-design.md similarity index 100% rename from docs/superpowers/specs/2026-08-01-refactoring-review-remediation-design.md rename to docs/design/2026-08-01-refactoring-review-remediation-design.md diff --git a/docs/superpowers/specs/2026-08-01-runtime-integrity-refactor-design.md b/docs/design/2026-08-01-runtime-integrity-refactor-design.md similarity index 100% rename from docs/superpowers/specs/2026-08-01-runtime-integrity-refactor-design.md rename to docs/design/2026-08-01-runtime-integrity-refactor-design.md diff --git a/docs/superpowers/specs/2026-08-02-platform-owned-frontend-assurance-delivery-design.md b/docs/design/2026-08-02-platform-owned-frontend-assurance-delivery-design.md similarity index 100% rename from docs/superpowers/specs/2026-08-02-platform-owned-frontend-assurance-delivery-design.md rename to docs/design/2026-08-02-platform-owned-frontend-assurance-delivery-design.md diff --git a/docs/superpowers/specs/2026-08-02-provider-raw-guardian-design.md b/docs/design/2026-08-02-provider-raw-guardian-design.md similarity index 100% rename from docs/superpowers/specs/2026-08-02-provider-raw-guardian-design.md rename to docs/design/2026-08-02-provider-raw-guardian-design.md diff --git a/docs/superpowers/specs/2026-08-02-v8-coverage-counter-contract-design.md b/docs/design/2026-08-02-v8-coverage-counter-contract-design.md similarity index 100% rename from docs/superpowers/specs/2026-08-02-v8-coverage-counter-contract-design.md rename to docs/design/2026-08-02-v8-coverage-counter-contract-design.md diff --git a/docs/superpowers/specs/2026-09-16-adapter-barrel-boundary-design.md b/docs/design/2026-09-16-adapter-barrel-boundary-design.md similarity index 100% rename from docs/superpowers/specs/2026-09-16-adapter-barrel-boundary-design.md rename to docs/design/2026-09-16-adapter-barrel-boundary-design.md diff --git a/docs/superpowers/specs/2026-09-16-indexeddb-kernel-promotion-design.md b/docs/design/2026-09-16-indexeddb-kernel-promotion-design.md similarity index 100% rename from docs/superpowers/specs/2026-09-16-indexeddb-kernel-promotion-design.md rename to docs/design/2026-09-16-indexeddb-kernel-promotion-design.md diff --git a/docs/superpowers/specs/2026-09-20-memento-frontend-template-bootstrap-design.md b/docs/design/2026-09-20-memento-frontend-template-bootstrap-design.md similarity index 100% rename from docs/superpowers/specs/2026-09-20-memento-frontend-template-bootstrap-design.md rename to docs/design/2026-09-20-memento-frontend-template-bootstrap-design.md diff --git a/docs/superpowers/plans/2026-07-31-platform-overview-completion.md b/docs/history/plans/2026-07-31-platform-overview-completion.md similarity index 100% rename from docs/superpowers/plans/2026-07-31-platform-overview-completion.md rename to docs/history/plans/2026-07-31-platform-overview-completion.md diff --git a/docs/superpowers/plans/2026-08-01-http-worker-adapter-remediation.md b/docs/history/plans/2026-08-01-http-worker-adapter-remediation.md similarity index 100% rename from docs/superpowers/plans/2026-08-01-http-worker-adapter-remediation.md rename to docs/history/plans/2026-08-01-http-worker-adapter-remediation.md diff --git a/docs/superpowers/plans/2026-08-01-quality-architecture-remediation.md b/docs/history/plans/2026-08-01-quality-architecture-remediation.md similarity index 100% rename from docs/superpowers/plans/2026-08-01-quality-architecture-remediation.md rename to docs/history/plans/2026-08-01-quality-architecture-remediation.md diff --git a/docs/superpowers/plans/2026-08-01-release-boot-integrity.md b/docs/history/plans/2026-08-01-release-boot-integrity.md similarity index 100% rename from docs/superpowers/plans/2026-08-01-release-boot-integrity.md rename to docs/history/plans/2026-08-01-release-boot-integrity.md diff --git a/docs/superpowers/plans/2026-08-01-release-evidence-remediation.md b/docs/history/plans/2026-08-01-release-evidence-remediation.md similarity index 100% rename from docs/superpowers/plans/2026-08-01-release-evidence-remediation.md rename to docs/history/plans/2026-08-01-release-evidence-remediation.md diff --git a/docs/superpowers/plans/2026-08-01-runtime-correctness-remediation.md b/docs/history/plans/2026-08-01-runtime-correctness-remediation.md similarity index 100% rename from docs/superpowers/plans/2026-08-01-runtime-correctness-remediation.md rename to docs/history/plans/2026-08-01-runtime-correctness-remediation.md diff --git a/docs/superpowers/plans/2026-08-01-scope-owned-server-state.md b/docs/history/plans/2026-08-01-scope-owned-server-state.md similarity index 100% rename from docs/superpowers/plans/2026-08-01-scope-owned-server-state.md rename to docs/history/plans/2026-08-01-scope-owned-server-state.md diff --git a/docs/superpowers/plans/2026-08-02-cicd-frontend-assurance-delivery.md b/docs/history/plans/2026-08-02-cicd-frontend-assurance-delivery.md similarity index 100% rename from docs/superpowers/plans/2026-08-02-cicd-frontend-assurance-delivery.md rename to docs/history/plans/2026-08-02-cicd-frontend-assurance-delivery.md diff --git a/docs/superpowers/plans/2026-08-02-counter-bearing-coverage-provenance.md b/docs/history/plans/2026-08-02-counter-bearing-coverage-provenance.md similarity index 100% rename from docs/superpowers/plans/2026-08-02-counter-bearing-coverage-provenance.md rename to docs/history/plans/2026-08-02-counter-bearing-coverage-provenance.md diff --git a/docs/superpowers/plans/2026-08-02-frontend-platform-consumer-migration.md b/docs/history/plans/2026-08-02-frontend-platform-consumer-migration.md similarity index 100% rename from docs/superpowers/plans/2026-08-02-frontend-platform-consumer-migration.md rename to docs/history/plans/2026-08-02-frontend-platform-consumer-migration.md diff --git a/docs/superpowers/plans/2026-08-02-promotion-security-review-fixes.md b/docs/history/plans/2026-08-02-promotion-security-review-fixes.md similarity index 100% rename from docs/superpowers/plans/2026-08-02-promotion-security-review-fixes.md rename to docs/history/plans/2026-08-02-promotion-security-review-fixes.md diff --git a/docs/superpowers/plans/2026-08-02-provider-raw-guardian.md b/docs/history/plans/2026-08-02-provider-raw-guardian.md similarity index 100% rename from docs/superpowers/plans/2026-08-02-provider-raw-guardian.md rename to docs/history/plans/2026-08-02-provider-raw-guardian.md diff --git a/docs/superpowers/plans/2026-08-02-security-finalizer.md b/docs/history/plans/2026-08-02-security-finalizer.md similarity index 100% rename from docs/superpowers/plans/2026-08-02-security-finalizer.md rename to docs/history/plans/2026-08-02-security-finalizer.md diff --git a/docs/superpowers/plans/2026-08-02-test-assurance-frontend-capabilities.md b/docs/history/plans/2026-08-02-test-assurance-frontend-capabilities.md similarity index 100% rename from docs/superpowers/plans/2026-08-02-test-assurance-frontend-capabilities.md rename to docs/history/plans/2026-08-02-test-assurance-frontend-capabilities.md diff --git a/docs/superpowers/plans/2026-08-02-v8-coverage-counter-contract.md b/docs/history/plans/2026-08-02-v8-coverage-counter-contract.md similarity index 100% rename from docs/superpowers/plans/2026-08-02-v8-coverage-counter-contract.md rename to docs/history/plans/2026-08-02-v8-coverage-counter-contract.md diff --git a/docs/superpowers/plans/2026-08-13-adapter-remediation.md b/docs/history/plans/2026-08-13-adapter-remediation.md similarity index 100% rename from docs/superpowers/plans/2026-08-13-adapter-remediation.md rename to docs/history/plans/2026-08-13-adapter-remediation.md diff --git a/docs/superpowers/plans/2026-09-16-adapter-barrel-boundary.md b/docs/history/plans/2026-09-16-adapter-barrel-boundary.md similarity index 100% rename from docs/superpowers/plans/2026-09-16-adapter-barrel-boundary.md rename to docs/history/plans/2026-09-16-adapter-barrel-boundary.md diff --git a/docs/superpowers/plans/2026-09-16-indexeddb-kernel-promotion.md b/docs/history/plans/2026-09-16-indexeddb-kernel-promotion.md similarity index 100% rename from docs/superpowers/plans/2026-09-16-indexeddb-kernel-promotion.md rename to docs/history/plans/2026-09-16-indexeddb-kernel-promotion.md