メインコンテンツへスキップ

APIリファレンス

JARFISのスラッシュcommand、.jarfis-state.jsonスキーマ、学習ファイル構造、Phase仕様の完全リファレンス。

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

APIリファレンス

すべてのJARFIS command、状態スキーマ、設定ファイルの完全リファレンス。

スラッシュcommand

/jarfis:work

JARFISワークフローを開始する基本commandです。TriageからRetrospectiveまで全体のPhaseパイプラインを実行します。

Syntax
/jarfis:work [description]
/jarfis:work [description] --meeting [meeting-name]
Parameters
descriptionrequired実装する機能またはタスクの自然言語による説明
--meetingoptional入力コンテキストとして使用する以前の /jarfis:meeting セッション名
Examples
/jarfis:work Build a user authentication system with JWT tokens
/jarfis:work Add Stripe subscription billing --meeting billing-kickoff
/jarfis:work Fix the broken cart calculation on checkout page

/jarfis:meeting

計画と整合のための構造化されたキックオフミーティングを開始します。ミーティング結果は保存され、以降の /jarfis:work セッションで参照できます。

Syntax
/jarfis:meeting [topic]
Parameters
topicrequiredミーティングの主題またはアジェンダ
Examples
/jarfis:meeting Define the authentication strategy for the mobile app
/jarfis:meeting Decide on database schema for multi-tenant architecture

/jarfis:continue

完了したワークフローを後続タスクで引き続き進行します。以前のワークフローのブランチとartifactを再利用して効率的に後続作業を行います。

Syntax
/jarfis:continue [description]
/jarfis:continue [description] --workflow [path]
/jarfis:continue [description] --mode fix|extend
Parameters
descriptionrequired後続タスクの自然言語による説明
--workflowoptionalワークフローディレクトリのパスを直接指定
--modeoptionalモードを明示的に指定: fix（バグ修正）またはextend（機能拡張）
Examples
/jarfis:continue Add unit tests for the authentication module
/jarfis:continue Fix the token refresh edge case --mode fix
/jarfis:continue Add OAuth support --workflow .jarfis/works/2026-03-10/auth-system

/jarfis:implement

JARFISシステム自体を修正または追加する専用commandです。command、agent、内部構造を変更する際に使用します。

Syntax
/jarfis:implement [description]
Parameters
descriptionrequiredJARFISシステムの修正または追加に関する説明
Examples
/jarfis:implement Add a new /jarfis:standup command for daily status reports
/jarfis:implement Modify the QA agent to include performance testing

/jarfis:project-init

現在のコードベースを分析してプロジェクトプロファイルを生成します。プロジェクト構造、依存関係、conventionの情報が含まれた .jarfis/project-profile.md を作成します。

Syntax
/jarfis:project-init
Examples
/jarfis:project-init

/jarfis:project-update

最後の初期化以降のコードベース変更を反映して既存のプロジェクトプロファイルを更新します。

Syntax
/jarfis:project-update
Examples
/jarfis:project-update

/jarfis:health

JARFIS環境でゾンビプロセスなどの運用上の問題を診断します。

Syntax
/jarfis:health
Examples
/jarfis:health

/jarfis:upgrade

学習アイテムを管理します — 学習システムのエントリを確認、編集、整理します。

Syntax
/jarfis:upgrade
Examples
/jarfis:upgrade

/jarfis:version

JARFISのバージョン情報を表示・管理します。

Syntax
/jarfis:version
Examples
/jarfis:version

/jarfis:distill

プロンプト蒸留を実行します — プロンプトコンテンツを最適化・圧縮します。

Syntax
/jarfis:distill
Examples
/jarfis:distill

状態ファイル: .jarfis-state.json

状態ファイルは現在のワークフローの進行状況を追跡します。プロジェクトルートに配置されます。

スキーマ

