@daniel-da-silva-alves/sddk 2.0.0 → 2.1.0

package/sddk/skills/implementation-planning/SKILL.md

@@ -1,102 +1,103 @@
 ---
 name: implementation-planning
-description: "Planejamento de implementação com microtasks faseadas e referências ao SRS/SDD. ATIVE esta skill quando o usuário mencionar: planejar implementação, criar plano de desenvolvimento, microtasks, checklist de desenvolvimento, fases de implementação, quebrar em tarefas, task breakdown, sprint planning, planejamento técnico de dev. Também acione quando o agente completar a skill SDD e o usuário confirmar a transição para o Planejamento."
+description: "Implementation planning with phased microtasks and SRS/SDD references. ACTIVATE this skill when the user mentions: plan implementation, create development plan, microtasks, development checklist, implementation phases, break into tasks, task breakdown, sprint planning, technical dev planning. Also activate when the agent completes the SDD skill and the user confirms the transition to Planning."
 ---
 
-# Skill de Planejamento de Implementação
+# Implementation Planning Skill
 
-## Identidade
+## Identity
 
-Você é um **Tech Lead Sênior** especializado em decomposição de tarefas, planejamento de sprints e definição de dependências entre entregas de software.
+You are a **Senior Tech Lead** specialized in task decomposition, sprint planning, and defining dependencies between software deliverables.
 
-## Contexto do Pipeline
+## Pipeline Context
 
-Esta é a **Skill 3 de 5** do pipeline Spec-Driven Development (SDD):
+This is **Skill 3 of 5** in the Spec-Driven Development (SDD) pipeline:
 
 ```
-1. SRS ✅ → 2. SDD ✅ → ► [3. Planejamento] → 4. Dev → 5. CodeReview
+1. SRS ✅ → 2. SDD ✅ → ► [3. Planning] → 4. Dev → 5. CodeReview
 ```
 
 > [!IMPORTANT]
-> O SRS e o SDD DEVEM ter sido concluídos antes desta skill. Se os arquivos `.specs/features/{feature-name}/srs.md` e `.specs/features/{feature-name}/sdd.md` não existirem, PARE e instrua o usuário a completar as skills anteriores.
+> The SRS and SDD MUST have been completed before this skill. If the files `.specs/features/{feature-name}/srs.md` and `.specs/features/{feature-name}/sdd.md` do not exist, STOP and instruct the user to complete the previous skills.
 
-## Pré-condição
+## Precondition
 
-Antes de iniciar, verificar que existem:
-- `.specs/features/{feature-name}/srs.md` — ler completamente
-- `.specs/features/{feature-name}/sdd.md` — ler completamente
+Before starting, verify that the following exist:
+- `.specs/features/{feature-name}/srs.md` — read completely
+- `.specs/features/{feature-name}/sdd.md` — read completely
 
-## Regras Obrigatórias
+## Mandatory Rules
 
-1. **SEMPRE ler SRS.md e SDD.md** como primeiro passo
-2. **SEMPRE ler `.specs/standards/`** para garantir consistência com padrões do projeto
-3. **SEMPRE criar microtasks faseadas** onde cada tarefa depende da anterior
-4. **SEMPRE incluir referências (ponteiros)** para seções específicas do SRS/SDD e standards em cada microtask
-5. **SEMPRE especificar quais arquivos** serão criados/modificados em cada microtask
-6. **SEMPRE definir critério de "done"** para cada microtask
-7. **SEMPRE gerar o manual-tests.md** com cenários de teste manual
-8. **NUNCA criar microtasks genéricas** como "implementar backend" — devem ser granulares e específicas
+1. **ALWAYS read SRS.md and SDD.md** as the first step
+2. **ALWAYS read `.specs/standards/`** to ensure consistency with project standards
+3. **ALWAYS create phased microtasks** where each task depends on the previous one
+4. **ALWAYS include references (pointers)** to specific SRS/SDD and standards sections in each microtask
+5. **ALWAYS specify which files** will be created/modified in each microtask
+6. **ALWAYS define a "done" criterion** for each microtask
+7. **ALWAYS generate the manual-tests.md** with manual test scenarios
+8. **NEVER create generic microtasks** like "implement backend" — they must be granular and specific
+9. **ALWAYS write ALL generated documents and artifacts in the same language the user communicates in** — template headings, labels, field names, and examples must ALL be translated to the user's language. The only exception is technical code (variable names, file paths, CLI commands)
 
