Repolode
mtarcure

mtarcure/claude-vibe-squad

Markdown으로 정의한 작업을 Claude, Codex, Gemini, Kimi, Grok CLI에 분배하는 멀티모델 AI 코딩 오케스트레이터

스타
165
포크
26
열린 이슈
0
마지막 커밋
29일 전

어떤 프로젝트인가요?

Vibe Squad은 AI 코딩 작업을 위한 macOS 우선 오케스트레이션 계층입니다. Chrono라는 코디네이터에게 목표를 설명하면, Chrono가 이를 범위가 정해진 작업 파일로 나누고 역할 기반 전문가 71명 중 각 작업에 적합한 전문가를 배정한 뒤 Claude, Codex, Gemini(agy 사용), Kimi 또는 Grok의 기본 CLI를 실행합니다. 변경을 가하는 작업은 각각 선언된 쓰기 범위가 있는 별도의 git worktree에서 실행되며, 검사를 통과한 뒤에만 결과를 통합합니다.

동작 방식은 Markdown에 담겨 있습니다. 모드, 전문가 브리프, 기능 카드, 스킬은 읽고 편집할 수 있는 일반 파일입니다. 코드는 실행, worktree 격리, ID 확인, 통합 경계를 처리합니다. 위험도가 높은 작업에서는 다른 모델 계열의 리뷰어를 필수로 지정할 수 있으며, 실행 기록은 저장소 외부의 비공개 Markdown vault에 보관됩니다.

이 프로젝트를 사용하려면 tmux, fswatch, jq, Python 3.13과 각 제공업체의 인증된 CLI가 필요합니다. 문서에 따르면 에이전트는 사용자 권한으로 실행되며, 쓰기 범위는 샌드박스가 아니라 통합 단계에서 적용됩니다.

핵심 기능

  • 01작업을 Claude, Codex, Gemini, Kimi 또는 Grok CLI에 연결된 전문가에게 분배
  • 02변경을 가하는 각 작업을 선언된 쓰기 범위가 있는 별도의 git worktree에서 실행
  • 03보안 및 판단이 중요한 작업에 서로 다른 모델 계열의 리뷰를 필수로 지정
  • 04전문가 브리프, 모드, 스킬을 편집 가능한 Markdown 파일로 관리
  • 05실행 기록을 저장소 외부의 비공개 Markdown vault에 보관

활용 사례

  • 하나의 저장소에서 여러 AI 코딩 에이전트를 서로 다른 브랜치에 병렬로 실행
  • AI가 작성한 변경 사항을 병합하기 전에 다른 모델 계열을 독립 리뷰어로 추가
  • 코드 대신 Markdown을 편집해 에이전트 역할과 워크플로를 맞춤 설정

빠른 시작

  1. 1

    비공개 메모리 보관소를 만들고 해당 경로를 내보내세요

    mkdir -p "$HOME/Obsidian-Chrono" && printf '%s\n' '{"vault_id":"my-private-vault","schema_version":1}' > "$HOME/Obsidian-Chrono/.chrono-vault" && export CHRONO_VAULT_ROOT="$HOME/Obsidian-Chrono"
  2. 2

    저장소를 클론하고 Python 환경을 설치하세요

    git clone https://github.com/mtarcure/claude-vibe-squad.git && cd claude-vibe-squad && uv sync
  3. 3

    로컬 유출 방지 훅을 설치하고 상태 점검을 실행하세요

    bash docs/install/install-pre-commit-hook.sh && bin/squad doctor
  4. 4

    Chrono로 tmux 컨트롤 룸을 실행하세요

    bin/squad up

사용 전 알아둘 점

  • 현재는 macOS만 지원합니다.
  • Claude, Codex, Gemini(agy), Kimi, Grok용으로 인증된 네이티브 CLI가 여러 개 필요합니다.
  • 에이전트는 사용자의 권한으로 체크아웃한 코드에서 실행됩니다. 쓰기 범위 설정은 샌드박스가 아닙니다.
  • chrono-dedup과 같은 일부 선택 기능은 배포되지 않으며 별도 설정이 필요합니다.

토픽

자주 묻는 질문

claude-vibe-squad은(는) 무엇인가요?
Markdown으로 정의한 작업을 Claude, Codex, Gemini, Kimi, Grok CLI에 분배하는 멀티모델 AI 코딩 오케스트레이터 Vibe Squad은 AI 코딩 작업을 위한 macOS 우선 오케스트레이션 계층입니다. Chrono라는 코디네이터에게 목표를 설명하면, Chrono가 이를 범위가 정해진 작업 파일로 나누고 역할 기반 전문가 71명 중 각 작업에 적합한 전문가를 배정한 뒤 Claude, Codex, Gemini(agy 사용), Kimi 또는 Grok의 기본 CLI를 실행합니다. 변경을 가하는 작업은 각각 선언된 쓰기 범위가 있는 별도의 git worktree에서 실행되며, 검사를 통과한 뒤에만 결과를 통합합니다.
claude-vibe-squad은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
claude-vibe-squad은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
claude-vibe-squad은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. claude-vibe-squad의 마지막 커밋은 2026년 9월 21일입니다.
claude-vibe-squad은(는) 어디에 사용할 수 있나요?
하나의 저장소에서 여러 AI 코딩 에이전트를 서로 다른 브랜치에 병렬로 실행 AI가 작성한 변경 사항을 병합하기 전에 다른 모델 계열을 독립 리뷰어로 추가 코드 대신 Markdown을 편집해 에이전트 역할과 워크플로를 맞춤 설정
claude-vibe-squad는 어떻게 설치하나요?
비공개 메모리 보관소를 만들고 해당 경로를 내보내세요: mkdir -p "$HOME/Obsidian-Chrono" && printf '%s\n' '{"vault_id":"my-private-vault","schema_version":1}' > "$HOME/Obsidian-Chrono/.chrono-vault" && export CHRONO_VAULT_ROOT="$HOME/Obsidian-Chrono" 저장소를 클론하고 Python 환경을 설치하세요: git clone https://github.com/mtarcure/claude-vibe-squad.git && cd claude-vibe-squad && uv sync 로컬 유출 방지 훅을 설치하고 상태 점검을 실행하세요: bash docs/install/install-pre-commit-hook.sh && bin/squad doctor Chrono로 tmux 컨트롤 룸을 실행하세요: bin/squad up
claude-vibe-squad은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/mtarcure/claude-vibe-squad

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트