@riligar/agents-kit 1.12.0 → 1.14.0

package/.agent/skills/riligar-business-startup/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-business-startup
-type: business
 description: Comprehensive startup planning toolkit. Use for business cases, financial projections (3-5 year models), and market opportunity analysis (TAM/SAM/SOM). Covers investor-ready documentation, fundraising strategy, and go-to-market planning.
 ---
 

package/.agent/skills/riligar-design-system/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-design-system
-type: design
 description: Especialista no Sistema Visual da RiLiGar. Use para: (1) Criação de interfaces web e mobile (Light/Dark Mode), (2) Implementação de componentes UI (Mantine Only), (3) Garantir estética minimalista "Content-First", (4) Aplicar tokens de design via Mantine Theme.
 ---
 

package/.agent/skills/riligar-dev-architecture/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-architecture
-type: development
 description: Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.
 ---
 
@@ -12,13 +11,13 @@ description: Architectural decision-making framework. Requirements analysis, tra
 
 **Read ONLY files relevant to the request!** Check the content map, find what you need.
 
-| File                    | Description                              | When to Read                 |
-| ----------------------- | ---------------------------------------- | ---------------------------- |
-| `context-discovery.md`  | Questions to ask, project classification | Starting architecture design |
-| `trade-off-analysis.md` | ADR templates, trade-off framework       | Documenting decisions        |
-| `pattern-selection.md`  | Decision trees, anti-patterns            | Choosing patterns            |
-| `examples.md`           | MVP, SaaS, Enterprise examples           | Reference implementations    |
-| `patterns-reference.md` | Quick lookup for patterns                | Pattern comparison           |
+| File                                | Description                              | When to Read                 |
+| ----------------------------------- | ---------------------------------------- | ---------------------------- |
+| `references/context-discovery.md`   | Questions to ask, project classification | Starting architecture design |
+| `references/trade-off-analysis.md`  | ADR templates, trade-off framework       | Documenting decisions        |
+| `references/pattern-selection.md`   | Decision trees, anti-patterns            | Choosing patterns            |
+| `references/examples.md`            | MVP, SaaS, Enterprise examples           | Reference implementations    |
+| `references/patterns-reference.md`  | Quick lookup for patterns                | Pattern comparison           |
 
 ---
 

package/.agent/skills/riligar-dev-auth-elysia/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-auth-elysia
-type: development
 description: 'Comprehensive guide for integrating the Riligar Auth Elysia SDK into backend servers. Use when a user needs to: (1) Set up a backend auth plugin, (2) Configure Elysia with Riligar Secret Key, (3) Protect API routes or groups, (4) Access authenticated user data in handlers, (5) Perform manual JWT verification.'
 ---
 
@@ -20,13 +19,18 @@ npm install @riligar/auth-elysia
 
 ### 2. Environment Variables
 
-Set up your Secret Key and URLs in your `.env` file.
+Set up your Secret Key and URLs in your environment files.
 
 > [!CAUTION]
 > Backend integration requires the **Secret Key** (`sk_...`). Never share this key or include it in client-side code.
 
 ```bash
-# .env
+# .env.development
+AUTH_API_URL=https://manager.myauth.click
+AUTH_API_SECRET=sk_test_your_secret_key
+AUTH_JWKS_URL=https://manager.myauth.click/.well-known/jwks.json
+
+# .env.production
 AUTH_API_URL=https://manager.myauth.click
 AUTH_API_SECRET=sk_live_your_secret_key
 AUTH_JWKS_URL=https://manager.myauth.click/.well-known/jwks.json

package/.agent/skills/riligar-dev-auth-react/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-auth-react
-type: development
 description: 'Comprehensive guide for integrating the Riligar Auth React SDK into web applications. Use when a user needs to: (1) Set up authentication from scratch, (2) Configure AuthProvider, (3) Implement route protection, (4) Use auth hooks or pre-built UI components, (5) Handle login/signup/profile/magic links in React.'
 ---
 
@@ -20,13 +19,16 @@ bun add @riligar/auth-react
 
 ### 2. Environment Variables
 
-Set up your Public Key in your `.env.local` file.
+Set up your Public Key in your environment files.
 
 > [!IMPORTANT]
 > Always use the **Public Key** (`pk_...`) in the frontend. Never expose your Secret Key.
 
 ```bash
