iSparto는 1인 창업가(solopreneurs)를 위해 구축된 Claude Code용 오픈 소스 에이전트 팀 (Agent Team) 프레임워크입니다. 단 한 번의 명령으로 전체 에이전트 팀을 가동하며, 모든 에이전트가 완벽하게 동기화되어 작동합니다. 사용자는 팀 리드 (Team Lead)를 통해 팀을 지휘하며, 나머지는 백그라운드에서 실행됩니다.

중국어 사용자는 설치, 첫 사용 및 일상적인 워크플로우 (workflow)를 다루는 중국어 퀵스타트 가이드인 docs/zh/quick-start.md부터 시작할 수 있습니다. iSparto는 의도적인 이중 언어 전략을 사용합니다. 사용자 대상 진입점(README, 중국어 퀵스타트, CONTRIBUTING.md 모두 포함)은 병렬로 유지 관리됩니다. 반면, 프레임워크 지침 및 참조 문서(reference documentation)는 단일 진실 공급원 (single source of truth)으로서 영어로만 작성됩니다. 이는 AI의 지침 준수 (instruction-following) 능력을 안정적으로 유지하고, 영어를 사용하는 기여자 (contributors)들이 프레임워크를 검토할 수 있도록 하기 위함입니다. 자세한 근거는 CLAUDE.md > Documentation Language Convention을 참조하십시오.

v0.8.0 (2026-04-20 출시)에서는 두 가지 런타임 (runtime) 기대 사항이 변경되었습니다. 이제 tmux 3.x가 필수 의존성 (hard dependency)이 되었습니다 (독립 검토자 (Independent Reviewer)는 Claude Code 서브 에이전트가 아닌, 전용 tmux 창에서 codex exec를 통해 실행됩니다). 또한, Codex CLI는 이제 두 가지 역할(구현 및 QA를 담당하는 개발자 (Developer), 그리고 교차 제공자 블라인드 검토를 담당하는 독립 검토자 (Independent Reviewer))을 수행합니다. 전체 릴리스 노트는 CHANGELOG.md에서 확인할 수 있습니다.

Cursor, Windsurf, Copilot, 그리고 단독으로 사용하는 Claude Code를 포함한 모든 기존 AI 코딩 도구들은 사용자를 단일 에이전트 (single agent)와의 루프 속에 가둡니다. 사용자와 에이전트는 모든 결정, 모든 파일, 모든 커밋(commit)에 대해 메시지를 주고받아야 합니다. 전체 개발 사이클이 하나의 대화창을 통해 실행됩니다.

iSparto의 핵심적인 변화는 그 단일 에이전트를 에이전트 팀 (Agent Team)으로 전환하는 것입니다. 단 한 번의 명령(/init-isparto 또는 /start-isparto)으로 다음과 같은 6가지 역할이 병렬로 작동하는 전체 에이전트 팀이 가동됩니다: 팀 리드 (Team Lead)는 계획 및 조율을 담당하고, 팀원 (Teammate)은 병렬로 코드 프롬프트 (code prompts)를 작성하며, 독립 검토자 (Independent Reviewer)는 새로운 컨텍스트 (context)로 감사를 수행하고, 개발자 (Developer)는 Codex를 통해 구현하며, 문서 엔지니어 (Doc Engineer)는 문서 동기화를 유지하고, 프로세스 옵저버 (Process Observer)는 워크플로우를 보호합니다. 사용자는 팀 리드를 통해 팀을 지휘하며, 나머지는 실제 결정이 필요한 시점 전까지는 사용자의 흐름을 방해하지 않습니다.

Claude Code 위에서 전체 에이전트 팀을 실행하고자 하는 macOS 기반의 소프트웨어 출시 1인 창업가 (Solopreneurs)를 위한 도구입니다. Claude Max 및 ChatGPT 구독이 필요합니다.

플랫폼: macOS 전용. v0.8.0부터 tmux가 필수 의존성 (hard dependency)으로 요구됩니다. 독립 검토자 (Independent Reviewer)는 tmux 창 내에서 codex exec를 통해 생성되기 때문입니다 (상속된 컨텍스트가 전혀 없는 상태에서 제공업체가 다른 블라인드 리뷰 수행). brew install tmux로 설치할 수 있습니다. 단일 세션 모드 (Single-session mode)는 다른 플랫폼에서도 작동할 수 있으나 테스트되지 않았습니다.

