Architecture & Concepts

JARFISがAI AgentをTriageからRetrospectiveまで構造化されたPhaseで調整する方法 — すべての重要な意思決定ポイントで人間の監督を伴いながら。

JARFISの哲学

JARFISは、エージェントの動作からPhase遷移まで、すべての設計決定を導く基本原則の上に構築されています。これらの原則は抽象的な理想ではなく、システムに埋め込まれた強制制約です。

9つの原則

システムのすべての設計決定を導く9つのコア原則：

生産的な緊張関係

原則間には意図的な緊張関係が存在します。このバランスがシステムを健全に保ちます：

オーケストレーションモデル

JARFISはPhase管理型オーケストレーションモデルに従います。作業は順次Phaseを経て流れ、重要な意思決定ポイントにHuman Gateが置かれます。オーケストレーターが状態遷移とエージェントの活性化を管理します。

オーケストレーションモデルの主要な特性：

• 順次Phase — 各Phaseは次が始まる前に必ず完了しなければなりません
• 条件付き実行 — Phase 3（UX）はUI変更が必要なときのみ実行され、Phase 4.5（Ops）はインフラ変更時のみ実行されます
• タイプ別ルーティング — Type A（単純修正）はPhase 4に直接進み、Type B（中規模）はPhase 1から、Type C（複雑）は全パイプラインを経由します
• Gate可逆性 — 人間はどのGateからでも作業を前のPhaseに戻せます

11のAgent役割

各エージェントは明確に定義された責任を持つ専門的な役割であり、現在のPhaseが必要とする専門知識が求められるときにのみ活性化されます。エージェントは4つのカテゴリに整理されます：

計画 & 設計 Agent

実装 Agent

品質 & レビュー Agent

弁証法 Agent

9段階 Phase パイプライン

Phase別の責任とGate位置を含む全パイプライン：

状態管理

JARFISは以下を追跡する構造化された状態ファイルでワークフローの状態を維持します：

• 現在のPhase — 現在実行中のPhase
• Phase出力物 — 各完了Phaseが生成した成果物
• Gate決定 — タイムスタンプとともに記録された各Gateでの人間の決定
• エージェント活性化 — 活性化されたエージェントとその出力物
• 回復チェックポイント — 中断されたワークフローの再開のためのスナップショット

状態はプロジェクト内の.jarfis/ディレクトリにJSONファイルとして保存されます。これにより中断後もワークフローを回復でき、中断した正確な地点から再開できます。

学習システム

JARFISは継続的な改善を可能にする3ブロックの学習アーキテクチャを実装しています：

• グローバル学習 — プロジェクトを横断するパターン、ベストプラクティス、アンチパターン。Phase 0で読み込まれ、Phase 6で更新されます。
• プロジェクトコンテキスト — プロジェクト固有の規約、技術スタックの決定、アーキテクチャパターン。同一プロジェクト内のワークフロー全体を通じて保持されます。
• ワークフローメモリ — 現在のワークフロー状態、下された決定、根拠。一時的 — ワークフローの期間のみ存在します。

このアーキテクチャにより、JARFISは時間が経つほど向上します — 過去の失敗と成功から学び、あなたの特定のプロジェクトコンテキストに合わせて推奨を調整します。

次のステップ

• Quick Start — JARFISをインストールして最初のワークフローを実行
• API Reference — すべてのコマンドと設定の詳細
• Guides & Customization — 高度なワークフローパターン