{
  "work_name": "string",
  "docs_dir": "string (artifactディレクトリのパス)",
  "branch": "string (Gitブランチ名)",
  "base_branch": "string (マージ先のベースブランチ)",
  "current_phase": "number | \"done\"",
  "required_roles": {
    "backend": "boolean",
    "frontend": "boolean",
    "ux": "boolean",
    "devops": "boolean",
    "security": "boolean"
  },
  "api_spec_required": "boolean",
  "phases": {
    "T": { "status": "pending | in_progress | completed | skipped" },
    "0": { "status": "..." },
    "1": { "status": "..." },
    "2": { "status": "..." },
    "3": { "status": "..." },
    "4": { "status": "..." },
    "4.5": { "status": "..." },
    "5": { "status": "..." },
    "6": { "status": "..." }
  },
  "last_checkpoint": {
    "timestamp": "ISO 8601 文字列",
    "phase": "number",
    "summary": "string"
  },
  "meeting_ref": "string (任意, ミーティング名)",
  "meeting_dir": "string (任意, ミーティングartifactのパス)"
}

フィールドリファレンス

.jarfis-state.json フィールドリファレンス
FieldTypeDescription
work_namestring現在のワークフローの識別子
docs_dirstringartifactが保存されるパス
branchstringこのワークフローのために作成されたGitブランチ
base_branchstringマージ先のベースブランチ
current_phasenumber | "done"アクティブなPhase番号
required_rolesobjectどのAgentの役割が有効かを示すbooleanフラグ
api_spec_requiredbooleanAPI specificationドキュメントが必要かどうか
workspaceobjectプロジェクト構造のメタデータ
phasesobjectPhase別の状態(pending / in_progress / completed / skipped)
last_checkpointobject最後に保存された進行地点のタイムスタンプと要約
meeting_refstring?リンクされたミーティングへの参照(--meeting使用時)
meeting_dirstring?リンクされたミーティングのartifactへのパス

学習ファイル

グローバル学習: ~/.claude/jarfis-learnings.md

ユーザーのホームディレクトリに配置されます。すべてのプロジェクトで共有されます。主に2つのセクションを含みます:

  • Agent Hints — Retrospectiveから蓄積された行動ルールとガイドライン
  • Workflow Patterns — 一般的なシナリオに対する実証済みのパターン

このファイルは各ワークフローのPhase 0 (Pre-flight)に読み込まれます。

プロジェクトコンテキスト: .jarfis/context.md

Agentプロンプトに注入されるプロジェクト固有のコンテキストです。技術スタックの詳細、convention、ドメイン知識、統合制約を含みます。

プロジェクトプロファイル: .jarfis/project-profile.md

/jarfis:project-initによって自動生成されます。プロジェクトの構造、依存関係、ビルドツール、設定を説明します。/jarfis:project-updateで更新されます。

Phaseリファレンス

  1. Triage

    リクエスト分類 (A/B/Cタイプ決定)

  2. Pre-flight

    Git同期、ブランチ作成、学習ファイル読み込み

  3. Discovery

    POの逆質問、Working Backwards、PRD、実現可能性評価

  4. Architecture & Planning

    影響分析、システム設計、API spec（条件付き）、タスク分解、テスト戦略

  5. UX Design

    画面設計、インタラクション設計、SVG asset、デザイントークン（条件付き: UIが必要な場合のみ）

  6. Implementation

    BE/FE/DevOps並行実装（タスクがある部分のみ）

  7. Operational Readiness

    デプロイ戦略、ロールバック計画、運用準備チェック

  8. Review & QA

    API契約検証、Tech Lead + QA + Security並行レビュー

  9. Retrospective

    学習蓄積（グローバルlearnings + プロジェクトcontext）

Gateリファレンス

GATE 1

Phase 1後

承認

Phase 2に進む

修正

変更を要求して再発表

中断

ワークフローをキャンセル

GATE 2

Phase 2 & 3後

承認

Phase 4に進む

修正

変更を要求して再発表

中断

ワークフローをキャンセル

GATE 3

Phase 5後

承認

Phase 6に進む

修正後再レビュー

修正を要求し、別のレビューサイクルを開始

中断

ワークフローをキャンセル

設計再検討

Phase 2に戻り根本的な再設計を行う

参照