Skip to content
cccskills
FreePublished on GitHub

dotnet-architecture

Arquitectura de backends .NET: Vertical Slice Architecture (features) y Clean Architecture (capas), con guía de cuándo usar cada una, estructura, patrones (MediatR/Result/outbox) y anti-patterns. Usar al diseñar o revisar la estructura de un proyecto ASP.NET Core.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3 stars(GitHub 3 + cccskills 0)

Run score Not tested

See how to install

Files included (5)

  • SKILL.md3.7 KB
  • references/anti-patterns.md1.8 KB
  • references/checklist.md1.3 KB
  • references/patterns.md4.0 KB
  • references/project-structure.md3.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

dotnet-architecture — VSA & Clean Architecture para .NET

Dos enfoques production-ready para estructurar un backend ASP.NET Core. No son excluyentes: muchos proyectos usan Clean Architecture en el borde y slices verticales adentro. Esta skill ayuda a elegir y a aplicar cada uno correctamente.

MANDATORY WORKFLOW

No imponer arquitectura por moda. Elegir según complejidad del dominio y vida del proyecto.

Step 0: Elegir enfoque (when-to-use)

SeñalRecomendación
CRUD, prototipos, APIs chicas, dominio fino, equipo chicoVertical Slice (o single project)
Dominio complejo, reglas de negocio ricas, long-lived, varios equiposClean Architecture
Necesitás aislar el dominio de frameworks/DB para test y reemplazoClean Architecture
Querés velocidad y bajo overhead de indirecciónVertical Slice

Evitá Clean Architecture para CRUD simple: los proyectos extra y la indirección cuestan más de lo que aportan cuando la lógica de negocio es delgada. Empezá con Vertical Slice y migrá si el dominio crece.

Step 1: Aplicar la estructura

  • Vertical Slice: un folder por feature/use-case; cada slice tiene su request, handler, validator y endpoint juntos. Ver references/project-structure.md.
  • Clean Architecture: proyectos Domain → Application → Infrastructure → Api; las dependencias apuntan hacia adentro, nunca al revés. Ver references/project-structure.md.

Step 2: Patrones idiomáticos

Leer references/patterns.md: MediatR/handlers por use-case, IApplicationDbContext (exponer EF Core sin repos genéricos), pipeline behaviors (validación/logging/transacción), Result pattern en vez de excepciones para flujo, y outbox pattern para consistencia entre DB y eventos.

Step 3: Revisar contra anti-patterns + checklist

  • references/anti-patterns.md — repos genéricos sobre EF Core, fat controllers, dependencias que apuntan hacia afuera, lógica de dominio en Infrastructure.
  • references/checklist.md — verificación de cierre antes de dar la estructura por buena.

Antes de aplicar una reestructuración significativa, confirmar el approach con el usuario (Question → Decision → Approval). Si todo el checklist pasa → arquitectura COMPLIANT.

Resumen de enfoques

AspectoVertical SliceClean Architecture
Eje de organizaciónFeature / use-caseCapa técnica
Proyectos1 (+ tests)4 (Domain/App/Infra/Api)
Acoplamiento entre featuresBajo (slices independientes)Mediado por Application
Overhead inicialBajoAlto
Mejor paraCRUD, features, velocidadDominios complejos, long-lived
RiesgoDuplicación entre slicesSobre-ingeniería

Próximos pasos

Definida la arquitectura → /dotnet-scaffold para generar el proyecto, y /dotnet-best-practices para revisar el código contra las 40 reglas.


Inspirado en ardalis/CleanArchitecture, nadirbad/VerticalSliceArchitecture y la guía de Vertical Slice de Milan Jovanović. Adaptado al formato Arcane.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Plan, design, and implement A/B tests and experiments with statistical rigor. Covers hypothesis frameworks, sample sizing, metrics, and result analysis.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Web/mobile accessibility decision guide: WCAG 2.2 AA, ARIA, keyboard nav, focus management, contrast, testing. Use for: a11y, accessibility, wcag, aria, screen reader, keyboard, contrast.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Generate, iterate, and scale ad creative for paid advertising across Google, Meta, LinkedIn, and X. Covers platform specs, creative frameworks, and quality validation.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Musica interactiva para juegos: layering vertical, re-secuenciacion horizontal, stingers, reglas de transicion con sync points, y mapeo de estados de gameplay a musica. Usar para: musica adaptativa, sistema de musica dinamica, transiciones musicales, combat music.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Design multi-agent systems, create agent architectures, define communication patterns, and build autonomous agent workflows with structured evaluation frameworks.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Inter-agent communication protocol for C-suite agent teams. Defines invocation syntax, loop prevention, isolation rules, response formats, and quality loops.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

See all skills by SebastianLuser

Report a problem with this skill