create-claude-workspace 1.1.65 → 1.1.67

package/dist/template/.claude/agents/backend-ts-architect.md

@@ -34,7 +34,7 @@ You are a Senior Backend TypeScript Architect with deep expertise in server-side
 ## Architecture Patterns
 
 **Onion Architecture per domain:**
-- `domain/` — models, repository interfaces, value objects (no dependencies)
+- `domain/` — **TypeBox schemas** (single source of truth for all types), repository interfaces, value objects (no dependencies). Define schemas here, derive TypeScript types via `Static<typeof Schema>`. NEVER create separate interface files when a TypeBox schema exists — use `Static<>` everywhere (API, frontend, DB mapping).
 - `business/` — use cases, business logic (depends on domain only)
 - `api/` — Hono routes, validation, OpenAPI (depends on business + domain)
 - `infrastructure/` — repository implementations, external APIs (depends on domain)
@@ -63,6 +63,7 @@ Always prefer `@cibule/*` packages over custom implementations:
 - Platform-specific code lives ONLY in `infrastructure/` layer behind abstract repository interfaces
 - Use Web Standard APIs: `fetch`, `Request`, `Response`, `URL`, `crypto`, `TextEncoder`/`TextDecoder`
 - Hono is inherently platform-agnostic — inject platform bindings via DI, not `c.env` in routes
+- **OpenAPI-first**: All API routes MUST use `hono-openapi` with `openAPIRouteHandler` — generates OpenAPI spec from TypeBox schemas. Serve API docs via `@scalar/hono-api-reference` at `/reference`. Never define routes without OpenAPI metadata.
 - Entry points handle platform wiring:
   - Worker entry: exports `default { fetch }` with Hono app + D1 bindings
   - Node entry: `serve()` with Hono app + SQLite/better-sqlite3 bindings
@@ -84,7 +85,7 @@ Always prefer `@cibule/*` packages over custom implementations:
 - `moduleResolution: "bundler"` — NEVER add `.js` extensions to imports (write `'./foo'`, not `'./foo.js'`)
 - `readonly` on all fields that don't need reassignment
 - Custom error classes for domain-specific errors
-- Input validation at system boundaries — **TypeBox** preferred (compile-time types + runtime validation from one schema, no duplication). Use `@sinclair/typebox` and `@sinclair/typebox/compiler` for `TypeCompiler`.
+- Input validation at system boundaries — **TypeBox** preferred (compile-time types + runtime validation from one schema, no duplication). Use `typebox` and `typebox/compiler` for `TypeCompiler`.
 - Async/await patterns (no callback hell)
 - Separation of concerns (routes, services, repositories)
 - File size limit: MAX 200 lines per TypeScript file

package/dist/template/.claude/templates/claude-md.md

@@ -115,7 +115,8 @@ After generation, the architect's plan specifies what code to write IN the gener
 |  Use cases, business logic                            |
 +-----------------------------------------------------+
 |                      domain/                          |
-|  Models, repository interfaces, value objects         |
+|  TypeBox schemas (single source of truth), types,     |
+|  repository interfaces, value objects                 |
 +-----------------------------------------------------+
 |                   infrastructure/                     |
 |  Repository implementations (database, API, mock)     |
@@ -131,6 +132,13 @@ Dependency rules:
 - ui -> shared/ui, domain (for types)
 - feature -> ui, data-access, shared/ui
 
+**TypeBox as single source of truth**: Define TypeBox schemas in `domain/` layer (`libs/[domain]/domain/`). These schemas are the canonical definition — derive everything from them:
+- **TypeScript types**: `Static<typeof MySchema>` — no separate interface definitions
+- **API validation**: `openAPIRouteHandler` uses the same schemas for request/response validation + OpenAPI spec
+- **Frontend types**: Frontend imports types from domain lib via `@[PREFIX]/[domain]-domain` — no copy-paste
+- **DB mapping**: Infrastructure layer maps between DB rows and domain types
+- NEVER duplicate type definitions. If a type exists as a TypeBox schema, use `Static<>` everywhere.
+
 ### @cibule/* Ecosystem (Preferred Libraries)
 
 [Include only if project uses backend or fullstack architecture]
@@ -281,7 +289,8 @@ Key rules enforced (do NOT weaken):
 
 [Include only if the project has a backend]
 
-- Hono routes with validation (**TypeBox** — `@sinclair/typebox` for schema + type inference, `TypeCompiler` for runtime validation)
+- Hono routes with validation (**TypeBox** — `typebox` for schema + type inference, `TypeCompiler` for runtime validation)
+- **OpenAPI-first**: Use `hono-openapi` with `openAPIRouteHandler` for all API routes — generates OpenAPI spec from TypeBox schemas automatically. API docs served via `@scalar/hono-api-reference` at `/reference`.
 - `@cibule/di` for dependency injection (see @cibule/* Ecosystem section above)
 - `@cibule/db` + driver for database access, UnitOfWork for atomic writes
 - `@cibule/storage` + driver for file storage, `@cibule/image` + driver for image processing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-claude-workspace",
-  "version": "1.1.65",
+  "version": "1.1.67",
   "description": "Scaffold a project with Claude Code agents for autonomous AI-driven development",
   "type": "module",
   "bin": {