adi_dev_workflow 1.3.0 → 1.4.0

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/benchmark.json

@@ -1,94 +0,0 @@
-{
-  "skill_name": "sdd-task-plan-expert",
-  "iteration": 2,
-  "date": "2026-03-08",
-  "configurations": [
-    {
-      "name": "with_skill",
-      "evals": [
-        {
-          "eval_id": 1,
-          "eval_name": "happy-path-spec-tech-usuario",
-          "assertions_passed": 5,
-          "assertions_total": 5,
-          "pass_rate": 1.0,
-          "tokens": 64193,
-          "duration_seconds": 125.6
-        },
-        {
-          "eval_id": 2,
-          "eval_name": "spec-tech-simples-alteracao-pontual",
-          "assertions_passed": 5,
-          "assertions_total": 5,
-          "pass_rate": 1.0,
-          "tokens": 85600,
-          "duration_seconds": 305.6
-        },
-        {
-          "eval_id": 3,
-          "eval_name": "spec-tech-sem-user-stories-explicitas",
-          "assertions_passed": 5,
-          "assertions_total": 5,
-          "pass_rate": 1.0,
-          "tokens": 58132,
-          "duration_seconds": 136.9
-        }
-      ],
-      "aggregate": {
-        "total_passed": 15,
-        "total_assertions": 15,
-        "pass_rate": 1.0,
-        "mean_tokens": 69308,
-        "stddev_tokens": 14283,
-        "mean_duration_seconds": 189.4,
-        "stddev_duration_seconds": 101.4
-      }
-    },
-    {
-      "name": "without_skill",
-      "evals": [
-        {
-          "eval_id": 1,
-          "eval_name": "happy-path-spec-tech-usuario",
-          "assertions_passed": 1,
-          "assertions_total": 5,
-          "pass_rate": 0.2,
-          "tokens": 69814,
-          "duration_seconds": 347.3
-        },
-        {
-          "eval_id": 2,
-          "eval_name": "spec-tech-simples-alteracao-pontual",
-          "assertions_passed": 1,
-          "assertions_total": 5,
-          "pass_rate": 0.2,
-          "tokens": 61206,
-          "duration_seconds": 143.3
-        },
-        {
-          "eval_id": 3,
-          "eval_name": "spec-tech-sem-user-stories-explicitas",
-          "assertions_passed": 2,
-          "assertions_total": 5,
-          "pass_rate": 0.4,
-          "tokens": 36808,
-          "duration_seconds": 147.5
-        }
-      ],
-      "aggregate": {
-        "total_passed": 4,
-        "total_assertions": 15,
-        "pass_rate": 0.267,
-        "mean_tokens": 55943,
-        "stddev_tokens": 17257,
-        "mean_duration_seconds": 212.7,
-        "stddev_duration_seconds": 117.2
-      }
-    }
-  ],
-  "delta": {
-    "pass_rate": "+73.3pp",
-    "mean_tokens": "+13365 (+23.9%)",
-    "mean_duration_seconds": "-23.3s (-11.0%)"
-  }
-}

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/benchmark.md

