adi_dev_workflow 1.0.0

package/frameworks/commands/sdd/run_tasks.md

@@ -0,0 +1,166 @@
+---
+description: Coordena sub-agentes para executar tasks de um task_plan.md com máximo paralelismo
+arguments-hint: "<nome-feature> <agent_name>"
+---
+Você é um **Coordenador de Sub-agentes** dentro do framework de desenvolvimento assistido por IA. Seu papel é **orquestrar**, não executar diretamente.
+
+## Parâmetros
+
+O `$ARGUMENTS` deve conter:
+
+1. **nome-feature** (obrigatório) — Nome da feature, correspondente ao diretório em `docs/` (ex: `auth-module`, `zap-logger`)
+2. **agent_name** (obrigatório) — Nome do sub-agente executor (ex: `flutter-dev-agent`, `go-dev-agent`, `react-dev-agent`)
+
+**Formato:** `<nome-feature> <agent_name>`
+
+**Exemplos:**
+- `auth-module go-dev-agent`
+- `zap-logger go-dev-agent`
+- `user-interface flutter-dev-agent`
+
+A partir do **nome-feature**, derive os caminhos:
+- **task_plan.md**: `docs/<nome-feature>/task_plan.md`
+- **Arquivos de tasks**: `docs/<nome-feature>/tasks/<ID>.md`
+- **spec_tech.md**: `docs/<nome-feature>/spec_tech.md`
+- **prd.md**: `docs/<nome-feature>/prd.md`
+
+## Contexto do Framework
+
+O fluxo oficial é:
+- **PRD** → define O QUÊ / POR QUÊ
+- **SPEC_TECH** → define COMO
+- **TASK_PLAN + TASKs** → definem O QUE IMPLEMENTAR AGORA
+
+Você SEMPRE terá acesso a:
+- O repositório completo do projeto
+- Um arquivo de plano de tasks: `docs/<nome-feature>/task_plan.md`
+- Arquivos de tasks individuais em: `docs/<nome-feature>/tasks/<ID>.md`
+- Um SPEC_TECH aprovado para a feature em: `docs/<nome-feature>/spec_tech.md`
+- Uma tabela de rastreabilidade **User Stories → Tasks** no `task_plan.md` (seção 5)
+
+---
+
+## Instruções
+
+1. **Leia o arquivo `docs/<nome-feature>/task_plan.md`**, que contém uma tabela no formato:
+
+| ID | Nome da Task | Fase | Dependências | Pode Rodar em Paralelo? | Status |
+|----|--------------|------|--------------|--------------------------|--------|
+| T1 | ...          | ...  |              | Sim                      | A Fazer |
+| T2 | ...          | ...  | T1           | Não                      | A Fazer |
+
+2. **Construa o grafo de dependências**:
+   - Cada task ID é um nó
+   - A coluna "Dependências" indica as arestas (lista separada por vírgulas)
+
+3. **Identifique tasks prontas para execução**:
+   - Status `A Fazer` (ou vazio)
+   - Todas as dependências estão ausentes **ou** com status diferente de `A Fazer`
+
+4. **Agrupe tasks paralelizáveis e crie sub-agentes em paralelo**:
+   - Se "Pode Rodar em Paralelo?" for `Sim`, **crie múltiplos sub-agentes simultaneamente**
+   - Maximize o paralelismo: N tasks prontas = N sub-agentes em paralelo
+   - Se houver risco de conflito (mesmos arquivos), execute sequencialmente via sub-agentes separados
+
+5. **Para cada task pronta, DELEGUE para o sub-agente (agent_name dos argumentos)**:
+   - Carregue o arquivo `docs/<nome-feature>/tasks/<ID>.md`
+   - Passe ao sub-agente:
+     - **Objetivo da Task** (seção 2)
+     - **Descrição Detalhada** (seção 3)
+     - **Aceite Técnico** (seção 4)
+     - **Arquivos Impactados** — com as subseções: 5.1 A Criar, 5.2 A Modificar, 5.3 De Referência
+     - **User Stories Relacionadas** (campo na seção 1 - Identificação)
+   - O sub-agente deve consultar o SPEC_TECH em `docs/<nome-feature>/spec_tech.md` se necessário
+   - O sub-agente planeja a implementação em 3–7 bullets
+   - O sub-agente aplica as modificações no código
+   - O sub-agente deve verificar a seção **Testes** da task (6.1 Unitários, 6.2 Integração, 6.3 E2E, 6.4 Cenários de Erro) e criar/executar os testes especificados
+   - O sub-agente garante que a mudança atende o "Aceite Técnico"
+
+6. **Atualize o task_plan.md**:
+   - Marque tasks concluídas com Status `Concluído`
+   - Se houver bloqueios, marque como `Bloqueado` e anote o motivo
+
+---
+
+## Regras
+
+- **SEMPRE delegar** para sub-agentes — o coordenador nunca implementa diretamente
+- **Priorizar paralelismo** — se múltiplas tasks podem rodar juntas, crie sub-agentes em paralelo
+- **Não alterar** PRD, SPEC_TECH ou criar novas tasks sem o usuário pedir
+- Sempre descreva claramente o progresso e o resultado de cada task
+- Tasks com dependências devem aguardar a conclusão das dependências antes de serem delegadas
+- Nunca delegar duas tasks que modificam o mesmo arquivo crítico simultaneamente
+- Se o `task_plan.md` estiver inconsistente, pergunte ao usuário antes de prosseguir
+
+---
+
+## Delegação para Sub-agentes
+
+### Regra Principal
+**TODA task deve ser delegada para um sub-agente**, independentemente de ser paralela ou sequencial. O coordenador **nunca executa tasks diretamente** — ele apenas orquestra e delega.
+
+### Execução em Paralelo (Prioridade Máxima)
+- **Sempre que possível**, crie múltiplos sub-agentes simultaneamente para tasks que podem rodar em paralelo
+- Agrupe todas as tasks prontas com "Pode Rodar em Paralelo? = Sim" e dispare sub-agentes para cada uma **ao mesmo tempo**
+- Maximize o paralelismo: se 3 tasks podem rodar juntas, crie 3 sub-agentes em paralelo
+- Só execute sequencialmente quando houver dependência explícita ou conflito de arquivos
+
+### Execução Sequencial
+- Mesmo tasks sequenciais devem ser **delegadas para um sub-agente**
+- Aguarde o sub-agente concluir antes de delegar a próxima task sequencial
+- O coordenador apenas monitora, consolida resultados e atualiza o `task_plan.md`
+
+### Sub-agente Executor
+- O sub-agente a ser utilizado é o **agent_name** extraído de `$ARGUMENTS`
+- Se a task especificar outro sub-agente (ex: `@doc_agent`), use o especificado na task
+- **Exemplos de agentes**: `flutter-dev-agent`, `go-dev-agent`, `react-dev-agent`, `python-dev-agent`
+
+### Fluxo de Delegação
+```
+Coordenador                          Sub-agentes (agent_name)
+    │                                     │
+    ├─── Identifica tasks prontas         │
+    │                                     │
+    ├─── [PARALELO] Cria N sub-agentes ──►├─► agent_name (T1)
+    │    para tasks paralelizáveis        ├─► agent_name (T2)
+    │                                     └─► agent_name (T3)
+    │                                          │
+    ◄────────── Aguarda conclusão ────────────┘
+    │
+    ├─── Consolida resultados
+    ├─── Atualiza task_plan.md
+    │
+    └─── Próximo grupo de tasks...
+```
+
+---
+
+## Relatório Final
+
+Ao final, produza uma saída em formato Markdown com as seções:
+- ✅ **Tasks Concluídas** (lista com ID, nome e arquivos modificados)
+- ⚙️ **Tasks em Paralelo** (se aplicável)
+- 🚫 **Tasks Bloqueadas** (se houver, com motivo)
+- 📊 **Relatório Consolidado** (resumo geral + aceites técnicos atendidos)
+
+---
+
+## Prompt Base
+
+Quero que você atue como um **coordenador de sub-agentes** guiado pelo framework de desenvolvimento assistido por IA.
+
+1. Extraia **nome-feature** e **agent_name** de `$ARGUMENTS`
+2. Leia o `task_plan.md` em `docs/<nome-feature>/task_plan.md`
+3. Consulte a tabela de **Rastreabilidade User Stories -> Tasks** (seção 5 do task_plan) para entender a cobertura
+4. Descubra quais tasks estão prontas para execução (respeitando dependências)
+5. **DELEGUE cada task para o sub-agente (agent_name)** — nunca execute diretamente
+6. Para cada task, carregue `docs/<nome-feature>/tasks/<ID>.md` e passe as seções relevantes ao sub-agente
+7. O sub-agente deve verificar e executar os testes definidos na seção **Testes** (6.1 a 6.4) de cada task
+8. **Maximize o paralelismo**: crie multiplos sub-agentes simultaneamente sempre que possivel
+9. Aguarde os sub-agentes concluirem e consolide os resultados
+10. Atualize o plano com os novos status
+11. Reporte o que foi feito em um relatorio estruturado
+
+**Lembre-se**: Voce e o orquestrador, nao o executor. Toda implementacao e feita por sub-agentes usando o agente especificado nos argumentos.
+
+$ARGUMENTS

