@k2works/claude-code-booster 4.6.0 → 4.7.0

package/lib/assets/docs/article/getting-start-docker-kubernetes/outline.md

@@ -0,0 +1,211 @@
+# 執筆計画アウトライン
+
+## 概要
+
+「Docker/Kubernetes 実践コンテナ解説」シリーズの執筆計画。書籍『Docker/Kubernetes 実践コンテナ開発入門（第 2 版）』の章立て（`tmp/index.md`）を解説記事として再構成し、各章を実際に動作するサンプルコードに紐づけて解説する。
+
+アルゴリズム入門シリーズ（`getting-started-algorithm`）の `outline.md` の方針を踏襲し、章とソースの対応を明確にしたうえで、読者が手を動かしながら理解できる構成にする。
+
+## 執筆方針
+
+### 実コード紐づけ方式
+
+すべての解説は実在のサンプルコードに紐づける。コードを引用するときは出典（パス）を明示し、存在しないコマンドや設定を捏造しない。中心となるサンプルは本リポジトリの `apps/` 配下に実装を配置し、実機で動作検証している。書籍リポジトリの一部（pipecd-examples / cloudshell / gihyo-docker-kuberbetes）は `apps/` には収録せず、補助参照として扱う。
+
+### apps/ 配下に配置するサンプル
+
+- **echo**（`apps/echo/`）— 単一コンテナの最小サンプル（Go 製の Hello サーバ）。第 1〜2 章、第 5 章、第 8 章、第 10 章で利用
+- **taskapp**（`apps/taskapp/`）— 複数コンテナ構成のタスク管理アプリ（api / web / mysql / migrator / nginx）。第 3〜4 章、第 6 章、第 9 章で利用
+- **container-kit**（`apps/container-kit/`）— デバッグ・プロキシ・ジョブ用の補助コンテナ集。第 7 章、第 12 章、付録 C で利用
+- **image-bootstrap**（`apps/image-bootstrap/`）— distroless + 非 root + Trivy によるセキュアイメージのサンプル。第 10 章、付録 C で利用
+- **echo-bootstrap**（`apps/cd/echo-bootstrap/`）— echo を Kubernetes へデプロイする Kustomize マニフェスト。第 6 章、第 11 章で利用
+- **argocd-example-apps**（`apps/cd/argocd-example-apps/`）— Argo CD 用のサンプルアプリ（guestbook、helm、kustomize、blue-green）。第 11 章で利用
+
+### 補助参照（apps/ には収録しない書籍リポジトリ）
+
+- **pipecd-examples** — PipeCD 用のデプロイ定義（canary、bluegreen、analysis など）。第 11 章で利用
+- **cloudshell** — AWS（EKS / ECS）構築スクリプトと CDK。付録 B で利用
+- **gihyo-docker-kuberbetes** — 書籍のサンプルコード（simple-pod/replicaset/deployment/service/ingress、Helm チャートなど）。第 5 章、第 7〜10 章の補助参照
+
+### 文体・表記
+
+- 言語: 日本語（技術用語は英語のまま）
+- 文体: ですます調、句読点は「。」「、」
+- 日本語と半角英数字の間には半角スペースを入れる
+- コードブロックには言語識別子（`dockerfile` `yaml` `bash` `go` など）を付ける
+- 各章は「はじめに → 概念解説 → ハンズオン → まとめ」の流れを基本とする
+
+## 章とソースの対応
+
+| 章 | ファイル | テーマ | 主な参考ソース |
+|----|---------|--------|---------------|
+| 第 1 章 | `01-container-and-docker-basics.md` | コンテナと Docker の基礎 | `apps/echo/Dockerfile`, `apps/container-kit/containers/` |
+| 第 2 章 | `02-container-deployment.md` | コンテナのデプロイ | `apps/echo/` (main.go, Dockerfile, compose.yaml) |
+| 第 3 章 | `03-practical-container-build-deploy.md` | 実用的なコンテナの構築とデプロイ | `apps/echo/Dockerfile.slim`, `apps/taskapp/containers/` |
+| 第 4 章 | `04-multi-container-application.md` | 複数コンテナ構成でのアプリケーション構築 | `apps/taskapp/` (compose.yaml, containers, Tiltfile) |
+| 第 5 章 | `05-kubernetes-introduction.md` | Kubernetes 入門 | `gihyo-docker-kuberbetes/ch05/simple-*.yaml`, `apps/echo/k8s` |
+| 第 6 章 | `06-kubernetes-deploy-cluster.md` | Kubernetes のデプロイ・クラスタ構築 | `apps/taskapp/k8s/plain/local/`, `apps/cd/echo-bootstrap/` |
+| 第 7 章 | `07-kubernetes-advanced.md` | Kubernetes の発展的な利用 | `apps/container-kit/containers/time-limit-job`, `gihyo*/ch09` |
+| 第 8 章 | `08-kubernetes-packaging.md` | Kubernetes アプリケーションのパッケージング | `apps/taskapp/k8s/kustomize/`, `gihyo*/ch07`, `apps/cd/argocd-example-apps/helm-guestbook` |
+| 第 9 章 | `09-container-operations.md` | コンテナの運用 | `apps/taskapp/containers/nginx-*`, `apps/taskapp/containers/mysql` |
+| 第 10 章 | `10-optimal-container-image.md` | 最適なコンテナイメージ作成と運用 | `apps/echo/Dockerfile.slim`, `apps/image-bootstrap/` |
+| 第 11 章 | `11-continuous-delivery.md` | コンテナにおける継続的デリバリー | `apps/cd/argocd-example-apps/`, `pipecd-examples/`, `apps/cd/echo-bootstrap/` |
+| 第 12 章 | `12-container-use-cases.md` | コンテナのさまざまな活用方法 | `apps/container-kit/`, `gihyo*/chA` |
+| 付録 A | `appendix-a-dev-tools-setup.md` | 開発ツールのセットアップ | `apps/taskapp/.tool-versions`, `apps/taskapp/hack/` |
+| 付録 B | `appendix-b-orchestration-environments.md` | さまざまなコンテナオーケストレーション環境 | `cloudshell/aws/`, `apps/taskapp/k8s/plain/aks`, `pipecd-examples/ecs` |
+| 付録 C | `appendix-c-tips.md` | コンテナ開発・運用の Tips | `apps/container-kit/`, `apps/image-bootstrap/trivy.yaml` |
+
+## ファイル構成
+
+```
+docs/article/getting-start-docker-kubernetes/
+├── index.md                                  # 記事トップページ（目次）
+├── outline.md                                # 本ファイル（執筆計画）
+├── 01-container-and-docker-basics.md         # 第 1 章
+├── 02-container-deployment.md                # 第 2 章
+├── 03-practical-container-build-deploy.md    # 第 3 章
+├── 04-multi-container-application.md         # 第 4 章
+├── 05-kubernetes-introduction.md            # 第 5 章
+├── 06-kubernetes-deploy-cluster.md          # 第 6 章
+├── 07-kubernetes-advanced.md                # 第 7 章
+├── 08-kubernetes-packaging.md               # 第 8 章
+├── 09-container-operations.md               # 第 9 章
+├── 10-optimal-container-image.md            # 第 10 章
+├── 11-continuous-delivery.md                # 第 11 章
+├── 12-container-use-cases.md                # 第 12 章
+├── 13-case-monolith-compose-vs-kustomize.md       # 第 13 章（ケーススタディ 1）
+├── 14-case-event-driven-kustomize-vs-helm.md      # 第 14 章（ケーススタディ 2）
+├── 15-case-escqrs-axon-kustomize-vs-helm.md       # 第 15 章（ケーススタディ 3）
+├── 16-case-escqrs-kafka-kustomize-vs-helm.md      # 第 16 章（ケーススタディ 4）
+├── 17-case-comparison-summary.md                  # 第 17 章（ケーススタディ まとめ）
+├── appendix-a-dev-tools-setup.md            # 付録 A
+├── appendix-b-orchestration-environments.md # 付録 B
+└── appendix-c-tips.md                        # 付録 C
+```
+
+## 構成方針
+
+書籍の 12 章 + 付録 3 章構成をそのまま維持する。各部のねらいは以下のとおり。
+
+### 第 1 部: コンテナと Docker（第 1〜3 章）
+
+コンテナの概念、Docker の基本操作、実用的なイメージ構築までを学ぶ。
+
+| 章 | テーマ | 内容 |
+|----|--------|------|
+| 1 | コンテナと Docker の基礎 | コンテナとは、Docker とは、利用意義、ローカル実行環境の構築 |
+| 2 | コンテナのデプロイ | アプリの実行、イメージ作成、イメージ・コンテナの操作、Docker Compose |
+| 3 | 実用的なコンテナの構築とデプロイ | 粒度、ポータビリティ、コンテナフレンドリ、クレデンシャル、永続化 |
+
+### 第 2 部: 複数コンテナと Kubernetes 入門（第 4〜6 章）
+
+複数コンテナ構成のアプリ構築と Kubernetes の基礎・デプロイを学ぶ。
+
+| 章 | テーマ | 内容 |
+|----|--------|------|
+| 4 | 複数コンテナ構成でのアプリケーション構築 | Web/API/MySQL/マイグレータ/リバースプロキシ、Tilt |
+| 5 | Kubernetes 入門 | Kubernetes とは、ローカル実行、Pod/ReplicaSet/Deployment/Service/Ingress |
+| 6 | Kubernetes のデプロイ・クラスタ構築 | タスクアプリのデプロイ、インターネット公開 |
+
+### 第 3 部: Kubernetes の実践（第 7〜9 章）
+
+発展的な利用、パッケージング、運用を学ぶ。
+
+| 章 | テーマ | 内容 |
+|----|--------|------|
+| 7 | Kubernetes の発展的な利用 | デプロイ戦略、CronJob、RBAC |
+| 8 | Kubernetes アプリケーションのパッケージング | Kustomize、Helm |
+| 9 | コンテナの運用 | ロギング、可用性の高い運用 |
+
+### 第 4 部: イメージ最適化と継続的デリバリー（第 10〜12 章）
+
+イメージ最適化、CD パイプライン、応用的な活用方法を学ぶ。
+
+| 章 | テーマ | 内容 |
+|----|--------|------|
+| 10 | 最適なコンテナイメージ作成と運用 | 軽量ベースイメージ、Multi-stage builds、BuildKit、セキュリティ |
+| 11 | コンテナにおける継続的デリバリー | Flux、Argo CD、PipeCD |
+| 12 | コンテナのさまざまな活用方法 | 開発環境統一、CLI、負荷テスト |
+
+### 第 5 部: 国際貨物輸送システムのケーススタディ（第 13〜17 章）
+
+書籍の基礎を踏まえ、実在の貨物追跡システム（Cargo Tracker）の 4 つのアーキテクチャ実装を題材に、コンテナデプロイ手段（Docker Compose / Kustomize / Helm）を比較する。アーキテクチャの違いがデプロイ手段の選択にどう影響するかを、実装と動作検証を通じて学ぶ。
+
+| 章 | テーマ | 比較軸 |
+|----|--------|--------|
+| 13 | モノリス（case-1）のデプロイ | Docker Compose 対 Kustomize |
+| 14 | イベント駆動マイクロサービス（case-2）のデプロイ | Kustomize 対 Helm |
+| 15 | ES/CQRS マイクロサービス（Axon、case-3）のデプロイ | Kustomize 対 Helm |
+| 16 | ES/CQRS マイクロサービス（Kafka、case-4）のデプロイ | Kustomize 対 Helm |
+| 17 | ケーススタディ実装比較まとめ | 全アーキテクチャ × デプロイ手段の総括 |
+
+### 付録（App.A〜C）
+
+| 付録 | テーマ | 内容 |
+|------|--------|------|
+| A | 開発ツールのセットアップ | WSL2、asdf、kind、Rancher Desktop |
+| B | さまざまなコンテナオーケストレーション環境 | GKE、EKS、AKS、オンプレミス、ECS |
+| C | コンテナ開発・運用の Tips | コンテナランタイム、Kubernetes Tips、生成 AI 活用、apk |
+
+## 第 5 部 ケーススタディの実装・執筆計画
+
+### ねらい
+
+第 1〜12 章で学んだコンテナ・Kubernetes・パッケージング・CD の知識を、実在の業務システム（国際貨物輸送システム = Cargo Tracker）の 4 アーキテクチャに適用する。同一ドメインを異なるアーキテクチャで実装した題材を使い、「アーキテクチャの複雑さが増すほど、宣言的・テンプレート化されたデプロイ手段（Kustomize → Helm）の価値が高まる」ことを実装と検証で示す。
+
+### 題材（参考ソース）
+
+| ケース | アーキテクチャ | 参考ソース | 主な構成要素 |
+|--------|--------------|-----------|------------|
+| case-1 | モノリス | `tmp/case-1` | Spring Boot 単一アプリ（port 8080）+ PostgreSQL |
+| case-2 | イベント駆動マイクロサービス | `tmp/case-2` | 7 マイクロサービス（auth/booking/routing/tracking/handling/billing/gateway）+ frontend |
+| case-3 | ES/CQRS マイクロサービス（Axon） | `tmp/case-3` | Axon 5（Command/Event Sourcing）+ MyBatis（Read）構成のマイクロサービス群 |
+| case-4 | ES/CQRS マイクロサービス（Kafka） | `tmp/case-4` | Kafka + ZooKeeper + PostgreSQL + マイクロサービス群。**`ops/k8s`（Kustomize）と `ops/helm` を既に実装済み**（参照モデル） |
+
+### 章とソース・比較軸の対応
+
+| 章 | ファイル | 参考ソース | 実装する成果物 | 比較軸 |
+|----|---------|-----------|--------------|--------|
+| 第 13 章 | `13-case-monolith-compose-vs-kustomize.md` | `tmp/case-1` | Docker Compose 一式 + Kustomize マニフェスト | Compose 対 Kustomize |
+| 第 14 章 | `14-case-event-driven-kustomize-vs-helm.md` | `tmp/case-2` | Kustomize（base/overlay）+ Helm チャート | Kustomize 対 Helm |
+| 第 15 章 | `15-case-escqrs-axon-kustomize-vs-helm.md` | `tmp/case-3` | Kustomize + Helm チャート | Kustomize 対 Helm |
+| 第 16 章 | `16-case-escqrs-kafka-kustomize-vs-helm.md` | `tmp/case-4` | 既存の `ops/k8s`・`ops/helm` を整理・検証 | Kustomize 対 Helm |
+| 第 17 章 | `17-case-comparison-summary.md` | 第 13〜16 章 | （比較表・指針） | 全体総括 |
+
+### apps/ への実装方針
+
+ケーススタディのデプロイ成果物とアプリ本体のソースは `apps/case-studies/` 配下に配置する。`tmp/` は Git 管理対象外でチェックアウトし直すと失われ再現できないため、ビルドに必要なソースも `apps/` に同梱する（ビルド成果物・`node_modules`・`.gradle` 等は除外）。
+
+```
+apps/case-studies/
+├── case-1-monolith/        # 第 13 章: cargo-tracker/（ソース）+ compose/ + k8s/kustomize/
+├── case-2-event-driven/    # 第 14 章: ソース + k8s/kustomize/ + helm/
+├── case-3-escqrs-axon/     # 第 15 章: ソース + k8s/kustomize/ + helm/
+└── case-4-escqrs-kafka/    # 第 16 章: ソース + k8s/kustomize/ + helm/（tmp/case-4 の ops を基に）
+```
+
+### 実装・検証・執筆のワークフロー
+
+各章は「実装 → 動作検証 → 執筆」の順で進める。
+
+1. **実装**: 参考ソースを基に、対象のデプロイ成果物（Compose / Kustomize / Helm）を `apps/case-studies/` に作成する。
+2. **動作検証**: Docker と ローカル Kubernetes（Docker Desktop / kind）で実際にデプロイし、起動・疎通を確認する。検証時に発見した不具合は修正し、修正点を記録する。
+3. **執筆**: 検証で確認した実コード・コマンド・結果に基づき、比較記事を執筆する。捏造せず、出典（`apps/case-studies/...`）を明示する。
+
+各章の比較記事には、最低限以下を含める。
+
+- アーキテクチャ概要（ドメインとサービス構成）
+- 各デプロイ手段の実装（マニフェスト・チャートの要点）
+- 環境差分の扱い（overlay / values による上書き）
+- 動作検証の手順と結果
+- 比較考察（記述量・重複・再利用性・学習コスト・適性）
+
+### 進め方
+
+規模が大きいため、第 13 章（case-1）から順に「実装 → 検証 → 執筆」を 1 章ずつ完了させ、章単位でコミットする。第 17 章は第 13〜16 章の成果を踏まえて最後に執筆する。
+
+## 参考文献
+
+- 『Docker/Kubernetes 実践コンテナ開発入門（第 2 版）』 — 山田明憲
+- 国際貨物輸送システム（Cargo Tracker）ケーススタディ実装（`tmp/case-1`〜`tmp/case-4`、実装は `apps/case-studies/` に配置）
+- 各章のサンプルコード（`apps/` 配下に配置。一部は書籍リポジトリの補助参照）

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

