🎯프레임워크

Vibe Engineering: Claude 코드 에이전트를 위한 세션 관리 프레임워크

AI 코딩 세션의 범위, 작업 추적, 테스트 게이트를 관리하는 Claude 전용 하네스 프레임워크

#Claude#AI코딩#에이전트#칸반#코드리뷰

개요

Vibe Engineering은 Claude Code 에이전트가 코딩할 때 발생하는 '드리프트(방향성 이탈)' 문제를 해결하는 프레임워크입니다. AI가 빠르게 코드를 작성하지만, 어디까지 작업해야 하는지, 무엇을 건드리지 말아야 하는지, 언제 멈춰야 하는지를 관리해줍니다.

주요 기능

1. 범위 제어 (Scope Guard)

▸AI가 수정할 수 있는 파일과 코드 범위를 명확히 설정

▸예상치 못한 변경을 방지

2. 단계별 게이트 (Phase Gates)

▸기획(Planning), 디자인(Design), 리뷰(Review) 등 6단계 관리

▸각 단계가 완료되어야 다음 단계로 진행

3. 칸반 보드

▸작업 진행 상황을 시각적으로 추적

▸세션 중 발생한 모든 변경사항 기록

4. 코드 리뷰 자동화

▸`/vibe-review` 커맨드로 작성한 코드를 자체 평가

▸객관적인 품질 검증 제공

핵심 컴포넌트

컴포넌트	역할	구현 방식
Harness	작업 범위 및 기록 관리	스코프 가드, 칸반
Planning	제품 방향성 정의	6단계 게이트
Design	UI/UX 설계	HTML 프로토타입
Review	코드 품질 검증	자동 평가 시스템
Loop	재시도 로직	에러 예산 관리

왜 필요한가?

기존의 프롬프트 엔지니어링과 컨텍스트 엔지니어링은 AI에게 무엇을 말할지와 무엇을 알려줄지를 다룹니다.

Vibe Engineering은 그 사이의 공백, 즉 실제 작업 세션 동안 일어나는 일들을 관리합니다:

▸어떤 파일을 수정할 수 있는가?

▸언제 작업을 멈춰야 하는가?

▸무엇이 최종 결과로 남는가?

기술 스펙

▸

언어: Python 3.11 / 3.12 / 3.13

▸

라이선스: MIT

▸

테스트: GitHub Actions 자동화

시작하기

bash

# 1. 머신 등록 (sync.json 생성)
~/.claude/skills/vibe-harness/sync.json

# 2. 칸반 보드 확인
# 작업 진행 상황을 실시간으로 추적

활용 사례

▸

장기 프로젝트: AI와 함께하는 며칠 이상의 개발 작업

▸

팀 협업: AI가 작성한 코드의 추적성 확보

▸

품질 관리: 자동 리뷰로 일관된 코드 품질 유지

Vibe Engineering은 AI 코딩의 속도는 유지하면서, 방향성과 품질을 함께 관리하는 실용적인 솔루션입니다.