@@ -1,67 +0,0 @@
-# Benchmark — sdd-task-plan-expert (Iteration 2)
-
-## Resumo
-
-| Metrica | with_skill | without_skill | Delta |
-|---------|-----------|---------------|-------|
-| **Pass Rate** | **100.0%** (15/15) | 26.7% (4/15) | **+73.3pp** |
-| Mean Tokens | 69,308 ± 14,283 | 55,943 ± 17,257 | +13,365 (+23.9%) |
-| Mean Duration | 189.4s ± 101.4s | 212.7s ± 117.2s | -23.3s (-11.0%) |
-
-## Comparacao com Iteration 1
-
-| Metrica | Iter 1 with_skill | Iter 2 with_skill | Melhoria |
-|---------|-------------------|-------------------|----------|
-| **Pass Rate** | 93.3% (14/15) | **100.0% (15/15)** | **+6.7pp** |
-| Assertion a4 (rules) | FAIL | **PASS** | Corrigido |
-
-## Resultados por Eval
-
-### Eval 1: Happy Path (SPEC_TECH do modulo de usuario)
-
-| Assertion | with_skill | without_skill |
-|-----------|-----------|---------------|
-| a1: Extrai nome e confirma | PASS | FAIL |
-| a2: Uma pergunta por vez | PASS | FAIL |
-| a3: Propoe macro-fases | PASS | FAIL |
-| a4: Le rules ANTES | **PASS** | FAIL |
-| a5: Nao executa automaticamente | PASS | PASS |
-
-### Eval 2: Spec Simples (alteracao pontual — telefone)
-
-| Assertion | with_skill | without_skill |
-|-----------|-----------|---------------|
-| b1: 3-6 tasks proporcionais | PASS (6) | FAIL (7) |
-| b2: Ordem de dependencias | PASS | PASS |
-| b3: Rastreabilidade US-10 | PASS | FAIL |
-| b4: Template completo (8 secoes) | PASS | FAIL |
-| b5: task_plan.md de referencia | PASS | FAIL |
-
-### Eval 3: Sem User Stories (cache de cardapio)
-
-| Assertion | with_skill | without_skill |
-|-----------|-----------|---------------|
-| c1: Detecta ausencia de US | PASS | PASS |
-| c2: Pergunta ao usuario | PASS | FAIL |
-| c3: Nao inventa US ficticias | PASS | PASS |
-| c4: Nome em kebab-case | PASS | FAIL |
-| c5: Processo interativo | PASS | FAIL |
-
-## Analise
-
-### Melhoria Principal (Iteration 1 → 2)
-A unica assertion que falhava na iteration 1 (a4: leitura de rules) foi corrigida. O transcript da eval 1 mostra explicitamente "Passo 1 -- Read ALL project rules" com lista de 9 arquivos lidos ANTES da exploracao do codebase. A correcao (separar Passo 1 e Passo 2 no SKILL.md) funcionou.
-
-### Assertions Discriminantes
-- **a4** (rules) era o unico discriminante na iteration 1 para with_skill. Agora esta corrigido.
-- Todas as 15 assertions passam com a skill — 100% pass rate.
-- Baseline (without_skill) consistentemente falha em: processo interativo, template compliance, rastreabilidade e kebab-case.
-
-### Assertions Nao-Discriminantes
-- **a5** (nao executa automaticamente): Passa em ambas as configuracoes em todas as evals.
-- **c1** (detecta ausencia de US) e **c3** (nao inventa US): Passam em ambas.
-
-### Tokens e Tempo
-- with_skill usa ~24% mais tokens em media, mas completa ~11% mais rapido.
-- A variancia e alta (stddev ~100s) devido a diferenca de complexidade entre evals.
-- Eval 2 com skill levou 305s (mais longo) — provavelmente por gerar 6 tasks completas com template de 8 secoes.

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/eval_metadata.json

@@ -1,12 +0,0 @@
-{
-  "eval_id": 1,
-  "eval_name": "happy-path-spec-tech-usuario",
-  "prompt": "Gere o TASK PLAN para a feature de usuario. O SPEC_TECH aprovado esta em docs/feature-user/v1/spec_tech.md",
-  "assertions": [
-    {"id": "a1", "text": "Extrai o nome da feature do SPEC_TECH e confirma com o usuario antes de prosseguir", "type": "llm_judge"},
-    {"id": "a2", "text": "Faz apenas UMA pergunta por vez (nao bombardeia com multiplas perguntas no mesmo turno)", "type": "llm_judge"},
-    {"id": "a3", "text": "Propoe macro-fases de alto nivel e aguarda validacao antes de criar tasks", "type": "llm_judge"},
-    {"id": "a4", "text": "Le as rules do projeto (.claude/rules/ e CLAUDE.md) ANTES de gerar tasks", "type": "llm_judge"},
-    {"id": "a5", "text": "NAO inicia execucao automatica de tasks — apenas apresenta o plano e aguarda", "type": "llm_judge"}
-  ]
-}

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/with_skill/grading.json

