npm package: @felipevilas.design/prevc-spec
Description: PREVC-Spec Framework - AI-assisted development with structured planning and context protection
Author: FelipevDesign
Latest version: 1.0.3

# PREVC-Spec Framework

> AI-assisted development with structured planning and context protection.

[![npm version](https://badge.fury.io/js/@felipevilas.design%2Fprevc-spec.svg)](https://www.npmjs.com/package/@felipevilas.design/prevc-spec)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Installation

```bash
npx @felipevilas.design/prevc-spec init
```

> ⚠️ **PowerShell users**: Use quotes around the package name:
> ```powershell
> npx "@felipevilas.design/prevc-spec" init
> ```

Or install globally:

```bash
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

```bash
# 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](https://www.npmjs.com/~felipevilas.design)