bps-kit 1.2.0 → 1.2.2

package/.bps-kit.json

@@ -0,0 +1,6 @@
+{
+  "mode": "extra",
+  "vscode": true,
+  "version": "1.2.1",
+  "installedAt": "2026-03-09T22:52:06.758Z"
+}

package/CHANGELOG.md

@@ -5,6 +5,26 @@ 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.2.0] - 2026-03-09
+### Adicionado
+- Novo template `ARCHITECTURE.md` distribuído junto ao kit, mapeando os 20 agentes com suas skills, skills organizadas por tier (basic/normal/extra), 12 workflows e scripts de validação disponíveis. Referenciado obrigatoriamente pelo `GEMINI.md` no startup da sessão.
+- Passo de cópia do `ARCHITECTURE.md` adicionado ao `cli.js` — agora instalado em `.agents/ARCHITECTURE.md` (Gemini/Cursor/Windsurf) e `.github/ARCHITECTURE.md` (VS Code Copilot) automaticamente.
+- Scripts de validação (`checklist.py`, `verify_all.py`) agora são movidos para `.github/scripts/` no modo `--vscode`, corrigindo bug crítico onde eram silenciosamente deletados junto com `.agents/`.
+
+### Corrigido
+- **GEMINI.md**: 12 problemas identificados e corrigidos no template global:
+  - Todos os 6 paths `.agent/` (singular) corrigidos para `.agents/` (plural) com subpastas adequadas.
+  - Protocolo Anti-Amnesia removido (instrução impossível para LLMs — causava loops).
+  - Skill count hardcoded `(~69)` substituído por referência dinâmica ao `ARCHITECTURE.md`.
+  - Skills e scripts fantasmas removidos do Routing Map e do Checklist Final (ex: `test_runner.py`, `ux_audit.py`).
+  - Socratic Gate expandido com 5ª estratégia "Direct Proceed" + validação de edge cases.
+  - TIER 2 corrigido para paths `.agents/agents/` ao invés de `.agents/` direto.
+  - Seção `Path Awareness` adicionada ao TIER 0 com mapa completo de diretórios.
+  - Seção `System Map Read` adicionada — leitura obrigatória do `ARCHITECTURE.md` no início da sessão.
+  - Final Checklist Protocol atualizado com comandos Python executáveis.
+  - `QUICK REFERENCE` expandido com listas de Scanners e Audits.
+- **convert_to_vscode.js**: Regexes atualizadas para cobrir paths `.agents/` com e sem prefixo `./`. Novos padrões adicionados para `.agents/agents/`, `.agents/scripts/` e `.agents/ARCHITECTURE.md`. Passos 7 e 8 adicionados para copiar `ARCHITECTURE.md` e mover `scripts/` para `.github/`.
+
 ## [1.0.18] - 2026-03-08
 ### Modificado
 - Universalização do *Lazy-Loading*: A instrução contida no template base `GEMINI.md` dizia que as habilidades (skills) na pasta raíz estariam "*always in context*" (sempre no contexto). Essa linha foi alterada para um comando forte que impõe as IAs nativas (Windsurf e Cursor) lerem a habilidade "explicitly read the SKILL.md file via file tools before using". Isso universaliza a redução de uso de Tokens Passivos (barrando possíveis alucinações de contexto) em todas as esferas e não apenas na arquitetura VS Code Copilot.

package/README.md

@@ -4,6 +4,12 @@ O **BPS Kit** é a evolução modular e de larga escala do consagrado ecossistem
 
 Seu principal diferencial é o brilhante **Skill Vault System**: o sistema resolve o temido limite de tokens (Context Window) das LLMs ao armazenar mais de +1.200 skills valiosas em um cofre fechado (Vault) munido de um índice super comprimido. Ele mantém no seu "Core Ativo" apenas as Skills cruciais baseadas no perfil de desenvolvimento escolhido (ex: Web, Sec, Cloud).
 
+---
+
+> 💡 **Melhor experiência no [Antigravity IDE](https://idx.google.com) (Google).** Suporte completo para VS Code + GitHub Copilot via flag `--vscode`.
+
+---
+
 ## 📦 Instalação (Via NPX)
 
 Você não precisa e não deve instalar isso via `npm install` fixo. Você invoca a maleta de ferramentas instantaneamente na raiz do projeto sempre que quiser injetar o "cérebro":

package/bin/cli.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 const fs = require('fs-extra');
 const path = require('path');

package/package.json

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

package/templates/agents-template/agents/site-builder.md

@@ -27,10 +27,17 @@ When the user asks to build a site (or this agent is activated for a new project
 ### Questions (all in one interaction)
 
 1. **"What is the brand name and its purpose in one sentence?"** — Free text. Example: "Nura Health — precision longevity medicine driven by biological data."
-2. **"Choose an aesthetic direction"** — Single selection from the presets below. Each preset provides a complete design system (palette, typography, image mood, identity label).
+2. **"Choose an aesthetic direction:"**
+   - **A — "Organic Tech"** — Biological lab meets luxury magazine. Greens, clay, organic textures.
+   - **B — "Midnight Luxe"** — Dark editorial, gold accents, private-club elegance.
+   - **C — "Brutalist Signal"** — Raw precision, high contrast, information density.
+   - **D — "Vapor Clinic"** — Neon biotech, deep voids, plasma purple.
+   - **Custom** — Describe your own vibe freely. Provide references, colors, mood — I'll build a full design system from scratch.
 3. **"What are your 3 main value propositions?"** — Free text. Short phrases. They will become the Features section cards.
 4. **"What should visitors do?"** — Free text. The primary CTA. Example: "Join the waitlist", "Book a consultation", "Start free trial".
 
+> **If the user picks Custom:** derive a complete design system (palette, typography, image mood, identity label) from their description before proceeding to build. Do NOT use any preset tokens.
+
 ---
 
 ## Aesthetic Presets

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

@@ -31,9 +31,40 @@ Este workflow permite que eu (o seu agente Antigravity) faça uma varredura comp
    - Solicite aprovação do usuário para executar as movimentações locais.
 
 5. **Execução Automática da Otimização**:
-   - Assim que o usuário aprovar, utilize tools de shell (como `run_command` via bash ou node) ou scripts nativos para MOVER as pastas de skills sugeridas de `./.agents/vault/` para `./.agents/skills/`.
-   - Modifique regras do `.agents/rules/GEMINI.md` se for preciso rebalancear ou limpar referências.
+   - Assim que o usuário aprovar, utilize tools de shell para MOVER as pastas de skills:
+     - Desativar: mover de `./.agents/skills/{skill}` → `./.agents/vault/{skill}`
+     - 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.
 
 ### 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.
 - Encerre rodando uma mensagem informando o resultado "Cérebro Calibrado e Otimizado para este ecossistema."