AIエージェントとの共同作業

TandemLoopは、外部のAIエージェントが対等なパートナーとして同じデータを扱えるように、最初から設計されています。App自体にはAIは含まれておらず、好きなエージェント型のAIツールを接続して使います（AIツールを接続するを参照）。データフォルダは中身の見えない独自形式ではなく、どのツールでも読めるプレーンテキストのMarkdownです。それでも、明確な作業の取り決めがあります。構成に何が起きるかを決めるのは自分です。

タンデムの考え方

タンデム自転車のたとえは、この共同作業をよく表しています。自分は前に座って進む方向を決め、エージェントは後ろに座って力を出します。どちらも勝手には動きません。Appにとって、これは次のことを意味します。

• 自分は、ビジョン、優先順位、関係性、判断を決めます。
• AIツールは、全体を把握し、準備をし、リマインドし、パターンに気づき、アクションを提案します。

エージェントがデータフォルダを扱うしくみ

AIエージェントは、ほかのツールと同じようにデータフォルダを読みます。フォルダ構成をたどり、YAMLフロントマターとMarkdownの本文を読み込みます。何を書き込んでよいかは、提案を有効にしているかどうかで変わります。

既存のタグの名前の変更や削除は、App内で自分で行います。設定に関係なく、エージェントはカスタム属性とテーマを作成でき、依頼に応じて未完了のどのタスクにもリマインドを設定できます。どちらの場合も、_archive/、_system/、_conflicts/、_config/内のAppの設定、およびAGENTS.mdの管理されたブロックを直接編集することは禁止されています。

エージェントは実行のたびに、_config/agent.yaml（last_run）に時刻を記録します。TandemLoopはこれをもとに、エージェントからの返却 › エージェント待ちで、エージェントが最後に作業した時刻を表示します。自律的かつ継続的に共同作業するを参照してください。

提案のオン/オフ

提案は任意の機能で、標準ではオフです。いつでも設定から有効にできます。

この設定はデータフォルダ全体に適用されます。オフにすると、TandemLoopは提案に関するすべての画面を非表示にします。既存の提案ファイルはそのまま残り、提案を再びオンにすると表示されます。

提案：承認して反映する変更

提案を有効にしている場合、提案は_proposals/フォルダにあるMarkdownファイルです。1つ以上のアクション（例：「タスクXをプロジェクトYに移動」）とその理由が記述されています。提案は、全体またはアクションごとに、承認、却下、修正の依頼ができます。

提案の流れについては、このマニュアルの第4部で詳しく説明しています。

カスタム属性：エージェントも作成できます

カスタム属性は、エージェントが把握しているデータモデルの一部です。AGENTS.mdと_system/docs/data-model.mdには、現在定義されているすべての属性が、キー、種類、適用対象、オプション、説明とともに一覧になっています。属性を作成、変更、削除したとき、またはエージェントが新しい定義ファイルを書き込んだときに、Appがこの一覧を自動的に更新します。

たとえば、エージェントは依頼に応じてタスク用の「顧客」属性を作成し、そのあと値を入力できます。提案がオフの場合は直接、提案がオンの場合は、自分に割り当てられた項目と新しく作成した項目には直接、それ以外の項目には提案（パラメータattributes）を通じて入力します。

AGENTS.md：エージェント向けの手順書

データフォルダのルートには、AGENTS.mdというファイルがあります。このファイルは、許可されているアクション、書き込みのルール、ディレクトリ構成、さらに提案を有効にしている場合は提案の形式といった決まりごとを、AIエージェントに説明します。Appはこのファイルを最新の状態に保ち、提案をオン/オフにすると内容を書き換えます。ファイルは読むことができますが、TANDEMLOOP:STARTとTANDEMLOOP:ENDのマーカーの間にあるシステム管理のブロックは、手作業で変更しないでください。