@einja/dev-cli 0.1.6

package/templates/design.md.template

@@ -0,0 +1,327 @@
+# [機能名] 設計書
+
+<!-- このテンプレートは新規タスクの設計書作成時に使用してください -->
+
+## システムアーキテクチャ
+
+### システム構成図
+
+```mermaid
+graph TD
+    A[コンポーネントA] --> B[コンポーネントB]
+    B --> C[コンポーネントC]
+```
+
+### データフロー
+
+```mermaid
+sequenceDiagram
+    participant Client
+    participant Server
+    participant Database
+
+    Client->>Server: リクエスト
+    Server->>Database: データ取得
+    Database->>Server: データ返却
+    Server->>Client: レスポンス
+```
+
+## データモデル
+
+### ERD（Entity Relationship Diagram）
+
+```mermaid
+erDiagram
+    USER ||--o{ ORDER : places
+    USER {
+        string id PK
+        string name
+        string email
+    }
+    ORDER {
+        string id PK
+        string userId FK
+        datetime createdAt
+    }
+```
+
+### Prismaスキーマ
+
+```prisma
+// 主要なデータモデルを記載
+
+model User {
+  id        String   @id @default(cuid())
+  name      String
+  email     String   @unique
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+```
+
+## API仕様
+
+### エンドポイント一覧
+
+| メソッド | エンドポイント | 説明 | 認証 |
+|---------|--------------|------|------|
+| POST | /api/resource | リソース作成 | 必要 |
+| GET | /api/resource/:id | リソース取得 | 必要 |
+| PUT | /api/resource/:id | リソース更新 | 必要 |
+| DELETE | /api/resource/:id | リソース削除 | 必要 |
+
+### API詳細
+
+#### POST /api/resource
+
+**リクエスト**:
+```typescript
+{
+  "field1": "value1",
+  "field2": "value2"
+}
+```
+
+**レスポンス（成功時）**:
+```typescript
+{
+  "success": true,
+  "data": {
+    "id": "resource_id",
+    "field1": "value1",
+    "field2": "value2",
+    "createdAt": "2024-01-01T00:00:00Z"
+  }
+}
+```
+
+**レスポンス（エラー時）**:
+```typescript
+{
+  "success": false,
+  "error": {
+    "code": "ERROR_CODE",
+    "message": "エラーメッセージ"
+  }
+}
+```
+
+### エラーハンドリング
+
+| HTTPステータス | エラーコード | 説明 | 対処方法 |
+|--------------|------------|------|---------|
+| 400 | INVALID_REQUEST | リクエストが不正 | リクエストパラメータを確認 |
+| 401 | UNAUTHORIZED | 認証エラー | 認証情報を確認 |
+| 403 | FORBIDDEN | アクセス権限なし | 権限を確認 |
+| 404 | NOT_FOUND | リソースが見つからない | リソースの存在を確認 |
+| 429 | RATE_LIMIT_EXCEEDED | レート制限超過 | 時間を置いて再試行 |
+| 500 | INTERNAL_ERROR | サーバーエラー | サポートに連絡 |
+
+## フロントエンドコンポーネント構造
+
+### コンポーネント階層
+
+```
+Page
+├── Layout
+│   ├── Header
+│   ├── Sidebar
+│   └── Footer
+└── Content
+    ├── ComponentA
+    ├── ComponentB
+    └── ComponentC
+```
+
+### 主要コンポーネント仕様
+
+#### ComponentA
+
+**目的**: <!-- コンポーネントの目的を記載 -->
+
+**Props**:
+```typescript
+interface ComponentAProps {
+  prop1: string;
+  prop2: number;
+  onAction?: () => void;
+}
+```
+
+**状態管理**:
+- useState: ローカル状態
+- useContext: グローバル状態（該当する場合）
+
+**主要な振る舞い**:
+1. 振る舞い1の説明
+2. 振る舞い2の説明
+
+### 状態管理戦略
+
+**使用ライブラリ**: <!-- Zustand / React Context / その他 -->
+
+**状態の種類**:
+- ローカル状態: コンポーネント内で完結する状態
+- 共有状態: 複数コンポーネント間で共有する状態
+- サーバー状態: APIから取得するデータ
+
+## 技術選定
+
+### 使用技術スタック
+
+| カテゴリ | 技術 | バージョン | 選定理由 |
+|---------|-----|-----------|---------|
+| フレームワーク | Next.js | 15.x | App Routerの活用、パフォーマンス |
+| データベース | PostgreSQL | 16.x | リレーショナルデータモデルに適合 |
+| ORM | Prisma | 5.x | 型安全性、開発効率 |
+| 認証 | NextAuth.js | 5.x | 既存システムとの統合 |
+| UI | Panda CSS + shadcn/ui | latest | デザインシステムとの統合 |
+
+### ライブラリ選定
+
+#### [ライブラリ名]
+
+**用途**: <!-- ライブラリの用途を記載 -->
+
+**選定理由**:
+- 理由1
+- 理由2
+
+**代替案との比較**:
+- 代替案A: <!-- 採用しなかった理由 -->
+- 代替案B: <!-- 採用しなかった理由 -->
+
+## セキュリティ考慮事項
+
+### 認証・認可
+
+**認証方式**: <!-- JWT / Session / その他 -->
+
+**認可モデル**: <!-- RBAC / ABAC / その他 -->
+
+**実装方針**:
+- 認証フロー: <!-- 認証フローを記載 -->
+- トークン管理: <!-- トークン管理方法を記載 -->
+- セッション管理: <!-- セッション管理方法を記載 -->
+
+### データ保護
+
+**暗号化**:
+- 通信: TLS 1.3
+- 保存データ: <!-- 暗号化方法を記載 -->
+- パスワード: bcrypt（コスト係数: 12）
+
+**入力検証**:
+- クライアントサイド: <!-- 検証方法を記載 -->
+- サーバーサイド: <!-- 検証方法を記載 -->
+
+### 脆弱性対策
+
+| 脆弱性 | 対策 |
+|--------|------|
+| XSS | エスケープ処理、Content Security Policy |
+| CSRF | トークン検証 |
+| SQLインジェクション | Prismaによるパラメータ化クエリ |
+| 機密情報漏洩 | 環境変数による管理 |
+
+## パフォーマンス考慮事項
+
+### パフォーマンス目標
+
+| 指標 | 目標値 | 測定方法 |
+|------|--------|---------|
+| First Contentful Paint | < 1.8秒 | Lighthouse |
+| Time to Interactive | < 3.8秒 | Lighthouse |
+| API レスポンス | < 200ms | サーバーログ |
+| データベースクエリ | < 100ms | Prisma logs |
+
+### 最適化戦略
+
+**フロントエンド**:
+- React.memo / useMemo / useCallback による再レンダリング最適化
+- 画像最適化（Next.js Image コンポーネント）
+- コード分割（動的インポート）
+- キャッシング戦略
+
+**バックエンド**:
+- データベースインデックスの最適化
+- N+1問題の回避（Prisma include/select）
+- レスポンスキャッシング
+- CDN活用
+
+### データベース設計
+
+**インデックス設計**:
+```sql
+-- 主要なインデックスを記載
+CREATE INDEX idx_user_email ON User(email);
+CREATE INDEX idx_order_userId ON Order(userId);
+```
+
+**クエリ最適化**:
+- よく使われるクエリパターンを記載
+- パフォーマンスボトルネックへの対策
+
+## テスト戦略
+
+### テストレベル
+
+| レベル | 対象 | ツール | カバレッジ目標 |
+|--------|------|--------|--------------|
+| Unit | ロジック、ユーティリティ | Vitest | 80%以上 |
+| Integration | API、データベース | Vitest | 70%以上 |
+| E2E | ユーザーシナリオ | Playwright | クリティカルパス |
+
+### テストケース設計
+
+**単体テスト**:
+- 正常系
+- 異常系
+- 境界値
+
+**統合テスト**:
+- APIエンドポイント
+- データベース操作
+- 認証・認可
+
+**E2Eテスト**:
+- クリティカルパス（requirements.mdの受け入れ基準に基づく）
+- ユーザーシナリオ
+
+## マイグレーション戦略（該当する場合）
+
+### データ移行
+
+**移行対象**:
+<!-- 移行するデータを記載 -->
+
+**移行手順**:
+1. 手順1
+2. 手順2
+3. 手順3
+
+**ロールバック手順**:
+<!-- ロールバック方法を記載 -->
+
+### デプロイ戦略
+
+**デプロイフロー**:
+1. ステージング環境でのテスト
+2. データベースマイグレーション
+3. アプリケーションデプロイ
+4. 動作確認
+
+**モニタリング**:
+- エラーログ監視
+- パフォーマンスメトリクス
+- ユーザー行動分析
+
+## 参考資料
+
+### 関連ドキュメント
+- 要件定義書: `requirements.md`
+- QAテスト: `qa-tests/`
+
+### 外部リソース
+- [参考ドキュメント1のタイトル](URL)
+- [参考ドキュメント2のタイトル](URL)

