J.A.R.V.I.S. - Intelligent Autonomous Orchestration

JikiME-ADK의 지능형 자율 오케스트레이션 시스템. Iron Man의 AI 비서에서 영감을 받은 선제적이고 적응적인 개발 자동화.

Overview

J.A.R.V.I.S. (Just A Rather Very Intelligent System)는 JikiME-ADK의 개발 전담 지능형 오케스트레이터입니다. 단순 명령 실행이 아닌 예측하고, 적응하고, 학습하는 자율 시스템으로, 마이그레이션은 파트너 오케스트레이터인 F.R.I.D.A.Y.가 담당합니다.

핵심 철학

"I'm not just following orders, sir. I'm anticipating your needs."

기존 오케스트레이터와의 차별점

기능	기존 오케스트레이터	J.A.R.V.I.S.
탐색	3개 에이전트 병렬	5개 에이전트 + 의존성 분석
계획	단일 전략	멀티 전략 비교 후 최적 선택
실행	순차/병렬 고정	상황 적응형 동적 전환
에러 처리	단순 재시도	자가 진단 + 대안 전략 피봇
학습	없음	세션 내 패턴 학습
예측	없음	다음 단계 선제 제안

Architecture

시스템 구조

┌─────────────────────────────────────────────────────────────────┐
│                    J.A.R.V.I.S. System                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Phase 0: Proactive Intelligence Gathering                      │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐│
│  │ Explore  │ │ Research │ │ Quality  │ │ Security │ │  Perf  ││
│  │  Agent   │ │  Agent   │ │  Agent   │ │  Agent   │ │ Agent  ││
│  └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ └───┬────┘│
│       └────────────┴────────────┼────────────┴───────────┘     │
│                                 ▼                               │
│                    ┌────────────────────┐                       │
│                    │ Integration Engine │                       │
│                    │  + Dependency Map  │                       │
│                    │  + Risk Assessment │                       │
│                    └─────────┬──────────┘                       │
│                              ▼                                  │
│  Phase 1: Multi-Strategy Planning                               │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────┐            │
│  │ Strategy A   │ │ Strategy B   │ │ Strategy C   │            │
│  │ Conservative │ │  Balanced    │ │  Aggressive  │            │
│  └──────┬───────┘ └──────┬───────┘ └──────┬───────┘            │
│         └────────────────┼────────────────┘                    │
│                          ▼                                      │
│                ┌──────────────────┐                             │
│                │ Trade-off Matrix │                             │
│                │ Optimal Selection│                             │
│                └────────┬─────────┘                             │
│                         ▼                                       │
│  Phase 2: Adaptive DDD Implementation (Ralph Loop)              │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  WHILE (issues_exist AND iteration < max):              │   │
│  │    ├── LSP Quality Gate (baseline capture/compare)      │   │
│  │    ├── Diagnostics (LSP + Tests + Coverage)             │   │
│  │    ├── Self-Assessment: "Is approach working?"          │   │
│  │    │   ├── YES → Continue                               │   │
│  │    │   ├── REGRESSION → Ralph alerts → Pivot            │   │
│  │    │   └── NO  → Pivot Strategy                         │   │
│  │    ├── Expert Agent Delegation                          │   │
│  │    └── Verification (zero errors required)              │   │
│  └─────────────────────────────────────────────────────────┘   │
│                         ▼                                       │
│  Phase 3: Completion & Prediction                               │
│  ┌──────────────┐ ┌──────────────────────┐                     │
│  │  Doc Sync    │ │ Predictive Suggest   │                     │
│  │ manager-docs │ │ "You might also..."  │                     │
│  └──────────────┘ └──────────────────────┘                     │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

파일	설명
`templates/.claude/commands/jikime/jarvis.md`	J.A.R.V.I.S. 슬래시 커맨드
`templates/.claude/commands/jikime/friday.md`	F.R.I.D.A.Y. 슬래시 커맨드
`templates/CLAUDE.md`	듀얼 오케스트레이터 등록
`templates/.jikime/config/quality.yaml`	LSP Quality Gates 설정
`docs/friday.md`	F.R.I.D.A.Y. 마이그레이션 오케스트레이터 문서
`docs/migration.md`	마이그레이션 시스템 문서

Dual Orchestrator Architecture

듀얼 오케스트레이션 체계

