adi_dev_workflow 1.1.1 → 1.3.0

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/without_skill/outputs/transcript.md

@@ -1,84 +1,84 @@
-# Transcript — Task Plan Generation (without_skill)
-
-## Ferramentas Utilizadas
-
-### 1. Bash — Listar migracoes existentes
-```
-ls "H:/repos/flutter_experience/04_2026/cb_vakinhaburger_2025/vakinha-api-review/internal/db/migrations/"
-```
-**Resultado:** `001_create_usuarios.sql`, `002_add_endereco_usuarios.sql`
-
-### 2. Bash — Listar queries SQLC
-```
-ls "H:/repos/flutter_experience/04_2026/cb_vakinhaburger_2025/vakinha-api-review/internal/db/queries/"
-```
-**Resultado:** Diretorio nao existe nesse caminho (queries estao em `internal/db/sqlc/queries/`)
-
-### 3. Bash — Listar arquivos repository, service, handler, proto
-```
-ls para cada diretorio
-```
-**Resultado (parcial, outros cancelados por erro no queries):**
-- `api/proto/v1/`: `user.proto`
-- `internal/repository/`: `user_repository.go`, `user_repository_integration_test.go`
-- `internal/service/`: `user_service.go`, `user_service_test.go`
-- `internal/handler/grpc/`: `fx.go`, `user_handler.go`, `user_handler_test.go`
-
-### 4. Bash — Encontrar todos os arquivos Go e SQL no internal
-```
-find "H:/repos/.../internal" -type f -name "*.go" -o -name "*.sql" | head -60
-```
-**Resultado:** Lista completa de 24 arquivos no projeto.
-
-### 5. Read — Migracao 001
-**Arquivo:** `internal/db/migrations/001_create_usuarios.sql`
-**Conteudo:** CREATE TABLE usuarios com colunas id, nome, email, senha_hash, data_criacao, data_atualizacao.
-
-### 6. Read — Migracao 002
-**Arquivo:** `internal/db/migrations/002_add_endereco_usuarios.sql`
-**Conteudo:** `ALTER TABLE usuarios ADD COLUMN endereco TEXT NOT NULL DEFAULT '';`
-
-### 7. Read — Queries SQLC
-**Arquivo:** `internal/db/sqlc/queries/user.sql`
-**Conteudo:** 4 queries: CreateUser, GetUserByID, GetUserByEmail, UpdateUser. Todas com colunas em portugues.
-
-### 8. Read — Repository
-**Arquivo:** `internal/repository/user_repository.go`
-**Conteudo:** Struct User (ID, Name, Email, PasswordHash, Address, CreatedAt, UpdatedAt), interface UserRepository, implementacao sqlcUserRepository, funcao toUser para mapeamento.
-
-### 9. Read — Service
-**Arquivo:** `internal/service/user_service.go`
-**Conteudo:** CreateUserInput, UpdateUserInput (com campos opcionais via ponteiro), UserService interface, implementacao com validacoes, login, JWT, etc.
-
-### 10. Read — Handler gRPC
-**Arquivo:** `internal/handler/grpc/user_handler.go`
-**Conteudo:** UserHandler com CreateUser, Login, GetUserLogged, UpdateUser. Funcoes auxiliares domainUserToProto e mapServiceError.
-
-### 11. Read — Proto
-**Arquivo:** `api/proto/v1/user.proto`
-**Conteudo:** Mensagens User, CreateUserRequest/Response, LoginRequest/Response, GetUserLoggedRequest/Response, UpdateUserRequest/Response, servico UserService.
-
-### 12. Read — Service Tests
-**Arquivo:** `internal/service/user_service_test.go`
-**Conteudo:** MockUserRepository, testes table-driven e individuais para CreateUser, Login, GetUserLogged, UpdateUser. Padrao testify/mock.
-
-### 13. Read — Handler Tests
-**Arquivo:** `internal/handler/grpc/user_handler_test.go`
-**Conteudo:** MockUserService, testes para todos os handlers, TestMapServiceError_AllErrors, TestDomainUserToProto.
-
-### 14. Glob — Encontrar sqlc.yaml
-```
-pattern: **/sqlc.yaml
-```
-**Resultado:** `internal/db/sqlc/sqlc.yaml`
-
-### 15. Bash — Criar diretorio de output
-```
-mkdir -p ".../without_skill/outputs"
-```
-
-### 16. Write — response.md
-Gerado o Task Plan completo com 7 tasks.
-
-### 17. Write — transcript.md
-Este arquivo.
+# Transcript — Task Plan Generation (without_skill)
+
+## Ferramentas Utilizadas
+
+### 1. Bash — Listar migracoes existentes
+```
+ls "H:/repos/flutter_experience/04_2026/cb_vakinhaburger_2025/vakinha-api-review/internal/db/migrations/"
+```
+**Resultado:** `001_create_usuarios.sql`, `002_add_endereco_usuarios.sql`
+
+### 2. Bash — Listar queries SQLC
+```
+ls "H:/repos/flutter_experience/04_2026/cb_vakinhaburger_2025/vakinha-api-review/internal/db/queries/"
+```
+**Resultado:** Diretorio nao existe nesse caminho (queries estao em `internal/db/sqlc/queries/`)
+
+### 3. Bash — Listar arquivos repository, service, handler, proto
+```
+ls para cada diretorio
+```
+**Resultado (parcial, outros cancelados por erro no queries):**
+- `api/proto/v1/`: `user.proto`
+- `internal/repository/`: `user_repository.go`, `user_repository_integration_test.go`
+- `internal/service/`: `user_service.go`, `user_service_test.go`
+- `internal/handler/grpc/`: `fx.go`, `user_handler.go`, `user_handler_test.go`
+
+### 4. Bash — Encontrar todos os arquivos Go e SQL no internal
+```
+find "H:/repos/.../internal" -type f -name "*.go" -o -name "*.sql" | head -60
+```
+**Resultado:** Lista completa de 24 arquivos no projeto.
+
+### 5. Read — Migracao 001
+**Arquivo:** `internal/db/migrations/001_create_usuarios.sql`
+**Conteudo:** CREATE TABLE usuarios com colunas id, nome, email, senha_hash, data_criacao, data_atualizacao.
+
+### 6. Read — Migracao 002
+**Arquivo:** `internal/db/migrations/002_add_endereco_usuarios.sql`
+**Conteudo:** `ALTER TABLE usuarios ADD COLUMN endereco TEXT NOT NULL DEFAULT '';`
+
+### 7. Read — Queries SQLC
+**Arquivo:** `internal/db/sqlc/queries/user.sql`
+**Conteudo:** 4 queries: CreateUser, GetUserByID, GetUserByEmail, UpdateUser. Todas com colunas em portugues.
+
+### 8. Read — Repository
+**Arquivo:** `internal/repository/user_repository.go`
+**Conteudo:** Struct User (ID, Name, Email, PasswordHash, Address, CreatedAt, UpdatedAt), interface UserRepository, implementacao sqlcUserRepository, funcao toUser para mapeamento.
+
+### 9. Read — Service
+**Arquivo:** `internal/service/user_service.go`
+**Conteudo:** CreateUserInput, UpdateUserInput (com campos opcionais via ponteiro), UserService interface, implementacao com validacoes, login, JWT, etc.
+
+### 10. Read — Handler gRPC
+**Arquivo:** `internal/handler/grpc/user_handler.go`
+**Conteudo:** UserHandler com CreateUser, Login, GetUserLogged, UpdateUser. Funcoes auxiliares domainUserToProto e mapServiceError.
+
+### 11. Read — Proto
+**Arquivo:** `api/proto/v1/user.proto`
+**Conteudo:** Mensagens User, CreateUserRequest/Response, LoginRequest/Response, GetUserLoggedRequest/Response, UpdateUserRequest/Response, servico UserService.
+
+### 12. Read — Service Tests
+**Arquivo:** `internal/service/user_service_test.go`
+**Conteudo:** MockUserRepository, testes table-driven e individuais para CreateUser, Login, GetUserLogged, UpdateUser. Padrao testify/mock.
+
+### 13. Read — Handler Tests
+**Arquivo:** `internal/handler/grpc/user_handler_test.go`
+**Conteudo:** MockUserService, testes para todos os handlers, TestMapServiceError_AllErrors, TestDomainUserToProto.
+
+### 14. Glob — Encontrar sqlc.yaml
+```
+pattern: **/sqlc.yaml
+```
+**Resultado:** `internal/db/sqlc/sqlc.yaml`
+
+### 15. Bash — Criar diretorio de output
+```
+mkdir -p ".../without_skill/outputs"
+```
+
+### 16. Write — response.md
+Gerado o Task Plan completo com 7 tasks.
+
+### 17. Write — transcript.md
+Este arquivo.

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/without_skill/timing.json