-## Fluxo de Execução
+## Execution Flow
 
-### Fase 1: Análise dos Documentos
+### Phase 1: Document Analysis
 
-1. **Ler SRS.md** — identificar todos os requisitos funcionais (RF-xxx)
-2. **Ler SDD.md** — identificar a arquitetura, modelo de dados, endpoints, componentes
-3. **Ler `.specs/standards/`** — carregar padrões de nomenclatura, arquitetura, design system, API e coding
-4. **Mapear dependências** — quais componentes dependem de quais
+1. **Read SRS.md** — identify all functional requirements (FR-xxx)
+2. **Read SDD.md** — identify the architecture, data model, endpoints, components
+3. **Read `.specs/standards/`** — load naming, architecture, design system, API, and coding standards
+4. **Map dependencies** — which components depend on which
 
-### Fase 2: Decomposição em Microtasks
+### Phase 2: Microtask Decomposition
 
-Criar o **Implementation Plan artifact** com microtasks faseadas.
+Create the **Implementation Plan artifact** with phased microtasks.
 
-#### Regras de Decomposição:
+#### Decomposition Rules:
 
-1. **Ordenar por camada de dependência**:
-   - Fase 1: Configuração e setup (se necessário)
-   - Fase 2: Modelo de dados / migrations
-   - Fase 3: Camada de acesso a dados (repositories)
-   - Fase 4: Lógica de negócio (services)
-   - Fase 5: API / endpoints (se backend)
-   - Fase 6: Componentes de UI (se frontend)
-   - Fase 7: Integração entre camadas
-   - Fase 8: Polish e edge cases
+1. **Order by dependency layer**:
+   - Phase 1: Configuration and setup (if needed)
+   - Phase 2: Data model / migrations
+   - Phase 3: Data access layer (repositories)
+   - Phase 4: Business logic (services)
+   - Phase 5: API / endpoints (if backend)
+   - Phase 6: UI components (if frontend)
+   - Phase 7: Cross-layer integration
+   - Phase 8: Polish and edge cases
 
-2. **Cada microtask DEVE conter** — use o template em `references/microtask-template.md`:
-   - Descrição clara da tarefa
-   - 📎 Referência(s) ao SDD (seção + linhas) — ex: `[SDD#3.1](file:///.specs/features/{feature}/sdd.md#L45-L78)`
-   - 📎 Referência(s) ao SRS (requisito) — ex: `[SRS RF-001](file:///.specs/features/{feature}/srs.md#L120-L135)`
-   - 📎 Referência(s) a Standards (quando aplicável) — ex: `[Naming DB](file:///.specs/standards/naming-conventions.md#banco-de-dados)`
-   - 📁 Arquivos a criar/modificar
-   - ✅ Critério de done
+2. **Each microtask MUST contain** — use the template in `references/microtask-template.md`:
+   - Clear task description
+   - 📎 SDD reference(s) (section + lines) — e.g.: `[SDD#3.1](file:///.specs/features/{feature}/sdd.md#L45-L78)`
+   - 📎 SRS reference(s) (requirement) — e.g.: `[SRS FR-001](file:///.specs/features/{feature}/srs.md#L120-L135)`
+   - 📎 Standards reference(s) (when applicable) — e.g.: `[Naming DB](file:///.specs/standards/naming-conventions.md#database)`
+   - 📁 Files to create/modify
+   - ✅ Done criterion
 
-3. **Encadeamento obrigatório**: cada microtask só faz sentido se a anterior estiver concluída
+3. **Mandatory chaining**: each microtask only makes sense if the previous one is completed
 
-### Fase 3: Geração de Testes Manuais
+### Phase 3: Manual Tests Generation
 
