grimoire-framework 1.0.18 → 1.0.21

package/packages/installer/src/utils/grimoire-colors.js

@@ -19,73 +19,73 @@ const colors = {
   // ============================================
   // CORE BRAND COLORS
   // ============================================
-  
+
   /**
    * Primary brand color - ClickUp-inspired purple
    * Usage: Main questions, headers, CTAs, primary actions
    */
   primary: chalk.hex('#8B5CF6'),
-  
+
   /**
    * Secondary brand color - Magenta accent from logo gradient
    * Usage: Important highlights, special emphasis, key information
    */
   secondary: chalk.hex('#EC4899'),
-  
+
   /**
    * Tertiary brand color - Blue accent from logo gradient
    * Usage: Secondary actions, links, complementary elements
    */
   tertiary: chalk.hex('#3B82F6'),
-  
+
   // ============================================
   // FUNCTIONAL COLORS
   // ============================================
-  
+
   /**
    * Success state color
    * Usage: Checkmarks, completed steps, success messages
    */
   success: chalk.hex('#10B981'),
-  
+
   /**
    * Warning state color - Orange from logo gradient
    * Usage: Warnings, confirmations, caution states
    */
   warning: chalk.hex('#F59E0B'),
-  
+
   /**
    * Error state color
    * Usage: Errors, critical alerts, validation failures
    */
   error: chalk.hex('#EF4444'),
-  
+
   /**
    * Info state color - Cyan-blue from logo gradient
    * Usage: Info messages, tips, helper text, additional context
    */
   info: chalk.hex('#06B6D4'),
-  
+
   // ============================================
   // NEUTRAL COLORS
   // ============================================
-  
+
   /**
    * Muted text color
    * Usage: Subtle text, disabled states, secondary content
    */
   muted: chalk.hex('#94A3B8'),
-  
+
   /**
    * Dim text color
    * Usage: Secondary text, muted content, less important info
    */
   dim: chalk.hex('#64748B'),
-  
+
   // ============================================
   // GRADIENT SYSTEM
   // ============================================
-  
+
   /**
    * Brand gradient colors for animations and special effects
    * Matches grimoire logo gradient: magenta → purple → blue
@@ -93,28 +93,28 @@ const colors = {
   gradient: {
     /** Gradient start - Magenta (logo top) */
     start: chalk.hex('#EC4899'),
-    
+
     /** Gradient middle - Purple (brand) */
     middle: chalk.hex('#8B5CF6'),
-    
+
     /** Gradient end - Blue (logo bottom) */
     end: chalk.hex('#3B82F6'),
   },
-  
+
   // ============================================
   // SEMANTIC SHORTCUTS
   // ============================================
-  
+
   /**
    * Highlighted text - Bold magenta for key information
    */
   highlight: chalk.hex('#EC4899').bold,
-  
+
   /**
    * Primary branding - Bold purple for grimoire brand moments
    */
   brandPrimary: chalk.hex('#8B5CF6').bold,
-  
+
   /**
    * Secondary branding - Cyan for supporting brand elements
    */