-# .env.local
+# .env.development
+VITE_AUTH_API_KEY=pk_test_your_public_key
+
+# .env.production
 VITE_AUTH_API_KEY=pk_live_your_public_key
 ```
 

package/.agent/skills/riligar-dev-autopilot/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-autopilot
-type: development
 description: Automação do ciclo de vida de desenvolvimento. Validação com Bun, Auto-correção, Commit Semântico e Deploy. Use para garantir código funcional e entregue em produção.
 ---
 

package/.agent/skills/riligar-dev-backend/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-backend
-type: development
 description: Elysia backend development patterns for Bun. Use when building APIs, routes, plugins, validation, middleware, and error handling with Elysia framework.
 ---
 

package/.agent/skills/riligar-dev-clean-code/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-clean-code
-type: development
 description: Pragmatic coding standards - concise, direct, no over-engineering, no unnecessary comments. CRITICAL skill that defines RiLiGar coding standards. Use when writing or reviewing any code.
 ---
 

package/.agent/skills/riligar-dev-code-review/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-code-review
-type: development
 description: Code review guidelines covering code quality, security, and best practices. Use when reviewing code or creating review checklists.
 ---
 

package/.agent/skills/riligar-dev-database/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-database
-type: development
 description: Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases. Use when designing schemas or optimizing database performance.
 ---
 
@@ -12,14 +11,14 @@ description: Database design principles and decision-making. Schema design, inde
 
 **Read ONLY files relevant to the request!** Check the content map, find what you need.
 
-| File                    | Description                           | When to Read       |
-| ----------------------- | ------------------------------------- | ------------------ |
-| `database-selection.md` | PostgreSQL vs Neon vs Turso vs SQLite | Choosing database  |
-| `orm-selection.md`      | Drizzle vs Prisma vs Kysely           | Choosing ORM       |
-| `schema-design.md`      | Normalization, PKs, relationships     | Designing schema   |
-| `indexing.md`           | Index types, composite indexes        | Performance tuning |
-| `optimization.md`       | N+1, EXPLAIN ANALYZE                  | Query optimization |
-| `migrations.md`         | Safe migrations, serverless DBs       | Schema changes     |
+| File                              | Description                           | When to Read       |
+| --------------------------------- | ------------------------------------- | ------------------ |
+| `references/database-selection.md`| PostgreSQL vs Neon vs Turso vs SQLite | Choosing database  |
+| `references/orm-selection.md`     | Drizzle vs Prisma vs Kysely           | Choosing ORM       |
+| `references/schema-design.md`     | Normalization, PKs, relationships     | Designing schema   |
+| `references/indexing.md`          | Index types, composite indexes        | Performance tuning |
+| `references/optimization.md`      | N+1, EXPLAIN ANALYZE                  | Query optimization |
+| `references/migrations.md`        | Safe migrations, serverless DBs       | Schema changes     |
 
 ---
 

package/.agent/skills/riligar-dev-frontend/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-frontend
-type: development
 description: Modern React patterns and principles. Hooks, composition, performance, and JavaScript best practices. Use when building React components, managing state, or implementing UI patterns.
 ---
 

package/.agent/skills/riligar-dev-landing-page/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-landing-page
-type: development
 description: Specialist in High-Conversion Landing Pages using RiLiGar Design System. Use for: (1) Creating marketing/sales pages, (2) Structuring conversion flows (AIDA/PAS), (3) Implementing high-trust components (Hero, Social Proof, Pricing), (4) Writing persuasive copy.
 ---
 

package/.agent/skills/riligar-dev-seo/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: riligar-dev-seo
-type: development
 description: Implementação de infraestrutura de SEO técnico seguindo a stack RiLiGar (React, Vite, Bun, Elysia). Use para configurar sitemaps, robots.txt, meta tags, OpenGraph, dados estruturados (JSON-LD) e URLs canônicas.
 ---
 
@@ -177,10 +176,14 @@ app.get('/*', async ({ path }) => {
 
 # Part 4: Variáveis de Ambiente
 
-Sempre configure a URL base:
+Sempre configure a URL base nos arquivos de ambiente:
 
 ```bash