총 비용: 월 $120 — 두 개의 최상위 모델을 사용하며, 추가 API 비용은 없습니다.

사전 요구 사항 (Prerequisites): Claude Max (월 $100) + ChatGPT Plus (월 $20). iSparto는 런타임 (runtime)으로서 Claude Code 위에서 실행되며, 개발자 역할 (구현 + QA)과 독립 검토자 (tmux 창 내의 codex exec) 모두를 위해 Codex CLI를 사용합니다.

curl -fsSL https://raw.githubusercontent.com/BinaryHB0916/iSparto/main/bootstrap.sh | bash

이 명령어 하나로 모든 과정이 처리됩니다: GitHub Releases에서 검증된 설치 프로그램을 다운로드하고, Claude Code와 Codex CLI를 확인 및 설치하며, Codex에 로그인하고, 명령어와 템플릿을 ~/.claude/로 복사하고, 글로벌 MCP 서버를 등록합니다. 기존의 ~/.claude/settings.json은 절대 수정되지 않습니다. 모든 변경 사항이 적용되기 전에 기존 파일의 스냅샷이 자동으로 생성되므로 언제든지 되돌릴 수 있습니다.

설치 전 드라이 런 (Dry run, 미리보기):

curl -fsSL https://raw.githubusercontent.com/BinaryHB0916/iSparto/main/bootstrap.sh | bash -s -- --dry-run

특정 버전 설치:

curl -fsSL https://raw.githubusercontent.com/BinaryHB0916/iSparto/main/bootstrap.sh | bash -s -- --version=0.8.0

업그레이드:

~/.isparto/install.sh --upgrade

업그레이드 (Upgrade)는 프레임워크 구성 요소(명령어, 템플릿, 스냅샷 엔진)만 업데이트합니다. 사용자의 프로젝트 파일(CLAUDE.md, docs/, 코드, 설정)은 절대 건드리지 않습니다.

삭제 (Uninstall): 모든 변경 사항을 되돌리고 백업 스냅샷에서 원래 파일을 복구하며, 오프라인에서도 작동합니다:

~/.isparto/install.sh --uninstall

문제가 발생했나요? 문제 해결 (Troubleshooting) 섹션을 참조하세요.

대안: 수동 클론 (manual clone)

git clone https://github.com/BinaryHB0916/iSparto.git
cd iSparto && ./install.sh # 또는: ./install.sh --dry-run

mkdir my-app && cd my-app
claude --effort max
/env-isparto # 선택적 환경 확인
...

파일이 생성되기 전에 스냅샷이 찍힙니다. 문제가 발생하면 /restore-isparto를 실행하여 롤백(roll back)하세요.

cd existing-project/
claude --effort max
/migrate-isparto --dry-run # 실행 없이 마이그레이션 계획 미리보기 (첫 실행 시 권장)
...

변경 사항이 적용되기 전에 스냅샷이 찍힙니다. 언제든지 /restore-isparto를 실행하여 롤백할 수 있습니다.

/start-isparto
→ 팀 리드 (Lead)가 plan.md를 읽고, 현재 상태와 남은 작업을 보고합니다.
→ 사용자가 "진행해 (go ahead)"라고 확인합니다.
...

/plan-isparto xxx 기능을 추가하고 싶어
→ 팀 리드 (Lead)가 제품 방향을 검토하고 하나의 제안서를 작성합니다.
→ 사용자가 확인하면, 팀 리드 (Lead)가 이를 plan.md에 작성하고 작업을 시작합니다.

에이전트 팀은 6가지 역할을 가집니다:

팀 리드 (Team Lead)— 사용자가 대화하는 대상입니다. 작업을 계획하고, 팀을 조율하며, 실제로 의사결정이 필요한 경우에만 에스컬레이션(escalate)합니다.

팀원 (Teammate)— 팀 리드가 위임한 작업을 수행하는 병렬 Claude 세션입니다. 자체적인 tmux 창에서 실행됩니다.

독립 리뷰어 (Independent Reviewer)— 리뷰 시점에 상속된 컨텍스트(context) 없이 생성되므로, 자신이 참여했던 결정에 대해 무조건적으로 승인(rubber-stamp)할 수 없습니다.

