agentleFS
bryanus1bryanus1/agent-skills/skills/practices/design-patterns/SKILL.md

design-patterns

Skill0 starsChanged 4 days agoMITView on GitHub

Elige y aplica patrones de diseño (GoF y modernos: Strategy, Adapter, Factory, Repository, Result, Compound Components, hooks) a partir del problema, no del catálogo, y decide cuándo NO usar ninguno. Úsala al pedir un patrón, al ver ifs/switch repetidos, SDKs acoplados o lógica de UI duplicada, en frontend o backend.

37 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use logging-patterns, tdd-rust and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • DIL8654Skill

    logging-patterns

    Keep logs structured, correlated, low-noise, and safe for production support. Use when adding operational logging, reviewing observability, or improving diagnostics in .NET services.

    Also in 7 projects that use this

  • FlorianBruniauxSkill

    tdd-rust

    Also in 3 projects that use this

  • mstuder-slalomSkill

    jpa-patterns

    JPA/Hibernate patterns for entity design, relationships, query optimization, transactions, auditing, indexing, pagination, and pooling in Spring Boot.

    Also in 6 projects that use this

  • ufodev-ioSkill

    security-guardian

    Comprehensive security layer for all interactions with Claude: audits code, dependencies, commands, configs, and AI-generated output for vulnerabilities. Protects against prompt injection, data leaks, unsafe advice, and social engineering. Works in Cursor, Claude Code, claude.ai, and API contexts. Use always as a background security protocol in any Claude-powered environment.

    Also in 3 projects that use this

  • DIL8654Skill

    api-contract-review

    Review ASP.NET Core Web API contracts for HTTP semantics, versioning, backward compatibility, and response consistency. Use when the user asks to review an API, check endpoints, validate REST behavior, or before releasing contract changes.

    Also in 3 projects that use this

  • zavierSkill

    java-code-review

    Java代码审查技能,通过比较两个git分支进行自动化代码审查

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 36 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    No la actives para legibilidad local (nombres, funciones largas): usa clean-code.

    line 37

“Common” is measured: kept by at least 6 in 10 of the 36 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Design Patterns

🎯 Propósito

Un patrón es una solución con nombre a un problema recurrente, y su valor es el vocabulario compartido y el equilibrio de fuerzas ya estudiado. Esta skill parte del problema (qué dolor hay, qué variación existe) y llega al patrón, no al revés. Aplicar un patrón sin el problema es el error más común: produce capas sin beneficio.

Complementa a solid-principles (por qué separar y qué depende de qué) y a clean-code (legibilidad dentro de las funciones). Para la estructura de carpetas, usa las skills de arquitectura del catálogo.

⚡ Cuándo Activar esta Skill

  • El usuario pide un patrón por nombre ("aplica Strategy", "usa el patrón Repository") o pregunta "qué patrón uso para…".
  • Hay if/switch sobre un tipo repetidos, SDKs de terceros acoplados a la lógica, objetos con construcción compleja, eventos que muchos módulos necesitan escuchar, o lógica de UI duplicada entre componentes.
  • Se revisa un diseño y se quiere saber si un patrón ayudaría (o si sobra el que ya hay).

No la actives para legibilidad local (nombres, funciones largas): usa clean-code.

📋 Flujo de Trabajo Paso a Paso

1. Formular el problema, no la solución

Antes de nombrar ningún patrón, responde por escrito:

  1. ¿Qué duele hoy? (cambio que se propaga, test imposible, duplicación, acoplamiento a un proveedor, construcción repetida).
  2. ¿Qué varía y qué es estable? El patrón aísla lo que varía de lo que no.
  3. ¿Cuántas variantes reales existen? (una, dos, tres o más; ya conocidas o hipotéticas).
  4. ¿Qué convenciones tiene el proyecto? (clases o funciones, contenedor DI, librerías de estado y de datos, framework).

Si el usuario pidió un patrón concreto, comprueba igualmente que encaja con el problema; si no encaja, dilo y propón la alternativa.

2. Elegir con la tabla problema → patrón

ProblemaCandidatoAlternativa más simple a considerar primero
Varias formas de hacer lo mismo, elegidas en tiempo de ejecución (tarifas, exportadores, validadores)StrategyTabla Record<Tipo, función>
Integrar una API/SDK de terceros sin acoplarse a élAdapter (puerto + adaptador)Función envoltorio
Crear objetos cuyo tipo depende de datos o configuraciónFactory / Factory MethodFunción create(...) con switch
Construcción con muchos parámetros opcionalesBuilderObjeto de opciones con valores por defecto
Añadir comportamiento transversal sin tocar el original (caché, logs, reintentos, auth)Decorator / middlewareFunción de orden superior
Ocultar un subsistema complejo tras una API simpleFacadeUn módulo con una función pública
Notificar a varios interesados de un cambio, sin acoplarlosObserver / eventosCallback directo si hay un único interesado
Un proceso con pasos fijos y detalles variablesTemplate MethodFunción que recibe los pasos variables como parámetros
Cambiar de comportamiento según el estado, con transiciones explícitasState / máquina de estadosswitch sobre un enum si son pocos estados
Encapsular una acción para deshacer, encolar o registrarCommandFunción + datos
Aislar el acceso a datos de la lógica de negocioRepositoryFunción de acceso a datos con interfaz
Devolver éxito/fallo sin excepciones en flujos esperadosResult / EitherExcepciones de dominio tipadas
Instancia compartida por toda la appMódulo/instancia compuesta en la raízEvita Singleton clásico (estado global, tests difíciles)
UI con piezas relacionadas que comparten estado (tabs, accordion, select)Compound ComponentsProps + children
Reutilizar lógica con estado entre componentesCustom HookFunción pura
Separar presentación de acceso a datos en UIContainer/Presentational o hook + componente—

