Vibe Coding Report
AI 기반 프로젝트 평가 및 개선 보고서 자동 생성 VS Code 확장
바이브 코딩(AI 페어 프로그래밍)을 통해 프로그램을 제작할 때, 프로젝트 상태를 분석하고 AI 에이전트에게 전달할 개선 프롬프트를 자동으로 생성하는 확장 프로그램입니다.
✨ Features
📊 삼중 보고서 시스템
- Project Evaluation Report - 프로젝트 현황 평가 (10개 카테고리 점수)
- Project Improvement Exploration Report - 개선 사항 탐색 및 추적
- Prompt.md - AI 에이전트용 실행 프롬프트
🔄 증분 업데이트
- 마커 기반 섹션 업데이트 (전체 덮어쓰기 X)
- 이전 세션 내용 보존
- 변경된 부분만 AI에게 전달
✅ 적용된 개선사항 추적
- 이미 적용된 개선사항 자동 제외
- 우선순위(P1/P2/P3)별 분류
- 다음 보고서에서 중복 제안 방지
📋 AI 친화적 출력
- 클립보드에 분석 프롬프트 자동 복사
- Copilot Chat에 바로 붙여넣기 가능
- 순차 실행 가능한 프롬프트 구조
🖥️ 사이드바 UI
- 프로젝트 요약 Webview (CSP 보안 적용)
- 세션 히스토리 TreeView
- 자동 새로고침 (devplan/*.md 변경 감지)
🚀 Installation
VSIX 파일로 설치 (권장)
GitHub Releases에서 최신 .vsix 파일을 다운로드하여 설치합니다.
방법 1: VS Code UI에서 설치
- Releases 페이지에서
vibereport-x.x.x.vsix 다운로드
- VS Code 열기
- Extensions 사이드바 열기 (
Ctrl+Shift+X)
- 상단
... 메뉴 클릭 → Install from VSIX... 선택
- 다운로드한
.vsix 파일 선택
- VS Code 재시작
방법 2: 명령줄에서 설치
# VSIX 파일 다운로드 후
code --install-extension vibereport-0.1.0.vsix
방법 3: PowerShell/터미널에서 직접 다운로드 및 설치
# GitHub에서 직접 다운로드 (PowerShell)
Invoke-WebRequest -Uri "https://github.com/Stankjedi/projectmanager/releases/download/v0.1.0/vibereport-0.1.0.vsix" -OutFile "vibereport-0.1.0.vsix"
code --install-extension vibereport-0.1.0.vsix
# Linux/Mac
curl -L -o vibereport-0.1.0.vsix https://github.com/Stankjedi/projectmanager/releases/download/v0.1.0/vibereport-0.1.0.vsix
code --install-extension vibereport-0.1.0.vsix
Development (개발자용)
cd vibereport-extension
pnpm install
pnpm run compile
# F5 눌러서 Extension Development Host 실행
📖 Usage
보고서 업데이트
- Command Palette 열기 (
Ctrl+Shift+P)
VibeCoding: Update Project Reports 실행- 분석 프롬프트가 클립보드에 복사됨
- Copilot Chat에 붙여넣어 분석 요청
명령어 목록
| 명령어 |
설명 |
VibeCoding: Update Project Reports |
프로젝트 분석 및 보고서 업데이트 |
VibeCoding: Open Evaluation Report |
평가 보고서 열기 |
VibeCoding: Open Improvement Report |
개선 보고서 열기 |
VibeCoding: Open Prompt File |
AI 프롬프트 파일 열기 |
VibeCoding: Initialize Project Reports |
보고서 초기화 |
VibeCoding: Show Last Run Summary |
마지막 실행 요약 보기 |
⚙️ Configuration
| Setting |
Description |
Default |
vibereport.reportDirectory |
보고서 저장 디렉토리 |
devplan |
vibereport.snapshotFile |
스냅샷 상태 파일 경로 |
.vscode/vibereport-state.json |
vibereport.enableGitDiff |
Git 기반 변경 분석 활성화 |
true |
vibereport.excludePatterns |
스캔 제외 패턴 |
["**/node_modules/**", ...] |
vibereport.maxFilesToScan |
최대 스캔 파일 수 |
5000 |
vibereport.autoOpenReports |
업데이트 후 자동 열기 |
true |
vibereport.language |
보고서 언어 (ko / en) |
ko |
📁 Generated Files
devplan/
├── Project_Evaluation_Report.md # 종합 평가 보고서
├── Project_Improvement_Exploration_Report.md # 개선 탐색 보고서
└── Prompt.md # AI 에이전트용 프롬프트
마커 기반 섹션 업데이트
보고서의 특정 섹션만 자동 업데이트됩니다:
<!-- AUTO-OVERVIEW-START -->
이 영역만 자동 업데이트
<!-- AUTO-OVERVIEW-END -->
🏗️ Architecture
vibereport-extension/
├── src/
│ ├── extension.ts # 진입점
│ ├── commands/ # 명령 핸들러
│ │ ├── index.ts
│ │ └── updateReports.ts # 핵심 워크플로우
│ ├── services/ # 비즈니스 로직
│ │ ├── workspaceScanner.ts
│ │ ├── snapshotService.ts
│ │ ├── reportService.ts
│ │ └── __tests__/
│ ├── views/ # UI 컴포넌트
│ │ ├── SummaryViewProvider.ts
│ │ ├── HistoryViewProvider.ts
│ │ └── __tests__/
│ ├── models/ # 타입 정의
│ │ ├── types.ts
│ │ ├── errors.ts
│ │ └── constants.ts
│ └── utils/ # 유틸리티
│ ├── markdownUtils.ts
│ ├── timeUtils.ts
│ ├── logger.ts
│ └── __tests__/
├── images/
│ └── icon.png
├── package.json
├── tsconfig.json
└── vitest.config.ts
🧪 Testing
# 단위 테스트 실행
pnpm test
# 커버리지 리포트
pnpm run test:coverage
# 테스트 감시 모드
pnpm test -- --watch
현재 49개 단위 테스트 통과 (서비스/유틸/뷰 레이어)
📚 API Documentation
# TypeDoc으로 API 문서 생성
pnpm run docs
# docs/ 폴더에 HTML 문서 생성됨
🛠️ Development
Prerequisites
- Node.js 18+
- pnpm
- VS Code 1.100+
Building
pnpm install
pnpm run compile
Packaging
pnpm run package
# vibereport-0.1.0.vsix 생성
📝 Changelog
v0.3.11 (2025-12-04)
- Command Layer 테스트 확장: SetProjectVisionCommand, UpdateReportsCommand 테스트 추가 (86 → 102 테스트)
- markerUtils 분리: SRP 원칙에 따라 마커 처리 로직을 별도 모듈로 분리
- 스냅샷 캐싱: 30초 TTL 캐시로 연속 스캔 성능 향상
- Git 라인 메트릭: 파일별 추가/삭제 라인 수 추적 기능 추가
v0.3.10 (2025-12-04)
- TODO 기반 프롬프트 구조: 분석 프롬프트에 10개 TODO 체크리스트 추가
- AI 에이전트가 반드시 순차적으로 TODO를 실행하도록 강화
- AGENTS.md에 Anti-Stalling 규칙 추가 (멈춤 방지)
v0.3.9 (2025-12-04)
- Prompt.md 예시 코드 작성: 보고서 업데이트 시 Prompt.md에 실제 구현 예시 코드가 포함되도록 개선
- AI 에이전트가 프롬프트를 받을 때 참고할 수 있는 코드 예시 제공
- 코드 작성 가이드라인 추가
v0.3.8 (2025-12-04)
- OPT 항목 영어 출력: Prompt.md에 OPT 항목을 영어로 작성하고, 이를 파싱하여 클립보드에 복사
- 개선 보고서의 한글 OPT 내용 대신 Prompt.md의 영어 OPT 항목 사용
- OPT 상태(pending/done) 기반 정렬 추가
v0.3.7 (2025-12-04)
- 다중 선택 지원: 여러 개의 프롬프트 또는 OPT 항목을 동시에 선택하여 클립보드에 복사
- 선택한 항목들이 구분선과 함께 결합되어 복사됨
v0.3.6 (2025-12-04)
- OPT 항목 선택: 개선 프롬프트 생성 시 코드 품질 및 성능 최적화 항목(OPT) 선택 가능
- 프롬프트와 OPT 항목이 구분되어 표시
v0.3.5 (2025-12-03)
- UX 단순화: 새 프롬프트 생성 기능 제거, 기존 프롬프트 선택식 복사 기능만 유지
- 선택 가능한 항목 없을 때 명확한 안내 메시지 표시
📝 License
MIT
🤝 Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing)
- Commit your changes (
git commit -m 'Add amazing feature')
- Push to the branch (
git push origin feature/amazing)
- Open a Pull Request
🔗 Links
Made with ❤️ for Vibe Coding