package/templates/qa-test.md.template

@@ -0,0 +1,125 @@
+# Phase X-Y: [タスクグループ名] QAテスト結果
+
+## テスト対象タスク
+- **タスクID**: X.Y.1〜X.Y.N
+- **タスク名**: [タスクグループ名]
+- **実装日**: YYYY-MM-DD
+- **テスター**: task-qa
+- **最終更新**: YYYY-MM-DD HH:MM
+
+## テストサマリー
+| ステータス | 件数 |
+|----------|-----|
+| ✅ PASS | 0 |
+| ❌ FAIL | 0 |
+| ⚠️ PARTIAL | 0 |
+
+---
+
+## 必須自動テスト結果
+
+### 実行コマンド
+```bash
+# 1. ユニットテスト
+pnpm test
+
+# 2. E2Eテスト（Playwrightコードによる自動テスト）
+pnpm test:e2e
+
+# 3. Lintチェック
+pnpm lint
+
+# 4. ビルドチェック
+pnpm build
+
+# 5. 型チェック（TypeScript）
+pnpm typecheck
+```
+
+> **Note**: E2Eテストは `pnpm test:e2e` で実行されるPlaywrightコードテストを指します。
+> Playwright MCPを使用したブラウザテスト（Browser検証レベル）は、下記「タスク X.Y.N」セクションのテストシナリオで実施します。
+> 詳細は `docs/einja/steering/terminology.md` を参照してください。
+
+### 結果
+| テスト項目 | ステータス | 備考 |
+|----------|----------|------|
+| ユニットテスト | - | - |
+| E2Eテスト | - | - |
+| Lintチェック | - | - |
+| ビルドチェック | - | - |
+| 型チェック | - | - |
+
+**重要**: 上記のいずれか1つでも失敗した場合、全体ステータスは**❌ FAIL**となります。
+
+---
+
+## タスク X.Y.1: [タスク名]
+
+### 受け入れ条件（requirements.md から抽出）
+- AC1.1: Given [前提条件] When [操作] Then [期待結果]
+- AC1.2: Given [前提条件] When [操作] Then [期待結果]
+
+### テストシナリオ
+
+| No | 手順 | 確認項目 | 期待値 | 結果 | 備考 |
+|----|------|---------|--------|------|------|
+| 1 | [操作内容] | [確認する項目] | [期待される結果] | - | - |
+| 2 | [操作内容] | [確認する項目] | [期待される結果] | - | - |
+
+**重要**:
+- 手順は自然言語で簡潔に記述（例: 「ログイン画面に移動」「メールアドレス入力: test@example.com」）
+- 「-」は手順のみで確認項目がない場合に使用
+- 備考欄はテストの区切りや注意事項を記載
+
+### 全体ステータス: - （未実施）
+
+#### 主な問題点
+- （実施後に記載）
+
+#### 対応策
+- （実施後に記載）
+
+#### エビデンス
+- ログファイル: `qa-tests/phaseX/evidence/X-Y-1-*.log`
+- スクリーンショット: `qa-tests/phaseX/evidence/X-Y-1-*.png`
+
+---
+
+## 統合テスト結果サマリー
+
+### フェーズ X-Y 全体結果
+- **全体ステータス**: - （未実施）
+- **完了タスク**: 0/N
+- **テスト合格率**: 0% (0/0)
+
+### 修正が必要な項目
+- （実施後に記載）
+
+### 次フェーズへの引き継ぎ事項
+- （実施後に記載）
+
+### 改善提案
+- （実施後に記載）
+
+---
+
+## 報告と対応
+
+### 失敗原因分類
+<!-- 該当する分類にチェック -->
+- [ ] **A: 実装ミス** → task-executerへ差し戻し
+- [ ] **B: 要件齟齬** → requirements.md修正 → task-executerへ差し戻し
+- [ ] **C: 設計不備** → design.md修正 → task-executerへ差し戻し
+- [ ] **D: 環境問題** → qa再実行
+
+### task-executerへの差し戻し（該当する場合）
+以下の項目について修正が必要:
+- （実施後に記載）
+
+### 修正優先度
+- **即座対応**: （実施後に記載）
+- **1週間以内**: （実施後に記載）
+- **2週間以内**: （実施後に記載）
+
+### 回避策（該当する場合）
+- （実施後に記載）

