nykooi1/vibe-wise

VibeWise – 학습에 초점을 맞춘 AI 안내 코딩

정의

• Anthropic의 Claude Code와 OpenAI의 Codex용 플러그인으로, 코드 생성 워크플로우에 학습 모드를 추가합니다.
• AI는 먼저 접근 방식의 개요를 요청하고, 장단점을 논의하며, 코드를 작성하기 전에 익숙하지 않은 개념을 설명합니다.
• 설계를 확인하면 AI가 구현을 생성한 다음 변경된 내용과 이유에 대한 간결한 보고서를 제공합니다.

대상

• 개발하면서 이해를 깊게 하려는 주니어 개발자 또는 모든 사람.
• 새로운 스택이나 아키텍처를 구조적으로 탐색해야 하는 경험 많은 엔지니어.
• 설계 결정을 명시적으로 유지하고 코드 소유권을 보유하려는 팀.

작동 방식

1. 설치 – Claude Code의 내장 Anthropic Directory를 통해 설치합니다 (/plugin install vibe-wise@anthropic-plugin-directory). 또는 GitHub 마켓플레이스를 통해. Codex의 경우 마켓플레이스를 추가하고 codex plugin add vibe-wise@vibe-wise로 설치합니다.
2. 학습 세션 시작 – /vibe-wise:learn(Claude Code) 또는 $vibe-wise:learn(Codex)을 실행합니다. 플러그인이 일련의 체크포인트를 안내합니다.
   • 빌드 – AI와 함께 문제를 추론합니다 (예: 메모와 폴더가 어떻게 관련되어야 하는지).
   • 설계 – AI가 설계를 제안합니다. 확인하고 계속하거나 논의할 수 있습니다.
   • 구현 – 승인하면 AI가 코드를 작성하고 테스트를 실행하며 변경 사항을 보고합니다.
3. 메모 및 컨텍스트 – 모든 결정, 다이어그램, 설명은 프로젝트 내 숨겨진 .vibe-wise/ 폴더에 저장됩니다. 이 메모는 향후 세션에서 AI의 컨텍스트에 자동으로 추가되어 어시스턴트가 이전 논의를 기억합니다.
4. 환경 설정 – 학습 수준(초급, 중급, 고급)을 설정하고 체크포인트 빈도, 질문 스타일 등을 즉시 조정할 수 있습니다.
5. 초기화 / 업데이트 – /vibe-wise:reset으로 처음부터 시작하거나 일반적인 Claude Code 또는 Codex 플러그인 업데이트 명령으로 플러그인을 업데이트합니다.

주요 기능

• 코드 생성 전 대화형 설계 논의.
• 설명 우선 접근 방식 – AI가 개념, 장단점, 익숙하지 않은 부분을 설명합니다.
• 체크포인트 시스템 – 구조화되었지만 선택적인 단계(빌드, 설계, 구현)로 명확한 "확인" 또는 "논의" 작업이 있습니다.
• 지속적인 학습 메모 – 로컬에 저장되고 버전 관리되며 기본적으로 Git에서 무시됩니다.
• 외부 종속성 없음 – Python 3만 필요합니다. 플러그인은 호스트 IDE/어시스턴트 내에서 실행됩니다.

중요성

• AI 지원 코딩을 블랙박스 코드 덤프에서 빌드하면서 배우는 경험으로 전환합니다.
• 개발자가 아키텍처 결정에 대한 소유권을 유지하고 생성된 코드를 이해하도록 돕습니다.
• 간단한 스크립트부터 풀스택 앱까지 모든 프로젝트에 적용할 수 있는 재사용 가능한 워크플로우를 제공합니다.

라이선스

• MIT 라이선스 하에 오픈소스로, 상업적 사용, 수정, 재배포가 허용됩니다.