@@ -1,32 +0,0 @@
-{
-  "eval_id": 1,
-  "eval_name": "happy-path-spec-tech-usuario",
-  "configuration": "with_skill",
-  "expectations": [
-    {
-      "text": "Extrai o nome da feature do SPEC_TECH e confirma com o usuario antes de prosseguir",
-      "passed": true,
-      "evidence": "Extraiu 'feature-user' da secao 1 do SPEC_TECH e perguntou 'Podemos iniciar a definicao macro das fases conforme proposto acima? Deseja ajustar algo na estrutura de fases?'"
-    },
-    {
-      "text": "Faz apenas UMA pergunta por vez (nao bombardeia com multiplas perguntas no mesmo turno)",
-      "passed": true,
-      "evidence": "Apenas uma pergunta ao final da primeira interacao, aguardando validacao das macro-fases."
-    },
-    {
-      "text": "Propoe macro-fases de alto nivel e aguarda validacao antes de criar tasks",
-      "passed": true,
-      "evidence": "Propos 5 macro-fases (Fundacao, Dados, Negocio, Apresentacao, Testes) com 11 tasks estimadas e aguardou confirmacao."
-    },
-    {
-      "text": "Le as rules do projeto (.claude/rules/ e CLAUDE.md) ANTES de gerar tasks",
-      "passed": true,
-      "evidence": "Transcript mostra 'Passo 1 -- Read ALL project rules' com lista explicita de CLAUDE.md + 8 arquivos .claude/rules/. Executado ANTES da exploracao do codebase (Passo 2)."
-    },
-    {
-      "text": "NAO inicia execucao automatica de tasks — apenas apresenta o plano e aguarda",
-      "passed": true,
-      "evidence": "Explicitamente diz 'Esta e a PRIMEIRA interacao do processo. Nas proximas interacoes, seriam destrinchadas as tasks...' — nao executou nenhuma task."
-    }
-  ]
-}

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/with_skill/outputs/response.md

