Liz AI Agent

A Liz e uma agente de IA que vem pre-configurada em cada projeto gerado pelo PlazerCLI. Ela conhece toda a stack, estrutura de pastas, convencoes e padroes do projeto — e esta pronta para ajudar em qualquer IDE com suporte a IA.

A Liz nao e um chatbot generico. Ela tem contexto completo do SEU projeto especifico, incluindo quais frameworks, features e integracoes voce escolheu.

O PlazerCLI gera 3 arquivos de configuracao para a Liz:

Arquivo	Ferramenta	Proposito
CLAUDE.md	Claude Code (Anthropic)	Contexto completo do projeto para o Claude
.cursor/rules/liz.mdc	Cursor IDE	Regras e convencoes para o Cursor AI
AGENTS.md	Codex / outros agentes	Instrucoes genericas para qualquer agente IA

O CLAUDE.md e personalizado para cada projeto e inclui:

# CLAUDE.md (exemplo gerado)

## Projeto
- Nome: meu-saas
- Stack: Next.js + NestJS + PostgreSQL
- Gerado por: PlazerCLI v2.0

## Estrutura
- apps/api/ — Backend NestJS com Prisma
- apps/web/ — Frontend Next.js com Tailwind

## Convencoes
- Usar Prisma para todas as queries de banco de dados
- Validacao com Zod em todos os endpoints
- Autenticacao: JWT + Magic Link + Google OAuth
- RBAC com CASL (roles: OWNER, ADMIN, MEMBER)
- Organizacoes multi-tenant com coluna organizationId

## Features habilitadas
- Auth: JWT, Magic Link, Google OAuth
- SaaS: RBAC, Organizations, Stripe Billing
- API: Zod validation, Rate Limiting, Pino Logger, Swagger
- Infra: Redis, BullMQ, SMTP, WebSockets
- Integracoes: Stripe, ViaCEP, WhatsApp

## Comandos
- pnpm run dev — inicia frontend + backend
- pnpm run build — build de producao
- pnpm run test — roda testes
- docker compose up -d — sobe infra local

# .cursor/rules/liz.mdc (exemplo gerado)
---
description: Regras da Liz AI para o projeto meu-saas
globs: ["**/*.ts", "**/*.tsx"]
---

# Liz - AI Agent Rules

## Quem sou eu
Eu sou a Liz, agente de IA do projeto meu-saas gerado pelo PlazerCLI.

## Stack
- Backend: NestJS com Prisma ORM (PostgreSQL)
- Frontend: Next.js com Tailwind CSS
- Auth: JWT + Magic Link + Google OAuth

## Regras de codigo
1. Sempre usar TypeScript strict mode
2. Validar inputs com Zod schemas
3. Usar Prisma client para queries (nunca raw SQL)
4. Seguir o padrao NestJS: Module > Controller > Service
5. Componentes React: functional components com hooks
6. Estilizacao: sempre Tailwind CSS (nunca CSS inline ou modules)

## Padroes
- Nomes de arquivo: kebab-case (user-profile.service.ts)
- Exports: named exports (nunca default)
- Erros: usar HttpException do NestJS ou classes customizadas
- Testes: descrever com "should" em ingles

A Liz funciona automaticamente com as ferramentas suportadas:

• Claude Code: Abra o terminal no diretorio do projeto e rode claude. O CLAUDE.md sera lido automaticamente.
• Cursor: Abra o projeto no Cursor. As regras em .cursor/rules/ sao carregadas automaticamente.
• Outros agentes: Aponte o agente para o arquivo AGENTS.md na raiz do projeto.

Exemplos de perguntas que voce pode fazer:

# "Crie um CRUD completo para Products com nome, preco e descricao"
# A Liz vai gerar: module, controller, service, dto, schema Prisma, rota frontend

# "Adicione um endpoint de webhook para processar pagamentos do Stripe"
# A Liz sabe que voce tem Stripe e vai gerar o handler correto

# "Crie um job de fila para enviar emails de boas-vindas"
# A Liz sabe que voce tem BullMQ + SMTP e gera producer + worker