---
name: create-service
description: Create a shared service and DTO specification document for the project.
argument-hint: "Service name (e.g., auth-service)"
---

# Create Service Document

共通サービス（Shared Services）の責務とインターフェース、およびそこでのデータ受け渡しに使用される DTO (Data Transfer Object) の定義を含む仕様書を作成します。文書は `docs/services/<service-name>.md` に保存してください。文書には以下の内容を必ず含めてください。

## Table of Contents

-   **サービス概要**: サービスの役割、公開インターフェースとしての責務。
-   **インターフェース定義**: メソッドシグネチャ、引数、戻り値、例外処理、および処理フローの概要。
-   **DTO定義**:
    -   `Controller <- DTO <- Service` レイヤー間の受け渡しで使用するDTOのデータ構造定義。
    -   DTOの各フィールドの物理名、論理名、データ型、およびバリデーションルール（必須、桁数、フォーマット等）。

## Related Documents

-   INPUTS: ARCHITECTURE.md, models/<table-name>.md
-   OUTPUTS: specs/<ID>.md (画面仕様等の上位コンポーネント)
