Reasonix Vs HagiCode

主な機能

Reasonix CLI の強みは、制御可能な推論と検査可能な実行を中心に構成されています：

推論努力の制御：Reasonix は effort 設定を公開しており、タスクにどれだけの推論の深さを与えるかを決められます。迅速な実装作業と、より遅く慎重な技術分析を区別したい場合に有用です。

予算と積極性のガードレール：Reasonix は budgetUsd や enableYolo などの制御を備え、タスクがどれだけ探索的であるべきか、あるいは制約されるべきかに応じて、コスト意識と実行の大胆さのバランスを取れます。

トランスクリプトフレンドリーなワークフロー：Reasonix は指定されたパスにトランスクリプト出力を書き込め、コーディングのターンがどう展開したかを後から保存、監査、レビューしやすくなります。

技術アーキテクチャ

Reasonix にはいくつか注目すべきアーキテクチャ上の特徴があります：

ACP を基盤としたトランスポート：HagiCode Core では、Reasonix は共有の ACP ベースのランタイムを通じて統合されており、標準化されたエージェントトランスポートモデルの中でストリーミング出力、ツール呼び出し、システムメッセージのサポートを備えています。

リクエストをまたぐセッションの再バインド：Reasonix は、ルーティングコンテキストが一致する場合、後続のターンを既存のプロバイダーセッションに再バインドでき、すべてのリクエストをコールドスタートさせるのではなく、長時間のタスクの継続性を保ちます。

ランタイムのチューニング面：startupTimeoutMs と追加の引数は、プロバイダーを異なる環境、実行速度、ラッパーの規約に適応させる必要があるチームに、実用的なチューニング層を提供します。

ワークフローと統合モデル

Reasonix のエコシステムの価値は、派手なパッケージではなく、規律ある CLI 運用から生まれます：

推論ファーストのワークフロー適合：Reasonix は、常に生の速度を最大化するのではなく、慎重な計画、レビュー可能な意思決定、明示的な運用制約を重視するチームに適しています。

トランスクリプトと監査のサポート：トランスクリプトの捕捉がランタイム面の一部であるため、Reasonix は、即時の答えと同じくらい説明可能性や後からのレビューが重要なワークフローに適合します。

モデルとルートの柔軟性：Reasonix はワークフローを一つのプロバイダー経路に固定せず、モデルの選択を設定可能なまま保ち、コスト、品質、ポリシーの要件が変化した際の適応を容易にします。

マルチスレッド並列：複数の Reasonix の推論トラックを並行して走らせる

Reasonix は一つのセッションの中で多くのことをこなせますが、実際の納品は一つのタスクずつ行われることはほとんどありません。

HagiCode は複数の Reasonix セッションを並列実行でき、それぞれが隔離されたコンテキスト、明確な責任の境界、独立した進捗を持ちます。

これにより、Reasonix は慎重な単一レーンの CLI から、複数の推論スレッドが一緒に前進できる協調されたエンジニアリング面へと変わります。

• スレッド A はバックエンドの API エンドポイントをブラッシュアップ;
• スレッド B はフロントエンドのコンポーネントをリファクタリング;
• スレッド C はユニットテストを記述;
• スレッド D はセキュリティ脆弱性のコード監査を実施。

OpenSpec 提案セッション：努力と予算の選択を文書化された提案に結びつける

日常の開発で最もよくある混乱は、コードが書けないことではなく、あれこれ変更した結果、なぜ変更したのか、何を変更したのか、変更同士がどう関連しているのかを忘れてしまうことです。

HagiCode に組み込まれた OpenSpec 提案ワークフローは、この問題を根本から解決します。すべての開発タスクは提案として起動されます：

この構造は、Reasonix に、実装の意思決定だけでなく、なぜ特定の努力レベル、予算上限、実行スタイルがそのタスクに選ばれたのかを記録する場所を与えます。

• まず、このタスクがどんな問題を解決するのか、なぜこの方法が理にかなっているのかを書き出します;
• 提案の枠組みの中で Reasonix と技術方針を深く議論します。すべての会話と意思決定は提案の文脈に記録されます;
• 方針が確定したら、Reasonix は提案の制約の中でコードを実装します;
• 最終的な提案ドキュメント、議論の記録、コード変更が完全な追跡チェーンを形成します。

AI コミット：Reasonix の出力をクリーンなコミット履歴に変える

コードを書き終えた後にコミットメッセージを書くのは、多くの開発者にとって精神的な摩擦になります。雑に書けば後で重要なコミットを見つけられず、きっちり書けば時間の無駄に感じます。