Detalle, forma y ejemplos en TypeScript: Creacionales, Estructurales, Comportamiento, Frontend y backend.

3. Contrastar con la alternativa más simple (obligatorio)

Para el candidato elegido, responde:

  • ¿Una función o una tabla de datos resuelve el problema con menos piezas? En TypeScript/JavaScript muchos patrones GoF son funciones de orden superior o objetos literales; una jerarquía de clases suele sobrar.
  • ¿Hay al menos dos variantes reales o una costura de test necesaria? Con una sola, aplaza.
  • ¿El patrón encaja con las convenciones del proyecto? (No metas clases en un código funcional, ni un contenedor DI donde no lo hay.)
  • ¿Cuánto añade? (archivos, indirección, curva de lectura). Debe pagar por sí mismo.

Resultado: Aplicar, Aplazar (esperar a la segunda variante) o No aplicar (alternativa simple). Anótalo con la razón.

4. Red de seguridad

Si el patrón se introduce en código existente, es un refactor: ejecuta los tests antes y después. Si no cubren el código afectado, añade tests de caracterización primero (si tdd-workflow está disponible, sigue su Flujo C). Si construyes algo nuevo, escribe el test del comportamiento primero.

5. Implementar de forma mínima

  • Nombra el patrón en el código solo cuando ayude (ShippingStrategy, StripeAdapter, OrderRepository); es vocabulario compartido. No lo fuerces en el nombre si la convención del proyecto es otra.
  • Define la interfaz desde el consumidor y con lo mínimo que necesita (ver ISP en solid-principles).
  • Concentra la composición (qué implementación se usa) en un único punto, no repartida.
  • Mantén la API pública salvo petición expresa, y avisa de cualquier cambio de comportamiento.

6. Verificar y reportar

Ejecuta tests, typecheck y lint si existen. Usa el formato de la sección "Reporte"; incluye las decisiones de No aplicar y Aplazar.

🚫 Cuándo NO usar un patrón

  • Una sola implementación y sin segunda a la vista: la interfaz, la factoría o la estrategia son ruido.
  • Un switch pequeño, estable y en un único sitio: es más legible que N clases.
  • Para parecer "profesional" o porque "el proyecto debería tener patrones": cada pieza debe justificar su coste.
  • Singleton, Service Locator y estado global: casi siempre hay una alternativa por inyección o composición.
  • Cuando el framework ya lo resuelve (middleware de Express/Nest como Decorator/Chain, hooks como Strategy/Observer, ORM como Repository/Unit of Work): usa el mecanismo nativo.
  • Combinaciones decorativas: apilar Factory + Strategy + Builder para dos casos es sobreingeniería, no diseño.

⚠️ Reglas Críticas

  • Parte del problema, no del patrón. Cita el dolor concreto en el reporte; sin dolor ni variación real, no hay patrón.
  • Pregunta por la alternativa simple antes de añadir clases. Una función o una tabla vence a una jerarquía casi siempre en TS/JS.
  • No cambies la API pública ni el comportamiento sin avisar. Un refactor a patrón mantiene el comportamiento; ejecuta los tests antes y después e informa del resultado real.
  • No instales dependencias (contenedores DI, librerías de eventos, neverthrow, xstate…) sin confirmación del usuario.
  • Respeta las convenciones del proyecto: estilo funcional vs clases, contenedor DI existente, librería de estado o de datos ya elegida.
  • No toques lo que no se pidió: lo demás va a "Aplazado / fuera de alcance".

📤 Reporte

### Problema
<qué duele, qué varía, cuántas variantes reales>

### Decisión
| Candidato | Alternativa simple | Veredicto | Razón |
|---|---|---|---|
| Strategy | Tabla Record<Carrier, fn> | Aplicar tabla, no clases | 3 variantes sin estado; encaja con el estilo funcional del proyecto |
| Factory | — | No aplicar | Solo un punto de creación |

### Cambios aplicados
1. <cambio> — tests: ✅ N/N

### Aplazado / fuera de alcance
- <qué reevaluar con una segunda variante, riesgos, decisiones para el usuario>

📚 Referencias

  • Patrones creacionales: Factory, Builder, evitar Singleton
  • Patrones estructurales: Adapter, Decorator, Facade
  • Patrones de comportamiento: Strategy, Observer, State, Command, Template Method
  • Frontend y backend: Repository, Result, Compound Components, hooks, middleware
  • Ejemplo: de switch repetido a estrategias

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.