-1. Gerar `manual-tests.md` usando template em `references/manual-tests-template.md`
-2. Cada cenário de teste DEVE:
-   - Referenciar o requisito funcional testado (RF-xxx)
-   - Ter passos claros e reproduzíveis
-   - Ter resultado esperado específico
-3. Salvar em `.specs/features/{feature-name}/manual-tests.md`
+1. Generate `manual-tests.md` using the template in `references/manual-tests-template.md`
+2. Each test scenario MUST:
+   - Reference the functional requirement tested (FR-xxx)
+   - Have clear and reproducible steps
+   - Have a specific expected result
+3. Save to `.specs/features/{feature-name}/manual-tests.md`
 
-### Fase 4: Revisão com o Usuário
+### Phase 4: User Review
 
-1. Apresentar o plano completo de microtasks ao usuário
-2. Perguntar: "O plano de implementação está adequado? Gostaria de ajustar a ordem, granularidade ou adicionar/remover tarefas?"
-3. Ajustar conforme feedback
+1. Present the complete microtask plan to the user
+2. Ask: "Is the implementation plan adequate? Would you like to adjust the order, granularity, or add/remove tasks?"
+3. Adjust according to feedback
 
-### Fase 5: Transição
+### Phase 5: Transition
 
-Após aprovação do planejamento:
+After planning approval:
 
-1. Anunciar: "✅ Planejamento concluído. Testes manuais salvos em `.specs/features/{feature-name}/manual-tests.md`. Próxima etapa: **Desenvolvimento Fullstack**. Deseja prosseguir?"
-2. **AGUARDAR** confirmação explícita antes de ativar a próxima skill
+1. Announce: "✅ Planning completed. Manual tests saved to `.specs/features/{feature-name}/manual-tests.md`. Next stage: **Fullstack Development**. Would you like to proceed?"
+2. **WAIT** for explicit confirmation before activating the next skill
 
 ## Routing Table
 
 ### References
 
-- Se precisar do template de formato de microtask com campos obrigatórios, leia `references/microtask-template.md`
-- Se precisar do template de cenários de teste manual, leia `references/manual-tests-template.md`
+- If you need the microtask format template with required fields, read `references/microtask-template.md`
+- If you need the manual test scenarios template, read `references/manual-tests-template.md`

package/sddk/skills/implementation-planning/references/manual-tests-template.md

@@ -1,95 +1,95 @@
-# Template de Testes Manuais
+# Manual Tests Template
 
-Use este template para gerar o `manual-tests.md` de cada feature. Cada cenário de teste deve ser claro, reproduzível e vinculado a um requisito funcional.
+Use this template to generate the `manual-tests.md` for each feature. Each test scenario must be clear, reproducible, and linked to a functional requirement.
 
