rbin-task-flow 1.1.2 → 1.2.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.
@@ -1,24 +1,24 @@
1
1
  ---
2
- description: Regras sobre comentários em código - proibição de comentários explicativos, uso de dev-logs para documentação, e padrão para comentários de separação
2
+ description: Rules about code comments - prohibition of explanatory comments, use of dev-logs for documentation, and pattern for separation comments
3
3
  globs: **/*
4
4
  alwaysApply: true
5
5
  ---
6
6
 
7
- - **Proibição de Comentários Explicativos:**
8
- - **❌ NUNCA adicionar** comentários que explicam o que o código faz
9
- - **❌ NUNCA adicionar** comentários como "// This function does X" ou "// Check if user exists"
10
- - **❌ NUNCA adicionar** comentários inline explicando lógica de negócio
11
- - **✅ O código deve ser auto-explicativo** através de nomes claros de variáveis, funções e classes
7
+ - **Prohibition of Explanatory Comments:**
8
+ - **❌ NEVER add** comments that explain what the code does
9
+ - **❌ NEVER add** comments like "// This function does X" or "// Check if user exists"
10
+ - **❌ NEVER add** inline comments explaining business logic
11
+ - **✅ Code must be self-explanatory** through clear variable, function, and class names
12
12
 
13
- - **Documentação em dev-logs:**
14
- - **✅ Quando precisar explicar algo complexo**, criar um arquivo em `dev-logs/` na raiz do projeto
15
- - **✅ Criar a pasta `dev-logs/`** se ela não existir
16
- - **✅ Usar arquivos markdown** (`.md`) para documentação técnica
17
- - **✅ Incluir contexto**, decisões de design, e explicações detalhadas nos arquivos de dev-logs
13
+ - **Documentation in dev-logs:**
14
+ - **✅ When you need to explain something complex**, create a file in `dev-logs/` at the project root
15
+ - **✅ Create the `dev-logs/` folder** if it doesn't exist
16
+ - **✅ Use markdown files** (`.md`) for technical documentation
17
+ - **✅ Include context**, design decisions, and detailed explanations in dev-logs files
18
18
 
19
- - **Estrutura de dev-logs:**
19
+ - **dev-logs Structure:**
20
20
  ```
21
- projeto/
21
+ project/
22
22
  └── dev-logs/
23
23
  ├── architecture-decisions.md
24
24
  ├── complex-algorithms.md
@@ -26,56 +26,56 @@ alwaysApply: true
26
26
  └── ...
27
27
  ```
28
28
 
29
- - **Quando Criar dev-logs:**
30
- - Algoritmos complexos que precisam de explicação detalhada
31
- - Decisões de arquitetura importantes
32
- - Integrações com APIs externas complexas
33
- - Workarounds ou hacks necessários
34
- - Contexto histórico importante
35
- - Padrões não óbvios do projeto
29
+ - **When to Create dev-logs:**
30
+ - Complex algorithms that need detailed explanation
31
+ - Important architecture decisions
32
+ - Complex external API integrations
33
+ - Necessary workarounds or hacks
34
+ - Important historical context
35
+ - Non-obvious project patterns
36
36
 
37
- - **Formato dos Arquivos dev-logs:**
37
+ - **dev-logs File Format:**
38
38
  ```markdown
39
- # Título do Tópico
39
+ # Topic Title
40
40
 
41
- ## Contexto
42
- Explicação do contexto e por que isso é necessário...
41
+ ## Context
42
+ Explanation of context and why this is necessary...
43
43
 
44
- ## Implementação
45
- Detalhes da implementação...
44
+ ## Implementation
45
+ Implementation details...
46
46
 
47
- ## Referências
48
- - Link para documentação
49
- - Issue relacionada
47
+ ## References
48
+ - Link to documentation
49
+ - Related issue
50
50
  ```
51
51
 
52
- - **Comentários de Separação Permitidos:**
53
- - **✅ PERMITIDO**: Comentários que organizam e separam blocos de código
54
- - **✅ SEMPRE usar** o padrão exato de separação:
52
+ - **Separation Comments Allowed:**
53
+ - **✅ ALLOWED**: Comments that organize and separate code blocks
54
+ - **✅ ALWAYS use** the exact separation pattern:
55
55
  ```typescript
56
56
  // ────────────────────────────────
57
57
  // Prisma Types
58
58
  // ────────────────────────────────
59
59
  ```
60
- - **✅ Usar** para separar seções lógicas do código
61
- - **✅ Usar** para organizar imports, tipos, constantes, etc.
60
+ - **✅ Use** to separate logical sections of code
61
+ - **✅ Use** to organize imports, types, constants, etc.
62
62
 
63
- - **Padrão de Comentário de Separação:**
63
+ - **Separation Comment Pattern:**
64
64
  ```typescript
65
65
  // ────────────────────────────────
66
- // Seção ou Título
66
+ // Section or Title
67
67
  // ────────────────────────────────
68
68
  ```
69
69
 
70
- **Características:**
71
- - Linha de traços (`─`) com exatamente 31 caracteres
72
- - Título centralizado entre as linhas de separação
73
- - Sempre usar `//` para comentários de linha
74
- - **Sem linhas em branco** entre as linhas de separação e o título
70
+ **Characteristics:**
71
+ - Dash line (`─`) with exactly 31 characters
72
+ - Title centered between separation lines
73
+ - Always use `//` for line comments
74
+ - **No blank lines** between separation lines and title
75
75
 
76
- - **Exemplos de Uso Correto:**
76
+ - **Correct Usage Examples:**
77
77
 
78
- **✅ DO: Comentário de separação**
78
+ **✅ DO: Separation comment**
79
79
  ```typescript
80
80
  // ────────────────────────────────
81
81
  // Type Definitions
@@ -91,11 +91,11 @@ alwaysApply: true
91
91
  // ────────────────────────────────
92
92
 
93
93
  export async function fetchUser(id: string): Promise<User> {
94
- // código aqui
94
+ // code here
95
95
  }
96
96
  ```
97
97
 
98
- **❌ DON'T: Comentários explicativos**
98
+ **❌ DON'T: Explanatory comments**
99
99
  ```typescript
100
100
  // ❌ DON'T: This function fetches a user from the database
101
101
  export async function fetchUser(id: string): Promise<User> {
@@ -107,7 +107,7 @@ alwaysApply: true
107
107
  }
108
108
  ```
109
109
 
110
- **✅ DO: Código auto-explicativo + dev-logs se necessário**
110
+ **✅ DO: Self-explanatory code + dev-logs if necessary**
111
111
  ```typescript
112
112
  export async function fetchUserById(id: string): Promise<User> {
113
113
  const user = await db.user.findUnique({ where: { id } });
@@ -116,23 +116,23 @@ alwaysApply: true
116
116
  }
117
117
  ```
118
118
 
119
- Se a lógica for complexa, criar `dev-logs/user-fetching.md` com explicações.
119
+ If the logic is complex, create `dev-logs/user-fetching.md` with explanations.
120
120
 
121
- - **Criação Automática de dev-logs:**
122
- - **Sempre verificar** se `dev-logs/` existe antes de criar arquivo
123
- - **Criar a pasta** se não existir: `mkdir -p dev-logs`
124
- - **Usar nomes descritivos** para os arquivos: `kebab-case.md`
125
- - **Incluir data** no conteúdo do arquivo quando relevante
121
+ - **Automatic dev-logs Creation:**
122
+ - **Always check** if `dev-logs/` exists before creating file
123
+ - **Create the folder** if it doesn't exist: `mkdir -p dev-logs`
124
+ - **Use descriptive names** for files: `kebab-case.md`
125
+ - **Include date** in file content when relevant
126
126
 
127
- - **Exceções e Casos Especiais:**
128
- - **NENHUMA EXCEÇÃO** para comentários explicativos no código
129
- - Comentários de separação **sempre** seguem o padrão exato
130
- - Documentação complexa **sempre** vai para `dev-logs/`
127
+ - **Exceptions and Special Cases:**
128
+ - **NO EXCEPTION** for explanatory comments in code
129
+ - Separation comments **always** follow the exact pattern
130
+ - Complex documentation **always** goes to `dev-logs/`
131
131
 
132
- - **Integração com Outras Regras:**
133
- - [cursor_rules.mdc](mdc:.cursor/rules/cursor_rules.mdc) - Formatação de regras
134
- - [self_improve.mdc](mdc:.cursor/rules/self_improve.mdc) - Melhoria contínua
135
- - [commit_practices.mdc](mdc:.cursor/rules/commit_practices.mdc) - Commits podem referenciar dev-logs
132
+ - **Integration with Other Rules:**
133
+ - [cursor_rules.mdc](mdc:.cursor/rules/cursor_rules.mdc) - Rule formatting
134
+ - [self_improve.mdc](mdc:.cursor/rules/self_improve.mdc) - Continuous improvement
135
+ - [commit_practices.mdc](mdc:.cursor/rules/commit_practices.mdc) - Commits can reference dev-logs
136
136
 
137
- - **Princípio Fundamental:**
138
- > **O código deve ser auto-explicativo. Se algo precisa de explicação, documente em dev-logs/, não no código. Use comentários apenas para organização visual seguindo o padrão exato.**
137
+ - **Fundamental Principle:**
138
+ > **Code must be self-explanatory. If something needs explanation, document it in dev-logs/, not in code. Use comments only for visual organization following the exact pattern.**
@@ -1,30 +1,30 @@
1
1
  ---
2
- description: Práticas de commit após conclusão de tarefas e subtarefas, incluindo sugestões automáticas de mensagens
2
+ description: Commit practices after task and subtask completion, including automatic message suggestions
3
3
  globs: **/*
