bps-kit 1.4.0 → 1.4.1

package/CHANGELOG.md

@@ -5,6 +5,18 @@ Todas as mudanças notáveis ​​neste projeto serão documentadas neste arqui
 O formato é baseado no [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/), 
 e este projeto adere ao [Versionamento Semântico](https://semver.org/lang/pt-BR/).
 
+## [1.4.1] - 2026-03-11
+### Corrigido
+- **`automation-specialist.md`**: Arquivo faltando em `src/agents/` — criado e sincronizado com `templates/`.
+- **`debugger.md`**: Frontmatter incompleto em `src/` e `templates/` — adicionados campos `tools` e `model: inherit` faltantes.
+- **`frontend-specialist.md`**: Dois skills (`design-md`, `enhance-prompt`) faltando em `src/` — sincronizado com template.
+- **`setup-brain.md`** em `src/`: Passo 6 ainda continha a versão antiga (editava GEMINI.md) — sincronizado com a versão corrigida do template.
+- **`AGENTS.md`**: Coluna "Skills (frontmatter)" corrigida para 20/22 agentes — agora reflete exatamente o frontmatter `skills:` real de cada agente (removido `clean-code` genérico, adicionados skills específicos por domínio).
+- **`orchestrate.md`**: Tabela de agentes listava apenas 16 agentes — atualizada para todos os 22, incluindo `qa-automation-engineer`, `site-builder`, `automation-specialist`, `code-archaeologist`, `product-manager`, `product-owner`. Checklist de domínios expandida com 4 novos domínios.
+- **`ARCHITECTURE.md`**: Corrigidas contagens (20→22 agentes, 12→15 workflows), tabela de agentes atualizada com skills reais, workflows `/automate`, `/build-site` e `/recall` adicionados, Quick Reference atualizado.
+- **`copy_templates.js`**: Adicionado step de cópia do `AGENTS.md` ao pipeline (com fallback de aviso). `NORMAL_SKILLS` expandida com `design-md`, `enhance-prompt`, `react-components` e 7 skills `n8n-*`. `EXTRA_SKILLS` expandida com `stitch-loop`.
+- **`.agents/rules/AGENTS.md`**: Criado como fonte para o pipeline `copy_templates.js`.
+
 ## [1.4.0] - 2026-03-11
 ### Adicionado
 - **AGENTS.md**: Novo arquivo de regras dedicado ao routing de agentes, extraído do `GEMINI.md`. Contém a tabela Keyword→Agent completa com 22 agentes mapeados, regras de boundary enforcement e file type ownership. Distribuído automaticamente em `.agents/rules/AGENTS.md` (Antigravity) e `.github/AGENTS.md` (VS Code Copilot via `--vscode`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bps-kit",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "BPS Kit - The Ultimate Antigravity Brain",
   "bin": {
     "bps-kit": "./bin/cli.js"
@@ -26,4 +26,4 @@
     "fs-extra": "^11.2.0",
     "ora": "^5.4.1"
   }
-}
+}

package/templates/agents-template/ARCHITECTURE.md

@@ -39,28 +39,28 @@ Specialist AI personas for different domains.
 
 | Agent                    | Focus                      | Skills Used                                              |
 | ------------------------ | -------------------------- | -------------------------------------------------------- |
-| `orchestrator`           | Multi-agent coordination   | clean-code, behavioral-modes, plan-writing               |
-| `project-planner`        | Discovery, task planning   | brainstorming, plan-writing                              |
-| `frontend-specialist`    | Web UI/UX                  | frontend-design, react-patterns, tailwind-patterns       |
-| `backend-specialist`     | API, business logic        | api-patterns, database-design                            |
-| `database-architect`     | Schema, SQL                | database-design, prisma-expert                           |
+| `orchestrator`           | Multi-agent coordination   | parallel-agents, behavioral-modes, plan-writing, architecture |
+| `project-planner`        | Discovery, task planning   | app-builder, plan-writing, brainstorming                 |
+| `frontend-specialist`    | Web UI/UX                  | nextjs-react-expert, tailwind-patterns, frontend-design, design-md, enhance-prompt |
+| `backend-specialist`     | API, business logic        | nodejs-best-practices, api-patterns, database-design, mcp-builder |
+| `database-architect`     | Schema, SQL                | database-design                                          |
 | `mobile-developer`       | iOS, Android, RN           | mobile-design                                            |
