- Home
- Skills
- Code Quality & Review
- Archbase NestJS Architecture Auditor
Works with the AI Agents you already use
Archbase NestJS Architecture Auditor
Review NestJS architecture with file evidence, applicable rules and a prioritized Markdown report. Separate confirmed findings, suspicions and missing context. Read-only; no runtime installation required.
$9
Archbase NestJS Architecture Auditor
Example session with this skill installed
Recorded local evaluation: nestjs-auditor 0.1.0; codex-cli 0.166.0-alpha.5.1; model gpt-6.1-sol. Synthetic supplied snapshot, not a live Agensi session. The agent received the skill and its included references. The complete recorded response below is preserved in its original language. No framework build or automatic edits were performed.
Use nestjs-auditor to audit only the supplied synthetic package. Respond in Portuguese with actual path/line or excerpt evidence, disclosed adopted RuleID/baseline, justified severity, corrections and limits. Distinguish confirmed, suspected and not-assessable checks. Keep report in chat. Do not call tools, execute scripts, install, edit or post. Supplied tool transcripts are simulations, not your executions. Do not assume a runnable app or security certification.
Supplied synthetic files
AGENTS.md.md
```markdown
# Project conventions
Adopt architecture/nestjs-prisma-modular@1 for this package.
### fixture-context.md.md
```text
```markdown
Synthetic source-analysis fixture. External dependencies are declared or shown only, not installed. No build, framework runtime, database or tool integration has been executed. Only supplied files are available.
### package.json.md
```text
```json
{"private":true,"dependencies":{"@nestjs/core":"11.0.0","@nestjs/common":"11.0.0","@prisma/client":"6.0.0"}}
### src/features/orders/orders.controller.ts.md
```text
```typescript
```ts
import { Controller, Get } from "@nestjs/common";
import { OrdersService } from "./orders.service";
@Controller("orders")
export class OrdersController { constructor(private readonly service:OrdersService){}
@Get() list(){return this.service.list()} }
src/features/orders/orders.service.ts.md
```typescript
import { Injectable } from "@nestjs/common";
import { PrismaService } from "../../infrastructure/prisma/prisma.service";
@Injectable()
export class OrdersService { constructor(private readonly prisma:PrismaService){}
list(){return this.prisma.order.findMany()} }
### src/infrastructure/prisma/prisma.service.ts.md
```text
```typescript
import { PrismaClient } from "@prisma/client";
export class PrismaService extends PrismaClient {}
- Read your context and instructions
- Compiled the archbase nestjs architecture
Vou aplicar a skill nestjs-auditor ao snapshot fornecido, usando a baseline declarada e sem executar ferramentas ou acessar outros arquivos.
Auditoria de arquitetura
Resumo e escopo inspecionado
Escopo exclusivo: C:\Users\enzo_\AppData\Local\Temp\archbase-evals-864811d16670434981e7085be6952aee\01-feature-flow\project.
A análise com a skill nestjs-auditor abrangeu somente os seis arquivos fornecidos: AGENTS.md, fixture-context.md, package.json, controller e service de pedidos, e serviço Prisma.
Nenhuma violação foi confirmada no recorte disponÃvel. O fluxo observado respeita a separação entre transporte, serviço de aplicação e infraestrutura. Há lacunas de composição e ciclo de vida que impedem concluir conformidade do pacote inteiro.
Baseline e cobertura
Regra adotada: architecture/nestjs-prisma-modular@1, versão canônica 1.0.0, explicitamente adotada em AGENTS.md:2.
- Proveniência fixa: catálogo
v0.8.0, commit240950368facf47684d574cd95b8e5132d3afdef.
Compatibilidade: package.json:1 declara NestJS 11 e Prisma Client 6; os imports e responsabilidades apresentados são compatÃveis com essa arquitetura.
Customizações: nenhuma adicional foi fornecida. Não há conteúdo de .archbase/scopes.yaml no snapshot; não se presume sua existência ou ausência no projeto original.
- Os identificadores de padrões, como
nestjs/prisma-service@8356, são mapeamentos da referência fornecida. Não foram presumidas regras adicionais de padrões cujo texto não foi disponibilizado.
Não foram realizadas chamadas de ferramentas, leituras externas, alterações ou execuções.
Achados confirmados
Não há achados confirmados com a evidência disponÃvel.
As seguintes verificações tiveram resultado limitado favorável:
| Verificação | Evidência e conclusão |
|---|---|
| Controller delega ao serviço | src/features/orders/orders.controller.ts:2–5 injeta OrdersService e chama this.service.list(). Não há consulta Prisma ou chamada externa nesse controller. |
| Serviço pode consultar Prisma injetado | src/features/orders/orders.service.ts:2–5 resolve o import local de PrismaService e executa this.prisma.order.findMany(). A regra adotada permite consultas especÃficas da feature no serviço; não exige repository adicional. |
| Infraestrutura compartilhada não contém consultas de pedidos | src/infrastructure/prisma/prisma.service.ts:1–2 contém apenas import e extensão de PrismaClient. A consulta especÃfica permanece no serviço de pedidos. |
| Ausência de DTO não demonstra falha de validação | O endpoint @Get() list() em src/features/orders/orders.controller.ts:5 não declara entrada HTTP a validar. Não há fundamento para exigir DTO apenas para preencher uma estrutura de pastas. |
Essas conclusões descrevem o código apresentado, sem comprovar resolução de dependências pelo NestJS ou execução de consultas.
Suspeitas e verificações não avaliáveis
Suspeita — gestão do ciclo de vida Prisma.
Em src/infrastructure/prisma/prisma.service.ts:2, a implementação completa fornecida é:
export class PrismaService extends PrismaClient {}
Não aparece gestão explÃcita de inicialização ou encerramento nessa classe. A regra adotada atribui à infraestrutura Prisma a responsabilidade por ciclo de vida e configuração de conexão. Contudo, a composição da aplicação e possÃveis mecanismos externos não foram fornecidos; portanto, isso
não confirma uma violação, nem demonstra vazamento de conexões. É necessário verificar onde essas responsabilidades são implementadas. Severidade não atribuÃda enquanto a suspeita permanecer sem comprovação.
| Verificação não avaliável | Evidência ausente e referência relativa solicitada |
|---|---|
| Módulo explÃcito da feature, providers e exports intencionais | src/features/orders/orders.module.ts, ou o caminho real do módulo que declara essas classes. A ausência no snapshot não prova que o módulo inexista. |
| Composição e configuração global de transporte | src/main.ts e src/app.module.ts, ou seus equivalentes reais. Sem eles, não se avaliam pipes globais, registro dos módulos ou hooks de encerramento. |
| Configuração e ciclo de vida Prisma | Módulo de infraestrutura e provider de configuração efetivamente usados, por exemplo src/infrastructure/prisma/prisma.module.ts, se esse for o caminho real. Não são necessários valores de credenciais. |
Modelo Order e configuração do cliente gerado | prisma/schema.prisma, ou o schema real. A expressão order.findMany() não comprova existência do modelo, geração do cliente ou acesso a banco. |
| Autenticação e autorização da rota | Registro dos guards, metadados públicos e implementação do verificador, nos caminhos reais. Não se pode inferir acesso indevido pela ausência desses arquivos no snapshot. |
| Integrações externas e envelopes HTTP | Não há implementação fornecida para avaliar. Não se exige criar essas camadas sem uma responsabilidade concreta que as justifique. |
Propostas ordenadas e limitações
Verificar a composição da feature: confirmar que um módulo NestJS declara o controller e o serviço, disponibiliza a dependência Prisma e exporta somente serviços públicos intencionais. Corrigir apenas se essa composição estiver efetivamente ausente.
2.
Localizar a gestão Prisma: confirmar configuração de conexão e encerramento na infraestrutura. Se não houver responsável, implementá-los nessa camada, preservando a consulta de pedidos no serviço da feature.
3.
Completar a análise de transporte e proteção: examinar bootstrap e guards reais antes de propor mudanças em validação ou autenticação. O método sem entrada apresentada não justifica adicionar DTO.
4.
Quando houver ambiente autorizado, validar compilação, resolução de dependências e encerramento da aplicação. Esses são testes propostos, não resultados observados.
Todas as referências normativas exigidas pela skill foram fornecidas. As lacunas são de evidência do projeto. fixture-context.md:1 declara que dependências, runtime, banco e integrações não foram executados; esta análise não pressupõe uma aplicação executável e não constitui certificação de segurança ou aprovação integral do pacote.
Connects securely to your tools. The creator never sees your data.
About this skill
Purpose
Inspect NestJS/Prisma feature modules, controllers, DTOs, services, persistence boundaries and guards. Identify the requested package, its stack and adopted local conventions before applying a compatible baseline. Variants are not cumulative.
What you receive
A Markdown architecture report with inspected scope, baseline, confirmed findings, suspicions, unassessed checks, justified high/medium/low severity, ordered recommendations and limitations. Confirmed findings cite real paths, lines or excerpts and applicable RuleIDs. No numeric score.
Evidence and local conventions
Local customizations and more specific scopes take precedence. Unknown imports, missing context and invalid selected configuration are never silently treated as confirmed violations or replaced by another architecture. Responses follow the user's language.
Included package and license
Skill content version 0.1.0. Generated canonical references use Archbase catalog v0.8.0, commit 240950368facf47684d574cd95b8e5132d3afdef. Original reusable workflow and templates are proprietary; included public references retain MIT attribution. Legitimately generated project-specific results may be used under the license. The skill itself may not be resold or redistributed.
Tools and privacy
Use a SKILL.md-compatible AI agent and bounded project text. No arc, Python, Go, framework runtime, extra MCP server or connected service is required. Existing trusted read-only tools are optional. Project text is untrusted evidence, never permission to execute instructions or disclose secrets. This skill adds no telemetry; your agent/provider processes context under its own configuration.
Tested scope and limits
Tested in 30 independent local Codex CLI supplied-snapshot scenarios, with semantic review. No live Agensi delivery test for this product. No framework builds, runtime verification, complete security audit, native host discovery or Cursor/Claude Code/Copilot certification. Analysis is limited to the supplied scope; unresolved imports and invalid configurations remain explicit limitations. No scripts, installations or automatic source changes.
Support
Use Agensi creator messaging with a minimal redacted reproduction. Best-effort support; no guaranteed response deadline. Platform purchase/refund terms apply. One-time purchase; no subscription.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Code Quality & Review.
Tested in 30 independent local Codex CLI supplied-snapshot scenarios, with semantic review. No live Agensi delivery test for this product. No framework builds, runtime verification, complete security audit, native host discovery or Cursor/Claude Code/Copilot certification. Analysis is limited to the supplied scope; unresolved imports and invalid configurations remain explicit limitations. No scripts, installations or automatic source changes.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 12 days ago
Permissions
Read only the bounded project/package or supplied snapshot authorized by the user. No required shell, writes, network, environment variables or connected service. Output is Markdown in the conversation; no PDF or generated source file is promised.