-# .env
+# .env.development
+VITE_SITE_URL=http://localhost:5173
+SITE_URL=http://localhost:3000
+
+# .env.production
 VITE_SITE_URL=https://riligar.com
 SITE_URL=https://riligar.com
 ```

package/.agent/skills/riligar-dev-stripe/SKILL.md

@@ -1,152 +1,257 @@
 ---
 name: riligar-dev-stripe
-type: development
-description: Stripe payment integration patterns. Use when implementing payments, subscriptions, webhooks, checkout flows, or billing in Elysia/Bun applications.
+description: 'Interactive Stripe setup wizard. Use when implementing payments. The agent will ask for keys, products, and configure everything automatically.'
 ---
 
-# Stripe Integration Patterns
+# Stripe Setup Wizard
 
-> Patterns for integrating Stripe payments in RiLiGar applications.
+Esta skill configura a integração completa do Stripe no seu projeto. O agente vai guiar você através de um setup interativo.
 
 ---
 
-## Mandatory Guidelines
+## Setup Workflow
 
-> [!IMPORTANT]
-> All work in this skill MUST adhere to:
+Quando o usuário solicitar configurar o Stripe, siga este fluxo **OBRIGATÓRIO**:
+
+### Step 1: Coletar Chaves
+
+Pergunte ao usuário:
+
+> Para configurar o Stripe, preciso das suas chaves da API.
+> Você pode encontrá-las em: https://dashboard.stripe.com/apikeys
 >
-> - @[.agent/skills/riligar-dev-backend] (API Standards)
-> - @[.agent/skills/riligar-dev-clean-code] (Clean Code Standards)
+> Por favor, me forneça:
+> 1. **Publishable Key** (pk_live_... ou pk_test_...)
+> 2. **Secret Key** (sk_live_... ou sk_test_...)
 
----
+Aguarde as chaves antes de prosseguir.
 
-## 1. Core Concepts
+### Step 2: Identificar Produtos
 
-| Concept | Description |
-| --- | --- |
-| **Customer** | User identity in Stripe |
-| **Product** | What you're selling |
-| **Price** | How much and billing cycle |
-| **Subscription** | Recurring payment |
-| **PaymentIntent** | One-time payment |
-| **Webhook** | Event notifications |
+Após receber as chaves, pergunte:
 
----
+> Agora preciso entender seus produtos. Me diga:
+>
+> 1. **Tipo de cobrança**: Assinatura (recorrente) ou pagamento único?
+> 2. **Quais planos/produtos** você quer oferecer?
+>
+> Exemplo de resposta:
+> - Assinatura mensal
+> - Plano Starter: R$ 29/mês (5 projetos, suporte email)
+> - Plano Pro: R$ 99/mês (ilimitado, suporte prioritário)
+> - Plano Enterprise: R$ 299/mês (tudo + SLA)
 
-## 2. Environment Setup
+### Step 3: Criar Produtos no Stripe
 
-```bash
-# .env
-STRIPE_SECRET_KEY=sk_live_...
-STRIPE_WEBHOOK_SECRET=whsec_...
-STRIPE_PUBLISHABLE_KEY=pk_live_...
+Com as informações coletadas, gere o script para criar os produtos:
+
+```javascript
+// scripts/setup-stripe-products.js
+import Stripe from 'stripe'
+
+const stripe = new Stripe('SK_KEY_AQUI')
+
+async function setupProducts() {
+    const products = [
+        // Substituir com os produtos do usuário
+        {
+            name: 'Plano Starter',
+            description: '5 projetos, suporte email',
+            price: 2900,  // R$ 29,00 em centavos
+            interval: 'month',
+            features: ['5 projetos', 'Suporte email', '1GB storage']
+        },
+        {
+            name: 'Plano Pro',
+            description: 'Ilimitado, suporte prioritário',
+            price: 9900,  // R$ 99,00 em centavos
+            interval: 'month',
+            features: ['Projetos ilimitados', 'Suporte prioritário', '10GB storage']
+        }
+    ]
+
+    console.log('Criando produtos no Stripe...\n')
+
+    for (const product of products) {
+        const stripeProduct = await stripe.products.create({
+            name: product.name,
+            description: product.description,
+            metadata: { features: JSON.stringify(product.features) }
+        })
+
+        const stripePrice = await stripe.prices.create({
+            product: stripeProduct.id,
+            unit_amount: product.price,
+            currency: 'brl',
+            recurring: product.interval ? { interval: product.interval } : undefined
+        })
+
+        console.log(`✓ ${product.name}`)
+        console.log(`  Product ID: ${stripeProduct.id}`)
+        console.log(`  Price ID: ${stripePrice.id}\n`)
+    }
+
+    console.log('Produtos criados com sucesso!')
+}
+
+setupProducts().catch(console.error)
 ```
 