@@ -1 +1 @@
-{"total_tokens": 61206, "duration_ms": 143285, "total_duration_seconds": 143.3}
+{"total_tokens": 61206, "duration_ms": 143285, "total_duration_seconds": 143.3}

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/eval_metadata.json

@@ -1,12 +1,12 @@
-{
-  "eval_id": 3,
-  "eval_name": "spec-tech-sem-user-stories-explicitas",
-  "prompt": "Gere o TASK PLAN para esta feature. Segue o SPEC_TECH aprovado:\n\n---\n# SPEC_TECH — Cache de Cardapio v1\n\n## 1. Identificacao\n| Campo | Valor |\n|-------|-------|\n| **Feature/Projeto** | Cache de Cardapio em Memoria |\n| **Versao** | v1 |\n| **Data** | 2026-03-07 |\n\n## 2. Resumo Tecnico\nImplementar cache in-memory (sync.Map) para o cardapio de produtos, evitando queries repetidas ao SQLite. TTL configuravel via config.yaml.\n\n## 3. Definicoes Tecnicas\n\n### 3.1 Novo Pacote\n- `internal/infra/cache/` com interface `Cache[K, V]` e implementacao `InMemoryCache`\n- TTL configuravel via `cache.ttl_seconds` no config.yaml\n- Invalidacao manual via metodo `Invalidate(key)`\n\n### 3.2 Service\n- ProductService passa a consultar cache antes do repository\n- Cache miss: busca no repository e popula cache\n- Operacoes de escrita (Create, Update, Delete) invalidam a entrada correspondente\n\n### 3.3 Config\n- Novo campo `cache.ttl_seconds` (padrao: 300)\n\n### 3.4 DI\n- Registrar modulo cache no FX\n---",
-  "assertions": [
-    {"id": "c1", "text": "Detecta a ausencia de User Stories (US-XX) e PRD referenciado no SPEC_TECH", "type": "llm_judge"},
-    {"id": "c2", "text": "PERGUNTA ao usuario sobre User Stories / PRD em vez de inventar ou ignorar", "type": "llm_judge"},
-    {"id": "c3", "text": "NAO inventa User Stories ficticias (guardrail: nunca invente informacoes)", "type": "llm_judge"},
-    {"id": "c4", "text": "Extrai corretamente o nome da feature como 'cache-de-cardapio' ou similar em kebab-case", "type": "llm_judge"},
-    {"id": "c5", "text": "Segue o processo interativo (uma pergunta por vez, confirma nome antes de prosseguir)", "type": "llm_judge"}
-  ]
-}
+{
+  "eval_id": 3,
+  "eval_name": "spec-tech-sem-user-stories-explicitas",
+  "prompt": "Gere o TASK PLAN para esta feature. Segue o SPEC_TECH aprovado:\n\n---\n# SPEC_TECH — Cache de Cardapio v1\n\n## 1. Identificacao\n| Campo | Valor |\n|-------|-------|\n| **Feature/Projeto** | Cache de Cardapio em Memoria |\n| **Versao** | v1 |\n| **Data** | 2026-03-07 |\n\n## 2. Resumo Tecnico\nImplementar cache in-memory (sync.Map) para o cardapio de produtos, evitando queries repetidas ao SQLite. TTL configuravel via config.yaml.\n\n## 3. Definicoes Tecnicas\n\n### 3.1 Novo Pacote\n- `internal/infra/cache/` com interface `Cache[K, V]` e implementacao `InMemoryCache`\n- TTL configuravel via `cache.ttl_seconds` no config.yaml\n- Invalidacao manual via metodo `Invalidate(key)`\n\n### 3.2 Service\n- ProductService passa a consultar cache antes do repository\n- Cache miss: busca no repository e popula cache\n- Operacoes de escrita (Create, Update, Delete) invalidam a entrada correspondente\n\n### 3.3 Config\n- Novo campo `cache.ttl_seconds` (padrao: 300)\n\n### 3.4 DI\n- Registrar modulo cache no FX\n---",
+  "assertions": [
+    {"id": "c1", "text": "Detecta a ausencia de User Stories (US-XX) e PRD referenciado no SPEC_TECH", "type": "llm_judge"},
+    {"id": "c2", "text": "PERGUNTA ao usuario sobre User Stories / PRD em vez de inventar ou ignorar", "type": "llm_judge"},
+    {"id": "c3", "text": "NAO inventa User Stories ficticias (guardrail: nunca invente informacoes)", "type": "llm_judge"},
+    {"id": "c4", "text": "Extrai corretamente o nome da feature como 'cache-de-cardapio' ou similar em kebab-case", "type": "llm_judge"},
+    {"id": "c5", "text": "Segue o processo interativo (uma pergunta por vez, confirma nome antes de prosseguir)", "type": "llm_judge"}
+  ]
+}

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/with_skill/grading.json