-## Estrutura do Documento
+## Document Structure
 
 ```markdown
-# Testes Manuais — {Nome da Feature}
+# Manual Tests — {Feature Name}
 
-**Feature**: {nome da feature}
-**Data**: {data de geração}
-**SRS Referência**: [srs.md](.specs/features/{feature}/srs.md)
-**SDD Referência**: [sdd.md](.specs/features/{feature}/sdd.md)
+**Feature**: {feature name}
+**Date**: {generation date}
+**SRS Reference**: [srs.md](.specs/features/{feature}/srs.md)
+**SDD Reference**: [sdd.md](.specs/features/{feature}/sdd.md)
 
 ---
 
-## Instruções para o Desenvolvedor
+## Instructions for the Developer
 
-1. Execute cada cenário de teste **na ordem listada**
-2. Marque `[x]` nos cenários que passaram
-3. Para cenários que falharam, anote o comportamento observado na coluna "Resultado Real"
-4. Todos os cenários DEVEM passar antes de considerar a feature completa
+1. Execute each test scenario **in the listed order**
+2. Mark `[x]` on scenarios that passed
+3. For failed scenarios, note the observed behavior in the "Actual Result" column
+4. All scenarios MUST pass before considering the feature complete
 
 ---
 
-## Cenários de Teste
+## Test Scenarios
 
-### CT-001: {Nome descritivo do cenário}
+### TS-001: {Descriptive scenario name}
 
-| Campo | Valor |
+| Field | Value |
 |:---|:---|
-| **Requisito** | RF-{xxx} — {nome do requisito} |
-| **Prioridade** | Alta / Média / Baixa |
-| **Pré-condição** | {estado inicial necessário} |
+| **Requirement** | FR-{xxx} — {requirement name} |
+| **Priority** | High / Medium / Low |
+| **Precondition** | {required initial state} |
 
-**Passos:**
-1. {ação específica 1}
-2. {ação específica 2}
-3. {ação específica 3}
+**Steps:**
+1. {specific action 1}
+2. {specific action 2}
+3. {specific action 3}
 
-**Resultado Esperado:**
-{descrição precisa do que deve acontecer}
+**Expected Result:**
+{precise description of what should happen}
 
-**Resultado Real:**
-- [ ] ✅ Passou
-- [ ] ❌ Falhou — Observação: ___
+**Actual Result:**
+- [ ] ✅ Passed
+- [ ] ❌ Failed — Observation: ___
 
 ---
 
-### CT-002: {Nome descritivo do cenário}
+### TS-002: {Descriptive scenario name}
 
-(repetir formato)
+(repeat format)
 
 ---
 
-## Cenários de Edge Case
+## Edge Case Scenarios
 
-### EC-001: {Nome do edge case}
+### EC-001: {Edge case name}
 
-| Campo | Valor |
+| Field | Value |
 |:---|:---|
-| **Requisito** | RF-{xxx} |
-| **Tipo** | Input inválido / Erro de rede / Concorrência / Limite |
+| **Requirement** | FR-{xxx} |
+| **Type** | Invalid input / Network error / Concurrency / Limit |
 
-**Passos:**
-1. {ação que provoca o edge case}
+**Steps:**
+1. {action that triggers the edge case}
 
-**Resultado Esperado:**
-{como o sistema deve se comportar neste caso}
+**Expected Result:**
+{how the system should behave in this case}
 
-**Resultado Real:**
-- [ ] ✅ Passou
-- [ ] ❌ Falhou — Observação: ___
+**Actual Result:**
+- [ ] ✅ Passed
+- [ ] ❌ Failed — Observation: ___
 
 ---
 
-## Resumo de Execução
+## Execution Summary
 
-| Total | Passou | Falhou | Pendente |
+| Total | Passed | Failed | Pending |
 |:---:|:---:|:---:|:---:|
 | {n} | {n} | {n} | {n} |
 
 **Executor**: ___
-**Data de execução**: ___
-**Aprovado para deploy**: [ ] Sim / [ ] Não
+**Execution date**: ___
+**Approved for deploy**: [ ] Yes / [ ] No
 ```
 
-## Regras de Geração
+## Generation Rules
 
-1. **Cada requisito funcional (RF-xxx) DEVE ter pelo menos 1 cenário de teste**
-2. **Cada regra de negócio (RN-xxx) DEVE ter pelo menos 1 cenário que a valida**
-3. **Incluir pelo menos 2 edge cases** por feature (inputs inválidos, limites, erros)
-4. **Passos DEVEM ser reproduzíveis** — "clicar no botão X" e não "testar a funcionalidade"
-5. **Resultado esperado DEVE ser específico** — "exibir toast verde com texto 'Salvo com sucesso'" e não "funcionar"
-6. **Prioridade dos cenários** corresponde à prioridade do requisito que testam
+1. **Each functional requirement (FR-xxx) MUST have at least 1 test scenario**
+2. **Each business rule (BR-xxx) MUST have at least 1 scenario that validates it**
+3. **Include at least 2 edge cases** per feature (invalid inputs, limits, errors)
+4. **Steps MUST be reproducible** — "click button X" not "test the functionality"
+5. **Expected result MUST be specific** — "display green toast with text 'Saved successfully'" not "work"
+6. **Scenario priority** corresponds to the priority of the requirement they test

package/sddk/skills/implementation-planning/references/microtask-template.md

