nestjs-review-agent

# NestJS Review Agent

> 🔍 AI-powered code review prompts for NestJS/TypeScript projects

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)

A self-learning code review agent that works with **GitHub Copilot**, **Cursor**, and any LLM-powered IDE.

## ✨ Features

- 🛡️ **Security checks** - Injection, auth, secrets, input validation
- 🐛 **Bug prevention** - Null safety, async/await, error handling
- 🏗️ **Architecture rules** - NestJS patterns, DI, module boundaries
- ✨ **Code quality** - Types, naming, immutability, no magic numbers
- 📚 **Self-learning** - Remembers patterns it finds

## 🚀 Quick Start

### GitHub Copilot (VS Code)

1. Open Cursor Chat (`⌘+I` / `Ctrl+I`)
2. Type:

```
Review origin/main..origin/feature using path/to/REVIEW.md
```

### Cursor

1. Open Composer (`⌘+I`) or Chat (`⌘+L`)
2. Add `REVIEW.md` to context (drag or `@` mention)
3. Type:

```
Review origin/main..origin/feature
```

## 📦 Installation

**Option A: Clone (recommended)**

```bash
git clone https://github.com/shouryaraj/nestjs-review-agent .review-agent
echo ".review-agent/" >> .git/info/exclude  # Keep out of git history
```

**Option B: Copy just the prompt**

```bash
curl -o REVIEW.md https://raw.githubusercontent.com/shouryaraj/nestjs-review-agent/main/REVIEW.md
```

**Option C: Reference directly**

```
Review HEAD using ~/path/to/nestjs-review-agent/REVIEW.md
```

## 📁 Files

```
nestjs-review-agent/
├── REVIEW.md              ← Main review prompt (use this!)
├── learned-patterns.md    ← Agent learns here (auto-updated)
├── rules/
│   ├── security.md        ← Security rules
│   ├── bugs.md            ← Bug prevention rules
│   ├── architecture.md    ← Architecture rules
│   └── quality.md         ← Code quality rules
└── examples/
    └── review-output.md   ← Example review output
```

## 💻 Usage Examples

```