개발자 (Developer)— 구현 전문가로, MCP (Codex)를 통해 호출됩니다. 팀 리드로부터 사양(specs)을 전달받고 코드를 반환합니다.

문서 엔지니어 (Doc Engineer)— 모든 웨이브(Wave) 경계에서 문서를 감사(audit)합니다.

프로세스 옵저버 (Process Observer)— 형식적인 단계가 건너뛰어지는 것을 차단하는 PreToolUse 훅(shell, 모델 미사용)이며, 추가적으로 자문 역할을 하는 Sonnet 감사 레이어입니다.

전체 모델 할당(Full model assignments) 및 추론 수준(reasoning levels)은 docs/configuration.md에 명시되어 있습니다. 보안 감독(쓰기/편집 스캔, 커밋 전 비밀번호/개인정보(PII) 확인, /security-isparto)에 관한 내용은 docs/security.md에 문서화되어 있습니다.

iSparto는 스스로를 '도그푸딩(dogfoods)' 합니다. 즉, 프레임워크 자체의 워크플로우를 사용하여 프레임워크를 개발합니다. 엔드 투 엔드(End-to-end) 사례 연구는 전용 파일인 docs/case-studies.md에 정리되어 있습니다. 여기에는 워크플로우를 사용하여 자체 세션 지표(session-metrics) 기능을 구축하는 데 사용된 '세션 로그 셀프 부트스트래핑(Session Log self-bootstrapping)' 실행 사례부터 시작됩니다.

프레임워크가 실제로 실무에서 동기화되어 작동하는지에 대한 세션별 주관적 노트는 docs/dogfood-log.md에 기록되어 있습니다. 이는 이 페이지의 가치 제안(value prop)을 뒷받침하는 증거 사슬(evidence-chain) 역할을 합니다.

파일별로 주석이 달린 전체 리포지토리 레이아웃(repository layout)은 docs/repo-structure.md에서 관리됩니다. 이전에는 README에 트리 구조를 직접 포함했으나, 현재는 별도의 파일로 유지하여 구조적 변경이 발생할 때마다 모든 웨이브(Wave)에서 README가 변경되는 현상을 방지하고 있습니다.

일회성 설정 (./install.sh가 이를 자동으로 처리합니다):

• Claude Max + ChatGPT 구독 활성화 상태
• 터미널은 iTerm2 사용 (macOS, 병렬 실행 분할 창(parallel-execution split panes)을 위해 필수)
• tmux 3.x 설치됨 (v0.8.0부터 필수; brew install tmux)
• ./install.sh 완료 (Claude Code, Codex CLI, 설정 파일, MCP 포함)
• 여러 대의 컴퓨터를 사용하는 경우 멀티 디바이스 동기화 구성 완료 (configuration.md 참조)

새 프로젝트마다 (/init-isparto가 이를 자동으로 처리합니다):

• claude --effort max로 실행
• /env-isparto 체크 통과 (선택 사항)
• /init-isparto가 CLAUDE.md 및 docs/ 생성 완료
• 플랫폼별 플러그인이 포함된 프로젝트 수준의 .claude/settings.json 구성 (선택 사항)

그리스 신화에서 영웅 카드모스(Cadmus)는 용을 죽이고 그 이빨을 땅에 심었습니다. 그러자 땅에서 무장한 전사들이 떼를 지어 솟아올랐는데, 이들을 '심어진 자들'이라는 뜻의 **스파르토이(Spartoi, Σπαρτοί)**라고 불렀습니다.

이것은 iSparto의 워크플로우와 동일한 이야기입니다. 당신은 제품 요구사항을 /init-isparto에 심게 됩니다.

, 그리고 전체 팀이 스스로 결성됩니다 — 리드(lead)는 작업을 분해하고, 개발자(developer)는 코드를 작성하며, 리뷰(review)는 동일한 Wave 내에서 이루어지고, 문서화(documentation)는 동기화된 상태를 유지합니다 — 단 하나의 씨앗에서 자라난 완전한 팀입니다.

i는 Spartoi의 끝에서 앞으로 이동되었습니다. 소문자 i = I = 나, 즉 한 사람을 의미합니다.

iSparto = I + Sparto = 한 사람, 단 하나의 씨앗에서 뿌려진 전체 에이전트 팀.