design-policy

設計方針作成コマンド

概要

アーキテクチャ設計、技術選定、設計判断を支援するコマンドです。

使用方法

/design-policy [要件概要]

例:

/design-policy ユーザー認証機能の追加
/design-policy リアルタイム通知システム

実行内容

あなたはソフトウェアアーキテクトです。以下の観点から設計方針を策定してください：

1. アーキテクチャ設計

システム構成図

graph TD
    Client[クライアント] --> API[Next.js API Routes]
    API --> Auth[認証サービス]
    API --> BL[ビジネスロジック]
    BL --> DB[(SQLite)]
    BL --> Cache[(キャッシュ)]
    BL --> Queue[非同期処理]

レイヤー構成

• プレゼンテーション層（src/app/）
• ビジネスロジック層（src/lib/）
• データアクセス層（src/lib/db.ts）
• インフラストラクチャ層

2. 技術選定

カテゴリ	選定技術	選定理由
言語/フレームワーク	TypeScript/Next.js 14	既存技術スタック
データベース	SQLite	軽量、ファイルベース
スタイル	Tailwind CSS	既存技術スタック
テスト	Vitest/Playwright	高速、型安全
監視/ログ	console/file	シンプル運用

3. 設計パターン

適用する設計パターンと理由：

Repository パターン

データアクセスを抽象化し、ビジネスロジックとデータ永続化を分離

// src/lib/repositories/worktree-repository.ts
export interface WorktreeRepository {
  findAll(): Promise<Worktree[]>
  findById(id: string): Promise<Worktree | null>
  create(data: CreateWorktreeInput): Promise<Worktree>
  update(id: string, data: UpdateWorktreeInput): Promise<Worktree>
  delete(id: string): Promise<void>
}

Factory パターン

複雑なオブジェクト生成を集約

Service パターン

ビジネスロジックをサービスクラスに集約

4. データモデル設計

ER図

erDiagram
    WORKTREE ||--o{ SESSION : has
    WORKTREE ||--o{ MESSAGE : contains
    SESSION ||--o{ MESSAGE : generates
    WORKTREE {
        string id PK
        string name
        string path
        string branch
        datetime created_at
    }
    SESSION {
        string id PK
        string worktree_id FK
        string status
        datetime started_at
        datetime ended_at
    }
    MESSAGE {
        string id PK
        string worktree_id FK
        string session_id FK
        string role
        text content
        datetime created_at
    }

主要テーブル設計

• テーブル名、カラム、インデックス

5. API設計

RESTful API

GET    /api/worktrees          - 一覧取得
GET    /api/worktrees/:id      - 詳細取得
POST   /api/worktrees          - 新規作成
PUT    /api/worktrees/:id      - 更新
DELETE /api/worktrees/:id      - 削除