AI software team for Claude Code - 138 agents, 295 skills, 73 hooks. Self-learning, multi-agent swarm, autonomous skill evolution.

vibecosystem – Claude Code 기반 AI 소프트웨어 팀

무엇인가요 – vibecosystem은 단일 어시스턴트인 Claude Code 환경을 자기조직화 팀 으로 전환하는 패키지화된 컬렉션입니다. 138개의 전문 에이전트, 296개의 재사용 가능한 "스킬", 74개의 TypeScript 훅, 20개의 행동 규칙을 포함합니다. 1줄의 설치 후 에이전트들이 5단계 개발 프로세스(계획 → 코드 → 리뷰 → 테스트 → 학습)를 가로지르며 협력하여, Claude Code에 "기능 추가" 라고 요청하면 설계, 구현, 보안 리뷰, 테스트, 사후 분석 학습을 추가 구성 없이 자동으로 처리할 수 있습니다. 프로파일 기능을 통해 필요 없는 에이전트는 비활성화하여 토큰 사용량을 절감할 수 있으며, vibeco CLI와 웹 대시보드를 통해 통계, 건강 상태 점검, 토큰 비용 추적을 제공합니다. 모든 데이터는 로컬 ~/.claude/에 보관되며, 태레메트리 데이터는 전송되지 않습니다. 이 프로젝트는 Cursor, Codex CLI, OpenCode를 위한 전용 설치 스크립트를 지원합니다.

핵심 개념

개념	기능
에이전트	마크다운으로 정의된 프롬프트로 전문 역할(예: `frontend-dev`, `security-reviewer`, `graphql-expert`)을 수행합니다. 138개의 에이전트가 제공됩니다.
스킬	재사용 가능한 지식을 캡처하는 프롬프트 조각(총 296개)으로, TDD 패턴, Kubernetes 매니페스트, 준수 검사, 마케팅 전략 등이 포함됩니다.
훅	Claude Code 도구 호출을 관찰하고 컨텍스트를 주입하며 에이전트를 트리거하는 74개의 TypeScript 센서(예: compiler-in-loop, error-broadcast). 선택된 프로파일 에 따라 적응적으로 로드됩니다.
규칙	출력 스타일, 안전성 제약, QA 정책을 정의하는 20개의 마크다운 파일. 오류에서 자동으로 새로운 규칙이 생성됩니다.
자기학습 파이프라인	오류는 `error-ledger.jsonl`에 기록되며, 스킬 매트릭스로 집계되고, 여러 프로젝트에서 반복 발생 시 영구 `.md` 규칙 파일로 승격됩니다.
프로파일	에이전트/스킬의 하위 집합을 활성화하여 토큰 사용량을 줄이는 사전 정의된 번들(예: `core`, `frontend`, `full`). 프로파일 전환 시 활성 컴포넌트 세트와 컨텍스트 예산이 변경됩니다.
대시보드 및 CLI	`vibeco` 명령어로 통계, 건강 상태 점검, 프로파일 전환 가능. 웹 UI는 에이전트 활동과 토큰/비용 사용량을 시각화합니다.

빠른 시작 (npm – 권장)

npx vibecosystem init            # 설치, 훅 등록, ~/.claude 레이아웃 생성
vibeco profile core             # 최소한의 "core" 번들(12개 에이전트, 32개 스킬) 로드
vibeco dashboard                # 모니터링 UI 열기

또는 원라인으로:

curl -fsSL https://raw.githubusercontent.com/vibeeval/vibecosystem/main/install-remote.sh | bash

또는 리포지토리 클론 후 ./install.sh --profile core 실행 가능.

일반적인 워크플로우

당신: "새 기능 추가"
 → 의도 분류기
 → 단계 1 (발견): 스카우트 + 아키텍트 + 프로젝트 매니저
 → 단계 2 (개발): 백엔드 개발자 + 프론트엔드 개발자 + DevOps + 도메인 전문가
 → 단계 3 (리뷰): 코드 리뷰어 + 보안 리뷰어 + QA 엔지니어
 → 단계 4 (QA 루프): 검증자 + TDD 가이드 (최대 3회 재시도)
 → 단계 5 (학습): 작업이 반복 실패 시 자기학습 에이전트가 규칙 작성
