コーディング Agent

🟢 資金は移動しません。Coding は選択したプロジェクトのチェックアウト内でファイルを変更し、コマンドを実行できます。メインの作業ディレクトリに影響を与えたくない場合は、分離ワークツリーを使用してください。

Coding は、プロジェクトのコンテキストを理解するエンジニアリングワークスペースを Minara に提供します。Agent は編集前にリポジトリを確認し、プロジェクト内の指示に従います。必要な範囲だけを変更し、プロジェクト固有のツールで結果を検証します。

未知のコードベースの理解、機能実装、失敗したテストの修正、変更レビュー、アルゴリズムの改善に利用できます。金融工学のコードでは、データ、精度、リスクの前提も明確にします。

コーディングタスクを開始する

1. Web UI で Coding を開きます。
2. 新しいプロジェクトフォルダーを作成するか、既存のフォルダーを追加します。マシン上の任意のフォルダーを選択するには Minara デスクトップアプリが必要です。
3. 新しい Git タスクでは、コンポーザーの ワークツリー をオフにすると選択中のローカルチェックアウトを使い、オンにするとタスクを分離できます。
4. ワークツリーモードでは、利用可能な場合は main が優先され、存在しない場合は有効なデフォルトまたは現在のローカルブランチにフォールバックします。別のローカル基点はブランチピッカーから選択でき、この操作でローカルチェックアウトは切り替わりません。
5. 目的を記述して最初のプロンプトを送信します。Agent が操作を始める前に、Minara は選択した基点から minara/task-* ブランチと管理対象ワークツリーを作成します。プロジェクト、チェックアウト、ターミナル、ファイル、ワークベンチツールは、そのタスクに継続して紐付きます。

タスク開始時に、Minara はルートの AGENTS.md と CLAUDE.md を読み込みます。ネストされた指示ファイルとリポジトリ構造も検出し、各ファイルを変更する前に適用されるルールを読み込みます。

プロジェクト、チェックアウト、ワークツリー

プロジェクトは Coding に登録したリポジトリまたはフォルダーです。チェックアウトは、1 つのタスクが実際に使用するディレクトリです。

ワークツリーモードを使わない場合、ブランチピッカーにはローカルブランチ、現在のブランチ、未コミットファイル数が表示され、ブランチの作成やチェックアウトもできます。ワークツリーモードでは、新しいタスクブランチの基点だけを選択し、ローカルチェックアウトは切り替えません。ローカル変更が上書きされる場合、Git は切り替えを拒否します。

Agent ができること

• ファイル、アーキテクチャ、型、設定、プロジェクト履歴を調査します。
• 紐付いたチェックアウト内でファイルを編集、追加、名前変更、削除します。
• ターミナルコマンド、テスト、型チェック、ビルド、プロジェクト固有の検証を実行します。
• プロジェクトに開発サーバーやプレビューコマンドがある場合、アプリケーションのプレビューと実行時動作を確認します。
• コードとともに、アルゴリズム、データフロー、障害原因、トレードオフを説明します。
• 分析だけを依頼された場合、ファイルを変更せずに既存の diff をレビューします。

Browser & Computer Use

Browser と Computer Use は 1 つの操作機能として動作します。Minara はページ構造の取得、スクリーンショット、クリック、入力、スクロール、ドラッグ、キー操作を行えます。同じセッションで操作の様子を確認できます。

• クラウド環境では、表示中のクラウドブラウザーまたはクラウドコンピューターのセッションを操作します。
• デスクトップでは、ローカルのブラウザーとコンピューター画面を操作します。
• 通常の Web ページにはページ構造を使います。キャンバス、デスクトップアプリ、信頼できるセレクターがないコントロールには視覚的なコンピューター操作を使います。

ローカルプレビューの確認、UI バグの再現、レスポンシブレイアウトの検証、ブラウザーベースの開発フローに利用できます。状態を変更した後は画面を再確認します。公開、購入、送信、削除など、外部に影響する重要な操作の前には確認を求めます。

ターンごとの変更をレビューする

Coding のターンでファイルが変更されると、応答に変更セットカードが表示されます。対象パス、追加行、削除行を確認でき、Review から diff を開けます。

ターン完了後にファイルが変更されていない場合、Undo でそのターンを復元できます。Minara は現在の内容と記録済みの変更後状態を最初に比較します。別の編集を上書きする可能性がある場合、競合として停止し、どのファイルも復元しません。

大きなファイルやバイナリファイルでは、元に戻せるテキストスナップショットが保存されないことがあります。コミット前には Git diff を正として確認してください。

安全性と Git の境界

• タスクは紐付いたチェックアウト内で動作します。範囲を広げるには明示的な指示が必要で、設定済みのフォルダー権限も適用されます。
• プロジェクトをタスクに紐付ける前に、Minara はディレクトリの読み書き権限を確認します。
• 既存のユーザー変更は保持します。Agent は無関係な整理を行いません。
• 明示的に依頼されない限り、Agent はコミット、プッシュ、ブランチの作成や切り替え、プルリクエストの作成、履歴の書き換え、変更の破棄を行いません。
• Coding は、金融操作やブラウザーおよびコンピューター上の重要な操作に対する確認ルールを回避しません。

プロンプト例

このリポジトリを調査し、アーキテクチャ、実行コマンド、主なリスクを説明してください。

分離ワークツリーを作成し、レポート画面に CSV エクスポートを実装して、関連テストを実行してください。

認証テストが失敗する根本原因を調べてください。コードを変更する前に診断結果を説明してください。

現在の diff について、正確性、セキュリティ、不足しているテストをレビューしてください。ファイルは変更しないでください。

ローカルプレビューを開いてモバイルレイアウトの不具合を再現し、修正後にデスクトップとモバイルの両方で検証してください。

次に読むページ

• コーディングタスクに引用付きの外部情報が必要な場合は、ディープリサーチを使用してください。
• 管理されたコンポーネントと公開フローを備えたライブデータダッシュボードには、Data Studioを使用してください。
• Web UI のその他の機能については、Web ダッシュボードをご覧ください。