JikiME-ADK는 두 개의 전문 오케스트레이터로 역할을 분리합니다:

Orchestrator	역할	명령어	담당 영역
J.A.R.V.I.S.	개발	`/jikime:jarvis`	새 기능 구현, 리팩토링, 버그 수정
F.R.I.D.A.Y.	마이그레이션	`/jikime:friday`	레거시 → 현대 프레임워크 전환

마이그레이션 관련 상세 문서는 docs/friday.md 및 docs/migration.md를 참조하세요.

라우팅 로직

IF migration keywords detected (migrate, convert, legacy, transform):
    → F.R.I.D.A.Y. 활성화
ELIF development keywords detected (implement, build, fix, refactor):
    → J.A.R.V.I.S. 활성화
ELSE:
    → 기본값: J.A.R.V.I.S.

Usage

기본 사용법

bash

# 지능형 자율 실행
/jikime:jarvis "Add JWT authentication"

# 안전 전략 (보수적 접근)
/jikime:jarvis "Refactor payment module" --strategy safe

# 빠른 전략 (공격적 접근)
/jikime:jarvis "Fix typo in README" --strategy fast

# 자동 루프 활성화
/jikime:jarvis "Implement user dashboard" --loop --max 20

# 이전 작업 재개
/jikime:jarvis resume SPEC-AUTH-001

명령어 옵션

옵션	설명	기본값
`--strategy`	실행 전략: auto, safe, fast	auto
`--loop`	에러 자동 수정 반복 활성화	config
`--max N`	최대 반복 횟수	50
`--branch`	피처 브랜치 자동 생성	config
`--pr`	완료 시 PR 자동 생성	config
`--resume SPEC`	이전 작업 재개	-

Intelligence Features

1. Proactive Intelligence Gathering (Phase 0)

5개의 전문 에이전트가 동시에 분석을 수행합니다:

에이전트	역할	출력
Explore Agent	코드베이스 구조, 아키텍처 패턴 분석	관련 파일 목록, 의존성 맵
Research Agent	외부 문서, 라이브러리 베스트 프랙티스	구현 패턴, API 레퍼런스
Quality Agent	테스트 커버리지, 코드 품질 베이스라인	품질 메트릭, 기술 부채 평가
Security Agent	잠재적 보안 영향 사전 스캔	보안 고려사항, OWASP 체크리스트
Performance Agent	성능 영향 예측 분석	병목 위험, 최적화 기회

2. Multi-Strategy Planning (Phase 1)

모든 작업에 대해 2-3개의 접근 전략을 생성하고 비교합니다:

전략 유형

전략	리스크	속도	되돌리기	테스트 커버리지
Conservative	낮음	느림	쉬움	100%
Balanced	중간	중간	중간	85%
Aggressive	높음	빠름	어려움	70%

자동 전략 선택 알고리즘

IF risk_score > 70:
    SELECT Conservative (안전 우선)
ELIF risk_score > 40:
    SELECT Balanced (균형)
ELSE:
    SELECT Aggressive (속도 우선)

OVERRIDE: --strategy 플래그로 수동 지정 가능

3. Adaptive Execution (Phase 2)

LSP Quality Gates

Phase 2 실행 중 LSP 기반 품질 게이트가 자동으로 적용됩니다:

Phase	조건	설명
plan	`require_baseline: true`	Phase 시작 시 LSP 베이스라인 캡처
run	`max_errors: 0`	에러/타입에러/린트에러 모두 0 필요
sync	`require_clean_lsp: true`	PR/Sync 전 LSP 클린 상태 필수

설정 위치: .jikime/config/quality.yaml → constitution.lsp_quality_gates

Ralph Loop 통합

J.A.R.V.I.S.의 자가 진단 루프는 LSP Quality Gates와 통합됩니다:

Ralph Loop Cycle:
  1. Code Transformation (에이전트 작업 수행)
  2. LSP Diagnostic Capture (변환 후 진단)
  3. Regression Check (베이스라인 대비 비교)
  4. Decision: Continue or Pivot

LSP regression이 감지되면 J.A.R.V.I.S.는 자동으로 피봇을 고려합니다.

자가 진단 루프

매 반복마다 J.A.R.V.I.S.는 스스로 질문합니다:

"현재 접근법이 진전을 보이고 있는가?"
- 에러 수가 줄어들고 있는가?
- 테스트 통과율이 개선되고 있는가?
- LSP 진단 결과가 개선되고 있는가?
"다른 전략으로 전환해야 하는가?"
- 트리거: 3회 연속 개선 없음
- 트리거: LSP regression 감지
- 행동: 대안 전략으로 피봇
"이전에 본 패턴인가?"
- 세션 내 유사 에러 패턴 확인
- 학습된 해결책 즉시 적용

피봇 결정 트리

IF no_progress_count >= 3:
    IF current_strategy == "aggressive":
        PIVOT → "balanced"
    ELIF current_strategy == "balanced":
        PIVOT → "conservative"
    ELSE:
        REQUEST → user_intervention

4. Predictive Suggestions (Phase 3)

완료된 작업을 기반으로 다음 단계를 예측하고 제안합니다:

markdown

## Completed: JWT Authentication

### Predictive Suggestions

Based on this implementation, you might also want to:

1. **Add refresh token mechanism** - JWT 토큰 만료 시 세션 연장
2. **Implement rate limiting** - 인증 엔드포인트 무차별 공격 방지
3. **Add password reset flow** - 인증과 짝을 이루는 일반적인 기능
4. **Set up audit logging** - 보안을 위한 인증 이벤트 추적

Would you like me to start any of these?

Strategy Details

auto (기본값)

J.A.R.V.I.S.가 작업 복잡도를 분석하여 최적 전략을 자동 선택:

작업 유형	분석 결과	선택 전략
단순 (단일 도메인)	리스크 < 40	직접 전문가 위임
중간 (2-3 도메인)	리스크 40-70	순차 워크플로우
복잡 (4+ 도메인)	리스크 > 70	전체 병렬 오케스트레이션

safe (보수적)

최대한의 검증과 안전장치를 적용:

더 많은 사용자 체크포인트
더 작은 점진적 변경
각 단계마다 종합 테스트
모든 Phase에 롤백 포인트

fast (공격적)

단순하거나 긴급한 작업을 위한 빠른 실행:

최소한의 체크포인트
가능한 모든 것 병렬화
선택적 검증 건너뛰기
빠른 완료 우선

Agent Delegation

위임 규칙

[HARD] 모든 구현 작업은 반드시 전문가 에이전트에 위임:

작업 유형	담당 에이전트
백엔드 로직	backend
프론트엔드 컴포넌트	frontend
풀스택 기능 (DB→API→UI)	fullstack
테스트 생성	test-guide
버그 수정	debugger
리팩토링	refactorer
보안 수정	security-auditor
성능 최적화	optimizer
API 설계	specialist-api
GraphQL 스키마	specialist-graphql
마이크로서비스 아키텍처	specialist-microservices
모바일 앱 (RN/Flutter)	specialist-mobile
데스크톱 앱 (Electron)	specialist-electron
실시간 통신 (WebSocket)	specialist-websocket
UI 디자인 시스템	designer-ui
Angular 15+ 개발	specialist-angular
JavaScript/Node.js 개발	specialist-javascript
PHP/Laravel/Symfony 개발	specialist-php
Python/FastAPI/Django 개발	specialist-python
Rust 시스템 프로그래밍	specialist-rust
SQL 쿼리 최적화	specialist-sql
TypeScript 고급 타입	specialist-typescript
Vue/Nuxt 개발	specialist-vue

Output Format

실행 중

markdown

## J.A.R.V.I.S.: Phase 2 (Iteration 3/50)

### Strategy: Balanced (auto-selected)
### Risk Score: 45/100

### Current Status
- [x] User model created
- [x] JWT token generation
- [ ] Login endpoint ← in progress
- [ ] Token validation middleware

### Self-Assessment
- Progress: YES (2 errors → 1 error)
- Pivot needed: NO
- Confidence: 85%

### Active Issues
- ERROR: src/auth/login.ts:45 - undefined 'hashPassword'

Fixing...

완료

markdown

## J.A.R.V.I.S.: COMPLETE

### Summary
- SPEC: SPEC-AUTH-001
- Strategy Used: Balanced
- Files Modified: 12
- Tests: 34/34 passing
- Coverage: 92%
- Iterations: 5
- Self-Corrections: 1 (pivoted from aggressive at iteration 3)

### Changes Implemented
- JWT token generation and validation
- Login/logout endpoints
- Token refresh mechanism
- Authentication middleware
- Comprehensive test suite