-> [!IMPORTANT]
-> Never expose `STRIPE_SECRET_KEY` in frontend code.
+Instrua o usuário a executar: `bun run scripts/setup-stripe-products.js`
 
----
+### Step 4: Coletar Price IDs
 
-## 3. Server-Side Patterns (Elysia)
+Após executar o script, peça:
 
-### Initialize Stripe
+> O script gerou os Price IDs. Por favor, me envie os IDs gerados.
+> Exemplo: price_1ABC123...
 
-```javascript
-import Stripe from 'stripe'
+### Step 5: Configurar Ambiente
 
-const stripe = new Stripe(process.env.STRIPE_SECRET_KEY)
+Com as chaves e Price IDs, configure os arquivos de ambiente:
+
+**Backend: `.env.development` e `.env.production`**
+```bash
+# .env.development (chaves de teste)
+STRIPE_SECRET_KEY=sk_test_...
+STRIPE_WEBHOOK_SECRET=whsec_...
+
+# .env.production (chaves de produção)
+STRIPE_SECRET_KEY=sk_live_...
+STRIPE_WEBHOOK_SECRET=whsec_...
 ```
 
-### Create Checkout Session
+**Frontend: `.env.development` e `.env.production`**
+```bash
+# .env.development
+VITE_STRIPE_PUBLISHABLE_KEY=pk_test_...
 
-```javascript
-const session = await stripe.checkout.sessions.create({
-    mode: 'subscription',
-    customer_email: user.email,
-    line_items: [{ price: priceId, quantity: 1 }],
-    success_url: `${baseUrl}/success?session_id={CHECKOUT_SESSION_ID}`,
-    cancel_url: `${baseUrl}/cancel`,
-})
+# .env.production
+VITE_STRIPE_PUBLISHABLE_KEY=pk_live_...
 ```
 
-### Webhook Handler
+### Step 6: Configurar Database
 
-```javascript
-app.post('/webhook/stripe', async ({ request, set }) => {
-    const sig = request.headers.get('stripe-signature')
-    const body = await request.text()
-
-    const event = stripe.webhooks.constructEvent(
-        body,
-        sig,
-        process.env.STRIPE_WEBHOOK_SECRET
-    )
-
-    switch (event.type) {
-        case 'checkout.session.completed':
-            await handleCheckoutComplete(event.data.object)
-            break
-        case 'customer.subscription.updated':
-            await handleSubscriptionUpdate(event.data.object)
-            break
-        case 'customer.subscription.deleted':
-            await handleSubscriptionCancel(event.data.object)
-            break
-    }
+Gere a migration para adicionar campos do Stripe:
 
-    return { received: true }
-})
+```javascript
+// database/schema.js - adicionar aos users
+stripeCustomerId: text('stripe_customer_id').unique(),
+stripeSubscriptionId: text('stripe_subscription_id').unique(),
+plan: text('plan').default('free'),
+subscriptionStatus: text('subscription_status'),
+currentPeriodEnd: integer('current_period_end', { mode: 'timestamp' }),
 ```
 
----
+### Step 7: Configurar Webhook
 
-## 4. Essential Webhooks
+Instrua o usuário:
 
-| Event | When to Handle |
+> Configure o webhook no Stripe Dashboard:
+>
+> 1. Acesse https://dashboard.stripe.com/webhooks
+> 2. Clique em "Add endpoint"
+> 3. URL: `https://seu-dominio.com/webhook/stripe`
+> 4. Selecione os eventos:
+>    - `checkout.session.completed`
+>    - `customer.subscription.updated`
+>    - `customer.subscription.deleted`
+>    - `invoice.paid`
+>    - `invoice.payment_failed`
+> 5. Copie o "Signing secret" (whsec_...)
+> 6. Adicione ao `.env.development` e `.env.production`
+
+### Step 8: Gerar Código
+
+Gere todos os arquivos necessários usando os templates de [assets/](assets/):
+
+| Arquivo | Baseado em |
 | --- | --- |
