TAKT & TeamKit

Transcript

1. TAKT & TeamKit 2026.03.06 AI コーディングエージェントに 構造化されたワークフローを与える
2. 自己紹介 Go Tanaka X: @tan_go238 フリーランスエンジニア 普段はマネジメントが中心ですが、 最近はAI を活用した開発プロセスの改善に 取り組んでいます。
3. 宣伝 「要件定義の教科書」 を Zenn で無料公開しています。 ベテランPM と若手エンジニアの対話形式で、 炎上しないプロジェクトの作り 方を解説しています。 30 分程度で読める分量なので、要件定義に苦手意識があ る方もぜひ。 https://zenn.dev/tan_go238/books/f4cdf93523210f
4. What is TAKT?
5. TAKT とは AI コーディングエージェントに「品質の高いコード」を出させるためのツール 解決する課題 AI に丸投げすると品質がバラつく レビューなしでは不安が残る 再現性のあるワークフローが欲しい TAKT のアプローチ YAML でワークフローを宣言的に定義 計画 → 実装 → レビュー → 修正 の自動ループ 隔離された worktree で安全に実行 TAKT Agent Koordination Topology
6. TAKT の基本コンセプト Piece （楽曲） ワークフロー全体の定義ファイル（YAML ） Movement （楽章） 各ステップ（計画・実装・レビューなど） Persona （演奏者） 各Movement を担当するAI の役割 Planner - 計画を立てる Coder - 実装する Reviewer - レビューする 音楽のメタファーで構成されている Piece = [Movement1 → Movement2 → Movement3 → ...] (planner) (coder) (reviewer)
7. Piece ファイルの構造（1/2 ） 最小構成の例 name: plan-implement-review initial_movement: plan max_movements: 10 movements: - name: plan persona: planner edit: false rules: - { condition: Planning complete, next: implement } - name: implement persona: coder edit: true rules: - { condition: Implementation complete, next: review } - name: review persona: reviewer edit: false rules: - { condition: approved, next: COMPLETE } - { condition: needs_fix, next: implement }
8. Piece ファイルの構造（2/2 ） Piece の主要フィールド フィールド 説明 name Piece の識別子 initial_movement 開始Movement max_movements 最大実行回数 movements Movement の配列 Movement のフィールド フィールド 説明 persona 担当ペルソナ edit 編集権限の有無 rules 遷移ルール instruction 追加指示 allowed_tools 使用可能ツール
9. Piece のカスタマイズ ファセット管理 Piece の中で外部ファイルを参照できる 並列レビューの例 takt eject で組み込みPiece をローカルにコピーして編集可能 takt eject plan-implement-review # ~/.takt/pieces/ にコピー personas: planner: ./facets/personas/planner.md coder: ./facets/personas/coder.md policies: quality: ./facets/policies/quality.md knowledge: domain: ./facets/knowledge/domain.md - name: reviewers parallel: - name: arch-review persona: reviewer - name: security-review persona: security-reviewer rules: - condition: all("approved") next: COMPLETE - condition: any("needs_fix") next: implement
10. What is TeamKit?
11. TeamKit とは できること 要件定義書の自動生成 ユースケース抽出 UI 定義の生成 HTML モックアップの自動生成 フィードバックの収集・反映 基本ワークフロー 要件定義からモックアップまで、開発プロセスの上流工程を自動化 AI 駆動開発における周辺タスクの自動化ツール # 1. プロジェクト初期化 /teamkit:app-init MyApp # 2. 機能の要件を作成 /teamkit:create FeatureName # 3. フィードバック反映 /teamkit:feedback FeatureName /teamkit:apply-feedback
12. TeamKit の出力例 ファイル 種別 説明 README.md 要件定義 機能要件・非機能要件・制約条件 workflow.yml 業務フロー ワークフロー定義 usecase.yml ユースケース ユースケース分析 ui.yml UI 定義 画面設計・入力ルール screenflow.md 画面遷移 スクリーンフロー図（Mermaid ） npx mokkun ui.yml モックアップ HTML モックを表示 /teamkit:create で .teamkit/FeatureName/ 配下に仕様書群が自動生成される
13. 要件定義 → ユースケース → UI 設計 → モックアップまで一括生成 TeamKit × TAKT
14. export-to-takt 入力（TeamKit ） 要件定義書 ユースケース UI 定義 モックアップ 出力（TAKT 用） 構造化されたタスク定義 実装に必要なコンテキスト 品質基準・制約条件 上流工程の成果物 → AI が理解できる実装指示へ自動変換 TeamKit の仕様書を TAKT の order （タスク） に変換するスキル /teamkit:export-to-takt FeatureName ※ 現在改修中
15. 全体ワークフロー TAKT TeamKit OK 要件定義 モック生成 タスク化 指示書作成 （Planner ） レビュー （人間） 実装・検証 （Coder, Reviewer ） 完成
16. 全体ワークフロー - 3 つのPhase Phase 1: 設計 1. 要件を整理 2. TeamKit でモックアップ生成 3. フィードバック反映 Phase 2: 計画 4. export-to-takt でタスク化 5. Planner が指示書を作成 6. 人がレビュー・承認 Phase 3: 実装 7. TAKT が実装を実行 8. 自動レビュー・修正ループ 9. 完成・PR 作成
17. Step 1: TeamKit でモックアップ生成 要件を書く TeamKit で生成 ここで人がモックアップを確認し、仕様を固める # ユーザー認証機能 ## 概要 メールアドレスとパスワードによる ユーザー認証を実装する ## 機能要件 - サインアップ - ログイン / ログアウト - パスワードリセット # 機能を作成（仕様書・モック一括生成） /teamkit:create auth # モックアップを確認してフィードバック /teamkit:feedback auth # フィードバックを反映 /teamkit:apply-feedback
18. Step 2: export-to-takt でタスク化 TeamKit の成果物を TAKT が理解できる形式に変換 /teamkit:export-to-takt auth # 生成されるタスク（イメージ） task: ユーザー認証機能の実装 context: requirements: .teamkit/auth/README.md workflows: .teamkit/auth/workflow.yml usecases: .teamkit/auth/usecase.yml ui_specs: .teamkit/auth/ui.yml screenflows: .teamkit/auth/screenflow.yml constraints: - Zod によるバリデーション必須 - エラーメッセージは日本語対応 仕様書・モックアップ・制約条件が構造化されたコンテキストとして渡される
19. Step 3: Planner が指示書を作成 → 人がレビュー Planner の出力例 人がレビューするポイント 設計の妥当性 テーブル設計・API 設計は要件を満たすか セキュリティ・実装方針 認証方式・パスワードハッシュは適切か 技術選定・テスト戦略は十分か ここが人間のゲート AI に任せきりにしない # 実装計画 ## 1. データモデル定義 - User テーブル (email, password_hash...) - Session テーブル ## 2. API エンドポイント - POST /api/auth/signup - POST /api/auth/login - POST /api/auth/logout - POST /api/auth/reset-password ## 3. フロントエンド - SignupForm コンポーネント - LoginForm コンポーネント - AuthProvider (Context)
20. Step 4: TAKT で実装 → 自動検証 needs_fix approved Plan 計画確認 Implement コード実装 Review 自動レビュー COMPLETE PR 作成 Plan edit: false 指示書を確認・整理 Implement edit: true コード実装・テスト Review edit: false 品質チェック・修正指示 レビュー済みの指示書を元に TAKT が自動実行 takt --task "${FilePath} にある指示書を元に実装を進めてください"
21. まとめ
22. TAKT × TeamKit の価値 AI に任せること モックアップ生成 仕様書の構造化 指示書の作成 コード実装 自動レビュー・修正 人が担うこと 要件の定義 モックアップの確認 指示書のレビュー・承認 最終的な品質判断 Human in the Loop AI の効率性 × 人の判断力 「任せるところは任せ、見るべきところは見る」
23. Thank you! github.com/nrslib/takt github.com/tango238/teamkit