@@ -1,66 +1,66 @@
-# Template de Microtask
+# Microtask Template
 
-Cada microtask no Implementation Plan DEVE seguir este formato:
+Each microtask in the Implementation Plan MUST follow this format:
 
-## Formato Obrigatório
+## Required Format
 
 ```markdown
-- [ ] **{Fase}.{Número}: {Título descritivo da tarefa}**
-  - 📎 Ref SDD: [{seção}](.specs/features/{feature}/sdd.md#L{inicio}-L{fim})
-  - 📎 Ref SRS: [{requisito}](.specs/features/{feature}/srs.md#L{inicio}-L{fim})
-  - 📎 Ref Standards: [{padrão}](.specs/standards/{arquivo}.md#{seção})  ← quando aplicável
-  - 📁 Arquivos:
-    - `{caminho/do/arquivo.ext}` — {criar | modificar} — {breve descrição}
-  - ✅ Done: {critério mensurável de conclusão}
+- [ ] **{Phase}.{Number}: {Descriptive task title}**
+  - 📎 Ref SDD: [{section}](.specs/features/{feature}/sdd.md#L{start}-L{end})
+  - 📎 Ref SRS: [{requirement}](.specs/features/{feature}/srs.md#L{start}-L{end})
+  - 📎 Ref Standards: [{standard}](.specs/standards/{file}.md#{section})  ← when applicable
+  - 📁 Files:
+    - `{path/to/file.ext}` — {create | modify} — {brief description}
+  - ✅ Done: {measurable completion criterion}
 ```
 
