rbin-task-flow 1.0.0 → 1.0.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/.claude/settings.json +1 -3
- package/README.md +447 -70
- package/bin/cli.js +1 -1
- package/lib/install.js +3 -0
- package/package.json +2 -2
package/.claude/settings.json
CHANGED
package/README.md
CHANGED
|
@@ -9,30 +9,399 @@
|
|
|
9
9
|

|
|
10
10
|

|
|
11
11
|
|
|
12
|
-
**
|
|
12
|
+
**Configuração com um comando para Claude Code, Gemini, Cursor e RBIN Task Flow em qualquer projeto**
|
|
13
|
+
|
|
14
|
+
<div style="margin-top: 20px; margin-bottom: 20px;">
|
|
15
|
+
<a href="#português">🇧🇷 Português</a> | <a href="#english">🇬🇧 English</a>
|
|
16
|
+
</div>
|
|
13
17
|
|
|
14
18
|
</div>
|
|
15
19
|
|
|
16
20
|
---
|
|
17
21
|
|
|
18
|
-
|
|
22
|
+
<div align="center">
|
|
19
23
|
|
|
20
|
-
|
|
24
|
+
### Screenshots
|
|
21
25
|
|
|
22
|
-
|
|
26
|
+
<img src=".github/screens/1.png" alt="Screenshot 1" width="800"/>
|
|
27
|
+
<img src=".github/screens/2.png" alt="Screenshot 2" width="800"/>
|
|
28
|
+
<img src=".github/screens/3.png" alt="Screenshot 3" width="800"/>
|
|
23
29
|
|
|
24
|
-
|
|
25
|
-
- **Simple Task Management** - Define tasks in plain text, AI generates detailed subtasks
|
|
26
|
-
- **Multiple AI Models** - Claude Code Sonnet and Gemini 3 Flash configured and ready to use
|
|
27
|
-
- **Discrete .gitignore** - AI configs hidden with generic comments
|
|
28
|
-
- **Zero Configuration** - Ready to use immediately
|
|
29
|
-
- **RBIN Task Flow** - AI-powered task management with simple text interface
|
|
30
|
+
</div>
|
|
30
31
|
|
|
31
|
-
|
|
32
|
+
---
|
|
32
33
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
34
|
+
<a id="português"></a>
|
|
35
|
+
# 🇧🇷 Português
|
|
36
|
+
|
|
37
|
+
## O Que É Este Projeto?
|
|
38
|
+
|
|
39
|
+
RBIN Task Flow é um sistema de gerenciamento de tarefas alimentado por IA que configura automaticamente Claude Code, Gemini e Cursor IDE em qualquer projeto. Você define tarefas em texto simples e a IA gera subtarefas detalhadas e acionáveis automaticamente.
|
|
40
|
+
|
|
41
|
+
**Principais benefícios:**
|
|
42
|
+
- ✅ Instalação global NPM - instale uma vez, use em qualquer projeto
|
|
43
|
+
- ✅ Zero configuração - pronto para usar imediatamente
|
|
44
|
+
- ✅ Gerenciamento simples - escreva tarefas em texto, a IA faz o resto
|
|
45
|
+
- ✅ Múltiplos modelos de IA - Claude, Gemini e Cursor configurados
|
|
46
|
+
|
|
47
|
+
## Instalação
|
|
48
|
+
|
|
49
|
+
### Início Rápido (NPM Global)
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# 1. Instalar globalmente via npm (apenas uma vez)
|
|
53
|
+
npm install -g rbin-task-flow
|
|
54
|
+
|
|
55
|
+
# 2. Ir para qualquer projeto e inicializar
|
|
56
|
+
cd /caminho/para/seu/projeto
|
|
57
|
+
rbin-task-flow init
|
|
58
|
+
|
|
59
|
+
# 3. Usar comandos da IA
|
|
60
|
+
# Edite .task-flow/tasks.input.txt e use:
|
|
61
|
+
# - task-flow: sync
|
|
62
|
+
# - task-flow: run next X
|
|
63
|
+
# - task-flow: run task X
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**Pronto!** RBIN Task Flow agora está disponível globalmente no seu sistema.
|
|
67
|
+
|
|
68
|
+
## Comandos
|
|
69
|
+
|
|
70
|
+
### Comandos CLI
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
rbin-task-flow init # Inicializa no projeto atual
|
|
74
|
+
rbin-task-flow update # Atualiza configurações
|
|
75
|
+
rbin-task-flow version-check # Verifica atualizações de modelos
|
|
76
|
+
rbin-task-flow info # Mostra informações
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### Comandos da IA - Por Que Usar?
|
|
80
|
+
|
|
81
|
+
Após inicializar, use estes comandos na IA (Cursor/Claude/Gemini) para gerenciar tarefas automaticamente:
|
|
82
|
+
|
|
83
|
+
| Comando | Por Que Usar | Feature Principal |
|
|
84
|
+
|---------|--------------|-------------------|
|
|
85
|
+
| `task-flow: sync` | **Sincroniza** tarefas do arquivo texto com o sistema | Mantém tudo sincronizado automaticamente - adiciona novas, remove deletadas, preserva seu progresso |
|
|
86
|
+
| `task-flow: think` | **Descobre** tarefas que você esqueceu | Analisa código e sugere tarefas que faltam (testes, refatoração, documentação) |
|
|
87
|
+
| `task-flow: run next X` | **Automatiza** o trabalho nas próximas subtarefas | A IA trabalha nas próximas X subtarefas sequencialmente, você só acompanha |
|
|
88
|
+
| `task-flow: run task X` | **Completa** uma tarefa inteira de uma vez | Executa todas as subtarefas de uma tarefa específica (permite trabalho paralelo) |
|
|
89
|
+
| `task-flow: status` | **Visualiza** o progresso rapidamente | Vê resumo com tasks completas, em andamento e quantas subtarefas faltam |
|
|
90
|
+
| `task-flow: review` | **Garante** qualidade do trabalho | Verifica se tarefas marcadas como "done" estão realmente concluídas |
|
|
91
|
+
| `task-flow: refactor` | **Melhora** código sem quebrar | Refatora código do commit atual removendo comentários e melhorando qualidade |
|
|
92
|
+
|
|
93
|
+
**Fluxo típico:**
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
# 1. Instalar e inicializar
|
|
97
|
+
npm install -g rbin-task-flow
|
|
98
|
+
cd meu-projeto && rbin-task-flow init
|
|
99
|
+
|
|
100
|
+
# 2. Editar tarefas em texto simples
|
|
101
|
+
# Edite .task-flow/tasks.input.txt:
|
|
102
|
+
# - Criar sistema de autenticação
|
|
103
|
+
# - Adicionar testes
|
|
104
|
+
|
|
105
|
+
# 3. Usar comandos da IA:
|
|
106
|
+
# "task-flow: sync" → Gera subtarefas detalhadas automaticamente
|
|
107
|
+
# "task-flow: run next 3" → IA trabalha nas próximas 3 subtarefas
|
|
108
|
+
# "task-flow: status" → Vê progresso visual
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Visão Geral
|
|
112
|
+
|
|
113
|
+
Repositório centralizado de configurações e regras de desenvolvimento que podem ser instaladas instantaneamente em qualquer projeto. Fornece configuração completa para Claude Code, Gemini, Cursor IDE e RBIN Task Flow - um sistema simples de gerenciamento de tarefas alimentado por IA.
|
|
114
|
+
|
|
115
|
+
### Principais Recursos
|
|
116
|
+
|
|
117
|
+
- **Instalação Global NPM** - Instale uma vez, use em qualquer lugar com `npm install -g rbin-task-flow`
|
|
118
|
+
- **Gerenciamento Simples de Tarefas** - Defina tarefas em texto simples, a IA gera subtarefas detalhadas
|
|
119
|
+
- **Múltiplos Modelos de IA** - Claude Code Sonnet e Gemini 3 Flash configurados e prontos para uso
|
|
120
|
+
- **.gitignore Discreto** - Configurações de IA ocultas com comentários genéricos
|
|
121
|
+
- **Zero Configuração** - Pronto para usar imediatamente
|
|
122
|
+
- **RBIN Task Flow** - Gerenciamento de tarefas alimentado por IA com interface de texto simples
|
|
123
|
+
|
|
124
|
+
## Requisitos do Sistema
|
|
125
|
+
|
|
126
|
+
- **Sistema Operacional:** macOS, Linux ou Windows (WSL)
|
|
127
|
+
- **Ferramentas:** Git, Bash, Node.js
|
|
128
|
+
- **Necessário:** Claude Code CLI, acesso à API Gemini ou Cursor IDE (com assinatura Pro)
|
|
129
|
+
|
|
130
|
+
### Alternativa: Instalação Legacy (Sem NPM)
|
|
131
|
+
|
|
132
|
+
Se você preferir o método antigo sem npm:
|
|
133
|
+
|
|
134
|
+
```bash
|
|
135
|
+
# 1. Clonar este repositório
|
|
136
|
+
git clone https://github.com/rbinoliveira/rbin-task-flow.git ~/.rbin-task-flow
|
|
137
|
+
|
|
138
|
+
# 2. Instalar no seu projeto
|
|
139
|
+
~/.rbin-task-flow/install.sh
|
|
140
|
+
# Digite o caminho do projeto quando solicitado
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
### O Que É Instalado
|
|
144
|
+
|
|
145
|
+
O script cria e configura:
|
|
146
|
+
|
|
147
|
+
```
|
|
148
|
+
seu-projeto/
|
|
149
|
+
├── .cursor/
|
|
150
|
+
│ ├── rules/ # Todas as regras de desenvolvimento
|
|
151
|
+
│ │ ├── cursor_rules.mdc
|
|
152
|
+
│ │ ├── self_improve.mdc
|
|
153
|
+
│ │ ├── code_comments.mdc
|
|
154
|
+
│ │ ├── commit_practices.mdc
|
|
155
|
+
│ │ ├── git_control.mdc
|
|
156
|
+
│ │ └── task_execution.mdc
|
|
157
|
+
│ └── settings.json # Configurações do modelo Cursor
|
|
158
|
+
│
|
|
159
|
+
├── .claude/
|
|
160
|
+
│ └── settings.json # Configurações do Claude Code
|
|
161
|
+
│
|
|
162
|
+
├── .gemini/
|
|
163
|
+
│ └── settings.json # Configurações do Gemini
|
|
164
|
+
│
|
|
165
|
+
├── .task-flow/ # RBIN Task Flow
|
|
166
|
+
│ ├── tasks.input.txt # Definições de tarefas em texto simples (edite isso!)
|
|
167
|
+
│ ├── tasks.status.md # ⚠️ Status das tarefas (atualizado automaticamente, NÃO EDITE)
|
|
168
|
+
│ └── .internal/ # ⚠️ Arquivos internos do sistema (ignore - gerados automaticamente)
|
|
169
|
+
│ ├── tasks.json # Definições de tarefas (auto)
|
|
170
|
+
│ └── status.json # Rastreamento de status das tarefas (auto)
|
|
171
|
+
│
|
|
172
|
+
└── .gitignore # Atualizado com entradas discretas
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
## Configuração
|
|
176
|
+
|
|
177
|
+
Nenhuma configuração adicional necessária! Apenas certifique-se de ter:
|
|
178
|
+
- Claude Code CLI instalado, OU
|
|
179
|
+
- Acesso à API Gemini configurado, OU
|
|
180
|
+
- Cursor IDE com assinatura Pro ativa
|
|
181
|
+
|
|
182
|
+
**Você está pronto!**
|
|
183
|
+
|
|
184
|
+
### Integração com Cursor
|
|
185
|
+
|
|
186
|
+
O Cursor vem pré-configurado com:
|
|
187
|
+
- Claude Sonnet 4.5 Pro como modelo padrão
|
|
188
|
+
- Configurações personalizadas
|
|
189
|
+
- Integração com RBIN Task Flow
|
|
190
|
+
- Melhores práticas de desenvolvimento
|
|
191
|
+
|
|
192
|
+
Todas as regras são automaticamente ativas no Cursor. O IDE irá:
|
|
193
|
+
- Seguir padrões de codificação de `.cursor/rules/`
|
|
194
|
+
- Integrar com fluxos de trabalho do RBIN Task Flow
|
|
195
|
+
- Seguir práticas de commit e git
|
|
196
|
+
|
|
197
|
+
### Integração com Claude Code
|
|
198
|
+
|
|
199
|
+
O Claude Code vem pré-configurado com:
|
|
200
|
+
- Configurações personalizadas
|
|
201
|
+
- Integração com RBIN Task Flow
|
|
202
|
+
- Melhores práticas de desenvolvimento
|
|
203
|
+
|
|
204
|
+
### Integração com Gemini
|
|
205
|
+
|
|
206
|
+
O Gemini vem pré-configurado com:
|
|
207
|
+
- Configurações personalizadas
|
|
208
|
+
- Integração com RBIN Task Flow
|
|
209
|
+
- Melhores práticas de desenvolvimento
|
|
210
|
+
|
|
211
|
+
## O Que Está Configurado
|
|
212
|
+
|
|
213
|
+
### Regras de Desenvolvimento
|
|
214
|
+
|
|
215
|
+
Regras incluídas para:
|
|
216
|
+
- Formatação de regras do Cursor
|
|
217
|
+
- Processos de auto-melhoria
|
|
218
|
+
- Padrões de comentários de código
|
|
219
|
+
- Práticas de commit
|
|
220
|
+
- Controle de comandos git
|
|
221
|
+
- Gerenciamento de execução de tarefas
|
|
222
|
+
|
|
223
|
+
### RBIN Task Flow
|
|
224
|
+
|
|
225
|
+
Gerenciamento de tarefas simples e poderoso:
|
|
226
|
+
- **Entrada de Texto Simples**: Escreva tarefas em `.task-flow/tasks.input.txt` usando formato simples
|
|
227
|
+
- **Geração Alimentada por IA**: Transforma tarefas simples em subtarefas detalhadas e acionáveis
|
|
228
|
+
- **Instruções Inteligentes**: Cada subtarefa inclui contexto, objetivos, etapas de implementação e validação
|
|
229
|
+
- **Rastreamento Simples**: Gerenciamento de status baseado em JSON com comandos CLI fáceis
|
|
230
|
+
- **Monitoramento de Progresso**: Feedback visual claro sobre a conclusão das tarefas
|
|
231
|
+
|
|
232
|
+
## .gitignore Discreto
|
|
233
|
+
|
|
234
|
+
O instalador adiciona estas entradas ao `.gitignore`:
|
|
235
|
+
|
|
236
|
+
```gitignore
|
|
237
|
+
.claude/
|
|
238
|
+
.gemini/
|
|
239
|
+
.cursor/
|
|
240
|
+
.task-flow/
|
|
241
|
+
CLAUDE.md
|
|
242
|
+
GEMINI.md
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
**Por que discreto?**
|
|
246
|
+
- Sem comentários explicando o que são
|
|
247
|
+
- Sem menção a "IA", "Claude" ou "Anthropic"
|
|
248
|
+
- Tudo relacionado ao RBIN Task Flow permanece local
|
|
249
|
+
- Histórico git limpo sem arquivos de ferramentas de IA
|
|
250
|
+
|
|
251
|
+
## Atualizando Projetos
|
|
252
|
+
|
|
253
|
+
Para atualizar configurações em um projeto existente:
|
|
254
|
+
|
|
255
|
+
```bash
|
|
256
|
+
# Usando NPM (recomendado)
|
|
257
|
+
cd /caminho/para/seu/projeto
|
|
258
|
+
rbin-task-flow update
|
|
259
|
+
|
|
260
|
+
# Ou usando método legacy
|
|
261
|
+
~/.rbin-task-flow/install.sh
|
|
262
|
+
# Digite o caminho do projeto
|
|
263
|
+
```
|
|
264
|
+
|
|
265
|
+
O instalador irá:
|
|
266
|
+
- ✅ Copiar novas regras (sempre sobrescreve)
|
|
267
|
+
- ✅ **Sobrescrever arquivos de configuração** (settings.json) com as versões mais recentes
|
|
268
|
+
- ✅ Atualizar .gitignore se necessário
|
|
269
|
+
- ✅ Atualizar scripts do Task Flow (sempre sobrescreve)
|
|
270
|
+
- ✅ **Preservar seus dados**: `.internal/tasks.json` e `.internal/status.json` **NÃO são sobrescritos** (suas tarefas permanecem seguras)
|
|
271
|
+
|
|
272
|
+
**Nota**: O instalador adiciona automaticamente `.task-flow/` ao `.gitignore`, mantendo seu progresso de tarefas privado e fora do controle de versão.
|
|
273
|
+
|
|
274
|
+
## Estrutura do Projeto
|
|
275
|
+
|
|
276
|
+
Este repositório contém:
|
|
277
|
+
|
|
278
|
+
```
|
|
279
|
+
rbin-task-flow/
|
|
280
|
+
├── .cursor/
|
|
281
|
+
│ ├── settings.json # Configurações do modelo Cursor
|
|
282
|
+
│ └── rules/ # Todas as regras de desenvolvimento
|
|
283
|
+
│
|
|
284
|
+
├── .claude/
|
|
285
|
+
│ └── settings.json # Configurações do Claude Code
|
|
286
|
+
│
|
|
287
|
+
├── .gemini/
|
|
288
|
+
│ └── settings.json # Configurações do Gemini
|
|
289
|
+
│
|
|
290
|
+
├── .task-flow/
|
|
291
|
+
│ ├── README.md # Referência rápida de comandos
|
|
292
|
+
│ ├── tasks.input.txt # Template de definições de tarefas
|
|
293
|
+
│ ├── tasks.status.md # ⚠️ Template de status de tarefas (NÃO EDITE manualmente)
|
|
294
|
+
│ └── .internal/ # ⚠️ Arquivos internos do sistema (ignore - gerados automaticamente)
|
|
295
|
+
│ ├── tasks.json # Definições de tarefas (auto)
|
|
296
|
+
│ └── status.json # Rastreamento de status de tarefas (auto)
|
|
297
|
+
│
|
|
298
|
+
├── .gitignore # Template gitignore
|
|
299
|
+
├── .model-versions.json # Referência de versão do modelo (atualize quando novos modelos forem lançados)
|
|
300
|
+
├── CLAUDE.md # Instruções principais do Claude
|
|
301
|
+
├── GEMINI.md # Instruções principais do Gemini
|
|
302
|
+
├── install.sh # Script de instalação
|
|
303
|
+
└── README.md # Este arquivo
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
## Notas Importantes
|
|
307
|
+
|
|
308
|
+
- ⚠️ Este é um **repositório template** - não use RBIN Task Flow aqui
|
|
309
|
+
- ✅ Use RBIN Task Flow em **projetos que recebem** as configurações via instalação
|
|
310
|
+
- 🔄 O instalador **sempre sobrescreve** configurações existentes
|
|
311
|
+
- 🤫 As entradas do .gitignore são **discretas** (sem menções a IA)
|
|
312
|
+
- 🎯 Funciona com **Claude Code CLI**, **API Gemini** ou **Cursor Pro**
|
|
313
|
+
- 📦 O diretório Task Flow (`.task-flow/`) é **automaticamente gitignored**
|
|
314
|
+
- 📝 Defina tarefas em `.task-flow/tasks.input.txt` usando formato simples: `- Descrição da tarefa`
|
|
315
|
+
- 🚀 **Instalação Global NPM**: `npm install -g rbin-task-flow`, depois use `rbin-task-flow init` em qualquer projeto
|
|
316
|
+
- 🔒 **Chaves de API podem ser necessárias** - depende do seu provedor de IA (Claude Code, API Gemini ou Cursor Pro)
|
|
317
|
+
- 🔔 **Verificação de versão do modelo** - Use `rbin-task-flow version-check` para verificar versões mais recentes dos modelos (verificação rápida e local)
|
|
318
|
+
|
|
319
|
+
## Atualizando Versões dos Modelos
|
|
320
|
+
|
|
321
|
+
Quando novas versões de modelos forem lançadas, atualize `.model-versions.json` neste repositório:
|
|
322
|
+
|
|
323
|
+
```json
|
|
324
|
+
{
|
|
325
|
+
"claude": {
|
|
326
|
+
"current": "claude-sonnet-4-5-20250929",
|
|
327
|
+
"latest": "NOVA_VERSÃO_AQUI",
|
|
328
|
+
"checkUrl": "https://docs.anthropic.com/claude/docs/models-overview"
|
|
329
|
+
},
|
|
330
|
+
"cursor": {
|
|
331
|
+
"current": "claude-sonnet-4-5-20250929",
|
|
332
|
+
"latest": "NOVA_VERSÃO_AQUI",
|
|
333
|
+
"checkUrl": "https://docs.cursor.com/models"
|
|
334
|
+
},
|
|
335
|
+
"gemini": {
|
|
336
|
+
"current": "gemini-3-flash",
|
|
337
|
+
"latest": "NOVA_VERSÃO_AQUI",
|
|
338
|
+
"checkUrl": "https://ai.google.dev/models/gemini"
|
|
339
|
+
}
|
|
340
|
+
}
|
|
341
|
+
```
|
|
342
|
+
|
|
343
|
+
O instalador verificará automaticamente versões mais recentes dos modelos e **perguntará individualmente** se você deseja atualizar cada um (Claude, Cursor, Gemini). Esta verificação é **rápida e local** - sem chamadas de API, sem solicitações de rede, apenas uma simples comparação de strings.
|
|
344
|
+
|
|
345
|
+
**Atualizações Interativas:** Quando uma versão mais recente estiver disponível, o instalador irá:
|
|
346
|
+
- Mostrar versões atuais e mais recentes
|
|
347
|
+
- Perguntar: "Atualizar [Modelo] para a versão mais recente? [y/N]"
|
|
348
|
+
- Atualizar apenas se você confirmar com `y`
|
|
349
|
+
- Pular se você pressionar Enter ou digitar `n`
|
|
350
|
+
|
|
351
|
+
**Importante:** As atualizações de versão do modelo funcionam de forma diferente:
|
|
352
|
+
|
|
353
|
+
- **Ao instalar em um projeto de destino** (passando um caminho):
|
|
354
|
+
- O instalador **copia/substitui** arquivos do template do repositório para o projeto de destino
|
|
355
|
+
- **SEM prompts de atualização de modelo** - apenas copia o que está no template
|
|
356
|
+
- O projeto de destino recebe as versões atuais do template
|
|
357
|
+
|
|
358
|
+
- **Ao executar o instalador no próprio repositório** (rbin-task-flow):
|
|
359
|
+
- Se novas versões de modelos forem detectadas, você pode escolher atualizá-las
|
|
360
|
+
- As atualizações são aplicadas **apenas aos arquivos do template do repositório**
|
|
361
|
+
- Após atualizar o template, execute o instalador nos projetos para aplicar as novas versões
|
|
362
|
+
|
|
363
|
+
**Fluxo de Trabalho:**
|
|
364
|
+
1. Execute o instalador em um projeto → copia arquivos do template atual para o projeto (sem prompts de atualização)
|
|
365
|
+
2. Para atualizar o template do repositório → execute o instalador no próprio repositório, escolha atualizar
|
|
366
|
+
3. Execute o instalador novamente nos projetos → copia arquivos do template atualizados para os projetos
|
|
367
|
+
|
|
368
|
+
Você tem controle total - as atualizações de modelo acontecem apenas no template do repositório, não nos projetos de destino.
|
|
369
|
+
|
|
370
|
+
## Contribuindo
|
|
371
|
+
|
|
372
|
+
Contribuições são bem-vindas! Para adicionar novas regras ou melhorar templates:
|
|
373
|
+
|
|
374
|
+
1. Faça um fork deste repositório
|
|
375
|
+
2. Crie um branch de feature
|
|
376
|
+
3. Adicione suas regras/templates seguindo os formatos existentes
|
|
377
|
+
4. Teste em um projeto real
|
|
378
|
+
5. Envie um Pull Request
|
|
379
|
+
|
|
380
|
+
## Licença
|
|
381
|
+
|
|
382
|
+
Licença MIT - Veja o arquivo LICENSE para detalhes
|
|
383
|
+
|
|
384
|
+
## Suporte
|
|
385
|
+
|
|
386
|
+
Para problemas ou perguntas:
|
|
387
|
+
- Abra uma issue no GitHub
|
|
388
|
+
- Verifique issues existentes para soluções
|
|
389
|
+
- Consulte CHANGELOG.md para atualizações recentes
|
|
390
|
+
|
|
391
|
+
---
|
|
392
|
+
|
|
393
|
+
<a id="english"></a>
|
|
394
|
+
# 🇬🇧 English
|
|
395
|
+
|
|
396
|
+
## What Is This Project?
|
|
397
|
+
|
|
398
|
+
RBIN Task Flow is an AI-powered task management system that automatically configures Claude Code, Gemini, and Cursor IDE in any project. You define tasks in plain text and the AI automatically generates detailed, actionable subtasks.
|
|
399
|
+
|
|
400
|
+
**Key benefits:**
|
|
401
|
+
- ✅ Global NPM installation - install once, use in any project
|
|
402
|
+
- ✅ Zero configuration - ready to use immediately
|
|
403
|
+
- ✅ Simple management - write tasks in text, AI does the rest
|
|
404
|
+
- ✅ Multiple AI models - Claude, Gemini, and Cursor configured
|
|
36
405
|
|
|
37
406
|
## Installation
|
|
38
407
|
|
|
@@ -55,13 +424,75 @@ rbin-task-flow init
|
|
|
55
424
|
|
|
56
425
|
**That's it!** RBIN Task Flow is now available globally on your system.
|
|
57
426
|
|
|
427
|
+
## Commands
|
|
428
|
+
|
|
429
|
+
### CLI Commands
|
|
430
|
+
|
|
431
|
+
```bash
|
|
432
|
+
rbin-task-flow init # Initialize in current project
|
|
433
|
+
rbin-task-flow update # Update configurations
|
|
434
|
+
rbin-task-flow version-check # Check for model updates
|
|
435
|
+
rbin-task-flow info # Show information
|
|
436
|
+
```
|
|
437
|
+
|
|
438
|
+
### AI Commands - Why Use Them?
|
|
439
|
+
|
|
440
|
+
After initializing, use these commands in your AI (Cursor/Claude/Gemini) to automatically manage tasks:
|
|
441
|
+
|
|
442
|
+
| Command | Why Use It | Key Feature |
|
|
443
|
+
|---------|------------|-------------|
|
|
444
|
+
| `task-flow: sync` | **Sync** tasks from text file with system | Keeps everything synchronized automatically - adds new, removes deleted, preserves your progress |
|
|
445
|
+
| `task-flow: think` | **Discover** tasks you forgot | Analyzes code and suggests missing tasks (tests, refactoring, documentation) |
|
|
446
|
+
| `task-flow: run next X` | **Automate** work on next subtasks | AI works on next X subtasks sequentially, you just follow along |
|
|
447
|
+
| `task-flow: run task X` | **Complete** an entire task at once | Executes all subtasks of a specific task (allows parallel work) |
|
|
448
|
+
| `task-flow: status` | **Visualize** progress quickly | See summary with completed tasks, in progress, and remaining subtasks |
|
|
449
|
+
| `task-flow: review` | **Ensure** work quality | Verifies that tasks marked as "done" are actually completed |
|
|
450
|
+
| `task-flow: refactor` | **Improve** code without breaking | Refactors code from current commit removing comments and improving quality |
|
|
451
|
+
|
|
452
|
+
**Typical workflow:**
|
|
453
|
+
|
|
454
|
+
```bash
|
|
455
|
+
# 1. Install and initialize
|
|
456
|
+
npm install -g rbin-task-flow
|
|
457
|
+
cd my-project && rbin-task-flow init
|
|
458
|
+
|
|
459
|
+
# 2. Edit tasks in plain text
|
|
460
|
+
# Edit .task-flow/tasks.input.txt:
|
|
461
|
+
# - Create authentication system
|
|
462
|
+
# - Add tests
|
|
463
|
+
|
|
464
|
+
# 3. Use AI commands:
|
|
465
|
+
# "task-flow: sync" → Automatically generates detailed subtasks
|
|
466
|
+
# "task-flow: run next 3" → AI works on next 3 subtasks
|
|
467
|
+
# "task-flow: status" → View visual progress
|
|
468
|
+
```
|
|
469
|
+
|
|
470
|
+
## Overview
|
|
471
|
+
|
|
472
|
+
A centralized repository of development configurations and rules that can be instantly installed in any project. Provides complete setup for Claude Code, Gemini, Cursor IDE, and RBIN Task Flow - a simple AI-powered task management system.
|
|
473
|
+
|
|
474
|
+
### Key Features
|
|
475
|
+
|
|
476
|
+
- **NPM Global Installation** - Install once, use everywhere with `npm install -g rbin-task-flow`
|
|
477
|
+
- **Simple Task Management** - Define tasks in plain text, AI generates detailed subtasks
|
|
478
|
+
- **Multiple AI Models** - Claude Code Sonnet and Gemini 3 Flash configured and ready to use
|
|
479
|
+
- **Discrete .gitignore** - AI configs hidden with generic comments
|
|
480
|
+
- **Zero Configuration** - Ready to use immediately
|
|
481
|
+
- **RBIN Task Flow** - AI-powered task management with simple text interface
|
|
482
|
+
|
|
483
|
+
## System Requirements
|
|
484
|
+
|
|
485
|
+
- **Operating System:** macOS, Linux, or Windows (WSL)
|
|
486
|
+
- **Tools:** Git, Bash, Node.js
|
|
487
|
+
- **Required:** Claude Code CLI, Gemini API access, or Cursor IDE (with Pro subscription)
|
|
488
|
+
|
|
58
489
|
### Alternative: Legacy Installation (Without NPM)
|
|
59
490
|
|
|
60
491
|
If you prefer the old method without npm:
|
|
61
492
|
|
|
62
493
|
```bash
|
|
63
494
|
# 1. Clone this repository
|
|
64
|
-
git clone https://github.com/
|
|
495
|
+
git clone https://github.com/rbinoliveira/rbin-task-flow.git ~/.rbin-task-flow
|
|
65
496
|
|
|
66
497
|
# 2. Install in your project
|
|
67
498
|
~/.rbin-task-flow/install.sh
|
|
@@ -109,60 +540,6 @@ No additional configuration required! Just make sure you have:
|
|
|
109
540
|
|
|
110
541
|
**You're ready!**
|
|
111
542
|
|
|
112
|
-
## Usage
|
|
113
|
-
|
|
114
|
-
### RBIN Task Flow Commands
|
|
115
|
-
|
|
116
|
-
After installing globally, you can use these commands:
|
|
117
|
-
|
|
118
|
-
```bash
|
|
119
|
-
# Initialize in current directory
|
|
120
|
-
rbin-task-flow init
|
|
121
|
-
|
|
122
|
-
# Update configurations
|
|
123
|
-
rbin-task-flow update
|
|
124
|
-
|
|
125
|
-
# Check for model version updates
|
|
126
|
-
rbin-task-flow version-check
|
|
127
|
-
|
|
128
|
-
# Show help information
|
|
129
|
-
rbin-task-flow info
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
### AI Commands
|
|
133
|
-
|
|
134
|
-
Once initialized in a project, use these AI commands:
|
|
135
|
-
- `task-flow: sync` - Sincronização completa: adiciona novas, remove removidas, atualiza modificadas, preserva status
|
|
136
|
-
- `task-flow: think` - Analisa código e sugere novas tasks
|
|
137
|
-
- `task-flow: run next X` - Trabalha nas próximas X subtasks sequenciais
|
|
138
|
-
- `task-flow: run task X` - Executa todas as subtasks pendentes da task X (só executa se tasks anteriores estiverem completas - permite trabalho paralelo)
|
|
139
|
-
- `task-flow: status` - Mostra status atual das tasks
|
|
140
|
-
- `task-flow: review` - Revisa tasks concluídas
|
|
141
|
-
- `task-flow: refactor` - Refatora código do commit atual
|
|
142
|
-
|
|
143
|
-
**Complete workflow:**
|
|
144
|
-
|
|
145
|
-
```bash
|
|
146
|
-
# 1. Install globally (one time)
|
|
147
|
-
npm install -g rbin-task-flow
|
|
148
|
-
|
|
149
|
-
# 2. Initialize in your project
|
|
150
|
-
cd /path/to/my-project
|
|
151
|
-
rbin-task-flow init
|
|
152
|
-
|
|
153
|
-
# 3. Use AI commands:
|
|
154
|
-
# - Edit .task-flow/tasks.input.txt and use 'task-flow: sync' to generate
|
|
155
|
-
# - Use 'task-flow: run next X' to work on next X subtasks
|
|
156
|
-
# - Use 'task-flow: run task X' to work on all subtasks of task X
|
|
157
|
-
# - Use 'task-flow: status' to view progress
|
|
158
|
-
```
|
|
159
|
-
|
|
160
|
-
**Key features:**
|
|
161
|
-
- ✅ **.task-flow/** directory is automatically **gitignored**
|
|
162
|
-
- ✅ Your task progress stays **local and private**
|
|
163
|
-
- ✅ Team members can use their own tasks without conflicts
|
|
164
|
-
- ✅ AI generates detailed, actionable subtasks from simple descriptions
|
|
165
|
-
|
|
166
543
|
### Cursor Integration
|
|
167
544
|
|
|
168
545
|
Cursor is pre-configured with:
|
|
@@ -376,6 +753,6 @@ For issues or questions:
|
|
|
376
753
|
|
|
377
754
|
**Made with ❤️ for developers who love simple, AI-powered workflows**
|
|
378
755
|
|
|
379
|
-
|
|
756
|
+
<a href="#português">🇧🇷 Português</a> | <a href="#english">🇬🇧 English</a> | <a href="#rbin-task-flow">⬆ Back to top</a>
|
|
380
757
|
|
|
381
758
|
</div>
|
package/bin/cli.js
CHANGED
|
@@ -45,7 +45,7 @@ program
|
|
|
45
45
|
console.log(chalk.cyan('╚════════════════════════════════════════════════════════════════╝') + '\n');
|
|
46
46
|
console.log(chalk.blue('AI-powered task management for Claude, Cursor, and Gemini'));
|
|
47
47
|
console.log(chalk.yellow('\nVersion:'), require('../package.json').version);
|
|
48
|
-
console.log(chalk.yellow('Repository:'), 'https://github.com/
|
|
48
|
+
console.log(chalk.yellow('Repository:'), 'https://github.com/rbinoliveira/rbin-task-flow');
|
|
49
49
|
console.log(chalk.yellow('\nCommands:'));
|
|
50
50
|
console.log(chalk.cyan(' rbin-task-flow init') + ' - Initialize in current directory');
|
|
51
51
|
console.log(chalk.cyan(' rbin-task-flow update') + ' - Update configurations');
|
package/lib/install.js
CHANGED
|
@@ -236,6 +236,9 @@ async function showModelVersions(targetPath) {
|
|
|
236
236
|
if (settings.model) {
|
|
237
237
|
console.log(chalk.blue('Claude:'), chalk.yellow(settings.model));
|
|
238
238
|
hasModels = true;
|
|
239
|
+
} else {
|
|
240
|
+
console.log(chalk.blue('Claude:'), chalk.yellow('Default (recommended)'));
|
|
241
|
+
hasModels = true;
|
|
239
242
|
}
|
|
240
243
|
} catch (error) {
|
|
241
244
|
// Ignorar erros de parsing
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "rbin-task-flow",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "AI-powered task management for Claude, Cursor, and Gemini",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"bin": {
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
"license": "MIT",
|
|
26
26
|
"repository": {
|
|
27
27
|
"type": "git",
|
|
28
|
-
"url": "https://github.com/
|
|
28
|
+
"url": "https://github.com/rbinoliveira/rbin-task-flow.git"
|
|
29
29
|
},
|
|
30
30
|
"files": [
|
|
31
31
|
"bin/",
|