# 設計思想

TAKT は、AI エージェントをプロンプトの記憶に委ねるのではなく、再利用可能な構造で導くという考え方で設計されています。

このドキュメントでは、TAKT の設計判断の背景にある原則を説明します。ユーザーが TAKT の挙動を理解し、コントリビューターが今後の変更を判断するときの基準にするためのものです。

## エージェントは強力だが、権威ではない

AI エージェントは、計画、実装、レビュー、要約を行えます。しかし、その出力は確率的で、コンテキストに依存します。もっともらしい答えだからといって、それをそのまま正しいものとして扱うべきではありません。

TAKT は、役割、権限、期待する出力、レビュー経路、エスカレーション先を定義したプロセスの中にエージェントを置きます。

## プロンプトより構造

プロンプトは有用ですが、プロンプトだけでは振る舞いを強制できません。エージェントは指示を忘れ、制約を見落とし、コンテキストが長くなるほど目的から逸れることがあります。

TAKT は、workflow、step、rules、output contract、quality gate によってプロセスを明示します。プロセス上重要なことは、エージェントが覚えているはずの文章ではなく、構造として表現されるべきです。

## 分離が品質を高める

TAKT は、責務、知識、制約を分離します。

実装 step が、自分自身のレビューまで独立して担うべきではありません。レビュワーには、レビューに必要な knowledge と policy を渡せばよく、タスク履歴のすべてを渡す必要はありません。判定者は、実装を書き換えるのではなく、次の step を決めることに集中します。

この分離により、コンテキストを小さく保ち、各エージェントの責務を明確にし、必要な情報を必要な step に渡すことでタスクの精度を高めます。

## フィードバックループを第一級に扱う

TAKT は、レビュー、修正、再レビュー、仲裁、ループ監視をプロセスの中心として扱います。

AI が生成した成果物は、構造化されたフィードバックによって改善できるべきです。一方で、フィードバックループには境界も必要です。TAKT の workflow は、指摘を修正 step に戻し、複数のレビュー観点を集約し、人間に判断を求め、生産的でないループを停止できます。

## 人間の判断はエスカレーション先である

TAKT は、人間の継続的な介入を減らすためのものであり、人間の判断を不要にするためのものではありません。

安全に進められる間は、定型的なループをエージェントが担います。要件が曖昧なとき、指摘が衝突するとき、権限が不足しているとき、workflow が前に進めないときは、不確実性を隠さず人間に判断を戻します。

## workflow はプロセス資産である

workflow は単なる実行スクリプトではありません。工程、役割、レビュー基準、修正経路、完了条件を含む「仕事の進め方」を表します。

そのプロセスを YAML として保存し、再利用可能な facet からプロンプトを組み立てることで、個人やチームの開発プロセスを共有し、点検し、改善できます。

## 追跡性を重視する

AI の作業は、後から確認できるべきです。

TAKT は、レポート、ログ、コンテキスト、タスク状態を記録し、何が起きたのか、なぜ次へ進んだのか、判断がどこから来たのかを確認できるようにします。追跡性は workflow 改善の土台でもあります。失敗とフィードバックの記録がなければ、プロセスを安定して改善することはできません。

## 完全自律より実用的な自動化

TAKT は、エージェントを無制約に動かすことを前提にしていません。繰り返し可能な部分を自動化しつつ、観測可能で、レビュー可能で、中断可能なプロセスとして保つために設計されています。

目的は実用的な自動化です。再利用可能な構造、明確な責務、制御されたフィードバック、そして人間が信頼し改善できるだけの追跡性を提供します。