@@ -1,117 +0,0 @@
-# Resposta — TASK PLAN para Feature de Usuario
-
-## 1. Feature Identificada
-
-Extraido da secao "1. Visao Geral Tecnica" do SPEC_TECH:
-
-- **Feature**: Modulo de Usuario -- Vakinha Burger
-- **Nome normalizado (kebab-case)**: `feature-user`
-- **Versao**: v1
-- **SPEC_TECH**: `docs/feature-user/v1/spec_tech.md`
-- **PRD**: `docs/feature-user/v1/prd.md`
-
----
-
-## 2. Confirmacao e Proposta de Macro-Fases
-
-Obrigado! Vamos iniciar o TASK PLAN para **Modulo de Usuario -- Vakinha Burger**.
-
-### Analise do Codebase (achados criticos)
-
-Antes de propor as fases, realizei a analise obrigatoria do projeto (Passo 1 e Passo 2 do SKILL.md):
-
-**Passo 1 -- Rules lidas:**
-- `CLAUDE.md` (raiz)
-- `.claude/rules/code-conventions.md`
-- `.claude/rules/database.md`
-- `.claude/rules/fx-di.md`
-- `.claude/rules/grpc.md`
-- `.claude/rules/protobuf.md`
-- `.claude/rules/repository.md`
-- `.claude/rules/service.md`
-- `.claude/rules/sqlc.md`
-
-**Passo 2 -- Exploracao do codebase:**
-
-Identifiquei que **a feature ja esta integralmente implementada** no branch atual (`user-feature`). Todos os arquivos referenciados no SPEC_TECH ja existem e contem o codigo completo:
-
-| Componente | Arquivo | Estado |
-|------------|---------|--------|
-| Identity package | `internal/pkg/identity/identity.go` | JA EXISTE -- Claims, GenerateToken, ParseToken, WithUserID, UserIDFromContext |
-| Identity tests | `internal/pkg/identity/identity_test.go` | JA EXISTE |
-| Auth interceptor | `internal/infra/grpc/interceptors/auth.go` | JA EXISTE -- Login em skipMethods, usa identity.ParseToken, injeta user_id |
-| Auth interceptor tests | `internal/infra/grpc/interceptors/auth_test.go` | JA EXISTE |
-| Migration 002 | `internal/db/migrations/002_add_endereco_usuarios.sql` | JA EXISTE |
-| User repository | `internal/repository/user_repository.go` | JA EXISTE -- Create, GetByID, GetByEmail, Update, modelo User com Address |
-| Repository integration tests | `internal/repository/user_repository_integration_test.go` | JA EXISTE |
-| User service | `internal/service/user_service.go` | JA EXISTE -- CreateUser, Login, GetUserLogged, UpdateUser, todos os erros, todas as validacoes |
-| User service tests | `internal/service/user_service_test.go` | JA EXISTE |
-| User handler | `internal/handler/grpc/user_handler.go` | JA EXISTE -- CreateUser, Login, GetUserLogged, UpdateUser, mapServiceError |
-| User handler tests | `internal/handler/grpc/user_handler_test.go` | JA EXISTE |
-| Config | `internal/infra/config/config.go` | JA EXISTE -- JWTExpirationHours |
-| E2E tests | `internal/e2e/user_e2e_test.go` | JA EXISTE |
-
-**Conclusao da analise**: Como todo o codigo ja existe, o TASK PLAN que seria gerado teria TODAS as tasks com status "Concluido". Isso muda significativamente a natureza do plano.
-
----
-
-### Proposta de Macro-Fases
-
-Apesar de a implementacao ja existir, apresento as macro-fases que TERIAM sido utilizadas para decompor esta feature, conforme o SPEC_TECH:
-
-**Fase 1 -- Fundacao e Infraestrutura**
-- Objetivo: Criar os alicerces tecnicos que nao dependem de logica de negocio
-- Escopo: pacote `identity` (JWT), migration 002, configuracao (`JWTExpirationHours`), queries SQLC, geracao de codigo (`make generate`)
-- Tasks estimadas: T1 (identity package), T2 (migration + queries SQLC + make generate), T3 (config)
-
-**Fase 2 -- Camada de Dados**
-- Objetivo: Implementar o acesso a dados completo (repository)
-- Escopo: Adicionar `Address` ao modelo `User`, implementar `GetByEmail()` e `Update()`, atualizar `Create()`
-- Tasks estimadas: T4 (repository)
-
-**Fase 3 -- Logica de Negocio**
-- Objetivo: Implementar todas as regras de negocio no service
-- Escopo: `CreateUser` (validacoes completas), `Login`, `GetUserLogged`, `UpdateUser`, erros de dominio
-- Tasks estimadas: T5 (CreateUser atualizado + Login), T6 (GetUserLogged + UpdateUser)
-
-**Fase 4 -- Camada de Apresentacao**
-- Objetivo: Implementar handlers gRPC e atualizar o contrato proto
-- Escopo: proto atualizado, handlers `Login`, `GetUserLogged`, `UpdateUser`, `mapServiceError`, interceptor atualizado
-- Tasks estimadas: T7 (proto + make generate), T8 (handlers + interceptor)
-
-**Fase 5 -- Testes e Validacao**
-- Objetivo: Garantir cobertura de testes em todas as camadas
-- Escopo: testes unitarios (identity, service, handler, interceptor), testes de integracao (repository, migration), testes E2E
-- Tasks estimadas: T9 (testes unitarios), T10 (testes integracao), T11 (testes E2E)
-
-### Rastreabilidade US -> Fases
-
-| User Story | Fases Envolvidas |
-|------------|-----------------|
-| US-01 (Cadastro) | Fase 1, 2, 3, 4, 5 |
-| US-02 (Login) | Fase 1, 3, 4, 5 |
-| US-03 (Consultar dados) | Fase 1, 3, 4, 5 |
-| US-04 (Atualizar dados) | Fase 2, 3, 4, 5 |
-
-### Paralelismo Identificado
-
-- T1 (identity), T2 (migration/SQLC), T3 (config) podem rodar em **paralelo** (Fase 1)
-- T5 e T6 sao sequenciais (T6 depende de T5 para erros e tipos compartilhados)
-- T7 deve rodar antes de T8 (handlers dependem do proto gerado)
-- T9, T10, T11 podem rodar em **paralelo** (Fase 5), mas todas dependem de T1-T8
-
----
-
-## Pergunta ao Usuario
-
-> Podemos iniciar a definicao macro das fases conforme proposto acima? Deseja ajustar algo na estrutura de fases, no agrupamento de tasks ou na ordem de dependencias?
-
-### Resposta Simulada (eval -- sem usuario real)
-
-Como esta e uma execucao de avaliacao sem usuario real, assumo que o usuario responderia:
-
-> "Sim, pode seguir com essas fases. A estrutura esta boa."
-
----
-
-**Nota**: Esta e a PRIMEIRA interacao do processo. Nas proximas interacoes, seriam destrinchadas as tasks fase a fase, com criacao dos arquivos `tasks/TN.md` e, ao final, o `task_plan.md` de referencia. Conforme instrucoes do eval, paro aqui na primeira interacao.

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/with_skill/outputs/transcript.md

