@maestro-ai/cli 1.0.0 → 1.1.0
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.
- package/README.md +121 -19
- package/content/rules/GEMINI.md +841 -0
- package/content/rules/RULES.md +835 -0
- package/content/rules/adapters/copilot.md +10 -0
- package/content/rules/adapters/cursor.md +10 -0
- package/content/rules/adapters/gemini.md +13 -0
- package/content/rules/adapters/windsurf.md +10 -0
- package/dist/commands/init.d.ts +1 -0
- package/dist/commands/init.js +47 -15
- package/dist/index.js +10 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,41 +1,120 @@
|
|
|
1
|
-
# @maestro/cli
|
|
1
|
+
# @maestro-ai/cli
|
|
2
2
|
|
|
3
3
|
CLI para inicializar projetos com Maestro - Desenvolvimento assistido por IA.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## 🚀 Uso Rápido
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
-
npx @maestro
|
|
8
|
+
npx @maestro-ai/cli
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
Só isso! O comando injeta automaticamente todos os arquivos na pasta atual.
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
---
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
## ⚙️ Opções
|
|
16
|
+
|
|
17
|
+
| Opção | Descrição |
|
|
18
|
+
|-------|-----------|
|
|
19
|
+
| `--force` | Sobrescreve arquivos existentes |
|
|
20
|
+
| `--minimal` | Instala apenas workflows + rules |
|
|
21
|
+
| `--ide <ide>` | IDE alvo: `gemini`, `cursor`, `copilot`, `windsurf`, `all` (default: `all`) |
|
|
22
|
+
|
|
23
|
+
### Exemplos
|
|
16
24
|
|
|
17
25
|
```bash
|
|
18
|
-
|
|
19
|
-
npx @maestro
|
|
20
|
-
|
|
26
|
+
# Instalação completa (todas as IDEs)
|
|
27
|
+
npx @maestro-ai/cli
|
|
28
|
+
|
|
29
|
+
# Apenas para Gemini/Antigravity
|
|
30
|
+
npx @maestro-ai/cli --ide gemini
|
|
31
|
+
|
|
32
|
+
# Apenas para Cursor
|
|
33
|
+
npx @maestro-ai/cli --ide cursor
|
|
34
|
+
|
|
35
|
+
# Apenas para GitHub Copilot
|
|
36
|
+
npx @maestro-ai/cli --ide copilot
|
|
37
|
+
|
|
38
|
+
# Apenas para Windsurf
|
|
39
|
+
npx @maestro-ai/cli --ide windsurf
|
|
40
|
+
|
|
41
|
+
# Sobrescrever arquivos existentes
|
|
42
|
+
npx @maestro-ai/cli --force
|
|
43
|
+
|
|
44
|
+
# Instalação mínima
|
|
45
|
+
npx @maestro-ai/cli --minimal
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## 📁 Estrutura Criada
|
|
51
|
+
|
|
21
52
|
```
|
|
53
|
+
projeto/
|
|
54
|
+
├── .maestro/
|
|
55
|
+
│ ├── config.json # Configuração do projeto
|
|
56
|
+
│ ├── history/ # Histórico de conversas
|
|
57
|
+
│ └── content/ # Especialistas, templates, guides, prompts
|
|
58
|
+
├── .agent/
|
|
59
|
+
│ ├── skills/ # Skills para a IA
|
|
60
|
+
│ └── workflows/ # Workflows automatizados
|
|
61
|
+
└── [Arquivos de regras por IDE]
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### Arquivos de Regras por IDE
|
|
65
|
+
|
|
66
|
+
| IDE | Arquivo Gerado |
|
|
67
|
+
|-----|----------------|
|
|
68
|
+
| Gemini/Antigravity | `.gemini/GEMINI.md` |
|
|
69
|
+
| Cursor | `.cursorrules` |
|
|
70
|
+
| GitHub Copilot | `.github/copilot-instructions.md` |
|
|
71
|
+
| Windsurf | `.windsurfrules` |
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## 🔄 Fluxo Esperado
|
|
76
|
+
|
|
77
|
+
```mermaid
|
|
78
|
+
graph LR
|
|
79
|
+
A[npx @maestro-ai/cli] --> B{Opção --ide?}
|
|
80
|
+
B -->|all| C[Gera todos]
|
|
81
|
+
B -->|específico| D[Gera um arquivo]
|
|
82
|
+
C --> E[.gemini/GEMINI.md]
|
|
83
|
+
C --> F[.cursorrules]
|
|
84
|
+
C --> G[.github/copilot-instructions.md]
|
|
85
|
+
C --> H[.windsurfrules]
|
|
86
|
+
D --> I[Arquivo da IDE escolhida]
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
1. **Execute o CLI** no diretório do seu projeto
|
|
90
|
+
2. **Escolha a IDE** (ou deixe `all` para suportar todas)
|
|
91
|
+
3. **Configure o MCP** na sua IDE
|
|
92
|
+
4. **Inicie um projeto Maestro** com `iniciar_projeto`
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 📋 Comandos
|
|
22
97
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
-
|
|
27
|
-
|
|
98
|
+
### `init` (padrão)
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
npx @maestro-ai/cli init
|
|
102
|
+
npx @maestro-ai/cli init --ide cursor
|
|
103
|
+
npx @maestro-ai/cli init --force
|
|
104
|
+
```
|
|
28
105
|
|
|
29
106
|
### `update`
|
|
30
107
|
|
|
31
108
|
Atualiza content para a última versão:
|
|
32
109
|
|
|
33
110
|
```bash
|
|
34
|
-
npx @maestro update
|
|
35
|
-
npx @maestro update --force # Sobrescreve arquivos modificados
|
|
111
|
+
npx @maestro-ai/cli update
|
|
112
|
+
npx @maestro-ai/cli update --force # Sobrescreve arquivos modificados
|
|
36
113
|
```
|
|
37
114
|
|
|
38
|
-
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## ⚡ Após Inicialização
|
|
39
118
|
|
|
40
119
|
Configure o MCP na sua IDE:
|
|
41
120
|
|
|
@@ -49,11 +128,34 @@ Configure o MCP na sua IDE:
|
|
|
49
128
|
}
|
|
50
129
|
```
|
|
51
130
|
|
|
52
|
-
|
|
131
|
+
Depois inicie um projeto:
|
|
132
|
+
|
|
133
|
+
```
|
|
134
|
+
@mcp:maestro iniciar_projeto
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## 🛠️ Desenvolvimento
|
|
53
140
|
|
|
54
141
|
```bash
|
|
55
142
|
cd packages/cli
|
|
56
143
|
npm install
|
|
57
144
|
npm run build
|
|
58
|
-
npm run dev -- init # Testar localmente
|
|
145
|
+
npm run dev -- init --ide gemini # Testar localmente
|
|
59
146
|
```
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## 📦 Publicação
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
npm version patch # ou minor/major
|
|
154
|
+
npm publish
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## 📄 Licença
|
|
160
|
+
|
|
161
|
+
MIT
|