vibeeval/vibecosystem

당신의 AI 소프트웨어 팀. Claude Code를 기반으로 구축되었습니다.

Turkce | English | Espanol | Francais | Deutsch | Portugues | Italiano | Nederlands | 中文 | 日本語 | 한국어 | العربية | हिन्दी | Русский

vibecosystem은 Claude Code를 완전한 AI 소프트웨어 팀으로 변모시킵니다. 계획, 구축, 리뷰, 테스트를 수행하고 모든 실수로부터 학습하는 139개의 전문 에이전트 (agents)가 포함되어 있습니다. 별도의 설정이 필요 없습니다. 설치하고 바로 코딩하세요.

v2.0: 13개의 새로운 에이전트 (sast-scanner, mutation-tester, graph-analyst, mcp-manager, community-manager, benchmark, dependency-auditor, api-designer, incident-responder, data-modeler, test-architect, release-engineer, documentation-architect) + 23개의 새로운 기술 (skills) (SAST, compliance, product, marketing, MCP) + 4개의 새로운 훅 (hooks) + 에이전트 모니터링 대시보드 (Agent Monitoring Dashboard) + GitHub Actions CI/CD + MCP 자동 검색 (Auto-Discovery). 자세한 내용은 UPGRADING.md를 참조하세요.

v2.1: 7개의 새로운 기술 (minimax-pdf, minimax-docx, minimax-xlsx, pptx-generator, frontend-dev, fullstack-dev, clone-website) + 2개의 새로운 에이전트 (document-generator, website-cloner). 문서 생성, 픽셀 단위의 완벽한 웹사이트 클로닝 (cloning), 그리고 강화된 프론트엔드/풀스택 (frontend/fullstack) 패턴.

v2.1.1: oh-my-claudecode로부터 가져온 7개의 새로운 기술 (smart-model-routing, deep-interview, agent-benchmark, visual-verdict, ai-slop-cleaner, factcheck-guard, notepad-system) + 1개의 새로운 규칙 (commit-trailers).

v2.2: Claude Code 소스에서 가져온 5가지 기능 — 에이전트 메모리 (Agent Memory, 에이전트별 영구 메모리), 매직 독스 (Magic Docs, 자동 업데이트 문서), 드림 컨솔리데이션 (Dream Consolidation, 세션 간 메모리 정리), 스마트 리콜 (Smart Recall, 프론트매터 기반 메모리 점수 산정), 플러그인 토글 (Plugin Toggle, CLI를 통한 훅 활성화/비활성화). +7개의 훅 (hooks), 21개 에이전트를 위한 기술 참조 (skill references).

v2.2.1: 수익화 스택 (Monetization stack) — 1개의 새로운 에이전트 (monetization-expert), 2개의 새로운 기술 (paywall-optimizer, codex-orchestration), 3개의 업데이트된 기술 (revenuecat-patterns, paywall-strategy, subscription-pricing). 14개 카테고리 벤치마크, RevenueCat SDK 패턴, Codex + Claude Code 오케스트레이션 (orchestration)을 통한 AI 기반 페이월 (paywall) 최적화.

v2.3:vibeco

CLI 도구 (stats, doctor, profiles, dashboard), 토큰 절약을 위한 6가지 프리셋 프로필 (preset profiles), 한 줄 설치 (curl | bash).

v2.4: 터미널 HUD (Terminal HUD, 실시간 상태 표시줄), 프롬프트 자동 개선기 (prompt auto-improver, 모호한 프롬프트에 컨텍스트를 풍부하게 추가), 지속적인 계획 시스템 (persistent planning system, 96.7%의 작업 완료율을 위한 PLAN.md/PROGRESS.md/CONTEXT.md), 20개 이상의 에코시스템 리포지토리 (ecosystem repos) 분석을 통한 경쟁 격차 해소.

v3.0: npx vibecosystem init

npm 설치 프로그램, 공식 플러그인 에코시스템 (official plugin ecosystem)을 위한 plugin.json, 60개의 프로듀서 에이전트 (producer agents)에 대한 워크트리 격리 (worktree isolation), 멀티 LLM 모델 라우팅 (multi-LLM model routing, Haiku/Sonnet/Opus 티어), 지식 그래프 통합 (knowledge graph integration, 6-71배의 토큰 절약), 토큰 및 비용 추적 기능이 포함된 대시보드 (dashboard) v2.

