Guides & Customization

JARFISの高度なパターン：Meeting-to-Work連携、role設定、プロジェクトプロファイル、Gate活用、学習システム管理、ワークフロー復旧。

最終更新: Sun Mar 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

JARFISの高度なパターンをマスターしましょう — ミーティングと作業項目の連携から、エージェントの役割のカスタマイズ、Gate管理、中断からの復旧まで。

Meeting-to-Work連携

JARFISはミーティングの成果を開発ワークフローに直接連結します。まずミーティングを実行して構造化された出力を生成し、その出力をworkコマンドに連結することで、パイプライン全体が完全なコンテキストを持ってスタートします。

/jarfis:meetingsummary.md + decisions.md + meeting-notes.md/jarfis:work --meetingPhase 0でミーティングコンテキストを読み込み

ステップバイステップ

トピックとともにミーティングコマンドを実行します：

/jarfis:meeting Define the authentication strategy for the mobile app

実行結果としてsummary.md、decisions.md、meeting-notes.mdが生成されます。

--meetingフラグでミーティング出力物をworkコマンドに連結します：

/jarfis:work Implement mobile auth with biometric login --meeting auth-strategy-meeting

Phase 0（Pre-flight）が自動的にミーティングコンテキストを読み込みます。以降すべてのPhaseのエージェントがミーティングで決定された事項を参照します。

ヒント： --meetingフラグはミーティング出力物ディレクトリを参照します。Phase 0がすべてのミーティング成果物を読み込むため、パイプラインのすべてのエージェントが議論された決定と制約にアクセスできます。

Role設定

JARFISは.jarfis-state.jsonのrequired_rolesフィールドを使用して、ワークフローで有効なエージェントの役割を決定します。どのPhaseを実行するか、Phase 4での並行作業をどのように分散するかを制御します。

{
  "required_roles": {
    "backend": true,
    "frontend": true,
    "ux": false,
    "devops": false,
    "security": true
  }
}

Frontend Only

Phase 3（UX）が有効、Phase 4はFE実装のみ実行

backend:false

frontend:true

ux:true

devops:false

security:false

Full Stack + Security

すべてのPhaseが有効、Phase 4はBE/FE/DevOpsが並行実行

backend:true

frontend:true

ux:true

devops:true

security:true

Backend API Only

Phase 3（UX）をスキップ、Phase 4はBE + DevOpsのみ実行

backend:true

frontend:false

ux:false

devops:true

security:true

注意： JARFISはPhase T（Triage）中に作業の説明とプロジェクト構造に基づいて役割を自動的に決定します。Gate 1の承認前に.jarfis-state.jsonを編集して上書きできます。

完了したワークフローの継続

/jarfis:continueを使用して、完了したワークフローを基に作業を続けられます — テストの追加、エッジケースの修正、スコープの拡張など、ゼロから始めることなく。

/jarfis:continue Add unit tests for the auth module
/jarfis:continue Fix the token refresh edge case --mode fix

Fix Mode

TriageとDiscoveryをスキップします。ピンポイントの修正のためにImplementation Phaseに直接進みます。

--mode fix

Extend Mode

Triageはスキップしますが、新しい追加作業のスコープを適切に把握するためにDiscoveryは実行します。

--mode extend

--workflow pathで特定の過去のワークフローの出力物をターゲットにして継続することもできます。

プロジェクトプロファイル

プロジェクトプロファイルはJARFISがコードベースを完全に理解できるようにします — リポジトリ構造、依存関係、ビルドツール、規約まで — すべてのワークフローが正確なプロジェクトコンテキストとともに始まります。

1
/jarfis:project-init — リポジトリ構造、依存関係、ビルドツール、規約を分析して.jarfis/project-profile.mdを生成します。
2
/jarfis:project-update — プロジェクトが進化した際に、手動で追加したコンテキストを維持しながらプロファイルを更新します。

ヒント： リポジトリにJARFISを初めて設定する際に/jarfis:project-initを一度実行し、主要な依存関係や構造の変更後には/jarfis:project-updateを使用してください。

Gateの活用

Gateは人間による監視の主要なメカニズムです。各Gateはワークフローの方向を制御するための具体的なアクションを提供します。

Gate 1 — Phase 1（Discovery）の後

PRD、実現可能性分析、スコープ定義を確認します。方向転換のコストが最も低いポイントです。

承認修正中断

Gate 2 — Phase 2 & 3（Architecture + UX）の後