-| `game-developer`         | Game logic, mechanics      | —                                                        |
-| `devops-engineer`        | CI/CD, Docker              | docker-expert                                            |
-| `security-auditor`       | Security compliance        | vulnerability-scanner                                    |
-| `penetration-tester`     | Offensive security         | vulnerability-scanner                                    |
-| `test-engineer`          | Testing strategies         | testing-patterns, test-driven-development                |
+| `game-developer`         | Game logic, mechanics      | game-development (12 sub-skills)                         |
+| `devops-engineer`        | CI/CD, Docker              | deployment-procedures, server-management                 |
+| `security-auditor`       | Security compliance        | vulnerability-scanner, red-team-tactics                   |
+| `penetration-tester`     | Offensive security         | vulnerability-scanner, red-team-tactics                   |
+| `test-engineer`          | Testing strategies         | testing-patterns, tdd-workflow, webapp-testing            |
 | `debugger`               | Root cause analysis        | systematic-debugging                                     |
 | `performance-optimizer`  | Speed, Web Vitals          | performance-profiling                                    |
-| `seo-specialist`         | Ranking, visibility        | seo-fundamentals                                         |
-| `documentation-writer`   | Manuals, docs              | —                                                        |
+| `seo-specialist`         | Ranking, visibility        | seo-fundamentals, geo-fundamentals                       |
+| `documentation-writer`   | Manuals, docs              | documentation-templates                                  |
 | `product-manager`        | Requirements, user stories | plan-writing, brainstorming                              |
 | `product-owner`          | Strategy, backlog, MVP     | plan-writing, brainstorming                              |
-| `qa-automation-engineer` | E2E testing, CI pipelines  | testing-patterns                                         |
-| `code-archaeologist`     | Legacy code, refactoring   | clean-code                                               |
-| `explorer-agent`         | Codebase analysis          | —                                                        |
-| `site-builder`           | Landing pages, websites    | frontend-design, scroll-experience, enhance-prompt       |
-| `automation-specialist`  | n8n workflow automation    | n8n-mcp-tools-expert, n8n-workflow-patterns, n8n-expression-syntax |
+| `qa-automation-engineer` | E2E testing, CI pipelines  | webapp-testing, testing-patterns                          |
+| `code-archaeologist`     | Legacy code, refactoring   | refactoring-patterns, code-review-checklist               |
+| `explorer-agent`         | Codebase analysis          | architecture, plan-writing, brainstorming                 |
+| `site-builder`           | Landing pages, websites    | scroll-experience, tailwind-patterns, frontend-design, design-md, enhance-prompt |
+| `automation-specialist`  | n8n workflow automation    | n8n-mcp-tools-expert, n8n-workflow-patterns               |
 
 ---
 