4
4
  alwaysApply: true
5
5
  ---
6
6
 
7
- - **Notificação e Sugestão de Commit Após Tarefas:**
8
- - **Sempre avisar o usuário** quando uma task ou subtask for marcada como `done`
9
- - **Sugerir uma mensagem de commit** baseada nas mudanças realizadas
10
- - **Incluir contexto** da task/subtask na sugestão de commit
11
- - **CRÍTICO: NUNCA executar comandos git** - apenas sugerir, o usuário executa
7
+ - **Notification and Commit Suggestion After Tasks:**
8
+ - **Always notify user** when a task or subtask is marked as `done`
9
+ - **Suggest a commit message** based on changes made
10
+ - **Include context** of task/subtask in commit suggestion
11
+ - **CRITICAL: NEVER execute git commands** - only suggest, user executes
12
12
 
13
- - **Quando Aplicar:**
14
- - Após `set_task_status` com status `done` para qualquer task ou subtask
15
- - Após implementação completa de uma subtask
16
- - Após conclusão de uma task pai (quando todas subtasks estiverem done)
13
+ - **When to Apply:**
14
+ - After `set_task_status` with status `done` for any task or subtask
15
+ - After complete implementation of a subtask
16
+ - After completion of a parent task (when all subtasks are done)
17
17
 
