Architecture & Concepts

JARFIS가 AI Agent를 어떻게 구조화된 Phase로 조율하는지 — Triage부터 Retrospective까지, 모든 핵심 결정 지점에서 인간의 통제가 함께합니다.

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에서 해당 전문성이 필요할 때만 활성화됩니다. 에이전트는 네 가지 카테고리로 구성됩니다:

기획 & 설계 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 — 고급 워크플로우 패턴