Claude Code는 강력하지만, 하나의 어시스턴트일 뿐입니다. 당신이 프롬프트를 입력하면, 그것이 응답하고, 당신이 검토합니다. 복잡한 프로젝트를 위해서는 플래너 (planner), 리뷰어 (reviewer), 보안 감사관 (security auditor), 테스터 (tester)가 필요하며, 결국 당신 스스로가 이 모든 역할을 수행하게 됩니다.

vibecosystem은 자가 조직화된 AI 팀을 구축하는 완전한 Claude Code 에코시스템입니다:

138개의 에이전트 (agents)— 프론트엔드 개발 (frontend-dev)부터 보안 분석가 (security-analyst)까지 전문화된 역할
295개의 기술 (skills)— TDD 워크플로우부터 Kubernetes 패턴까지 재사용 가능한 지식
73개의 훅 (hooks)— 컨텍스트를 관찰, 필터링 및 주입하는 TypeScript 센서
20개의 규칙 (rules)— 모든 에이전트의 출력을 형성하는 행동 지침
자가 학습 (Self-learning)— 모든 오류가 자동으로 규칙이 됨

설정 후

프로필 (Profile)	에이전트 (Agents)	기술 (Skills)	사용 사례 (Use case)
minimal	~15	~40	핵심 기능만 포함 (리뷰, 테스트, 검증)
frontend	~30	~60	React/Next.js/CSS/a11y
backend	~44	~74	API/DB/보안 (security)
fullstack	~59	~96	프론트엔드 (Frontend) + 백엔드 (Backend)
devops	~33	~61	CI/CD/K8s/클라우드 (cloud)
all	139	295	모든 기능 (기본값)

vibeco profile frontend # 프론트엔드 프로필로 전환
vibeco profile all # 모든 기능으로 복귀

당신이 말하면 VIBECOSYSTEM이 활성화되어 결과가 나타남
┌──────────────┐ ┌──────────────────────┐ ┌──────────┐
│ "새로운 기능 │──→ 의도 (Intent) ──→ │ 1단계: 정찰 (scout) + │──→ 코드 (Code) │ 기능 (Feature) │
... 

**훅 (Hooks)**은 센서입니다 — 모든 도구 호출 (tool call)을 관찰하고 관련 문맥 (context)을 주입합니다:

"버그 수정" → 컴파일러 인 루프 (compiler-in-loop) + 에러 브로드캐스트 (error-broadcast) ~2,400 토큰 (tok)
"API 엔드포인트 추가" → 편집 문맥 (edit-context) + 시그니처 헬퍼 (signature-helper) + 아키텍처 (arch) ~3,100 토큰 (tok)
"이 코드 설명" → (추가 사항 없음) ~800 토큰 (tok)

**에이전트 (Agents)**는 근육입니다 — 각 에이전트는 특정 작업에 특화되어 있습니다:

GraphQL API → graphql-expert (백업: backend-dev)
Kubernetes → kubernetes-expert (백업: devops)
DDD 모델링 → ddd-expert (백업: architect)
...

**자가 학습 파이프라인 (Self-Learning Pipeline)**은 실수를 영구적인 지식으로 전환합니다:

오류 발생 → 수동 학습기 (passive-learner)가 패턴 포착 (+ 프로젝트 태그)
→ 통합기 (consolidator)가 그룹화 및 카운트 (프로젝트별 + 전역)
→ 신뢰도 (confidence) >= 5 → 문맥 (context)에 자동 주입
...

수동 개입은 필요 없습니다. 시스템이 스스로 규칙을 작성하며, 이를 여러 프로젝트에 걸쳐 공유합니다.

SAST Security Scanner— 정적 분석 에이전트 (static analysis agent) + 자동 취약점 탐지를 위한 훅 (hook)
Agent Monitoring Dashboard— 에이전트 활동 및 성능을 위한 실시간 웹 UI
MCP Auto-Discovery— 프로젝트 유형에 기반한 자동 MCP 서버 추천
Changelog Automation— 세션 종료 시 자동 변경 로그 (changelog) 생성
Compliance Skills— SOC2, GDPR, HIPAA 준수 여부 확인
Product & Marketing Skills— PRD 작성자, 분석 설정, 성장 플레이북 (growth playbooks)
GitHub Actions CI/CD— 자동 PR 리뷰 + 이슈 수정 워크플로
Mutation Testing— 변이 분석 (mutation analysis)을 통한 테스트 품질 측정
Code Knowledge Graph— 그래프 분석가 (graph-analyst)를 통한 코드베이스 구조 분석