-| `checkout.session.completed` | Provision access after payment |
-| `customer.subscription.updated` | Plan changes, renewals |
-| `customer.subscription.deleted` | Cancellation |
-| `invoice.payment_failed` | Payment issues |
-| `invoice.paid` | Successful recurring payment |
+| `plugins/stripe.js` | stripe-server.js (seção 1) |
+| `routes/billing.js` | stripe-server.js (seção 2) |
+| `routes/webhook.js` | stripe-server.js (seção 3) |
+| `services/billing.js` | stripe-server.js (seção 4) |
+| `config/stripe-prices.js` | Price IDs coletados |
+| `pages/Pricing.jsx` | stripe-client.js (seção 3) |
+| `components/BillingSettings.jsx` | stripe-client.js (seção 4) |
+| `hooks/useSubscription.js` | stripe-client.js (seção 2) |
 
----
+### Step 9: Criar Config de Preços
 
-## 5. Customer Portal
+Gere o arquivo de configuração com os Price IDs:
 
 ```javascript
-const portalSession = await stripe.billingPortal.sessions.create({
-    customer: customerId,
-    return_url: `${baseUrl}/account`,
-})
+// config/stripe-prices.js
+export const STRIPE_PRICES = {
+    starter: {
+        priceId: 'price_COLETADO_STARTER',
+        name: 'Starter',
+        price: 29,
+        features: ['5 projetos', 'Suporte email', '1GB storage']
+    },
+    pro: {
+        priceId: 'price_COLETADO_PRO',
+        name: 'Pro',
+        price: 99,
+        features: ['Projetos ilimitados', 'Suporte prioritário', '10GB storage']
+    }
+}
+
+export const getPrice = (plan) => STRIPE_PRICES[plan]
+export const getPriceId = (plan) => STRIPE_PRICES[plan]?.priceId
 ```
 
 ---
 
-## 6. Security Checklist
+## Checklist Final
 
-- [ ] Verify webhook signatures
-- [ ] Use idempotency keys for retries
-- [ ] Store customer ID in database
-- [ ] Handle edge cases (expired cards, disputes)
-- [ ] Test with Stripe CLI locally
+Ao completar o setup, confirme:
+
+- [ ] Dependências instaladas (`bun add stripe @stripe/stripe-js @stripe/react-stripe-js`)
+- [ ] Chaves no `.env.development` e `.env.production` (backend e frontend)
+- [ ] Produtos criados no Stripe
+- [ ] Price IDs configurados em `config/stripe-prices.js`
+- [ ] Schema do database atualizado
+- [ ] Webhook endpoint configurado no Stripe Dashboard
+- [ ] Webhook secret nos arquivos de ambiente
+- [ ] Rotas de billing funcionando
+- [ ] Página de pricing criada
+- [ ] Testado com cartão 4242 4242 4242 4242
 
 ---
 
-## 7. Testing
+## Testing Local
 
 ```bash
-# Install Stripe CLI
+# Instalar Stripe CLI
 brew install stripe/stripe-cli/stripe
 
-# Forward webhooks to local server
+# Login
+stripe login
+
+# Forward webhooks
 stripe listen --forward-to localhost:3000/webhook/stripe
+
+# Testar checkout
+stripe trigger checkout.session.completed
 ```
 
 ---
 
+## Specialized Guides
+
+| Guide | Content |
+| --- | --- |
+| [stripe-elysia.md](references/stripe-elysia.md) | Backend routes completas |
+| [stripe-react.md](references/stripe-react.md) | Componentes React/Mantine |
+| [stripe-webhooks.md](references/stripe-webhooks.md) | Handlers de eventos |
+| [stripe-database.md](references/stripe-database.md) | Schema Drizzle |
+
+---
+
 ## Related Skills
 
 - @[.agent/skills/riligar-dev-backend]
+- @[.agent/skills/riligar-dev-frontend]
 - @[.agent/skills/riligar-dev-auth-elysia]
 - @[.agent/skills/riligar-tech-stack]