clouvel 0.3.3

바이브코딩 프로세스를 강제하는 MCP 서버

Clouvel

바이브코딩 프로세스를 강제하는 MCP 서버.

PRD 없으면 코딩 없다.

현재 버전

• MCP 서버: v0.3.3
• VS Code 확장: v0.10.2
• Cursor 확장: v0.10.2

설치

방법 1: VS Code/Cursor 확장 (추천)

1. 확장 탭에서 "Clouvel" 검색 → 설치
2. Ctrl+Shift+P → "Clouvel: Claude Desktop 설정" 선택
3. 끝!

방법 2: 수동 설정

Claude Desktop 설정 (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "clouvel": {
      "command": "uvx",
      "args": ["clouvel"]
    }
  }
}

핵심 기능

can_code - 코딩 차단

코딩해도 돼? (can_code로 docs 폴더 확인)

• docs 폴더 없음 → 코딩 금지
• 필수 문서 부족 → 코딩 금지
• 모든 문서 있음 → 코딩 허용

init_docs - 문서 초기화

init_docs로 docs 폴더 만들어줘

5개 템플릿 자동 생성:

• PRD.md
• ARCHITECTURE.md
• API.md
• DATABASE.md
• VERIFICATION.md

전체 도구 목록

도구	설명
can_code	코딩 가능 여부 확인 - 핵심 기능
init_docs	docs 폴더 초기화 + 템플릿 생성
scan_docs	docs 폴더 파일 목록
analyze_docs	필수 문서 체크, 빠진 거 알려줌
get_prd_template	PRD 템플릿 생성 (11개 섹션)
write_prd_section	섹션별 PRD 작성 가이드
get_prd_guide	PRD 작성 가이드
get_verify_checklist	검증 체크리스트
get_setup_guide	설치/설정 가이드

사용 플로우

1. can_code → "코딩 금지" (문서 없음)
2. init_docs → 빈 템플릿 생성
3. Claude와 함께 PRD 작성
4. can_code → "코딩 허용"
5. 코딩 시작!

필수 문서

can_code가 체크하는 것들:

• PRD (제품 요구사항) - 가장 중요
• 아키텍처 문서
• API 스펙
• DB 스키마
• 검증 계획

다 있어야 코딩 허용.

VS Code/Cursor 확장 기능

• 원클릭 MCP 서버 설정
• 사이드바에서 문서 상태 확인
• 코드 파일에 경고 표시 (Diagnostic)
• 프로젝트 유형별 PRD 템플릿 (수익화/개인/사내)

로드맵

피드백에 따라 변경/추가/삭제될 수 있습니다.

버전	목표
v0.1.0 ✅	MVP - can_code, scan_docs, init_docs 등 9개 도구
v0.2.0	문서 상태 추적 - freshness 체크, PROGRESS.md 자동화
v0.3.0	문서-코드 동기화 - Git 커밋 후 문서 미수정 감지
v0.4.0	컨텍스트 유지 - 세션 요약 저장/복원, handoff 생성
v0.5.0	에러 학습 - 에러 패턴 기록/검색
v1.0.0	안정화 + 웹 대시보드 + Boris 검증 통합
v2.0.0	shovel-setup 통합 - 완전한 바이브코딩 시스템 (미정)

자세한 내용: ROADMAP.md

왜?

바이브코딩 = AI가 코드 짬. 근데 PRD 없이 시작하면 = 나중에 다 뜯어고침.

Clouvel = 문서 없으면 코딩 못 하게 강제.

피드백 / 버그 리포트

GitHub Issues에 남겨주세요!

License

MIT