ワークフローを更新した

Author: KaiShoya

.agent/README.md

@@ -13,19 +13,19 @@
 ├── specs/               # 仕様・設計の確定版（ソース・オブ・トゥルース）
 │   └── ci-and-dependencies.md  # CI・パッケージ管理に関する運用ルール
 ├── docs/
-│   ├── QA_AND_DECISIONS.md  # Q&A と設計決定ログ
+│   ├── qa.md                # Q&A と設計決定ログ
 │   ├── tasks.md             # リリース時のみ更新する統一インデックス
 │   ├── backlog-tasks.md     # バージョン未決定タスク & ロードマップ
 │   ├── tasks/               # マイナーバージョン別タスク（開発中に随時更新）
 │   ├── qa/                  # 開発中のQ&A / 決定事項（バージョン別）
 │   ├── qa-archive/          # 完了・アーカイブ済みのQ&A（参照用）
 │   └── task-archive/        # 完了済みバージョンの保管
-└── README.md            # この説明書
+└── README.md                # この説明書
 ```
 
 ## クイックスタート
 1. 仕様・設計を追加/変更する場合は `.agent/specs/` を編集。
-2. Q&A や設計決定は `.agent/docs/QA_AND_DECISIONS.md` に記録。
+2. Q&A や設計決定は `.agent/docs/qa.md` に記録。
 3. 開発タスクは `.agent/docs/tasks/vX.Y-tasks.md` で管理（X.Y はマイナーバージョン）。
 4. バージョン未決定のタスクは `.agent/docs/backlog-tasks.md` に記載。
 5. コード修正・追加・削除時は、関連する specs/docs を同一 PR で同期更新。
@@ -39,13 +39,13 @@
 
 ## PR チェックリスト
 - 仕様変更は `.agent/specs/` へ反映済みか。
-- Q&A や決定事項は `.agent/docs/QA_AND_DECISIONS.md` に記録済みか。
+- Q&A や決定事項は `.agent/docs/qa.md` に記録済みか。
 - タスクに Issue/PR/Commit のリンクを記載したか。
 - PR 本文に「ドキュメント更新」セクションを含めたか。
 
 ## 強制ルール（自動化）
 - **ルール**: コードの変更は必ず関連する `specs` / `docs` / `tasks` を同一 PR で更新すること。
-- もし更新できない場合は、PR に `spec-exception` ラベルを付け、`.agent/docs/QA_AND_DECISIONS.md` に理由と次のアクションを記載すること。
+- もし更新できない場合は、PR に `spec-exception` ラベルを付け、`.agent/docs/qa.md` に理由と次のアクションを記載すること。
 - CI ワークフローにより PR がコード変更を含むと自動検出された場合、対応する `specs`/`docs` の差分がなければ CI が失敗（または警告）します。
 
 ### アーカイブ注意事項

.agent/docs/pr_description_v0.1.4.md

@@ -8,7 +8,7 @@
 .agent/
   ├── specs/                  # 仕様・設計の単一ソース（SoT）
   ├── docs/
-  │   ├── qa-index.md         # QA インデックス（リリース時に更新）
+  │   ├── qa.md               # QA インデックス（リリース時に更新）
   │   ├── tasks.md            # タスクリストインデックス（リリース時に更新）
   │   ├── qa/                 # バージョン別 QA
   │   ├── tasks/              # バージョン別タスクリスト
@@ -35,7 +35,7 @@
 
 このディレクトリで管理するドキュメント：
 
-#### **QA_AND_DECISIONS.md** - Q&A と設計決定ログ
+#### **qa.md** - Q&A と設計決定ログ
 - 形式: `## [カテゴリ] 質問タイトル`
   - カテゴリ例: `[API]`, `[UI]`, `[アーキテクチャ]`, `[テスト]`, `[データベース]` など
 - 推奨フォーマット:
@@ -51,15 +51,14 @@
   ```
 - 目的: 設計決定とアーキテクチャの議論を記録し、将来の参照用として保管
 
-**QA ファイル分割ルール（v1.20 より採用）**:
+**QA ファイル分割ルール**:
 
 QA リストはコンフリクト防止のため、バージョン毎に分割。tasks.md と同じ構造を採用。
 
 **ディレクトリ構成**:
 ```
 .agent/docs/
-├── qa-index.md              ← インデックス（tasks.md 相当）
-├── QA_AND_DECISIONS.md      ← レガシー（v1.19 以前用）
+├── qa.md              ← インデックス（tasks.md 相当）
 └── qa/
     ├── v1.20-qa.md          ← v1.20 開発中の Q&A・決定
     ├── v1.21-qa.md          ← v1.21 の Q&A（予定）