18
- - **Formato da Sugestão de Commit:**
18
+ - **Commit Suggestion Format:**
19
19
  ```bash
20
- # ✅ DO: Formato recomendado
21
- git commit -m "feat(module): Descrição curta da mudança
20
+ # ✅ DO: Recommended format
21
+ git commit -m "feat(module): Short description of change
22
22
 
23
- - Detalhes da implementação
23
+ - Implementation details
24
24
  - Task/Subtask ID: X.Y
25
- - Mudanças principais realizadas"
25
+ - Main changes made"
26
26
 
27
- # Exemplo real:
27
+ # Real example:
28
28
  git commit -m "feat(auth): Implement user login validation
29
29
 
30
30
  - Add email format validation
@@ -32,34 +32,34 @@ alwaysApply: true
32
32
  - Task ID: 3.2"
33
33
  ```
34
34
 
35
- - **Processo de Sugestão:**
36
- 1. **Analisar mudanças**: Usar `git status` e `git diff` para identificar arquivos modificados (apenas leitura, nunca modificar)
37
- 2. **Extrair contexto da task**: Incluir ID da task/subtask e título/descrição
38
- 3. **Gerar mensagem**: Criar mensagem seguindo conventional commits
39
- 4. **Apresentar ao usuário**: Mostrar sugestão formatada e pronta para uso
40
- 5. **NUNCA executar**: Apenas sugerir, o usuário decide quando e como fazer o commit
35
+ - **Suggestion Process:**
36
+ 1. **Analyze changes**: Use `git status` and `git diff` to identify modified files (read-only, never modify)
37
+ 2. **Extract task context**: Include task/subtask ID and title/description
38
+ 3. **Generate message**: Create message following conventional commits
39
+ 4. **Present to user**: Show formatted suggestion ready to use
40
+ 5. **NEVER execute**: Only suggest, user decides when and how to commit
41
41
 