@@ -1,166 +1,166 @@
-# 第 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 テスティングフレームワークの導入
-
-### テストファースト
-
-最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
-
-> テストファースト
->
-> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
->
-> — テスト駆動開発
-
-今回 Clojure のテスティングフレームワークには標準ライブラリの **clojure.test** を利用します。`deftest`、`testing`、`is` マクロを使ってテストを記述します。
-
-### 開発環境のセットアップ
-
-Leiningen でプロジェクトをセットアップします。
-
-```bash
-# Nix 環境に入る
-$ nix develop .#clojure
-
-# プロジェクトディレクトリに移動
-$ cd apps/clojure
-```
-
-Clojure のテストは `test/` ディレクトリ配下に、プロダクトコードと対応する名前空間で配置します。
-
-### 環境確認テスト
-
-環境が正しく設定されていることを確認するため、学習用テストを書きます。
-
-```clojure
-;; test/fizzbuzz/core_test.clj
-(ns fizzbuzz.core-test
-  (:require [clojure.test :refer :all]
-            [fizzbuzz.core :refer :all]))
-
-(deftest greeting-test
-  (testing "挨拶機能"
-    (is (= "hello world" (greeting)))))
-```
-
-プロダクトコードを作成します。
-
-```clojure
-;; src/fizzbuzz/core.clj
-(ns fizzbuzz.core)
-
-(defn greeting []
-  "hello world")
-```
-
-テストを実行します。
-
-```bash
-$ lein test
-
-lein test fizzbuzz.core-test
-
-Ran 1 tests containing 1 assertions.
-0 failures, 0 errors.
-```
-
-テスト環境が正しく動作することを確認できました。
-
-## 1.5 最初のテスト
-
-では、FizzBuzz の最初のテストを作成しましょう。「1 を渡したら文字列 "1" を返す」テストです。
-
-```clojure
-;; test/fizzbuzz/core_test.clj
-(ns fizzbuzz.core-test
-  (:require [clojure.test :refer :all]
-            [fizzbuzz.core :refer :all]))
-
-(deftest fizzbuzz-test
-  (testing "数を文字列にして返す"
-    (testing "1 を渡したら文字列 \"1\" を返す"
-      (is (= "1" (fizzbuzz 1))))))
-```
-
-プロダクトコードに空の実装を追加します。
-
-```clojure
-;; src/fizzbuzz/core.clj
-(ns fizzbuzz.core)
-
-(defn fizzbuzz [n]
-  nil)
-```
-
-テストを実行すると失敗します。
-
-```bash
-$ lein test
-
-FAIL in (fizzbuzz-test) (core_test.clj:7)
-数を文字列にして返す 1 を渡したら文字列 "1" を返す
-expected: (= "1" (fizzbuzz 1))
-  actual: (not (= "1" nil))
-
-Ran 1 tests containing 1 assertions.
-1 failures, 0 errors.
-```
-
-**RED** の状態です。テストが失敗していることを確認しました。
-
-## 1.6 まとめ
-
-この章では以下のことを学びました。
-
-- **TODO リスト** を作成して仕様を小さなタスクに分解する方法
-- **clojure.test** を使ったテストの書き方（`deftest`、`testing`、`is`）
-- **テストファースト** のアプローチで最初に失敗するテストを書くこと
-- Leiningen プロジェクトの基本構造
-
-**TODO リスト**:
-
-- [ ] 数を文字列にして返す
-    - [x] 1 を渡したら文字列 "1" を返す ← RED
-- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
+# 第 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 テスティングフレームワークの導入
+
+### テストファースト
+
+最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
+
+> テストファースト
+>
+> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
+>
+> — テスト駆動開発
+
+今回 Clojure のテスティングフレームワークには標準ライブラリの **clojure.test** を利用します。`deftest`、`testing`、`is` マクロを使ってテストを記述します。
+
+### 開発環境のセットアップ
+
+Leiningen でプロジェクトをセットアップします。
+
+```bash
+# Nix 環境に入る
+$ nix develop .#clojure
+
+# プロジェクトディレクトリに移動
+$ cd apps/clojure
+```
+
+Clojure のテストは `test/` ディレクトリ配下に、プロダクトコードと対応する名前空間で配置します。
+
+### 環境確認テスト
+
+環境が正しく設定されていることを確認するため、学習用テストを書きます。
+
+```clojure
+;; test/fizzbuzz/core_test.clj
+(ns fizzbuzz.core-test
+  (:require [clojure.test :refer :all]
+            [fizzbuzz.core :refer :all]))
+
+(deftest greeting-test
+  (testing "挨拶機能"
+    (is (= "hello world" (greeting)))))
+```
+
+プロダクトコードを作成します。
+
+```clojure
+;; src/fizzbuzz/core.clj
+(ns fizzbuzz.core)
+
+(defn greeting []
+  "hello world")
+```
+
+テストを実行します。
+
+```bash
+$ lein test
+
+lein test fizzbuzz.core-test
+
+Ran 1 tests containing 1 assertions.
+0 failures, 0 errors.
+```
+
+テスト環境が正しく動作することを確認できました。
+
+## 1.5 最初のテスト
+
+では、FizzBuzz の最初のテストを作成しましょう。「1 を渡したら文字列 "1" を返す」テストです。
+
+```clojure
+;; test/fizzbuzz/core_test.clj
+(ns fizzbuzz.core-test
+  (:require [clojure.test :refer :all]
+            [fizzbuzz.core :refer :all]))
+
+(deftest fizzbuzz-test
+  (testing "数を文字列にして返す"
+    (testing "1 を渡したら文字列 \"1\" を返す"
+      (is (= "1" (fizzbuzz 1))))))
+```
+
+プロダクトコードに空の実装を追加します。
+
+```clojure
+;; src/fizzbuzz/core.clj
+(ns fizzbuzz.core)
+
+(defn fizzbuzz [n]
+  nil)
+```
+
+テストを実行すると失敗します。
+
+```bash
+$ lein test
+
+FAIL in (fizzbuzz-test) (core_test.clj:7)
+数を文字列にして返す 1 を渡したら文字列 "1" を返す
+expected: (= "1" (fizzbuzz 1))
+  actual: (not (= "1" nil))
+
+Ran 1 tests containing 1 assertions.
+1 failures, 0 errors.
+```
+
+**RED** の状態です。テストが失敗していることを確認しました。
+
+## 1.6 まとめ
+
+この章では以下のことを学びました。
+
+- **TODO リスト** を作成して仕様を小さなタスクに分解する方法
+- **clojure.test** を使ったテストの書き方（`deftest`、`testing`、`is`）
+- **テストファースト** のアプローチで最初に失敗するテストを書くこと
+- Leiningen プロジェクトの基本構造
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+    - [x] 1 を渡したら文字列 "1" を返す ← RED
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする