はじめに
Qiita Conference 2026 に参加し、AI コーディングエージェント向けのワークフロー管理フレームワーク「TAKT」の存在を知りました。
TAKT は YAML でワークフローを定義して、AI エージェントに計画→実装→レビュー→修正のループを回させるフレームワークです。
そんなにすごいものなら、要件定義から設計書を作成し、実装、テストまでやってみようと思いました。
使い方が個性的で、ClaudCode PRO程度の課金枠ではむりかなと思っていたところ、ワークフローのカスタマイズ化を発見。
今回は、ドキュメント生成用にカスタマイズした、ワークフロー定義を紹介します。軽量化に特化させています。
.takt/workflows/doc-gen.yaml
name: doc-gen
description: ドキュメント生成専用。実装のみ・レビューなし・セッション消費最小。
max_steps: 10
initial_step: implement
steps:
- name: implement
edit: true
persona: coder
policy:
- coding
session: refresh
provider_options:
claude:
allowed_tools:
- Read
- Glob
- Grep
- Edit
- Write
- Bash
required_permission_mode: edit
instruction: team-leader-implement
rules:
- condition: 実装完了
next: COMPLETE
- condition: 判断できない、情報不足
next: implement
requires_user_input: true
interactive_only: true
追加後の確認
takt workflow doctor
Workflow OK: .takt/workflows/doc-gen.yaml
takt メニューのその他に入っている
TAKT
Select workflow:
(↑↓ to move, Enter to select, b to bookmark, r to remove)
❯ 📁 🚀 クイックスタート/
📁 ⚡ Mini/
📁 🎨 フロントエンド/
📁 ⚙️ バックエンド/
📁 🔧 デュアル/
📁 🏗️ インフラストラクチャ/
📁 🔍 レビュー/
📁 🎵 TAKT開発/
📁 その他/
Cancel
doc-gen が見つかれば、進めます。
← Go back
✓ 🎼 doc-gen
対話モードを選択してください:
(↑↓ to move, Enter to select)
アシスタント (default)
確認質問をしてから指示書を作成
ペルソナ
先頭エージェントのペルソナで対話
クワイエット
質問なしでベストエフォートの指示書を生成
❯ パススルー
入力をそのままタスクとして渡す
Cancel
✓ パススルー
[INFO] パススルーモード - タスク内容を入力してください。入力内容をそのまま実行します。
>
CLAUDE.md 例(実現したい内容を記載)
# プロジェクト概要
## インフラ情報
- ホストOS: Amazon Linux 2023 (AWS EC2)
- デプロイパス:
- ユーザー: ec2-user
## プロジェクトゴール
xxx
## ユーザー管理フロー
xxx
## ネットワーク構成
xxx
設計書作成の例
パススルーモードにて、以下のように指示を与えてEnterを押下します。
CLAUDE.mdの情報を大前提として、docs/requirements.mdの要件定義書に基づいた『XXX 基本設計書』を日本語で新規作成し、docs/design.md に保存してください。設計書には「1.システム構成図（テキスト表現）」「2.技術スタック選定」「3.画面設計（各画面の項目・遷移）」「4.API設計（エンドポイント一覧）」「5.データベース設計（テーブル定義）」「6.デプロイ構成」を含めてください。
docs/design.md が問題なく生成されていれば、まずは成功！