@k2works/claude-code-booster 6.4.0 → 6.5.0

package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/reference/index.md

@@ -0,0 +1,9 @@
+# 原則
+
+* [よいソフトウェアとは](よいソフトウェアとは.md) - よいソフトウェアの目的・価値・必要十分条件（変更を楽に安全にできて役に立つこと）と、それを作るための規律をまとめた原則文書。
+
+# ガイド
+
+* [リリースガイド](リリースガイド.md) - 品質ゲート → バージョンバンプ → CHANGELOG 生成 → git commit + tag を一貫して実行するリリースワークフローの手順。
+* [環境変数管理ガイド](環境変数管理ガイド.md) - dotenv による環境変数の管理方法と、.env.vault による暗号化・復号化（Vault）の運用手順。
+* [OKF 導入ガイド（v0.2）](OKF導入ガイド_V0.2.md) - Open Knowledge Format v0.2 の仕様を日本語で整理し、本プロジェクトの知識バンドルへ導入する手順をまとめたガイド。

package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/reference//343/202/210/343/201/204/343/202/275/343/203/225/343/203/210/343/202/246/343/202/247/343/202/242/343/201/250/343/201/257.md

@@ -0,0 +1,250 @@
+---
+type: Reference
+title: よいソフトウェアとは
+description: よいソフトウェアの目的・価値・必要十分条件（変更を楽に安全にできて役に立つこと）と、それを作るための規律をまとめた原則文書。
+tags: [principles, software-quality, xp, craftsmanship]
+status: stable
+generated: { by: human:k2works, at: 2025-06-27T09:48:46Z }
+---
+
+# よいソフトウェアとは
+
+## ソフトウェアの目的
+
+- 問題解決:
+
+ 
+  - 単なる「動くプログラム」ではなく問題を解決するもの
+- 本質的な目的:
+
+  - ユーザーの問題解決: 課題や不便を解消
+  - ビジネス価値の創出: 組織やビジネスに利益をもたらす
+  - 効率化と自動化: 時間や労力を節約
+  - イノベーションの実現: 新しい体験や可能性を提供
+  
+## ソフトウェアの価値
+
+- 機能性:
+
+  ユーザーの問題をちゃんと解決できるか
+
+- 使いやすさ:
+
+  優れた機能でも使いにくければ意味がない
+
+- 信頼性:
+
+  安定して動作するか
+
+- 保守性:
+
+  長期間にわたって改善・維持できるか
+
+## よいソフトウェアの必要十分条件
+
+変更を楽に安全にできて役に立つソフトウェアであることが必要十分条件である。
+変更を楽に安全にできて役に立つソフトウェアであればよいソフトウェアである。
+
+変更を楽に安全にできなくても役に立つソフトウェアはあるのではないか？
+
+## よいソフトウェアの内部要因と外部要因
+
+### 内部要因
+
+
+```plantuml
+@startuml
+title 内部要因
+
+folder "ビジネス" {
+  folder "チーム" {
+    folder "技術" {
+    }
+  }
+}
+@enduml
+```
+
+内部要因:自分でコントロールできる部分
+
+### 外部要因
+
+外部要因:自分でコントロールできない部分
+
+## だめなソフトウェア
+
+### へろへろスクラム
+
+へろへろスクラムが続くと、チームは疲弊し、顧客満足度は低下し、技術的負債が蓄積する。スクラムの名を借りた単なる「現代的な搾取システム」になりかねない。結局、アジャイルの見かけだけで本質を理解していないマネージャーの自己満足だけが残る。
+
+### 動作するきれいなゴミ
+
+技術的には完璧なソフトウェアのように見えるが、誰も使わないただのゴミ
+
+## よいソフトウェア
+
+本当に良いソフトウェアを作るには、以下のバランスが必要：
+
+1. 技術的な卓越性 - コードの品質、保守性、拡張性
+1. ビジネス価値 - 市場ニーズ、収益創出、競争優位性
+1. ユーザー中心設計 - 使いやすさ、問題解決力4. 健全なチーム文化 - 心理的安全性、自己組織化、継続的改善
+
+## よいソフトウェアを作るための規律
+
+### 規律とは
+
+> ”規律とは「本質的な部分」と「任意の部分」で構成される一連のルールである。”
+> Clean Craftsmanship　規律、基準、倫理 (アスキードワンゴ)
+
+本質的な部分・・・よいソフトウェアを作るパワーを与える
+任意の部分・・・よいソフトウェアを作るために従うプラクティス
+
+### ソフトウエア開発の3P(プリンシパル・パターン・プラクティス)
+
+- SOLID原則:
+
+  単一責任、開放閉鎖、リスコフの置換、インターフェース分離、依存性逆転
+
+- デザインパターン:
+
+  再利用可能な設計ソリューション
+
+- アーキテクチャパターン:
+
+  ソフトウェアアーキテクチャで発生する問題の解決策
+
+- ドメイン駆動設計:
+
+  ビジネスドメインに焦点を当てた設計
+
+- テスト駆動開発:
+
+  テストを先に書いてから実装
+
+- 継続的デリバリー:
+
+  小さな変更を頻繁にリリース
+
+### サークルオブライフ
+
+```plantuml
+@startuml
+title 内部要因
+
+folder "ビジネス" {
+  object チーム全体
+  object 受入テスト
+  object 小さなリリース
+  object 計画ゲーム
+  folder "チーム" {
+    object 継続的インテグレーション
+    object 共同所有
+    object 持続可能なペース
+    object メタファー
+    folder "技術" {
+      object テスト駆動開発
+      object リファクタリング
+      object シンプルな設計
+      object ペアリング
+    }
+  }
+}
+@enduml
+```
+
+#### ビジネスプラクティス
+
+```plantuml
+@startuml
+title 内部要因
+
+folder "ビジネス" {
+  object チーム全体
+  object 受入テスト
+  object 小さなリリース
+  object 計画ゲーム
+  folder "チーム" {
+    folder "技術" {
+    }
+  }
+}
+@enduml
+```
+
+#### チームプラクティス
+
+```plantuml
+@startuml
+title 内部要因
+
+folder "ビジネス" {
+  folder "チーム" {
+    object 継続的インテグレーション
+    object 共同所有
+    object 持続可能なペース
+    object メタファー
+    folder "技術" {
+    }
+  }
+}
+@enduml
+```
+
+
+#### テクニカルプラクティス
+
+```plantuml
+@startuml
+title 内部要因
+
+folder "ビジネス" {
+  folder "チーム" {
+    folder "技術" {
+      object テスト駆動開発
+      object リファクタリング
+      object シンプルな設計
+      object ペアリング
+    }
+  }
+}
+@enduml
+```
+
+### 拡張サークルオブライフ
+
+```plantuml
+@startuml
+title 内部要因
+
+folder "ビジネス" {
+  object チーム全体
+  object 受入テスト
+  object 小さなリリース
+  object 計画ゲーム
+  folder "チーム" {
+    object 継続的インテグレーション
+    object 共同所有
+    object 持続可能なペース
+    object ドメイン駆動設計
+    object 戦略的設計
+    object 戦術的設計
+    object ユビキタス言語
+    folder "技術" {
+      object テスト駆動開発
+      object リファクタリング
+      object シンプルな設計
+      object ペアリング
+    }
+  }
+}
+@enduml
+```
+
+
+## 結論
+
+短期的には変更を楽に安全にできなくても役に立つソフトウェアを作ることはできる。
+しかし、時間の経過・外部環境の変化とともに変更を楽に安全にできないため役に立つソフトウェアでなくなる。
+変更を楽に安全にできて役に立つソフトウェアであることが必要十分条件である。
+上記の条件を満たし外部環境の変化に適応し続けるソフトウェアこそよいソフトウェアである。
+よって、良いソフトウェアとは変更を楽に安全にできて役に立つソフトウェアである。