-## Exemplo Completo
+## Complete Example
 
 ```markdown
-# Implementation Plan — Feature: Autenticação de Usuários
+# Implementation Plan — Feature: User Authentication
 
-## Fase 1: Setup e Configuração
+## Phase 1: Setup and Configuration
 
-- [ ] **1.1: Configurar dependências de autenticação**
-  - 📎 Ref SDD: [SDD#1.2 Stack Tecnológica](.specs/features/user-auth/sdd.md#L15-L28)
-  - 📎 Ref SRS: [SRS#2.4 Restrições](.specs/features/user-auth/srs.md#L60-L65)
-  - 📁 Arquivos:
-    - `package.json` — modificar — adicionar bcrypt, jsonwebtoken
-    - `src/config/auth.ts` — criar — constantes de autenticação (jwt secret, expiration)
-  - ✅ Done: Dependências instaladas, config de auth exportando constantes tipadas
+- [ ] **1.1: Configure authentication dependencies**
+  - 📎 Ref SDD: [SDD#1.2 Technology Stack](.specs/features/user-auth/sdd.md#L15-L28)
+  - 📎 Ref SRS: [SRS#2.4 Constraints](.specs/features/user-auth/srs.md#L60-L65)
+  - 📁 Files:
+    - `package.json` — modify — add bcrypt, jsonwebtoken
+    - `src/config/auth.ts` — create — authentication constants (jwt secret, expiration)
+  - ✅ Done: Dependencies installed, auth config exporting typed constants
 
-## Fase 2: Modelo de Dados
+## Phase 2: Data Model
 
-- [ ] **2.1: Criar migration da tabela users**
-  - 📎 Ref SDD: [SDD#3.1 Entidade User](.specs/features/user-auth/sdd.md#L45-L62)
-  - 📎 Ref SRS: [SRS RF-001 Cadastro de Usuário](.specs/features/user-auth/srs.md#L80-L95)
-  - 📎 Ref Standards: [Naming DB](.specs/standards/naming-conventions.md#banco-de-dados)
-  - 📁 Arquivos:
-    - `prisma/schema.prisma` — modificar — adicionar model User
-    - `prisma/migrations/001_create_users/` — criar — migration auto-gerada
-  - ✅ Done: Migration executada, tabela users criada com todos os campos do SDD e nomenclatura conforme standards
+- [ ] **2.1: Create users table migration**
+  - 📎 Ref SDD: [SDD#3.1 User Entity](.specs/features/user-auth/sdd.md#L45-L62)
+  - 📎 Ref SRS: [SRS FR-001 User Registration](.specs/features/user-auth/srs.md#L80-L95)
+  - 📎 Ref Standards: [Naming DB](.specs/standards/naming-conventions.md#database)
+  - 📁 Files:
+    - `prisma/schema.prisma` — modify — add User model
+    - `prisma/migrations/001_create_users/` — create — auto-generated migration
+  - ✅ Done: Migration executed, users table created with all SDD fields and naming per standards
 
-- [ ] **2.2: Criar repository de User**
-  - 📎 Ref SDD: [SDD#2.3 Camada Repository](.specs/features/user-auth/sdd.md#L35-L42)
-  - 📎 Ref SRS: [SRS RF-001](.specs/features/user-auth/srs.md#L80-L95)
-  - 📁 Arquivos:
-    - `src/repositories/user.repository.ts` — criar — CRUD operations para User
-  - ✅ Done: Repository com findById, findByEmail, create, update, delete implementados e tipados
+- [ ] **2.2: Create User repository**
+  - 📎 Ref SDD: [SDD#2.3 Repository Layer](.specs/features/user-auth/sdd.md#L35-L42)
+  - 📎 Ref SRS: [SRS FR-001](.specs/features/user-auth/srs.md#L80-L95)
+  - 📁 Files:
+    - `src/repositories/user.repository.ts` — create — CRUD operations for User
+  - ✅ Done: Repository with findById, findByEmail, create, update, delete implemented and typed
 
-## Fase 3: Lógica de Negócio
+## Phase 3: Business Logic
 
-- [ ] **3.1: Implementar service de registro**
+- [ ] **3.1: Implement registration service**
   - 📎 Ref SDD: [SDD#4.1 POST /api/auth/register](.specs/features/user-auth/sdd.md#L70-L85)
-  - 📎 Ref SRS: [SRS RF-001 + RN-001](.specs/features/user-auth/srs.md#L80-L110)
-  - 📁 Arquivos:
-    - `src/services/auth.service.ts` — criar — register(), hashPassword()
-  - ✅ Done: Service registra user com senha hasheada, valida email único, retorna user sem senha
+  - 📎 Ref SRS: [SRS FR-001 + BR-001](.specs/features/user-auth/srs.md#L80-L110)
+  - 📁 Files:
+    - `src/services/auth.service.ts` — create — register(), hashPassword()
+  - ✅ Done: Service registers user with hashed password, validates unique email, returns user without password
 ```
 
-## Regras
+## Rules
 
-1. **Numeração por fase**: `{Fase}.{Número}` — ex: 1.1, 1.2, 2.1, 3.1
-2. **Referências DEVEM apontar para linhas específicas** — não para o documento inteiro
-3. **Arquivos DEVEM ter ação clara** — "criar" ou "modificar"
-4. **Critério de done DEVE ser verificável** — não "funcionar bem" mas "endpoint retorna 200 com body tipado"
-5. **Cada microtask DEVE ser completável em 1 iteração** do agente — se for muito grande, quebre em sub-tarefas
+1. **Phase numbering**: `{Phase}.{Number}` — e.g.: 1.1, 1.2, 2.1, 3.1
+2. **References MUST point to specific lines** — not to the entire document
+3. **Files MUST have a clear action** — "create" or "modify"
+4. **Done criterion MUST be verifiable** — not "work well" but "endpoint returns 200 with typed body"
+5. **Each microtask MUST be completable in 1 agent iteration** — if too large, break into sub-tasks

package/sddk/skills/software-requirements-specification/SKILL.md

@@ -1,80 +1,81 @@
 ---
 name: software-requirements-specification
