diff --git a/docs/guides/adding-a-feature.md b/docs/guides/adding-a-feature.md index 8af4a8b..a7588dd 100644 --- a/docs/guides/adding-a-feature.md +++ b/docs/guides/adding-a-feature.md @@ -9,7 +9,7 @@ by one package under `packages//`. > `navigation` reference shape (DI, tRPC router with tests, span + capture > sandwich, dev seed, contract suite). See > [Scaffolding a Feature](./scaffolding-a-feature.md). Use this guide when -> the generator's Phase-1 scope doesn't fit — multi-entity layouts, custom +> the generator's default scope doesn't fit — multi-entity layouts, custom > shapes, or extending an existing feature — or when you need to understand > what the generator emits and why. diff --git a/docs/guides/scaffolding-a-feature.md b/docs/guides/scaffolding-a-feature.md index a5b8bfc..d16acd6 100644 --- a/docs/guides/scaffolding-a-feature.md +++ b/docs/guides/scaffolding-a-feature.md @@ -55,7 +55,7 @@ See `docs/guides/conformance-quickref.md` for the manifest field reference. with the canonical safeParse → presenter shape - Mock + real repository (`src/infrastructure/repositories/.repository{,.mock}.ts`). Both wrap calls in `tracer.startSpan`; the real repo also calls - `logger.captureException` on errors. The real repo body is a Phase-1 + `logger.captureException` on errors. The real repo body is a stub that returns `null` until you wire a Payload collection. - DI: `symbols.ts`, `module.ts`, `container.ts`, plus `bind-production.ts` and `bind-dev-seed.ts` that compose @@ -67,7 +67,7 @@ See `docs/guides/conformance-quickref.md` for the manifest field reference. - Contract suite (`__contracts__/`), dev seed (`__seeds__/dev.ts`), and empty stubs for `__factories__/` and `ui/` -## Phase-1 scope (intentionally limited) +## Scope (intentionally limited) The generator does NOT yet emit: @@ -113,7 +113,7 @@ pnpm turbo gen realtime channel # realtime channel descriptor (ADR-016) pnpm turbo gen realtime handler # inbound realtime handler (ADR-016) ``` -The event/job generators insert at six fixed `// ` anchor comments. Generated features include four of them automatically (the `// ` location is in `integrations/cms/index.ts`, which is manually authored as part of Phase-2 wiring); pre-existing features were retrofitted in ADR-015. +The event/job generators insert at six fixed `// ` anchor comments. Generated features include four of them automatically (the `// ` location is in `integrations/cms/index.ts`, which is manually authored as part of the post-scaffold wiring); pre-existing features were retrofitted in ADR-015. The realtime generators insert at three additional fixed `// ` anchor comments (`// ` in `src/index.ts`, `// ` in `src/di/symbols.ts`, `// ` in both `bind-*.ts` files). Generated features include all three automatically; pre-existing features were retrofitted in ADR-016. diff --git a/docs/guides/tdd-workflow.md b/docs/guides/tdd-workflow.md index 4686950..74b2174 100644 --- a/docs/guides/tdd-workflow.md +++ b/docs/guides/tdd-workflow.md @@ -605,7 +605,7 @@ describe("CommentsRepository", () => { The `buildSubject` pattern ensures each `run()` call supplies a fresh instance — every contract `it()` starts with a clean repository. -**File naming convention (post-Plan-8):** +**File naming convention:** - Mock implementation: `.repository.mock.ts` (not `mock-.repository.ts`) - Mock test: `.repository.mock.test.ts`