### Predictive Suggestions
1. Add rate limiting to auth endpoints
2. Implement password reset flow
3. Set up audit logging

<jikime>DONE</jikime>

Workflow Integration

듀얼 오케스트레이터 워크플로우

JikiME-ADK는 역할에 따라 두 오케스트레이터가 독립적으로 운영됩니다:

J.A.R.V.I.S. (개발):
  개별:  /jikime:0-project → /jikime:1-plan → /jikime:2-run → /jikime:3-sync
  통합:  /jikime:jarvis "task" → 전체 자동 실행

F.R.I.D.A.Y. (마이그레이션):
  개별:  /jikime:migrate-0-discover → 1-analyze → 2-plan → 3-execute → 4-verify
  통합:  /jikime:friday "migrate to X" → 전체 자동 실행

명령어 체계

타입	명령어	오케스트레이터	용도
Workflow (Type A)	0-project, 1-plan, 2-run, 3-sync	J.A.R.V.I.S.	개발 단계별 세밀한 제어
Migration	migrate-0 ~ migrate-4	F.R.I.D.A.Y.	마이그레이션 단계별 제어
Utility (Type B)	jarvis, test, loop, fix	J.A.R.V.I.S.	빠른 실행 및 자동화
Utility (Type B)	friday	F.R.I.D.A.Y.	마이그레이션 자동화

오케스트레이터 비교

측면	J.A.R.V.I.S. (개발)	F.R.I.D.A.Y. (마이그레이션)
목적	새 기능 구현, 개선	레거시 → 현대 프레임워크 전환
입력	작업 설명, SPEC	레거시 소스 코드
단계	4단계 (0-project ~ 3-sync)	5단계 (0-discover ~ 4-verify)
산출물	코드, 문서	마이그레이션된 프로젝트, 검증 보고서
방법론	DDD	DDD + 동작 비교 검증
완료 마커	`<jikime>DONE</jikime>`	`<jikime>MIGRATION_COMPLETE</jikime>`

Limitations & Safety

제한사항

최대 3회 전략 피봇 (이후 사용자 개입 요청)
중요 작업(마이그레이션, 삭제) 중에는 피봇 금지
세션 내 학습만 지원 (세션 간 학습 미지원)

안전장치

[HARD] 모든 구현은 전문가 에이전트에 위임
[HARD] SPEC 생성 전 사용자 확인 필수
[HARD] 완료 마커 필수: <jikime>DONE</jikime>
[HARD] LSP Quality Gate: run phase에서 에러 0 필수
각 Phase에 롤백 포인트 생성
LSP Quality Gates가 regression 감지 시 자동 알림

병렬 실행 기능

J.A.R.V.I.S.의 5-way 병렬 탐색과 연계하여 사용할 수 있는 명령어들:

명령어	설명	병렬 실행 패턴
`/jikime:perspective`	4개 관점(Arch, Sec, Perf, Test) 동시 분석	4-way 병렬 서브에이전트
`/jikime:verify pre-pr`	Adversarial Review 포함 검증	3-way 병렬 검증

Multi-Perspective Analysis

/jikime:perspective 명령어는 J.A.R.V.I.S.의 Intelligence Gathering과 유사한 병렬 분석 패턴을 사용합니다:

J.A.R.V.I.S. Phase 0:        /jikime:perspective:
├── Explore Agent            ├── Architecture Agent
├── Research Agent           ├── Security Agent
├── Quality Agent      ←→    ├── Performance Agent
├── Security Agent           └── Testing Agent
└── Performance Agent

Adversarial Review

/jikime:verify pre-pr에서 Phase 8로 실행되는 Adversarial Review는 3개의 서브에이전트가 병렬로 검증합니다:

Subagent	역할
False Positive Filter	오탐 필터링
Missing Issues Finder	놓친 이슈 탐지
Context Validator	맥락 검증

Skill Reference

병렬 실행 패턴에 대한 상세 문서:

templates/.claude/skills/jikime-workflow-parallel/SKILL.md
templates/.claude/skills/jikime-workflow-parallel/modules/parallel-patterns.md
templates/.claude/skills/jikime-workflow-parallel/modules/synthesis-strategies.md

Best Practices

언제 J.A.R.V.I.S.를 사용하나요?

적합한 경우:

새로운 기능 구현 (여러 도메인에 걸친)
대규모 리팩토링
복잡한 버그 수정
전체 워크플로우 자동화가 필요할 때

개별 명령어가 나은 경우:

단일 파일 수정
특정 단계만 실행하고 싶을 때
세밀한 제어가 필요할 때

권장 사용 패턴

bash

# 복잡한 새 기능
/jikime:jarvis "Implement payment processing system"

# 안전이 중요한 리팩토링
/jikime:jarvis "Refactor database layer" --strategy safe

# 간단한 수정
/jikime:jarvis "Add validation to login form" --strategy fast

# 긴 작업에 대한 재개 지원
/jikime:jarvis "Complex feature" --loop --max 30
# ... 중단 후 ...
/jikime:jarvis resume SPEC-XXX

# 마이그레이션은 F.R.I.D.A.Y.를 사용
/jikime:friday "Migrate Vue app to Next.js 16"

Version: 3.2.0 Last Updated: 2026-01-25 Codename: J.A.R.V.I.S. (Just A Rather Very Intelligent System) Inspiration: Iron Man's AI Assistant Changelog:

v3.2.0: Related Commands 섹션 추가 (perspective, verify), 병렬 실행 패턴 문서 연결
v3.1.0: LSP Quality Gates 설정 경로 업데이트 (quality.yaml), 문서 개선
v3.0.0: Dual Orchestrator (J.A.R.V.I.S. + F.R.I.D.A.Y.), LSP Quality Gates, Ralph Loop integration
v2.0.0: Added Migration Mode (--mode migrate), unified workflow orchestration
v1.0.0: Initial release with Development Mode

J.A.R.V.I.S. - Intelligent Autonomous Orchestration ​

Overview ​

핵심 철학 ​

기존 오케스트레이터와의 차별점 ​

Architecture ​

시스템 구조 ​

관련 파일 ​

Dual Orchestrator Architecture ​

듀얼 오케스트레이션 체계 ​

라우팅 로직 ​

Usage ​

기본 사용법 ​

명령어 옵션 ​

Intelligence Features ​

1. Proactive Intelligence Gathering (Phase 0) ​

2. Multi-Strategy Planning (Phase 1) ​

전략 유형 ​

자동 전략 선택 알고리즘 ​

3. Adaptive Execution (Phase 2) ​

LSP Quality Gates ​

Ralph Loop 통합 ​

자가 진단 루프 ​

피봇 결정 트리 ​

4. Predictive Suggestions (Phase 3) ​

Strategy Details ​

auto (기본값) ​

safe (보수적) ​

fast (공격적) ​

Agent Delegation ​

위임 규칙 ​

Output Format ​

실행 중 ​

완료 ​

Workflow Integration ​

듀얼 오케스트레이터 워크플로우 ​

명령어 체계 ​

오케스트레이터 비교 ​

Limitations & Safety ​

제한사항 ​

안전장치 ​

Related Commands & Features ​

병렬 실행 기능 ​

Multi-Perspective Analysis ​

Adversarial Review ​

Skill Reference ​

Best Practices ​

언제 J.A.R.V.I.S.를 사용하나요? ​

권장 사용 패턴 ​

J.A.R.V.I.S. - Intelligent Autonomous Orchestration

Overview

핵심 철학

기존 오케스트레이터와의 차별점

Architecture

시스템 구조

관련 파일

Dual Orchestrator Architecture

듀얼 오케스트레이션 체계

라우팅 로직

Usage

기본 사용법

명령어 옵션

Intelligence Features

1. Proactive Intelligence Gathering (Phase 0)

2. Multi-Strategy Planning (Phase 1)

전략 유형

자동 전략 선택 알고리즘

3. Adaptive Execution (Phase 2)

LSP Quality Gates

Ralph Loop 통합

자가 진단 루프

피봇 결정 트리

4. Predictive Suggestions (Phase 3)

Strategy Details

auto (기본값)

safe (보수적)

fast (공격적)

Agent Delegation

위임 규칙

Output Format

실행 중

완료

Workflow Integration

듀얼 오케스트레이터 워크플로우

명령어 체계

오케스트레이터 비교

Limitations & Safety

제한사항

안전장치

Related Commands & Features

병렬 실행 기능

Multi-Perspective Analysis

Adversarial Review

Skill Reference

Best Practices

언제 J.A.R.V.I.S.를 사용하나요?

권장 사용 패턴