"새로운 기능을 추가해줘"라고 말하면 5개 단계에 걸쳐 20개 이상의 에이전트가 활성화됩니다.

Phase 1 (Discovery): scout + architect + project-manager
Phase 2 (Development): backend-dev + frontend-dev + devops + specialists
Phase 3 (Review): code-reviewer + security-reviewer + qa-engineer
...

모든 오류는 규칙이 됩니다. 자동으로.

모든 작업은 품질 게이트 (quality gate)를 통과합니다:

개발자 구현 → code-reviewer + verifier 확인
→ PASS → 다음 작업
→ FAIL → 개발자에게 피드백, 재시도 (최대 3회)
...

한 프로젝트에서 학습된 패턴은 자동으로 귀하의 모든 프로젝트에 이점을 제공합니다.

Project A: add-error-handling (3x) ─┐
├→ 2개 이상의 프로젝트, 총 5회 이상 발생 → GLOBAL
Project B: add-error-handling (4x) ─┘
...

각 프로젝트는 고유의 패턴 저장소 (pattern store)를 가집니다. 동일한 패턴이 2개 이상의 프로젝트에서 총 5회 이상 나타나면, 이는 모든 프로젝트(심지어 완전히 새로운 프로젝트까지)에 이점을 주는 글로벌 패턴 (global pattern)으로 승격됩니다.

node ~/.claude/hooks/dist/instinct-cli.mjs portfolio # 모든 프로젝트
node ~/.claude/hooks/dist/instinct-cli.mjs global # 글로벌 패턴
node ~/.claude/hooks/dist/instinct-cli.mjs project <name> # 프로젝트 상세 정보
...

한 에이전트가 실수를 하면, 팀 전체가 그로부터 배웁니다.

에이전트 오류 → error-ledger.jsonl → skill-matrix.json
→ 모든 에이전트가 세션 시작 시 교훈을 습득
→ 팀 전체의 오류 방지

73개의 훅 (hooks)이 존재하지만, 이들이 모두 동시에 실행되는 것은 아닙니다. 의도 (Intent)에 따라 어떤 훅이 실행될지가 결정됩니다.

┌─────────────────────────────────────────────────────────┐
│ Claude Code │
│ │
...

카테고리 (Category)	개수 (Count)	예시 (Examples)
핵심 개발 (Core Dev)	14	frontend-dev, backend-dev, kraken, spark, devops, browser-agent, website-cloner
...
기능 (Feature)	vibecosystem	단일 Claude Code
---	---	---
특화 에이전트 (Specialized agents)	139
0	0	0
자기 학습 (Self-learning)	예 (Yes)	아니오 (No)
에이전트 스웜 조정 (Agent swarm coordination)	예 (Yes)	아니오 (No)
프로젝트 간 학습 (Cross-project learning)	예 (Yes)	아니오 (No)
에이전트 간 오류 트레이닝 (Cross-agent error training)	예 (Yes)	아니오 (No)
개발-QA 재시도 루프 (Dev-QA retry loop)	예 (Yes)	아니오 (No)
적응형 훅 로딩 (Adaptive hook loading)	예 (Yes)	아니오 (No)
할당 매트릭스 라우팅 (Assignment matrix routing)	예 (Yes)	아니오 (No)
Claude Code 네이티브 (Claude Code native)	예 (Yes)	예 (Yes)
설치 후 제로 설정 (Zero config after install)	예 (Yes)	예 (Yes)

구성 요소 (Component)	개수 (Count)	설명 (Description)
agents/	139	특화된 프롬프트 (prompts)를 포함한 마크다운 에이전트 정의
skills/	295	재사용 가능한 지식 — TDD, 보안 (security), 패턴 (patterns), 프레임워크 (frameworks)
hooks/src/	73	TypeScript 훅 (hooks) — 센서 (sensors), 학습기 (learners), 검증기 (validators)
rules/	20	행동 지침 (behavioral guidelines) — 코딩 스타일 (coding style), 안전 (safety), QA

구성 요소 (Component)	기술 (Technology)
런타임 (Runtime)	Claude Code (Claude Max)
...

훅 (hooks)은 센서 (sensors)입니다. 관찰하고, 필터링하며, 신호를 보냅니다.
에이전트 (agents)는 근육 (muscles)입니다. 구축하고, 생산하며, 수정합니다.
그 사이의 가교는 컨텍스트 주입 (context injection)입니다.
...