@@ -119,13 +119,6 @@ Skills availability depends on the installed profile (`basic`, `normal`, or `ext
 | `test-driven-development` | TDD workflow                   |
 | `testing-patterns`        | Jest, Vitest, strategies       |
 | `vercel-deployment`       | Vercel deploy workflows        |
-| `n8n-mcp-tools-expert`    | n8n MCP tool selection & usage |
-| `n8n-workflow-patterns`   | n8n architectural patterns     |
-| `n8n-expression-syntax`   | n8n expression `{{$json.*}}`   |
-| `n8n-node-configuration`  | n8n node operation config      |
-| `n8n-validation-expert`   | n8n validation error fixing    |
-| `n8n-code-javascript`     | n8n Code node (JavaScript)     |
-| `n8n-code-python`         | n8n Code node (Python)         |
 
 ### Extra Profile (adds ~27 more skills)
 
@@ -167,8 +160,9 @@ Slash command procedures. Invoke with `/command`.
 
 | Command          | Description                     |
 | ---------------- | ------------------------------- |
+| `/automate`      | n8n workflow automation builder  |
 | `/brainstorm`    | Socratic discovery              |
-| `/build-site`    | Full website creation workflow  |
+| `/build-site`    | Cinematic landing page builder  |
 | `/create`        | Create new features             |
 | `/debug`         | Debug issues                    |
 | `/deploy`        | Deploy application              |
@@ -176,12 +170,11 @@ Slash command procedures. Invoke with `/command`.
 | `/orchestrate`   | Multi-agent coordination        |
 | `/plan`          | Task breakdown                  |
 | `/preview`       | Preview changes                 |
-| `/recall`        | Re-anchor AI to rules           |
+| `/recall`        | Re-anchor AI on rules           |
 | `/setup-brain`   | Initialize agent memory/context |
 | `/status`        | Check project status            |
 | `/test`          | Run tests                       |
 | `/ui-ux-pro-max` | Full UI/UX design workflow      |
-| `/automate`      | n8n workflow automation builder |
 
 ---
 
@@ -225,7 +218,7 @@ Scripts are embedded within skills at `.agents/skills/<skill>/scripts/`:
 | ------------------- | ----------------------------- |
 | **Total Agents**    | 22                            |
 | **Basic Skills**    | 11                            |
-| **Normal Skills**   | ~49                           |
+| **Normal Skills**   | ~42                           |
 | **Extra Skills**    | ~69                           |
 | **Vault Skills**    | 1200+                         |
 | **Total Workflows** | 15                            |
@@ -234,15 +227,15 @@ Scripts are embedded within skills at `.agents/skills/<skill>/scripts/`:
 
 ## 🔗 Quick Reference
 
-| Need     | Agent                 | Skills                                |
-| -------- | --------------------- | ------------------------------------- |
-| Web App  | `frontend-specialist` | frontend-design, react-patterns       |
-| API      | `backend-specialist`  | api-patterns, backend-dev-guidelines  |
-| Mobile   | `mobile-developer`    | mobile-design                         |
-| Database | `database-architect`  | database-design, prisma-expert        |
-| Security | `security-auditor`    | vulnerability-scanner                 |
-| Testing  | `test-engineer`       | testing-patterns, test-driven-development |
-| Debug    | `debugger`            | systematic-debugging                  |
-| Plan     | `project-planner`     | brainstorming, plan-writing           |
-| Deploy   | `devops-engineer`     | docker-expert, vercel-deployment      |
+| Need     | Agent                 | Skills                                    |
+| -------- | --------------------- | ----------------------------------------- |
+| Web App  | `frontend-specialist` | nextjs-react-expert, tailwind-patterns, frontend-design |
+| API      | `backend-specialist`  | api-patterns, nodejs-best-practices       |
+| Mobile   | `mobile-developer`    | mobile-design                             |
+| Database | `database-architect`  | database-design                           |
+| Security | `security-auditor`    | vulnerability-scanner, red-team-tactics   |
+| Testing  | `test-engineer`       | testing-patterns, tdd-workflow            |
+| Debug    | `debugger`            | systematic-debugging                      |
+| Plan     | `project-planner`     | brainstorming, plan-writing               |
+| Deploy   | `devops-engineer`     | deployment-procedures, server-management  |
 | Automate | `automation-specialist` | n8n-mcp-tools-expert, n8n-workflow-patterns |

package/templates/agents-template/agents/debugger.md

@@ -1,6 +1,8 @@
 ---
 name: debugger
 description: Expert in systematic debugging, root cause analysis, and crash investigation. Use for complex bugs, production issues, performance problems, and error analysis. Triggers on bug, error, crash, not working, broken, investigate, fix.
+tools: Read, Grep, Glob, Bash, Edit, Write
+model: inherit
 skills: clean-code, systematic-debugging
 ---
 

package/templates/agents-template/rules/AGENTS.md

@@ -19,28 +19,28 @@ trigger: always_on
 
 | Keywords no request | Agent | Skills (frontmatter) |
 |---|---|---|
-| component, react, ui, ux, css, tailwind, frontend, hook, state | `frontend-specialist` | clean-code, frontend-design, react-patterns, tailwind-patterns |
-| landing page, site, website, hero, parallax, one-pager | `site-builder` | scroll-experience, enhance-prompt, frontend-design, design-md |
-| backend, server, api, endpoint, auth, express, fastapi, hono | `backend-specialist` | api-patterns, database-design, backend-dev-guidelines |
-| schema, SQL, migration, prisma, drizzle, database design | `database-architect` | database-design, prisma-expert |
+| component, react, ui, ux, css, tailwind, frontend, hook, state | `frontend-specialist` | nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, design-md, enhance-prompt |
+| landing page, site, website, hero, parallax, one-pager | `site-builder` | scroll-experience, tailwind-patterns, react-patterns, frontend-design, design-md, enhance-prompt, react-components |
+| backend, server, api, endpoint, auth, express, fastapi, hono | `backend-specialist` | nodejs-best-practices, api-patterns, database-design, mcp-builder |
+| schema, SQL, migration, prisma, drizzle, database design | `database-architect` | database-design |
 | bug, error, crash, not working, broken, fix, investigate | `debugger` | systematic-debugging |
-| test, testing, coverage, TDD, E2E, jest, vitest | `test-engineer` | testing-patterns, test-driven-development |
+| test, testing, coverage, TDD, E2E, jest, vitest | `test-engineer` | testing-patterns, tdd-workflow, webapp-testing, code-review-checklist |
 | mobile, iOS, Android, React Native, Flutter, Expo | `mobile-developer` | mobile-design |
-| security, vulnerability, audit, OWASP | `security-auditor` | vulnerability-scanner |
-| pentest, red team, exploit | `penetration-tester` | vulnerability-scanner |
-| deploy, CI/CD, Docker, infrastructure, PM2 | `devops-engineer` | docker-expert |
+| security, vulnerability, audit, OWASP | `security-auditor` | vulnerability-scanner, red-team-tactics, api-patterns |
+| pentest, red team, exploit | `penetration-tester` | vulnerability-scanner, red-team-tactics, api-patterns |
+| deploy, CI/CD, Docker, infrastructure, PM2 | `devops-engineer` | deployment-procedures, server-management |
 | performance, speed, Web Vitals, optimize, profiling | `performance-optimizer` | performance-profiling |
-| SEO, meta tags, ranking, sitemap | `seo-specialist` | seo-fundamentals |
-| plan, roadmap, task breakdown, milestones | `project-planner` | brainstorming, plan-writing |
+| SEO, meta tags, ranking, sitemap | `seo-specialist` | seo-fundamentals, geo-fundamentals |
+| plan, roadmap, task breakdown, milestones | `project-planner` | app-builder, plan-writing, brainstorming |
 | requirements, user stories, backlog | `product-manager` | plan-writing, brainstorming |
 | MVP, strategy, product vision | `product-owner` | plan-writing, brainstorming |
-| game, unity, godot, phaser, multiplayer | `game-developer` | — |
-| n8n, webhook, automation, workflow automation | `automation-specialist` | n8n-mcp-tools-expert, n8n-workflow-patterns |
-| docs, README, documentation, manual | `documentation-writer` | — |
-| legacy code, refactor, tech debt | `code-archaeologist` | clean-code |
-| codebase analysis, map, discovery, explore | `explorer-agent` | — |
-| E2E automation, CI pipeline, QA pipeline | `qa-automation-engineer` | testing-patterns |
-| coordinate, orchestrate, 2+ domains simultâneos | `orchestrator` | plan-writing, behavioral-modes |
+| game, unity, godot, phaser, multiplayer | `game-developer` | game-development (12 sub-skills) |
+| n8n, webhook, automation, workflow automation | `automation-specialist` | n8n-mcp-tools-expert, n8n-workflow-patterns, n8n-expression-syntax, n8n-node-configuration, n8n-validation-expert |
+| docs, README, documentation, manual | `documentation-writer` | documentation-templates |
+| legacy code, refactor, tech debt | `code-archaeologist` | refactoring-patterns, code-review-checklist |
+| codebase analysis, map, discovery, explore | `explorer-agent` | architecture, plan-writing, brainstorming, systematic-debugging |
+| E2E automation, CI pipeline, QA pipeline | `qa-automation-engineer` | webapp-testing, testing-patterns, web-design-guidelines |
+| coordinate, orchestrate, 2+ domains simultâneos | `orchestrator` | parallel-agents, behavioral-modes, plan-writing, brainstorming, architecture |
 
 ### Protocolo de Uso
 

package/templates/agents-template/workflows/orchestrate.md

@@ -82,7 +82,7 @@ Do you approve? (Y/N)
 
 > ✅ After user approval, invoke multiple agents in PARALLEL.
 
-## Available Agents (17 total)
+## Available Agents (22 total)
 
 | Agent | Domain | Use When |
 |-------|--------|----------|
@@ -94,6 +94,7 @@ Do you approve? (Y/N)
 | `security-auditor` | Security | Vulnerabilities, Auth |
 | `penetration-tester` | Security | Active testing |
 | `test-engineer` | Testing | Unit, E2E, Coverage |
+| `qa-automation-engineer` | QA | CI pipelines, E2E automation |
 | `devops-engineer` | Ops | CI/CD, Docker, Deploy |
 | `mobile-developer` | Mobile | React Native, Flutter |
 | `performance-optimizer` | Speed | Lighthouse, Profiling |
@@ -101,6 +102,11 @@ Do you approve? (Y/N)
 | `documentation-writer` | Docs | README, API docs |
 | `debugger` | Debug | Error analysis |
 | `game-developer` | Games | Unity, Godot |
+| `site-builder` | Sites | Landing pages, cinematic UX |
+| `automation-specialist` | Automation | n8n workflows, webhooks |
+| `code-archaeologist` | Legacy | Refactoring, tech debt |
+| `product-manager` | Product | Requirements, user stories |
+| `product-owner` | Strategy | MVP, backlog, vision |
 | `orchestrator` | Meta | Coordination |
 
 ---
@@ -114,12 +120,16 @@ Identify ALL domains this task touches:
 □ Backend/API  → backend-specialist
 □ Frontend/UI  → frontend-specialist
 □ Database     → database-architect
-□ Testing      → test-engineer
+□ Testing      → test-engineer, qa-automation-engineer
 □ DevOps       → devops-engineer
 □ Mobile       → mobile-developer
 □ Performance  → performance-optimizer
 □ SEO          → seo-specialist
 □ Planning     → project-planner
+□ Sites        → site-builder
+□ Automation   → automation-specialist
+□ Legacy/Debt  → code-archaeologist
+□ Games        → game-developer
 ```
 
 ### Step 2: Phase Detection

package/templates/agents-template/workflows/setup-brain.md

@@ -36,35 +36,12 @@ Este workflow permite que eu (o seu agente Antigravity) faça uma varredura comp
      - Ativar: copiar de `./.agents/vault/{skill}` → `./.agents/skills/{skill}`
    - Confirme o total final de skills ativas após os movimentos.
 
-6. **Atualização da Rule File (OBRIGATÓRIO após mover skills)**:
-   - Detecte qual formato está instalado no repositório:
-     - **VS Code / Copilot**: Rule File = `.github/copilot-instructions.md`
-     - **Antigravity padrão (Cursor/Windsurf)**: Rule File = `.agents/rules/GEMINI.md`
-   - Após mover as skills, edite a Rule File atualizando TODOS os trechos que referenciam nomes de skills:
-
-   **a) `Skill Auto-Routing System` → contagem de active skills:**
-   ```
-   - **Active skills** (~N): in `./.agents/skills/` (ou `./.copilot-skills/` no VS Code)
-   ```
-   Substituir N pelo número real de skills ativas após a otimização.
-
-   **b) `Intent → Skill Routing Map`:**
-   - Remover todas as linhas de intent que apontam para skills que foram movidas para o vault.
-   - Adicionar/ajustar entradas baseadas nas novas skills ativas e na stack detectada.
-   - Exemplo: se `tailwind-patterns` foi para o vault, remover da linha `UI/component`.
-
-   **c) `Project Type Routing` (TIER 1):**
-   - Atualizar a tabela de agentes/skills para refletir o tipo real de projeto detectado.
-   - Adicionar nota `> 🔴 Este projeto é [tipo detectado]. Não usar agentes de [tipos irrelevantes].`
-
-   **d) `Final Checklist` (TIER 1):**
-   - Remover linhas de scripts que dependem de skills agora no vault (ex: `ux_audit.py → frontend-design`).
-   - Manter apenas scripts cujas skills dependentes ainda estejam ativas.
-
-   **e) `QUICK REFERENCE`:**
-   - Atualizar `Masters` e `Key Skills` para refletir os agentes/skills relevantes ao projeto.
+6. **Atualização do ARCHITECTURE.md (OBRIGATÓRIO após mover skills)**:
+   - Atualize SOMENTE a tabela de skills no `ARCHITECTURE.md` para refletir quais skills estão ativas vs vault.
+   - **🔴 NÃO EDITE os arquivos de regras (GEMINI.md, AGENTS.md, copilot-instructions.md).** Esses arquivos contêm routing genérico que funciona para qualquer stack — o Intent Map e a Keyword→Agent table são universais e não devem ser alterados pelo setup-brain.
 
 ### Critérios de Sucesso
 - **Precisão**: Apenas skills de altíssimo valor agregado (diretamente conectadas com a stack) serão movidas. Não encha o contexto em vão. Você foi programado para manter seu Token footprint baixo.
-- A Rule File deve estar 100% sincronizada com as skills ativas — zero referências a skills no vault.
+- O `ARCHITECTURE.md` deve refletir as skills ativas atualizadas.
+- **🔴 PROIBIDO**: Editar GEMINI.md, AGENTS.md, ou copilot-instructions.md. O routing é genérico por design.
 - Encerre rodando uma mensagem informando o resultado "Cérebro Calibrado e Otimizado para este ecossistema."