diff --git a/PRODUCT.md b/PRODUCT.md
index 5d612657..d6263b02 100644
--- a/PRODUCT.md
+++ b/PRODUCT.md
@@ -8,7 +8,7 @@ web
## Users
-- **템플릿을 가져다 쓰는 개발자**: 이 템플릿으로 새 서비스를 빠르게 시작하는 사람입니다. 예제 화면(홈, 플랫폼 구성, UI 구성요소, 화면 상태, 인증 연동, Reference feature)은 이 사람이 실행 구조와 공통 동작을 확인하는 용도입니다.
+- **템플릿을 가져다 쓰는 개발자**: 이 템플릿으로 새 서비스를 빠르게 시작하는 사람입니다. 기본 화면(홈, 플랫폼 구성)과 Storybook 갤러리(UI 구성요소, 화면 상태)는 이 사람이 실행 구조와 공통 동작을 확인하는 용도입니다.
- **파생 서비스의 최종 사용자**: 디자인 시스템(토큰, 프리미티브, 패턴, 레이아웃, 페이지 템플릿)은 이 템플릿으로 만든 서비스를 실제로 쓰는 사람을 기준으로 합니다.
## Product Purpose
@@ -30,7 +30,7 @@ web
- 하나의 디자인 시스템으로 세 종류의 서비스를 받칩니다. 업무용·관리 도구(대시보드, 어드민, 설정), 일반 사용자용 웹 서비스, 소개·랜딩 페이지입니다.
- 디자인 시스템 위치는 `src/presentation/design-system/`입니다. 토큰은 primitive → semantic → component 세 단계로 파생됩니다(`tokens/primitive.css`, `semantic.css`, `component.css`).
- 시각 회귀 골든이 `tests/visual/__snapshots__/`에 있습니다. 화면을 바꾸면 골든도 의도적으로 갱신해야 합니다.
-- 참조 기능(`src/features/reference-feature/`)은 `test:sample-removal`로 지울 수 있습니다. 예제 화면 3개(`/examples/ui`, `states`, `auth`)도 기능 `platform-examples-feature`라서 같은 드릴(`test:sample-removal -- --feature=platform-examples-feature`)로 지울 수 있습니다. 플랫폼 구성 화면(`/examples/platform`)과 홈은 기본 구성이고 제거 드릴이 없습니다. 그래서 예제 화면 3개에만 넣은 디자인은 예제를 지운 파생 서비스에서 함께 사라지고, 홈과 플랫폼 구성 화면에 넣은 디자인은 남습니다.
+- 템플릿에는 샘플 기능이 없습니다(참조 기능과 예제 화면은 2026-11-07에 지웠습니다). 기능은 `create:feature`로 만듭니다. 디자인 시스템 갤러리와 화면 상태 갤러리는 Storybook story(`src/presentation/design-system/galleries.stories.tsx`)이고 시각 회귀 골든의 대상입니다. 플랫폼 구성 화면(`/examples/platform`)과 홈은 기본 구성입니다. 그래서 갤러리와 홈, 플랫폼 구성 화면에 넣은 디자인은 파생 서비스에 남습니다.
- 어떤 서비스가 먼저 만들어질지, 서비스별 우선순위는 아직 정하지 않았습니다.
## Brand Commitments
diff --git a/README.md b/README.md
index f5e039ca..8b0d536b 100644
--- a/README.md
+++ b/README.md
@@ -87,8 +87,8 @@ persistent `system` / `light` / `dark` theme selector, and a language selector.
The route list is `ROUTE_REGISTRY` (`src/features/installed-feature-contracts.ts`):
the platform routes of `src/contracts/routes.ts` plus the routes of every
-installed feature, the removable reference feature included. The platform
-overview page (`/examples/platform`) shows the composed list at runtime, so
+installed feature. The template installs none: `corepack pnpm create:feature`
+adds one (`docs/manual/`). The platform overview page (`/examples/platform`) shows the composed list at runtime, so
this README keeps no copy of it and adding a feature does not edit it.
`AUTH_MODE=demo` is credential-free and accepted only in local/development
@@ -105,7 +105,7 @@ design documents use; the next table maps them.
| Tier | What it covers | Status words |
| --- | --- | --- |
-| Default | In the default build and covered by the merge gates: the application shell and example routes, the REST HTTP executor, TanStack Query server state, Local/Session Storage registries, cross-tab invalidation, runtime config profiles and the release manifest check, `AUTH_MODE=external` (`demo` only in local/development), the typed message catalog, and the removable reference feature. `dist/` is served by a static host ([`docs/architecture/static-delivery.md`](docs/architecture/static-delivery.md)) | `COMPOSED` |
+| Default | In the default build and covered by the merge gates: the application shell and example routes, the REST HTTP executor, TanStack Query server state, Local/Session Storage registries, cross-tab invalidation, runtime config profiles and the release manifest check, `AUTH_MODE=external` (`demo` only in local/development), the typed message catalog, and `create:feature`, which writes a feature that passes the merge gates. `dist/` is served by a static host ([`docs/architecture/static-delivery.md`](docs/architecture/static-delivery.md)) | `COMPOSED` |
| Optional (recipe) | Not installed. A project copies one of the recipes in `config/recipes/frontend-capability-recipes.json` and narrows it ([`docs/architecture/optional-adapter-recipes.md`](docs/architecture/optional-adapter-recipes.md)). `realtime`, `offline-indexeddb`, `service-worker-pwa` and `file-transfer` also ship a tested reference runtime that the default build leaves out | `RECIPE_AVAILABLE`, `NOT_INSTALLED`, `AVAILABLE_NOT_COMPOSED` |
| Experimental | Designed and decided, but the runtime is missing or unfinished; finish it before building on it. GraphQL, gRPC-Web, Connect-Web and Protobuf adapters, Range resumable download, IndexedDB query persistence, the local preview decode-safety probe | `DESIGNED_NOT_IMPLEMENTED` |
| Not supported | Deliberately not selected, or browsers cannot guarantee it: SSR, app-managed background upload and download, directory selection, persistent file handles, product query persistence, exactly-once delivery between tabs | `NOT_SELECTED`, `PLATFORM_LIMITED` |
@@ -173,12 +173,13 @@ Domain code lives inside each feature; there is no top-level domain folder.
See
`docs/architecture/frontend-application-foundation.md`,
`docs/architecture/overview.md`, `docs/architecture/layers.md`, and
-`docs/architecture/starter-experience.md`. The removable vertical slice is
-under `src/features/reference-feature`; its domain, application input, HTTP
-binding, contracts, route runtime, and presentation own their contributions.
-The central installed catalogs only aggregate selected contributions. The
-generic starter routes continue to typecheck, test, and build after that
-feature is removed.
+`docs/architecture/starter-experience.md`. A feature is a vertical slice under
+`src/features/`; its domain, application input, HTTP binding, contracts,
+route runtime, and presentation own their contributions. The central installed
+catalogs only aggregate selected contributions. The template ships no feature
+(its reference sample and example screens were deleted on 2026-11-07):
+`corepack pnpm create:feature ` writes one, and the generic starter routes
+typecheck, test, and build without any.
### Platform capability review
@@ -229,15 +230,15 @@ reads them, except the one file noted below
| `CLAUDE.md` | review instructions for the template repository itself; replace it with your own |
| `PRODUCT.md` | product context of the template itself (users, purpose, principles) for design tools; replace it with your product's |
-The reference feature is not in this list: deleting its directory alone
-leaves tests, policy entries and CI scripts behind that fail the gates.
-`scripts/test-sample-removal.ts` removes it from a copy of
-the repository and lists everything that has to go with it (its header comment,
-and the files outside the feature's folders in
-`scripts/lib/removable-template-features.ts`); do the same in your project and
-run the gates. The documents keep naming the sample's paths: the documentation
-check accepts them once `src/features/reference-feature/feature-module.ts` is
-gone.
+A feature is not in this list: deleting its directory alone leaves tests,
+policy entries and CI scripts behind that fail the gates.
+`corepack pnpm test:sample-removal -- --feature=` removes it from a copy of
+the repository and lists everything that has to go with it (the header comment
+of `scripts/test-sample-removal.ts`); do the same in your project and run the
+gates. A sample your project keeps for a while can be listed in
+`scripts/lib/removable-template-features.ts`: the drill then removes it without
+`--feature`, and the documentation check accepts its paths once its
+`feature-module.ts` is gone.
## Verification
diff --git a/artifacts/tests/a11y-manual/EXAMPLES_AUTH.md b/artifacts/tests/a11y-manual/EXAMPLES_AUTH.md
deleted file mode 100644
index 8c6efa23..00000000
--- a/artifacts/tests/a11y-manual/EXAMPLES_AUTH.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# EXAMPLES_AUTH accessibility review
-
-Status: pending-manual-review
-Route ID: EXAMPLES_AUTH
-Release ID:
-Reviewer:
-Reviewed at:
-Signature:
-Attestation: pending
-M1 Keyboard: pending
-M2 Visible focus: pending
-M3 Route focus: pending
-M4 Modal focus: not-applicable (no modal on this route)
-M5 Error association: not-applicable (no form error on this route)
-M6 Color signal: pending
-M7 Reduced motion: pending
-Screen reader: pending
-Notes: Review session state announcements and unavailable external-integration behavior.
diff --git a/artifacts/tests/a11y-manual/EXAMPLES_STATES.md b/artifacts/tests/a11y-manual/EXAMPLES_STATES.md
deleted file mode 100644
index b071073a..00000000
--- a/artifacts/tests/a11y-manual/EXAMPLES_STATES.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# EXAMPLES_STATES accessibility review
-
-Status: pending-manual-review
-Route ID: EXAMPLES_STATES
-Release ID:
-Reviewer:
-Reviewed at:
-Signature:
-Attestation: pending
-M1 Keyboard: pending
-M2 Visible focus: pending
-M3 Route focus: pending
-M4 Modal focus: not-applicable (no modal on this route)
-M5 Error association: not-applicable (no form error on this route)
-M6 Color signal: pending
-M7 Reduced motion: pending
-Screen reader: pending
-Notes: Review loading, refresh, empty, error, authentication, forbidden, and not-found announcements.
diff --git a/artifacts/tests/a11y-manual/EXAMPLES_UI.md b/artifacts/tests/a11y-manual/EXAMPLES_UI.md
deleted file mode 100644
index 6f89235c..00000000
--- a/artifacts/tests/a11y-manual/EXAMPLES_UI.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# EXAMPLES_UI accessibility review
-
-Status: pending-manual-review
-Route ID: EXAMPLES_UI
-Release ID:
-Reviewer:
-Reviewed at:
-Signature:
-Attestation: pending
-M1 Keyboard: pending
-M2 Visible focus: pending
-M3 Route focus: pending
-M4 Modal focus: pending
-M5 Error association: pending
-M6 Color signal: pending
-M7 Reduced motion: pending
-Screen reader: pending
-Notes: Review form primitives, Menu/Tabs keyboard behavior, Toast announcements, Tooltip supplemental copy, text-field error association and modal focus containment/restoration.
diff --git a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_DETAIL.md b/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_DETAIL.md
deleted file mode 100644
index 81ebaae7..00000000
--- a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_DETAIL.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# REFERENCE_RESOURCE_DETAIL accessibility review
-
-Status: pending-manual-review
-Route ID: REFERENCE_RESOURCE_DETAIL
-Release ID:
-Reviewer:
-Reviewed at:
-Signature:
-Attestation: pending
-M1 Keyboard: pending
-M2 Visible focus: pending
-M3 Route focus: pending
-M4 Modal focus: not-applicable (no modal on this route)
-M5 Error association: not-applicable (no form error on this route)
-M6 Color signal: pending
-M7 Reduced motion: pending
-Screen reader: pending
-Notes: Human review pending.
diff --git a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_FORM.md b/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_FORM.md
deleted file mode 100644
index e78d1859..00000000
--- a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_FORM.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# REFERENCE_RESOURCE_FORM accessibility review
-
-Status: pending-manual-review
-Route ID: REFERENCE_RESOURCE_FORM
-Release ID:
-Reviewer:
-Reviewed at:
-Signature:
-Attestation: pending
-M1 Keyboard: pending
-M2 Visible focus: pending
-M3 Route focus: pending
-M4 Modal focus: pending
-M5 Error association: pending
-M6 Color signal: pending
-M7 Reduced motion: pending
-Screen reader: pending
-Notes: Human review pending.
diff --git a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_LIST.md b/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_LIST.md
deleted file mode 100644
index 74e9ae65..00000000
--- a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_LIST.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# REFERENCE_RESOURCE_LIST accessibility review
-
-Status: pending-manual-review
-Route ID: REFERENCE_RESOURCE_LIST
-Release ID:
-Reviewer:
-Reviewed at:
-Signature:
-Attestation: pending
-M1 Keyboard: pending
-M2 Visible focus: pending
-M3 Route focus: pending
-M4 Modal focus: not-applicable (no modal on this route)
-M5 Error association: not-applicable (no form error on this route)
-M6 Color signal: pending
-M7 Reduced motion: pending
-Screen reader: pending
-Notes: Human review pending.
diff --git a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_STATUS.md b/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_STATUS.md
deleted file mode 100644
index 93e37c45..00000000
--- a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_STATUS.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# REFERENCE_RESOURCE_STATUS accessibility review
-
-Status: pending-manual-review
-Route ID: REFERENCE_RESOURCE_STATUS
-Release ID:
-Reviewer:
-Reviewed at:
-Signature:
-Attestation: pending
-M1 Keyboard: pending
-M2 Visible focus: pending
-M3 Route focus: pending
-M4 Modal focus: not-applicable (no modal on this route)
-M5 Error association: not-applicable (no form error on this route)
-M6 Color signal: pending
-M7 Reduced motion: pending
-Screen reader: pending
-Notes: Human review pending.
diff --git a/config/ci/contract-baseline.json b/config/ci/contract-baseline.json
index 7e1243d0..439cde3c 100644
--- a/config/ci/contract-baseline.json
+++ b/config/ci/contract-baseline.json
@@ -1,11 +1,11 @@
{
"schemaVersion": 1,
"owner": "DongHyeonka",
- "reason": "1106/13-01: FE-GATE-027 runs the advisory scan before the release admission",
+ "reason": "2026-11-07 소유자 결정: 템플릿 샘플 삭제. 참조 기능 시험 명령과 그 산출물, 지운 라우트의 수동 a11y 기록 산출물 4개를 뺀다",
"gates": 27,
- "commands": 100,
- "commandReferences": 104,
- "artifacts": 110,
+ "commands": 99,
+ "commandReferences": 103,
+ "artifacts": 105,
"stages": 5,
- "gateShapeSha256": "7f6f3d975c62c022d6a6f8b5f39562f73de9ca0f22aa3d086ac28959e50fa93e"
+ "gateShapeSha256": "df584fba26f8448c6a77638351c6906ed91869da82e20f12ac71ea7b2037c989"
}
diff --git a/config/ci/gates.json b/config/ci/gates.json
index 500fca74..bb90e7c2 100644
--- a/config/ci/gates.json
+++ b/config/ci/gates.json
@@ -238,11 +238,6 @@
"script": "test:http-scenario-evidence",
"expect": "pass"
},
- {
- "id": "test-reference-feature",
- "script": "test:reference-feature",
- "expect": "pass"
- },
{
"id": "test-recipes",
"script": "test:recipes",
@@ -1028,15 +1023,6 @@
"test-http-scenario-evidence"
]
},
- {
- "id": "artifact-artifacts-tests-reference-feature-xml",
- "path": "artifacts/tests/reference-feature.xml",
- "schemaId": "junit",
- "production": "command-generated",
- "producerCommandIds": [
- "test-reference-feature"
- ]
- },
{
"id": "artifact-artifacts-tests-optional-recipes-xml",
"path": "artifacts/tests/optional-recipes.xml",
@@ -1163,30 +1149,6 @@
"schemaId": "markdown",
"production": "source-controlled"
},
- {
- "id": "artifact-artifacts-tests-a11y-manual-EXAMPLES-UI-md",
- "path": "artifacts/tests/a11y-manual/EXAMPLES_UI.md",
- "schemaId": "markdown",
- "production": "source-controlled"
- },
- {
- "id": "artifact-artifacts-tests-a11y-manual-EXAMPLES-STATES-md",
- "path": "artifacts/tests/a11y-manual/EXAMPLES_STATES.md",
- "schemaId": "markdown",
- "production": "source-controlled"
- },
- {
- "id": "artifact-artifacts-tests-a11y-manual-EXAMPLES-AUTH-md",
- "path": "artifacts/tests/a11y-manual/EXAMPLES_AUTH.md",
- "schemaId": "markdown",
- "production": "source-controlled"
- },
- {
- "id": "artifact-artifacts-tests-a11y-manual-REFERENCE-RESOURCE-LIST-md",
- "path": "artifacts/tests/a11y-manual/REFERENCE_RESOURCE_LIST.md",
- "schemaId": "markdown",
- "production": "source-controlled"
- },
{
"id": "artifact-artifacts-tests-a11y-manual-NOT-FOUND-md",
"path": "artifacts/tests/a11y-manual/NOT_FOUND.md",
@@ -1875,7 +1837,6 @@
"commandIds": [
"test-integration",
"test-http-scenario-evidence",
- "test-reference-feature",
"test-recipes"
],
"logArtifactId": "artifact-artifacts-quality-gates-FE-GATE-007-txt",
@@ -1884,7 +1845,6 @@
"artifact-artifacts-tests-http-scenario-executions-json",
"artifact-artifacts-quality-http-scenario-evidence-json",
"artifact-artifacts-quality-http-scenario-evidence-fixture-json",
- "artifact-artifacts-tests-reference-feature-xml",
"artifact-artifacts-tests-optional-recipes-xml"
],
"retentionClassId": "merge-cycle"
@@ -2227,10 +2187,6 @@
"logArtifactId": "artifact-artifacts-quality-gates-FE-GATE-028-txt",
"evidenceArtifactIds": [
"artifact-artifacts-tests-a11y-manual-APP-HOME-md",
- "artifact-artifacts-tests-a11y-manual-EXAMPLES-UI-md",
- "artifact-artifacts-tests-a11y-manual-EXAMPLES-STATES-md",
- "artifact-artifacts-tests-a11y-manual-EXAMPLES-AUTH-md",
- "artifact-artifacts-tests-a11y-manual-REFERENCE-RESOURCE-LIST-md",
"artifact-artifacts-tests-a11y-manual-NOT-FOUND-md",
"artifact-artifacts-tests-a11y-manual-report-json"
],
diff --git a/config/contracts/registry-baseline.approval.json b/config/contracts/registry-baseline.approval.json
index 74247c76..3ffa6989 100644
--- a/config/contracts/registry-baseline.approval.json
+++ b/config/contracts/registry-baseline.approval.json
@@ -1,7 +1,7 @@
{
"schemaVersion": 1,
- "snapshotDigest": "319a798ca3c9a87d7e2943177d952b13941622f4faec23c28f36024196a9e91d",
+ "snapshotDigest": "2430864767622f21490feb7f0b6932f73b82c0062e4b3ec70fe2c3ef3ac76889",
"owner": "DongHyeonka",
- "reason": "1103/16-04 FE-REG-API problemSchema가 FE-REG-SCHEMA api-problem 행을 참조한다",
- "approvedAt": "2026-11-04T14:04:44.377Z"
+ "reason": "2026-11-07 소유자 결정: 템플릿 샘플 삭제(design-docs repo-structure/README.md 3.4절). 참조 기능과 예제 화면의 라우트·operation·스키마·무효화 행을 지운다",
+ "approvedAt": "2026-11-08T02:26:50.112Z"
}
diff --git a/config/contracts/registry-baseline.json b/config/contracts/registry-baseline.json
index 6a56a3ef..a054a8b4 100644
--- a/config/contracts/registry-baseline.json
+++ b/config/contracts/registry-baseline.json
@@ -5,7 +5,7 @@
"registryId": "FE-REG-ROUTE",
"owner": "feature-frontend-routing-release-recovery-runtime",
"source": "src/features/installed-feature-contracts.ts",
- "rowCount": 10,
+ "rowCount": 3,
"contract": {
"requiredFields": [
"routeId",
@@ -93,19 +93,6 @@
"searchSchema": null,
"title": "시작"
},
- "EXAMPLES_AUTH": {
- "access": "public",
- "chunkId": "route-examples-auth",
- "errorSurface": "route-boundary",
- "loadingSurface": "example-page",
- "navigationLabel": "인증 연동",
- "navigationOrder": 40,
- "paramsSchema": null,
- "path": "/examples/auth",
- "routeId": "EXAMPLES_AUTH",
- "searchSchema": null,
- "title": "인증 연동"
- },
"EXAMPLES_PLATFORM": {
"access": "public",
"chunkId": "route-examples-platform",
@@ -119,32 +106,6 @@
"searchSchema": null,
"title": "플랫폼 구성"
},
- "EXAMPLES_STATES": {
- "access": "public",
- "chunkId": "route-examples-states",
- "errorSurface": "route-boundary",
- "loadingSurface": "example-page",
- "navigationLabel": "화면 상태",
- "navigationOrder": 30,
- "paramsSchema": null,
- "path": "/examples/states",
- "routeId": "EXAMPLES_STATES",
- "searchSchema": null,
- "title": "화면 상태"
- },
- "EXAMPLES_UI": {
- "access": "public",
- "chunkId": "route-examples-ui",
- "errorSurface": "route-boundary",
- "loadingSurface": "example-page",
- "navigationLabel": "UI 구성요소",
- "navigationOrder": 20,
- "paramsSchema": null,
- "path": "/examples/ui",
- "routeId": "EXAMPLES_UI",
- "searchSchema": null,
- "title": "UI 구성요소"
- },
"NOT_FOUND": {
"access": "public",
"chunkId": "route-not-found",
@@ -157,58 +118,6 @@
"routeId": "NOT_FOUND",
"searchSchema": null,
"title": "페이지를 찾을 수 없음"
- },
- "REFERENCE_RESOURCE_DETAIL": {
- "access": "session-required",
- "chunkId": "route-reference-resource-detail",
- "errorSurface": "feature-boundary",
- "loadingSurface": "reference-resource-detail",
- "navigationLabel": null,
- "navigationOrder": null,
- "paramsSchema": "ReferenceResourceParams",
- "path": "/examples/reference-resources/items/:resourceId",
- "routeId": "REFERENCE_RESOURCE_DETAIL",
- "searchSchema": null,
- "title": "Reference detail"
- },
- "REFERENCE_RESOURCE_FORM": {
- "access": "session-required",
- "chunkId": "route-reference-resource-form",
- "errorSurface": "feature-boundary",
- "loadingSurface": "reference-resource-form",
- "navigationLabel": null,
- "navigationOrder": null,
- "paramsSchema": null,
- "path": "/examples/reference-resources/new",
- "routeId": "REFERENCE_RESOURCE_FORM",
- "searchSchema": null,
- "title": "Reference form"
- },
- "REFERENCE_RESOURCE_LIST": {
- "access": "session-required",
- "chunkId": "route-reference-resources",
- "errorSurface": "feature-boundary",
- "loadingSurface": "reference-resource-list",
- "navigationLabel": "Reference feature",
- "navigationOrder": 50,
- "paramsSchema": null,
- "path": "/examples/reference-resources",
- "routeId": "REFERENCE_RESOURCE_LIST",
- "searchSchema": "ReferenceResourceListQuery",
- "title": "Reference feature"
- },
- "REFERENCE_RESOURCE_STATUS": {
- "access": "session-required",
- "chunkId": "route-reference-resource-status",
- "errorSurface": "feature-boundary",
- "loadingSurface": "reference-resource-status",
- "navigationLabel": null,
- "navigationOrder": null,
- "paramsSchema": null,
- "path": "/examples/reference-resources/status",
- "routeId": "REFERENCE_RESOURCE_STATUS",
- "searchSchema": null,
- "title": "Reference status"
}
}
},
@@ -216,7 +125,7 @@
"registryId": "FE-REG-ROUTE-RUNTIME",
"owner": "feature-frontend-routing-release-recovery-runtime",
"source": "src/features/installed-feature-contracts.ts",
- "rowCount": 10,
+ "rowCount": 3,
"contract": {
"requiredFields": [
"routeId",
@@ -267,59 +176,17 @@
"routeId": "APP_HOME",
"searchCodec": "none"
},
- "EXAMPLES_AUTH": {
- "moduleId": "auth-example-page",
- "paramsCodec": "none",
- "routeId": "EXAMPLES_AUTH",
- "searchCodec": "none"
- },
"EXAMPLES_PLATFORM": {
"moduleId": "platform-overview-page",
"paramsCodec": "none",
"routeId": "EXAMPLES_PLATFORM",
"searchCodec": "none"
},
- "EXAMPLES_STATES": {
- "moduleId": "state-gallery-page",
- "paramsCodec": "none",
- "routeId": "EXAMPLES_STATES",
- "searchCodec": "none"
- },
- "EXAMPLES_UI": {
- "moduleId": "ui-gallery-page",
- "paramsCodec": "none",
- "routeId": "EXAMPLES_UI",
- "searchCodec": "none"
- },
"NOT_FOUND": {
"moduleId": "not-found-page",
"paramsCodec": "NotFoundSplat",
"routeId": "NOT_FOUND",
"searchCodec": "none"
- },
- "REFERENCE_RESOURCE_DETAIL": {
- "moduleId": "reference-resource-detail-page",
- "paramsCodec": "ReferenceResourceParams",
- "routeId": "REFERENCE_RESOURCE_DETAIL",
- "searchCodec": "none"
- },
- "REFERENCE_RESOURCE_FORM": {
- "moduleId": "reference-resource-form-page",
- "paramsCodec": "none",
- "routeId": "REFERENCE_RESOURCE_FORM",
- "searchCodec": "none"
- },
- "REFERENCE_RESOURCE_LIST": {
- "moduleId": "reference-resource-page",
- "paramsCodec": "none",
- "routeId": "REFERENCE_RESOURCE_LIST",
- "searchCodec": "ReferenceResourceListQuery"
- },
- "REFERENCE_RESOURCE_STATUS": {
- "moduleId": "reference-resource-status-page",
- "paramsCodec": "none",
- "routeId": "REFERENCE_RESOURCE_STATUS",
- "searchCodec": "none"
}
}
},
@@ -327,7 +194,7 @@
"registryId": "FE-REG-API",
"owner": "feature-frontend-api-client-response-envelope-contract",
"source": "src/features/loaded-feature-runtimes.ts",
- "rowCount": 3,
+ "rowCount": 0,
"contract": {
"requiredFields": [
"operationId",
@@ -442,113 +309,13 @@
"unvalidated"
]
},
- "rows": {
- "CREATE_REFERENCE_RESOURCE": {
- "acceptedStatuses": [
- 200,
- 201
- ],
- "authProfileId": "EXTERNAL_BEARER",
- "commandEffect": {
- "classifiesStatus": true
- },
- "commandRecovery": {
- "mode": "IDEMPOTENCY_REPLAY",
- "operationIdentityField": "idempotencyKey"
- },
- "emptyBodyStatuses": [],
- "featureId": "reference-feature",
- "method": "POST",
- "operationId": "CREATE_REFERENCE_RESOURCE",
- "path": "/api/reference-resources",
- "problemSchema": "ReferenceProblem",
- "requestBody": "JSON",
- "requestByteLimit": 32768,
- "requestSchema": "CreateReferenceResourceCommand",
- "responseBody": "REQUIRED_JSON",
- "responseByteLimit": 32768,
- "responseEnvelope": "NONE",
- "responseSchema": "ReferenceResourcePayload",
- "retryBudget": 0,
- "retrySemantics": "KEYED",
- "totalDeadlineMs": 10000,
- "traffic": {
- "maxConcurrentRequests": 1,
- "maxPhysicalRequests": 1,
- "maxQueuedRequests": 0,
- "maxRetries": 0
- },
- "unvalidated": []
- },
- "GET_REFERENCE_RESOURCE": {
- "acceptedStatuses": [
- 200
- ],
- "authProfileId": "EXTERNAL_BEARER",
- "commandEffect": null,
- "commandRecovery": null,
- "emptyBodyStatuses": [],
- "featureId": "reference-feature",
- "method": "GET",
- "operationId": "GET_REFERENCE_RESOURCE",
- "path": "/api/reference-resources/{resourceId}",
- "problemSchema": "ReferenceProblem",
- "requestBody": "NONE",
- "requestByteLimit": 0,
- "requestSchema": "ReferenceResourceParams",
- "responseBody": "REQUIRED_JSON",
- "responseByteLimit": 32768,
- "responseEnvelope": "NONE",
- "responseSchema": "ReferenceResourcePayload",
- "retryBudget": 2,
- "retrySemantics": "SAFE",
- "totalDeadlineMs": 10000,
- "traffic": {
- "maxConcurrentRequests": 1,
- "maxPhysicalRequests": 3,
- "maxQueuedRequests": 0,
- "maxRetries": 2
- },
- "unvalidated": []
- },
- "LIST_REFERENCE_RESOURCES": {
- "acceptedStatuses": [
- 200
- ],
- "authProfileId": "EXTERNAL_BEARER",
- "commandEffect": null,
- "commandRecovery": null,
- "emptyBodyStatuses": [],
- "featureId": "reference-feature",
- "method": "GET",
- "operationId": "LIST_REFERENCE_RESOURCES",
- "path": "/api/reference-resources",
- "problemSchema": "ReferenceProblem",
- "requestBody": "NONE",
- "requestByteLimit": 0,
- "requestSchema": "ReferenceResourceListQuery",
- "responseBody": "REQUIRED_JSON",
- "responseByteLimit": 262144,
- "responseEnvelope": "NONE",
- "responseSchema": "ReferenceResourceListPayload",
- "retryBudget": 2,
- "retrySemantics": "SAFE",
- "totalDeadlineMs": 10000,
- "traffic": {
- "maxConcurrentRequests": 1,
- "maxPhysicalRequests": 3,
- "maxQueuedRequests": 0,
- "maxRetries": 2
- },
- "unvalidated": []
- }
- }
+ "rows": {}
},
{
"registryId": "FE-REG-SCHEMA",
"owner": "feature-frontend-contract-schema-registry",
"source": "src/features/loaded-feature-runtimes.ts",
- "rowCount": 8,
+ "rowCount": 2,
"contract": {
"requiredFields": [
"schemaId",
@@ -587,15 +354,6 @@
]
},
"rows": {
- "CreateReferenceResourceCommand": {
- "boundary": "api-request",
- "direction": "REQUEST",
- "owner": "feature-frontend-reference-feature-vertical-slice",
- "runtime": "zod",
- "schemaId": "CreateReferenceResourceCommand",
- "schemaVersion": 1,
- "unknownFieldPolicy": "REJECT_UNKNOWN"
- },
"none": {
"boundary": "route-params",
"owner": "feature-frontend-routing-release-recovery-runtime",
@@ -607,51 +365,6 @@
"owner": "feature-frontend-routing-release-recovery-runtime",
"runtime": "zod",
"schemaId": "NotFoundSplat"
- },
- "ReferenceProblem": {
- "boundary": "api-problem",
- "direction": "RESPONSE",
- "owner": "feature-frontend-reference-feature-vertical-slice",
- "runtime": "zod",
- "schemaId": "ReferenceProblem",
- "schemaVersion": 1,
- "unknownFieldPolicy": "STRIP_UNKNOWN"
- },
- "ReferenceResourceListPayload": {
- "boundary": "api-response",
- "direction": "RESPONSE",
- "owner": "feature-frontend-reference-feature-vertical-slice",
- "runtime": "zod",
- "schemaId": "ReferenceResourceListPayload",
- "schemaVersion": 1,
- "unknownFieldPolicy": "STRIP_UNKNOWN"
- },
- "ReferenceResourceListQuery": {
- "boundary": "route-search-api-request",
- "direction": "REQUEST",
- "owner": "feature-frontend-reference-feature-vertical-slice",
- "runtime": "zod",
- "schemaId": "ReferenceResourceListQuery",
- "schemaVersion": 1,
- "unknownFieldPolicy": "REJECT_UNKNOWN"
- },
- "ReferenceResourceParams": {
- "boundary": "route-params",
- "direction": "REQUEST",
- "owner": "feature-frontend-reference-feature-vertical-slice",
- "runtime": "zod",
- "schemaId": "ReferenceResourceParams",
- "schemaVersion": 1,
- "unknownFieldPolicy": "REJECT_UNKNOWN"
- },
- "ReferenceResourcePayload": {
- "boundary": "api-response",
- "direction": "RESPONSE",
- "owner": "feature-frontend-reference-feature-vertical-slice",
- "runtime": "zod",
- "schemaId": "ReferenceResourcePayload",
- "schemaVersion": 1,
- "unknownFieldPolicy": "STRIP_UNKNOWN"
}
}
},
@@ -814,7 +527,7 @@
"registryId": "FE-REG-STORAGE",
"owner": "feature-frontend-storage-registry-contract",
"source": "src/contracts/storage-keys.ts",
- "rowCount": 7,
+ "rowCount": 8,
"contract": {
"requiredFields": [
"logicalName",
@@ -883,6 +596,19 @@
]
},
"rows": {
+ "AUTH_REDIRECT_TRANSACTION": {
+ "backend": "external",
+ "classification": "opaque-cache",
+ "logicalName": "AUTH_REDIRECT_TRANSACTION",
+ "migration": "discard",
+ "name": "oidc-pkce-transaction",
+ "physicalKey": "ca-frontend:auth:v1:oidc-pkce-transaction",
+ "quotaFallback": "no-persist",
+ "schemaVersion": 1,
+ "scope": "auth",
+ "ttl": "session",
+ "valueCodec": "none"
+ },
"AUTH_TOKEN": {
"backend": "forbidden",
"classification": "sensitive-forbidden",
@@ -1304,24 +1030,9 @@
},
"rows": {
"invalidation-graph": {
- "edges": [
- {
- "namespace": {
- "namespaceId": "reference-resource",
- "namespaceVersion": 1
- },
- "topicId": "qinv.01k10f7m3w9p6r2c8v5n4x"
- }
- ],
- "namespaces": [
- {
- "namespaceId": "reference-resource",
- "namespaceVersion": 1
- }
- ],
- "topics": [
- "qinv.01k10f7m3w9p6r2c8v5n4x"
- ]
+ "edges": [],
+ "namespaces": [],
+ "topics": []
}
}
},
@@ -1329,7 +1040,7 @@
"registryId": "FE-REG-QUERY-INVALIDATION-TOPIC-VERSION",
"owner": "feature-frontend-server-state-caching-contract",
"source": "src/features/installed-feature-contracts.ts",
- "rowCount": 1,
+ "rowCount": 0,
"contract": {
"requiredFields": [
"topicId",
@@ -1353,12 +1064,7 @@
"topicId"
]
},
- "rows": {
- "[\"qinv.01k10f7m3w9p6r2c8v5n4x\"]": {
- "topicId": "qinv.01k10f7m3w9p6r2c8v5n4x",
- "topicVersion": 1
- }
- }
+ "rows": {}
},
{
"registryId": "FE-REG-TELEMETRY",
diff --git a/config/runtime/development.json b/config/runtime/development.json
index 63006b82..d73619fc 100644
--- a/config/runtime/development.json
+++ b/config/runtime/development.json
@@ -13,7 +13,5 @@
"SERVICE_WORKER": "DEFAULT",
"OFFLINE_COMMANDS": "DEFAULT"
},
- "FEATURE_OVERRIDES": {
- "reference-feature": "DEFAULT"
- }
+ "FEATURE_OVERRIDES": {}
}
diff --git a/config/runtime/local.json b/config/runtime/local.json
index 952aa3c9..6222d0b6 100644
--- a/config/runtime/local.json
+++ b/config/runtime/local.json
@@ -13,7 +13,5 @@
"SERVICE_WORKER": "DEFAULT",
"OFFLINE_COMMANDS": "DEFAULT"
},
- "FEATURE_OVERRIDES": {
- "reference-feature": "DEFAULT"
- }
+ "FEATURE_OVERRIDES": {}
}
diff --git a/config/runtime/production.json b/config/runtime/production.json
index 46ad7781..a6ee567d 100644
--- a/config/runtime/production.json
+++ b/config/runtime/production.json
@@ -14,7 +14,5 @@
"SERVICE_WORKER": "DEFAULT",
"OFFLINE_COMMANDS": "DEFAULT"
},
- "FEATURE_OVERRIDES": {
- "reference-feature": "DEFAULT"
- }
+ "FEATURE_OVERRIDES": {}
}
diff --git a/config/runtime/staging.json b/config/runtime/staging.json
index 861f87bd..f1df1789 100644
--- a/config/runtime/staging.json
+++ b/config/runtime/staging.json
@@ -14,7 +14,5 @@
"SERVICE_WORKER": "DEFAULT",
"OFFLINE_COMMANDS": "DEFAULT"
},
- "FEATURE_OVERRIDES": {
- "reference-feature": "DEFAULT"
- }
+ "FEATURE_OVERRIDES": {}
}
diff --git a/config/scale/feature-shape-ceilings.json b/config/scale/feature-shape-ceilings.json
index b5cd3fdf..ebb04405 100644
--- a/config/scale/feature-shape-ceilings.json
+++ b/config/scale/feature-shape-ceilings.json
@@ -39,10 +39,10 @@
}
],
"initialJavascript": {
- "gzipBytes": 204266,
- "files": 27,
- "firstFeatureGzipBytes": 797,
- "perFeatureGzipBytes": 521,
- "perContextGzipBytes": 12
+ "gzipBytes": 194354,
+ "files": 17,
+ "firstFeatureGzipBytes": 6327,
+ "perFeatureGzipBytes": 539,
+ "perContextGzipBytes": 4
}
}
diff --git a/config/testing/risk-coverage.json b/config/testing/risk-coverage.json
index 0ba7859c..3cf507f8 100644
--- a/config/testing/risk-coverage.json
+++ b/config/testing/risk-coverage.json
@@ -129,16 +129,6 @@
"branches": 58
}
},
- {
- "path": "src/features/reference-feature/adapters/reference-http-gateway.ts",
- "owner": "reference-feature",
- "minimum": {
- "lines": 90,
- "statements": 90,
- "functions": 90,
- "branches": 90
- }
- },
{
"path": "src/presentation/adapters/query/application-query.ts",
"owner": "presentation-runtime",
@@ -193,7 +183,6 @@
"src/bootstrap/load-release-manifest.ts",
"src/bootstrap/read-bounded-boot-json.ts",
"src/contracts/diagnostics.ts",
- "src/features/reference-feature/adapters/reference-http-gateway.ts",
"src/presentation/adapters/query/application-query.ts",
"src/adapters/http/http-contract-bridge.ts",
"src/adapters/http/http-retry-lifecycle.ts",
diff --git a/docs/README.md b/docs/README.md
index 74dc482b..fc22ea81 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -51,9 +51,9 @@ checkout이 없거나 그 커밋이 없으면 실패 대신 확인하지 못한
지난 상태를 적는 문서라 빼고, git이 무시하는 생성 산출물과 복사한 프로젝트가 지운 작업 이력은
없어도 된다. 설명·수치가 코드와 맞는지는 검사하지 않는다. 규칙과 예외의 정본은
`scripts/verify-documentation-readiness.ts`다.
-복사한 프로젝트가 지울 수 있는 템플릿 기능(참조 기능, 예제 화면. 목록은
-`scripts/lib/removable-template-features.ts`)의 경로와 script는 그 기능이 설치돼 있을 때
-(`src/features//feature-module.ts`가 있을 때) 검사하고, 지운 뒤에는 없어도 된다.
+프로젝트가 지울 예정인 샘플 기능(목록은 `scripts/lib/removable-template-features.ts`, 템플릿은
+비어 있다)의 경로와 script는 그 기능이 설치돼 있을 때(`src/features//feature-module.ts`가
+있을 때) 검사하고, 지운 뒤에는 없어도 된다.
게이트가 직접 읽는 파일이라 지우거나 옮기면 게이트가 실패한다.
diff --git a/docs/accessibility/manual-checklist.md b/docs/accessibility/manual-checklist.md
index 61425334..313cd9b8 100644
--- a/docs/accessibility/manual-checklist.md
+++ b/docs/accessibility/manual-checklist.md
@@ -57,8 +57,8 @@ The reviewer must verify:
- M7: non-essential motion is suppressed with reduced-motion preference
- Screen reader: headings, live regions, errors, and actions are announced once
-`EXAMPLES_UI` requires real M4 modal and M5 field-error review; those items must
-not be marked not-applicable on that route. Passing automated evidence means
+A route with a form or a dialog requires real M4 modal and M5 field-error
+review; those items must not be marked not-applicable on that route. Passing automated evidence means
only that tested pages had no critical or serious axe findings under the
recorded Chromium, Firefox, and WebKit runs.
@@ -78,7 +78,7 @@ What the automated run scans:
route's `paramsSchema` is the input of such a read, the report expects that
record from the descriptors alone and fails without it
(`scripts/write-a11y-report.ts`).
-- The reference sample's list in its success, empty and error states, its
- detail, its form with submit errors and its status page, each after that
- state is on screen (`tests/e2e/reference-form.spec.ts`, removed with the
- sample).
+- The list of the feature `create:feature` writes, in its success, empty and
+ error states, its detail and its form with submit errors, each after that
+ state is on screen (`tests/e2e/generated-feature.spec.ts`, on a build with
+ that feature). A product's own features get the route scan above.
diff --git a/docs/architecture/backend-api-and-server-state-contract.md b/docs/architecture/backend-api-and-server-state-contract.md
index f6131c85..8f267acc 100644
--- a/docs/architecture/backend-api-and-server-state-contract.md
+++ b/docs/architecture/backend-api-and-server-state-contract.md
@@ -124,36 +124,22 @@ runtime config의 version 문자열 일치만 compatibility 증거로 사용하
artifact digest가 없는 동안에는 실제 staging conformance fixture와 수동 승인
evidence가 필요하다.
-## 4. 현재 reference REST 계약
+## 4. 현재 REST 계약
-현재 frontend에 실제 조립된 operation은 다음 세 개다.
+템플릿에는 조립된 기능 operation이 없다. 참조 샘플(`LIST_REFERENCE_RESOURCES` 등
+problem details 모양의 세 operation)은 2026-11-07에 지웠다. 기능의 operation은
+`corepack pnpm create:feature `가 만든다. 짝 백엔드 `new-feature.sh`와 같은 경로
+규칙이다(`docs/manual/reference/create-feature.md`).
| operation | request | success |
| --- | --- | --- |
-| `LIST_REFERENCE_RESOURCES` | `GET /api/reference-resources?cursor&limit&tags` | `200 application/json` |
-| `GET_REFERENCE_RESOURCE` | `GET /api/reference-resources/{resourceId}` | `200 application/json` |
-| `CREATE_REFERENCE_RESOURCE` | `POST /api/reference-resources` | `200` 또는 `201 application/json` |
+| `_LIST_ITEMS` | `GET /` | `200`, Envelope 안의 항목 배열과 `meta.page` |
+| `_GET_ITEM` (`--with-create`) | `GET //{Id}` | `200`, Envelope 안의 항목 |
+| `_CREATE_ITEM` (`--with-create`) | `POST /` | `201`, Envelope 안의 항목 |
-현재 list payload는 `ReferenceResource[]`다. `cursor` 입력이 존재하더라도
-`CursorPage` 출력 계약은 아직 아니다. backend가 같은 operation에서 배열을
-page object로 조용히 바꾸면 schema mismatch로 실패한다.
-
-resource DTO:
-
-```text
-ReferenceResourceDtoV1
- id: non-empty string, maximum 120 characters
- name: non-empty string, maximum 240 characters
- createdAt?: RFC 3339 date-time
-```
-
-create command:
-
-```text
-CreateReferenceResourceCommandV1
- name: trimmed string, 1..120
- note?: trimmed string, 0..500
-```
+모든 operation이 `responseEnvelope: "ENVELOPE_V1"`이다. Envelope가 없는 백엔드(DTO와
+problem details)에 붙이는 법은 [매뉴얼 02 결정표 4절](../manual/02-decision-tables.md)의
+「problem details 백엔드의 예」다.
Backend는 frontend validation을 신뢰하지 않고 동일하거나 더 좁은 validation과
authorization을 다시 수행한다.
@@ -193,8 +179,9 @@ Envelope의 모양과 키 존재 규칙은 짝 백엔드 템플릿 문서가 정
바뀐 파일마다 다시 볼 프론트 위치를 말하며 1로 끝난다(1105/16-02).
- 프론트에서 Envelope를 읽는 곳: `src/adapters/http/backend-envelope.ts`(스키마와
해석). V3 실행기는 descriptor가 `responseEnvelope: "ENVELOPE_V1"`일 때 쓴다.
- `create:feature`가 만든 기능은 이 값을 선언한다. 참조 기능은 `"NONE"`을
- 선언하고 DTO와 problem details를 검증한다. 이 칸은 descriptor 타입의 필수
+ `create:feature`가 만든 기능은 이 값을 선언한다. Envelope가 없는 백엔드의
+ operation은 `"NONE"`을 선언하고 DTO와 problem details를 검증한다(매뉴얼 02
+ 결정표 4절의 예). 이 칸은 descriptor 타입의 필수
칸이라 빠뜨리면 `check:types`가 실패한다(1103/16-01).
- 실패 Envelope의 `error.code`가 "적용 안 됨"인지는 6.1절이 정한다.
- 페이지 목록의 `meta.page`(`number`·`size`·`total`·`sort`)는 기능의
@@ -272,7 +259,7 @@ Cross-origin bearer provider 최소 CORS:
## 6. Command와 idempotency
-`CREATE_REFERENCE_RESOURCE`는 keyed command다. frontend memory single-flight는
+`create:feature --with-create --keyed`의 작성 operation은 keyed command다. frontend memory single-flight는
backend idempotency를 대체하지 않는다.
멱등성 응답의 status·`error.code`·`retryable`·`Retry-After`와 키 문법은 짝
@@ -287,9 +274,8 @@ backend idempotency를 대체하지 않는다.
`src/presentation/adapters/query/application-query.ts`
- Envelope operation의 거절 판정: `src/adapters/http/backend-envelope.ts`
`REFUSED_BEFORE_WRITE`(6.1절 표)
- - 참조 기능(Envelope 없음) 판정: `src/features/reference-feature/contracts/reference-feature-contract-contribution.ts`
- (effect), `src/features/reference-feature/adapters/reference-http-gateway.ts`
- (code)
+ - Envelope 없는 operation의 판정: 기능의 `commandEffect.classifyProblem`과
+ `mapProblem`(예: [매뉴얼 02 결정표 4절](../manual/02-decision-tables.md)의 코드 조각)
### 6.1 거절 code와 적용 여부
@@ -411,10 +397,10 @@ mutation이 400·409·422로 실패하면 프론트는 그 요청이 적용됐
프론트 판정과 표가 다른 곳(고치면 이 줄을 지운다):
-- 참조 기능 분류기(`classifyProblem`)는 참조 fixture(problem+json)용이라
- 400·422를 모두 `NOT_APPLIED`로 본다. 참조 기능은 Envelope operation이 아니라
- 이 표의 대상이 아니다. 짝 백엔드에 붙이는 Envelope operation은
- `src/adapters/http/backend-envelope.ts`의 표가 400·409·422를 정한다(`3261208`).
+- 매뉴얼 02 결정표의 problem details 예(`classifyProblem`)는 400·422를 모두
+ `NOT_APPLIED`로 본다. Envelope operation이 아니라 이 표의 대상이 아니다. 짝
+ 백엔드에 붙이는 Envelope operation은 `src/adapters/http/backend-envelope.ts`의
+ 표가 400·409·422를 정한다(`3261208`).
남은 위험: "쓰기 전"은 현재 코드에서 그 handler에 닿는 출처를 센 결과다. 백엔드가
application bean에 `@Validated`를 달거나 JPA entity에 Bean Validation 제약을
diff --git a/docs/architecture/capability-consumer-experience.md b/docs/architecture/capability-consumer-experience.md
index 18033b4d..422fbc66 100644
--- a/docs/architecture/capability-consumer-experience.md
+++ b/docs/architecture/capability-consumer-experience.md
@@ -8,23 +8,24 @@ These measurements are baselines, not score targets. A lower line count is not
automatically better if it hides business semantics or creates a universal
repository abstraction.
-## Scenario A — reference REST feature
+## Scenario A — a REST feature
-The existing reference feature is the executable REST consumer.
+The REST consumer is the feature `corepack pnpm create:feature --with-create`
+writes (the template's reference sample had this role until 2026-11-07).
-It covers list/detail/create behavior, mapping, typed operation inputs,
-application ports and an optimistic mutation path.
+It covers list/detail/create behavior, mapping, typed operation inputs and
+application ports.
The feature-owned boundary and application source is these four files:
-- `application/reference-feature-api.ts`
-- `contracts/reference-mapper.ts`
-- `adapters/reference-http-gateway.ts`
-- `adapters/create-reference-feature-input.ts`
+- `application/-feature-api.ts`
+- `contracts/-mapper.ts`
+- `adapters/-http-gateway.ts`
+- `adapters/create--feature-input.ts`
This document does not keep their line counts; a hand-typed count drifted
-from the code (review 14-07). Measure them with
-`wc -l src/features/reference-feature/{application/reference-feature-api.ts,contracts/reference-mapper.ts,adapters/reference-http-gateway.ts,adapters/create-reference-feature-input.ts}`.
+from the code (review 14-07). Measure them in a generated feature with
+`wc -l` on those four files.
The important boundary metric is not the raw total. It is what those files need
to know about the platform.
diff --git a/docs/architecture/contract-ownership.md b/docs/architecture/contract-ownership.md
index 270956b5..a2838c9b 100644
--- a/docs/architecture/contract-ownership.md
+++ b/docs/architecture/contract-ownership.md
@@ -101,8 +101,8 @@ Feature-specific contracts stay inside the vertical slice:
`features//contracts`
-The reference feature owns routes, schemas, mapper definitions, message
-catalogs and contribution identities. Central installed files aggregate those
+A feature owns its routes, schemas, mapper definitions, message catalogs and
+contribution identities (`create:feature` writes them under its `contracts/`). Central installed files aggregate those
contributions; they do not own their semantics.
The message catalog is a deliberate special case: the compiled catalog remains
diff --git a/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md b/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md
index 9268cff4..92d0c560 100644
--- a/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md
+++ b/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md
@@ -71,9 +71,9 @@ route/form/failure 의미 값
- `check:i18n`은 catalog key와 placeholder parity, backend message JSX 렌더링을
검사한다. 검사 범위는 공통 UI 디렉터리, `src/presentation/pages`, 모든
`src/features/*/presentation`이다. 플랫폼 구성 화면
- `src/presentation/examples`와 예제 화면
- `src/features/platform-examples-feature/presentation`(1103/09-04)은 화면
- 문구 ESLint 규칙에서 일부러 뺐다(`eslint.config.ts`).
+ `src/presentation/examples`와 Storybook story(디자인 시스템·화면 상태 갤러리,
+ 2026-11-07 전에는 예제 화면 기능)는 화면 문구 ESLint 규칙에서 일부러
+ 뺐다(`eslint.config.ts`).
- 화면 문구가 catalog에서 오는지는 ESLint `no-restricted-syntax`가 본다
(`eslint.config.ts`의 `screenTextSelectors`, 0929/08-02). 대상은 글자가 든
`JSXText`와 표시·접근성 속성(`aria-label`, `title`, `placeholder`, `alt`,
diff --git a/docs/architecture/frontend-application-foundation.md b/docs/architecture/frontend-application-foundation.md
index b1fae3da..296e497e 100644
--- a/docs/architecture/frontend-application-foundation.md
+++ b/docs/architecture/frontend-application-foundation.md
@@ -5,8 +5,8 @@ an independent general-purpose SDK. Its architectural role is:
> Frontend Application Foundation = Starter / Composition Skeleton + Reusable Capability Platform
-The starter side owns bootstrap, routing, providers, project conventions and a
-removable reference feature. The capability side owns reusable technical
+The starter side owns bootstrap, routing, providers, project conventions and
+the `create:feature` command that writes a feature; it ships no sample feature. The capability side owns reusable technical
problems such as HTTP execution, Server State, authentication boundaries,
IndexedDB/OPFS, Cache Storage, realtime, browser RPC, transfer and diagnostics.
@@ -78,9 +78,9 @@ A reusable capability boundary is composed from:
- feature-selected policy,
- one capability-specific runtime.
-The HTTP reference path is the first concrete example.
+The HTTP path is the first concrete example.
`src/adapters/http/feature-http-binding.ts` owns transport/outcome
-normalization. The reference feature contributes only:
+normalization. A feature `create:feature` writes contributes only:
- operation ID,
- route ID,
@@ -152,11 +152,11 @@ repository or move dataset/migration/lifecycle policy into the feature.
The repository now has two executable contribution shapes:
-- Reference feature: `needs: ["http"]`
-- Local Draft feature: `needs: ["indexedDb"]`
+- A feature `create:feature` writes: `needs: ["http", "telemetry"]`
+- The Local Draft consumer: `needs: ["indexedDb"]`
-Local Draft is a compiled architecture consumer used to prove the second
-capability shape; it is not added to the default product manifest. Its
+Local Draft is a test fixture (`tests/fixtures/indexeddb-consumer`) used to
+prove the second capability shape; it is not a feature of the product. Its
browser-capability test composes the feature over the real
`createIndexedDbRuntime` and native IndexedDB, proving that this seam is not
limited to an in-memory contract fixture.
diff --git a/docs/architecture/frontend-ports-adapters-and-boundaries.md b/docs/architecture/frontend-ports-adapters-and-boundaries.md
index 0b64fe76..e633119f 100644
--- a/docs/architecture/frontend-ports-adapters-and-boundaries.md
+++ b/docs/architecture/frontend-ports-adapters-and-boundaries.md
@@ -124,7 +124,7 @@ bootstrap은 page별 orchestration이나 업무 규칙을 소유하지 않는다
| `src/adapters` | HTTP, auth, storage, cache, telemetry 구현 | outbound adapter |
| `src/bootstrap` | runtime config와 구현 조립 | 유일한 composition root |
| `src/contracts` | 여러 계층의 registry가 혼재 | 소유 계층으로 분산 |
-| `src/features/reference-feature` | 완전한 제거 가능 수직 예제 | installed contribution과 제거 gate 유지 |
+| `src/features/` | 제품 기능의 수직 slice. 템플릿은 비어 있고 `create:feature`가 만든다(참조 샘플은 2026-11-07 삭제) | installed contribution과 제거 gate 유지 |
현재 구조가 잘 제공하는 기반은 다음과 같다.
@@ -178,7 +178,7 @@ Data Router tree, codec, surface, title, navigation, chunk/release recovery의
단일 조립 입력이며 registry/type/build 검증이 누락과 orphan을 거절한다.
RP-05에서 두 번째 불일치도 닫혔다. feature별 domain/application/adapter/
-contract/presentation은 `src/features/reference-feature`가 소유하고, generic
+contract/presentation은 그 기능 폴더(`src/features/`)가 소유하고, generic
installed catalog만 bootstrap과 router에 노출된다. 제거 gate는 feature와 test를
삭제한 복제본에서 전체 P0 경로를 다시 실행한다.
@@ -351,7 +351,7 @@ src/
platform/
features/
- reference-feature/
+ /
domain/
application/
ports/
@@ -376,8 +376,8 @@ src/
application capability만 둔다. `shared`, `common`, `utils` 같은 이름으로
기술과 업무 규칙을 무제한 혼합하지 않는다.
-`features/reference-feature`는 구조를 설명하기 위한 완전한 수직
-슬라이스다. 이 폴더를 삭제하고 route 등록 한 곳만 제거했을 때
+`features/`는 구조를 설명하기 위한 완전한 수직
+슬라이스다(2026-11-07부터 템플릿의 예는 `create:feature`가 만드는 기능이다). 이 폴더를 삭제하고 route 등록 한 곳만 제거했을 때
typecheck, architecture check, test와 build가 모두 통과해야 한다.
## 8. Input port 설계 규칙
@@ -835,6 +835,10 @@ status/attempt/duration bucket만 전달한다.
## 16. Feature 경계와 removable reference feature
+> 2026-11-07: 템플릿의 참조 샘플은 지웠다. 이 절이 참조 기능에 요구한 수직 경로와
+> 제거 검증은 `create:feature`가 만드는 기능이 맡는다(`test:feature-scaffold`가 게이트와
+> 제거를, `tests/e2e/generated-feature.spec.ts`가 실제 브라우저 경로를 본다).
+
Reference feature는 단순 UI fixture가 아니라 다음 경로를 모두 실행해야
한다.
@@ -871,7 +875,7 @@ operation을 전역 core registry 안에 하드코딩하지 않는다.
제거 테스트는 다음을 수행해야 한다.
-1. `src/features/reference-feature` 전체 삭제
+1. `src/features/` 전체 삭제
2. reference route registration 삭제
3. reference test 삭제 또는 제외
4. 잔여 import와 registry owner 검색
diff --git a/docs/architecture/starter-experience.md b/docs/architecture/starter-experience.md
index 5ca50132..ef39a92c 100644
--- a/docs/architecture/starter-experience.md
+++ b/docs/architecture/starter-experience.md
@@ -101,21 +101,16 @@ rather than adding another independent route or data-loading convention.
feature takes it over by declaring that route id (see "Product home and
layouts"). Its starter links are the first three screens of the navigation.
-The example screens `/examples/ui`, `/examples/states` and `/examples/auth`
-are one feature, `src/features/platform-examples-feature/`, in its own context
-`src/contexts/platform-examples-context/` (1103/09-04). A product turns them
-off like any feature: leave the id out of `VITE_PRODUCT_FEATURES`, or delete
-the feature. To delete it, remove those two folders and
-`tests/features/platform-examples-feature/` (its component tests), then run
-`corepack pnpm generate:feature-index`;
-`corepack pnpm test:sample-removal -- --feature=platform-examples-feature`
-does the same in a copy of the repository and runs the gates there. Their
-routes then leave the registry, the navigation, the bundle and the manual
-accessibility list (FE-GATE-028). This document keeps naming the three
-folders after they are gone: `verify:documentation` checks the paths of a
-removable template feature (`scripts/lib/removable-template-features.ts`)
-while the feature is installed and accepts them once its `feature-module.ts`
-is gone (1105/14-01).
+The template ships no example feature. Its example screens (`/examples/ui`,
+`/examples/states`, `/examples/auth`) and its reference sample were deleted on
+2026-11-07: the design-system and screen-state galleries are workshop stories
+(`src/presentation/design-system/galleries.stories.tsx`), and the manual
+(`docs/manual/`) with `create:feature` shows how a feature is built. A sample a
+product keeps for a while is listed in
+`scripts/lib/removable-template-features.ts`: `verify:documentation` checks its
+paths while it is installed and accepts them once its `feature-module.ts` is
+gone (1105/14-01), and `corepack pnpm test:sample-removal` removes it in a copy
+of the repository and runs the gates there.
The platform overview (`/examples/platform`,
`src/presentation/examples/platform-overview-page.tsx`) stays a platform
@@ -125,11 +120,12 @@ routes module before the page, a second request round the 200 ms budget does
not fit. Its tests are the `tests/component/starter-*.test.tsx` files.
The platform's component tests (router, boundaries, shell, runtime tree) run
-on the pages of the test-only feature in `tests/helpers/fixture-feature.tsx`
-and keep passing without the examples. The browser-level checks in
-`tests/e2e` and `tests/visual` use the example screens as their pages and run
-where the examples are installed: a product that leaves them out points those
-specs at its own screens or deletes them.
+on the pages of the test-only feature in `tests/helpers/fixture-feature.tsx`.
+The browser-level checks in `tests/e2e` and `tests/visual` use the home page,
+the platform overview and the gallery stories; what needs a feature
+(`tests/e2e/generated-feature.spec.ts`, the chunk recovery spec) builds a copy
+of the repository with the one `create:feature` writes
+(`scripts/lib/generated-feature.ts`).
### Ownership declarations
@@ -168,7 +164,7 @@ selected app. Every build and check script runs it first; run it yourself with
invalidation, topic versions and the external `contractPackages` the
release manifest is checked against at boot), its message catalogs, and
`loadRuntime`, which imports `feature-runtime.ts` dynamically.
- `src/features/reference-feature/feature-module.ts` is the complete example.
+ `create:feature` writes a complete one.
2. Create `src/features//feature-runtime.ts` with
`defineFeatureRuntime`: the `schemas` (FE-REG-SCHEMA rows for the
feature's route and API schemas), the adapter contributions
@@ -183,13 +179,14 @@ selected app. Every build and check script runs it first; run it yourself with
executes, and `check:registries` governs the FE-REG-API row projected from
it (`projectApiOperationRows` in `src/contracts/api-operations.ts`).
A product feature's contract contribution uses an `EXTERNAL_PACKAGE`
- source. `TEMPLATE_FIXTURE` belongs to `reference-feature` only and never
- joins the release contract set; the composer rejects it anywhere else.
+ source. `TEMPLATE_FIXTURE` was the template's reference sample source; it
+ never joins the release contract set, and the composer rejects it in any
+ product feature.
3. Create `src/features//context-routes.ts` exporting
`FEATURE_CONTEXT_ROUTES`. Page components are imported lazily here, and each
route handle carries the route's params/search `codecs`; the owning context
loads this file only when its route root is visited
- (`src/features/reference-feature/context-routes.ts`). Each handle's
+ (a `create:feature --with-create` feature's `context-routes.ts`). Each handle's
`routeId` must be a route of a feature contract in the same context; the
context refuses the routes when they load, naming the route, context and
features (`src/contexts/bounded-context-module.ts`).
diff --git a/docs/architecture/typescript-state-and-data-flow.md b/docs/architecture/typescript-state-and-data-flow.md
index a3ff6b2d..e845534d 100644
--- a/docs/architecture/typescript-state-and-data-flow.md
+++ b/docs/architecture/typescript-state-and-data-flow.md
@@ -157,7 +157,7 @@ export interface ApplicationFeatureInputs {}
declare module "../../../application/ports/in/application-api.ts" {
interface ApplicationFeatureInputs {
- "reference-feature": ReferenceFeatureInput;
+ "invoice-feature": InvoiceFeatureInput;
}
}
```
@@ -342,8 +342,8 @@ export function useCreateResourceMutation() {
`useApplicationMutation`은 bound 정의(`BoundMutation`)만 받는다(1101/08-03).
`{ execute }`만 넘기는 raw 형태는 멱등 키와 scope 확인 없이 쓰기를 보내고
결과 불명 뒤 "다시 보내기"가 아무것도 하지 않아 타입에서 막는다. 실제 정의는
-`src/features/reference-feature/presentation/use-reference-feature.ts`의
-`REFERENCE_CREATE_MUTATION_POLICY`를 본다.
+`create:feature --with-create`가 만드는 `presentation/use--create.ts`의
+작성 뮤테이션 정책을 본다.
기본 mutation은 navigation만으로 취소됐다고 가정하지 않는다. 서버 작업의 취소가
안전한 operation만 controller가 보관한 `AbortController`와 명시적 cancel action을
@@ -622,10 +622,9 @@ Form 또는 TanStack Form adapter를 평가한다.
- controller와 mapping: `src/presentation/forms`
- layout-only template: `src/presentation/templates`
-- feature form schema/command mapper:
- `src/features/reference-feature/presentation/reference-resource-form.ts`
-- 실제 create page:
- `src/features/reference-feature/presentation/reference-resource-form-page.tsx`
+- feature form schema/command mapper: `create:feature --with-create`의
+ `presentation/-form.ts`
+- 실제 create page: 같은 판의 `presentation/-create-page.tsx`
`ApiFailure.validationIssues`는 HTTP 경계가 투영한 `path`와 `code`만 담는다.
backend message와 알 수 없는 path는 field copy로 사용하지 않는다.
diff --git a/docs/contracts/compatibility.md b/docs/contracts/compatibility.md
index 9185fd3b..9c481ac7 100644
--- a/docs/contracts/compatibility.md
+++ b/docs/contracts/compatibility.md
@@ -25,7 +25,7 @@ reader that accepts it must ship before any writer sends it.
| `FEATURE_OVERRIDES` | record; unknown feature id ignored | additive | `featureOverrideArtifactSchema` in `src/contracts/release-artifacts.ts` |
| Release manifest V2 | strict object | breaking | `releaseManifestV2ArtifactSchema` in `src/contracts/release-artifacts.ts` |
| HTTP success/failure envelope (V3 with `responseEnvelope: "ENVELOPE_V1"`) | strict object (`meta` strips) | breaking | `successEnvelopeSchema`, `failureEnvelopeSchema` in `src/adapters/http/backend-envelope.ts` |
-| HTTP V3 response DTO (reference feature) | `.strip()` drops unknown fields | additive | `referenceResourceDtoSchema` in `src/features/reference-feature/contracts/reference-schemas.ts` |
+| HTTP V3 response DTO (a feature's) | `.strip()` drops unknown fields | additive | `ItemDtoSchema` in `contracts/-schemas.ts` of a feature `create:feature` writes |
| Realtime envelope | exact key set; unknown `eventType` is `MALFORMED_EVENT` | breaking | `decodeUnsafe` in `src/adapters/realtime/event-codec.ts` |
| Browser RPC transport error code | closed vocabulary; unknown code is a protocol violation | breaking | `decodeTransportFailure` in `src/adapters/browser-rpc/browser-rpc-runtime.ts` |
| Persisted client storage | versioned key; incompatible value discarded | use a new key version | `defineStorageKey` in `src/contracts/storage-keys.ts` |
diff --git a/docs/manual/reference/create-feature.md b/docs/manual/reference/create-feature.md
index 0d08b926..f515d8f7 100644
--- a/docs/manual/reference/create-feature.md
+++ b/docs/manual/reference/create-feature.md
@@ -156,10 +156,13 @@ node scripts/write-dev-release-manifest.ts # dev manifest에서 그 기능의
- `test:feature-scaffold` (FE-GATE-020)
- 저장소 복사본에 기능 둘(기본 하나, `--with-create --keyed` 하나)을 만들고 커밋한 뒤 게이트를 돈다.
- 타입, lint, 아키텍처, 레지스트리, i18n, 디자인 시스템, 진단, 문서, unit, component, integration, 기능 테스트, 커버리지, CI 계약, 빌드.
-- `test:sample-removal` (FE-GATE-020)
- - 참조 기능을 지운 복사본에서 이 명령(`--with-create`)으로 기능을 만들고 같은 게이트를 다시 돈다. 명령과 쓰기 slice가 참조 기능에 기대지 않는다는 증거다.
+- `test:sample-removal -- --feature=` (`test:feature-scaffold`가 부른다)
+ - 위에서 만든 기본 기능을 복사본에서 지우고 같은 게이트를 다시 돈다. 생성 기능이 지워진다는 증거다.
+ - 인자 없이 돌면(FE-GATE-020) `scripts/lib/removable-template-features.ts`에 적힌 샘플을 하나씩 지우고, 지운 복사본에서 이 명령(`--with-create`)으로 기능을 만들어 게이트를 다시 돈다. 템플릿은 그 목록이 비어 있어 건너뛰었다고(SKIP) 출력한다.
+- `tests/e2e/generated-feature.spec.ts` (`test:e2e`, FE-GATE-008)
+ - 저장소 복사본에 `--with-create --keyed` 기능을 만들어 빌드하고, 실제 브라우저에서 로그인 뒤 목록, 폼 검증, 이탈 확인, 저장(멱등 키), 429 뒤 다시 시도, 결과 불명과 같은 키 재전송, 접근성(axe)을 본다. 생성기 출력이 바뀌면 여기서 잡힌다.
## 알려진 한계
-- 드릴은 브라우저 테스트(FE-GATE-008·009의 `test:e2e`, `test:a11y` 등)와 `test:system`을 돌리지 않는다. `check:bundle`(FE-GATE-012)은 돈다.
+- 드릴은 브라우저 테스트(FE-GATE-008·009의 `test:e2e`, `test:a11y` 등)와 `test:system`을 돌리지 않는다. `check:bundle`(FE-GATE-012)은 돈다. 브라우저에서의 동작은 위 e2e spec이 고정한 이름(`order-feature`)의 기능 하나로만 본다.
- 새 context는 앱이 하나일 때만 만든다. 앱이 여럿이면 `--context`로 기존 context를 고른다.
diff --git a/docs/operations/adapter-remediation-ledger.md b/docs/operations/adapter-remediation-ledger.md
index 5e48aab7..4c8016c6 100644
--- a/docs/operations/adapter-remediation-ledger.md
+++ b/docs/operations/adapter-remediation-ledger.md
@@ -194,7 +194,7 @@ Captured after every correctness task landed.
| `git diff --check` | 0 | clean |
| `corepack pnpm test:component` | 0 | 126 passed |
| `corepack pnpm test:integration` | 0 | 52 passed |
-| `corepack pnpm test:reference-feature` | 0 | 26 passed |
+| 참조 샘플 기능 시험(그 script는 2026-11-07 샘플과 함께 지웠다) | 0 | 26 passed |
| `corepack pnpm test:recipes` | 0 | 17 passed |
| `corepack pnpm test:unit` | 1 | 1585 passed / 19 failed tests; the 19 are the unchanged pre-existing `ci-artifact-contract` sandbox failures |
| `corepack pnpm check:registries` | 0 | 11 registries PASS |
@@ -340,7 +340,7 @@ Run on the landed tree. Only what actually passed is claimed as passing.
| `tests/unit` + `tests/integration`, no exclusions | — | 1643 passed / 1747; the 104 failures are the four environmental files below |
| `corepack pnpm test:component` | 0 | 126 passed |
| `corepack pnpm test:recipes` | 0 | 17 passed |
-| `corepack pnpm test:reference-feature` | 0 | 26 passed |
+| 참조 샘플 기능 시험(그 script는 2026-11-07 샘플과 함께 지웠다) | 0 | 26 passed |
### Environmental failures, not claimed as green
diff --git a/docs/operations/performance-evidence.md b/docs/operations/performance-evidence.md
index c1c6b1de..820861f3 100644
--- a/docs/operations/performance-evidence.md
+++ b/docs/operations/performance-evidence.md
@@ -20,15 +20,16 @@ Performance evidence is deliberately split by measurement context:
보고 예산을 정한다.
기준선 숫자는 이 문서에 적지 않는다. 손으로 적은 숫자는 두 번 낡았다. 기록은
-`config/scale/feature-shape-ceilings.json`의 `initialJavascript` 한 곳이다. 이 파일과 아래
-측정 테스트는 참조 기능을 복사해 재므로 샘플과 함께 지워진다. 문서 검사는 샘플을 지운 사본에서
-이 경로들을 요구하지 않는다(`scripts/lib/removable-template-features.ts`).
+`config/scale/feature-shape-ceilings.json`의 `initialJavascript` 한 곳이다. 측정은
+`create:feature --with-create --keyed`가 만드는 기능을 복사해 잰다
+(`scripts/scale/measure-feature-shape-growth.ts`, 2026-11-07 전에는 참조 샘플을 복사했다).
| 칸 | 뜻 |
|---|---|
| `gzipBytes`, `files` | 템플릿 그대로의 초기 JS gzip bytes와 파일 수(entry 포함) |
-| `perFeatureGzipBytes` | 있는 context에 참조 기능 모양 기능을 하나 더할 때 느는 초기 JS. 상한 1 KiB |
-| `perContextGzipBytes` | 새 context를 하나 더할 때 느는 초기 JS. 상한 512 B |
+| `firstFeatureGzipBytes` | 기능이 없는 템플릿에 첫 기능(과 그 context)을 더할 때 느는 초기 JS. 모든 기능이 함께 쓰는 코드가 이때 초기 청크에 들어온다. 한 번만 든다. 상한 없음(전체는 `check:bundle`의 예산이 막는다) |
+| `perFeatureGzipBytes` | 있는 context에 생성 기능 모양 기능을 하나 더할 때 느는 초기 JS. 상한 1 KiB |
+| `perContextGzipBytes` | 둘째 기능을 같은 context 대신 새 context에 둘 때 느는 초기 JS. 상한 512 B |
- `tests/unit/feature-shape-growth.test.ts`(unit, merge 단계)가 매번 빌드해 이
값을 재고, 상한을 넘거나 기록과 다르면(합계 256 B 초과, 파일 수 불일치, 기능·
@@ -120,11 +121,14 @@ lab 측정(`scripts/test-performance.ts`, FE-GATE-026)은 local 프로필 build
`context.sampling.targetDeepLink`에 남긴다. 예산은 `cls`와 같다(1105/15-01).
- 대상 화면(플랫폼 구성)은 기능 코드를 받지 않으므로 기능이 늘어도 수치가
거의 그대로다. 그래서 run마다 설치된 기능이 가진 첫 공개 내비게이션
- 라우트(`labFeatureRoute`, 템플릿에서는 `EXAMPLES_UI`)를 같은 시계로 따로 잰다
+ 라우트(`labFeatureRoute`)를 같은 시계로 따로 잰다
(`metrics.featureRouteInteractionMs`, `context.sampling.featureRoute`,
1105/15-04). 그런 라우트가 없으면 `measured: false`로 남기고 판정하지 않는다.
+ 템플릿은 기능이 없어 재지 않는다(2026-11-07 예제 화면 삭제 뒤. 그 전에는 예제
+ 화면 `/examples/ui`가 이 라우트였다). 공개 내비게이션 라우트를 가진 제품 기능이
+ 생기면 그 라우트를 잰다.
- 예산 `lab.featureRouteInteractionMs`는 500 ms다. 근거: `8a44226`에서 lab
- 조건으로 `EXAMPLES_UI`를 5회 재니 중앙값 406 ms(403~410)였다. 그 진입은 요청
+ 조건으로 그때의 예제 화면 라우트를 5회 재니 중앙값 406 ms(403~410)였다. 그 진입은 요청
두 묶음이다(context 라우트 모듈과 기능 실행부, 그다음 페이지 청크와 공유
청크). 둘째 묶음이 약 100 ms(클릭 뒤 98~204 ms)다. 500 ms는 지금 진입을
통과시키고, 같은 크기의 묶음이 하나 더 붙으면 넘는다.
diff --git a/docs/styling/design-tokens.md b/docs/styling/design-tokens.md
index bd31f947..dae8bd8e 100644
--- a/docs/styling/design-tokens.md
+++ b/docs/styling/design-tokens.md
@@ -62,8 +62,8 @@ Arbitrary-value policy:
- user-controlled or runtime-composed class strings are forbidden
- class variants must be selected from a closed static map
-The removable reference feature may demonstrate tokens, but generic production
-starter modules do not import its domain, application, adapter, or presentation
+A feature may demonstrate tokens, but generic production starter modules do
+not import a feature's domain, application, adapter, or presentation
implementation.
This file documents the currently implemented token and primitive baseline.
diff --git a/docs/testing/frontend-platform-testing-strategy.md b/docs/testing/frontend-platform-testing-strategy.md
index 5cdd8456..2bf3fb19 100644
--- a/docs/testing/frontend-platform-testing-strategy.md
+++ b/docs/testing/frontend-platform-testing-strategy.md
@@ -503,8 +503,9 @@ tests/support/query/
helper는 production default를 복사하지 않는다. production factory를 호출하고
필요한 시간·retry만 test override로 주입한다.
-RP-05의 executable reference matrix는
-`tests/features/reference-feature`에 모여 있다. 설치 모드에서는 URL codec과
+RP-05의 executable reference matrix는 참조 샘플의 시험 폴더에 모여 있었다(2026-11-07
+샘플과 함께 삭제). 지금 기능 하나의 경로는 `create:feature`가 만든 기능의 시험
+(`tests/features//`)과 `tests/e2e/generated-feature.spec.ts`가 본다. 그때 설치 모드에서는 URL codec과
query key/HTTP search의 동일성, DTO 차단, loading/success/empty/terminal,
refreshing/stale, pending/duplicate/optimistic/conflict/rollback과 MSW production
composition을 검증한다. 제거 모드는 feature source/tests와 installed
@@ -513,8 +514,8 @@ contract/runtime/adapter contribution을 제거한 복제본에서 P0 gate와 bu
RP-06 form/page matrix는 `tests/component/form-foundation.test.tsx`,
`tests/component/page-templates.test.tsx`,
-`tests/features/reference-feature/reference-page.test.tsx`와
-`tests/e2e/reference-form.spec.ts`에 있다. client validation에서 command 0회와
+생성 기능의 `-create-page.test.tsx`와
+`tests/e2e/generated-feature.spec.ts`에 있다(2026-11-07 전에는 참조 샘플의 페이지 시험과 폼 e2e). client validation에서 command 0회와
첫 오류 focus, Zod transform/default, pending 중 중복 제출, 승인된 422
field/unknown field mapping, conflict 입력 보존, reset/dirty, navigation
confirmation/focus restore, URL/storage 비노출과 320px reflow를 검증한다.
diff --git a/docs/testing/taxonomy.md b/docs/testing/taxonomy.md
index f54b4aad..d44b88f2 100644
--- a/docs/testing/taxonomy.md
+++ b/docs/testing/taxonomy.md
@@ -19,7 +19,7 @@ Each gate is blocking in its declared scope. Failures are not downgraded with
`test:all` is the normal product-development loop. It runs, in order,
`test:runtime-schema`, `test:unit`, `test:contract`, `test:component`,
`test:integration`, the rest of what `test:coverage` runs (`tests/features`,
-the reference sample's tests among them, `tests/scripts` and
+each installed feature's tests, `tests/scripts` and
`tests/scale/browser-soak.contract.test.ts`), `test:platform` (`tests/platform`
and `tests/architecture`), `check:release-coherence` and `test:recipes`
(`package.json` `test:all`). So every Vitest path the merge gate's coverage
diff --git a/eslint.config.ts b/eslint.config.ts
index cc8f0336..fbdcd82a 100644
--- a/eslint.config.ts
+++ b/eslint.config.ts
@@ -458,9 +458,9 @@ const hookRules = {
// template literal, a ternary, an object prop such as `heading.title`) is not
// seen; review catches those. A product replaces these selectors in its own
// config, for example to allow a brand name or to drop the rule for a
-// one-locale product. The platform overview (src/presentation/examples),
-// the example screens (src/features/platform-examples-feature/presentation)
-// and stories are workshop code and stay out; tests are outside these folders.
+// one-locale product. The platform overview (src/presentation/examples) and
+// stories (the galleries among them) are workshop code and stay out; tests
+// are outside these folders.
const screenTextDirectories = [
"src/presentation/boundaries",
"src/presentation/components",
@@ -912,13 +912,9 @@ export default [
`${directory}/**/*.tsx`,
`tests/fixtures/i18n/*/${directory}/**/*.tsx`,
]),
- // 1103/09-04. The example screens moved from src/presentation/examples
- // into this feature and stay workshop code: their copy is Korean in every
+ // Stories are workshop code: the galleries' copy is Korean in every
// locale on purpose (08-07).
- ignores: [
- "**/*.stories.tsx",
- "src/features/platform-examples-feature/presentation/**",
- ],
+ ignores: ["**/*.stories.tsx"],
rules: {
"no-restricted-syntax": [
...commonSecurityRules["no-restricted-syntax"],
diff --git a/package.json b/package.json
index 4d3c87c7..d3d1440d 100644
--- a/package.json
+++ b/package.json
@@ -78,7 +78,6 @@
"test:optional-recipe-removal": "node scripts/test-optional-recipe-removal.ts",
"test:browser-file-storage-removal": "node scripts/test-browser-file-storage-runtime-removal.ts",
"test:realtime-removal": "node scripts/test-realtime-runtime-removal.ts",
- "test:reference-feature": "node scripts/run-vitest.ts run tests/features/reference-feature --reporter=default --reporter=junit --outputFile.junit=artifacts/tests/reference-feature.xml --passWithNoTests",
"check:v8-coverage-counter-semantics": "node scripts/check-v8-coverage-counter-semantics.ts",
"test:coverage": "corepack pnpm check:v8-coverage-counter-semantics && node scripts/run-vitest.ts run tests/runtime-schema tests/unit tests/contract tests/component tests/integration tests/features tests/platform tests/architecture tests/release tests/scripts tests/scale/browser-soak.contract.test.ts --coverage --maxWorkers=4 --reporter=default --reporter=junit --outputFile.junit=artifacts/tests/coverage.xml && node scripts/check-risk-coverage.ts",
"check:coverage:fixture": "node scripts/check-risk-coverage.ts --summary tests/fixtures/coverage/below-threshold.json --artifact artifacts/quality/risk-coverage-fixture.json",
@@ -149,7 +148,7 @@
"check:request-fanout": "node scripts/check-request-fanout.ts && node scripts/check-request-fanout.ts --fixture",
"check:app-build-input": "node scripts/check-app-build-input.ts",
"check:app-build-input:bundle": "node scripts/check-app-build-input.ts --require-bundle",
- "test:extreme-scale:focused": "node scripts/run-vitest.ts run tests/scale/global-local-independence.test.ts tests/architecture/app-build-input.test.ts tests/architecture/request-fanout.test.ts tests/platform/traffic/request-fanout.test.ts tests/platform/traffic/request-deduplication.test.ts tests/features/reference-feature/reference-request-fanout.test.ts tests/features/reference-feature/reference-request-deduplication.test.ts tests/scripts/generate-product-feature-index.test.ts --reporter=default",
+ "test:extreme-scale:focused": "node scripts/run-vitest.ts run tests/scale/global-local-independence.test.ts tests/architecture/app-build-input.test.ts tests/architecture/request-fanout.test.ts tests/platform/traffic/request-fanout.test.ts tests/platform/traffic/request-deduplication.test.ts tests/scripts/generate-product-feature-index.test.ts --reporter=default",
"check:release-coherence": "node scripts/run-vitest.ts run tests/platform/release tests/release --reporter=default"
},
"dependencies": {
diff --git a/public/config.json b/public/config.json
index e8466b6e..2ad5dfc4 100644
--- a/public/config.json
+++ b/public/config.json
@@ -15,7 +15,5 @@
"SERVICE_WORKER": "DEFAULT",
"OFFLINE_COMMANDS": "DEFAULT"
},
- "FEATURE_OVERRIDES": {
- "reference-feature": "DEFAULT"
- }
+ "FEATURE_OVERRIDES": {}
}
diff --git a/public/release-manifest.json b/public/release-manifest.json
index 471e2dd2..ed7bd068 100644
--- a/public/release-manifest.json
+++ b/public/release-manifest.json
@@ -10,13 +10,6 @@
"routeChunks": {
"route-home": "src/presentation/pages/home-page.tsx",
"route-examples-platform": "src/presentation/examples/platform-overview-page.tsx",
- "route-examples-ui": "src/features/platform-examples-feature/presentation/ui-gallery-page.tsx",
- "route-examples-states": "src/features/platform-examples-feature/presentation/state-gallery-page.tsx",
- "route-examples-auth": "src/features/platform-examples-feature/presentation/auth-example-page.tsx",
- "route-reference-resources": "src/features/reference-feature/presentation/reference-resource-page.tsx",
- "route-reference-resource-detail": "src/features/reference-feature/presentation/reference-resource-detail-page.tsx",
- "route-reference-resource-form": "src/features/reference-feature/presentation/reference-resource-form-page.tsx",
- "route-reference-resource-status": "src/features/reference-feature/presentation/reference-resource-status-page.tsx",
"route-not-found": "src/presentation/pages/not-found-page.tsx"
},
"contractSet": {
diff --git a/scripts/check-browser-file-storage-boundaries.ts b/scripts/check-browser-file-storage-boundaries.ts
index 9866e541..1d23ab2f 100644
--- a/scripts/check-browser-file-storage-boundaries.ts
+++ b/scripts/check-browser-file-storage-boundaries.ts
@@ -141,10 +141,10 @@ const misplacedAdapterResults = [
),
},
{
- file: "src/features/reference-feature/adapters/boundary-fixture.ts",
+ file: "src/features/fixture-feature/adapters/boundary-fixture.ts",
result: runEslintSource(
objectUrlBypassSource,
- "src/features/reference-feature/adapters/boundary-fixture.ts",
+ "src/features/fixture-feature/adapters/boundary-fixture.ts",
),
},
{
diff --git a/scripts/check-i18n.ts b/scripts/check-i18n.ts
index 0c2c04c7..ab236d6b 100644
--- a/scripts/check-i18n.ts
+++ b/scripts/check-i18n.ts
@@ -59,9 +59,8 @@ if (!fixtureMode) {
// from an ordinary `.message` read. Fixture mode runs the ESLint rule on the
// fixture trees too, so this one gate shows the whole i18n contract rejecting
// every forbidden file and passing the allowed one.
-// `src/presentation/examples` (the platform overview) and the example
-// screens (`src/features/platform-examples-feature/presentation`, 1103/09-04)
-// are workshop code and stay out of the ESLint rule's scope on purpose.
+// `src/presentation/examples` (the platform overview) and the stories are
+// workshop code and stay out of the ESLint rule's scope on purpose.
const forbiddenFixtureRoot = "tests/fixtures/i18n/forbidden";
const allowedFixtureRoot = "tests/fixtures/i18n/allowed";
const sourceRoot = fixtureMode ? forbiddenFixtureRoot : ".";
diff --git a/scripts/lib/a11y-data-state.ts b/scripts/lib/a11y-data-state.ts
index 07db68ab..e5aee77c 100644
--- a/scripts/lib/a11y-data-state.ts
+++ b/scripts/lib/a11y-data-state.ts
@@ -113,7 +113,7 @@ type ReadFacts = Readonly<{
* not listed.
*
* This finds the detail pages that take their params schema from their read
- * (the reference sample and every `create:feature --with-create` slice). A
+ * (every `create:feature --with-create` slice). A
* detail page whose params schema differs is not found, and its record alone
* decides, as before.
*/
diff --git a/scripts/lib/feature-residue.ts b/scripts/lib/feature-residue.ts
index 459a6262..95202ea2 100644
--- a/scripts/lib/feature-residue.ts
+++ b/scripts/lib/feature-residue.ts
@@ -34,8 +34,8 @@ import path from "node:path";
* a test title), and no text rule tells that from a reference, so a spec
* that names only a one-word ID is not found either.
*
- * The reference sample keeps its own, wider pattern in
- * scripts/test-sample-removal.ts: the template owns all of its files.
+ * The drill applies the same rule to a sample a project lists in
+ * scripts/lib/removable-template-features.ts.
*/
function escapeRegExp(value: string): string {
return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
diff --git a/tests/e2e/support/generated-feature.ts b/scripts/lib/generated-feature.ts
similarity index 57%
rename from tests/e2e/support/generated-feature.ts
rename to scripts/lib/generated-feature.ts
index 3e2a3f0f..8430f836 100644
--- a/tests/e2e/support/generated-feature.ts
+++ b/scripts/lib/generated-feature.ts
@@ -1,14 +1,24 @@
import { spawnSync } from "node:child_process";
+import { cp, mkdtemp, rename, rm } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { tmpdir } from "node:os";
import path from "node:path";
import { pathToFileURL } from "node:url";
+import { localBuildEnvironment } from "./build-environment.ts";
+import { linkFixtureNodeModules } from "./fixture-node-modules.ts";
+import { REMOVAL_FIXTURE_COPY_TARGETS } from "./removal-fixture.ts";
+
/**
- * 2026-11-07. The template ships no feature. The browser checks that one
- * feature works end to end (its route, form and save, a save whose result is
- * lost) run on the feature `create:feature` writes: a fixture build
- * (fixture-builds.ts) gets it with `addGeneratedFeature` as its edit, so a
- * change of the generator's output fails here. The `--keyed` write slice is
- * the widest one the command makes.
+ * 2026-11-07. The template ships no feature. What needs one in a real build
+ * runs on the feature `create:feature` writes, added to a copy of the
+ * repository: the browser checks that one feature works end to end (route,
+ * form, save, a save whose result is lost; tests/e2e/generated-feature.spec.ts
+ * and the chunk recovery spec, whose fixture builds take `addGeneratedFeature`
+ * as their edit) and the browser soak's failing-backend visits
+ * (scripts/scale/browser-soak.ts, `buildWithGeneratedFeature`). A change of
+ * the generator's output fails there. The `--keyed` write slice is the widest
+ * one the command makes.
*/
export const GENERATED_FEATURE_ID = "order-feature";
@@ -78,3 +88,39 @@ export function generatedFeature(root: string): GeneratedFeature {
export function routePath(route: GeneratedRoute, id?: string): string {
return id === undefined ? route.path : route.path.replace(/:[A-Za-z][A-Za-z0-9_]*/u, id);
}
+
+/**
+ * A production build of a copy of the repository with the generated feature,
+ * in the local configuration. `remove` deletes the copy.
+ */
+export async function buildWithGeneratedFeature(prefix: string): Promise<
+ Readonly<{ dist: string; feature: GeneratedFeature; remove(): Promise }>
+> {
+ const root = await mkdtemp(path.join(tmpdir(), `${prefix}-`));
+ const remove = () => rm(root, { recursive: true, force: true });
+ try {
+ for (const entry of REMOVAL_FIXTURE_COPY_TARGETS) {
+ if (!existsSync(entry)) continue;
+ await cp(entry, path.join(root, entry), {
+ recursive: true,
+ filter: (source) => !source.includes(`${path.sep}.generated`),
+ });
+ }
+ await linkFixtureNodeModules(root);
+ await addGeneratedFeature(root);
+ const build = spawnSync(process.execPath, ["scripts/build-frontend.ts"], {
+ cwd: root,
+ encoding: "utf8",
+ env: localBuildEnvironment(),
+ });
+ if (build.status !== 0) {
+ throw new Error(`scripts/build-frontend.ts failed in ${root}:\n${build.stdout}\n${build.stderr}`);
+ }
+ const dist = path.join(root, "dist-generated-feature");
+ await rename(path.join(root, "dist"), dist);
+ return Object.freeze({ dist, feature: generatedFeature(root), remove });
+ } catch (error) {
+ await remove();
+ throw error;
+ }
+}
diff --git a/scripts/lib/removable-template-features.ts b/scripts/lib/removable-template-features.ts
index 39e5aed2..aea13657 100644
--- a/scripts/lib/removable-template-features.ts
+++ b/scripts/lib/removable-template-features.ts
@@ -1,14 +1,16 @@
/**
- * The features this template ships that a copied project may delete: the
- * reference sample (README "Files you can delete after copying") and the
- * example screens (docs/architecture/starter-experience.md, CHANGELOG "먼저
- * 할 일" 6). Each owns its folder under `src/features/` and `tests/features/`
- * and the context it is the only feature of. The reference sample also owns
- * files outside them, which `scripts/test-sample-removal.ts` deletes with it.
+ * The sample features a project ships and may delete later: each owns its
+ * folder under `src/features/` and `tests/features/`, the context it is the
+ * only feature of, and possibly files and package scripts outside them.
*
- * This is the one list. The removal drill reads the reference sample's paths
- * and scripts from it, and the documentation check reads the whole of it: a
- * feature counts as deleted once its `feature-module.ts` is gone.
+ * The template ships none: its reference sample and example screens were
+ * deleted on 2026-11-07, when the manual and `create:feature` took over their
+ * roles. A project that keeps a sample of its own lists it here. Then
+ * `test:sample-removal` without `--feature` (FE-GATE-020) deletes each one
+ * from a copy of the repository with these paths and scripts and runs the
+ * gates, and verify:documentation lets the documents name its paths until
+ * the sample is gone: a sample counts as deleted once its
+ * `feature-module.ts` is.
*/
export type RemovableTemplateFeature = Readonly<{
/** Its FEATURE_MODULE_ID, also its folder under src/features and tests/features. */
@@ -21,36 +23,7 @@ export type RemovableTemplateFeature = Readonly<{
scripts: readonly string[];
}>;
-export const REMOVABLE_TEMPLATE_FEATURES: readonly RemovableTemplateFeature[] = Object.freeze([
- Object.freeze({
- featureId: "reference-feature",
- contextDirectory: "src/contexts/reference-context",
- // 0929/10-02. The HTTP scenario catalog (tests/mocks) and the negative
- // type fixtures of the feature APIs run on the test contracts, so they
- // are platform checks and stay (commonTestPaths in the drill).
- extraPaths: Object.freeze([
- "tests/component/product-feature-switch.test.tsx",
- "tests/e2e/reference-form.spec.ts",
- "tests/e2e/reference-route.spec.ts",
- "tests/e2e/reference-save.spec.ts",
- // 11-04: the growth measurement copies this sample feature.
- "tests/unit/feature-shape-growth.test.ts",
- "scripts/scale/measure-feature-shape-growth.ts",
- "config/scale/feature-shape-growth.json",
- "config/scale/feature-shape-ceilings.json",
- ]),
- scripts: Object.freeze(["test:reference-feature"]),
- }),
- // 1103/09-04. The example screens /examples/ui, /examples/states and
- // /examples/auth. The platform overview (/examples/platform) is a platform
- // route and is not part of it.
- Object.freeze({
- featureId: "platform-examples-feature",
- contextDirectory: "src/contexts/platform-examples-context",
- extraPaths: Object.freeze([]),
- scripts: Object.freeze([]),
- }),
-]);
+export const REMOVABLE_TEMPLATE_FEATURES: readonly RemovableTemplateFeature[] = Object.freeze([]);
/** Every path removing `feature` deletes: its folders, its context and its extra files. */
export function removableTemplateFeaturePaths(feature: RemovableTemplateFeature): readonly string[] {
diff --git a/scripts/lib/removal-fixture.ts b/scripts/lib/removal-fixture.ts
index de5b83a9..f3246247 100644
--- a/scripts/lib/removal-fixture.ts
+++ b/scripts/lib/removal-fixture.ts
@@ -40,7 +40,7 @@ export const REMOVAL_FIXTURE_COPY_TARGETS = Object.freeze([
/**
* This is the only copy-target list. Each removal script used to keep its own,
- * and they drifted: the reference-feature fixture omitted
+ * and they drifted: the reference sample's fixture omitted
* `playwright.capabilities.config.ts`, which the repository file inventory
* requires, so supply-chain generation failed inside the fixture and took every
* provider suite down with it — twenty-odd failures with one cause.
diff --git a/scripts/scale/browser-soak.ts b/scripts/scale/browser-soak.ts
index 66ef7200..0d94bb3d 100644
--- a/scripts/scale/browser-soak.ts
+++ b/scripts/scale/browser-soak.ts
@@ -4,6 +4,7 @@ import { createServer, type Server } from "node:http";
import type { AddressInfo } from "node:net";
import path from "node:path";
+import { buildWithGeneratedFeature } from "../lib/generated-feature.ts";
import {
classifyCounterSeries,
classifyMemorySlope,
@@ -13,8 +14,12 @@ import {
/**
* scale-architecture.md §33 / §44. Browser soak on the existing Playwright runner.
*
- * Serves the built `dist/` on an OS-assigned 127.0.0.1 port and keeps one
- * long-lived page cycling through the app's routes by client-side navigation.
+ * Serves a build on an OS-assigned 127.0.0.1 port and keeps one long-lived
+ * page cycling through the app's routes by client-side navigation. One of
+ * them is a feature's protected list (`featureRoute`), signed in once, whose
+ * reads fail. The template has no feature: by default the soak builds a copy
+ * with the one `create:feature` writes (scripts/lib/generated-feature.ts);
+ * `--dist` with `--feature-route` soaks a build of a product's own.
* The served runtime config turns telemetry on (pointed at a local collector)
* and points the API at a stub that always answers 503, so every cycle also
* exercises bounded retries and telemetry under a sustained backend failure.
@@ -51,9 +56,9 @@ export type SoakSummary = Readonly<{
storageKeyDelta: number;
storageByteDelta: number;
apiRequests: number;
- referenceVisits: number;
- settledReferenceVisits: number;
- apiRequestsPerReferenceVisit: number;
+ featureVisits: number;
+ settledFeatureVisits: number;
+ apiRequestsPerFeatureVisit: number;
telemetryPosts: number;
telemetryEvents: number;
maxTelemetryPostsPerMinute: number;
@@ -83,7 +88,7 @@ export const SOAK_LIMITS = Object.freeze({
maxTimerDelta: 10,
maxStorageKeyDelta: 2,
/** One logical execution: 1 attempt + at most 2 retries. */
- maxApiRequestsPerReferenceVisit: 3,
+ maxApiRequestsPerFeatureVisit: 3,
/** Two bounded pipelines (platform events + feature events) x 20/min. */
maxTelemetryPostsPerMinute: 40,
});
@@ -104,8 +109,8 @@ export function summarizeSoak(
export type SoakTotals = Readonly<{
cycles: number;
navigationFailures: number;
- referenceVisits: number;
- settledReferenceVisits: number;
+ featureVisits: number;
+ settledFeatureVisits: number;
finalInFlightRequests: number;
apiRequests: number;
telemetryPosts: number;
@@ -148,12 +153,12 @@ export function evaluateSoak(
storageKeyDelta: delta((sample) => sample.storageKeys),
storageByteDelta: delta((sample) => sample.storageBytes),
apiRequests: totals.apiRequests,
- referenceVisits: totals.referenceVisits,
- settledReferenceVisits: totals.settledReferenceVisits,
- apiRequestsPerReferenceVisit:
- totals.referenceVisits === 0
+ featureVisits: totals.featureVisits,
+ settledFeatureVisits: totals.settledFeatureVisits,
+ apiRequestsPerFeatureVisit:
+ totals.featureVisits === 0
? 0
- : Math.round((totals.apiRequests / totals.referenceVisits) * 1_000) / 1_000,
+ : Math.round((totals.apiRequests / totals.featureVisits) * 1_000) / 1_000,
telemetryPosts: totals.telemetryPosts,
telemetryEvents: totals.telemetryEvents,
maxTelemetryPostsPerMinute,
@@ -192,15 +197,15 @@ export function evaluateSoak(
{
name: "backend failure exercised",
passed:
- summary.settledReferenceVisits > 0 && summary.apiRequests > 0 && summary.telemetryEvents > 0,
- detail: `${summary.settledReferenceVisits} settled visits, ${summary.apiRequests} API requests, ${summary.telemetryEvents} telemetry events`,
+ summary.settledFeatureVisits > 0 && summary.apiRequests > 0 && summary.telemetryEvents > 0,
+ detail: `${summary.settledFeatureVisits} settled visits, ${summary.apiRequests} API requests, ${summary.telemetryEvents} telemetry events`,
},
{
name: "request amplification",
passed:
- summary.referenceVisits > 0 &&
- summary.apiRequestsPerReferenceVisit <= SOAK_LIMITS.maxApiRequestsPerReferenceVisit,
- detail: `${summary.apiRequests} requests / ${summary.referenceVisits} visits`,
+ summary.featureVisits > 0 &&
+ summary.apiRequestsPerFeatureVisit <= SOAK_LIMITS.maxApiRequestsPerFeatureVisit,
+ detail: `${summary.apiRequests} requests / ${summary.featureVisits} visits`,
},
{
name: "telemetry rate",
@@ -348,6 +353,8 @@ export async function runBrowserSoak(
intervalMs: number;
warmupMs: number;
routes: readonly string[];
+ /** A feature's protected list: signed in on, then visited with the rest. */
+ featureRoute: string;
}>,
): Promise {
try {
@@ -397,13 +404,14 @@ export async function runBrowserSoak(
await page.addInitScript(PAGE_PROBES);
const cdp = await page.context().newCDPSession(page);
await cdp.send("Performance.enable");
- await page.goto(`${baseUrl}/examples/reference-resources`, { waitUntil: "load" });
+ await page.goto(`${baseUrl}${options.featureRoute}`, { waitUntil: "load" });
await page.waitForSelector("#root > *", { timeout: 15_000 });
// Protected routes need a session: start the local demo session once, so
- // the reference feature really dispatches its (failing) API requests.
- const login = page.getByRole("button", { name: /로그인 시작|Sign in|Start sign-in/u });
- if (await login.count()) {
- await login.first().click();
+ // the feature really dispatches its (failing) API requests.
+ // The prompt draws once the feature's context routes have loaded.
+ const login = page.getByRole("button", { name: /로그인 시작|Sign in|Start sign-in/u }).first();
+ if (await login.waitFor({ timeout: 10_000 }).then(() => true, () => false)) {
+ await login.click();
await page.waitForTimeout(500);
}
@@ -412,8 +420,8 @@ export async function runBrowserSoak(
let nextSample = 0;
let cycles = 0;
let navigationFailures = 0;
- let referenceVisits = 0;
- let settledReferenceVisits = 0;
+ let featureVisits = 0;
+ let settledFeatureVisits = 0;
const probe = async () =>
(await page.evaluate(() =>
(window as unknown as { __soakProbe: () => Probe }).__soakProbe(),
@@ -421,7 +429,7 @@ export async function runBrowserSoak(
while (Date.now() - started < options.durationMs) {
const route = options.routes[cycles % options.routes.length] ?? "/";
cycles += 1;
- if (route === "/examples/reference-resources") referenceVisits += 1;
+ if (route === options.featureRoute) featureVisits += 1;
// Client-side navigation keeps one long-lived document, like a real session.
await page.evaluate((target) => {
window.history.pushState({}, "", target);
@@ -436,10 +444,10 @@ export async function runBrowserSoak(
);
if (!rendered) navigationFailures += 1;
// Most visits leave after 50ms, which cancels the query (a cancelled
- // request is intentionally not reported). Every 5th reference visit
+ // request is intentionally not reported). Every 5th feature visit
// dwells until its interaction settles, so the failing backend is really
// observed end to end: bounded retries, then feature/platform telemetry.
- if (route === "/examples/reference-resources" && referenceVisits % 5 === 1) {
+ if (route === options.featureRoute && featureVisits % 5 === 1) {
await page.waitForTimeout(200);
await page
.waitForFunction(
@@ -448,7 +456,7 @@ export async function runBrowserSoak(
{ timeout: 5_000 },
)
.catch(() => undefined);
- settledReferenceVisits += 1;
+ settledFeatureVisits += 1;
}
const elapsedMs = Date.now() - started;
if (elapsedMs >= nextSample) {
@@ -483,8 +491,8 @@ export async function runBrowserSoak(
{
cycles,
navigationFailures,
- referenceVisits,
- settledReferenceVisits,
+ featureVisits,
+ settledFeatureVisits,
finalInFlightRequests,
apiRequests: counters.apiRequests,
telemetryPosts: counters.telemetryPosts,
@@ -526,16 +534,23 @@ async function main(): Promise {
const argument = (name: string, fallback: string) =>
process.argv.find((entry) => entry.startsWith(`--${name}=`))?.slice(name.length + 3) ?? fallback;
const artifact = path.resolve(argument("artifact", "artifacts/scale/browser-soak.json"));
+ const ownBuild = argument("dist", "");
+ const generated = ownBuild === "" ? await buildWithGeneratedFeature("browser-soak") : undefined;
+ const featureRoute = generated ? generated.feature.list.path : argument("feature-route", "");
+ if (featureRoute === "") {
+ throw new Error("--dist needs --feature-route=");
+ }
const result = await runBrowserSoak({
- distRoot: argument("dist", "dist"),
+ distRoot: generated?.dist ?? ownBuild,
durationMs: Number(argument("duration-ms", "60000")),
intervalMs: Number(argument("interval-ms", "5000")),
warmupMs: Number(argument("warmup-ms", "15000")),
routes: argument(
"routes",
- "/,/examples/reference-resources,/examples/platform,/examples/ui,/examples/states,/examples/reference-resources/status",
+ ["/", featureRoute, "/examples/platform", generated?.feature.create.path ?? "/not-found"].join(","),
).split(","),
- });
+ featureRoute,
+ }).finally(() => generated?.remove());
await mkdir(path.dirname(artifact), { recursive: true });
await writeFile(artifact, `${JSON.stringify(result, null, 2)}\n`);
process.stdout.write(
diff --git a/scripts/test-sample-removal.ts b/scripts/test-sample-removal.ts
index 8c4dbc10..e60d011d 100644
--- a/scripts/test-sample-removal.ts
+++ b/scripts/test-sample-removal.ts
@@ -8,8 +8,10 @@ import {
} from "node:fs/promises";
import { spawnSync } from "node:child_process";
import path from "node:path";
+import { fileURLToPath } from "node:url";
import { ROUTE_FEATURE_OWNER } from "../src/features/installed-feature-contracts.ts";
+import { loadCiGateContract } from "./contracts/ci-gates.ts";
import { createFileSystemDeclarationSource } from "./generate-product-feature-index.ts";
import { productFeatureResidue } from "./lib/feature-residue.ts";
import { isProductionModulePath } from "./lib/risk-coverage.ts";
@@ -32,42 +34,92 @@ import {
import { REMOVABLE_TEMPLATE_FEATURES } from "./lib/removable-template-features.ts";
/**
- * 09-07 (D-10). Removes one installed feature, `--feature=` (default: the
- * reference sample), from a copy of the repository and proves the rest still
- * typechecks, tests, covers and builds. Every feature loses its directory, its
- * tests/features directory, its context when no other feature is left in it,
- * its runtime-profile override and its central policy rows. The sample also
- * owns the extra paths and scripts listed in SAMPLE_EXTRAS.
+ * 09-07 (D-10). Removes one installed feature, `--feature=`, from a copy
+ * of the repository and proves the rest still typechecks, tests, covers and
+ * builds. Every feature loses its directory, its tests/features directory,
+ * its context when no other feature is left in it, its runtime-profile
+ * override and its central policy rows. A sample that
+ * scripts/lib/removable-template-features.ts lists also loses its extra paths
+ * and package scripts, with the CI evidence only those scripts produce, and
+ * the copy then gets a feature from create:feature and runs the gates again.
+ *
+ * Without `--feature` (FE-GATE-020) each listed sample is removed in turn.
+ * The template lists none since its samples were deleted (2026-11-07): the
+ * run then reports the drill as skipped, not passed, and test:feature-scaffold
+ * removes a generated feature through `--feature`.
*/
-const featureId =
- process.argv.find((argument) => argument.startsWith("--feature="))
- ?.slice("--feature=".length) ?? "reference-feature";
+const SAMPLE_REPORT = "artifacts/tests/sample-removal.xml";
+const requestedFeature = process.argv
+ .find((argument) => argument.startsWith("--feature="))
+ ?.slice("--feature=".length);
+
+if (requestedFeature === undefined) {
+ const checks: RemovalCheck[] = REMOVABLE_TEMPLATE_FEATURES.map((sample) => {
+ const status = spawnSync(
+ process.execPath,
+ [fileURLToPath(import.meta.url), `--feature=${sample.featureId}`],
+ { stdio: "inherit" },
+ ).status;
+ return status === 0
+ ? { name: sample.featureId, passed: true }
+ : {
+ name: sample.featureId,
+ passed: false,
+ failure: `test:sample-removal -- --feature=${sample.featureId} exited ${status ?? "on a signal"}`,
+ };
+ });
+ await mkdir("artifacts/tests", { recursive: true });
+ if (checks.length === 0) {
+ await writeFile(
+ SAMPLE_REPORT,
+ `\n` +
+ `` +
+ `` +
+ `\n`,
+ );
+ process.stdout.write(
+ "sample removal: SKIP (scripts/lib/removable-template-features.ts lists no sample; " +
+ "test:feature-scaffold removes a generated feature with --feature)\n",
+ );
+ } else {
+ await writeFile(SAMPLE_REPORT, renderRemovalJunit("sample-removal", checks));
+ if (checks.some((check) => !check.passed)) process.exitCode = 1;
+ }
+ process.exit();
+}
+const featureId: string = requestedFeature;
type FeatureExtras = Readonly<{
paths: readonly string[];
ciScripts: readonly string[];
evidencePathFragments: readonly string[];
- residue: RegExp;
}>;
-// The sample's own files and scripts outside its folders are declared with
-// the other removable template features, which verify:documentation reads too.
-const REFERENCE_SAMPLE = REMOVABLE_TEMPLATE_FEATURES.find(
- (feature) => feature.featureId === "reference-feature",
-);
-if (REFERENCE_SAMPLE === undefined) {
- throw new Error("scripts/lib/removable-template-features.ts does not declare reference-feature");
+/** The CI evidence that only `scripts` produce: it goes with them. */
+async function evidenceOnlyFrom(scripts: readonly string[]): Promise {
+ if (scripts.length === 0) return [];
+ const contract = await loadCiGateContract(process.cwd());
+ const commandIds = new Set(
+ contract.commands.filter(({ script }) => scripts.includes(script)).map(({ id }) => id),
+ );
+ return contract.artifacts.flatMap((artifact) =>
+ artifact.production === "command-generated" &&
+ artifact.producerCommandIds.length > 0 &&
+ artifact.producerCommandIds.every((commandId) => commandIds.has(commandId))
+ ? [artifact.path]
+ : [],
+ );
}
-const SAMPLE_EXTRAS: Readonly> = Object.freeze({
- "reference-feature": Object.freeze({
- paths: REFERENCE_SAMPLE.extraPaths,
- ciScripts: REFERENCE_SAMPLE.scripts,
- evidencePathFragments: [
- "reference-feature.xml",
- ],
- residue: /REFERENCE_RESOURCE|reference-feature|reference-resource/i,
- }),
+// The sample's own files and scripts outside its folders, which
+// verify:documentation reads too.
+const listedSample = REMOVABLE_TEMPLATE_FEATURES.find(
+ (feature) => feature.featureId === featureId,
+);
+const extras: FeatureExtras = Object.freeze({
+ paths: listedSample?.extraPaths ?? [],
+ ciScripts: listedSample?.scripts ?? [],
+ evidencePathFragments: await evidenceOnlyFrom(listedSample?.scripts ?? []),
});
function escapeRegExp(value: string): string {
@@ -106,15 +158,6 @@ async function locateFeature(id: string) {
}
const located = await locateFeature(featureId);
-const extras: FeatureExtras = SAMPLE_EXTRAS[featureId] ?? Object.freeze({
- paths: [],
- ciScripts: [],
- evidencePathFragments: [],
- residue: new RegExp(
- `${escapeRegExp(featureId)}|${escapeRegExp(located.directory)}`,
- "i",
- ),
-});
// Captured from this repository before the copy loses them.
const featureRouteIds = Object.entries(ROUTE_FEATURE_OWNER)
.filter(([, owner]) => owner === featureId)
@@ -124,7 +167,7 @@ const fixtureRoot = await createRemovalFixtureRoot(`${featureId}-removal`);
const pnpmCli = requireRemovalFixtureEnvironment("npm_execpath");
const featureSource = `src/features/${located.directory}`;
const featureTests = `tests/features/${located.directory}`;
-const isSample = featureId in SAMPLE_EXTRAS;
+const isSample = listedSample !== undefined;
/**
* Platform tests that must survive the sample feature's removal. Asserting they
* are still present is what stops the removal fixture from "passing" by having
@@ -281,12 +324,6 @@ try {
const retainedCriticalModules = coveragePolicy.criticalModules.filter(
(modulePolicy) => !modulePolicy.path?.startsWith(`${featureSource}/`),
);
- if (
- isSample &&
- retainedCriticalModules.length === coveragePolicy.criticalModules.length
- ) {
- throw new Error("Reference feature coverage policy is not registered");
- }
coveragePolicy.criticalModules = retainedCriticalModules;
coveragePolicy.highRiskPaths = coveragePolicy.highRiskPaths.filter(
(modulePath) => !modulePath.startsWith(`${featureSource}/`),
@@ -299,7 +336,7 @@ try {
);
coveragePolicy.repositoryBaseline -= removedProductionModuleCount;
if (coveragePolicy.repositoryBaseline <= 0) {
- throw new Error("Reference feature removal produced an invalid coverage baseline");
+ throw new Error(`${featureId} removal produced an invalid coverage baseline`);
}
await writeFile(
coveragePolicyFile,
@@ -400,7 +437,7 @@ try {
// JavaScript of the features installed now, and test:unit compares a build
// with it. A product re-records it when it adds a feature; removing that
// feature changes it again, so the fixture re-records it as the product
- // would. The sample removal deletes the measurement with the sample.
+ // would.
const measurement = path.join(fixtureRoot, "scripts/scale/measure-feature-shape-growth.ts");
if (await access(measurement).then(() => true, () => false)) {
const measured = spawnSync(
@@ -414,22 +451,13 @@ try {
}
await regenerateRemovalFixtureWorkflow(fixtureRoot);
- const residue: string[] = [];
- if (isSample) {
- for (const root of ["src", "tests"]) {
- for (const file of await filesBelow(path.join(fixtureRoot, root))) {
- const relative = path.relative(fixtureRoot, file);
- const content = await readFile(file, "utf8");
- if (extras.residue.test(`${relative}\n${content}`)) {
- residue.push(relative);
- }
- }
- }
- } else {
- // 1105/16-04. Template tests use example feature IDs as data; only what
- // still points at the removed feature counts (scripts/lib/feature-residue.ts).
- residue.push(...(await productFeatureResidue(fixtureRoot, featureId, located.directory)));
- }
+ // 1105/16-04. Template tests use example feature IDs as data; only what
+ // still points at the removed feature counts (scripts/lib/feature-residue.ts).
+ const residue = await productFeatureResidue(fixtureRoot, featureId, located.directory);
+ const builtResiduePattern = new RegExp(
+ `${escapeRegExp(featureId)}|${escapeRegExp(located.directory)}`,
+ "i",
+ );
const missingCommonTests: string[] = [];
for (const testPath of commonTestPaths) {
@@ -471,7 +499,7 @@ try {
for (const file of await filesBelow(path.join(fixtureRoot, "dist"))) {
if (!/\.(?:js|css|html|json)$/.test(file)) continue;
const content = await readFile(file, "utf8");
- if (extras.residue.test(content)) {
+ if (builtResiduePattern.test(content)) {
builtResidue.push(path.relative(fixtureRoot, file));
}
}
@@ -493,9 +521,9 @@ try {
outcome("built-fixture-id-residue", builtResidue, "built residue"),
);
- // U7 (decision 4). The same copy, now without the sample, gets one feature
- // from create:feature and runs the same gates again: the command and the
- // feature it writes need nothing from the sample.
+ // U7 (decision 4). The same copy, now without the listed sample, gets one
+ // feature from create:feature and runs the same gates again: the command
+ // and the feature it writes need nothing from the sample.
if (isSample) {
// 1103/09-06. With the write slice (NEVER), which needs nothing from
// the sample either.
@@ -513,9 +541,7 @@ try {
const failed = checks.filter((entry) => !entry.passed);
await mkdir("artifacts/tests", { recursive: true });
await writeFile(
- isSample
- ? "artifacts/tests/sample-removal.xml"
- : `artifacts/tests/feature-removal-${featureId}.xml`,
+ `artifacts/tests/feature-removal-${featureId}.xml`,
renderRemovalJunit(`${featureId}-removal`, checks),
);
if (failed.length > 0) {
diff --git a/scripts/verify-documentation-readiness.ts b/scripts/verify-documentation-readiness.ts
index 32f4b322..5f72f0df 100644
--- a/scripts/verify-documentation-readiness.ts
+++ b/scripts/verify-documentation-readiness.ts
@@ -187,15 +187,12 @@ const gateIds = new Set([
).gates.map((gate) => gate.id),
...RETIRED_GATE_IDS,
]);
-// 1105/14-01. A copy may delete the template features listed in
-// scripts/lib/removable-template-features.ts, and the CHANGELOG tells
-// tech-log to delete the example screens. The documents are the template's:
-// a product that edited them to drop the feature's paths would conflict on
-// every sync. While a feature is installed (its feature-module.ts exists),
-// its paths and scripts are checked like any other; once it is not, they are
-// not drift. tech-log keeps the reference sample's folder with its contracts
-// but without its module, screens and tests (CHANGELOG "먼저 할 일" 1). A
-// misspelt feature folder is not on the list and still fails.
+// 1105/14-01. A copy may delete the sample features listed in
+// scripts/lib/removable-template-features.ts (the template lists none since
+// 2026-11-07). The documents may name a sample's paths: while it is installed
+// (its feature-module.ts exists), its paths and scripts are checked like any
+// other; once it is not, they are not drift. A misspelt feature folder is not
+// on the list and still fails.
const removedTemplateFeatures = REMOVABLE_TEMPLATE_FEATURES.filter(
(feature) => !exists(`src/features/${feature.featureId}/feature-module.ts`),
);
diff --git a/scripts/verify-extreme-scale.ts b/scripts/verify-extreme-scale.ts
index 2fc9c913..8bffa3bb 100644
--- a/scripts/verify-extreme-scale.ts
+++ b/scripts/verify-extreme-scale.ts
@@ -35,7 +35,6 @@ export const EXTREME_SCALE_GATES = Object.freeze([
"check:observability",
"check:release-coherence",
"test:platform",
- "test:reference-feature",
"check:scale:pr",
"check:scale:main",
"check:scale:baseline",
diff --git a/src/contexts/platform-examples-context/context-module.ts b/src/contexts/platform-examples-context/context-module.ts
deleted file mode 100644
index 930b0859..00000000
--- a/src/contexts/platform-examples-context/context-module.ts
+++ /dev/null
@@ -1,12 +0,0 @@
-/**
- * 1103/09-04. The template's example screens (UI gallery, screen states,
- * auth integration) as one removable bounded context. A product leaves
- * `platform-examples-feature` out of `VITE_PRODUCT_FEATURES`, or deletes it,
- * and the three routes leave the registry, the navigation, the bundle and the
- * manual accessibility list together. The root is `examples/*`; the sample
- * feature's own context keeps a more specific path below it.
- */
-export const CONTEXT_MODULE_ID = "platform-examples-context";
-export const CONTEXT_APP_ID = "template-app";
-export const CONTEXT_ROUTE_PATH = "examples/*";
-export const CONTEXT_MAX_FEATURES = 1;
diff --git a/src/contexts/reference-context/context-module.ts b/src/contexts/reference-context/context-module.ts
deleted file mode 100644
index 11c6996b..00000000
--- a/src/contexts/reference-context/context-module.ts
+++ /dev/null
@@ -1,10 +0,0 @@
-/**
- * Ownership declaration of the reference bounded context (the rules are in
- * docs/architecture/starter-experience.md, "Ownership declarations"): the app
- * that owns it, its route root, and its direct-feature budget. Features name
- * this id as their owner.
- */
-export const CONTEXT_MODULE_ID = "reference-context";
-export const CONTEXT_APP_ID = "template-app";
-export const CONTEXT_ROUTE_PATH = "examples/reference-resources/*";
-export const CONTEXT_MAX_FEATURES = 200;
diff --git a/src/features/platform-examples-feature/context-routes.ts b/src/features/platform-examples-feature/context-routes.ts
deleted file mode 100644
index 1e332afe..00000000
--- a/src/features/platform-examples-feature/context-routes.ts
+++ /dev/null
@@ -1,17 +0,0 @@
-import type { RouteObject } from "react-router-dom";
-
-import { PLATFORM_EXAMPLES_CONTRACT } from "./contracts/platform-examples-contract.ts";
-import { PLATFORM_EXAMPLES_ROUTE_RUNTIME } from "./presentation/platform-examples-runtime.ts";
-
-export const FEATURE_CONTEXT_ROUTES: readonly RouteObject[] = Object.freeze(
- Object.values(PLATFORM_EXAMPLES_CONTRACT.routes).map((definition) =>
- Object.freeze({
- id: definition.routeId,
- path: definition.path,
- handle: Object.freeze({
- routeId: definition.routeId,
- runtime: PLATFORM_EXAMPLES_ROUTE_RUNTIME[definition.routeId],
- }),
- }),
- ),
-);
diff --git a/src/features/platform-examples-feature/contracts/platform-examples-contract.ts b/src/features/platform-examples-feature/contracts/platform-examples-contract.ts
deleted file mode 100644
index e98498e4..00000000
--- a/src/features/platform-examples-feature/contracts/platform-examples-contract.ts
+++ /dev/null
@@ -1,82 +0,0 @@
-export const PLATFORM_EXAMPLES_FEATURE_ID = "platform-examples-feature";
-
-/**
- * 1103/09-04. Three of the template's example screens, formerly fixed
- * platform routes. The platform overview (`EXAMPLES_PLATFORM`) stays a
- * platform route: the lab gate (FE-GATE-026) times entering it, and a feature
- * route's first entry costs a second request round (its context's routes
- * module, then the page). Paths, chunk ids and surfaces are unchanged: the
- * visual and e2e tests and the manual accessibility records still name them.
- * Declaration only, so it holds data; the pages load with `context-routes.ts`.
- */
-export const PLATFORM_EXAMPLES_CONTRACT = Object.freeze({
- featureId: PLATFORM_EXAMPLES_FEATURE_ID,
- routes: Object.freeze({
- EXAMPLES_UI: Object.freeze({
- routeId: "EXAMPLES_UI",
- path: "/examples/ui",
- paramsSchema: null,
- searchSchema: null,
- access: "public",
- loadingSurface: "example-page",
- errorSurface: "route-boundary",
- chunkId: "route-examples-ui",
- title: "UI 구성요소",
- navigationLabel: "UI 구성요소",
- navigationOrder: 20,
- }),
- EXAMPLES_STATES: Object.freeze({
- routeId: "EXAMPLES_STATES",
- path: "/examples/states",
- paramsSchema: null,
- searchSchema: null,
- access: "public",
- loadingSurface: "example-page",
- errorSurface: "route-boundary",
- chunkId: "route-examples-states",
- title: "화면 상태",
- navigationLabel: "화면 상태",
- navigationOrder: 30,
- }),
- EXAMPLES_AUTH: Object.freeze({
- routeId: "EXAMPLES_AUTH",
- path: "/examples/auth",
- paramsSchema: null,
- searchSchema: null,
- access: "public",
- loadingSurface: "example-page",
- errorSurface: "route-boundary",
- chunkId: "route-examples-auth",
- title: "인증 연동",
- navigationLabel: "인증 연동",
- navigationOrder: 40,
- }),
- }),
- routeRuntimeContracts: Object.freeze({
- EXAMPLES_UI: Object.freeze({
- routeId: "EXAMPLES_UI",
- moduleId: "ui-gallery-page",
- paramsCodec: "none",
- searchCodec: "none",
- }),
- EXAMPLES_STATES: Object.freeze({
- routeId: "EXAMPLES_STATES",
- moduleId: "state-gallery-page",
- paramsCodec: "none",
- searchCodec: "none",
- }),
- EXAMPLES_AUTH: Object.freeze({
- routeId: "EXAMPLES_AUTH",
- moduleId: "auth-example-page",
- paramsCodec: "none",
- searchCodec: "none",
- }),
- }),
- invalidation: Object.freeze({
- topics: Object.freeze([]),
- namespaces: Object.freeze([]),
- edges: Object.freeze([]),
- }),
- topicVersions: Object.freeze([]),
- contractPackages: Object.freeze([]),
-} as const);
diff --git a/src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts b/src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts
deleted file mode 100644
index 310c98d4..00000000
--- a/src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts
+++ /dev/null
@@ -1,23 +0,0 @@
-/**
- * 1103/09-04. The route titles and navigation labels the shell reads; they
- * moved here from the platform catalog with the routes. The pages' own copy
- * stays Korean in every locale (08-07).
- */
-export const PLATFORM_EXAMPLES_MESSAGE_CATALOGS = Object.freeze({
- "ko-KR": Object.freeze({
- "route.EXAMPLES_UI.navigation": "UI 구성요소",
- "route.EXAMPLES_UI.title": "UI 구성요소",
- "route.EXAMPLES_STATES.navigation": "화면 상태",
- "route.EXAMPLES_STATES.title": "화면 상태",
- "route.EXAMPLES_AUTH.navigation": "인증 연동",
- "route.EXAMPLES_AUTH.title": "인증 연동",
- }),
- "en-US": Object.freeze({
- "route.EXAMPLES_UI.navigation": "UI components",
- "route.EXAMPLES_UI.title": "UI components",
- "route.EXAMPLES_STATES.navigation": "Screen states",
- "route.EXAMPLES_STATES.title": "Screen states",
- "route.EXAMPLES_AUTH.navigation": "Authentication",
- "route.EXAMPLES_AUTH.title": "Authentication",
- }),
-} as const);
diff --git a/src/features/platform-examples-feature/feature-module.ts b/src/features/platform-examples-feature/feature-module.ts
deleted file mode 100644
index 7d7b3fc4..00000000
--- a/src/features/platform-examples-feature/feature-module.ts
+++ /dev/null
@@ -1,27 +0,0 @@
-import { defineFeatureModule } from "../feature-module.ts";
-import {
- PLATFORM_EXAMPLES_CONTRACT,
- PLATFORM_EXAMPLES_FEATURE_ID,
-} from "./contracts/platform-examples-contract.ts";
-import { PLATFORM_EXAMPLES_MESSAGE_CATALOGS } from "./contracts/platform-examples-message-catalog.ts";
-
-export const FEATURE_MODULE_ID =
- "platform-examples-feature" satisfies typeof PLATFORM_EXAMPLES_FEATURE_ID;
-/** Owning bounded context (route root and budget live in its declaration). */
-export const FEATURE_CONTEXT_ID = "platform-examples-context";
-
-/**
- * 1103/09-04. The template's example screens as a feature, so the product's
- * feature selection, `FEATURE_OVERRIDES`, the removal drill and the manual
- * accessibility list apply to them like to any feature. Declaration only:
- * the pages load with the context routes, and the runtime half is empty.
- */
-export const PLATFORM_EXAMPLES_FEATURE_MODULE = defineFeatureModule({
- id: FEATURE_MODULE_ID,
- contracts: PLATFORM_EXAMPLES_CONTRACT,
- routes: PLATFORM_EXAMPLES_CONTRACT.routes,
- messages: PLATFORM_EXAMPLES_MESSAGE_CATALOGS,
- loadRuntime: async () => (await import("./feature-runtime.ts")).FEATURE_RUNTIME,
-} as const);
-
-export const FEATURE_MODULE = PLATFORM_EXAMPLES_FEATURE_MODULE;
diff --git a/src/features/platform-examples-feature/feature-runtime.ts b/src/features/platform-examples-feature/feature-runtime.ts
deleted file mode 100644
index 7ab57e96..00000000
--- a/src/features/platform-examples-feature/feature-runtime.ts
+++ /dev/null
@@ -1,13 +0,0 @@
-import { defineFeatureRuntime } from "../feature-module.ts";
-import { PLATFORM_EXAMPLES_FEATURE_ID } from "./contracts/platform-examples-contract.ts";
-
-/**
- * 1103/09-04. The example screens call no feature API: they show the
- * design system and the shell's session. The runtime half is empty.
- */
-export const FEATURE_RUNTIME = defineFeatureRuntime({
- featureId: PLATFORM_EXAMPLES_FEATURE_ID,
- schemas: Object.freeze({}),
- adapters: [],
- contractContributions: [],
-} as const);
diff --git a/src/features/platform-examples-feature/presentation/auth-example-page.tsx b/src/features/platform-examples-feature/presentation/auth-example-page.tsx
deleted file mode 100644
index b7dcf908..00000000
--- a/src/features/platform-examples-feature/presentation/auth-example-page.tsx
+++ /dev/null
@@ -1,61 +0,0 @@
-import { PageHeader } from "../../../presentation/design-system/index.ts";
-import {
- useSession,
- useSessionAction,
-} from "../../../presentation/providers/session-provider.tsx";
-
-export default function AuthExamplePage() {
- const { sessionState } = useSession();
- const { pending, failed, run } = useSessionAction();
-
- return (
- // 08-07. Example copy is Korean in every locale (outside the catalog).
-
-
-
-