このガイド全体で使われる用語のクイックリファレンスと、よくある質問への回答です。
用語集とFAQ
用語集
| 用語 | 定義 |
|---|---|
| Agent | パイプラインの1つのステップを実行する AI の「作業者」。特定のプロバイダーとモデルが設定されています。Settings を参照。 |
| アーカイブ (Archive) | 完了したすべてのタスクの検索可能な記録で、結果の詳細がすべて含まれます。アーカイブされたタスクは Restore でキューに戻せます。結果とアーカイブの読み方を参照。 |
| 自動マージ (Auto-merge) | 完了してテストに合格したタスクを dev に自動的にマージする、autoMergeDev タスクオプション。タスクの作成を参照。 |
| ブランチ / Worktree (Branch / Worktree) | 各タスクのために作成される、分離された Git ブランチと別個の作業フォルダ。他の作業に影響を与えないようにします。パイプラインを参照。 |
| Brainstorm | コードを編集せずに、AI と自由な探索や計画を行うためのパネル。Brainstorm を参照。 |
| Chat | プロジェクトごとの会話パネル。コントラクトを踏まえた素早い質問や議論に使います。Chat を参照。 |
| Contract | プロジェクトの特定の部分がどのように動作するかを記述した、保存済みのファクトシート。自動的に同期が保たれます。ナレッジ共有を参照。 |
| Dashboard | AITM のメインのワークスペースビュー。プロジェクトのタブ、カード、タスクキューが表示されます。 |
| Dev Panel (AITM Dev Panel) | AITM サーバーから配信される、注入可能な JS ツールバー（aitm-dev-panel.js）。タグ付けされた UI 要素をオーバーレイ表示し、ライブのイベントカウンターとインスペクターを表示し、DOM の操作を AITM に報告することで、AITM がプロジェクトの DOM 要素マップを構築・維持できるようにします。DOM マップ + Dev Panel を参照。 |
| dev ブランチ (dev branch) | すべてのパイプラインタスクがマージされる、デフォルト／統合ブランチ。マージ、マージ後の修正、Scope Gate を参照。 |
| DOM Explorer | フロントエンドを持つプロジェクトについて、実際の UI 要素と、何が何を引き起こすかを登録したレジストリ。Variable Explorer と IntelliSense を参照。 |
| E2E (エンドツーエンド) | ユーザーが操作するのと同じように、ブラウザ上で実際に動作しているアプリケーションを操作する自動テスト。テストを参照。 |
| ヒント (Hint) | AI が今後のタスクで、繰り返し伝えなくても自動的に適用する、短く再利用可能なルール。ナレッジ共有を参照。 |
| 統合ブランチ (defaultBranch) | プロジェクトのタスクがどのブランチにマージされるかを指定する、プロジェクトごとの設定（デフォルトは dev）。Project settings で「Verify remote」チェックとともに編集できます。マージ、マージ後の修正、Scope Gate を参照。 |
| ナレッジグラフ (Knowledge Graph) | プロジェクトの変数、コントラクト、UI 要素、ドキュメントを相互に結び付けたマップ。ナレッジ共有を参照。 |
| ライセンススロット (License slot) | プロジェクトのスロット。ライセンスは、AITM が管理できるプロジェクトの数を定めます。同時に実行されるタスクの数は制限しません。それは別の Pipeline 設定である Max concurrently running tasks です。ライセンスとプロジェクトスロットを参照。 |
| Lite モード (Lite mode) | コーディングモデルが十分に強力な場合に、Architect の計画ステップをスキップするタスクオプション。タスクの作成を参照。 |
| main ブランチ (main branch) | 安定したリリースブランチ。リリース時の dev → main マージによってのみ更新されます。マージ、マージ後の修正、Scope Gate を参照。 |
| Merge queue | dev へのマージを1件ずつ直列化し、自動的なコンフリクト解決を試みる仕組み。パイプラインを参照。 |
| Pipeline | タスクのプロンプトを完成した変更に変える、12ステップ（branch → architect → code → compliance-check → review → fix → test → e2e → verify → snapshot → docs → chain-audit）の自動シーケンス。その後、Merge queue が dev にマージします。パイプラインを参照。 |
| 優先度 (Priority) | タスクのキュー内の位置のヒント：low、medium、high。タスクの作成を参照。 |
| プロジェクト (Project) | AITM にオンボーディングされ、タスクを作成できるコードベース。概要とはじめにを参照。 |
| プロバイダー (Provider) | パイプラインのステップを実行する、基盤となる AI サービス（Claude、Gemini、OpenAI、DeepSeek、NVIDIA、Ollama）。Settings を参照。 |
| ステータス（タスク） | タスクの現在の状態：pending、running、awaiting_input、waiting、finished、failed、stopped、conflict、archived。awaiting_input は AI がユーザーの回答または承認を待っていること、waiting は E2E テストで見つかったバグの修正をタスクが待っていることを意味します。タスクの作成を参照。 |
| Task | パイプラインを通過する、割り当てられた作業の1単位。タスクの作成を参照。 |
| ターン (Turn) | おおよそ、AI エージェントが考えて行動する1ステップ（例：ファイルの読み取りや編集）。Settings を参照。 |
| 判定 (Verdict) | テストステップの pass/fail（またはより詳細な）結果。特に E2E の判定。結果とアーカイブの読み方を参照。 |
| Watchdog | 停滞したパイプラインのステップを検出し、自動的に再開するバックグラウンドプロセス。パイプラインを参照。 |
FAQ
タスクが失敗するとどうなりますか？
パイプラインは失敗したステップで停止し、タスクのステータスは理由が記録された failed になります。何が問題だったかを把握した後、通常はそのステップ（またはそれ以前のステップ）から再開できます。結果とアーカイブの読み方を参照してください。
複数のタスクを同時に実行できますか？
はい、異なるプロジェクト間では可能です。1つのプロジェクト内では、2つのタスクが同じブランチを取り合うのを避けるため、タスクは1つずつ実行されます。異なるプロジェクトは完全に並列で実行されます。
AITM が自分でリモートや本番ブランチにプッシュすることはありますか？
いいえ。自動マージはローカルの dev ブランチにのみマージします。それ以外の場所へのプッシュは、常にユーザー自身が行う、意図的で別個の操作です。
タスクの途中で AI が行き詰まったらどうなりますか？
Watchdog が停滞したステップを検知し、限られた回数まで自動的にパイプラインを再開します。それでも復旧できない場合、タスクは理由が保持された状態で failed とマークされ、次にどうするかをユーザーが判断できます。パイプラインを参照してください。
データはどこに保存されますか？
ローカルに、プロジェクトごとのデータベース、タスクフォルダ、自動生成されたドキュメントの組み合わせとして保存されます。全体のマップは AITM が保存するデータを参照してください。
完璧なプロンプトを書く必要はありますか？
いいえ。ただし、より具体的なプロンプトの方が、修正サイクルは少なくて済みます。タスクの作成のプロンプト作成のヒントを参照してください。
Chat、Brainstorm、Task の違いは何ですか？
Chat と Brainstorm は議論と計画を行うもので、コードには一切触れません。コードを実際に変更するのは Task だけで、常に、レビューとテストを経る完全なパイプラインを通って実行されます。Chat と Brainstorm を参照してください。
「License blocked (session-mismatch)」バナーは何を意味しますか？
ライセンスサーバーが、同じキーが2か所から同時にハートビートを送っているのを検出しました。2つ目の AITM インスタンス、複製された VM、または元のインスタンスの隣で動いている復元されたバックアップなどです。解除されるまで、キューはタスクを受け付けません。重複しているインスタンスを停止し、バナーの Retry（または Settings → License の Refresh from server）をクリックしてください。インスタンスが1つしかないと確信できる場合、このブロックは誤検知であり、同じバナーからロックを解除できます。ライセンスとプロジェクトスロットを参照してください。
タスクのマージ後に、ヘッダーに「Restart」ボタンが表示されるのはなぜですか？
AITM が自身のコードへの変更をマージしました。デフォルトの manual モードでは、実行中のキューが中断されないよう、再起動の前にユーザーの操作を待ちます。実行中のタスクが完了するのを待ってから、ヘッダーメニューの Restart をクリックしてください。無人のサーバーでは、Settings → Git & Storage → Server restart after self-merge を auto に設定します。
何も実行されていないのに、タスクが pending のままなのはなぜですか？
同時実行数の上限が0である、ライセンスバナーが表示されている、または RAM／CPU が空きの割合のしきい値を下回っているためにリソースガードがタスクを保留している、のいずれかです。ステータスバー（RAM/CPU）、ライセンスバナー、Settings → Pipeline → Max concurrently running tasks を確認してください。Monitor バーの Queued タブには、各ジョブが待機している理由が表示されます。