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 — 설치 및 첫 워크플로우