42
- - **Tipos de Commit (Conventional Commits):**
43
- - `feat`: Nova funcionalidade (task completa)
44
- - `fix`: Correção de bug
45
- - `refactor`: Refatoração sem mudança de comportamento
46
- - `docs`: Mudanças em documentação
47
- - `style`: Formatação, ponto e vírgula, etc (sem mudança de código)
48
- - `test`: Adição ou correção de testes
49
- - `chore`: Mudanças em build, dependências, etc
42
+ - **Commit Types (Conventional Commits):**
43
+ - `feat`: New feature (complete task)
44
+ - `fix`: Bug fix
45
+ - `refactor`: Refactoring without behavior change
46
+ - `docs`: Documentation changes
47
+ - `style`: Formatting, semicolons, etc (no code change)
48
+ - `test`: Test addition or fix
49
+ - `chore`: Build, dependency changes, etc
50
50
 
51
- - **Estrutura da Mensagem Sugerida:**
51
+ - **Suggested Message Structure:**
52
52
  ```bash
53
- <tipo>(<escopo>): <descrição curta>
53
+ <type>(<scope>): <short description>
54
54
 
55
- <corpo opcional com detalhes>
55
+ <optional body with details>
56
56
  - Task/Subtask: <ID>
57
- - Arquivos modificados: <lista resumida>
57
+ - Modified files: <summary list>
58
58
  ```
59
59
 
60
- - **Exemplos de Sugestões:**
60
+ - **Suggestion Examples:**
61
61
 
62
- **Para subtask de implementação:**
62
+ **For implementation subtask:**
63
63
  ```bash
64
64
  git commit -m "feat(api): Add user authentication endpoint
65
65
 
@@ -69,7 +69,7 @@ alwaysApply: true
69
69
  - Subtask ID: 5.3"
70
70
  ```
71
71
 
72
- **Para task completa:**
72
+ **For complete task:**
73
73
  ```bash
74
74
  git commit -m "feat(dashboard): Complete user analytics dashboard
75
75
 
@@ -79,7 +79,7 @@ alwaysApply: true
79
79
  - Task ID: 7"
80
80
  ```
81
81
 
82
- **Para correção:**
82
+ **For fix:**
83
83
  ```bash
84
84
  git commit -m "fix(auth): Resolve token expiration issue
85
85
 
@@ -88,54 +88,54 @@ alwaysApply: true
88
88
  - Subtask ID: 8.1"
89
89
  ```
90
90
 
91
- - **Comandos Úteis para Análise:**
92
- - `git status --short` - Lista arquivos modificados de forma compacta
93
- - `git diff --stat` - Estatísticas de mudanças
94
- - `git diff --name-only` - Apenas nomes dos arquivos modificados
95
- - `git log --oneline -5` - Últimos commits para contexto
91
+ - **Useful Commands for Analysis:**
92
+ - `git status --short` - List modified files compactly
93
+ - `git diff --stat` - Change statistics
94
+ - `git diff --name-only` - Only names of modified files
95
+ - `git log --oneline -5` - Last commits for context
96
96
 
97
- - **Quando NÃO Sugerir Commit:**
98
- - ❌ DON'T: Se não houver mudanças no git (nenhum arquivo modificado)
99
- - ❌ DON'T: Se o usuário fez commit recentemente (últimos 5 minutos)
100
- - ❌ DON'T: Se houver conflitos de merge não resolvidos
101
- - ❌ DON'T: Se o repositório não for um git repo
97
+ - **When NOT to Suggest Commit:**
98
+ - ❌ DON'T: If there are no git changes (no modified files)
99
+ - ❌ DON'T: If user already committed recently (last 5 minutes)
100
+ - ❌ DON'T: If there are unresolved merge conflicts
101
+ - ❌ DON'T: If repository is not a git repo
102
102
 
