@polymorphism-tech/morph-spec 7.7.2 → 7.8.0

package/README.md

@@ -3,7 +3,7 @@
 > Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
 
 **Package:** `@polymorphism-tech/morph-spec`
-**Version:** 7.7.2  
+**Version:** 7.8.0  
 **Requires:** Node.js 22+, Claude Code
 
 ---
@@ -365,4 +365,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v7.7.2 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v7.8.0 by [Polymorphism Tech](https://polymorphism.tech)*

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "7.7.2",
+  "version": "7.8.0",
   "displayName": "MORPH-SPEC Framework",
   "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
   "publisher": "polymorphism-tech",

package/docs/CHEATSHEET.md

@@ -196,4 +196,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
 
 ---
 
-*morph-spec v7.7.2 by Polymorphism Tech*
+*morph-spec v7.8.0 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -197,4 +197,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v7.7.2 by Polymorphism Tech*
+*morph-spec v7.8.0 by Polymorphism Tech*

package/framework/CLAUDE.md

@@ -17,7 +17,7 @@ Se não houver feature ativa, pergunte ao usuário qual feature trabalhar.
 - Modificar o contrato do plano depois do Gate 2: `spec.md`, `mandate.md`, e os campos de plano de `tasks.json` (`title`, `description`, `dependencies`, `effort`, `doneCriteria`, `group`) estão congelados.
 - Tocar os campos de contrato do plano em `tasks.json` após o Gate 2 (`title`, `description`, `dependencies`, `effort`, `doneCriteria`, `group`) — o hook `protect-spec-files` faz diff semântico e bloqueia mudanças neles, seja via `Write` ou `Edit`. (Os campos mutáveis `status`/`outputs`/`notes` continuam graváveis por `Write` ou `Edit` — ver SEMPRE.)
 - Listar perguntas em texto simples — sempre use a tool `AskUserQuestion` (1-4 perguntas por chamada).
-- Usar `Guid.NewGuid()`, classes não-sealed sem justificativa, exceptions como fluxo de controle, camada de Service/Manager entre handler e dados, ou SQL cru sem justificativa.
+- Usar `Guid.NewGuid()`, classes não-sealed sem justificativa, exceptions como fluxo de controle, camada de Service/Manager entre handler e dados, repository genérico (`IRepository<T>`/`IUnitOfWork`), ou SQL cru sem justificativa.
 
 **SEMPRE:**
 - Auto-advance entre tarefas durante a fase implement — não pause sem ambiguidade bloqueante.

package/framework/MORPH.md

@@ -48,10 +48,11 @@ Padrões proibidos automaticamente injetados no mandate:
 - `Guid.NewGuid()` → `Guid.CreateVersion7()`
 - Classes não-sealed sem justificativa
 - Exceptions como fluxo de controle
-- Camada de Service/Manager entre handler e dados — o handler fala com `IRepository<T>` ou `DbContext`, nunca com um service
+- Camada de Service/Manager entre handler e dados — o handler fala com o `ApplicationDbContext` direto, nunca com um service
+- Repository genérico (`IRepository<T>`/`IUnitOfWork`) — redundante sobre EF Core: `DbSet<T>` já é repository, `DbContext` já é unit of work
 - SQL cru (`FromSqlRaw`, `ExecuteQuery(string)`) sem justificativa em `decisions.md` — use LINQ
 
-Acesso a dados em VSA é híbrido: `IRepository<T>` + `IUnitOfWork` para CRUD simples; `ApplicationDbContext` injetado direto no slice quando a query for específica (joins, projeção, paginação, filtros compostos).
+Acesso a dados em VSA: o handler injeta `ApplicationDbContext` direto no slice — `DbSet<T>` já é repository, `DbContext` já é unit of work. Para concorrência ou SQL específico, crie um store dedicado hand-written com justificativa em `decisions.md`. NUNCA camada de Service/Manager; NUNCA repository genérico.
 
 ---
 

package/framework/agents.json

@@ -22,7 +22,7 @@
         "backend-dotnet-fluent-validation-vsa"
       ],
       "mcp": ["context7"],
