grimoire-framework 1.0.17 → 1.0.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/.grimoire/install-manifest.yaml +2 -2
  2. package/README.md +91 -45
  3. package/package.json +1 -1
package/.grimoire/install-manifest.yaml CHANGED
@@ -7,8 +7,8 @@
7
7
  # - SHA256 hashes for change detection
8
8
  # - File types for categorization
9
9
  #
10
- version: 1.0.17
11
- generated_at: "2026-02-22T13:53:52.136Z"
10
+ version: 1.0.18
11
+ generated_at: "2026-02-22T14:00:42.557Z"
12
12
  generator: scripts/generate-install-manifest.js
13
13
  file_count: 1011
14
14
  files:
package/README.md CHANGED
@@ -10,74 +10,121 @@
10
10
 
11
11
  ## 🚀 Início Rápido
12
12
 
13
- Nenhuma instalação global necessária — use diretamente via `npx`:
14
-
15
13
  ```bash
16
14
  # Instalar o Grimoire em um projeto existente
17
- npx grimoire-framework
18
-
19
- # Ou explicitamente
20
15
  npx grimoire-framework install
16
+
17
+ # Atualizar para a versão mais recente (preserva customizações)
18
+ npx grimoire-framework update
21
19
  ```
22
20
 
21
+ Após a instalação, abra o **Gemini CLI** no diretório do projeto:
22
+
23
23
  ```bash
24
- # Criar um novo projeto do zero
25
- npx grimoire-framework init meu-projeto
24
+ gemini
25
+ # 👑 Michelangelo (grimoire-master) pronto para orquestrar!
26
26
  ```
27
27
 
28
28
  ---
29
29
 
30
- ## 🛠️ Comandos da CLI
30
+ ## 🛠️ Comandos CLI
31
+
32
+ ### Gerenciamento do Framework
31
33
 
32
34
  | Comando | Descrição |
33
35
  |---|---|
34
- | `npx grimoire-framework` | Wizard interativo de instalação |
35
36
  | `npx grimoire-framework install` | Instalar no projeto atual |
36
- | `npx grimoire-framework init <nome>` | Criar novo projeto |
37
- | `npx grimoire-framework update` | Atualizar para a versão mais recente |
38
- | `npx grimoire-framework validate` | Validar integridade da instalação |
39
- | `npx grimoire-framework doctor` | Diagnóstico e auto-reparação |
40
- | `npx grimoire-framework info` | Informações do sistema |
41
- | `npx grimoire-framework --version` | Versão instalada |
37
+ | `npx grimoire-framework update` | Atualizar preservando customizações |
38
+ | `npx grimoire-framework update --force` | Forçar resync de todos os arquivos |
39
+ | `npx grimoire-framework update --dry-run` | Simular update (sem aplicar) |
42
40
 
43
- ---
41
+ ### Diagnóstico
44
42
 
45
- ## 🧠 O que é o Grimoire?
43
+ | Comando | Descrição |
44
+ |---|---|
45
+ | `grimoire status` | Saúde do framework + integração IDE |
46
+ | `grimoire doctor` | Diagnóstico detalhado com dicas de fix |
47
+ | `grimoire agents list` | Listar agentes com personas |
48
+ | `grimoire whoami` | Contexto da sessão atual |
49
+ | `grimoire --version` | Versão instalada |
46
50
 
47
- O Grimoire não é apenas um assistente de código — é uma **equipe de engenharia completa na sua linha de comando**. Ele usa o **Autonomous Development Engine (ADE)** para planejar, executar, testar e revisar código de forma independente.
51
+ > 💡 **CLI vs Agentes:** `grimoire` (terminal) gerencia o framework. `@dev`, `@qa`, `@architect` (chat da IDE) são os agentes de IA — interfaces completamente diferentes.
48
52
 
49
- ### Filosofia: CLI First
50
- Toda a inteligência reside nos arquivos de configuração instalados em `.grimoire/`. Seus agentes são ativados diretamente pela sua IDE favorita, sem servidores externos.
53
+ ---
54
+
55
+ ## 🧙 Agentes Disponíveis
51
56
 
52
- ### IDEs Suportadas
53
- - **Claude Code** — Ative agentes com `/architect`, `/dev`, `/qa`
54
- - **Gemini CLI** — Use `/grimoire-menu` ou `/grimoire-dev`
55
- - **Cursor** — Sincronização automática via `.cursorrules`
56
- - **VS Code / Codex** — Integração nativa via arquivos de regras
57
+ Após instalar, ative os agentes diretamente no chat da sua IDE:
58
+
59
+ | Comando | Persona | Especialidade |
60
+ |---|---|---|
61
+ | `@grimoire-master` | 👑 Michelangelo | Orquestração & framework |
62
+ | `@dev` | 🎨 Da Vinci | Desenvolvimento Full-Stack |
63
+ | `@qa` | 🖌️ Dürer | Quality Assurance & Testes |
64
+ | `@architect` | 🏛️ Gaudí | Arquitetura de Sistemas |
65
+ | `@pm` | 📋 Raphael | Product Manager |
66
+ | `@sm` | 🌊 Monet | Scrum Master |
67
+ | `@devops` | ⚡ Boccioni | DevOps & Infraestrutura |
68
+ | `@data-engineer` | 📊 Escher | Engenharia de Dados |
69
+ | `@analyst` | 🔍 Vermeer | Pesquisa & Análise |
70
+ | `@ux-design-expert` | 🎭 Matisse | UX/UI Design |
71
+ | `@po` | 🎯 Velázquez | Product Owner |
57
72
 