• 모든 데이터는 사용자의 로컬 머신(~/.claude/)에 머뭅니다. - 네트워크 요청 없음, 텔레메트리 (telemetry) 없음, 클라우드 동기화 (cloud sync) 없음
• 자기 학습된 규칙 (Self-learned rules)은 ~/.claude/rules/로 이동합니다.
• 훅 (hooks)은 Claude Code의 네이티브 훅 시스템을 통해 로컬에서 실행됩니다.

vibecosystem은 다음과 같은 여러 AI 코딩 도구와 함께 작동합니다:

CLI	설치 프로그램 (Installer)	지침 파일 (Instructions File)	제공 사항 (What You Get)
Claude Code	./install.sh	CLAUDE.md	전체 지원 (에이전트 (agents) + 스킬 (skills) + 훅 (hooks) + 규칙 (rules))
Cursor IDE	./install-cursor.sh	AGENTS.md + .cursor/rules/	6개의 MDC 규칙 + AGENTS.md + 스킬
Codex CLI (OpenAI)	./install-codex.sh	AGENTS.md	스킬 전용 (295개 스킬)
OpenCode	수동 (Manual)	AGENTS.md	스킬 전용

# Cursor IDE 사용자의 경우:
./install-cursor.sh /path/to/your/project
# Codex CLI 사용자의 경우:
...

Codex CLI 설정은 docs/codex-setup.md를 참조하거나, .cursor/rules/를 모든 Cursor 프로젝트로 복사하십시오.

vibecosystem은 위대한 오픈 소스 프로젝트들의 토대 위에 세워졌습니다:

Shannon (KeygraphHQ 제작) — Result<T,E> 패턴, 침투 테스트 (pentest) 파이프라인, 주석 철학
UI UX Pro Max (nextlevelbuilder 제작) — 명명된 UX 규칙, UI 스타일 카탈로그, 디자인 토큰 (design token) 아키텍처
Game Studios (Donchitos 제작) — 컨텍스트 회복력 (context resilience), 점진적 작성 (incremental writing), 게이트 체크 (gate-check) 시스템
Skill Gateway (buraksu42 제작) — 보이지 않는 스킬 라우팅 (invisible skill routing), 외부 카탈로그, 단일 질문 규칙 (one-question rule)
Pyxel (kitao 제작) — 레트로 게임 엔진 패턴, 픽셀 아트 제약 조건, MML 오디오
copilot-orchestra (ShepAlderson 제작) — 단계별 게이트 커밋 (phase-gated commits), 계획 문서화 추적 (plan documentation trail), 90% 신뢰도 임계값
RevenueCat — 구독 인프라, 카테고리 벤치마크, 페이월 (paywall) 패턴
Trail of Bits Skills (trailofbits 제작) — 보안 감사 (security audit) 패턴, 변이 분석 (variant analysis), 오탐 (false positive) 검증, 날카로운 경계 (sharp edges) 탐지

기여를 환영합니다! 도움이 필요한 분야는 다음과 같습니다:

더 많은 에이전트 정의 — 귀하의 도메인을 위한 특화된 역할
더 많은 스킬 패턴 — 프레임워크별 지식 (Rails, Flutter 등)
더 나은 훅 — 새로운 센서, 더 스마트한 컨텍스트 주입 (context injection)
문서화 — 튜토리얼, 가이드, 예제
번역 — 기존 언어 개선 또는 새로운 언어 추가

vibecosystem은 Claude Code를 완전한 AI 소프트웨어 팀으로 변모시킵니다. 단순한 하나의 어시스턴트가 아니라, 계획하고, 개발하고, 리뷰하고, 테스트하며, 모든 실수로부터 학습하는 139명의 전문가 에이전트로 구성된 팀입니다.

특별한 모델은 없습니다. 특별한 API도 없습니다. 오직 Claude Code의 hook + agent + rules 시스템을 극한까지 활용했을 뿐입니다.

git clone https://github.com/vibeeval/vibecosystem.git
cd vibecosystem
./install.sh

Hook(훅)은 센서— 관찰하고, 필터링하며, 지표를 나타냅니다.
Agent(에이전트)는 근육— 실행하고, 생성하며, 수정합니다.
그들 사이의 가교: context injection (컨텍스트 주입)
직접적인 RPC는 없음— 의도적으로 이렇게 설계되었습니다.
**Context (컨텍스트)를 통한 암시적 협업 (implicit coordination)**이 작동합니다.

사용자가 아무것도 기억할 필요가 없습니다.
모든 것이 자동입니다.

MIT