PREVC-Spec Framework

AI-assisted development with structured planning and context protection.

Installation

npx @felipevilas.design/prevc-spec init

⚠️ PowerShell users: Use quotes around the package name:

npx "@felipevilas.design/prevc-spec" init

Or install globally:

npm install -g @felipevilas.design/prevc-spec
prevc-spec init

What is PREVC-Spec?

PREVC-Spec is a framework that helps AI coding assistants work more effectively by:

• Protecting context - Saving information to files instead of relying on memory
• Structured phases - Breaking work into 5 clear phases (Planning, Review, Execution, Validation, Confirmation)
• Quality gates - Requiring approval before execution
• Error handling - Protocols for when things go wrong

How It Works

1. Install: npx @felipevilas.design/prevc-spec init
2. Configure: AI automatically detects your project
3. Use: Start complex features with /prevc-spec command

Features

• 📋 Spec-Driven Development - Plan before you code
• 🔄 5-Phase Workflow - PREVC (Plan-Review-Execute-Validate-Confirm)
• 🛡️ Anti-Loop Protocol - Prevents repetitive errors
• ✅ Phase X Validation - Verification before completion
• 🤖 14 Agent Specialists - Expert personas for different tasks
• 🔧 36 Skills - Specialized capabilities (from Antigravity Kit)
• 🎯 Auto-Configuration - AI detects and configures your project

Commands

# Initialize in current project
npx @felipevilas.design/prevc-spec init

# Update to latest version  
npx @felipevilas.design/prevc-spec update

# Remove from project
npx @felipevilas.design/prevc-spec remove

What Gets Installed

your-project/
├── .agent/
│   ├── rules/           # 9 rule files + templates
│   ├── skills/          # 36 AI skills
│   └── workflows/       # PREVC workflow
├── .context/
│   ├── agents/          # 14 agent specialists
│   ├── docs/            # User guides
│   ├── skills/          # 11 context skills
│   └── templates/       # PRD, SPEC, LOG templates
└── prevc.config.js      # Configuration

Documentation

After installation, find documentation in:

• .context/docs/QUICK-START.md - Get started in 5 minutes
• .context/docs/USER-GUIDE.md - How to use the framework
• .context/docs/TECHNICAL-MANUAL.md - Detailed technical reference

Compatible With

• Antigravity (Claude) - Primary target
• GitHub Copilot Chat - Works great
• Cursor - Fully compatible
• Any AI that reads project files

License

MIT

Author

Felipe Vilas - @felipevilas.design