API Reference
JARFIS 슬래시 명령어, .jarfis-state.json 스키마, 학습 파일 구조, Phase 명세 완전 참고서.
최종 업데이트: Sun Mar 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
API Reference
모든 JARFIS 명령어, 상태 스키마, 설정 파일에 대한 완전한 참고서.
슬래시 명령어
/jarfis:work
JARFIS 워크플로우를 시작하는 기본 명령어입니다. Triage부터 Retrospective까지 전체 Phase 파이프라인을 실행합니다.
/jarfis:meeting
계획 및 정렬을 위한 구조화된 킥오프 미팅을 시작합니다. 미팅 결과는 저장되어 이후 /jarfis:work 세션에서 참조할 수 있습니다.
/jarfis:continue
완료된 워크플로우를 후속 태스크로 이어서 진행합니다. 이전 워크플로우의 브랜치와 산출물을 재활용하여 효율적으로 후속 작업을 수행합니다.
/jarfis:implement
JARFIS 시스템 자체를 수정하거나 추가하는 전용 명령어입니다. 명령어, Agent, 내부 구조를 변경할 때 사용합니다.
/jarfis:project-init
현재 코드베이스를 분석하여 프로젝트 프로파일을 생성합니다. 프로젝트 구조, 의존성, 컨벤션 정보가 담긴 .jarfis/project-profile.md를 생성합니다.
/jarfis:project-update
마지막 초기화 이후 코드베이스 변경 사항을 반영하여 기존 프로젝트 프로파일을 갱신합니다.
/jarfis:health
JARFIS 환경에서 좀비 프로세스 및 기타 운영 이슈를 진단합니다.
/jarfis:upgrade
학습 항목을 관리합니다 — 학습 시스템의 항목을 검토, 편집, 정리합니다.
/jarfis:version
JARFIS 버전 정보를 표시하고 관리합니다.
/jarfis:distill
프롬프트 증류를 수행합니다 — 프롬프트 내용을 최적화하고 압축합니다.
상태 파일: .jarfis-state.json
상태 파일은 현재 워크플로우 진행 상황을 추적합니다. 프로젝트 루트에 위치합니다.
스키마
{
"work_name": "string",
"docs_dir": "string (산출물 디렉토리 경로)",
"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",
"workspace": {
"type": "\"monorepo\" | \"multi-project\"",
"projects": ["string (프로젝트 경로)"]
},
"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 (선택사항, 미팅 산출물 경로)"
}필드 레퍼런스
학습 파일
전역 학습: ~/.claude/jarfis-learnings.md
사용자 홈 디렉토리에 위치합니다. 모든 프로젝트에서 공유됩니다. 두 가지 주요 섹션을 포함합니다:
- Agent Hints — Retrospective에서 축적된 행동 규칙 및 가이드라인
- Workflow Patterns — 검증된 일반적인 시나리오 패턴
이 파일은 모든 워크플로우의 Phase 0 (Pre-flight) 동안 로드됩니다.
프로젝트 컨텍스트: .jarfis/context.md
Agent 프롬프트에 주입되는 프로젝트별 컨텍스트입니다. 기술 스택 세부 사항, 컨벤션, 도메인 지식, 통합 제약 사항을 포함합니다.
프로젝트 프로파일: .jarfis/project-profile.md
/jarfis:project-init으로 자동 생성됩니다. 프로젝트의 구조, 의존성, 빌드 도구, 설정을 설명합니다. /jarfis:project-update로 갱신됩니다.
Phase 레퍼런스
Triage
요청 분류 (A/B/C 유형 결정)
Pre-flight
Git 동기화, 브랜치 생성, 학습 파일 로드
Discovery
PO 역질문, Working Backwards, PRD, 타당성 평가
Architecture & Planning
영향 분석, 시스템 설계, API spec (조건부), 태스크 분해, 테스트 전략
UX Design
화면 설계, 인터랙션 설계, SVG 에셋, 디자인 토큰 (조건부: UI 필요 시에만)
Implementation
BE/FE/DevOps 병렬 구현 (태스크가 있는 부분만)
Operational Readiness
배포 전략, 롤백 계획, 운영 준비 상태 점검
Review & QA
API 계약 검증, Tech Lead + QA + Security 병렬 리뷰
Retrospective
학습 축적 (전역 학습 + 프로젝트 컨텍스트)
Gate 레퍼런스
Phase 1 이후
Phase 2로 진행
변경 요청 후 재발표
워크플로우 취소
Phase 2 & 3 이후
Phase 4로 진행
변경 요청 후 재발표
워크플로우 취소
Phase 5 이후
Phase 6으로 진행
수정 요청 후 리뷰 사이클 재시작
워크플로우 취소
Phase 2로 복귀하여 근본적 재설계
참고
- Quick Start — 설치 및 첫 워크플로우 실행
- Architecture & Concepts — 오케스트레이션 모델 심층 분석
- Guides & Customization — 고급 워크플로우 패턴