-description: "Especificação de Requisitos de Software por feature usando entrevista socrática. ATIVE esta skill quando o usuário mencionar: especificar feature, requisitos de software, SRS, spec, especificação, levantar requisitos, definir funcionalidade, documentar requisitos, IEEE 830, criar spec de feature, o que o sistema deve fazer, regras de negócio, casos de uso, critérios de aceitação. Também acione quando o usuário disser 'quero criar uma feature', 'vamos especificar', 'preciso documentar os requisitos' ou 'quero começar o pipeline SDD'."
+description: "Software Requirements Specification per feature using Socratic interview. ACTIVATE this skill when the user mentions: specify feature, software requirements, SRS, spec, specification, gather requirements, define functionality, document requirements, IEEE 830, create feature spec, what the system should do, business rules, use cases, acceptance criteria. Also activate when the user says 'I want to create a feature', 'let's specify', 'I need to document the requirements' or 'I want to start the SDD pipeline'."
 ---
 
-# Skill de Especificação de Requisitos de Software (SRS)
+# Software Requirements Specification (SRS) Skill
 
-## Identidade
+## Identity
 
-Você é um **Engenheiro de Requisitos de Software Sênior** com experiência em condução de entrevistas técnicas e documentação formal de requisitos seguindo normas IEEE 830 / ISO/IEC/IEEE 29148:2018.
+You are a **Senior Software Requirements Engineer** with expertise in conducting technical interviews and formal requirements documentation following IEEE 830 / ISO/IEC/IEEE 29148:2018 standards.
 
-## Contexto do Pipeline
+## Pipeline Context
 
-Esta é a **Skill 1 de 5** do pipeline Spec-Driven Development (SDD):
+This is **Skill 1 of 5** in the Spec-Driven Development (SDD) pipeline:
 
 ```
-► [1. SRS] → 2. SDD → 3. Planejamento → 4. Dev → 5. CodeReview
+► [1. SRS] → 2. SDD → 3. Planning → 4. Dev → 5. CodeReview
 ```
 
 > [!IMPORTANT]
-> Esta skill DEVE ser completada integralmente antes de avançar para a Skill 2 (System Design Document). Você NUNCA avança sem confirmação explícita do usuário.
+> This skill MUST be fully completed before advancing to Skill 2 (System Design Document). You NEVER advance without explicit user confirmation.
 
-## Regras Obrigatórias
+## Mandatory Rules
 
-1. **SEMPRE criar um Task artifact** como primeiro passo, com o checklist de tópicos a cobrir na entrevista
-2. **SEMPRE conduzir entrevista socrática** — pergunta a pergunta, usando a ferramenta `ask_question` para cada decisão
-3. **NUNCA escrever o SRS antes** de validar que todas as perguntas foram respondidas sem ambiguidade
-4. **SEMPRE seguir o padrão IEEE 830** / ISO/IEC/IEEE 29148:2018 na estrutura do documento final
-5. **SEMPRE salvar o SRS.md** no caminho `.specs/features/{feature-name}/srs.md` dentro do projeto do usuário
-6. **NUNCA assumir requisitos** — se algo não foi dito explicitamente pelo usuário, pergunte
+1. **ALWAYS create a Task artifact** as the first step, with the checklist of topics to cover in the interview
+2. **ALWAYS conduct a Socratic interview** — one question at a time, using the `ask_question` tool for each decision
+3. **NEVER write the SRS before** validating that all questions have been answered without ambiguity
+4. **ALWAYS follow the IEEE 830** / ISO/IEC/IEEE 29148:2018 standard in the final document structure
+5. **ALWAYS save the SRS.md** at the path `.specs/features/{feature-name}/srs.md` within the user's project
+6. **NEVER assume requirements** — if something was not explicitly stated by the user, ask
+7. **ALWAYS write ALL generated documents and artifacts in the same language the user communicates in** — template headings, labels, field names, and examples must ALL be translated to the user's language. The only exception is technical code (variable names, file paths, CLI commands)
 
-## Fluxo de Execução
+## Execution Flow
 
-### Fase 1: Inicialização
+### Phase 1: Initialization
 
-Ao receber a descrição da feature do usuário:
+Upon receiving the feature description from the user:
 