103
- - **Apresentação da Sugestão:**
104
- - **Sempre notificar o usuário** quando uma task/subtask for concluída com mensagem clara e emoji ✅
105
- - **Mostrar sugestão formatada** pronta para copiar/colar
106
- - **Incluir estatísticas** das mudanças (arquivos modificados, linhas adicionadas/removidas)
103
+ - **Suggestion Presentation:**
104
+ - **Always notify user** when a task/subtask is completed with clear message and emoji ✅
105
+ - **Show formatted suggestion** ready to copy/paste
106
+ - **Include statistics** of changes (modified files, lines added/removed)
107
107
 
108
- **Exemplo de apresentação:**
108
+ **Presentation example:**
109
109
  ```markdown
110
- ✅ Task 3.2 concluída!
110
+ ✅ Task 3.2 completed!
111
111
 
112
- 📝 Sugestão de commit:
112
+ 📝 Commit suggestion:
113
113
  ```bash
114
- git commit -m "feat(module): Descrição da mudança
114
+ git commit -m "feat(module): Change description
115
115
 
116
- - Detalhe 1
117
- - Detalhe 2
116
+ - Detail 1
117
+ - Detail 2
118
118
  - Task ID: 3.2"
119
119
  ```
120
120
 
121
- 📊 Mudanças detectadas:
122
- - 3 arquivos modificados
123
- - 45 linhas adicionadas, 12 removidas
121
+ 📊 Changes detected:
122
+ - 3 files modified
123
+ - 45 lines added, 12 removed
124
124
  ```
125
125
 
126
- - **Integração com RBIN Task Flow:**
127
- - Após marcar uma task como concluída, automaticamente:
128
- 1. Verificar se mudanças no git
129
- 2. Analisar arquivos modificados
130
- 3. Gerar sugestão de commit baseada na task
131
- 4. Apresentar ao usuário de forma clara
126
+ - **Integration with RBIN Task Flow:**
127
+ - After marking a task as completed, automatically:
128
+ 1. Check if there are git changes
129
+ 2. Analyze modified files
130
+ 3. Generate commit suggestion based on task
131
+ 4. Present to user clearly
132
132
 
133
- - **Controle Git:**
134
- - **NUNCA executar comandos git** - apenas sugerir
135
- - Seguir [git_control.mdc](mdc:.cursor/rules/git_control.mdc) para controle total do usuário sobre git
136
- - Apresentar sugestões prontas para o usuário copiar e executar
133
+ - **Git Control:**
134
+ - **NEVER execute git commands** - only suggest
135
+ - Follow [git_control.mdc](mdc:.cursor/rules/git_control.mdc) for complete user control over git
136
+ - Present suggestions ready for user to copy and execute
137
137
 