@@ -191,134 +190,6 @@ feat: 日付範囲によるドリンクフィルタリングを追加
 
 ## 🏗️ 実装ガイドライン
 
-### Store 実装パターン
-
-**責務分離**: Data Stores と Page Stores を厳格に分離
-
-#### Data Stores（`store/data/`）
-```ts
-// 単純な CRUD + リポジトリ呼び出し
-const fetchDrinks = async () => {
-  try {
-    drinks.value = await $drinksRepository.fetchAll()
-  } catch (error) {
-    // 単に再スロー（トーストなし）
-    throw error
-  }
-}
-
-// 状態は readonly で公開
-return {
-  drinks: readonly(drinks),
-  fetchDrinks,
-}
-```
-
-**ルール**:
-- ✅ リポジトリを直接呼び出し
-- ✅ エラーはそのまま再スロー
-- ✅ トーストメッセージは表示しない
-- ✅ 状態は `readonly()` で公開
-- ❌ 複数ストアの組み合わせなし
-- ❌ ビジネスロジック・集約なし
-
-#### Page Stores（`store/pages/`）
-```ts
-// 複数の data store + エラー処理 + トースト表示
-const fetchData = async () => {
-  try {
-    showLoading()
-    await drinksStore.fetchDrinks()
-    // データ集約・変換処理
-  } catch (error) {
-    if (error instanceof CustomError) {
-      showDangerToast(error.getMessage())
-    }
-    logger.error('Failed to fetch', { module: 'indexStore' }, error)
-  } finally {
-    hideLoading()
-  }
-}
-```
-
-**ルール**:
-- ✅ 複数のデータストアを組み合わせ
-- ✅ エラーをキャッチしてトーストを表示
-- ✅ 集約・変換ロジックを実装
-- ✅ ログレコーディングを実施
-- ✅ ローディング状態を管理
-- ❌ リポジトリの直接呼び出しなし
-- ❌ エラー処理なしの再スロー
-
-### エラーハンドリング階層図
-
-```
-Component
-    ↓ (store action 呼び出し)
-Page Store ← トーストを表示、ログ記録
-    ↓ (data store 呼び出し)
-Data Store ← 単に再スロー
-    ↓ (repository 呼び出し)
-Repository ← CustomError をスロー
-    ↓
-Cloudflare API
-```
-
-**各層の責務**:
-
-1. **Repository** (`app/utils/api/`)
-   - Cloudflare API エラーをキャッチ
-   - `CustomError` に変換してスロー
-   - メッセージは実装者向け（英語）
-
-2. **Data Store** (`store/data/`)
-   - エラーを単に再スロー
-   - 処理なし（Page Store に任せる）
-
-3. **Page Store** (`store/pages/`)
-   - エラーをキャッチ
-   - `showDangerToast()` でユーザーに通知
-   - `logger.error()` でログ記録
-   - 必要に応じて UI 状態をリセット
-
-4. **Component** (`app/components/`)
-   - Page Store action を呼び出し
-   - ストア経由でユーザーに通知
-   - 直接的なエラー処理は不要
-
-**トースト種類**:
-```ts
-showSuccessToast('操作が成功しました')        // 緑
-showInfoToast('確認メッセージです')           // 青
-showWarningToast('注意が必要です')            // 黄
-showDangerToast('エラーが発生しました')       // 赤
-```
-
-**例**: 飲み物削除
-```ts
-// Page Store: deleteAction
-const deleteDrink = async (id: number, name: string) => {
-  try {
-    showLoading()
-    await drinksStore.deleteDrink(id)
-    showSuccessToast(
-      t(LOCALE_DRINKS_DELETE_SUCCESS, { name })
-    )
-    await fetchDrinks()  // リロード
-  } catch (error) {
-    if (error instanceof CustomError) {
-      showDangerToast(error.getMessage())
-    }
-    logger.error('Failed to delete drink', 
-      { module: 'drinksStore', drinkId: id }, 
-      error
-    )
-  } finally {
-    hideLoading()
-  }
-}
-```
-
 ### PR レビューチェックリスト
 
 PR を作成またはレビューする際は、以下を確認してください:
@@ -388,7 +259,6 @@ PR を作成またはレビューする際は、以下を確認してくださ
 - ❌ 実装なしで仕様を作成する
 - ❌ 複数のファイルに情報を重複させる
 - ❌ GitHub Issues へのリンクを忘れる
-- ❌ 解決済みの質問を `.agent/docs/` に無期限に残す
 
 ---