Architecture Intelligence — Skill
Detección, análisis y recomendación de patrones de arquitectura para los 16 lenguajes soportados.
Algoritmo de Detección
La detección de patrones sigue 4 fases con scoring acumulativo:
Fase 1: Análisis de Estructura de Carpetas (peso: 40%)
Buscar carpetas que correspondan a patrones conocidos:
| Patrón |
Carpetas esperadas |
| Clean Architecture |
Domain/, Application/, Infrastructure/, Presentation/ |
| Hexagonal |
ports/, adapters/, domain/ o core/ |
| DDD |
Carpetas por dominio: orders/, users/, billing/ |
| CQRS |
commands/, queries/, handlers/ |
| MVC |
controllers/, models/, views/ |
| MVVM |
viewmodels/, views/, models/ |
| Microservices |
Múltiples Dockerfile, docker-compose.yml, API gateway config |
Fase 2: Análisis de Imports/Dependencias (peso: 30%)
Verificar dirección de dependencias:
- Clean/Hexagonal: Domain NO importa Infrastructure → ✅
- Domain importa Infrastructure → ❌ violación
- Dependencias circulares → ❌ violación
- Buscar: MediatR, Axon, EventStore → CQRS/Event-Driven
Fase 3: Análisis de Naming Conventions (peso: 20%)
Buscar sufijos/prefijos indicativos:
*Controller, *Service, *Repository → MVC/Layered
*Command, *Query, *Handler → CQRS
*Aggregate, *ValueObject, *DomainEvent → DDD
*Port, *Adapter → Hexagonal
*ViewModel, *Presenter → MVVM/MVP
*UseCase, *Interactor → Clean Architecture
Fase 4: Análisis de Configuración (peso: 10%)
Buscar ficheros de configuración:
docker-compose.yml con múltiples servicios → Microservices
- DI container config → Clean/Hexagonal
- Event bus config → Event-Driven
- API gateway config → Microservices
Scoring
Cada patrón recibe score 0-100. Se reporta:
- Patrón principal: score más alto
- Patrones secundarios: scores >30 que no son el principal
- Nivel de adherencia: Alto (>80), Medio (50-80), Bajo (<50)
- Violaciones: reglas rotas del patrón detectado
Fitness Functions — Templates
Regla: No dependencias inversas entre capas
RULE: "Domain layer independence"
CHECK: Files in {domain_folder} do NOT import from {infrastructure_folder}
SEVERITY: CRITICAL
Regla: Naming conventions
RULE: "Controller naming"
CHECK: Files in {controllers_folder} end with "Controller" suffix
SEVERITY: WARNING
Regla: No dependencias circulares
RULE: "No circular dependencies"
CHECK: Module dependency graph has no cycles
SEVERITY: CRITICAL
Regla: Tamaño de módulos
RULE: "Module size limit"
CHECK: Each module/package has ≤ {max_files} files
SEVERITY: WARNING
Integración con Language Packs
Para cada lenguaje, cargar el reference correspondiente:
- Detectar lenguaje del proyecto (por extensiones, package manager, framework)
- Cargar
references/patterns-{lang}.md para markers específicos
- Combinar con reglas genéricas de
@docs/rules/domain/architecture-patterns.md
Output
Los templates de output están definidos en cada comando (/arch-detect, /arch-suggest, /arch-recommend).
Output se genera en output/architecture/{proyecto}-{tipo}.md.
1---2name: architecture-intelligence3description: Architecture Intelligence — Skill4---56# Architecture Intelligence — Skill78> Detección, análisis y recomendación de patrones de arquitectura para los 16 lenguajes soportados.910---1112## Algoritmo de Detección1314La detección de patrones sigue 4 fases con scoring acumulativo:1516### Fase 1: Análisis de Estructura de Carpetas (peso: 40%)1718Buscar carpetas que correspondan a patrones conocidos:1920| Patrón | Carpetas esperadas |21|--------|-------------------|22| Clean Architecture | `Domain/`, `Application/`, `Infrastructure/`, `Presentation/` |23| Hexagonal | `ports/`, `adapters/`, `domain/` o `core/` |24| DDD | Carpetas por dominio: `orders/`, `users/`, `billing/` |25| CQRS | `commands/`, `queries/`, `handlers/` |26| MVC | `controllers/`, `models/`, `views/` |27| MVVM | `viewmodels/`, `views/`, `models/` |28| Microservices | Múltiples `Dockerfile`, `docker-compose.yml`, API gateway config |2930### Fase 2: Análisis de Imports/Dependencias (peso: 30%)3132Verificar dirección de dependencias:33- Clean/Hexagonal: Domain NO importa Infrastructure → ✅34- Domain importa Infrastructure → ❌ violación35- Dependencias circulares → ❌ violación36- Buscar: MediatR, Axon, EventStore → CQRS/Event-Driven3738### Fase 3: Análisis de Naming Conventions (peso: 20%)3940Buscar sufijos/prefijos indicativos:41- `*Controller`, `*Service`, `*Repository` → MVC/Layered42- `*Command`, `*Query`, `*Handler` → CQRS43- `*Aggregate`, `*ValueObject`, `*DomainEvent` → DDD44- `*Port`, `*Adapter` → Hexagonal45- `*ViewModel`, `*Presenter` → MVVM/MVP46- `*UseCase`, `*Interactor` → Clean Architecture4748### Fase 4: Análisis de Configuración (peso: 10%)4950Buscar ficheros de configuración:51- `docker-compose.yml` con múltiples servicios → Microservices52- DI container config → Clean/Hexagonal53- Event bus config → Event-Driven54- API gateway config → Microservices5556### Scoring5758Cada patrón recibe score 0-100. Se reporta:59- **Patrón principal**: score más alto60- **Patrones secundarios**: scores >30 que no son el principal61- **Nivel de adherencia**: Alto (>80), Medio (50-80), Bajo (<50)62- **Violaciones**: reglas rotas del patrón detectado6364---6566## Fitness Functions — Templates6768### Regla: No dependencias inversas entre capas6970```71RULE: "Domain layer independence"72CHECK: Files in {domain_folder} do NOT import from {infrastructure_folder}73SEVERITY: CRITICAL74```7576### Regla: Naming conventions7778```79RULE: "Controller naming"80CHECK: Files in {controllers_folder} end with "Controller" suffix81SEVERITY: WARNING82```8384### Regla: No dependencias circulares8586```87RULE: "No circular dependencies"88CHECK: Module dependency graph has no cycles89SEVERITY: CRITICAL90```9192### Regla: Tamaño de módulos9394```95RULE: "Module size limit"96CHECK: Each module/package has ≤ {max_files} files97SEVERITY: WARNING98```99100---101102## Integración con Language Packs103104Para cada lenguaje, cargar el reference correspondiente:105- Detectar lenguaje del proyecto (por extensiones, package manager, framework)106- Cargar `references/patterns-{lang}.md` para markers específicos107- Combinar con reglas genéricas de `@docs/rules/domain/architecture-patterns.md`108109## Output110111Los templates de output están definidos en cada comando (`/arch-detect`, `/arch-suggest`, `/arch-recommend`).112Output se genera en `output/architecture/{proyecto}-{tipo}.md`.