@evolve.labs/devflow 0.8.0 → 0.8.1
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 +128 -90
- package/lib/constants.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
# DevFlow v0.
|
|
1
|
+
# DevFlow v0.8.0 - Sistema Multi-Agentes + Web IDE
|
|
2
2
|
|
|
3
|
-
Sistema de multi-agentes especializados para desenvolvimento de software, com **6 agentes
|
|
3
|
+
Sistema de multi-agentes especializados para desenvolvimento de software, com **6 agentes**, **Web IDE** integrada e **Autopilot** para execução automatizada.
|
|
4
4
|
|
|
5
|
-
[](docs/CHANGELOG.md)
|
|
6
|
+
[](https://www.npmjs.com/package/@evolve.labs/devflow)
|
|
7
7
|
[](LICENSE)
|
|
8
8
|
|
|
9
9
|
## Screenshots
|
|
@@ -20,68 +20,107 @@ Sistema de multi-agentes especializados para desenvolvimento de software, com **
|
|
|
20
20
|
|
|
21
21
|
---
|
|
22
22
|
|
|
23
|
-
##
|
|
23
|
+
## Novidades v0.8.0
|
|
24
|
+
|
|
25
|
+
### Autopilot
|
|
26
|
+
- **Terminal-based**: Agents rodam no terminal com output streaming em tempo real
|
|
27
|
+
- **CLI headless**: `devflow autopilot <spec-file>` para rodar sem Web IDE
|
|
28
|
+
- **Auto-task tracking**: Tasks na spec sao marcadas automaticamente como concluidas
|
|
29
|
+
- **Abort**: Cancele a qualquer momento
|
|
30
|
+
|
|
31
|
+
### Web IDE
|
|
32
|
+
- Removido File Explorer (navegacao por projeto)
|
|
33
|
+
- Multi-project support com ProjectSelector
|
|
34
|
+
- Agent completion tracking com badges visuais
|
|
35
|
+
- Layout simplificado sem sidebar
|
|
24
36
|
|
|
25
37
|
### System Designer Agent (6th agent)
|
|
26
38
|
- System Design Documents (SDDs) com back-of-the-envelope calculations
|
|
27
39
|
- RFCs, capacity planning, trade-off analysis
|
|
28
40
|
- SLA/SLO/SLI definitions e reliability patterns
|
|
29
41
|
|
|
30
|
-
### npm Package
|
|
31
|
-
- `npx devflow-agents init` para instalacao rapida
|
|
32
|
-
- `devflow update` para atualizacoes
|
|
33
|
-
- Flag `--web` para incluir Web IDE
|
|
34
|
-
|
|
35
|
-
### Web IDE (Opcional)
|
|
36
|
-
Interface visual completa para gerenciar seu projeto DevFlow:
|
|
37
|
-
|
|
38
|
-
- **Terminal Integrado** - Interface principal via xterm.js + node-pty
|
|
39
|
-
- **Dashboard** - Metricas do projeto, health check, status dos agentes
|
|
40
|
-
- **Specs Panel** - Visualize requirements, design decisions e tasks
|
|
41
|
-
- **File Explorer** - Navegue pelo codigo com preview de markdown/mermaid
|
|
42
|
-
- **Editor Monaco** - Editor profissional com syntax highlighting
|
|
43
|
-
- **Settings** - Configure tema, fonte, terminal
|
|
44
|
-
|
|
45
42
|
---
|
|
46
43
|
|
|
47
|
-
##
|
|
44
|
+
## Instalacao
|
|
48
45
|
|
|
49
46
|
### Via npm (Recomendado)
|
|
50
47
|
|
|
51
48
|
```bash
|
|
52
|
-
#
|
|
53
|
-
|
|
49
|
+
# Instalar globalmente
|
|
50
|
+
npm install -g @evolve.labs/devflow
|
|
54
51
|
|
|
55
|
-
#
|
|
56
|
-
npm install -g devflow-agents
|
|
52
|
+
# Inicializar no seu projeto
|
|
57
53
|
devflow init /caminho/para/seu-projeto
|
|
58
54
|
|
|
59
|
-
#
|
|
55
|
+
# Ou usar npx (sem instalar)
|
|
56
|
+
npx @evolve.labs/devflow init
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### Opcoes de instalacao
|
|
60
|
+
|
|
61
|
+
```bash
|
|
60
62
|
devflow init # Agentes + estrutura de docs (padrao)
|
|
61
63
|
devflow init --agents-only # Apenas agentes (minimo)
|
|
62
64
|
devflow init --full # Tudo incluindo .gitignore
|
|
63
65
|
devflow init --web # Inclui Web IDE (opcional)
|
|
64
66
|
devflow init --full --web # Tudo + Web IDE
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Comandos
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
devflow init [path] # Inicializar DevFlow num projeto
|
|
73
|
+
devflow update [path] # Atualizar instalacao existente
|
|
74
|
+
devflow web # Iniciar Web IDE (http://localhost:3000)
|
|
75
|
+
devflow autopilot <spec-file> # Rodar autopilot nos agentes
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Autopilot
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
# Rodar todas as fases
|
|
82
|
+
devflow autopilot docs/specs/minha-spec.md
|
|
65
83
|
|
|
66
|
-
#
|
|
67
|
-
devflow
|
|
84
|
+
# Escolher fases especificas
|
|
85
|
+
devflow autopilot docs/specs/minha-spec.md --phases "strategist,architect,builder"
|
|
86
|
+
|
|
87
|
+
# Apontar para outro projeto
|
|
88
|
+
devflow autopilot docs/specs/minha-spec.md --project /path/to/project
|
|
89
|
+
|
|
90
|
+
# Sem auto-update de tasks
|
|
91
|
+
devflow autopilot docs/specs/minha-spec.md --no-update
|
|
68
92
|
```
|
|
69
93
|
|
|
70
|
-
###
|
|
94
|
+
### Web IDE
|
|
71
95
|
|
|
72
96
|
```bash
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
97
|
+
# Iniciar (abre browser automaticamente)
|
|
98
|
+
devflow web
|
|
99
|
+
|
|
100
|
+
# Porta customizada
|
|
101
|
+
devflow web --port 8080
|
|
102
|
+
|
|
103
|
+
# Apontar para projeto especifico
|
|
104
|
+
devflow web --project /path/to/project
|
|
105
|
+
|
|
106
|
+
# Modo desenvolvimento
|
|
107
|
+
devflow web --dev
|
|
76
108
|
```
|
|
77
109
|
|
|
78
110
|
### Requisitos
|
|
79
111
|
|
|
80
112
|
- **Claude Code CLI** (`npm i -g @anthropic-ai/claude-code`)
|
|
81
|
-
- **Node.js 18+**
|
|
113
|
+
- **Node.js 18+**
|
|
82
114
|
- **Git** (recomendado)
|
|
83
115
|
|
|
84
|
-
###
|
|
116
|
+
### Dependencias por Sistema
|
|
117
|
+
|
|
118
|
+
#### macOS
|
|
119
|
+
```bash
|
|
120
|
+
xcode-select --install
|
|
121
|
+
brew install node
|
|
122
|
+
npm install -g @anthropic-ai/claude-code
|
|
123
|
+
```
|
|
85
124
|
|
|
86
125
|
#### Debian/Ubuntu
|
|
87
126
|
```bash
|
|
@@ -99,40 +138,15 @@ sudo dnf install -y python3 git nodejs npm
|
|
|
99
138
|
npm install -g @anthropic-ai/claude-code
|
|
100
139
|
```
|
|
101
140
|
|
|
102
|
-
#### RHEL/CentOS/Rocky
|
|
103
|
-
```bash
|
|
104
|
-
sudo dnf groupinstall -y "Development Tools"
|
|
105
|
-
sudo dnf install -y python3 git
|
|
106
|
-
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
|
|
107
|
-
sudo dnf install -y nodejs
|
|
108
|
-
npm install -g @anthropic-ai/claude-code
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
#### macOS
|
|
112
|
-
```bash
|
|
113
|
-
xcode-select --install
|
|
114
|
-
brew install node
|
|
115
|
-
npm install -g @anthropic-ai/claude-code
|
|
116
|
-
```
|
|
117
|
-
|
|
118
141
|
#### Windows (WSL)
|
|
119
142
|
```powershell
|
|
120
|
-
# PowerShell como Admin
|
|
121
143
|
wsl --install
|
|
122
144
|
```
|
|
123
|
-
Depois siga as
|
|
124
|
-
|
|
125
|
-
### Web IDE (Opcional)
|
|
126
|
-
```bash
|
|
127
|
-
cd devflow/web
|
|
128
|
-
npm install
|
|
129
|
-
npm run dev
|
|
130
|
-
# Acesse http://localhost:3000
|
|
131
|
-
```
|
|
145
|
+
Depois siga as instrucoes de Debian/Ubuntu no terminal WSL.
|
|
132
146
|
|
|
133
147
|
---
|
|
134
148
|
|
|
135
|
-
##
|
|
149
|
+
## Os 6 Agentes
|
|
136
150
|
|
|
137
151
|
| # | Agente | Funcao | Uso |
|
|
138
152
|
|---|--------|--------|-----|
|
|
@@ -151,62 +165,85 @@ strategist → architect → system-designer → builder → guardian → chroni
|
|
|
151
165
|
|
|
152
166
|
Cada agente tem **hard stops** — limites rigidos que impedem de fazer trabalho de outros agentes.
|
|
153
167
|
|
|
168
|
+
### Autopilot
|
|
169
|
+
|
|
170
|
+
O autopilot executa os agentes em sequencia automaticamente. Cada fase recebe o output da anterior como contexto:
|
|
171
|
+
|
|
172
|
+
```
|
|
173
|
+
1. Strategist analisa a spec e refina requisitos
|
|
174
|
+
2. Architect define a arquitetura baseado na analise
|
|
175
|
+
3. System Designer projeta o sistema em escala
|
|
176
|
+
4. Builder implementa conforme design
|
|
177
|
+
5. Guardian revisa seguranca e qualidade
|
|
178
|
+
6. Chronicler documenta tudo
|
|
179
|
+
```
|
|
180
|
+
|
|
154
181
|
---
|
|
155
182
|
|
|
156
|
-
##
|
|
183
|
+
## Web IDE Features
|
|
157
184
|
|
|
158
185
|
### Dashboard
|
|
159
|
-
-
|
|
186
|
+
- Metricas do projeto (specs, decisoes, tasks)
|
|
160
187
|
- Health check (Claude CLI, .devflow, git)
|
|
161
188
|
- Status em tempo real
|
|
162
189
|
|
|
163
190
|
### Specs Panel
|
|
164
191
|
- **Requirements** - User stories com acceptance criteria
|
|
165
192
|
- **Design** - Architecture Decision Records (ADRs)
|
|
166
|
-
- **Tasks** - Tarefas de
|
|
193
|
+
- **Tasks** - Tarefas de implementacao
|
|
194
|
+
|
|
195
|
+
### Terminal + Autopilot
|
|
196
|
+
- Terminal integrado via xterm.js + node-pty
|
|
197
|
+
- Autopilot roda direto no terminal com streaming
|
|
198
|
+
- Tab dedicada "Autopilot" criada automaticamente
|
|
199
|
+
- Botao Abort para cancelar execucao
|
|
167
200
|
|
|
168
201
|
### Editor
|
|
169
202
|
- Monaco Editor (VS Code engine)
|
|
170
203
|
- Syntax highlighting para 50+ linguagens
|
|
171
204
|
- Preview de Markdown com Mermaid diagrams
|
|
172
|
-
-
|
|
205
|
+
- Multiplas tabs com indicador de dirty state
|
|
173
206
|
|
|
174
|
-
###
|
|
175
|
-
-
|
|
176
|
-
-
|
|
177
|
-
- Histórico de comandos
|
|
178
|
-
- Resize responsivo
|
|
207
|
+
### Multi-Project
|
|
208
|
+
- ProjectSelector para alternar entre projetos
|
|
209
|
+
- Cada projeto com seus proprios specs e agents
|
|
179
210
|
|
|
180
211
|
---
|
|
181
212
|
|
|
182
|
-
##
|
|
213
|
+
## Estrutura do Projeto
|
|
183
214
|
|
|
184
215
|
```
|
|
185
|
-
|
|
216
|
+
seu-projeto/
|
|
186
217
|
├── .claude/ # Comandos e agentes
|
|
187
|
-
│ └── commands/
|
|
188
|
-
│
|
|
218
|
+
│ └── commands/
|
|
219
|
+
│ ├── agents/ # Definicoes dos 6 agentes
|
|
220
|
+
│ └── quick/ # Quick start commands
|
|
189
221
|
│
|
|
190
|
-
├── .devflow/ #
|
|
191
|
-
│ ├──
|
|
222
|
+
├── .devflow/ # Configuracao do projeto
|
|
223
|
+
│ ├── agents/ # Metadata dos agentes
|
|
192
224
|
│ └── project.yaml # Estado do projeto
|
|
193
225
|
│
|
|
194
|
-
├── docs/ #
|
|
226
|
+
├── docs/ # Documentacao
|
|
195
227
|
│ ├── decisions/ # ADRs
|
|
196
228
|
│ ├── planning/ # Stories e specs
|
|
197
|
-
│
|
|
229
|
+
│ ├── snapshots/ # Historico do projeto
|
|
230
|
+
│ └── system-design/ # SDDs, RFCs, capacity plans
|
|
231
|
+
│ ├── sdd/
|
|
232
|
+
│ ├── rfc/
|
|
233
|
+
│ ├── capacity/
|
|
234
|
+
│ └── trade-offs/
|
|
198
235
|
│
|
|
199
|
-
└── web/ # Web IDE
|
|
200
|
-
├── app/ # Next.js pages
|
|
236
|
+
└── web/ # Web IDE (opcional, com --web)
|
|
237
|
+
├── app/ # Next.js pages + API routes
|
|
201
238
|
├── components/ # React components
|
|
202
|
-
└── lib/ #
|
|
239
|
+
└── lib/ # Stores, utils, types
|
|
203
240
|
```
|
|
204
241
|
|
|
205
242
|
---
|
|
206
243
|
|
|
207
|
-
##
|
|
244
|
+
## Versoes
|
|
208
245
|
|
|
209
|
-
|
|
|
246
|
+
| Versao | Features |
|
|
210
247
|
|--------|----------|
|
|
211
248
|
| v0.1.0 | Multi-agent system, Documentation automation |
|
|
212
249
|
| v0.2.0 | Structured metadata, Knowledge graph |
|
|
@@ -214,20 +251,21 @@ devflow/
|
|
|
214
251
|
| v0.4.0 | Web IDE completa |
|
|
215
252
|
| v0.5.0 | Terminal como interface principal, WSL support |
|
|
216
253
|
| v0.6.0 | Permission mode configuration |
|
|
217
|
-
|
|
|
254
|
+
| v0.7.0 | System Designer agent (6th), npm package |
|
|
255
|
+
| **v0.8.0** | **Autopilot terminal-based, CLI commands, Multi-project, Web IDE refactoring** |
|
|
218
256
|
|
|
219
257
|
---
|
|
220
258
|
|
|
221
|
-
##
|
|
259
|
+
## Documentacao
|
|
222
260
|
|
|
223
261
|
- **[Quick Start](docs/QUICKSTART.md)** - Comece em 5 minutos
|
|
224
|
-
- **[
|
|
262
|
+
- **[Instalacao](docs/INSTALLATION.md)** - Guia detalhado
|
|
225
263
|
- **[Arquitetura](docs/ARCHITECTURE.md)** - Como funciona
|
|
226
|
-
- **[Changelog](docs/CHANGELOG.md)** -
|
|
264
|
+
- **[Changelog](docs/CHANGELOG.md)** - Historico de mudancas
|
|
227
265
|
|
|
228
266
|
---
|
|
229
267
|
|
|
230
|
-
##
|
|
268
|
+
## Tech Stack (Web IDE)
|
|
231
269
|
|
|
232
270
|
- **Next.js 15** - Framework React
|
|
233
271
|
- **TypeScript** - Type safety
|
|
@@ -240,10 +278,10 @@ devflow/
|
|
|
240
278
|
|
|
241
279
|
---
|
|
242
280
|
|
|
243
|
-
##
|
|
281
|
+
## Licenca
|
|
244
282
|
|
|
245
283
|
MIT License - veja [LICENSE](LICENSE) para detalhes.
|
|
246
284
|
|
|
247
285
|
---
|
|
248
286
|
|
|
249
|
-
**DevFlow v0.
|
|
287
|
+
**DevFlow v0.8.0** - Desenvolvido por [Evolve Labs](https://evolvelabs.cloud)
|
package/lib/constants.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@evolve.labs/devflow",
|
|
3
|
-
"version": "0.8.
|
|
3
|
+
"version": "0.8.1",
|
|
4
4
|
"description": "Multi-agent system for software development with Claude Code. 6 specialized agents (Strategist, Architect, System Designer, Builder, Guardian, Chronicler) as slash commands.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"claude-code",
|