138
- - **Referências:**
139
- - Seguir padrões de [Conventional Commits](https://www.conventionalcommits.org/)
140
- - Integrar com workflow do RBIN Task Flow
141
- - Controle git: [git_control.mdc](mdc:.cursor/rules/git_control.mdc)
138
+ - **References:**
139
+ - Follow [Conventional Commits](https://www.conventionalcommits.org/) patterns
140
+ - Integrate with RBIN Task Flow workflow
141
+ - Git control: [git_control.mdc](mdc:.cursor/rules/git_control.mdc)
@@ -1,88 +1,88 @@
1
1
  ---
2
- description: Controle total do usuário sobre comandos Git - o AI nunca executa comandos git, mas pode executar qualquer outro comando sem perguntar
2
+ description: Complete user control over Git commands - AI never executes git commands, but can execute any other command without asking
3
3
  globs: **/*
4
4
  alwaysApply: true
5
5
  ---
6
6
 
7
- - **Permissão Geral de Comandos:**
8
- - **✅ PODE executar** qualquer comando do sistema sem perguntar
9
- - **✅ PODE executar** npm, yarn, pnpm, docker, etc sem confirmação
10
- - **✅ PODE executar** scripts, testes, linters, formatters sem perguntar
11
- - **✅ NÃO precisa perguntar** antes de executar comandos simples ou comuns
12
- - **❌ ÚNICA EXCEÇÃO**: Comandos `git` que modificam o repositório
7
+ - **General Command Permission:**
8
+ - **✅ CAN execute** any system command without asking
9
+ - **✅ CAN execute** npm, yarn, pnpm, docker, etc without confirmation
10
+ - **✅ CAN execute** scripts, tests, linters, formatters without asking
11
+ - **✅ DON'T need to ask** before executing simple or common commands
12
+ - **❌ ONLY EXCEPTION**: `git` commands that modify the repository
13
13
 
14
- - **Comandos de Leitura - Execução Automática:**
15
- - **✅ SEMPRE executar sem perguntar** comandos que apenas leem informações:
16
- - `cat`, `head`, `tail`, `less`, `more` - Visualização de arquivos
17
- - `grep`, `find`, `ls`, `tree` - Busca e listagem
18
- - `wc`, `stat`, `file` - Informações sobre arquivos
19
- - `read_file` (ferramenta) - Leitura de arquivos
20
- - Qualquer comando que **não modifica** arquivos ou sistema
21
- - **✅ NUNCA perguntar** antes de executar comandos de leitura
22
- - **✅ Executar imediatamente** sem esperar confirmação do usuário
14
+ - **Read Commands - Automatic Execution:**
15
+ - **✅ ALWAYS execute without asking** commands that only read information:
16
+ - `cat`, `head`, `tail`, `less`, `more` - File viewing
17
+ - `grep`, `find`, `ls`, `tree` - Search and listing
18
+ - `wc`, `stat`, `file` - File information
19
+ - `read_file` (tool) - File reading
20
+ - Any command that **does not modify** files or system
21
+ - **✅ NEVER ask** before executing read commands
22
+ - **✅ Execute immediately** without waiting for user confirmation
23
23
 
24
- - **Proibição Absoluta de Executar Comandos Git:**
25
- - **❌ NUNCA executar** comandos `git` automaticamente
26
- - **❌ NUNCA fazer** `git add`, `git commit`, `git push`, `git pull`, `git merge`, etc
27
- - **❌ NUNCA modificar** o estado do repositório git
28
- - **✅ APENAS sugerir** comandos git quando apropriado
29
- - **✅ APENAS ler** informações do git (git status, git diff, git log) para análise
24
+ - **Absolute Prohibition of Executing Git Commands:**
25
+ - **❌ NEVER execute** `git` commands automatically
26
+ - **❌ NEVER do** `git add`, `git commit`, `git push`, `git pull`, `git merge`, etc
27
+ - **❌ NEVER modify** git repository state
28
+ - **✅ ONLY suggest** git commands when appropriate
29
+ - **✅ ONLY read** git information (git status, git diff, git log) for analysis
30
30
 
31
- - **Comandos Git Permitidos (Apenas Leitura):**
32
- - ✅ `git status` - Para verificar estado do repositório
33
- - ✅ `git diff` - Para analisar mudanças
34
- - ✅ `git log` - Para ver histórico
35
- - ✅ `git show` - Para ver detalhes de commits
36
- - ✅ `git branch` - Para listar branches (sem criar/modificar)
37
- - ✅ Qualquer comando git que **apenas lê** informações
31
+ - **Allowed Git Commands (Read Only):**
32
+ - ✅ `git status` - To check repository state
33
+ - ✅ `git diff` - To analyze changes
34
+ - ✅ `git log` - To view history
35
+ - ✅ `git show` - To view commit details
36
+ - ✅ `git branch` - To list branches (without creating/modifying)
37
+ - ✅ Any git command that **only reads** information
38
38
 
39
- - **Comandos Git Proibidos (Nunca Executar):**
40
- - ❌ `git add` - O usuário adiciona arquivos
41
- - ❌ `git commit` - O usuário faz commits
42
- - ❌ `git push` - O usuário faz push
43
- - ❌ `git pull` - O usuário faz pull
44
- - ❌ `git merge` - O usuário faz merge
45
- - ❌ `git checkout` - O usuário muda branches
46
- - ❌ `git branch -d` ou `-D` - O usuário deleta branches
47
- - ❌ `git reset` - O usuário faz reset
48
- - ❌ `git rebase` - O usuário faz rebase
49
- - ❌ `git tag` - O usuário cria tags
50
- - ❌ Qualquer comando que **modifique** o repositório
39
+ - **Prohibited Git Commands (Never Execute):**
40
+ - ❌ `git add` - User adds files
41
+ - ❌ `git commit` - User makes commits
42
+ - ❌ `git push` - User pushes
43
+ - ❌ `git pull` - User pulls
44
+ - ❌ `git merge` - User merges
45
+ - ❌ `git checkout` - User switches branches
46
+ - ❌ `git branch -d` or `-D` - User deletes branches
47
+ - ❌ `git reset` - User resets
48
+ - ❌ `git rebase` - User rebases
49
+ - ❌ `git tag` - User creates tags
50
+ - ❌ Any command that **modifies** the repository
51
51
 
52
- - **Quando Sugerir Comandos Git:**
53
- - ✅ Após conclusão de task/subtask - sugerir mensagem de commit
54
- - ✅ Quando mudanças não commitadas - sugerir commit
55
- - ✅ Quando conflitos - sugerir resolução (mas não executar)
56
- - ✅ Quando precisa atualizar - sugerir pull (mas não executar)
57
- - ✅ Sempre apresentar como **sugestão**, nunca executar
52
+ - **When to Suggest Git Commands:**
53
+ - ✅ After task/subtask completion - suggest commit message
54
+ - ✅ When there are uncommitted changes - suggest commit
55
+ - ✅ When there are conflicts - suggest resolution (but don't execute)
56
+ - ✅ When update is needed - suggest pull (but don't execute)
57
+ - ✅ Always present as **suggestion**, never execute
58
58
 
59
- - **Formato de Sugestões:**
59
+ - **Suggestion Format:**
60
60
  ```markdown
61
- ✅ Task concluída!
61
+ ✅ Task completed!
62
62
 
63
- 📝 Sugestão de commit (você executa):
63
+ 📝 Commit suggestion (you execute):
64
64
  ```bash
65
65
  git add .
66
- git commit -m "feat(module): Descrição"
66
+ git commit -m "feat(module): Description"
67
67
  ```
68
68
  ```
69
69
 
70
- **NUNCA fazer:**
70
+ **NEVER do:**
71
71
  ```bash
72
- # ❌ DON'T: Executar automaticamente
72
+ # ❌ DON'T: Execute automatically
73
73
  git add .
74
74
  git commit -m "..."
75
75
  ```
76
76
 
77
- - **Exceções e Casos Especiais:**
78
- - **NENHUMA EXCEÇÃO para git**: Esta regra é absoluta para comandos git
79
- - **Para comandos não-git**: Execute diretamente sem perguntar
80
- - **Para comandos git**: Mesmo que o usuário peça explicitamente, **sempre sugerir** ao invés de executar
81
- - Se houver dúvida sobre um comando ser git ou não, verificar se começa com `git` antes de executar
77
+ - **Exceptions and Special Cases:**
78
+ - **NO EXCEPTION for git**: This rule is absolute for git commands
79
+ - **For non-git commands**: Execute directly without asking
80
+ - **For git commands**: Even if user explicitly asks, **always suggest** instead of executing
81
+ - If in doubt about whether a command is git or not, check if it starts with `git` before executing
82
82
 
83
- - **Integração com Outras Regras:**
84
- - [commit_practices.mdc](mdc:.cursor/rules/commit_practices.mdc) - Sugerir commits, nunca executar
85
- - Workflow do RBIN Task Flow não deve incluir execução automática de git
83
+ - **Integration with Other Rules:**
84
+ - [commit_practices.mdc](mdc:.cursor/rules/commit_practices.mdc) - Suggest commits, never execute
85
+ - RBIN Task Flow workflow should not include automatic git execution
86
86
 
87
- - **Princípio Fundamental:**
88
- > **O usuário tem controle total sobre o repositório Git. O AI pode executar qualquer comando do sistema sem perguntar, EXCETO comandos git. Para git, apenas sugere, analisa e informa. Nunca modifica o estado do git.**
87
+ - **Fundamental Principle:**
88
+ > **User has complete control over the Git repository. AI can execute any system command without asking, EXCEPT git commands. For git, only suggests, analyzes, and informs. Never modifies git state.**