58
73
  ---
59
74
 
60
- ## 🏗️ Arquitetura
75
+ ## 💻 Integração com IDEs
76
+
77
+ ### Gemini CLI (Recomendado)
78
+ O Grimoire configura automaticamente o arquivo `GEMINI.md` na raiz do projeto. O Michelangelo se apresenta ao abrir o Gemini CLI.
79
+
80
+ ```bash
81
+ gemini
82
+ # 👑 Michelangelo (grimoire-master) pronto para orquestrar!
83
+ # Projeto: meu-projeto
84
+ ```
85
+
86
+ Para ativar um agente especializado:
87
+ ```
88
+ @dev ou Da Vinci ou ative o @architect
89
+ ```
90
+
91
+ ### Claude Code
92
+ Agentes disponíveis em `.claude/commands/grimoire/`. Use `/dev`, `/qa`, `/architect`.
61
93
 
62
- Após a instalação, o Grimoire cria o diretório `.grimoire/` no seu projeto com:
94
+ ### Cursor
95
+ Regras instaladas em `.cursor/rules/agents/`. Agentes ativados via contexto do chat.
96
+
97
+ ---
98
+
99
+ ## 🏗️ Estrutura Instalada
63
100
 
64
101
  ```
65
- .grimoire/
66
- ├── development/
67
- │ ├── agents/ # Analista, Arquiteto, Dev, QA, etc.
68
- │ ├── tasks/ # Tarefas reutilizáveis
69
- │ └── workflows/ # Fluxos de desenvolvimento
70
- ├── infrastructure/ # Scripts de integração e hooks
71
- ├── product/ # Templates e checklists
72
- └── core/ # Configurações do framework
102
+ projeto/
103
+ ├── GEMINI.md ← Config principal do Gemini CLI (Michelangelo)
104
+ ├── .gemini/
105
+ │ ├── rules.md ← Compatibilidade com versões antigas do Gemini CLI
106
+ │ └── rules/grimoire/ ← Definições de agentes para Gemini
107
+ ├── .codex/agents/ ← Definições de todos os agentes (12 core)
108
+ ├── .cursor/rules/agents/ ← Agentes para Cursor
109
+ ├── .claude/commands/ ← Comandos para Claude Code
110
+ └── .grimoire/ ← Memória, métricas e configurações
73
111
  ```
74
112
 
75
- ### Componentes Principais
113
+ ---
76
114
 
77
- 1. **Spec Pipeline** — Transforma prompts em especificações técnicas executáveis
78
- 2. **Execution Engine** — Implementação autônoma com autocrítica de código
79
- 3. **Recovery System** — Detecção automática de erros com rollback e retry
80
- 4. **QA Loop** — Revisão de código em múltiplas fases (80%+ cobertura)
115
+ ## 🔄 Fluxo de Update
116
+
117
+ O `grimoire update` é inteligente — preserva as suas customizações:
118
+
119
+ - ✅ **Atualiza** arquivos do framework (agentes core, GEMINI.md)
120
+ - 🔒 **Preserva** arquivos que só existem no seu projeto (agentes customizados)
121
+ - ➕ **Adiciona** arquivos novos do framework
122
+
123
+ ```bash
124
+ npx grimoire-framework update # Update normal
125
+ npx grimoire-framework update --force # Forçar re-sync completo
126
+ npx grimoire-framework update --dry-run # Ver o que mudaria
127
+ ```
81
128
 
82
129
  ---
83
130
 
@@ -91,6 +138,10 @@ Após a instalação, o Grimoire cria o diretório `.grimoire/` no seu projeto c
91
138
 
92
139
  ## 🗺️ Roadmap
93
140
 
141
+ - [x] Smart Update com preservação de customizações
142
+ - [x] Publisher Quality Gate (CI/CD)
143
+ - [x] Integração Gemini CLI via `GEMINI.md`
144
+ - [x] 12 agentes com personas artísticas (Michelangelo, Da Vinci, Dürer...)
94
145
  - [ ] **Sistema de Login & Autenticação** — Governança para equipes
95
146
  - [ ] **Project Models** — Templates para SaaS, Mobile, API
96
147
  - [ ] **Persistent Memory Layer** — Aprendizado de padrões do seu código
@@ -103,14 +154,9 @@ Após a instalação, o Grimoire cria o diretório `.grimoire/` no seu projeto c
103
154
  Contribuições são bem-vindas! Veja [CONTRIBUTING.md](CONTRIBUTING.md) para detalhes.
104
155
 
105
156
  ```bash
106
- # Clone o repositório
107
157
  git clone https://github.com/gabrielrlima/grimoire.git
108
158
  cd grimoire
109
-
110
- # Instale as dependências
111
159
  npm install
112
-
113
- # Rode os testes
114
160
  npm test
115
161
  ```
116
162
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "grimoire-framework",
3
- "version": "1.0.17",
3
+ "version": "1.0.18",
4
4
  "description": "Grimoire: AI-Orchestrated System for Full Stack Development - Core Framework",
5
5
  "publishConfig": {
6
6
  "access": "public"