package/templates/requirements.md.template

@@ -0,0 +1,254 @@
+# [機能名] 要件定義書
+
+<!-- このテンプレートは新規タスクの要件定義書作成時に使用してください -->
+<!-- QAエージェント（task-qa）は「受け入れ基準（Acceptance Criteria）」セクションを参照してテストシナリオを作成します -->
+
+## 概要
+<!-- 1-2段落で機能の概要を説明 -->
+<!-- 例: パスワードレス認証を実現するマジックリンク機能を実装し、ユーザーのログイン体験を向上させます。 -->
+
+## AS-IS（現状）
+
+### 現在の実装状況
+<!-- 現在の実装状況を記載 -->
+
+### 現状の課題
+<!-- 現在抱えている問題点や課題を記載 -->
+
+## TO-BE（目標状態）
+
+### 実現したい姿
+<!-- この機能で実現したい理想的な状態を記載 -->
+
+### 期待される改善
+<!-- 具体的な改善効果を記載（できれば数値目標） -->
+
+## ビジネス価値
+- **問題**: <!-- 解決すべき問題を記載 -->
+- **解決策**: <!-- その問題に対する解決策を記載 -->
+- **期待効果**: <!-- 期待される効果を記載 -->
+
+## スコープ
+### 含まれるもの
+<!-- このタスクで実装する機能のリスト -->
+- 機能A
+- 機能B
+- 機能C
+
+### 含まれないもの
+<!-- 明示的に対象外とする機能のリスト -->
+- 機能X
+- 機能Y
+
+## 画面要件（該当する場合）
+
+### 画面一覧と目的
+
+#### 1. [画面名]
+**目的**: <!-- この画面の目的を記載 -->
+
+**主要UI要素**:
+- UI要素1
+- UI要素2
+
+**表示条件**:
+<!-- この画面が表示される条件を記載 -->
+
+### 画面遷移フロー（必要に応じてMermaid図を使用）
+
+```mermaid
+graph TD
+    A[画面A] -->|操作| B[画面B]
+    B -->|操作| C[画面C]
+```
+
+### UIインタラクション要件
+
+#### フォーム入力とバリデーション
+**要件**:
+<!-- フォームの動作要件を記載 -->
+
+**バリデーションルール**:
+<!-- バリデーションルールを記載 -->
+
+#### ボタン操作
+**要件**:
+<!-- ボタンの動作要件を記載 -->
+
+#### ローディング状態
+**要件**:
+<!-- ローディング状態の動作要件を記載 -->
+
+#### エラーメッセージ表示
+**要件**:
+<!-- エラーメッセージの表示要件を記載 -->
+
+#### 成功フィードバック
+**要件**:
+<!-- 成功フィードバックの表示要件を記載 -->
+
+## ユーザーストーリー
+
+### Story 1: [ストーリー名]
+**As a** [ユーザー種別]
+**I want to** [実現したいこと]
+**So that** [ビジネス価値]
+
+#### AC（受け入れ基準）の書き方
+
+**AC番号体系**:
+- AC1.1, AC1.2, ... : Story 1 の受け入れ基準
+- AC2.1, AC2.2, ... : Story 2 の受け入れ基準
+- ストーリー番号.連番 の形式で一意に識別
+
+**検証レベル**:
+- **Unit**: 単体テスト（task-executer が実装・実行）
+  - 例: バリデーション関数、ユーティリティ関数
+- **Integration**: 統合テスト（task-qa が実行）
+  - 例: APIエンドポイント、データベース連携
+- **E2E**: Playwrightコードによる自動テスト（CI/開発者 が実行）
+  - 例: `pnpm test:e2e` で実行されるリグレッションテスト
+- **Browser**: Playwright MCPによるブラウザテスト（task-qa が実行）
+  - 例: 画面フロー、UIインタラクション確認
+
+**検証者**:
+- **task-executer**: 実装フェーズで Unit テストを作成・実行
+- **CI/開発者**: E2E テスト（`pnpm test:e2e`）を実行
+- **task-qa**: QA フェーズで Integration/Browser テストを実行
+
+詳細は `docs/einja/steering/terminology.md` および `docs/einja/steering/acceptance-criteria-and-qa-guide.md` を参照してください。
+
+#### 受け入れ基準
+
+<!-- ⚠️ 必須セクション: QAエージェント（task-qa）はこのセクションを参照してテストシナリオを作成します -->
+<!-- AC（Acceptance Criteria）は AC番号、検証レベル、Given/When/Then を必ず含めてください -->
+
+##### 機能要件
+<!-- Given/When/Then形式で記載 -->
+<!-- 振る舞い・入力・観測可能な結果をセットで書く -->
+<!-- ビジネス価値やユーザー影響が分かる文脈を添える -->
+<!-- 正常系に加え、代表的な異常・境界ケースを列挙する -->
+<!-- 観測手段（API レスポンス、イベント、DB 状態など）を明示する -->
+
+- [ ] **AC1.1** [検証レベル: Unit] [検証者: task-executer]
+      Given: [前提条件]
+      When: [実行する操作]
+      Then: [期待される結果]
+
+- [ ] **AC1.2** [検証レベル: Integration] [検証者: task-qa]
+      Given: [前提条件]
+      When: [実行する操作]
+      Then: [期待される結果]
+
+- [ ] **AC1.3** [検証レベル: E2E] [検証者: task-qa]
+      Given: [前提条件（異常系または境界ケース）]
+      When: [実行する操作]
+      Then: [期待される結果]
+
+##### UIインタラクション要件
+<!-- 画面操作に関する受け入れ基準（該当する場合） -->
+<!-- Browser検証レベルはPlaywright MCPによるブラウザテストで確認します -->
+
+- [ ] **AC1.4** [検証レベル: Browser] [検証者: task-qa]
+      Given: [前提条件（画面が表示されている状態）]
+      When: [ユーザー操作]
+      Then: [期待される画面の振る舞い]
+
+- [ ] **AC1.5** [検証レベル: Browser] [検証者: task-qa]
+      Given: [前提条件]
+      When: [ユーザー操作]
+      Then: [期待される画面の振る舞い]
+
+#### 実装の優先順位
+<!-- P0 (必須) / P1 (重要) / P2 (推奨) のいずれかを選択 -->
+P0 (必須)
+
+---
+
+### Story 2: [ストーリー名]
+**As a** [ユーザー種別]
+**I want to** [実現したいこと]
+**So that** [ビジネス価値]
+
+#### 受け入れ基準
+
+<!-- ⚠️ 必須セクション: QAエージェント（task-qa）はこのセクションを参照してテストシナリオを作成します -->
+<!-- AC（Acceptance Criteria）は AC番号、検証レベル、Given/When/Then を必ず含めてください -->
+
+##### 機能要件
+
+- [ ] **AC2.1** [検証レベル: Unit] [検証者: task-executer]
+      Given: [前提条件]
+      When: [実行する操作]
+      Then: [期待される結果]
+
+- [ ] **AC2.2** [検証レベル: Integration] [検証者: task-qa]
+      Given: [前提条件]
+      When: [実行する操作]
+      Then: [期待される結果]
+
+##### UIインタラクション要件
+<!-- 画面操作に関する受け入れ基準（該当する場合） -->
+<!-- Browser検証レベルはPlaywright MCPによるブラウザテストで確認します -->
+
+- [ ] **AC2.3** [検証レベル: Browser] [検証者: task-qa]
+      Given: [前提条件]
+      When: [ユーザー操作]
+      Then: [期待される画面の振る舞い]
+
+#### 実装の優先順位
+P0 (必須) / P1 (重要) / P2 (推奨)
+
+---
+
+## 詳細なビジネス要件（該当する場合）
+
+### [要件カテゴリ名]
+#### [要件サブカテゴリ名]
+**要件内容**:
+<!-- 要件の詳細を記載 -->
+
+**OK例**:
+<!-- 正しい実装例を記載 -->
+
+**NG例**:
+<!-- 誤った実装例を記載 -->
+
+## 非機能要件
+
+### パフォーマンス
+<!-- パフォーマンス要件を記載 -->
+- 処理A: XXms以内
+- 処理B: YY秒以内
+
+### セキュリティ
+<!-- セキュリティ要件を記載 -->
+
+### 可用性
+<!-- 可用性要件を記載 -->
+
+### アクセシビリティ
+<!-- アクセシビリティ要件を記載（該当する場合） -->
+
+## 技術的制約
+<!-- 技術的制約を記載 -->
+
+## 依存関係
+<!-- 外部サービスやライブラリへの依存関係を記載 -->
+
+## リスクと対策
+| リスク | 影響度 | 発生確率 | 対策 |
+|--------|--------|----------|------|
+| リスク1 | 高/中/低 | 高/中/低 | 対策内容 |
+| リスク2 | 高/中/低 | 高/中/低 | 対策内容 |
+
+## 成功指標
+<!-- 機能の成功を測定する指標を記載 -->
+- 指標1: 目標値
+- 指標2: 目標値
+
+## タイムライン
+<!-- 実装フェーズを記載（該当する場合） -->
+- Phase 1: 基本機能（Story 1, 2）
+- Phase 2: 高度な機能（Story 3）
+- Phase 3: 分析とモニタリング機能