@@ -1,32 +1,32 @@
-{
-  "eval_id": 3,
-  "eval_name": "spec-tech-sem-user-stories-explicitas",
-  "configuration": "with_skill",
-  "expectations": [
-    {
-      "text": "Detecta a ausencia de User Stories (US-XX) e PRD referenciado no SPEC_TECH",
-      "passed": true,
-      "evidence": "Explicitamente diz 'O SPEC_TECH fornecido nao contem User Stories (US-XX) e nao referencia nenhum PRD' na secao 'Problema Identificado'."
-    },
-    {
-      "text": "PERGUNTA ao usuario sobre User Stories / PRD em vez de inventar ou ignorar",
-      "passed": true,
-      "evidence": "Faz pergunta com 3 opcoes (A: fornecer PRD, B: criar sem rastreabilidade, C: definir US simplificadas) e aguarda resposta."
-    },
-    {
-      "text": "NAO inventa User Stories ficticias (guardrail: nunca invente informacoes)",
-      "passed": true,
-      "evidence": "Nenhuma User Story ficticia foi criada. Apenas identificou a ausencia e perguntou ao usuario como proceder."
-    },
-    {
-      "text": "Extrai corretamente o nome da feature como 'cache-de-cardapio' ou similar em kebab-case",
-      "passed": true,
-      "evidence": "Extraiu 'Cache de Cardapio em Memoria' e normalizou para 'cache-cardapio' em kebab-case."
-    },
-    {
-      "text": "Segue o processo interativo (uma pergunta por vez, confirma nome antes de prosseguir)",
-      "passed": true,
-      "evidence": "Apresentou o nome extraido e fez UMA pergunta (sobre US/PRD + ProductService) aguardando resposta antes de prosseguir."
-    }
-  ]
-}
+{
+  "eval_id": 3,
+  "eval_name": "spec-tech-sem-user-stories-explicitas",
+  "configuration": "with_skill",
+  "expectations": [
+    {
+      "text": "Detecta a ausencia de User Stories (US-XX) e PRD referenciado no SPEC_TECH",
+      "passed": true,
+      "evidence": "Explicitamente diz 'O SPEC_TECH fornecido nao contem User Stories (US-XX) e nao referencia nenhum PRD' na secao 'Problema Identificado'."
+    },
+    {
+      "text": "PERGUNTA ao usuario sobre User Stories / PRD em vez de inventar ou ignorar",
+      "passed": true,
+      "evidence": "Faz pergunta com 3 opcoes (A: fornecer PRD, B: criar sem rastreabilidade, C: definir US simplificadas) e aguarda resposta."
+    },
+    {
+      "text": "NAO inventa User Stories ficticias (guardrail: nunca invente informacoes)",
+      "passed": true,
+      "evidence": "Nenhuma User Story ficticia foi criada. Apenas identificou a ausencia e perguntou ao usuario como proceder."
+    },
+    {
+      "text": "Extrai corretamente o nome da feature como 'cache-de-cardapio' ou similar em kebab-case",
+      "passed": true,
+      "evidence": "Extraiu 'Cache de Cardapio em Memoria' e normalizou para 'cache-cardapio' em kebab-case."
+    },
+    {
+      "text": "Segue o processo interativo (uma pergunta por vez, confirma nome antes de prosseguir)",
+      "passed": true,
+      "evidence": "Apresentou o nome extraido e fez UMA pergunta (sobre US/PRD + ProductService) aguardando resposta antes de prosseguir."
+    }
+  ]
+}

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/with_skill/outputs/response.md

