@k2works/claude-code-booster 6.1.0 → 6.3.0

package/lib/assets/docs/article/getting-start-tdd/go/index.md

@@ -1,83 +0,0 @@
-# テスト駆動開発から始める Go 入門
-
-## 概要
-
-FizzBuzz 問題を題材に、テスト駆動開発（TDD）の基本サイクルから、開発環境の整備、オブジェクト指向設計、関数型プログラミングの活用まで、Go の特徴を活かしながら段階的に学びます。
-
-## 対象読者
-
-- Go の基本文法を理解しているプログラミング学習者
-- TDD を体験してみたい開発者
-- オブジェクト指向設計や関数型プログラミングに興味がある方
-
-## 前提条件
-
-- Go 1.25 以降がインストールされていること
-- golangci-lint が利用可能であること（Nix 環境推奨: `nix develop .#go`）
-
-## Go の特徴
-
-| 特徴 | 説明 |
-|------|------|
-| 静的型付け | コンパイル時に型を検査、安全で高速なバイナリを生成 |
-| シンプルな言語設計 | 25 個のキーワード、少ない構文で高い生産性 |
-| 暗黙的インターフェース | `implements` 宣言不要、メソッドセットで自動的に満たす |
-| 構造体埋め込み | 継承の代わりにコンポジションで型を拡張 |
-| ファーストクラス関数 | 関数を値として扱い、クロージャをサポート |
-| ジェネリクス（Go 1.18+） | 型パラメータによる汎用的なコード |
-
-## 開発ツール
-
-| ツール | 用途 |
-|--------|------|
-| [testing](https://pkg.go.dev/testing) | 標準テスティングパッケージ |
-| [Go Modules](https://go.dev/ref/mod) | パッケージ管理 |
-| [golangci-lint](https://golangci-lint.run/) | リンター（複数ルール統合） |
-| [gofmt](https://pkg.go.dev/cmd/gofmt) | 標準フォーマッター |
-| [Makefile](https://www.gnu.org/software/make/) | タスクランナー |
-
-## 目次
-
-### 第 1 部: TDD の基本サイクル
-
-1. [第 1 章: TODO リストと最初のテスト](01-todo-list-and-first-test.md)
-2. [第 2 章: 仮実装と三角測量](02-fake-it-and-triangulation.md)
-3. [第 3 章: 明白な実装とリファクタリング](03-obvious-implementation-and-refactoring.md)
-
-### 第 2 部: 開発環境と自動化
-
-4. [第 4 章: バージョン管理と Conventional Commits](04-version-control-and-conventional-commits.md)
-5. [第 5 章: パッケージ管理と静的解析](05-package-management-and-static-analysis.md)
-6. [第 6 章: タスクランナーと CI/CD](06-task-runner-and-ci-cd.md)
-
-### 第 3 部: オブジェクト指向設計
-
-7. [第 7 章: カプセル化とポリモーフィズム](07-encapsulation-and-polymorphism.md)
-8. [第 8 章: デザインパターンの適用](08-design-patterns.md)
-9. [第 9 章: SOLID 原則とモジュール設計](09-solid-principles-and-module-design.md)
-
-### 第 4 部: 関数型プログラミングへの展開
-
-10. [第 10 章: 高階関数と関数合成](10-higher-order-functions-and-composition.md)
-11. [第 11 章: 不変データとパイプライン処理](11-immutable-data-and-pipeline.md)
-12. [第 12 章: エラーハンドリングと型安全性](12-error-handling-and-type-safety.md)
-
-## 実装コード
-
-本記事のすべてのコード例は `apps/go/` に実装されています。
-
-```bash
-# 開発環境に入る
-nix develop .#go
-
-# テスト実行
-cd apps/go
-make test
-```
-
-## 参考文献
-
-- Kent Beck 著『テスト駆動開発』
-- Martin Fowler 著『リファクタリング: 既存のコードを安全に改善する』
-- Robert C. Martin 著『Clean Code: アジャイルソフトウェア達人の技』
-- Alan A. A. Donovan, Brian W. Kernighan 著『プログラミング言語 Go』

package/lib/assets/docs/article/getting-start-tdd/haskell/01-todo-list-and-first-test.md

@@ -1,288 +0,0 @@
----
-type: Article
-title: "第 1 章: TODO リストと最初のテスト"
-description: "プログラムを作成するにあたって、まず何をすればよいでしょうか？私たちは、仕様を確認して TODO リスト を作るところから始めます。"
-tags: [article, getting-start-tdd, haskell]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-24T05:22:28Z }
----
-
-# 第 1 章: TODO リストと最初のテスト
-
-## 1.1 はじめに
-
-プログラムを作成するにあたって、まず何をすればよいでしょうか？私たちは、仕様を確認して **TODO リスト** を作るところから始めます。
-
-> TODO リスト
->
-> 何をテストすべきだろうか——着手する前に、必要になりそうなテストをリストに書き出しておこう。
->
-> — テスト駆動開発
-
-## 1.2 仕様の確認
-
-今回取り組む FizzBuzz 問題の仕様は以下の通りです。
-
-```
-1 から 100 までの数をプリントするプログラムを書け。
-ただし 3 の倍数のときは数の代わりに「Fizz」と、5 の倍数のときは「Buzz」とプリントし、
-3 と 5 両方の倍数の場合には「FizzBuzz」とプリントすること。
-```
-
-この仕様をそのままプログラムに落とし込むには少しサイズが大きいですね。最初の作業は仕様を **TODO リスト** に分解する作業から着手しましょう。
-
-## 1.3 TODO リストの作成
-
-仕様を分解して TODO リストを作成します。
-
-**TODO リスト**:
-
-- [ ] 数を文字列にして返す
-  - [ ] 1 を渡したら文字列 "1" を返す
-- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-まず「1 を渡したら文字列 "1" を返す」という、最も小さなタスクから取り掛かります。
-
-## 1.4 テスティングフレームワークの導入
-
-### テストファースト
-
-最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
-
-> テストファースト
->
-> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
->
-> — テスト駆動開発
-
-今回 Haskell のテスティングフレームワークには **HSpec** を利用します。HSpec は BDD（振る舞い駆動開発）スタイルのテストフレームワークで、`describe` と `it` を使って自然言語に近い形式でテストを記述できます。
-
-### 開発環境のセットアップ
-
-Stack でプロジェクトを初期化し、テスト環境をセットアップします。
-
-```bash
-# Nix 環境に入る
-$ nix develop .#haskell
-
-# プロジェクトの初期化
-$ cd apps
-$ stack new haskell simple
-$ cd haskell
-```
-
-`package.yaml` にテストの依存関係を設定します。
-
-```yaml
-name:                fizzbuzz
-version:             0.1.0.0
-synopsis:            FizzBuzz TDD implementation in Haskell
-description:         A FizzBuzz implementation using Test-Driven Development
-license:             BSD-3-Clause
-author:              k2works
-
-dependencies:
-  - base >= 4.7 && < 5
-
-library:
-  source-dirs: src
-  exposed-modules:
-    - FizzBuzz
-
-tests:
-  fizzbuzz-test:
-    main: Spec.hs
-    source-dirs: test
-    dependencies:
-      - fizzbuzz
-      - hspec
-    build-tools:
-      - hspec-discover
-```
-
-`hspec-discover` を使うことで、テストファイルを自動的に検出してくれます。テストのエントリポイントとなる `test/Spec.hs` には以下の 1 行だけを記述します。
-
-```haskell
--- test/Spec.hs
-{-# OPTIONS_GHC -F -pgmF hspec-discover #-}
-```
-
-この GHC プリプロセッサディレクティブにより、`test/` 配下の `*Spec.hs` ファイルが自動的にテストスイートに組み込まれます。
-
-### 環境確認テスト
-
-環境が正しく設定されていることを確認するため、学習用テストを書きます。`test/FizzBuzz/FizzBuzzSpec.hs` を作成します。
-
-```haskell
--- test/FizzBuzz/FizzBuzzSpec.hs
-module FizzBuzz.FizzBuzzSpec (spec) where
-
-import Test.Hspec
-
-spec :: Spec
-spec = do
-  describe "learning test" $ do
-    it "整数を文字列へ変換できる" $
-      show 42 `shouldBe` "42"
-```
-
-テストを実行します。
-
-```bash
-$ stack test
-FizzBuzz.FizzBuzzSpec
-  learning test
-    整数を文字列へ変換できる
-
-Finished in 0.0001 seconds
-1 example, 0 failures
-```
-
-テストが通りました。HSpec が正常に動作することが確認できました。`shouldBe` は HSpec の Matcher で、期待値と実際の値が等しいことを検証します。Haskell の `show` 関数は `Show` 型クラスに属する任意の値を文字列に変換します。これは Rust の `to_string()`（`Display` トレイト）や Python の `str()` に相当します。
-
-## 1.5 仮実装
-
-テスト環境の準備ができたので、TODO リストの最初の作業に取り掛かりましょう。
-
-**TODO リスト**:
-
-- [ ] 数を文字列にして返す
-  - **1 を渡したら文字列 "1" を返す**
-- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-まずはアサーションを最初に書きましょう。
-
-> アサートファースト
->
-> いつアサーションを書くべきだろうか——最初に書こう。
->
-> — テスト駆動開発
-
-### Red: 最初のテスト
-
-まずプロダクトコードのモジュールを作成します。`src/FizzBuzz.hs` を作ります。
-
-```haskell
--- src/FizzBuzz.hs
-module FizzBuzz
-  ( generate
-  ) where
-
-generate :: Int -> String
-generate = undefined
-```
-
-Haskell の `undefined` は「まだ実装されていない」ことを表す値で、評価されると例外を投げます。Rust の `todo!()` マクロに相当します。
-
-テストファイルを更新して、FizzBuzz のテストを書きます。
-
-```haskell
--- test/FizzBuzz/FizzBuzzSpec.hs
-module FizzBuzz.FizzBuzzSpec (spec) where
-
-import Test.Hspec
-import FizzBuzz
-
-spec :: Spec
-spec = do
-  describe "generate" $ do
-    it "1 を渡すと '1' を返す" $
-      generate 1 `shouldBe` "1"
-```
-
-テストを実行します。
-
-```bash
-$ stack test
-FizzBuzz.FizzBuzzSpec
-  generate
-    1 を渡すと '1' を返す FAILED [1]
-
-Failures:
-
-  test/FizzBuzz/FizzBuzzSpec.hs:9:7:
-  1) generate 1 を渡すと '1' を返す
-       evaluate raised an unexpected exception:
-         Prelude.undefined
-
-1 example, 1 failure
-```
-
-`Prelude.undefined` -- まだ実装されていません。`undefined` が評価され、例外が発生しました。
-
-### Green: 仮実装
-
-テストを通すために **仮実装** から始めます。
-
-> 仮実装を経て本実装へ
->
-> 失敗するテストを書いてから、最初に行う実装はどのようなものだろうか——ベタ書きの値を返そう。
->
-> — テスト駆動開発
-
-`generate` 関数を定義して、文字列リテラルを返します。
-
-```haskell
--- src/FizzBuzz.hs
-module FizzBuzz
-  ( generate
-  ) where
-
-generate :: Int -> String
-generate _ = "1"
-```
-
-引数のパターンに `_`（ワイルドカード）を使い、どんな値が来ても無視して `"1"` を返します。これは Rust の `"1".to_string()` をベタ書きするのと同じ仮実装です。Haskell では文字列リテラル `"1"` がそのまま `String` 型（`[Char]` の型エイリアス）になるため、Rust のような `to_string()` 変換は不要です。
-
-テストを実行します。
-
-```bash
-$ stack test
-FizzBuzz.FizzBuzzSpec
-  generate
-    1 を渡すと '1' を返す
-
-Finished in 0.0001 seconds
-1 example, 0 failures
-```
-
-テストが通りました。
-
-**TODO リスト**:
-
-- [ ] 数を文字列にして返す
-  - [x] 1 を渡したら文字列 "1" を返す
-- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-ここまでの作業をバージョン管理システムにコミットしておきましょう。
-
-```bash
-$ git add .
-$ git commit -m 'test: 数を文字列にして返す'
-```
-
-## 1.6 まとめ
-
-この章では以下のことを学びました。
-
-- **TODO リスト** で仕様をプログラミング対象に分解する方法
-- **テストファースト** で最初にテストを書く考え方
-- HSpec テストフレームワーク（`describe`、`it`、`shouldBe`）のセットアップ
-- `hspec-discover` による自動テスト検出
-- **仮実装** でベタ書きの値を返してテストを通す手法
-- **アサートファースト** でテストの終わりから書き始めるアプローチ
-- Haskell の `undefined`（未実装マーカー）と `show`（文字列変換）
-
-次章では、2 つ目のテストケースを追加して **三角測量** を行い、プログラムを一般化していきます。