hono-ddd-guidelines

DDDアーキテクチャでHonoのバックエンドを新規実装または既存コードベースをリファクタリングする際のガイド。レイヤー構成(domain/application/infrastructure/controller)、依存方向、責務境界、Hono公式ミドルウェア/プラグインの活用、Hono OpenAPIプラグイン(hono-openapi)とzod-openapiの必須採用、Drizzle ORMの利用、トランザクション境界、エラーハンドリング、テスト指針、ESLint/Prettierの必須導入を含む。

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026

When & Why to Use This Skill

This Claude skill provides a comprehensive framework for building and refactoring Hono-based backends using Domain-Driven Design (DDD) principles. It offers structured guidance on layer separation, dependency management, and the integration of essential tools like hono-openapi, Drizzle ORM, and Zod for robust, type-safe API development.

Use Cases

  • Architecting new backend systems with Hono using a clean, layered DDD structure (Domain, Application, Infrastructure, Controller).
  • Refactoring legacy Hono applications to improve maintainability and decouple business logic from infrastructure.
  • Implementing schema-first API development by integrating hono-openapi and zod-openapi for automated documentation and validation.
  • Standardizing database access and transaction boundaries using Drizzle ORM within a Unit of Work pattern.
  • Setting up a professional development environment with integrated testing strategies, ESLint, and Prettier for Hono projects.
namehono-ddd-guidelines
descriptionDDDアーキテクチャでHonoのバックエンドを新規実装または既存コードベースをリファクタリングする際のガイド。レイヤー構成(domain/application/infrastructure/controller)、依存方向、責務境界、Hono公式ミドルウェア/プラグインの活用、Hono OpenAPIプラグイン(hono-openapi)とzod-openapiの必須採用、Drizzle ORMの利用、トランザクション境界、エラーハンドリング、テスト指針、ESLint/Prettierの必須導入を含む。

Hono DDD Guidelines

目的

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

使い方

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

参照ファイル

  • レイヤー責務と依存方向のルール: 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 を読む
  • 出力は日本語、簡潔かつ具体的に