바이브코딩 프로세스를 강제하는 MCP 서버 - PRD 없으면 코딩 없다
Project description
Clouvel
No spec, no code. PRD-First gate for AI coding.
The Problem
You ask AI to "build login" and it:
- Skips password reset
- Forgets social auth
- Ignores error handling
- Builds something different every time
Result: Hours of debugging "almost right" code.
The Solution
Clouvel blocks AI coding until you write a spec (PRD).
You: "Build login"
AI: ❌ BLOCKED - No PRD found. Write a spec first.
You: *writes PRD with requirements*
AI: ✅ PASS - PRD found. Coding allowed.
Same input → Same output. Every time.
Quick Start
# Install
pip install clouvel
# Add to Claude Code (auto-detects your platform)
clouvel install
# Start coding - can_code check runs automatically
claude
That's it. No config needed.
How It Works
- You ask AI to code something
- Clouvel checks for PRD (Product Requirements Document)
- No PRD? Blocked. Write the spec first.
- PRD exists? Allowed. AI codes with clear requirements.
Before & After
| Without Clouvel | With Clouvel |
|---|---|
| "Build login" → AI guesses | "Build login" → AI reads PRD |
| Missing features | All requirements included |
| Different results each time | Consistent output |
| Debug for hours | Works as specified |
Features
Free (Open Source)
| Feature | Description |
|---|---|
can_code |
PRD gate - blocks coding without specs |
start |
Project onboarding with PRD templates |
plan |
Detailed execution planning |
save_prd |
Save PRD from conversation |
| Knowledge Base | SQLite-based decision tracking + FTS5 search |
| Progress tracking | Track what's done and what's next |
| 8 project templates | web-app, api, cli, chrome-ext, discord-bot, landing-page, saas, generic |
Pro ($9.99/mo)
| Feature | Description |
|---|---|
manager |
8 C-Level managers review your code (PM, CTO, QA, CDO, CMO, CFO, CSO, Error) |
ship |
One-click test → verify → evidence generation |
| Error Learning | Learn from mistakes, auto-generate NEVER/ALWAYS rules |
| Dynamic meetings | AI-powered team discussions with Claude API |
Installation
Requirements
- Python 3.10+
- Claude Code, Claude Desktop, or VS Code with Claude extension
Install
pip install clouvel
Connect to Claude
Automatic (recommended):
clouvel install
Manual - Windows:
{
"mcpServers": {
"clouvel": {
"command": "py",
"args": ["-m", "clouvel.server"]
}
}
}
Manual - Mac/Linux:
{
"mcpServers": {
"clouvel": {
"command": "python3",
"args": ["-m", "clouvel.server"]
}
}
}
Usage Examples
Block coding without PRD
You: "Build a user authentication system"
Clouvel: ❌ BLOCKED
- PRD.md not found
- Architecture.md not found
💡 Write a PRD first. Use `start` to begin.
Start a new project
You: "Start a new project"
Clouvel: 🚀 Project detected: web-app
Questions:
1. What's the main goal?
2. Who are the users?
3. What are the core features?
→ Generates PRD from your answers
Get manager feedback (Pro)
You: "Review my login implementation"
👔 PM: User story covers happy path, but what about failed attempts?
🛠️ CTO: Consider rate limiting for brute force protection.
🧪 QA: Need tests for edge cases - empty password, SQL injection.
🔒 CSO: ⚠️ CRITICAL - Password hashing not implemented.
Status: NEEDS_REVISION
Documentation
Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
Changelog
See CHANGELOG.md for version history.
License
MIT License - see LICENSE for details.
Stop debugging AI code. Start with a spec.
Website •
Issues •
Get Pro
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file clouvel-1.6.2.tar.gz.
File metadata
- Download URL: clouvel-1.6.2.tar.gz
- Upload date:
- Size: 88.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5ffe4ebf9493229211b74ca5b358c738bc5bda703ddd197d5c40de207624f3e8
|
|
| MD5 |
9ab4b9ad738e7cfacb17c3c9496ac27c
|
|
| BLAKE2b-256 |
060b758ac98e913b83379959330489fdc385855c4874c2a89e634077aaddf44a
|
File details
Details for the file clouvel-1.6.2-py3-none-any.whl.
File metadata
- Download URL: clouvel-1.6.2-py3-none-any.whl
- Upload date:
- Size: 117.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4c6ed9215066e50f780b174d5de84e272a8410bb516ddf1ad1101ad622c1e58f
|
|
| MD5 |
2f4e5691ab57fefb31c20c0b2637167e
|
|
| BLAKE2b-256 |
bd4c12c3983298c3400857c27c0dac7465d6bc6a57e32bdd63820de5c9f2f544
|