docs: 音楽メタファーの由来説明追加、カタログ漏れ・リンク切れ・孤立ドキュメントを修正

- README.md / docs/README.ja.md に TAKT の語源（ドイツ語の「タクト」）の説明を追加
- builtin-catalog に default-test-first-mini を追加（おすすめ一覧・全一覧の両方）
- docs/pieces.md の壊れたリンク（docs/piece-categories.md → configuration.md#piece-categories）を修正
- Documentation テーブルに data-flow.md を追加（孤立ドキュメントの解消）
- docs/README.ja.md のテーブル後の改行欠落を修正

README.md

@@ -83,7 +83,7 @@ takt list
 
 ## How It Works
 
-TAKT uses a music metaphor: **piece** = workflow, **movement** = step.
+TAKT uses a music metaphor — the name itself comes from the German word for "beat" or "baton stroke," used in conducting to keep an orchestra in time. In TAKT, a **piece** is a workflow and a **movement** is a step within it, just as a musical piece is composed of movements.
 
 A piece defines a sequence of movements. Each movement specifies a persona (who), permissions (what's allowed), and rules (what happens next). Here's a minimal example:
 
@@ -252,6 +252,7 @@ await engine.run();
 | [Faceted Prompting](./docs/faceted-prompting.md) | Prompt design methodology |
 | [Repertoire Packages](./docs/repertoire.md) | Installing and sharing packages |
 | [Task Management](./docs/task-management.md) | Task queuing, execution, isolation |
+| [Data Flow](./docs/data-flow.md) | Internal data flow and architecture diagrams |
 | [CI/CD Integration](./docs/ci-cd.md) | GitHub Actions and pipeline mode |
 | [Provider Sandbox](./docs/provider-sandbox.md) | Sandbox configuration for providers |
 | [Changelog](./CHANGELOG.md) ([日本語](./docs/CHANGELOG.ja.md)) | Version history |

docs/README.ja.md

@@ -95,7 +95,7 @@ takt list
 
 ## 仕組み
 
-TAKT は音楽のメタファーを使っています。**piece** がワークフロー、**movement** が各ステップにあたります。
+TAKT は音楽のメタファーを使っています。TAKT という名前自体が、オーケストラの指揮で拍を刻む「タクト（Takt）」に由来しています。**piece** がワークフロー、**movement** が各ステップにあたります。音楽の楽曲（piece）が複数の楽章（movement）で構成されるのと同じです。
 
 piece は movement の並びを定義します。各 movement では persona（誰が実行するか）、権限（何を許可するか）、ルール（次にどこへ進むか）を指定します。
 
@@ -142,6 +142,7 @@ movements:
 | `backend-mini` | バックエンド向けの mini 構成です。 |
 | `expert-mini` | エキスパート向けの mini 構成です。 |
 | `default` | 本格的な開発向けです。並列レビュアーによる多段階レビューが付いています。TAKT 自身の開発にも使用しています。 |
+
 全ピース・ペルソナの一覧は [Builtin Catalog](./builtin-catalog.ja.md) を参照してください。
 
 ## 主要コマンド
@@ -263,6 +264,7 @@ await engine.run();
 | [Faceted Prompting](./faceted-prompting.ja.md) | プロンプト設計の方法論 |
 | [Repertoire Packages](./repertoire.ja.md) | パッケージのインストール・共有 |
 | [Task Management](./task-management.ja.md) | タスクの追加・実行・隔離 |
+| [データフロー](./data-flow.md) | 内部データフローとアーキテクチャ図 |
 | [CI/CD Integration](./ci-cd.ja.md) | GitHub Actions・パイプラインモード |
 | [Provider Sandbox](./provider-sandbox.md) | プロバイダーのサンドボックス設定 |
 | [Changelog](../CHANGELOG.md) ([日本語](./CHANGELOG.ja.md)) | バージョン履歴 |

docs/builtin-catalog.ja.md

@@ -12,6 +12,7 @@ TAKT に同梱されているすべてのビルトイン piece と persona の
 | `frontend-mini` | フロントエンド向けの mini 構成です。 |
 | `backend-mini` | バックエンド向けの mini 構成です。 |
 | `expert-mini` | エキスパート向けの mini 構成です。 |
+| `default-test-first-mini` | テストファースト開発向けです。テストを先に書き、それを通す実装を行います。 |
 | `default` | 本格的な開発向けです。並列レビュアーによる多段階レビューが付いています。TAKT 自身の開発にも使用しています。 |
 
 ## 全ビルトイン Piece 一覧
@@ -23,6 +24,7 @@ TAKT に同梱されているすべてのビルトイン piece と persona の
 | 🚀 クイックスタート | `default-mini` | ミニ開発 piece: plan -> implement -> 並列レビュー (AI antipattern + supervisor) -> 必要に応じて修正。レビュー付き軽量版。 |
 | | `frontend-mini` | ミニフロントエンド piece: plan -> implement -> 並列レビュー (AI antipattern + supervisor)。フロントエンドナレッジ注入付き。 |
 | | `backend-mini` | ミニバックエンド piece: plan -> implement -> 並列レビュー (AI antipattern + supervisor)。バックエンドナレッジ注入付き。 |
+| | `default-test-first-mini` | テストファースト開発 piece: plan -> テスト作成 -> 実装 -> 並列レビュー -> 必要に応じて修正 -> 完了。 |
 | | `default` | フル開発 piece: plan -> implement -> AI review -> 並列レビュー (architect + QA) -> supervisor 承認。各レビュー段階に修正ループあり。 |
 | | `compound-eye` | マルチモデルレビュー: 同じ指示を Claude と Codex に同時送信し、両方のレスポンスを統合。 |
 | ⚡ Mini | `backend-cqrs-mini` | ミニ CQRS+ES piece: plan -> implement -> 並列レビュー (AI antipattern + supervisor)。CQRS+ES ナレッジ注入付き。 |

docs/builtin-catalog.md

@@ -12,6 +12,7 @@ A comprehensive catalog of all builtin pieces and personas included with TAKT.
 | `frontend-mini` | Frontend-focused mini configuration. |
 | `backend-mini` | Backend-focused mini configuration. |
 | `expert-mini` | Expert-level mini configuration. |
+| `default-test-first-mini` | Test-first development. Write tests first, then implement to pass them. |
 | `default` | Serious development. Multi-stage review with parallel reviewers. Used for TAKT's own development. |
 
 ## All Builtin Pieces
@@ -23,6 +24,7 @@ Organized by category.
 | 🚀 Quick Start | `default-mini` | Mini development piece: plan -> implement -> parallel review (AI antipattern + supervisor) -> fix if needed. Lightweight with review. |
 | | `frontend-mini` | Mini frontend piece: plan -> implement -> parallel review (AI antipattern + supervisor) with frontend knowledge injection. |
 | | `backend-mini` | Mini backend piece: plan -> implement -> parallel review (AI antipattern + supervisor) with backend knowledge injection. |
+| | `default-test-first-mini` | Test-first development piece: plan -> write tests -> implement -> parallel review -> fix if needed -> complete. |
 | | `default` | Full development piece: plan -> implement -> AI review -> parallel review (architect + QA) -> supervisor approval. Includes fix loops at each review stage. |
 | | `compound-eye` | Multi-model review: sends the same instruction to Claude and Codex simultaneously, then synthesizes both responses. |
 | ⚡ Mini | `backend-cqrs-mini` | Mini CQRS+ES piece: plan -> implement -> parallel review (AI antipattern + supervisor) with CQRS+ES knowledge injection. |

docs/pieces.md

@@ -18,7 +18,7 @@ A piece is a YAML file that defines a sequence of movements executed by AI agent
 ## Piece Categories
 
 To organize the piece selection UI into categories, configure `piece_categories`.
-See `docs/piece-categories.md` for details.
+See the [Configuration Guide](./configuration.md#piece-categories) for details.
 
 ## Piece Schema