@@ -127,25 +127,25 @@ const colors = {
 const status = {
   /** Success indicator: ✓ (green) */
   success: (text) => `${colors.success('✓')} ${text}`,
-  
+
   /** Error indicator: ✗ (red) */
   error: (text) => `${colors.error('✗')} ${text}`,
-  
+
   /** Warning indicator: ⚠️ (orange) */
   warning: (text) => `${colors.warning('⚠️')} ${text}`,
-  
+
   /** Info indicator: ℹ (cyan) */
   info: (text) => `${colors.info('ℹ')} ${text}`,
-  
+
   /** Loading indicator: ⏳ (cyan) */
   loading: (text) => `${colors.info('⏳')} ${text}`,
-  
+
   /** Skipped indicator: ⊘ (muted) */
   skipped: (text) => `${colors.muted('⊘')} ${text}`,
-  
+
   /** Tip indicator: 💡 (info) */
   tip: (text) => `${colors.info('💡')} ${text}`,
-  
+
   /** Party indicator: 🎉 (brand primary) */
   celebrate: (text) => `${colors.brandPrimary('🎉')} ${text}`,
 };
@@ -156,13 +156,13 @@ const status = {
 const headings = {
   /** H1 - Brand primary, bold, large spacing */
   h1: (text) => `\n${colors.brandPrimary(text)}\n`,
-  
+
   /** H2 - Primary color, bold */
   h2: (text) => `\n${colors.primary.bold(text)}\n`,
-  
+
   /** H3 - Primary color */
   h3: (text) => colors.primary(text),
-  
+
   /** Section divider */
   divider: () => colors.dim('─'.repeat(50)),
 };
@@ -173,10 +173,10 @@ const headings = {
 const lists = {
   /** Bullet point (primary) */
   bullet: (text) => `${colors.primary('•')} ${text}`,
-  
+
   /** Numbered item (primary) */
   numbered: (num, text) => `${colors.primary(`${num}.`)} ${text}`,
-  
+
   /** Checkbox unchecked */
   checkbox: (text, checked = false) => {
     const icon = checked ? colors.success('☑') : colors.muted('☐');
@@ -192,31 +192,60 @@ const examples = {
     console.log(headings.h1('🎉 Welcome to grimoire v4 Installer!'));
     console.log(colors.info('Let\'s configure your project in just a few steps...\n'));
   },
-  
+
   question: () => {
     console.log(colors.primary('? Select your project type:'));
     console.log(lists.bullet('Greenfield (new project)'));
     console.log(lists.bullet('Brownfield (existing project)'));
   },
-  
+
   progress: () => {
     console.log(status.loading('Installing dependencies...'));
     console.log(status.success('Dependencies installed'));
     console.log(status.loading('Configuring environment...'));
   },
-  
+
   feedback: () => {
     console.log(status.success('Configuration complete!'));
     console.log(status.warning('Existing .env found. Overwrite?'));
     console.log(status.error('Invalid path provided'));
     console.log(status.tip('You can change this later in settings'));
   },
-  
-  complete: () => {
+
+  complete: (projectDir) => {
     console.log('\n' + headings.divider());
     console.log(status.celebrate('Installation Complete!'));
     console.log(colors.info('Your grimoire project is ready to use.'));
     console.log(headings.divider() + '\n');
+
+    // First-Run Next Steps
+    const path = require('path');
+    const fs = require('fs');
+    const cwd = projectDir || process.cwd();
+    const hasGemini = fs.existsSync(path.join(cwd, 'GEMINI.md'));
+    const hasClaude = fs.existsSync(path.join(cwd, '.claude'));
+    const hasCursor = fs.existsSync(path.join(cwd, '.cursor'));
+
+    let ideStep = '  2. Abra o Gemini CLI: gemini  →  Michelangelo te recebe';
+    if (hasClaude) ideStep = '  2. Abra o Claude Code — use /dev, /qa, /architect';
+    else if (hasCursor) ideStep = '  2. Abra o Cursor — @dev, @qa, @architect no chat';
+    else if (hasGemini) ideStep = '  2. Abra o Gemini CLI: gemini  →  Michelangelo te recebe';
+
+    const agentsDir = path.join(cwd, '.codex', 'agents');
+    const agentCount = fs.existsSync(agentsDir)
+      ? fs.readdirSync(agentsDir).filter(f => f.endsWith('.md')).length : 0;
+
+    console.log(`🎯 Próximos passos:
+  1. Verifique a instalação:   grimoire status
+${ideStep}
+  3. Liste os agentes:         grimoire agents list
+  4. Diagnóstico completo:     grimoire doctor
+
+💡 Dica: Diga "@dev implementa o login" no chat da sua IDE.
+   Você tem ${agentCount} agentes prontos: @dev @qa @architect @grimoire-master...
+
+📚 Docs: https://github.com/gabrielrlima/grimoire#readme
+`);
   },
 };
 

package/squads/.gitkeep

@@ -0,0 +1,2 @@
+# This file ensures the squads directory is tracked by Git
+# Add your squads (squads) here

package/squads/README.md

@@ -0,0 +1,25 @@
+# Grimoire Squads
+
+Este diretório contém os squads pré-configurados para organizar o fluxo de trabalho dos agentes.
+
+## Squads Disponíveis
+
+### 1. Full Stack Development
+**Agentes:** @dev, @qa, @architect  
+**Foco:** Planejamento técnico, codificação e testes.
+
+### 2. Planning & Strategy
+**Agentes:** @analyst, @pm, @architect, @ux-design-expert  
+**Foco:** Transformar ideias em PRDs e arquitetura.
+
+### 3. DevOps & Management
+**Agentes:** @devops, @sm, @po  
+**Foco:** Backlog, sprints e pipelines de deploy.
+
+## Como Usar
+Para carregar um squad durante a instalação ou re-setup, selecione as opções correspondentes no CLI do Grimoire.
+
+## Como Criar Squads Customizados
+1. Crie uma nova pasta dentro de `squads/`.
+2. Adicione um arquivo `squad.yaml` com nome, descrição e a lista de agentes (referenciando arquivos em `.codex/agents/`).
+3. Adicione fluxos de trabalho em uma pasta `workflows/` opcional.

package/squads/devops/squad.yaml

@@ -0,0 +1,9 @@
+name: "DevOps & Management Squad"
+description: "Squad responsável pelo ciclo de entrega, automação e gerenciamento de backlog."
+agents:
+  - devops
+  - sm
+  - po
+workflows:
+  - id: deploy-pipeline
+    file: workflows/deploy-pipeline.md

package/squads/devops/workflows/deploy-pipeline.md

@@ -0,0 +1,22 @@
+# Workflow: Pipeline de Deploy (Deploy Pipeline)
+
+**Objetivo:** Garantir a entrega segura e automatizada do software.
+
+## Etapas do Fluxo
+
+### 1. Quality Gate
+- **Agente:** @devops
+- **Ação:** Rodar lint, testes e build no CI antes do push.
+
+### 2. Versionamento
+- **Agente:** @devops
+- **Ação:** Realizar o bump de versão e criar tags de release.
+
+### 3. Promoção de Ambiente
+- **Agente:** @devops
+- **Ação:** Orquestrar o deploy para staging ou produção.
+
+## Ferramentas
+- GitHub Actions
+- Semantic Release
+- Quality Gate Hooks

package/squads/fullstack/squad.yaml

@@ -0,0 +1,11 @@
+name: "Full Stack Development Squad"
+description: "Squad completo para planejamento, implementação e teste de features de software."
+agents:
+  - dev
+  - qa
+  - architect
+workflows:
+  - id: new-feature
+    file: workflows/new-feature.md
+  - id: code-review
+    file: workflows/code-review.md

package/squads/fullstack/workflows/code-review.md

@@ -0,0 +1,22 @@
+# Workflow: Revisão de Código (Code Review)
+
+**Objetivo:** Garantir a qualidade e consistência do código antes do merge.
+
+## Etapas do Fluxo
+
+### 1. Análise Estática
+- **Agente:** @qa (em conjunto com CodeRabbit)
+- **Ação:** Identificar bugs latentes, vulnerabilidades e dívida técnica.
+
+### 2. Revisão de Padrões
+- **Agente:** @architect
+- **Ação:** Validar se o código segue os padrões arquiteturais do projeto.
+
+### 3. Validação de Lógica
+- **Agente:** @dev (Peer Review)
+- **Ação:** Revisar a lógica de negócio implementada.
+
+## Critérios de Aprovação
+- Zero problemas críticos de segurança.
+- Lint e testes passando 100%.
+- Conformidade com ADRs existentes.

package/squads/fullstack/workflows/new-feature.md

@@ -0,0 +1,24 @@
+# Workflow: Nova Funcionalidade (New Feature)
+
+**Objetivo:** Levar uma ideia de funcionalidade até a produção através de um fluxo estruturado.
+
+## Etapas do Fluxo
+
+### 1. Planejamento Arquitetural
+- **Agente:** @architect
+- **Ação:** Criar ou atualizar o design do sistema para a nova feature.
+- **Saída:** Documento de arquitetura técnica.
+
+### 2. Implementação
+- **Agente:** @dev
+- **Ação:** Codificar a funcionalidade seguindo o design aprovado.
+- **Saída:** Código-fonte implementado e commitado localmente.
+
+### 3. Garantia de Qualidade (QA)
+- **Agente:** @qa
+- **Ação:** Validar a implementação contra os critérios de aceitação.
+- **Saída:** Aprovação de QA e sugestões de melhoria.
+
+## Gatilhos (Triggers)
+- Solicitação de nova feature pelo @pm
+- Backlog de sprints atualizado pelo @sm

package/squads/planning/squad.yaml

@@ -0,0 +1,10 @@
+name: "Planning & Strategy Squad"
+description: "Squad focado em requisitos, design de sistema e experiência do usuário (UX)."
+agents:
+  - analyst
+  - pm
+  - architect
+  - ux-design-expert
+workflows:
+  - id: prd-to-stories
+    file: workflows/prd-to-stories.md

package/squads/planning/workflows/prd-to-stories.md

@@ -0,0 +1,20 @@
+# Workflow: PRD para Histórias (PRD to Stories)
+
+**Objetivo:** Fragmentar requisitos de alto nível em unidades de desenvolvimento acionáveis.
+
+## Etapas do Fluxo
+
+### 1. Refinamento de Requisitos
+- **Agente:** @analyst + @pm
+- **Ação:** Validar o briefing e transformar em um PRD completo.
+
+### 2. Design Visual (UX)
+- **Agente:** @ux-design-expert
+- **Ação:** Criar fluxos de usuário e wireframes para os requisitos.
+
+### 3. Fragmentação (Sharding)
+- **Agente:** @sm
+- **Ação:** Criar as histórias (stories) em `docs/stories/` com base no PRD.
+
+## Saída Esperada
+- Backlog de stories priorizado e pronto para implementação.