アーキテクチャの決定、タスク分解、UXデザインを確認します。tasks.mdを丁寧にチェックしてください — 抜け落ちたタスクは後で抜け落ちた機能になります。

承認修正中断

Gate 3 — Phase 5（Review & QA）の後

すべての実装、テスト結果、セキュリティの発見事項を確認します。「設計再検討」は根本的なアーキテクチャの問題がある場合にPhase 2に戻します。

承認修正後再レビュー中断設計再検討

重要： Gate 1での数分の検討がGate 3での数時間を節約します。早期の軌道修正は遅いものより格段に安上がりです。各Gateで十分に確認してください。

学習システムの管理

JARFISは蓄積されたプロジェクト知識を通じて出力品質を継続的に向上させる2段階の学習システムを運用しています。

Global

グローバル学習

~/.claude/jarfis-learnings.mdに保存されます。すべてのプロジェクトで共有されるAgent HintsとWorkflow Patternsを含みます。

Project

プロジェクトコンテキスト

.jarfis/context.mdに保存されます。このプロジェクトに固有の技術スタック、規約、ビジネスドメイン、統合制約。

学習サイクル

Phase 6 (Retro)learnings.mdPhase 0 (Pre-flight)エージェントが参照より良い出力

context.mdの例

# Project Context
## Tech Stack
- Frontend: Next.js 15, TypeScript strict, Tailwind CSS 4
- Backend: FastAPI (Python 3.12), PostgreSQL 16, Redis
## Conventions
- API responses follow RFC 9457 Problem Details format
- All database models use UUID primary keys
- Commit format: conventional commits

/jarfis:upgradeを使用して学習項目を整理しましょう — 保持、編集、削除で品質を維持します。

コンテキスト圧縮後のワークフロー復旧

JARFISは.jarfis-state.jsonを通じてPhaseと進行状態をディスクに保存します。特別な再開コマンドは不要です — システムが中断されたワークフローを自動的に検出して再開します。

1
セッション終了 — 接続断、タイムアウト、またはコンテキスト圧縮
2
/jarfis:workを再実行 — 前回と同じ作業説明を使用
3
JARFISが既存の状態ファイルを検出 — 進行中のワークフローがある.jarfis-state.jsonを発見
4
最後のチェックポイントから再開 — 前のセッションが中断した正確な地点から作業を再開

ポイント： 特別な再開コマンドはありません。同じ説明で/jarfis:workを実行するだけで、JARFISが保存された状態ファイルを通じて自動的に復旧を処理します。

JARFIS自体の修正

JARFIS自体を修正または拡張したい場合 — 新しいコマンドの追加、エージェントの動作変更、パイプライン構造の更新 — /jarfis:implementを使用してください。

/jarfis:implement Add a /jarfis:standup command for daily status reports

仕組み： /jarfis:implementはJARFISのシステム構造を理解し、プロンプトテンプレート、コマンド定義、Phaseハンドラー、ドキュメントなど影響を受けるすべてのファイルに変更を適用します。

実践的な例

一般的な開発シナリオに対する実際の使用パターン：

例 1 — フロントエンド専用の作業

/jarfis:work Redesign the dashboard with new chart components

Triageがfrontend + UXの役割を有効化します。Phase 3（UX Design）が実行され、Phase 4はFE実装のみを行います。

例 2 — ミーティングを活用したフルスタック作業

/jarfis:meeting Plan the multi-tenant architecture migration

/jarfis:work Implement multi-tenant data isolation --meeting tenant-architecture

ミーティングで決定事項と制約を整理します。workコマンドがミーティング出力物を連結し、完全なコンテキストでパイプラインを実行します。

例 3 — クイックフィックス

/jarfis:work Fix the broken pagination on the orders list

Triageが単純な修正として分類します。最小限の手順で合理化されたパイプラインで進行します。

例 4 — 完了した作業の継続

/jarfis:continue Add internationalization support to the auth module

以前に完了したワークフローを継続します。既存のコンテキストを維持しながら新しいDiscoveryパスでスコープを拡張します。

例 5 — 状態確認

/jarfis:health

ゾンビプロセス、古い状態ファイル、その他のワークフロー健全性の問題を診断します。

次のステップ

API Reference — 完全なコマンドと設定のリファレンス
Architecture & Concepts — オーケストレーションモデルの詳細解説
Quick Start — インストールと最初のワークフロー