soumatheusgomes/vibe-coding-toolkit

🎧 Vibe Coding Toolkit – AI 지원 개발을 위한 실용적인 워크플로우

무엇인가요 – 대규모 언어 모델 코딩 어시스턴트(Claude Code, OpenAI Codex 등)를 소프트웨어 팀의 규율 있는 구성원으로 활용할 수 있도록 해주는 문서화된 도구, 프롬프트, 설정 템플릿의 모음입니다. 이 리포지토리는 새로운 모델을 제공하지 않으며, 프로세스와 프로세스를 생산 환경에서 반복 가능하게 만드는 '접착제'(플러그인, 훅, 린트 규칙, 서브에이전트 오케스트레이션)를 제공합니다.

왜 중요한가요 – 많은 AI 코딩 가이드는 "큰 프롬프트를 붙여넣고 운을 기원하는 것"에서 끝납니다. 이 툴킷은 실제 생산 환경의 핀테크 프로젝트에서 저자가 겪은 구체적인 고통을 해결하는 현실적인 흐름을 보여줍니다:

• 세션 지속성(실행 간 메모리 유지)
• 에이전트가 과도하게 생성하거나 요청에서 벗어나는 것을 방지
• 파일을 겹치지 않도록 전문화된 병렬 서브에이전트(검토, DB, 테스트) 실행
• 경고를 추적 가능한 오류로 전환하는 자동 품질 게이트(ESLint/Biome) 강제
• 코드를 작성하기 전에 브레인스토밍 → 계획 → 구현 → 검토 루프를 강제하는 가벼운 "스уп퍼파워스" 규율

핵심 구성 요소

구성 요소	기능	사용 방법
스уп퍼파워스 (docs/tools/01‑superpowers.md)	브레인스토밍 → 계획 → 구현 → 검토 사이클을 강제; 가장 영향력 있는 습관.	superpowers@claude-plugins-official 플러그인을 Claude-Code에 설치하고, 모델에게 코드를 요청하기 전에 기술을 호출하세요.
서브에이전트 오케스트레이션 (02‑subagent‑orchestration.md)	여러 전문 에이전트 인스턴스를 파도 단위로 실행하여 동시에 동일한 파일을 편집하지 않도록 합니다.	문서에 설명된 프로토콜을 따르세요. 파도 디스패치 프롬프트 템플릿도 리포지토리에 포함되어 있습니다.
RTK 토큰 프록시 (03‑rtk-token-proxy.md)	git status, diff, log 등 반복적인 명령어를 컴팩트하고 토큰 절약형으로 재작성하는 CLI.	세션 내에서 해당 명령어의 대체로 제공된 스크립트를 사용하세요.
포니테일 & 캐브먼 성격 (04‑ponytail.md / 05‑caveman.md)	에이전트의 집중과 간결함을 유지하는 간단한 의사결정 및 커뮤니케이션 정책.	작업 시작 전에 Claude/Codex 세션에 성격 프롬프트를 추가하세요.
품질 게이트(ESLint/Biome) (06‑eslint‑biome‑quality‑gates.md)	선택된 린트 경고를 하드 에러로 전환하고, 파일당 350줄 제한을 강제하며, 위반 사항을 기록합니다.	준비된 프롬프트 08‑eslint‑quality‑gates‑install.md를 실행하거나(templates/eslint/) 설정 파일을 복사하세요.
Graphify & Context7 (07‑graphify.md / 12‑context7.md)	코드베이스의 지속 가능한 지식 그래프를 구축하고, 최신 라이브러리 문서를 모델의 컨텍스트에 주입합니다.	설명된 옵션의 MCP 서버를 배포하세요. 툴킷은 Claude에 연결하는 방법을 보여줍니다.
옵시디안 메모리 (08‑obsidian‑memory.md)	옵시디안 백업에 저장된 장기적인 프로젝트 노트로, MCP 프로토콜을 통해 에이전트가 접근합니다.	백업을 초기화하고 MEMORY.md 인덱스를 해당 위치로 지정하세요.
프롬프트 라이브러리 (docs/prompts/*.md)	lint 정리, 다중 에이전트 코드 리뷰, 파일 크기 리팩터링 등 일반적인 작업용 복사 가능한 프롬프트.	Claude/Codex(또는 URL을 읽을 수 있는 임의의 LLM)에 전체 프롬프트를 붙여넣고 에이전트가 실행하도록 하세요.
템플릿 (templates/…)	뼈대가 되는 CLAUDE.md, ESLint 설정, 훅 예시, CLI용 최소 settings.json.	프로젝트에 필요한 파일을 복사하고 Playbook에 설명된 대로 경로를 조정하세요.

시작하기

1. Claude Code 설치 및 공식 플러그인 마켓플레이스 추가 (README의 원라인 명령어).

   npm install -g @anthropic-ai/claude-code
   /plugin marketplace add anthropics/claude-plugins-official
   /plugin install superpowers@claude-plugins-official
   cp templates/CLAUDE.md.template CLAUDE.md
   

2. Playbook 읽기 – docs/02-playbook-onboarding.md. 전체 엔드투엔드 예제 프로젝트를 따라가며 각 도구가 타임라인에 어떻게 들어가는지(설치 → 설정 → 브레인스토밍 → 계획 → 서브에이전트 파도 → 검토 → 배포) 보여줍니다.
3. 단일 도구 선택. 예를 들어 350줄 규칙을 강제하려면 README에 나와 있는 원라인 프롬프트를 실행하거나 templates/eslint/에서 ESLint 설정을 복사하세요.

누구에게 적합한가요

• Claude Code, Codex, 또는 유사한 LLM 코딩 어시스턴트에 이미 접근이 가능한 개발자로, 재현 가능하고 생산 환경 대응 워크플로우를 원하는 사람.
• "프롬프트 붙여넣기 + 기대" 세션, 상황 인식 상실, 에이전트 간 파일 오버라이드에 어려움을 겪는 팀.
• CLI 작업에 어느 정도 익숙하고, 짧은 포르투갈어 문서를 읽는 데 부담이 없는 사람(핵심 개념은 인라인 설명되어 있으며, 실제 프롬프트는 영어로 제공).

성숙도 및 상태

• 리포지토리는 비공개 핀테크 프로젝트에서 추출된 메소드입니다(원본 코드는 NDA 하에 있음). 저자는 실제 생산 환경에서 이 실천을 사용해왔다고 하지만, 리포지토리는 컴파일된 바이너리 없이 문서, 프롬프트, 설정 템플릿만 포함합니다.
• 역사가 짧은 이유는 이 리포지토리가 생명 있는 가이드를 의도하고 있기 때문입니다. 저자가 워크플로우를 개선하거나 새로운 플러그인을 추가할 때마다 업데이트가 예상됩니다.

라이선스 – MIT (see LICENSE).

---

결론 – Vibe Coding Toolkit은 AI 코딩 어시스턴트를 규율 있는 팀원으로 바꾸는 구체적이고 오픈소스의 플레이북입니다. 프롬프트 즉흥 허접에서 재현 가능하고 생산 환경 대응 가능한 개발 흐름으로 전환할 수 있도록, 빠짐없이 필요한 '접착제'(플러그인, 프롬프트, 린트 게이트, 서브에이전트 오케스트레이션)를 제공합니다.