HagiCode の AI コミット機能はこれを完全に Reasonix に任せます。コードの変更を分析し、意図と影響範囲を理解した上で、構造が明確で意味的に正確なコミットメッセージを自動生成します。さらに重要なことに、AI コミット中は HagiCode がリポジトリを自動的にロックし、並行操作による状態の衝突を防ぎ、安全で信頼できるコミットを実現します。

注意力は創造のためにとっておき、コミットの事務作業は Reasonix に任せましょう。

Code Server ブラウザエディタ：推論トランスクリプトから正確なファイル編集へ

Reasonix がコードを分析し、問題のあるファイルを特定し、該当行まで示してくれた後、おなじみの気まずい瞬間が訪れます。AI の対話ウィンドウを離れ、IDE に戻り、またファイルを探し、手動で正しい位置までジャンプしなければなりません。この分析から編集への文脈の断絶は、流れを中断するだけでなく、AI の価値を「問題の場所を教える」止まりにしてしまい、「直接編集モードに入るのを助ける」まで届きません。

HagiCode に組み込まれた Code Server ベースのブラウザエディタは、まさにこの断絶を解消するために設計されています：

Code Server の統合により、HagiCode はコードを分析できるフロントエンドページにとどまらず、Reasonix の分析が直接編集アクションとして着地する完全なワークステーションになります。AI 分析と実際の編集のあいだのツール切り替えコストを最小化します。

• 分析から編集へワンクリック：Reasonix が提案の中で変更が必要なファイルを特定したら、HagiCode はそのファイルをワークベンチで直接開いて編集できます。
• ローカル、コンテナ、リモートを完全カバー：プロジェクトがローカル、コンテナ、リモートマシンのいずれで動いていても、HagiCode のエディタ面は推論の流れを実際のコードのそばに保ちます。
• Vault の直接編集：Reasonix がレビューや計画作業で指し示した際、サポートする参照資料やアーカイブされたプロジェクトのナレッジを直接開けます。

Preset Task：繰り返しの Reasonix のレビューと計画のワークフローをテンプレ化

Reasonix は繰り返しのレビュー、計画、監査スタイルのタスクに特に有用ですが、毎回同じ努力設定、ガードレール、指示を手作業で再組み立てするのは無駄です。

HagiCode の Preset Task 機構は、こうした繰り返しのワークフローを再利用可能なテンプレートに変えます。単なるショートカットコマンドではなく、拡張可能な Skills 統合プラットフォームです：

Preset Task は、Reasonix との協業を「毎回プロセスを言い直す」ものから「用意されたプロセスを起動して成果に集中する」ものへとアップグレードします。

• すぐ使えるコミュニティ Skills：すべてのワークフローをゼロから設計するのではなく、既存のレビュー、ドキュメント、リファクタ、納品のテンプレートから始められます。
• 拡張可能な Skills システム：共有テンプレートの上に、チーム固有のチェックリスト、監査の期待値、推論のデフォルトを追加できます。
• 視覚的な操作、ターミナルの反復ではなく：プロセス全体を CLI の反復する筋記憶にエンコードするのではなく、目的に特化したインターフェースからワークフローを選び、パラメータを調整し、起動できます。

ゲーム化インターフェース：努力、予算、進捗を読みやすく

プログラミング自体は退屈にもなりますが、楽しくもなれます。HagiCode のゲーム化されたインターフェース設計は、コマンドラインツールの冷たい体験から脱却します：

Reasonix が規律ある推論を、HagiCode が体験を提供する。両者が組み合わさることで、厳格なターミナルワークフローを、進捗、マイルストーン、運用状態が見え続けるワークスペースへと変えます。

• 明確な視覚的フィードバック：生のターミナルテキストを漁ることなく、何が実行中か、待機中か、ブロックされているか、完了したかを見られます。
• 達成と進捗の可視化：提案、コミット、納品のチェックポイントが、隠れた背景状態ではなく、目に見えるマイルストーンになります。
• より低い認知負荷：周囲のワークスペースが自分の位置の把握を助けてくれると、努力設定や長時間の推論作業がより管理しやすく感じられます。

Agents 管理：複数の Reasonix ワーカーを Agent フリートとして協調

並列セッションは便利ですが、複数同時に動かすようになると、次は連携がボトルネックになります。

HagiCode の Agents 管理層は、各 Reasonix ワーカーを、可視のステータス、割り当てられたスコープ、独立した設定を持つ名前付きでスケジュール可能な Agent に変えます。

「たくさんのターミナルが開いている」状態から「小さな AI チームを一カ所で連携している」状態へと移行します。