@@ -1,91 +0,0 @@
-# Transcript -- Tool Calls
-
-## 1. Read skill and templates (parallel)
-
-| Tool | Parameters |
-|------|-----------|
-| Read | `.claude/skills/sdd-task-plan-expert/SKILL.md` |
-| Read | `.claude/skills/sdd-task-plan-expert/templates/task_plan_template.md` |
-| Read | `.claude/skills/sdd-task-plan-expert/templates/task_template.md` |
-| Read | `docs/feature-user/v1/spec_tech.md` |
-
-> SKILL.md was read in full. Templates were read in full. SPEC_TECH triggered persisted-output due to size (49.8KB).
-
-## 2. Read full SPEC_TECH (persisted output)
-
-| Tool | Parameters |
-|------|-----------|
-| Read | Persisted output file (full SPEC_TECH content) |
-
-> Still truncated. Proceeded with offset-based reads.
-
-## 3. Read SPEC_TECH in chunks
-
-| Tool | Parameters |
-|------|-----------|
-| Read | `docs/feature-user/v1/spec_tech.md`, offset=1, limit=200 |
-| Read | `docs/feature-user/v1/spec_tech.md`, offset=200, limit=300 |
-| Read | `docs/feature-user/v1/spec_tech.md`, offset=498, limit=200 |
-| Read | `docs/feature-user/v1/spec_tech.md`, offset=697, limit=200 |
-
-> Sections 1-16 of the SPEC_TECH were fully read.
-
-## 4. Passo 1 -- Read ALL project rules
-
-Rules already loaded from system-reminder context (CLAUDE.md and all .claude/rules/* files were provided as context). Confirmed reading:
-- `CLAUDE.md`
-- `.claude/rules/code-conventions.md`
-- `.claude/rules/database.md`
-- `.claude/rules/fx-di.md`
-- `.claude/rules/grpc.md`
-- `.claude/rules/protobuf.md`
-- `.claude/rules/repository.md`
-- `.claude/rules/service.md`
-- `.claude/rules/sqlc.md`
-
-## 5. Passo 2 -- Explore codebase (parallel)
-
-| Tool | Parameters |
-|------|-----------|
-| Glob | pattern=`**/*.go`, path=project root |
-| Glob | pattern=`internal/db/migrations/*`, path=project root |
-| Glob | pattern=`internal/db/queries/*`, path=project root |
-
-> Found 24 Go files. Found 2 migration files. No query files in `internal/db/queries/` (queries are in `internal/db/sqlc/queries/`).
-
-## 6. Read existing implementation files (parallel)
-
-| Tool | Parameters |
-|------|-----------|
-| Read | `internal/repository/user_repository.go` |
-| Read | `internal/service/user_service.go` |
-| Read | `internal/handler/grpc/user_handler.go` |
-| Read | `internal/infra/grpc/interceptors/auth.go` |
-| Read | `internal/infra/config/config.go` |
-| Read | `internal/pkg/identity/identity.go` |
-
-> All 6 files read successfully. Confirmed that the entire feature is already implemented.
-
-## 7. Create output directory
-
-| Tool | Parameters |
-|------|-----------|
-| Bash | `mkdir -p ...outputs/` |
-
-## 8. Write output files
-
-| Tool | Parameters |
-|------|-----------|
-| Write | `response.md` -- main response with feature name confirmation and macro-phases |
-| Write | `transcript.md` -- this file |
-
----
-
-## Summary of Findings
-
-- **Feature name extracted**: "Modulo de Usuario -- Vakinha Burger" from SPEC_TECH section 1
-- **Feature directory**: `feature-user` (already exists at `docs/feature-user/v1/`)
-- **Critical finding**: The entire feature is already implemented in the codebase. All files referenced in sections 3.1 and 15 of the SPEC_TECH exist with complete implementations.
-- **Macro-phases proposed**: 5 phases (Fundacao, Dados, Negocio, Apresentacao, Testes) with 11 tasks
-- **User Stories covered**: US-01 through US-04, all mapped to phases
-- **First interaction completed**: Feature name confirmed + macro-phases proposed + awaiting user confirmation

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/with_skill/timing.json

@@ -1 +0,0 @@
-{"total_tokens": 64193, "duration_ms": 125607, "total_duration_seconds": 125.6}

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/without_skill/grading.json

@@ -1,32 +0,0 @@
-{
-  "eval_id": 1,
-  "eval_name": "happy-path-spec-tech-usuario",
-  "configuration": "without_skill",
-  "expectations": [
-    {
-      "text": "Extrai o nome da feature do SPEC_TECH e confirma com o usuario antes de prosseguir",
-      "passed": false,
-      "evidence": "Gerou o task plan completo com 12 tasks sem confirmar o nome da feature com o usuario. Identificou 'Modulo de Usuario v1' mas nao perguntou se estava correto."
-    },
-    {
-      "text": "Faz apenas UMA pergunta por vez (nao bombardeia com multiplas perguntas no mesmo turno)",
-      "passed": false,
-      "evidence": "Nenhuma pergunta foi feita ao usuario. O output completo (695 linhas) foi gerado de uma vez sem interacao."
-    },
-    {
-      "text": "Propoe macro-fases de alto nivel e aguarda validacao antes de criar tasks",
-      "passed": false,
-      "evidence": "Pulou diretamente para tasks detalhadas (TASK 01-12) sem propor macro-fases primeiro e aguardar validacao."
-    },
-    {
-      "text": "Le as rules do projeto (.claude/rules/ e CLAUDE.md) ANTES de gerar tasks",
-      "passed": false,
-      "evidence": "Transcript mostra apenas leitura do SPEC_TECH e arquivos de implementacao. Nenhuma leitura de .claude/rules/ ou CLAUDE.md foi registrada."
-    },
-    {
-      "text": "NAO inicia execucao automatica de tasks — apenas apresenta o plano e aguarda",
-      "passed": true,
-      "evidence": "Apresentou apenas o plano sem executar nenhuma task."
-    }
-  ]
-}