clouvel 2.1.0

바이브코딩 프로세스를 강제하는 MCP 서버 - PRD 없으면 코딩 없다

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

1. You ask AI to code something
2. Clouvel checks for PRD (Product Requirements Document)
3. No PRD? Blocked. Write the spec first.
4. 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 (v1.9: --template, --guide, --init)
setup_cli	Project setup with hooks (v1.9: --rules, --hook)
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)
quick_perspectives	Fast pre-coding check with key questions
ship	One-click lint → test → build → evidence generation
Error Learning	Learn from mistakes, auto-generate NEVER/ALWAYS rules
Dynamic meetings	AI-powered team discussions with Claude API

Get Pro →

---

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

v1.9 Consolidated Tools

# Before: Multiple tools
get_prd_template(template="web-app")
get_prd_guide()
init_docs()

# After: Single tool with options
start --template=web-app    # Get template
start --guide               # Get PRD writing guide
start --init                # Initialize docs folder

# Before: Separate hook tools
init_rules(template="web")
hook_design(trigger="pre_code")
hook_verify(trigger="post_code")

# After: Single tool with options
setup_cli --rules=web              # Initialize rules
setup_cli --hook=design            # Create design hook
setup_cli --hook=verify            # Create verify hook

---

Documentation

• Full Documentation
• PRD Templates
• FAQ

---

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

• Report bugs
• Request features
• Join discussions

---

Deprecation Notice (v1.9)

The following tools show deprecation warnings and will be removed in v2.0:

Deprecated	Use Instead
scan_docs	can_code
analyze_docs	can_code
verify	ship
gate	ship
get_prd_template	start --template
get_prd_guide	start --guide
init_docs	start --init
init_rules	setup_cli --rules
hook_design	setup_cli --hook=design
hook_verify	setup_cli --hook=verify
handoff	record_decision + update_progress

---

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