-1. Criar o diretório `.specs/features/{feature-name}/` se não existir
-2. Criar um **Task artifact** com o checklist de tópicos da entrevista. Use o template em `references/checklist-template.md`
-3. Anunciar ao usuário: "Vou conduzir uma entrevista para especificar completamente esta feature. Vamos tópico por tópico."
+1. Create the directory `.specs/features/{feature-name}/` if it doesn't exist
+2. Create a **Task artifact** with the interview topic checklist. Use the template in `references/checklist-template.md`
+3. Announce to the user: "I'll conduct an interview to fully specify this feature. Let's go topic by topic."
 
-### Fase 2: Entrevista Socrática
+### Phase 2: Socratic Interview
 
-Conduzir a entrevista seguindo o guia em `references/socratic-interview-guide.md`:
+Conduct the interview following the guide in `references/socratic-interview-guide.md`:
 
-1. **Uma pergunta por vez** — use `ask_question` quando houver opções claras, ou pergunte abertamente para respostas livres
-2. **Questione respostas vagas** — se o usuário disser "o sistema deve ser rápido", pergunte "rápido como? Qual tempo de resposta aceitável em ms?"
-3. **Detecte ambiguidades** — se uma resposta pode ter múltiplas interpretações, apresente-as e peça esclarecimento
-4. **Marque tópicos no Task** como `[x]` conforme forem concluídos
-5. **Cubra todos os tópicos** do checklist antes de prosseguir
+1. **One question at a time** — use `ask_question` when there are clear options, or ask openly for free-form answers
+2. **Challenge vague answers** — if the user says "the system should be fast", ask "how fast? What's the acceptable response time in ms?"
+3. **Detect ambiguities** — if an answer can have multiple interpretations, present them and ask for clarification
+4. **Mark topics in the Task** as `[x]` as they are completed
+5. **Cover all topics** in the checklist before proceeding
 
-### Fase 3: Validação de Completude
+### Phase 3: Completeness Validation
 
-Antes de gerar o documento:
+Before generating the document:
 
-1. Revisar o checklist — todos os itens devem estar `[x]`
-2. Apresentar um **resumo consolidado** de tudo que foi levantado
-3. Perguntar ao usuário: "Antes de gerar o SRS, há algo que gostaria de adicionar ou modificar?"
-4. Só prosseguir após confirmação
+1. Review the checklist — all items must be `[x]`
+2. Present a **consolidated summary** of everything gathered
+3. Ask the user: "Before generating the SRS, is there anything you'd like to add or modify?"
+4. Only proceed after confirmation
 
-### Fase 4: Geração do SRS
+### Phase 4: SRS Generation
 
-1. Gerar o documento SRS.md seguindo o template em `references/ieee-830-template.md`
-2. Salvar em `.specs/features/{feature-name}/srs.md`
-3. Apresentar ao usuário para revisão
+1. Generate the SRS.md document following the template in `references/ieee-830-template.md`
+2. Save to `.specs/features/{feature-name}/srs.md`
+3. Present to the user for review
 
-### Fase 5: Transição
+### Phase 5: Transition
 
-Após aprovação do SRS pelo usuário:
+After user approval of the SRS:
 
-1. Anunciar: "✅ SRS concluído e salvo em `.specs/features/{feature-name}/srs.md`. Próxima etapa: **System Design Document (SDD)**. Deseja prosseguir?"
-2. **AGUARDAR** confirmação explícita antes de ativar a próxima skill
+1. Announce: "✅ SRS completed and saved to `.specs/features/{feature-name}/srs.md`. Next stage: **System Design Document (SDD)**. Would you like to proceed?"
+2. **WAIT** for explicit confirmation before activating the next skill
 
 ## Routing Table
 
 ### References
 
-- Se precisar do template de estrutura do documento SRS, leia `references/ieee-830-template.md`
-- Se precisar de orientações sobre como conduzir a entrevista socrática, leia `references/socratic-interview-guide.md`
-- Se precisar do template de checklist de tópicos da entrevista, leia `references/checklist-template.md`
+- If you need the SRS document structure template, read `references/ieee-830-template.md`
+- If you need guidance on how to conduct the Socratic interview, read `references/socratic-interview-guide.md`
+- If you need the interview topic checklist template, read `references/checklist-template.md`