From c6e5a706d61148e6413752b9ecaa800dc20c138c Mon Sep 17 00:00:00 2001 From: nrslib <38722970+nrslib@users.noreply.github.com> Date: Mon, 23 Feb 2026 21:29:26 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=E9=9F=B3=E6=A5=BD=E3=83=A1=E3=82=BF?= =?UTF-8?q?=E3=83=95=E3=82=A1=E3=83=BC=E3=81=AE=E7=94=B1=E6=9D=A5=E8=AA=AC?= =?UTF-8?q?=E6=98=8E=E8=BF=BD=E5=8A=A0=E3=80=81=E3=82=AB=E3=82=BF=E3=83=AD?= =?UTF-8?q?=E3=82=B0=E6=BC=8F=E3=82=8C=E3=83=BB=E3=83=AA=E3=83=B3=E3=82=AF?= =?UTF-8?q?=E5=88=87=E3=82=8C=E3=83=BB=E5=AD=A4=E7=AB=8B=E3=83=89=E3=82=AD?= =?UTF-8?q?=E3=83=A5=E3=83=A1=E3=83=B3=E3=83=88=E3=82=92=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 | 3 ++- docs/README.ja.md | 4 +++- docs/builtin-catalog.ja.md | 2 ++ docs/builtin-catalog.md | 2 ++ docs/pieces.md | 2 +- 5 files changed, 10 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index e65025a..9afcb59 100644 --- a/README.md +++ b/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 | diff --git a/docs/README.ja.md b/docs/README.ja.md index 24d8075..b7d467f 100644 --- a/docs/README.ja.md +++ b/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)) | バージョン履歴 | diff --git a/docs/builtin-catalog.ja.md b/docs/builtin-catalog.ja.md index 2ca4c58..1ec2f5c 100644 --- a/docs/builtin-catalog.ja.md +++ b/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 ナレッジ注入付き。 | diff --git a/docs/builtin-catalog.md b/docs/builtin-catalog.md index b800e76..77ce519 100644 --- a/docs/builtin-catalog.md +++ b/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. | diff --git a/docs/pieces.md b/docs/pieces.md index ff654cb..f90af44 100644 --- a/docs/pieces.md +++ b/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