• Agent のアイデンティティとステータスの可視化：どの Agent が実行中か、待機中か、ブロックされているか、アーカイブ可能かを一目で確認できます。
• タスクと Agent のバインディング：提案、レビュー、リファクタリング、テスト作業をそれぞれ専用の Agent に割り当てられます。
• 独立した Agent 設定：異なる Agent が、互いに干渉することなく異なる努力レベル、モデルルート、Skills、コンテキスト範囲を使用できます。

Monospecs マルチリポジトリ管理：Reasonix にリポジトリの境界をまたいで推論させる

実際のプロジェクトでは、コードが単一のリポジトリに収まることは稀です。フロントエンド、バックエンド、ドキュメント、共有ライブラリは異なるリポジトリに分散しており、一つの機能変更で複数のリポジトリを同時に触る必要が生じることもあります。Reasonix にとってシングルリポジトリモードは機能しますが、リポジトリ間の関係を本来は理解しておらず、毎回の会話で「この変更はあと 2 つのリポジトリにも同期が必要」と手動で伝えなければならず、明らかに非効率です。

HagiCode の Monospecs 機構は、マルチリポジトリシナリオのために設計された構造化されたソリューションです。.hagicode/monospecs.yaml 設定ファイルを通じて、プロジェクト群のすべてのサブリポジトリのアドレス、名前、関係を宣言し、提案を起動する際に Reasonix に自動的にリポジトリ間の地図を提供します：

Monospecs は Reasonix をより有用にします。慎重な推論は、一度に一つのリポジトリではなく変更面の全体を見られるようになると、遥かに価値を増すからです。

• 自動的なリポジトリ関係の認識：Reasonix は繰り返しの手動ブリーフィングに頼るのではなく、Monospecs からリポジトリグラフを直接読み取れます。
• リポジトリ間の変更追跡：仕様は一カ所に集約され、実装は適切なリポジトリに留まり、クリーンな意思決定チェーンを保ちます。
• AI コミットの賢い送り先判定：HagiCode はリポジトリの地図に基づいて、各変更をどこにコミットすべきかを提案します。
• リポジトリごとの AGENTS.md：Reasonix は異なるコードベースを移動する際、リポジトリ固有のガイダンスを自動的に取得します。

Vault クロスプロジェクトのナレッジベース：Reasonix が再学習すべきでないコンテキストを永続化

Reasonix は深く推論できますが、新しいタスクが始まるたびにプロジェクトの歴史、参照、過去の結論を再発見する必要はありません。

Vault は HagiCode のクロスプロジェクトな永続ナレッジ層です。中核の設計思想は「一度登録すれば、どこでも再利用」です：

Monospecs が Reasonix に物事がどこにあるかを伝えるものだとすれば、Vault は Reasonix にあなたのチームが既に知っていることを伝えます。これが、慎重な推論を累積的なエンジニアリングのレバレッジに変えるものです。

• 複数タイプのナレッジコンテナ：フォルダ、コード参照、Obsidian ノート、システム管理の資産を一つの共有記憶層に登録できます。
• 自動的な AI コンテキスト注入：新しい提案は、Reasonix に適切な背景資料が既に利用可能な状態で始まります。
• きめ細かいアクセス制御：読み取り専用の参照と編集可能な作業空間を分離し、AI が安全に編集しながら広く検査できるようにします。
• クロスプロジェクトのナレッジ再利用：一度捕捉した結論と参照は、繰り返し再組み立てすることなく、その後のすべての提案を支えられます。

OmniRoute モデルルーティング：モデルルートが変わっても Reasonix のワークフローを安定に保つ

チームは、信頼する推論ワークフローを、一つのプロバイダー経路やサブスクリプションの選択に恒久的に縛ることなく保てるべきです。

OmniRoute はインタラクション層とモデルルーティング層を分離し、HagiCode はワークフローに Reasonix を残したまま、その下でモデルソースを切り替えられます。

これにより、より良いコスト管理、より良いタスクとモデルの適合、そしてモデルの価格や可用性が変化した際のワークフローの混乱の減少が得られます。

• 既に好みの CLI やインタラクションスタイルを維持しつつ、その下のモデルルートだけを変更できます。
• 一つのルーティング戦略を、HagiCode に接続された複数の Agent と複数の AI ツールで共有できます。
• 迅速な実装、深いレビュー、アーキテクチャ計画など、異なるワークロードに異なるモデルルートを調整できます。
• 個々のワークフローを作り直すのではなく、ルーティング層で一度コストと能力を調整できます。