결과: 기능 코드 병합, 문서화, 미래 프로젝트에 활용 가능한 오류 기록 저장

모든 조율은 컨텍스트 인젝션 을 통해 이루어집니다. RPC 호출이 아니라 공유 마크다운 파일(PLAN.md, PROGRESS.md, CONTEXT.md)을 읽고 씁니다.

프로파일 (토큰 절약 번들)

프로파일	에이전트	스킬	일반적 사용
`core` (기본)	12	32	제한된 구현 및 검증 (4k/12k 토큰 예산)
`quality`	12	32	Core + 추가 편집/검증 체크
`frontend`	~30	~60	React/Next.js, CSS, 접근성
`backend`	~44	~74	API, DB, 보안
`full`	138	296	모든 기능, 더 큰 토큰 예산
`all`	138	296	`full`의 별칭

vibeco profile <이름>으로 전환 가능.

멀티-CLI 지원

CLI	설치 스크립트	제공 기능
Claude Code	`./install.sh`	전체 에이전트, 스킬, 훅, 규칙
Cursor IDE	`./install-cursor.sh /path/to/project`	6 MDC 규칙 + 에이전트 목록 + 스킬
Codex CLI (OpenAI)	`./install-codex.sh --profile core --install-luna-worker`	Core 허용 목록(32 스킬) 또는 전체 세트, 단일 `luna_worker` 모델 권한
OpenCode	`AGENTS.md` 수동 복사	스킬만

최근 주목할 만한 기능 (v3.4)

경량 core 런타임 – 기본적으로 최소한의 런타임을 실행하여 속도와 토큰 효율성 향상.
Claude 어댑터 모델 라우팅 – 작업에 따라 Opus, Sonnet, Haiku를 자동 선택.
지식 그래프 통합 – 코드 구조 그래프를 구축하여 컨텍스트 재사용 시 6–71배의 토큰 절약.
대시보드 v2 – 에이전트별 실시간 토큰 및 비용 추적.
수익화 스택 – 월렛 최적화, RevenueCat 패턴, Codex 오케스트레이션용 에이전트/스킬.
문서 생성 및 웹사이트 클론 – PDF/문서/XLSX 생성 및 픽셀 단위 정확한 사이트 클론 생성 가능한 에이전트.

아키텍처 스냅샷

Claude Code
 ├─ 훅 (74 TS 모듈) → 컨텍스트 주입
 ├─ 에이전트 (138 마크다운 프롬프트) ← PLAN/PROGRESS/CONTEXT 읽기/쓰기
 ├─ 스킬 (296 프롬프트 조각)
 ├─ 규칙 (20 마크다운 파일, 자동 생성)
 └─ 메모리 (PostgreSQL + pgvector) – 에이전트별 지속적 메모리, 스마트 재검색

자기학습 파이프라인은 지속적으로 작동: 오류 → 직관 → 통합기 → 규칙 → 글로벌 승격.

데이터 및 프라이버시

모든 아티팩트는 로컬 머신의 ~/.claude/에 저장됩니다.
외부 네트워크 호출, 텔레메트리, 클라우드 동기화는 없습니다.
학습된 규칙은 ~/.claude/rules/에 로컬에 저장됩니다.

기여 방법

리포지토리는 다음을 환영합니다:

특수 도메인(예: Flutter, Rails)용 새로운 에이전트 정의.
추가 프레임워크 또는 준수 규제용 스킬 패턴.
더 스마트한 컨텍스트 인젝션을 위한 개선된 훅.
문서, 튜토리얼, 번역.

결론 – vibecosystem은 Claude Code(및 호환 CLI)용 즉시 사용 가능한 "AI 소프트웨어 팀" 계층으로, 수백 개의 전문 에이전트, 스킬, 훅을 패키지화하고, 자기학습 피드백 루프를 제공하며, 모니터링을 위한 CLI/대시보드를 제공합니다. 개발자가 Claude Code를 단순한 수동 조작 어시스턴트가 아닌, 풀스택 개발 파트너로 여길 수 있도록 목표로 합니다.

vibeeval/vibecosystem