-      "persona": "Você é um engenheiro .NET sênior. Pensa em VSA com handlers diretos, result pattern, sealed classes, Guid.CreateVersion7(). Acesso a dados híbrido: IRepository<T> + IUnitOfWork para CRUD, DbContext direto no slice para queries específicas; nunca uma camada de Service/Manager. Não usa exceptions como fluxo. Consulta o standard antes de escrever cada slice. Nomeia tudo em PascalCase para tipos, camelCase para parâmetros."
+      "persona": "Você é um engenheiro .NET sênior. Pensa em VSA com handlers diretos, result pattern, sealed classes, Guid.CreateVersion7(). Acesso a dados: ApplicationDbContext injetado direto no slice (DbSet<T> já é repository, DbContext já é unit of work); para concorrência ou SQL específico, store dedicado hand-written com justificativa em decisions.md; nunca uma camada de Service/Manager; nunca repository genérico (IRepository<T>/IUnitOfWork). Não usa exceptions como fluxo. Consulta o standard antes de escrever cada slice. Nomeia tudo em PascalCase para tipos, camelCase para parâmetros."
     },
     "ef-modeler": {
       "title": "EF Core / Database Modeler",

package/framework/evals/scenarios/dotnet-crud.yaml

@@ -28,7 +28,7 @@ dimensions:
   spec:
     specificity: "API contracts with sealed record DTOs, Result<T> return types, FluentValidation rules, specific HTTP status codes"
     data_model: "Product entity with all fields, EF Core configuration, Neon PostgreSQL constraints"
-    architecture: "VSA feature folders, IHandler pattern, Scrutor pipeline, IApiEndpoint discovery, Repository/UnitOfWork"
+    architecture: "VSA feature folders, IHandler pattern, Scrutor pipeline, IApiEndpoint discovery, ApplicationDbContext direto no slice (sem repository genérico)"
     completeness: "All CRUD endpoints, pagination params (page/pageSize), search filters, error responses via Result<T>"
   tasks:
     granularity: "Each task 15-60 minutes, no mega-tasks"

package/framework/rules/dotnet-templates.md

@@ -73,7 +73,6 @@ For each new feature slice, follow the patterns in these templates:
 
 | Template | Path | Purpose |
 |----------|------|---------|
-| Repository | `.morph/framework/templates/code/dotnet/backend/repository.cs` | EF Core repository |
 | Migration | `.morph/framework/templates/code/dotnet/database/migration.cs` | EF Core migration |
 | Hangfire Job | `.morph/framework/templates/code/dotnet/jobs/job.cs` | Background job |
 | MAF Agent | `.morph/framework/templates/code/dotnet/jobs/agent.cs` | MS Agent Framework |

package/framework/skills/core/create-umbraco-lp/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a criação de uma landing page nova ponta-a-ponta a partir do
 version: core
 when-to-invoke: ao iniciar um novo projeto de LP com o template Umbraco genérico
 user-invokable: true
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # create-umbraco-lp

package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md

@@ -4,7 +4,7 @@ description: Migra uma landing page existente (React/Vite, Next.js estático ou
 version: core
 when-to-invoke: ao receber instrução "use /migrate-lp-to-umbraco {projeto}" do usuário, ou quando o usuário descrever necessidade de migrar uma LP para Umbraco
 user-invokable: true
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # migrate-lp-to-umbraco

package/framework/skills/core/morph-apply/SKILL.md

@@ -4,7 +4,7 @@ description: Orquestra a execução autônoma de tasks de uma feature morph-spec
 version: core
 when-to-invoke: após Gate 2 aprovado, ao receber instrução "use /morph-apply" ou "implementar feature"
 user-invokable: true
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # morph-apply

package/framework/skills/core/morph-brainstorming/SKILL.md

@@ -4,7 +4,7 @@ description: Entende o negócio, os usuários e a arquitetura antes de qualquer
 version: core
 when-to-invoke: ao receber um novo request de feature, antes de morph-plan
 user-invokable: true
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # morph-brainstorming
@@ -27,7 +27,7 @@ O harness conhece o stack por padrão. Não pergunte sobre tecnologia a menos qu
 | Frontend | Next.js App Router + Tailwind + Framer Motion + Shadcn |
 | Jobs async | Hangfire — apenas se a feature requer processamento em background |
 
-**Padrões proibidos:** `Guid.NewGuid()`, classes não-sealed sem justificativa, exceptions sem result pattern, camada de Service/Manager entre handler e dados, SQL cru sem justificativa. Acesso a dados em VSA é híbrido: `IRepository<T>` + `IUnitOfWork` para CRUD; `DbContext` direto no slice para queries específicas.
+**Padrões proibidos:** `Guid.NewGuid()`, classes não-sealed sem justificativa, exceptions sem result pattern, camada de Service/Manager entre handler e dados, repository genérico (`IRepository<T>`/`IUnitOfWork`), SQL cru sem justificativa. Acesso a dados em VSA: `ApplicationDbContext` direto no slice (`DbSet<T>` já é repository, `DbContext` já é unit of work); para concorrência ou SQL específico, store dedicado hand-written com justificativa em `decisions.md`.
 
 ## O que fazer
 

package/framework/skills/core/morph-eval/SKILL.md

@@ -4,7 +4,7 @@ description: Avalia a qualidade de uma tarefa ou fase com rubricas graduadas 0-1
 version: core
 when-to-invoke: ao completar uma tarefa ou ao finalizar uma fase de implementação
 user-invokable: false
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # morph-eval

package/framework/skills/core/morph-implement/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a execução de cada tarefa de implementação com standard e
 version: core
 when-to-invoke: ao iniciar cada task de implementação listada em tasks.json
 user-invokable: false
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # morph-implement

package/framework/skills/core/morph-plan/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a produção dos três artefatos de planejamento de uma featur
 version: core
 when-to-invoke: ao iniciar a fase plan de uma feature, após o Gate 1 (proposal aprovado)
 user-invokable: true
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # morph-plan
@@ -34,9 +34,10 @@ Ao iniciar a fase plan — após o `proposal.md` ser aprovado e antes de qualque
      - `Guid.NewGuid()` → usar `Guid.CreateVersion7()`
      - Classes não-sealed sem justificativa documentada
      - Exceptions como fluxo de controle → usar result pattern com `result.Match()`
-     - Camada de Service/Manager entre handler e dados → handler usa `IRepository<T>` ou `DbContext` direto
+     - Camada de Service/Manager entre handler e dados → handler usa `ApplicationDbContext` direto no slice
+     - Repository genérico (`IRepository<T>`/`IUnitOfWork`) → redundante sobre EF Core: `DbSet<T>` já é repository, `DbContext` já é unit of work
      - SQL cru (`FromSqlRaw`, `ExecuteQuery(string)`) sem justificativa em `decisions.md` → usar LINQ
-   - Política de acesso a dados (registre no mandate como orientação, não proibição): `IRepository<T>` + `IUnitOfWork` para CRUD simples; `ApplicationDbContext` injetado direto no slice para queries específicas (joins, projeção, paginação).
+   - Política de acesso a dados (registre no mandate): `ApplicationDbContext` injetado direto no slice — para CRUD e para queries específicas (joins, projeção, paginação). Para concorrência ou SQL específico, store dedicado hand-written com justificativa em `decisions.md`.
    - **Features com agentes de IA (MAF):** se a feature envolve um agente (Microsoft Agent Framework), **use a tool Read** nos standards relevantes de `framework/standards/ai-agents/*.md` (ex.: `setup`, `agent-session`, `middleware-patterns`, `mcp-server`, `mcp-tools`, `multi-agent-patterns`, `production`) — filtre pelo que a feature exige via STANDARDS.json. Esses standards carregam as **convenções de projeto** (single-agent por padrão — Workflows só para fan-in/out real; provider, caching, observability, A2A) que uma fonte externa de docs (ex.: context7) não conhece. Padrão de divisão: **superfície da API** pode vir de docs ao vivo/context7 (mais frescas para um SDK em evolução), mas **as convenções vêm dos standards** — registre ambas no mandate. Não pule os `ai-agents/*.md` só porque o STANDARDS.json index lista que eles existem.
    - Checklist de done com critérios verificáveis por tarefa.
 

package/framework/skills/core/morph-proposal/SKILL.md

@@ -4,7 +4,7 @@ description: Orquestra a fase de proposta+plano de uma feature morph-spec. Encad
 version: core
 when-to-invoke: ao receber instrução "use /morph-proposal" do usuário, ou ao iniciar uma nova feature
 user-invokable: true
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # morph-proposal

package/framework/skills/core/morph-review/SKILL.md

@@ -4,7 +4,7 @@ description: Conduz a fase de revisão e produz o review-report.md para o Gate 3
 version: core
 when-to-invoke: ao iniciar a fase review, após todas as tasks de tasks.json estarem com status `done`
 user-invokable: true
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # morph-review

package/framework/skills/core/morph-stack-scan/SKILL.md

@@ -4,7 +4,7 @@ description: Varre o codebase existente, detecta stack atual, compara com o stac
 version: core
 when-to-invoke: ao iniciar uma feature em projeto brownfield (codebase já existente)
 user-invokable: true
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # morph-stack-scan
@@ -29,7 +29,7 @@ Quando o projeto já tem código existente e você precisa entender o estado atu
 | Frontend | Next.js App Router + Tailwind + Framer Motion + Shadcn |
 | Jobs | Hangfire (apenas quando necessário) |
 
-**Padrões proibidos:** `Guid.NewGuid()`, classes não-sealed sem justificativa, exceptions como fluxo de controle, camada de Service/Manager entre handler e dados, SQL cru sem justificativa. Acesso a dados em VSA é híbrido: `IRepository<T>` + `IUnitOfWork` para CRUD; `DbContext` direto no slice para queries específicas.
+**Padrões proibidos:** `Guid.NewGuid()`, classes não-sealed sem justificativa, exceptions como fluxo de controle, camada de Service/Manager entre handler e dados, repository genérico (`IRepository<T>`/`IUnitOfWork`), SQL cru sem justificativa. Acesso a dados em VSA: `ApplicationDbContext` direto no slice (`DbSet<T>` já é repository, `DbContext` já é unit of work); para concorrência ou SQL específico, store dedicado hand-written com justificativa em `decisions.md`.
 
 ## Greenfield short-circuit
 
@@ -62,7 +62,7 @@ Antes de despachar Explore, verifique se o projeto é greenfield:
    - Erros: Result pattern (`result.Match()`)
 
    ## Padrões proibidos
-   `Guid.NewGuid()`, classes não-sealed sem justificativa, exceptions como fluxo de controle, camada de Service/Manager entre handler e dados, SQL cru sem justificativa. Acesso a dados em VSA é híbrido: `IRepository<T>` + `IUnitOfWork` para CRUD; `DbContext` direto no slice para queries específicas.
+   `Guid.NewGuid()`, classes não-sealed sem justificativa, exceptions como fluxo de controle, camada de Service/Manager entre handler e dados, repository genérico (`IRepository<T>`/`IUnitOfWork`), SQL cru sem justificativa. Acesso a dados em VSA: `ApplicationDbContext` direto no slice (`DbSet<T>` já é repository, `DbContext` já é unit of work); para concorrência ou SQL específico, store dedicado hand-written com justificativa em `decisions.md`.
 
    ## Recomendação
    Compliance trivial (greenfield). Prosseguir para morph-brainstorming.
@@ -82,7 +82,7 @@ Antes de despachar Explore, verifique se o projeto é greenfield:
    BACKEND:
    - Todos os .csproj: qual TargetFramework? Quais PackageReferences relevantes?
    - Procure por: Guid.NewGuid() vs Guid.CreateVersion7(), sealed classes, result pattern vs exceptions
-   - Estrutura de src/: segue feature-folder (VSA)? Tem Controllers? Tem IRepository<T>?
+   - Estrutura de src/: segue feature-folder (VSA)? Tem Controllers? Tem repository genérico (IRepository<T>/IUnitOfWork)? Se tiver, reporte como código morto: liste onde está registrado no DI e quantos consumidores reais existem em src/ e tests/
    - Migrations/: qual ORM? Neon/Postgres ou outro banco?
    - Microsoft.Agents.* ou Microsoft.Extensions.AI nos PackageReferences?
 
@@ -102,7 +102,7 @@ Antes de despachar Explore, verifique se o projeto é greenfield:
    | Severidade | Critério |
    |------------|---------|
    | **Bloqueante** | Runtime diferente (.NET 8 ou anterior), ORM diferente (Dapper puro sem EF Core), banco diferente (MySQL, SQL Server) |
-   | **Alto** | `Guid.NewGuid()` generalizado, camada de Service/Manager entre handler e dados, SQL cru generalizado, exceptions como fluxo de controle |
+   | **Alto** | `Guid.NewGuid()` generalizado, camada de Service/Manager entre handler e dados, repository genérico (`IRepository<T>`/`IUnitOfWork`) presente — código morto: migração é deletar a pasta `Repository/` + as 2 linhas de DI, SQL cru generalizado, exceptions como fluxo de controle |
    | **Médio** | Classes não-sealed, Pages Router em vez de App Router, biblioteca de UI diferente |
    | **Baixo** | Versões de pacotes desatualizadas mas compatíveis |
 

package/framework/skills/core/morph-standards/SKILL.md

@@ -4,7 +4,7 @@ description: Localiza e carrega um standard específico do STANDARDS.json sob de
 version: core
 when-to-invoke: quando precisar consultar um standard específico durante a implementação
 user-invokable: true
-cliVersion: "7.7.2"
+cliVersion: "7.8.0"
 ---
 
 # morph-standards

package/framework/standards/STANDARDS.json

@@ -883,7 +883,7 @@
         "endpoint": "#complete-endpoint-example",
         "registration": "#programcs-di-registration-order"
       },
-      "digest": "Each VSA feature is 5 files: Request, Response, Handler, Validator, Endpoint. Use IHandler<TReq,TRes> (not MediatR). Sealed records for DTOs, primary constructors for DI, Guid.CreateVersion7() for IDs. Handler calls Repository+UnitOfWork directly — no service layer. CancellationToken in every async call."
+      "digest": "Each VSA feature is 5 files: Request, Response, Handler, Validator, Endpoint. Use IHandler<TReq,TRes> (not MediatR). Sealed records for DTOs, primary constructors for DI, Guid.CreateVersion7() for IDs. Handler injects ApplicationDbContext directly — no service layer, no generic repository (DbSet<T> is the repository, DbContext is the unit of work). CancellationToken in every async call."
     },
     {
       "id": "backend-integrations-asaas-asaas-api",

package/framework/standards/architecture/vertical-slice/vertical-slice.md

@@ -10,7 +10,8 @@
 
 Padrão arquitetural baseado em **KanaiyaKatarmal/VerticalSliceArchitectureTemplate** (.NET 10, Minimal APIs, EF Core 10).
 Cada feature é uma fatia vertical completa: endpoint → handler → validator → entity → DB.
-Sem MediatR, sem AggregateRoot, sem Domain Events, sem CQRS formal.
+Sem MediatR, sem AggregateRoot, sem Domain Events, sem CQRS formal, sem repository genérico
+(divergência intencional do template base: o handler usa `ApplicationDbContext` direto).
 
 ---
 
@@ -54,11 +55,6 @@ Sem MediatR, sem AggregateRoot, sem Domain Events, sem CQRS formal.
 ├── Pipelines/
 │   ├── ValidationDecorator.cs            # Decorator que executa validators
 │   └── LoggingDecorator.cs               # Decorator que loga request/failure
-├── Repository/
-│   ├── IRepository.cs                    # IRepository<T> genérico
-│   ├── Repository.cs                     # Repository<T> : IRepository<T>
-│   ├── IUnitOfWork.cs                    # IUnitOfWork
-│   └── UnitOfWork.cs                     # UnitOfWork
 └── Program.cs
 ```
 
@@ -190,8 +186,7 @@ public sealed record CreateBookRequest(string Title, string Author, string ISBN,
 public sealed record CreateBookResponse(Guid Id, string Title, string Author, string ISBN, decimal Price, int PublishedYear);
 
 public sealed class CreateBookHandler(
-    IRepository<Book> _bookRepo,
-    IUnitOfWork _unitOfWork) : IHandler<CreateBookRequest, Result<CreateBookResponse>>
+    ApplicationDbContext _db) : IHandler<CreateBookRequest, Result<CreateBookResponse>>
 {
     public async Task<Result<CreateBookResponse>> HandleAsync(
         CreateBookRequest command, CancellationToken cancellationToken)
@@ -205,8 +200,8 @@ public sealed class CreateBookHandler(
             Price = command.Price,
             PublishedYear = command.PublishedYear
         };
-        await _bookRepo.AddAsync(book, cancellationToken);
-        await _unitOfWork.CommitAsync(cancellationToken);
+        _db.Books.Add(book);
+        await _db.SaveChangesAsync(cancellationToken);
         return Result.Success(new CreateBookResponse(
             book.Id, book.Title, book.Author, book.ISBN, book.Price, book.PublishedYear));
     }
@@ -306,38 +301,41 @@ Ordem de execução (innermost-first): `LoggingDecorator → ValidationDecorator
 
 ---
 
-## Repository Pattern
+## Acesso a Dados — DbContext direto no slice
+
+O handler injeta `ApplicationDbContext` direto. Sobre EF Core um repository genérico é
+redundante: `DbSet<T>` já é repository, `DbContext` já é unit of work. **Nunca crie
+`IRepository<T>`/`IUnitOfWork`** — a auditoria de projetos reais mostrou que o par nasce
+registrado no DI e morre órfão, sem consumidores.
 
 ```csharp
-// Repository/IRepository.cs
-public interface IRepository<T> where T : class
-{
-    Task<IEnumerable<T>> GetAllAsync(CancellationToken cancellationToken = default);
-    Task<T?> GetByIdAsync(object id, CancellationToken cancellationToken = default);
-    Task<T> AddAsync(T entity, CancellationToken cancellationToken = default);
-    Task UpdateAsync(T entity, CancellationToken cancellationToken = default);
-    Task DeleteAsync(T entity, CancellationToken cancellationToken = default);
-    IEnumerable<T> ExecuteQuery(string query, DbParameter[] dbParams);
-    Task AddRangeAsync(IEnumerable<T> entities, CancellationToken cancellationToken = default);
-    void RemoveRange(IEnumerable<T> entities);
-}
+// CRUD por chave — direto no DbSet
+var book = await _db.Books.FindAsync([command.Id], cancellationToken);
+_db.Books.Add(book);
+await _db.SaveChangesAsync(cancellationToken);
+
+// Queries específicas — LINQ no slice (joins, projeção, paginação, filtros compostos)
+var page = await _db.Books
+    .Where(b => b.Author == command.Author)
+    .OrderBy(b => b.Title)
+    .Skip(command.Skip).Take(command.Take)
+    .Select(b => new BookDto(b.Id, b.Title))
+    .ToListAsync(cancellationToken);
 ```
 
-**Quando NÃO usar o repository:** o `IRepository<T>` genérico cobre CRUD por chave.
-Para queries com join, projeção, paginação ou filtros compostos, injete
-`ApplicationDbContext` direto no handler e escreva o LINQ no slice — não polua a
-interface genérica com métodos de um único slice, e não use `ExecuteQuery(string sql)`.
-Veja `backend/dotnet/vsa-handler-patterns.md` → "When to Use DbContext Directly".
+**Stores dedicados (exceção justificada):** quando um slice exige controle de concorrência
+(ex.: `SELECT ... FOR UPDATE`, retry de `DbUpdateConcurrencyException`) ou SQL específico
+que o LINQ não expressa, escreva um store hand-written e purpose-built (ex.: `OutboxStore`,
+`LeaseStore`) com métodos nomeados pela intenção — e registre a justificativa em
+`decisions.md`. Nunca um genérico por entidade.
+
+Veja `backend/dotnet/vsa-handler-patterns.md` → "Data Access: DbContext in the Slice".
 
 ---
 
 ## DI Registration (Program.cs)
 
 ```csharp
-// Repositories + Unit of Work
-builder.Services.AddScoped(typeof(IRepository<>), typeof(Repository<>));
-builder.Services.AddScoped(typeof(IUnitOfWork), typeof(UnitOfWork));
-
 // EF Core (SQLite/SqlServer/PostgreSQL)
 builder.Services.AddSQLDatabaseConfiguration(builder.Configuration);
 
@@ -385,8 +383,8 @@ app.MapApiEndpoints();
 4. **`result.Match()`** nos endpoints — nunca acessar `result.Value` sem checar `IsSuccess`.
 5. **IApiEndpoint `internal sealed`** — endpoints não são públicos.
 6. **`{Entity}Errors` compartilhado** por todas as operações da feature (1 arquivo por feature, não por slice).
-7. **Acesso a dados híbrido**: `IRepository<T>` injetado no handler para CRUD por chave; `ApplicationDbContext` injetado direto no slice para queries específicas (joins, projeção, paginação). Nunca uma Application Service layer entre handler e dados.
-8. **`IUnitOfWork.CommitAsync()`** em operações de escrita (Create, Update, Delete).
+7. **`ApplicationDbContext` direto no slice**: CRUD por chave via `DbSet<T>`; queries específicas (joins, projeção, paginação) via LINQ no handler. Nunca uma Application Service layer entre handler e dados; nunca repository genérico (`IRepository<T>`/`IUnitOfWork`).
+8. **`SaveChangesAsync()`** explícito em operações de escrita (Create, Update, Delete).
 9. **Sem validator em GetAll** — GetAllBooksHandler não tem validator (sem parâmetros para validar).
 
 ---
@@ -399,7 +397,8 @@ app.MapApiEndpoints();
 | `DomainEvent` | VSA não tem Domain Events — reações são handlers separados |
 | `MediatR` / `IRequest` / `IRequestHandler` | Substituído por `IHandler<TRequest, TResponse>` próprio |
 | DTOs compartilhados entre features | Cada slice define seus próprios records |
-| Application Service layer | Handler acessa Repository diretamente |
+| Application Service layer | Handler acessa o `ApplicationDbContext` diretamente |
+| Repository genérico (`IRepository<T>`/`IUnitOfWork`) | `DbSet<T>` já é repository, `DbContext` já é unit of work — vira código morto |
 | CQRS formal (Commands/Queries) | Handler simples, sem distinção Command/Query |
 | Shared Validators em Application layer | Validator fica no mesmo namespace do slice |
 

package/framework/standards/backend/api/validation.md

@@ -62,7 +62,7 @@ public enum OrderStatus
 ```csharp
 public async Task<Result> ProcessOrderAsync(Guid orderId, CancellationToken ct)
 {
-    var order = await _repository.GetByIdAsync(orderId, ct);
+    var order = await _db.Orders.FindAsync([orderId], ct);
     if (order == null) return Result.Failure("Order not found");
 
     // State validation (invalid states)
@@ -74,7 +74,7 @@ public async Task<Result> ProcessOrderAsync(Guid orderId, CancellationToken ct)
     if (order.RequiresPayment && !order.IsPaid) return Result.Failure("Payment required");
 
     order.MarkAsProcessing();
-    await _repository.UpdateAsync(order, ct);
+    await _db.SaveChangesAsync(ct);
     return Result.Success();
 }
 ```

package/framework/standards/backend/dotnet/scrutor.md

@@ -126,9 +126,7 @@ builder.Services.AddHandlersFromAssembly(typeof(Program).Assembly);
 The full DI registration sequence in VSA:
 
 ```csharp
-// 1. Infrastructure
-builder.Services.AddScoped(typeof(IRepository<>), typeof(Repository<>));
-builder.Services.AddScoped(typeof(IUnitOfWork), typeof(UnitOfWork));
+// 1. Infrastructure (DbContext)
 builder.Services.AddSQLDatabaseConfiguration(builder.Configuration);
 
 // 2. Endpoints (auto-discovery)

package/framework/standards/backend/dotnet/vsa-handler-patterns.md

@@ -11,7 +11,7 @@
 
 ## Overview
 
-Each feature in VSA is a self-contained slice with 5 files in a feature folder. Handlers implement `IHandler<TRequest, TResponse>` (not MediatR). Dependencies use primary constructors. The data path is `Handler -> Repository -> UnitOfWork` with no service layer in between.
+Each feature in VSA is a self-contained slice with 5 files in a feature folder. Handlers implement `IHandler<TRequest, TResponse>` (not MediatR). Dependencies use primary constructors. The data path is `Handler -> ApplicationDbContext` — no service layer, no generic repository in between.
 
 ---
 
@@ -71,8 +71,8 @@ public sealed record CreateBookResponse(
 namespace ProjectName.Features.BookFeature.CreateBook;
 
 using ProjectName.Abstractions;
+using ProjectName.Database;
 using ProjectName.Entities;
-using ProjectName.Repository;
 
 public sealed record CreateBookRequest(
     string Title, string Author, string ISBN, decimal Price, int PublishedYear);
@@ -82,8 +82,7 @@ public sealed record CreateBookResponse(
 
 // Primary constructor for DI — no field declarations needed
 public sealed class CreateBookHandler(
-    IRepository<Book> bookRepo,
-    IUnitOfWork unitOfWork) : IHandler<CreateBookRequest, Result<CreateBookResponse>>
+    ApplicationDbContext db) : IHandler<CreateBookRequest, Result<CreateBookResponse>>
 {
     public async Task<Result<CreateBookResponse>> HandleAsync(
         CreateBookRequest command, CancellationToken cancellationToken)
@@ -98,8 +97,8 @@ public sealed class CreateBookHandler(
             PublishedYear = command.PublishedYear
         };
 
-        await bookRepo.AddAsync(book, cancellationToken);
-        await unitOfWork.CommitAsync(cancellationToken);
+        db.Books.Add(book);
+        await db.SaveChangesAsync(cancellationToken);
 
         return Result.Success(new CreateBookResponse(
             book.Id, book.Title, book.Author, book.ISBN, book.Price, book.PublishedYear));
@@ -111,7 +110,7 @@ public sealed class CreateBookHandler(
 
 - **`sealed class`** — handlers are never inherited
 - **`sealed record`** — DTOs are immutable value types
-- **Primary constructors** — `(IRepository<Book> bookRepo, IUnitOfWork unitOfWork)` replaces field + constructor boilerplate
+- **Primary constructors** — `(ApplicationDbContext db)` replaces field + constructor boilerplate
 - **`Guid.CreateVersion7()`** — time-sortable, index-friendly UUID (not `Guid.NewGuid()`)
 - **`CancellationToken`** — passed through every async call
 - **`Result<T>` return** — never throw for expected failures
@@ -172,36 +171,35 @@ All endpoint classes implementing this interface are auto-discovered and mapped
 
 ---
 
-## Repository + UnitOfWork (No Service Layer)
+## Data Access: DbContext in the Slice (No Service Layer, No Generic Repository)
 
-Handlers call repositories directly. There is no service/manager layer:
+Handlers inject `ApplicationDbContext` directly. Over EF Core a generic repository is
+redundant — `DbSet<T>` **is** the repository, `DbContext` **is** the unit of work. A
+generic `IRepository<T>`/`IUnitOfWork` pair adds indirection with zero value and, in
+audited real projects, ends up registered in DI with zero consumers (dead code).
+
+CRUD by key goes straight to the `DbSet`:
 
 ```csharp
-public interface IRepository<T> where T : class
+public sealed class DeleteBookHandler(
+    ApplicationDbContext db) : IHandler<DeleteBookRequest, Result>
 {
-    Task<IEnumerable<T>> GetAllAsync(CancellationToken cancellationToken = default);
-    Task<T?> GetByIdAsync(object id, CancellationToken cancellationToken = default);
-    Task<T> AddAsync(T entity, CancellationToken cancellationToken = default);
-    Task UpdateAsync(T entity, CancellationToken cancellationToken = default);
-    Task DeleteAsync(T entity, CancellationToken cancellationToken = default);
-    Task AddRangeAsync(IEnumerable<T> entities, CancellationToken cancellationToken = default);
-    void RemoveRange(IEnumerable<T> entities);
-}
+    public async Task<Result> HandleAsync(
+        DeleteBookRequest command, CancellationToken cancellationToken)
+    {
+        var book = await db.Books.FindAsync([command.Id], cancellationToken);
+        if (book is null)
+            return BookErrors.NotFound(command.Id);
 
-public interface IUnitOfWork
-{
-    Task<int> CommitAsync(CancellationToken cancellationToken);
-    Task RollbackAsync(CancellationToken cancellationToken = default);
+        db.Books.Remove(book);
+        await db.SaveChangesAsync(cancellationToken);
+        return Result.Success();
+    }
 }
 ```
 
-**Pattern:** `Repository.AddAsync()` -> `UnitOfWork.CommitAsync()` — always commit explicitly.
-
-### When to Use DbContext Directly Instead
-
-`IRepository<T>` is the right tool for CRUD by key. It is **not** the right tool for
-slice-specific queries — joins, projections, pagination, composite filters. For those,
-inject `ApplicationDbContext` directly into the handler and write the LINQ in the slice:
+Slice-specific queries — joins, projections, pagination, composite filters — are LINQ
+written in the slice:
 
 ```csharp
 public sealed class SearchBooksHandler(
@@ -222,8 +220,16 @@ public sealed class SearchBooksHandler(
 }
 ```
 
-**Rule of thumb:** CRUD by key → `IRepository<T>` + `IUnitOfWork`. Anything that needs a
-custom query shape → `ApplicationDbContext` in the slice. Never reach for raw SQL
+### Dedicated Stores (the justified exception)
+
+When a slice needs concurrency control (`SELECT ... FOR UPDATE`, lease/outbox semantics,
+`DbUpdateConcurrencyException` retry loops) or SQL that LINQ cannot express, write a
+**hand-written, purpose-built store** with intention-named methods (e.g. `OutboxStore.ClaimBatchAsync`,
+`LeaseStore.TryAcquireAsync`) — and document the justification in `decisions.md`.
+Never a generic-per-entity abstraction.
+
+**Rule of thumb:** everything → `ApplicationDbContext` in the slice. Concurrency or
+specific SQL → dedicated hand-written store + `decisions.md` entry. Never reach for raw SQL
 (`FromSqlRaw`) unless a query genuinely cannot be expressed in LINQ — and document that
 in `decisions.md`.
 
@@ -251,7 +257,7 @@ public static class BookErrors
 Usage in handler:
 
 ```csharp
-var existing = await bookRepo.GetByIdAsync(command.BookId, cancellationToken);
+var existing = await db.Books.FindAsync([command.BookId], cancellationToken);
 if (existing is null)
     return BookErrors.NotFound(command.BookId);  // implicit conversion to Result<T>
 ```
@@ -264,9 +270,7 @@ if (existing is null)
 // 1. OpenAPI
 builder.Services.AddOpenApi();
 
-// 2. Infrastructure (Repository, UnitOfWork, DbContext)
-builder.Services.AddScoped(typeof(IRepository<>), typeof(Repository<>));
-builder.Services.AddScoped(typeof(IUnitOfWork), typeof(UnitOfWork));
+// 2. Infrastructure (DbContext)
 builder.Services.AddSQLDatabaseConfiguration(builder.Configuration);
 
 // 3. Endpoint auto-discovery
@@ -293,7 +297,8 @@ builder.Services.AddExceptionHandler<CustomExceptionHandler>()
 | Do NOT | Do Instead |
 |--------|------------|
 | Use MediatR `IRequest`/`Send()` | Use `IHandler<TReq, TRes>` resolved directly from DI |
-| Create a service/manager layer | Handler calls Repository + UnitOfWork directly |
+| Create a service/manager layer | Handler uses `ApplicationDbContext` directly |
+| Add a generic repository (`IRepository<T>`/`IUnitOfWork`) | `DbSet<T>` is the repository; `DbContext` is the unit of work |
 | Use `Guid.NewGuid()` | Use `Guid.CreateVersion7()` for time-sortable IDs |
 | Make handler classes non-sealed | Always `sealed class` |
 | Use mutable DTOs (class with setters) | Always `sealed record` with positional parameters |
@@ -302,7 +307,7 @@ builder.Services.AddExceptionHandler<CustomExceptionHandler>()
 | Share handlers across features | Each feature has its own handler, even if similar |
 | Use constructor + field for DI | Use primary constructors: `class Handler(IDep dep)` |
 | Group by technical concern (Controllers/, Services/) | Group by feature: `Features/BookFeature/CreateBook/` |
-| Force a slice-specific query through `IRepository<T>` | Inject `DbContext` and write LINQ in the slice |
+| Route data access through any indirection layer | Inject `DbContext` and write LINQ in the slice; dedicated store only with `decisions.md` justification |
 | Use raw SQL (`FromSqlRaw` / `ExecuteQuery(string)`) by default | Use LINQ; raw SQL only with a `decisions.md` justification |
 
 ---

package/framework/standards/data/nosql/cache/redis.md

@@ -32,7 +32,7 @@ builder.Services.AddStackExchangeRedisCache(opts =>
 public class CachedProductService : IProductService
 {
     private readonly IDistributedCache _cache;
-    private readonly IProductRepository _repository;
+    private readonly ApplicationDbContext _db;
 
     public async Task<Product?> GetAsync(Guid id, CancellationToken ct = default)
     {
@@ -44,7 +44,7 @@ public class CachedProductService : IProductService
             return JsonSerializer.Deserialize<Product>(cached);
 
         // Cache miss → read from DB
-        var product = await _repository.GetAsync(id, ct);
+        var product = await _db.Products.FindAsync([id], ct);
         if (product == null) return null;
 
         // Cache with TTL