hono-ddd-guidelines

A guide for implementing a new or refactoring an existing codebase of Hono's backend using DDD architecture. It includes layer structure (domain/application/infrastructure/controller), dependency direction, responsibility boundaries, leveraging official Hono middleware/plugins, mandatory adoption of Hono OpenAPI plugin (hono-openapi) and zod-openapi, usage of Drizzle ORM, transaction boundaries, error handling, testing guidelines, and the mandatory introduction of ESLint/Prettier.

Hono DDD Guidelines

目的

HonoでDDD構成のバックエンドを設計/実装/リファクタリングする手順と判断基準を提供する
レイヤー責務と依存方向を明確化する
Honoの公式ミドルウェア/プラグインを優先した構成を徹底する
OpenAPIは hono-openapi + zod-openapi を必須とし、スキーマ駆動で設計する
Drizzle ORMを前提にセッション/トランザクション境界を標準化する
テストはHono公式ガイドに準拠し、app.request() をベースに設計する
ESLint/Prettier を必須とし、型安全性とフォーマットの自動化を前提にする

使い方

依頼内容が「新規実装」か「リファクタリング」かを明確化する
必要に応じて references/ を読む（下記参照）
レイヤー構成・依存方向・責務の合意を作成する
具体的なディレクトリ構成・実装方針・コード例を示す

参照ファイル

レイヤー責務と依存方向のルール: references/layers.md
Drizzleのトランザクション/UoW/DI: references/transactions-uow.md
OpenAPI/Zodプラグイン運用: references/openapi.md
テスト指針: references/testing.md
実装テンプレ/ディレクトリ構成例: references/templates.md

実行ガイド

まず references/layers.md を読み、責務/依存方向/配置ルールを回答の土台にする
トランザクションやDIが必要なら references/transactions-uow.md を読む
OpenAPIやバリデーション設計が必要なら references/openapi.md を読む
テスト方針が必要なら references/testing.md を読む
新規実装やリファクタリングで具体的な構成が必要なら references/templates.md を読む
出力は日本語、簡潔かつ具体的に