bps-kit 1.0.2 → 1.0.4

package/bin/cli.js

@@ -42,22 +42,22 @@ async function runInstaller() {
         // 2. Copy Rule and Workflows
         spinner.text = `Copiando rule máster (GEMINI.md) e Workflows de IA...`;
         await fs.copy(
-            path.join(TEMPLATES_DIR, '.agents', 'rules'),
+            path.join(TEMPLATES_DIR, 'agents-template', 'rules'),
             path.join(DEST_AGENTS, 'rules') // A rule já com paths relativos
         );
         await fs.copy(
-            path.join(TEMPLATES_DIR, '.agents', 'workflows'),
+            path.join(TEMPLATES_DIR, 'agents-template', 'workflows'),
             path.join(DEST_AGENTS, 'workflows')
         );
 
         // 2.1 Copy Agents and Scripts
         spinner.text = `Copiando Personas de Agentes e Scripts (Validadores Python)...`;
         await fs.copy(
-            path.join(TEMPLATES_DIR, '.agents', 'agents'),
+            path.join(TEMPLATES_DIR, 'agents-template', 'agents'),
             path.join(DEST_AGENTS, 'agents')
         );
         await fs.copy(
-            path.join(TEMPLATES_DIR, '.agents', 'scripts'),
+            path.join(TEMPLATES_DIR, 'agents-template', 'scripts'),
             path.join(DEST_AGENTS, 'scripts')
         );
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bps-kit",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "BPS Kit - The Ultimate Antigravity Brain",
   "bin": {
     "bps-kit": "./bin/cli.js"

package/templates/{.agents → agents-template}/rules/GEMINI.md

@@ -20,7 +20,7 @@ ANTES de escrever QUALQUER código ou resposta:
 □ 1. CLASSIFICAR o request (QUESTION / SIMPLE / COMPLEX / DESIGN)
 □ 2. ROTEAR o agente correto (frontend-specialist / backend-specialist / etc)
 □ 3. ANUNCIAR: 🤖 **Applying knowledge of `@[agent-name]`...**
-□ 4. LER o arquivo .md do agente (ex: .agents/agents/frontend-specialist.md)
+□ 4. LER o arquivo .md do agente (ex: .agent/agents/frontend-specialist.md)
 □ 5. IDENTIFICAR skills relevantes no Intent → Skill Routing Map
 □ 6. LER cada SKILL.md relevante (view_file)
 □ 7. ANUNCIAR: 📖 Using skill: [nome] — para CADA skill usada
@@ -135,7 +135,7 @@ After invoking any skill, explicitly say: '📖 Using skill: [skill-name]' befor
 | Step | Check | If Unchecked |
 |------|-------|--------------|
 | 1 | Identified correct agent? | → STOP. Analyze domain first. |
-| 2 | Read agent's `.md` file? | → STOP. Open `.agents/agents/{agent}.md` |
+| 2 | Read agent's `.md` file? | → STOP. Open `.agent/agents/{agent}.md` |
 | 3 | Announced agent? | → STOP. Add announcement. |
 | 4 | Loaded required skills? | → STOP. Check `skills:` field. |
 
@@ -205,8 +205,8 @@ Priority: Security → Lint → Schema → Tests → UX → SEO → Lighthouse/E
 
 | Task | Read |
 |---|---|
-| Web UI/UX | `.agents/frontend-specialist.md` |
-| Mobile UI/UX | `.agents/mobile-developer.md` |
+| Web UI/UX | `.agent/frontend-specialist.md` |
+| Mobile UI/UX | `.agent/mobile-developer.md` |
 
 > 🔴 For design work: Open and READ the agent file. Rules are there.
 
@@ -216,4 +216,4 @@ Priority: Security → Lint → Schema → Tests → UX → SEO → Lighthouse/E
 
 - **Masters**: `orchestrator`, `project-planner`, `security-auditor`, `backend-specialist`, `frontend-specialist`, `mobile-developer`, `debugger`
 - **Key Skills**: `clean-code`, `brainstorming`, `app-builder`, `frontend-design`, `mobile-design`, `plan-writing`, `behavioral-modes`
-- **Verify**: `.agents/scripts/verify_all.py`, `.agents/scripts/checklist.py`
+- **Verify**: `.agent/scripts/verify_all.py`, `.agent/scripts/checklist.py`

package/templates/skills_extra/nodejs-best-practices/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: nodejs-best-practices
-description: Node.js development principles and decision-making. Framework selection, async patterns, security, and architecture. Teaches thinking, not copying.
-allowed-tools: Read, Write, Edit, Glob, Grep
+description: "Node.js development principles and decision-making. Framework selection, async patterns, security, and architecture. Teaches thinking, not copying."
+risk: unknown
+source: community
+date_added: "2026-02-27"
 ---
 
 # Node.js Best Practices
@@ -9,6 +11,10 @@ allowed-tools: Read, Write, Edit, Glob, Grep
 > Principles and decision-making for Node.js development in 2025.
 > **Learn to THINK, not memorize code patterns.**
 
+## When to Use
+
+Use this skill when making Node.js architecture decisions, choosing frameworks, designing async patterns, or applying security and deployment best practices.
+
 ---
 
 ## ⚠️ How to Use This Skill

package/templates/skills_normal/api-patterns/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: api-patterns
-description: API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.
-allowed-tools: Read, Write, Edit, Glob, Grep
+description: "API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination."
+risk: unknown
+source: community
+date_added: "2026-02-27"
 ---
 
 # API Patterns
@@ -79,3 +81,6 @@ Before designing an API:
 |--------|---------|---------|
 | `scripts/api_validator.py` | API endpoint validation | `python scripts/api_validator.py <project_path>` |
 
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/templates/skills_normal/app-builder/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: app-builder
-description: Main application building orchestrator. Creates full-stack applications from natural language requests. Determines project type, selects tech stack, coordinates agents.
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash, Agent
+description: "Main application building orchestrator. Creates full-stack applications from natural language requests. Determines project type, selects tech stack, coordinates agents."
+risk: unknown
+source: community
+date_added: "2026-02-27"
 ---
 
 # App Builder - Application Building Orchestrator
@@ -15,7 +17,7 @@ allowed-tools: Read, Write, Edit, Glob, Grep, Bash, Agent
 | File | Description | When to Read |
 |------|-------------|--------------|
 | `project-detection.md` | Keyword matrix, project type detection | Starting new project |
-| `tech-stack.md` | 2026 default stack, alternatives | Choosing technologies |
+| `tech-stack.md` | 2025 default stack, alternatives | Choosing technologies |
 | `agent-coordination.md` | Agent pipeline, execution order | Coordinating multi-agent work |
 | `scaffolding.md` | Directory structure, core files | Creating project structure |
 | `feature-building.md` | Feature analysis, error handling | Adding features to existing project |
@@ -73,3 +75,6 @@ App Builder Process:
 5. Report progress
 6. Start preview
 ```
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/templates/skills_normal/app-builder/tech-stack.md

@@ -1,8 +1,8 @@
-# Tech Stack Selection (2026)
+# Tech Stack Selection (2025)
 
 > Default and alternative technology choices for web applications.
 
-## Default Stack (Web App - 2026)
+## Default Stack (Web App - 2025)
 
 ```yaml
 Frontend:

package/templates/skills_normal/app-builder/templates/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: templates
-description: Project scaffolding templates for new applications. Use when creating new projects from scratch. Contains 12 templates for various tech stacks.
-allowed-tools: Read, Glob, Grep
+description: "Project scaffolding templates for new applications. Use when creating new projects from scratch. Contains 12 templates for various tech stacks."
+risk: unknown
+source: community
+date_added: "2026-02-27"
 ---
 
 # Project Templates
@@ -37,3 +39,6 @@ allowed-tools: Read, Glob, Grep
 2. Match to appropriate template
 3. Read ONLY that template's TEMPLATE.md
 4. Follow its tech stack and structure
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/templates/skills_normal/app-builder/templates/nextjs-fullstack/TEMPLATE.md

@@ -1,21 +1,20 @@
 ---
 name: nextjs-fullstack
-description: Next.js full-stack template principles. App Router, Prisma, Tailwind v4.
+description: Next.js full-stack template principles. App Router, Prisma, Tailwind.
 ---
 
-# Next.js Full-Stack Template (2026 Edition)
+# Next.js Full-Stack Template
 
 ## Tech Stack
 
-| Component | Technology | Version / Notes |
-|-----------|------------|-----------------|
-| Framework | Next.js | v16+ (App Router, Turbopack) |
-| Language | TypeScript | v5+ (Strict Mode) |
-| Database | PostgreSQL | Prisma ORM (Serverless friendly) |
-| Styling | Tailwind CSS | v4.0 (Zero-config, CSS-first) |
-| Auth | Clerk / Better Auth | Middleware Protected Routes |
-| UI Logic | React 19 | Server Actions, useActionState |
-| Validation | Zod | Schema validation (API & Forms) |
+| Component | Technology |
+|-----------|------------|
+| Framework | Next.js 14 (App Router) |
+| Language | TypeScript |
+| Database | PostgreSQL + Prisma |
+| Styling | Tailwind CSS |
+| Auth | Clerk (optional) |
+| Validation | Zod |
 
 ---
 
@@ -24,40 +23,33 @@ description: Next.js full-stack template principles. App Router, Prisma, Tailwin
 ```
 project-name/
 ├── prisma/
-│   └── schema.prisma       # Database schema
+│   └── schema.prisma
 ├── src/
 │   ├── app/
-│   │   ├── (auth)/         # Route groups for Login/Register
-│   │   ├── (dashboard)/    # Protected routes
-│   │   ├── api/            # Route Handlers (only for Webhooks/External integration)
-│   │   ├── layout.tsx      # Root Layout (Metadata, Providers)
-│   │   ├── page.tsx        # Landing Page
-│   │   └── globals.css     # Tailwind v4 config (@theme) lives here
+│   │   ├── layout.tsx
+│   │   ├── page.tsx
+│   │   ├── globals.css
+│   │   └── api/
 │   ├── components/
-│   │   ├── ui/             # Reusable UI (Button, Input)
-│   │   └── forms/          # Client forms using useActionState
+│   │   └── ui/
 │   ├── lib/
-│   │   ├── db.ts           # Prisma singleton client
-│   │   ├── utils.ts        # Helper functions
-│   │   └── dal.ts          # Data Access Layer (Server-only)
-│   ├── actions/            # Server Actions (Mutations)
-│   └── types/              # Global TS Types
-├── public/
-├── next.config.ts          # TypeScript Config
+│   │   ├── db.ts        # Prisma client
+│   │   └── utils.ts
+│   └── types/
+├── .env.example
 └── package.json
 ```
 
 ---
 
-## Key Concepts (Updated)
+## Key Concepts
 
 | Concept | Description |
 |---------|-------------|
-| Server Components | Render on server (default). Direct DB access (Prisma) without APIs. |
-| Server Actions | Handle Form mutations. Replaces traditional API Routes. Use in action={}. |
-| React 19 Hooks | Form state management: useActionState, useFormStatus, useOptimistic. |
-| Data Access Layer | Data security. Separation of DB logic (DTOs) for safe reuse. |
-| Tailwind v4 | Styling engine. No tailwind.config.js. Config directly in CSS. |
+| Server Components | Default, fetch data |
+| Server Actions | Form mutations |
+| Route Handlers | API endpoints |
+| Prisma | Type-safe ORM |
 
 ---
 
@@ -65,58 +57,26 @@ project-name/
 
 | Variable | Purpose |
 |----------|---------|
-| DATABASE_URL | PostgreSQL connection string (Prisma) |
-| NEXT_PUBLIC_APP_URL | Public application URL |
-| NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY | Auth (if using Clerk) |
-| CLERK_SECRET_KEY | Auth Secret (Server only) |
+| DATABASE_URL | Prisma connection |
+| NEXT_PUBLIC_APP_URL | Public URL |
 
 ---
 
 ## Setup Steps
 
-1. Initialize Project:
-   ```bash
-   npx create-next-app@latest my-app --typescript --tailwind --eslint
-   # Select Yes for App Router
-   # Select No for src directory (optional, this template uses src)
-   ```
-
-2. Install DB & Validation:
-   ```bash
-   npm install prisma @prisma/client zod
-   npm install -D ts-node # For running seed scripts
-   ```
-
-3. Configure Tailwind v4 (If missing):
-   Ensure `src/app/globals.css` uses the new import syntax instead of a config file:
-   ```css
-   @import "tailwindcss";
-
-   @theme {
-     --color-primary: oklch(0.5 0.2 240);
-     --font-sans: "Inter", sans-serif;
-   }
-   ```
-
-4. Initialize Database:
-   ```bash
-   npx prisma init
-   # Update schema.prisma
-   npm run db:push
-   ```
-
-5. Run Developer Server:
-   ```bash
-   npm run dev --turbo
-   # --turbo to enable faster Turbopack
-   ```
+1. `npx create-next-app {{name}} --typescript --tailwind --app`
+2. `npm install prisma @prisma/client zod`
+3. `npx prisma init`
+4. Configure schema
+5. `npm run db:push`
+6. `npm run dev`
 
 ---
 
-## Best Practices (2026 Standards)
+## Best Practices
 
-- **Fetch Data**: Call Prisma directly in Server Components (async/await). Do not use useEffect for initial data fetching.
-- **Mutations**: Use Server Actions combined with React 19's `useActionState` to handle loading and error states instead of manual useState.
-- **Type Safety**: Share Zod schemas between Server Actions (input validation) and Client Forms.
-- **Security**: Always validate input data with Zod before passing it to Prisma.
-- **Styling**: Use native CSS variables in Tailwind v4 for easier dynamic theming.
+- Server Components by default
+- Server Actions for mutations
+- Prisma for type-safe DB
+- Zod for validation
+- Edge runtime where possible

package/templates/skills_normal/app-builder/templates/nextjs-saas/TEMPLATE.md

@@ -1,21 +1,20 @@
 ---
 name: nextjs-saas
-description: Next.js SaaS template principles (2026 Standards). React 19, Server Actions, Auth.js v6.
+description: Next.js SaaS template principles. Auth, payments, email.
 ---
 
-# Next.js SaaS Template (Updated 2026)
+# Next.js SaaS Template
 
 ## Tech Stack
 
-| Component | Technology | Version / Notes |
-|-----------|------------|-----------------|
-| Framework | Next.js | v16+ (App Router, React Compiler) |
-| Runtime | Node.js | v24 (Krypton LTS) |
-| Auth | Auth.js | v6 (formerly NextAuth) |
-| Payments | Stripe API | Latest |
-| Database | PostgreSQL | Prisma v6 (Serverless Driver) |
-| Email | Resend | React Email |
-| UI | Tailwind CSS | v4 (Oxide Engine, no config file) |
+| Component | Technology |
+|-----------|------------|
+| Framework | Next.js 14 (App Router) |
+| Auth | NextAuth.js v5 |
+| Payments | Stripe |
+| Database | PostgreSQL + Prisma |
+| Email | Resend |
+| UI | Tailwind (ASK USER: shadcn/Headless UI/Custom?) |
 
 ---
 
@@ -24,28 +23,24 @@ description: Next.js SaaS template principles (2026 Standards). React 19, Server
 ```
 project-name/
 ├── prisma/
-│   └── schema.prisma    # Database Schema
 ├── src/
-│   ├── actions/         # NEW: Server Actions (Replaces API Routes for data mutation)
-│   │   ├── auth-actions.ts
-│   │   ├── billing-actions.ts
-│   │   └── user-actions.ts
 │   ├── app/
-│   │   ├── (auth)/      # Route Group: Login, register
-│   │   ├── (dashboard)/ # Route Group: Protected routes (App Layout)
-│   │   ├── (marketing)/ # Route Group: Landing, pricing (Marketing Layout)
-│   │   └── api/         # Only used for Webhooks or Edge cases
+│   │   ├── (auth)/      # Login, register
+│   │   ├── (dashboard)/ # Protected routes
+│   │   ├── (marketing)/ # Landing, pricing
+│   │   └── api/
+│   │       ├── auth/[...nextauth]/
 │   │       └── webhooks/stripe/
 │   ├── components/
-│   │   ├── emails/      # React Email templates
-│   │   ├── forms/       # Client components using useActionState (React 19)
-│   │   └── ui/          # Shadcn UI
+│   │   ├── auth/
+│   │   ├── billing/
+│   │   └── dashboard/
 │   ├── lib/
-│   │   ├── auth.ts      # Auth.js v6 config
-│   │   ├── db.ts        # Prisma Singleton
-│   │   └── stripe.ts    # Stripe Singleton
-│   └── styles/
-│       └── globals.css  # Tailwind v4 imports (CSS only)
+│   │   ├── auth.ts      # NextAuth config
+│   │   ├── stripe.ts    # Stripe client
+│   │   └── email.ts     # Resend client
+│   └── config/
+│       └── subscriptions.ts
 └── package.json
 ```
 
@@ -55,22 +50,21 @@ project-name/
 
 | Feature | Implementation |
 |---------|---------------|
-| Auth | Auth.js v6 + Passkeys + OAuth |
-| Data Mutation | Server Actions (No API routes) |
-| Subscriptions | Stripe Checkout & Customer Portal |
-| Webhooks | Asynchronous Stripe event handling |
+| Auth | NextAuth + OAuth |
+| Subscriptions | Stripe Checkout |
+| Billing Portal | Stripe Portal |
+| Webhooks | Stripe events |
 | Email | Transactional via Resend |
-| Validation | Zod (Server-side validation) |
 
 ---
 
 ## Database Schema
 
-| Model | Fields (Key fields) |
-|-------|---------------------|
-| User | id, email, stripeCustomerId, subscriptionId, plan |
-| Account | OAuth provider data (Google, GitHub...) |
-| Session | User sessions (Database strategy) |
+| Model | Fields |
+|-------|--------|
+| User | id, email, stripeCustomerId, subscriptionId |
+| Account | OAuth provider data |
+| Session | User sessions |
 
 ---
 
@@ -78,45 +72,29 @@ project-name/
 
 | Variable | Purpose |
 |----------|---------|
-| DATABASE_URL | Prisma connection string (Postgres) |
-| AUTH_SECRET | Replaces NEXTAUTH_SECRET (Auth.js v6) |
-| STRIPE_SECRET_KEY | Payments (Server-side) |
-| STRIPE_WEBHOOK_SECRET | Webhook verification |
-| RESEND_API_KEY | Email sending |
-| NEXT_PUBLIC_APP_URL | Application Canonical URL |
+| DATABASE_URL | Prisma |
+| NEXTAUTH_SECRET | Auth |
+| STRIPE_SECRET_KEY | Payments |
+| STRIPE_WEBHOOK_SECRET | Webhooks |
+| RESEND_API_KEY | Email |
 
 ---
 
 ## Setup Steps
 
-1. Initialize project (Node 24):
-   ```bash
-   npx create-next-app@latest {{name}} --typescript --eslint
-   ```
-
-2. Install core libraries:
-   ```bash
-   npm install next-auth@beta stripe resend @prisma/client
-   ```
-
-3. Install Tailwind v4 (Add to globals.css):
-   ```css
-   @import "tailwindcss";
-   ```
-
-4. Configure environment (.env.local)
-
-5. Sync Database:
-   ```bash
-   npx prisma db push
-   ```
-
-6. Run local Webhook:
-   ```bash
-   npm run stripe:listen
-   ```
-
-7. Run project:
-   ```bash
-   npm run dev
-   ```
+1. `npx create-next-app {{name}} --typescript --tailwind --app`
+2. Install: `npm install next-auth @auth/prisma-adapter stripe resend`
+3. Setup Stripe products/prices
+4. Configure environment
+5. `npm run db:push`
+6. `npm run stripe:listen` (webhooks)
+7. `npm run dev`
+
+---
+
+## Best Practices
+
+- Route groups for layout separation
+- Stripe webhooks for subscription sync
+- NextAuth with Prisma adapter
+- Email templates with React Email