@k2works/claude-code-booster 0.1.0

package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md

@@ -0,0 +1,556 @@
+# 開発ガイド
+
+## 開発ライフサイクル
+
+分析では、アプリケーションの機能や性能、品質、セキュリティ、運用、保守などの要件をまとめる活動を行います。
+開発では要件を満たすための設計、実装、テストなどの活動を行います。
+運用では、アプリケーションの運用、保守、改善などの活動を行います。
+構築では、アプリケーションの環境設定を行います。
+配置では、アプリケーションのビルドとデプロイを行います。
+これらの活動は相互に影響し合い、連携して行われるため、それぞれの活動において、開発者が守るべき規則やガイドラインをまとめたドキュメントを参照してください。
+
+```plantuml
+@startuml
+[*] --> 分析
+分析 --> 開発
+分析 -right-> 運用
+運用 -left-> 分析
+開発 -left-> 分析
+開発 --> 運用
+運用 --> 開発
+運用 --> 配置
+運用 -up-> 構築
+構築 --> 配置
+運用 ---> [*]
+
+state 分析 #yellow
+state 構築 #limegreen
+state 運用 #orange
+state 開発 #red
+state 配置 #lightblue
+@enduml
+```
+
+アプリケーション開発は、アジャイル開発手法（XP）に基づいて進めます。
+
+詳細は [エクストリームプログラミング](エクストリームプログラミング) を参照。
+
+## 分析
+
+```plantuml
+@startuml "Phase 1"
+|要件定義|
+start
+:要件定義;
+:ユーザーストーリー;
+:ユースケース;
+
+|機能要件|
+:アーキテクチャ設計;
+:データモデル設計;
+:ドメインモデル設計;
+:UI設計;
+
+|非機能要件|
+:テスト戦略策定;
+:非機能要件定義;
+:運用要件定義;
+
+|要件定義|
+:技術スタック選定;
+:ADR作成;
+:リリース計画;
+
+stop
+
+@enduml
+```
+
+### 要件定義
+
+```plantuml
+@startuml
+
+title RDRA要件定義の全体構造
+
+left to right direction
+
+package "システム価値" as sp {
+  rectangle "システムコンテキスト" as sc
+  rectangle "要求モデル" as rm
+}
+
+package "システム外部環境" as se {
+  rectangle "ビジネスコンテキスト" as bc
+  rectangle "ビジネスユースケース" as buc
+  rectangle "業務フロー" as bf
+  rectangle "利用シーン" as us
+}
+
+package "システム境界" as sb {
+  rectangle "ユースケース複合図" as ucc
+  rectangle "画面・帳票モデル" as ui
+  rectangle "イベントモデル" as em
+}
+
+package "システム" as sys {
+  rectangle "情報モデル" as im
+  rectangle "状態モデル" as sm
+}
+
+sp --> se : "価値を実現する\n環境を明確化"
+se --> sb : "環境での\n接点を定義"
+sb --> sys : "接点を実現する\nシステムを設計"
+
+sc --> bc : "アクター"
+rm --> buc : "要求"
+buc --> ucc : "ユースケース"
+bf --> ucc : "アクティビティ"
+us --> ucc : "利用シーン"
+ucc --> im : "情報"
+ucc --> sm : "状態"
+
+@enduml
+```
+
+要件定義の詳細は[要件定義ガイド](要件定義ガイド)を参照
+
+### リリース計画
+
+```plantuml
+@startuml
+
+[*] --> リリース
+
+state リリース {
+  満足条件1: （ユーザーストーリー、予算、スケジュール)
+  満足条件1 -->リリースプランニング
+  リリースプランニング --> 満足条件1 
+}
+
+state イテレーション {
+  リリースプランニング --> 満足条件2
+  満足条件2: （ユーザーストーリー、予算、スケジュール)
+  満足条件2 --> イテレーションプランニング
+  イテレーションプランニング --> 満足条件2
+  イテレーションプランニング --> 開発
+  開発 --> フィーチャが追加された状態
+  フィーチャが追加された状態 --> 満足条件2 : フィードバック
+  フィーチャが追加された状態 --> 満足条件1 : フィードバック
+}
+
+リリース --> [*]
+
+@enduml
+```
+
+計画づくりの詳細は [アジャイルな見積と計画づくり](アジャイルな見積と計画づくり)	 を参照。
+
+
+### 機能要件
+
+#### アーキテクチャ設計
+
+モノレポを標準とする。
+アプリケーションは、バックエンドとフロントエンドの2つの主要コンポーネントで構成されています。
+
+##### 全体構成
+
+```plantuml
+@startuml
+package "アプリケーション" {
+    package "フロントエンド" {
+        [Webアプリケーション] as WebApp
+    }
+
+    package "バックエンド" {
+        [APIサーバー] as API
+        database "データベース" as DB
+    }
+
+    WebApp --> API : HTTP/REST
+    API --> DB : SQL/NoSQL
+}
+@endtuml
+```
+
+##### パターン
+
+```plantuml
+@startuml
+!define DECISION_COLOR #FFE6CC
+!define PROCESS_COLOR #E6F3FF
+!define TERMINAL_COLOR #E6FFE6
+
+skinparam roundcorner 10
+skinparam shadowing false
+
+start
+
+if (業務領域のカテゴリー) then (補完、一般との連携)
+if (データ構造が複雑か?) then (いいえ)
+:トランザクションスクリプト;
+:逆ピラミッド形のテスト;
+if (永続化モデルは複数か?) then (いいえ)
+:レイヤードアーキテクチャ 3層;
+else (はい)
+:レイヤードアーキテクチャ 4層;
+endif
+else (はい)
+:アクティブレコード;
+:ダイヤモンド形のテスト;
+if (永続化モデルは複数か?) then (いいえ)
+:レイヤードアーキテクチャ 3層;
+else (はい)
+:レイヤードアーキテクチャ 4層;
+endif
+endif
+else (中核の業務領域)
+if (金額を扱う/分析/監査記録が必要か?) then (いいえ)
+:ドメインモデル;
+:ピラミッド形のテスト;
+if (永続化モデルは複数か?) then (いいえ)
+:ポートとアダプター;
+else (はい)
+:CQRS;
+endif
+else (はい)
+:イベント履歴式ドメインモデル;
+:ピラミッド形のテスト;
+:CQRS;
+endif
+endif
+
+stop
+@enduml
+```
+
+##### アーキテクチャパターン
+
+###### 1. **トランザクションスクリプトパターン**
+- **適用場面**: 補完・一般との連携業務で、データ構造が複雑でない場合
+- **特徴**:
+    - 各機能を独立したスクリプトとして実装
+    - 手続き的なプログラミングスタイル
+    - シンプルで理解しやすい
+    - 小規模なアプリケーションに適している
+
+###### 2. **アクティブレコードパターン**
+- **適用場面**: 補完・一般との連携業務で、データ構造が複雑な場合
+- **特徴**:
+    - データとビジネスロジックが同じクラスに含まれる
+    - オブジェクトが自身の永続化処理を担当
+    - ORMパターンの典型例
+    - 中規模のアプリケーションに適している
+
+###### 3. **ドメインモデルパターン**
+- **適用場面**: 中核の業務領域で、金額を扱わない・分析や監査記録が不要な場合
+- **特徴**:
+    - リッチなドメインモデル
+    - ビジネスロジックがオブジェクトに分散
+    - 依存関係の逆転を活用
+    - 複雑なビジネスロジックに適している
+
+###### 4. **イベント履歴式ドメインモデルパターン**
+- **適用場面**: 中核の業務領域で、金額を扱う・分析や監査記録が必要な場合
+- **特徴**:
+    - すべての状態変更をイベントとして記録
+    - 監査証跡の完全性を保証
+    - 時系列分析が可能
+    - 金融システムなど厳格な要件に適している
+
+##### アーキテクチャスタイル
+
+###### 1. **レイヤードアーキテクチャ（3層）**
+- **適用場面**: 永続化モデルが単一の場合
+- **特徴**:
+    - プレゼンテーション、ビジネスロジック、データアクセスの3層
+    - 関心事の分離が明確
+    - 保守性と拡張性が高い
+    - 標準的なエンタープライズアプリケーションに適している
+
+###### 2. **レイヤードアーキテクチャ（4層）**
+- **適用場面**: 永続化モデルが複数の場合
+- **特徴**:
+    - アプリケーション層を追加した4層構造
+    - より細かい責務の分離
+    - 複雑なデータ統合に対応
+    - 大規模なエンタープライズアプリケーションに適している
+
+###### 3. **ポートとアダプターアーキテクチャ（ヘキサゴナル）**
+- **適用場面**: ドメインモデルで永続化モデルが単一の場合
+- **特徴**:
+    - 外部依存からの完全な分離
+    - テスト容易性が高い
+    - 技術的な詳細から独立
+    - マイクロサービスに適している
+
+###### 4. **CQRSアーキテクチャ**
+- **適用場面**: 永続化モデルが複数、またはイベント履歴式の場合
+- **特徴**:
+    - コマンドとクエリの分離
+    - 読み書きのパフォーマンス最適化
+    - 複雑なレポート要件に対応
+    - 高スケーラビリティを要求されるシステムに適している
+
+#### データモデル設計
+
+[グラス片手にデータベース設計 ～販売管理システム編～](https://www.shoeisha.co.jp/book/detail/9784798105666) 参照
+
+#### ドメインモデル設計
+
+[エリック・エヴァンスのドメイン駆動設計 (IT Architects’Archive ソフトウェア開発の実践)](https://www.amazon.co.jp/%E3%82%A8%E3%83%AA%E3%83%83%E3%82%AF%E3%83%BB%E3%82%A8%E3%83%B4%E3%82%A1%E3%83%B3%E3%82%B9%E3%81%AE%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E9%A7%86%E5%8B%95%E8%A8%AD%E8%A8%88-Architects%E2%80%99Archive-%E3%82%BD%E3%83%95%E3%83%88%E3%82%A6%E3%82%A7%E3%82%A2%E9%96%8B%E7%99%BA%E3%81%AE%E5%AE%9F%E8%B7%B5-%E3%82%A8%E3%83%AA%E3%83%83%E3%82%AF%E3%83%BB%E3%82%A8%E3%83%B4%E3%82%A1%E3%83%B3%E3%82%B9/dp/4798121967) 参照
+
+#### UI設計
+
+[オブジェクト指向 UI デザイン -使いやすいソフトウェアの原理-](https://www.sociomedia.co.jp/10046) 参照
+
+### 非機能要件
+
+#### テスト戦略
+
+1. ユニットテスト
+- 個々のコンポーネントのテスト
+- ビジネスロジックの検証
+- 境界値テスト
+
+2. 統合テスト
+- コンポーネント間の連携テスト
+- APIの検証
+- データフローの確認
+
+3. E2Eテスト
+- ユーザーシナリオテスト
+- 実環境に近い状態でのテスト
+- 性能テスト
+
+##### **ピラミッド形テスト**
+- **適用**: ドメインモデル、イベント履歴式
+- **構成**: ユニットテスト多数、統合テスト中程度、E2Eテスト少数
+- **特徴**: 高品質なビジネスロジックの検証に重点
+
+##### **ダイヤモンド形テスト**
+- **適用**: アクティブレコード
+- **構成**: ユニットテストと統合テストを重視
+- **特徴**: データアクセスロジックの検証に重点
+
+##### **逆ピラミッド形テスト**
+- **適用**: トランザクションスクリプト
+- **構成**: E2Eテスト多数、統合テスト中程度、ユニットテスト少数
+- **特徴**: エンドツーエンドの動作検証に重点
+
+
+## 開発
+
+```plantuml
+@startuml
+
+[*] --> イテレーション計画
+イテレーション計画 --> ユーザーストーリー作成
+ユーザーストーリー作成 --> ユースケース作成
+ユースケース作成 --> コーディングとテスト
+アーキテクチャ設計 --> コーディングとテスト
+コーディングとテスト --> アーキテクチャ設計
+データモデル設計 --> コーディングとテスト
+コーディングとテスト --> データモデル設計
+ドメインモデル設計 --> コーディングとテスト
+コーディングとテスト --> ドメインモデル設計
+コーディングとテスト --> ユーザーインターフェース設計
+ユーザーインターフェース設計 --> コーディングとテスト
+コーディングとテスト --> ユースケース作成
+コーディングとテスト --> イテレーションレビュー
+イテレーションレビュー --> イテレーション計画
+イテレーションレビュー --> [*]
+
+@enduml
+```
+
+開発は、以下の2つのアプローチを状況に応じて使い分けます：
+
+1. インサイドアウトアプローチ
+- データモデルから実装を開始
+- ドメイン駆動設計に適合
+- テストファーストな開発
+
+2. アウトサイドインアプローチ
+- UIから実装を開始
+- プロトタイプ駆動開発に適合
+- モックを活用した開発
+
+
+```plantuml
+@startuml
+start
+:ユーザーストーリー;
+if (CRUD実装済み?) then (はい)
+  :ドメインモデル;
+  :アウトサイドイン;
+else (いいえ)
+  :貧血ドメインモデル;
+  :インサイドサイドアウト;
+endif
+if (API実装済み?) then (はい)
+  :インサイドサイドアウト;
+else (いいえ)
+  :アウトサイドイン;
+endif
+stop
+@enduml
+```
+#### インサイドアウト
+
+```plantuml
+@startuml
+start
+:データベース;
+:インフラストラクチャ層;
+:ドメイン層;
+:サービス層;
+:プレゼンテーション層;
+stop
+@enduml
+```
+
+```plantuml
+@startuml
+[*] --> コーディングとテスト
+コーディングとテスト --> TODO : TODOリストを作成
+TODO --> Red : 最小限の実装
+Red --> Green : テストを書く
+Green --> Refactor : リファクタリング
+Refactor --> Red : 次の実装
+Red : 動作の確認
+Green : テストが成功
+Refactor : コードの重複を除去してリファクタリング
+Refactor --> TODO : リファクタリングが完了したらTODOリストに戻る
+TODO --> コーディングとテスト : TODOリストが空になるまで繰り返す
+コーディングとテスト --> イテレーションレビュー
+@enduml
+```
+
+#### アウトサイドイン
+
+```plantuml
+@startuml
+start
+:プレゼンテーション層;
+:サービス層;
+:ドメイン層;
+:インフラストラクチャ層;
+:データベース;
+stop
+@enduml
+```
+
+```plantuml
+@startuml
+[*] --> コーディングとテスト
+コーディングとテスト --> TODO : TODOリストを作成
+TODO --> Red : テストを書く
+Red --> Green : 最小限の実装
+Green --> Refactor : リファクタリング
+Refactor --> Red : 次のテストを書く
+Red : テストに失敗
+Green : テストに通る最小限の実装
+Refactor : コードの重複を除去してリファクタリング
+Refactor --> TODO : リファクタリングが完了したらTODOリストに戻る
+TODO --> コーディングとテスト : TODOリストが空になるまで繰り返す
+コーディングとテスト --> イテレーションレビュー
+@enduml
+```
+
+### コーディングとテスト
+
+```plantuml
+@startuml "イテレーション開発プロセス"
+
+start
+
+partition "イテレーション開始" {
+}
+
+repeat :TODO確認;
+partition "TDD実装サイクル" {
+    repeat
+      :TODO選択;
+      
+      repeat
+        :失敗テスト作成 (Red);
+        :最小実装 (Green);
+        :リファクタリング (Refactor);
+        :品質チェック;
+        if (品質OK?) then (yes)
+          :コミット;
+        else (no)
+          :修正;
+        endif
+      repeat while (TODO完了?)
+      partition "コードレビュー" {
+      }
+    repeat while (全TODO完了?)
+}
+
+if (イテレーション完了?) then (yes)
+  partition "受け入れ" {
+    partition "ユーザーレビュー" {
+    }
+    if (受け入れOK?) then (yes)
+      partition "ふりかえり" {
+      }
+    else (no)
+      partition "修正対応" {
+      }
+    endif
+  }
+else (no)
+  partition "設計リファクタリング" {
+      partition "アーキテクチャリファクタリング" {
+      }
+      partition "データモデルリファクタリング" {
+      }
+      partition "ドメインモデルリファクタリング" {
+      }
+      partition "UIリファクタリング" {
+      }
+  }
+endif
+repeat while (次のTODO?)
+
+stop
+
+@enduml
+```
+- 必ずイテレーション単位で開発を行う
+- 勝手に次のイテレーションに進まない
+- コミットは必ずTODO単位で実施する
+- コミットの前に必ず品質確認を実施する
+- コミットメッセージはAngularのコミットメッセージの書き方を参考にする
+    - feat: 新機能の追加
+    - fix: バグ修正
+    - docs: ドキュメントの変更
+    - style: フォーマットやセミコロンの追加など、コードの動作に影響しない変更
+    - refactor: リファクタリング（バグ修正や機能追加ではない）
+    - test: テストコードの追加や修正
+    - chore: ビルドプロセスや補助ツールの変更
+
+## 運用
+
+### 構築・配置
+
+```plantuml
+@startuml "Phase 1"
+|構築|
+start
+:環境構築;
+:CI/CD構築;
+
+|配置|
+:デプロイ設定;
+
+|構築|
+:ドキュメント更新;
+
+stop
+
+@enduml
+```

package/lib/assets/docs/template/ADR.md

@@ -0,0 +1,30 @@
+# Sample
+
+アーキテクチャ決定の簡単な説明
+
+日付: 2025-02-26
+
+## ステータス
+
+2025-02-26 提案されました
+
+## コンテキスト
+
+この決定を行った状況
+
+## 決定
+
+決定とその根拠
+
+## 影響
+
+この決定による影響
+
+## コプライアンス
+
+この決定が遵守されていることを確認する方法
+
+## 備考
+
+この決定のメタデータ（著者など）
+

package/lib/assets/docs/template/README.md

@@ -0,0 +1,50 @@
+# プロジェクト名
+
+## 概要
+
+### 目的
+
+### 前提
+
+| ソフトウェア | バージョン | 備考 |
+| :----------- | :--------- | :--- |
+| nodejs       | 12.12.0    |      |
+
+## 構成
+
+- [構築](#構築)
+- [配置](#配置)
+- [運用](#運用)
+- [開発](#開発)
+
+## 詳細
+
+### Qick Start
+
+```bash
+npm install
+npm start
+```
+
+### 構築
+
+```bash
+npm init -y
+npm install --save-dev browser-sync jest @babel/core @babel/cli @babel/preset-env @babel/register
+```
+
+**[⬆ back to top](#構成)**
+
+### 配置
+
+**[⬆ back to top](#構成)**
+
+### 運用
+
+**[⬆ back to top](#構成)**
+
+### 開発
+
+**[⬆ back to top](#構成)**
+
+## 参照

package/lib/assets/docs/template//343/201/276/343/201/232/343/201/223/343/202/214/343/202/222/350/252/255/343/202/202/343/201/206/343/203/252/343/202/271/343/203/210.md

@@ -0,0 +1,12 @@
+# まずこれを読もうリスト
+
+- [コンテキスト図](./requirements/コンテキスト図.md) - 情勢をつかむ。
+- [インセプションデッキ](./requirements/インセプションデッキ.md) - プロジェクトの最初の週に作成された。ここにあるものの大部分は変更されたが、このドキュメントは我々がなぜこのシステムを構築しているかを示している。
+- [ユーザーストーリー](./requirements/要件.md) - ユーザーの視点からシステムの要件をまとめる。ユーザーが何を求めているかを理解するために重要。
+- [ユースケース](./requirements/要件.md) - システムの機能を表す。システムが何をするかを理解するのに必要。
+- [アーキテクチャドキュメント](./design/アーキテクチャ.md) - システムのアーキテクチャを示す。システムの全体像を把握するために重要。
+- [設計キュメント](./design) - システムの設計に関する詳細をまとめる。具体的な実装方法や技術選定を記録する。
+- [開発ドキュメント](./development) - 開発の具体的な手順やガイドラインをまとめる。
+- [運用ドキュメント](./operation) - システムの運用に関する情報を提供する。運用チームがシステムを管理するために必要。
+- [アーキテクチャ決定ログ](./adr) - システムのアーキテクチャに関する重要な決定を記録する。将来の参照や説明に役立つ。
+- [日誌](./journal) - 開発の進捗や問題点を記録する。開発の履歴を追うために重要。

package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md

@@ -0,0 +1,59 @@
+# プロジェクト概要
+
+## 日程
+
+- イテレーション開始日
+- イテレーション終了日
+- 作業日数
+
+## 要員
+
+|名前|予定作業日数|実績作業日数|
+|---|---|---|
+|A|5|5|
+
+## 指標
+
+### ナイトリービルド結果
+
+|日付|結果|
+|---|---|
+|9月1日(月) |Build failed|
+
+### イテレーションバーンダウン
+
+```mermaid
+xychart-beta
+    title "リリースバーンダウンチャート"
+    x-axis ["イテレーション1", "イテレーション2", "イテレーション3", "イテレーション4", "イテレーション5", "イテレーション6"]
+    y-axis "残ストーリーポイント" 0 --> 120
+    line [100, 82, 65, 48, 30, 0]
+    line [100, 85, 72, 60, 42, 10]
+```
+
+### ベロシティ
+
+```mermaid
+xychart-beta
+    title "イテレーション別ベロシティ"
+    x-axis ["イテレーション1", "イテレーション2", "イテレーション3", "イテレーション4", "イテレーション5", "イテレーション6", "イテレーション7", "イテレーション8"]
+    y-axis "完了したストーリーポイント" 0 --> 25
+    bar [15, 18, 14, 16, 19, 17, 20, 21]
+    line [17.5, 17.5, 17.5, 17.5, 17.5, 17.5, 17.5, 17.5]
+    line [20.5, 20.5, 20.5, 20.5, 20.5, 20.5, 20.5, 20.5]
+```
+
+## 実施内容と評価
+
+|ストーリー|結果|予定ポイント|ベロシティ加算ポイント|
+|---|---|---|---|
+|ユーザーとして、私は...|完了|5|5|
+|ユーザーとして、私は...|完了|3|3|
+|ユーザーとして、私は...|完了|8|8|
+|合計| |16|16|
+
+### イテレーションレビュー
+
+|アクションアイテム|担当|
+|---|---|
+|ユーザーとして、私は...のレビュー|A|