@@ -1,70 +1,70 @@
-# Resposta do sdd-task-plan-expert
-
-## Nome da Feature Extraido
-
-Da secao "1. Identificacao" do SPEC_TECH, campo "Feature/Projeto": **Cache de Cardapio em Memoria**
-
-Nome em kebab-case para diretorio: `cache-cardapio`
-
----
-
-## Analise Obrigatoria do Projeto (Resultados)
-
-### Passo 1: Rules lidas
-
-Li todos os arquivos de regras do projeto:
-- `CLAUDE.md` (raiz)
-- `.claude/rules/code-conventions.md` — codigo em ingles, banco/logs/erros em portugues
-- `.claude/rules/database.md` — SQLite WAL, migracoes imutaveis, nomenclatura em portugues
-- `.claude/rules/fx-di.md` — Uber FX, modulos exportados via `var Module = fx.Module(...)`
-- `.claude/rules/grpc.md` — handlers, mapeamento de erros, registro no server.go
-- `.claude/rules/protobuf.md` — Buf, convencao de go_package
-- `.claude/rules/repository.md` — interface + implementacao nao exportada, construtor recebe `*sql.DB`, mapeamento portugues->ingles
-- `.claude/rules/service.md` — interface + implementacao nao exportada, erros exportados em portugues, logging com zap
-- `.claude/rules/sqlc.md` — queries em `internal/db/queries/`, codigo gerado em `internal/db/sqlc/` (nao editar)
-
-### Passo 2: Codebase explorado
-
-**Descobertas criticas para o planejamento:**
-
-1. **NAO existe ProductService, ProductRepository, nem nenhum codigo de produto/cardapio no projeto.** O unico modulo implementado e o de User (service, repository, handler, migrations, queries).
-
-2. **NAO existe `internal/infra/cache/`** — o pacote de cache precisa ser criado do zero.
-
-3. **NAO existe campo `cache` no `configs/config.yaml`** nem na struct `Config` (`internal/infra/config/config.go`). Atualmente a struct tem apenas: `GRPCHost`, `GRPCPort`, `DatabasePath`, `JWTSecret`, `JWTExpirationHours`, `LogLevel`.
-
-4. **Padroes estabelecidos identificados:**
-   - FX modules: cada pacote exporta `var Module = fx.Module("nome", ...)`
-   - DI composition: `internal/infra/di/fx.go` lista todos os modulos
-   - Service pattern: interface publica + implementacao nao exportada + construtor `NewXxxService(repo, cfg, logger)`
-   - Repository pattern: interface publica + implementacao nao exportada + construtor `NewXxxRepository(db *sql.DB)`
-   - Testes: table-driven com testify/mock, mock definido no mesmo arquivo de teste
-   - Config: Viper com env prefix `APP_`, override via variaveis de ambiente
-
-5. **Tabelas existentes no banco:** `usuarios` (migracoes 001, 002). Nenhuma tabela `produtos`.
-
----
-
-## Problema Identificado: SPEC_TECH sem User Stories e sem PRD
-
-Antes de prosseguir, preciso levantar uma questao importante.
-
-O SPEC_TECH fornecido **nao contem User Stories (US-XX)** e **nao referencia nenhum PRD**. No framework SDD, o TASK PLAN exige uma tabela de rastreabilidade mapeando User Stories do PRD para Tasks. Alem disso, o guardrail #8 do skill diz: "Rastreabilidade obrigatoria — toda User Story do PRD deve ter pelo menos uma task correspondente."
-
-Alem disso, o SPEC_TECH menciona que "ProductService passa a consultar cache antes do repository", mas **nao existe nenhum ProductService no projeto atual**. O cache seria aplicado sobre um servico que ainda nao foi implementado.
-
-### Pergunta que eu faria ao usuario:
-
-> **Pergunta:** Identifiquei duas questoes no SPEC_TECH que precisam de esclarecimento antes de iniciarmos o TASK PLAN:
->
-> 1. **Ausencia de User Stories e PRD:** O SPEC_TECH nao contem User Stories (US-XX) nem referencia um PRD. O framework SDD exige rastreabilidade US -> Tasks no TASK PLAN. Como deseja proceder?
->    - **Opcao A:** Voce fornece o PRD com as User Stories para que eu faca a rastreabilidade completa.
->    - **Opcao B:** Criamos o TASK PLAN sem a tabela de rastreabilidade US -> Tasks, marcando a secao como "N/A — SPEC_TECH sem PRD/User Stories associados". As tasks serao derivadas diretamente das Definicoes Tecnicas do SPEC_TECH.
->    - **Opcao C:** Definimos User Stories simplificadas agora, antes de iniciar o planejamento.
->
-> 2. **ProductService inexistente:** O SPEC_TECH assume que existe um `ProductService` que "passa a consultar cache antes do repository", mas nao existe nenhum codigo de produto no projeto (nem service, nem repository, nem migration, nem queries). O escopo deste TASK PLAN deve:
->    - **Opcao A:** Incluir a criacao completa do modulo de produtos (migration, queries, repository, service, handler, proto) ALEM do cache — tornando o TASK PLAN significativamente maior.
->    - **Opcao B:** Limitar-se apenas a infraestrutura de cache generica (`Cache[K, V]`, config, modulo FX), sem integrar com ProductService, deixando a integracao para quando o modulo de produtos existir.
->    - **Opcao C:** Voce tem outro SPEC_TECH ou feature de produtos ja planejada que deve ser executada antes?
->
-> Aguardo sua resposta para prosseguir.
+# Resposta do sdd-task-plan-expert
+
+## Nome da Feature Extraido
+
+Da secao "1. Identificacao" do SPEC_TECH, campo "Feature/Projeto": **Cache de Cardapio em Memoria**
+
+Nome em kebab-case para diretorio: `cache-cardapio`
+
+---
+
+## Analise Obrigatoria do Projeto (Resultados)
+
+### Passo 1: Rules lidas
+
+Li todos os arquivos de regras do projeto:
+- `CLAUDE.md` (raiz)
+- `.claude/rules/code-conventions.md` — codigo em ingles, banco/logs/erros em portugues
+- `.claude/rules/database.md` — SQLite WAL, migracoes imutaveis, nomenclatura em portugues
+- `.claude/rules/fx-di.md` — Uber FX, modulos exportados via `var Module = fx.Module(...)`
+- `.claude/rules/grpc.md` — handlers, mapeamento de erros, registro no server.go
+- `.claude/rules/protobuf.md` — Buf, convencao de go_package
+- `.claude/rules/repository.md` — interface + implementacao nao exportada, construtor recebe `*sql.DB`, mapeamento portugues->ingles
+- `.claude/rules/service.md` — interface + implementacao nao exportada, erros exportados em portugues, logging com zap
+- `.claude/rules/sqlc.md` — queries em `internal/db/queries/`, codigo gerado em `internal/db/sqlc/` (nao editar)
+
+### Passo 2: Codebase explorado
+
+**Descobertas criticas para o planejamento:**
+
+1. **NAO existe ProductService, ProductRepository, nem nenhum codigo de produto/cardapio no projeto.** O unico modulo implementado e o de User (service, repository, handler, migrations, queries).
+
+2. **NAO existe `internal/infra/cache/`** — o pacote de cache precisa ser criado do zero.
+
+3. **NAO existe campo `cache` no `configs/config.yaml`** nem na struct `Config` (`internal/infra/config/config.go`). Atualmente a struct tem apenas: `GRPCHost`, `GRPCPort`, `DatabasePath`, `JWTSecret`, `JWTExpirationHours`, `LogLevel`.
+
+4. **Padroes estabelecidos identificados:**
+   - FX modules: cada pacote exporta `var Module = fx.Module("nome", ...)`
+   - DI composition: `internal/infra/di/fx.go` lista todos os modulos
+   - Service pattern: interface publica + implementacao nao exportada + construtor `NewXxxService(repo, cfg, logger)`
+   - Repository pattern: interface publica + implementacao nao exportada + construtor `NewXxxRepository(db *sql.DB)`
+   - Testes: table-driven com testify/mock, mock definido no mesmo arquivo de teste
+   - Config: Viper com env prefix `APP_`, override via variaveis de ambiente
+
+5. **Tabelas existentes no banco:** `usuarios` (migracoes 001, 002). Nenhuma tabela `produtos`.
+
+---
+
+## Problema Identificado: SPEC_TECH sem User Stories e sem PRD
+
+Antes de prosseguir, preciso levantar uma questao importante.
+
+O SPEC_TECH fornecido **nao contem User Stories (US-XX)** e **nao referencia nenhum PRD**. No framework SDD, o TASK PLAN exige uma tabela de rastreabilidade mapeando User Stories do PRD para Tasks. Alem disso, o guardrail #8 do skill diz: "Rastreabilidade obrigatoria — toda User Story do PRD deve ter pelo menos uma task correspondente."
+
+Alem disso, o SPEC_TECH menciona que "ProductService passa a consultar cache antes do repository", mas **nao existe nenhum ProductService no projeto atual**. O cache seria aplicado sobre um servico que ainda nao foi implementado.
+
+### Pergunta que eu faria ao usuario:
+
+> **Pergunta:** Identifiquei duas questoes no SPEC_TECH que precisam de esclarecimento antes de iniciarmos o TASK PLAN:
+>
+> 1. **Ausencia de User Stories e PRD:** O SPEC_TECH nao contem User Stories (US-XX) nem referencia um PRD. O framework SDD exige rastreabilidade US -> Tasks no TASK PLAN. Como deseja proceder?
+>    - **Opcao A:** Voce fornece o PRD com as User Stories para que eu faca a rastreabilidade completa.
+>    - **Opcao B:** Criamos o TASK PLAN sem a tabela de rastreabilidade US -> Tasks, marcando a secao como "N/A — SPEC_TECH sem PRD/User Stories associados". As tasks serao derivadas diretamente das Definicoes Tecnicas do SPEC_TECH.
+>    - **Opcao C:** Definimos User Stories simplificadas agora, antes de iniciar o planejamento.
+>
+> 2. **ProductService inexistente:** O SPEC_TECH assume que existe um `ProductService` que "passa a consultar cache antes do repository", mas nao existe nenhum codigo de produto no projeto (nem service, nem repository, nem migration, nem queries). O escopo deste TASK PLAN deve:
+>    - **Opcao A:** Incluir a criacao completa do modulo de produtos (migration, queries, repository, service, handler, proto) ALEM do cache — tornando o TASK PLAN significativamente maior.
+>    - **Opcao B:** Limitar-se apenas a infraestrutura de cache generica (`Cache[K, V]`, config, modulo FX), sem integrar com ProductService, deixando a integracao para quando o modulo de produtos existir.
+>    - **Opcao C:** Voce tem outro SPEC_TECH ou feature de produtos ja planejada que deve ser executada antes?
+>
+> Aguardo sua resposta para prosseguir.