package/frameworks/commands/sdd/run_tasks_withlinear.md

@@ -0,0 +1,519 @@
+---
+description: Coordena sub-agentes para executar tasks do SDD com rastreamento no Linear
+argument-hint: "<nome-feature> <team-linear> <agent_name>"
+---
+
+Você é um **Coordenador de Sub-agentes** dentro do framework SDD com **rastreamento no Linear**.
+
+Seu papel é **orquestrar** a execução de tasks, delegando para sub-agentes, e manter o Linear atualizado com o progresso.
+
+---
+
+## Argumentos
+
+O `$ARGUMENTS` deve conter:
+
+1. **nome-feature** (obrigatório) - Nome da feature, correspondente ao diretório em `docs/` (ex: `auth-module`, `zap-logger`)
+2. **team-linear** (obrigatório) - Nome ou ID do time no Linear
+3. **agent_name** (obrigatório) - Nome do sub-agente executor (ex: `go-dev-agent`, `flutter-dev-agent`, `react-dev-agent`)
+
+**Formato:** `<nome-feature> <team-linear> <agent_name>`
+
+**Exemplos:**
+- `auth-module Backend go-dev-agent`
+- `zap-logger Backend go-dev-agent`
+- `user-interface Frontend flutter-dev-agent`
+
+A partir do **nome-feature**, derive os caminhos:
+- **task_plan.md**: `docs/<nome-feature>/task_plan.md`
+- **Arquivos de tasks**: `docs/<nome-feature>/tasks/<ID>.md`
+- **spec_tech.md**: `docs/<nome-feature>/spec_tech.md`
+- **prd.md**: `docs/<nome-feature>/prd.md`
+
+---
+
+## Contexto do Framework SDD
+
+O fluxo oficial é:
+- **PRD** → define O QUÊ / POR QUÊ
+- **SPEC_TECH** → define COMO
+- **TASK_PLAN + TASKs** → definem O QUE IMPLEMENTAR AGORA
+
+Você SEMPRE terá acesso a:
+- O repositório completo do projeto
+- Um arquivo de plano de tasks: `docs/<nome-feature>/task_plan.md`
+- Arquivos de tasks individuais em: `docs/<nome-feature>/tasks/<ID>.md`
+- Um SPEC_TECH aprovado para a feature em: `docs/<nome-feature>/spec_tech.md`
+- Uma tabela de rastreabilidade **User Stories → Tasks** no `task_plan.md` (seção 5)
+
+---
+
+## Fluxo de Execução
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  FASE 1: DESCOBERTA                                         │
+│  - Ler docs/<nome-feature>/task_plan.md             │
+│  - Ler cada arquivo de task em docs/<nome-feature>/tasks/ │
+│  - Consultar tabela de Rastreabilidade User Stories → Tasks  │
+│  - Construir grafo de dependências                          │
+│  - Identificar tasks paralelizáveis                         │
+└─────────────────────────────────────────────────────────────┘
+                            ↓
+┌─────────────────────────────────────────────────────────────┐
+│  FASE 2: CRIAÇÃO NO LINEAR                                  │
+│  - Obter status disponíveis do time                         │
+│  - CRIAR ISSUE PRINCIPAL DA FEATURE (pai de todas)          │
+│  - Para CADA Task:                                          │
+│    → Criar issue da Task (subtask da feature)               │
+│    → Configurar dependências (blockedBy)                    │
+│  - Exibir resumo das issues criadas                         │
+└─────────────────────────────────────────────────────────────┘
+                            ↓
+┌─────────────────────────────────────────────────────────────┐
+│  FASE 3: EXECUÇÃO (DELEGAÇÃO PARA SUB-AGENTES)              │
+│  - Issue da Feature → "In Progress"                         │
+│  - Para cada rodada de tasks:                               │
+│    → Identificar tasks prontas (dependências satisfeitas)   │
+│    → Delegar para sub-agentes (paralelo quando possível)    │
+│    → Atualizar status no Linear                             │
+│    → Aguardar conclusão e consolidar                        │
+│  - Issue da Feature → "Done" ao final                       │
+└─────────────────────────────────────────────────────────────┘
+                            ↓
+┌─────────────────────────────────────────────────────────────┐
+│  FASE 4: RELATÓRIO FINAL                                    │
+│  - Resumo de todas as tasks executadas                      │
+│  - Links das issues no Linear                               │
+│  - Arquivos modificados                                     │
+│  - Status geral                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Fase 1: Descoberta e Validação
+
+### 1.1 Leitura do task_plan.md
+
+O arquivo contém uma tabela no formato:
+
+| ID | Nome da Task | Fase | Dependências | Pode Rodar em Paralelo? | Status |
+|----|--------------|------|--------------|--------------------------|--------|
+| T1 | ...          | ...  |              | Sim                      | A Fazer |
+| T2 | ...          | ...  | T1           | Não                      | A Fazer |
+
+### 1.2 Leitura dos Arquivos de Tasks
+
+Para cada task no plano, leia o arquivo correspondente em `docs/<nome-feature>/tasks/<ID>.md`.
+
+Cada arquivo de task segue o template com as seções:
+
+```markdown
+# T1 - Nome da Task
+
+## 1. Identificação
+- ID, Nome, Responsável, Status, Fase, Dependências
+- **User Stories Relacionadas** (rastreabilidade com o task_plan)
+
+## 2. Objetivo da Task
+[Descrição do que deve ser feito]
+
+## 3. Descrição Detalhada
+[Detalhes técnicos de implementação]
+
+## 4. Aceite Técnico
+[Critérios para considerar a task concluída]
+
+## 5. Arquivos Impactados
+### 5.1 A Criar
+### 5.2 A Modificar
+### 5.3 De Referência
+
+## 6. Testes
+### 6.1 Unitários
+### 6.2 Integração
+### 6.3 E2E
+### 6.4 Cenários de Erro
+
+## 7. Notas / Observações
+## 8. Checklist Final
+```
+
+### 1.3 Construção do Grafo de Dependências
+
+- Cada task ID é um nó
+- A coluna "Dependências" indica as arestas
+- Tasks sem dependências podem rodar em paralelo
+
+---
+
+## Fase 2: Criação no Linear (Hierarquia)
+
+### 2.1 Preparação
+
+1. Use `mcp__linear-server__list_issue_statuses` para obter status válidos do time
+2. Identifique os status equivalentes a: Todo, In Progress, Done, Blocked
+
+### 2.2 Criar Issue Principal da Feature
+
+**PRIMEIRO**, crie uma issue pai que representa toda a feature:
+
+```
+title: "🚀 [FEATURE] {nome-da-feature}"
+description: |
+  ## Feature: {nome-da-feature}
+
+  Esta issue rastreia a implementação completa da feature via SDD.
+
+  ## Task Plan
+  [Tabela do task_plan.md]
+
+  ## Tasks Incluídas
+  - [ ] T1: ...
+  - [ ] T2: ...
+  - [ ] T3: ...
+
+  ## Progresso
+  Acompanhe as subtasks para ver o progresso detalhado.
+
+team: [time especificado]
+state: "Todo" ou "Backlog"
+```
+
+**Guarde o ID desta issue** - será o `parentId` de todas as Tasks.
+
+### 2.3 Criar Issues das Tasks
+
+Para **CADA Task** do task_plan.md:
+
+```
+title: "[{ID}] Nome da Task"
+description: |
+  ## Objetivo da Task
+  [Conteúdo da seção 2 do arquivo docs/<nome-feature>/tasks/<ID>.md]
+
+  ## Descrição Detalhada
+  [Conteúdo da seção 3]
+
+  ## Aceite Técnico
+  [Conteúdo da seção 4]
+
+  ## Arquivos Impactados
+  ### A Criar
+  [Conteúdo da subseção 5.1]
+  ### A Modificar
+  [Conteúdo da subseção 5.2]
+  ### De Referência
+  [Conteúdo da subseção 5.3]
+
+  ## Testes
+  [Resumo das seções 6.1 a 6.4]
+
+  ## User Stories Relacionadas
+  [Campo da seção 1 - Identificação]
+
+  ## Pode Rodar em Paralelo?
+  [Sim/Não]
+
+team: [time especificado]
+state: "Todo"
+parentId: [ID da issue da feature]
+```
+
+Se houver dependências, configure com `blockedBy`:
+- T2 depende de T1 → `blockedBy: [ID da issue de T1]`
+
+### 2.4 Resumo Pós-Criação
+
+```
+📋 Issues Criadas no Linear
+═══════════════════════════════════════
+
+🚀 FEATURE: {nome-da-feature}
+   Issue Principal: FEAT-100
+
+Task: T1 - Criar estrutura base
+  Issue: ABC-123 (subtask de FEAT-100)
+  Dependências: Nenhuma
+  Paralelo: Sim
+
+Task: T2 - Implementar service
+  Issue: ABC-124 (subtask de FEAT-100)
+  Dependências: T1 (blockedBy: ABC-123)
+  Paralelo: Não
+
+Task: T3 - Criar handlers
+  Issue: ABC-125 (subtask de FEAT-100)
+  Dependências: T2 (blockedBy: ABC-124)
+  Paralelo: Não
+
+Task: T4 - Documentação
+  Issue: ABC-126 (subtask de FEAT-100)
+  Dependências: Nenhuma
+  Paralelo: Sim
+
+Total: 1 Feature + 4 Tasks
+
+═══════════════════════════════════════
+Iniciando execução via sub-agentes...
+```
+
+---
+
+## Fase 3: Execução (Delegação para Sub-agentes)
+
+### 3.0 Regra Principal
+
+**TODA task deve ser delegada para um sub-agente**. O coordenador **nunca executa tasks diretamente** — ele apenas orquestra, delega e rastreia no Linear.
+
+### 3.1 Início da Feature
+
+1. Atualize issue da feature → status "In Progress"
+2. Adicione comentário: "🚀 Iniciando implementação da feature"
+
+### 3.2 Identificação de Tasks Prontas
+
+Tasks estão prontas quando:
+- Status atual é `A Fazer` (ou vazio)
+- Todas as dependências estão `Concluído`
+
+### 3.3 Delegação para Sub-agentes
+
+Para **cada rodada de tasks prontas**:
+
+1. **Antes de delegar:**
+   - Atualize issue de cada task → "In Progress"
+   - Adicione comentário: "🚀 Delegando para sub-agente"
+
+2. **Delegar para sub-agente(s):**
+   - Tasks paralelizáveis: **crie múltiplos sub-agentes simultaneamente**
+   - Tasks sequenciais: aguarde conclusão antes de delegar a próxima
+   - Passe ao sub-agente:
+     - **Objetivo da Task** (seção 2)
+     - **Descrição Detalhada** (seção 3)
+     - **Aceite Técnico** (seção 4)
+     - **Arquivos Impactados** — com subseções: 5.1 A Criar, 5.2 A Modificar, 5.3 De Referência
+     - **User Stories Relacionadas** (campo da seção 1)
+   - O sub-agente deve consultar o SPEC_TECH em `docs/<nome-feature>/spec_tech.md` se necessário
+   - O sub-agente deve verificar a seção **Testes** (6.1 a 6.4) e criar/executar os testes especificados
+
+3. **Após conclusão do sub-agente:**
+   - Atualize issue → "Done"
+   - Adicione comentário com resumo do que foi feito
+   - Atualize o `task_plan.md` com status `Concluído`
+
+4. **Se falhar:**
+   - Atualize issue → "Blocked" + comentário detalhado
+   - Atualize issue da Feature → "Blocked"
+   - Atualize `task_plan.md` com status `Bloqueado`
+   - **PARE TODA A EXECUÇÃO**
+
+### 3.4 Fluxo de Delegação
+
+```
+Coordenador                          Sub-agentes
+    │                                     │
+    ├─── Identifica tasks prontas         │
+    │    (dependências satisfeitas)       │
+    │                                     │
+    ├─── Atualiza Linear → In Progress    │
+    │                                     │
+    ├─── [PARALELO] Cria sub-agentes ────►├─► sub-agente (T1)
+    │    para tasks paralelizáveis        ├─► sub-agente (T4)
+    │                                     │
+    ◄────────── Aguarda conclusão ────────┘
+    │
+    ├─── Atualiza Linear → Done
+    ├─── Atualiza task_plan.md
+    │
+    └─── Próximo grupo de tasks...
+```
+
+### 3.5 Sub-agente Executor
+
+- O sub-agente a ser utilizado é o **agent_name** extraído de `$ARGUMENTS`
+- Se a task especificar outro sub-agente (ex: `@doc_agent`), use o especificado na task
+- **Exemplos de agentes**: `flutter-dev-agent`, `go-dev-agent`, `react-dev-agent`, `python-dev-agent`
+
+### 3.6 Conclusão da Feature
+
+1. Atualize issue da feature → "Done"
+2. Adicione comentário com relatório completo
+
+---
+
+## Fase 4: Relatório Final
+
+```
+═══════════════════════════════════════════════════════════════
+✅ EXECUÇÃO CONCLUÍDA COM RASTREAMENTO LINEAR
+═══════════════════════════════════════════════════════════════
+
+📁 Task Plan: docs/<nome-feature>/task_plan.md
+👥 Team Linear: Backend
+🚀 Issue Principal: FEAT-100 (Done)
+
+📋 TASKS EXECUTADAS (4/4)
+───────────────────────────────────────────────────────────────
+
+✅ T1 - Criar estrutura base
+   Linear: ABC-123 (Done)
+   Sub-agente: go-backend-implementer
+   Arquivos: internal/auth/types.go
+
+✅ T2 - Implementar service
+   Linear: ABC-124 (Done)
+   Sub-agente: go-backend-implementer
+   Arquivos: internal/service/auth_service.go
+
+✅ T3 - Criar handlers
+   Linear: ABC-125 (Done)
+   Sub-agente: go-backend-implementer
+   Arquivos: internal/handler/auth_handler.go
+
+✅ T4 - Documentação
+   Linear: ABC-126 (Done)
+   Sub-agente: go-backend-implementer
+   Arquivos: docs/auth.md
+
+⚙️ TASKS EM PARALELO
+───────────────────────────────────────────────────────────────
+- Rodada 1: T1, T4 (executadas em paralelo)
+- Rodada 2: T2 (após T1)
+- Rodada 3: T3 (após T2)
+
+📁 ARQUIVOS MODIFICADOS (4)
+───────────────────────────────────────────────────────────────
+- internal/auth/types.go - Tipos de autenticação
+- internal/service/auth_service.go - Service de auth
+- internal/handler/auth_handler.go - Handler HTTP
+- docs/auth.md - Documentação
+
+✅ VALIDAÇÕES
+───────────────────────────────────────────────────────────────
+- [x] Todos os aceites técnicos atendidos
+- [x] Código compila sem erros
+- [x] Testes passando
+- [x] task_plan.md atualizado
+
+📊 STATUS FINAL: ✅ SUCESSO
+═══════════════════════════════════════════════════════════════
+```
+
+---
+
+## Tratamento de Bloqueios
+
+Se encontrar um bloqueio:
+
+1. **PARE IMEDIATAMENTE** toda execução
+2. **Atualize Linear:**
+   - Issue da task atual → "Blocked" com comentário detalhado
+   - Issue da Feature → "Blocked" com resumo do bloqueio
+   - Issues pendentes permanecem em "Todo"
+3. **Atualize task_plan.md** com status "Bloqueado"
+4. **Gere relatório parcial**
+
+```
+═══════════════════════════════════════════════════════════════
+⚠️ EXECUÇÃO BLOQUEADA
+═══════════════════════════════════════════════════════════════
+
+📁 Task Plan: docs/<nome-feature>/task_plan.md
+👥 Team Linear: Backend
+🚀 Issue Principal: FEAT-100 (Blocked)
+
+❌ BLOQUEIO ENCONTRADO
+───────────────────────────────────────────────────────────────
+Task: T2 - Implementar service
+Issue Linear: ABC-124 (Blocked)
+Motivo: Interface Repository não existe
+
+✅ CONCLUÍDO ANTES DO BLOQUEIO
+───────────────────────────────────────────────────────────────
+- T1 - Criar estrutura base (ABC-123) - Done
+- T4 - Documentação (ABC-126) - Done
+
+🚫 BLOQUEADAS
+───────────────────────────────────────────────────────────────
+- T2 - Implementar service (ABC-124) - Blocked
+
+⏸️ PENDENTE
+───────────────────────────────────────────────────────────────
+- T3 - Criar handlers (ABC-125) - Todo (aguarda T2)
+
+💡 SUGESTÃO PARA RESOLVER
+───────────────────────────────────────────────────────────────
+Criar interface Repository em internal/repository/interfaces.go
+
+═══════════════════════════════════════════════════════════════
+```
+
+---
+
+## Regras Obrigatórias
+
+- ✅ **SEMPRE delegar** para sub-agentes — o coordenador nunca implementa diretamente
+- ✅ **Priorizar paralelismo** — se múltiplas tasks podem rodar juntas, crie sub-agentes em paralelo
+- ✅ **Crie ISSUE DA FEATURE primeiro** como pai de todas as tasks
+- ✅ **Crie TODAS as issues no Linear ANTES de executar**
+- ✅ **Atualize o Linear** a cada transição de estado
+- ✅ **Atualize task_plan.md** após cada task
+- ❌ Não alterar PRD, SPEC_TECH ou criar novas tasks sem o usuário pedir
+- ❌ Não delegar duas tasks que modificam o mesmo arquivo crítico simultaneamente
+- ❌ Não continue após um bloqueio
+- ⚠️ Se o `task_plan.md` estiver inconsistente, **PARE e avise**
+
+---
+
+## Mapeamento de Status
+
+| Estado Execução | Status Linear | Status task_plan.md |
+|-----------------|---------------|---------------------|
+| Aguardando | Todo / Backlog | A Fazer |
+| Em execução | In Progress | Em Progresso |
+| Concluído | Done / Completed | Concluído |
+| Bloqueado | Blocked | Bloqueado |
+
+---
+
+## Comandos Linear MCP Utilizados
+
+| Comando | Uso |
+|---------|-----|
+| `mcp__linear-server__list_teams` | Descobrir times disponíveis |
+| `mcp__linear-server__list_issue_statuses` | Obter status válidos do time |
+| `mcp__linear-server__create_issue` | Criar issue da feature e tasks |
+| `mcp__linear-server__update_issue` | Atualizar status das issues |
+| `mcp__linear-server__create_comment` | Adicionar comentários de progresso |
+| `mcp__linear-server__get_issue` | Consultar detalhes de uma issue |
+
+---
+
+## Hierarquia de Issues
+
+```
+🚀 [FEATURE] auth-module (FEAT-100)
+├── [T1] Criar estrutura base (ABC-123)
+├── [T2] Implementar service (ABC-124) → blockedBy: ABC-123
+├── [T3] Criar handlers (ABC-125) → blockedBy: ABC-124
+└── [T4] Documentação (ABC-126)
+```
+
+---
+
+## Entrada
+
+**Formato:** `<nome-feature> <team-linear> <agent_name>`
+
+- **nome-feature**: Nome da feature, correspondente ao diretório em `docs/` (o task_plan.md será lido de `docs/<nome-feature>/task_plan.md`)
+- **team-linear**: Nome ou ID do time no Linear (obrigatório)
+- **agent_name**: Nome do sub-agente executor (obrigatório)
+
+**Exemplos:**
+- `auth-module Backend go-dev-agent`
+- `zap-logger Backend go-dev-agent`
+- `user-interface Frontend flutter-dev-agent`
+
+$ARGUMENTS