Funcionaba bien para cosas pequeñas.

Todo se desmoronaba en cuanto la tarea se volvía real: una pantalla de UIKit que necesitaba avanzar hacia Clean Architecture sin romper el resto del módulo, o una revisión de rendimiento de una lista con muchas imágenes que «se siente lenta», pero que no tiene una causa evidente.

El problema no era Claude.

El problema era que un único prompt improvisado no conserva ningún contexto sobre cómo debe planificarse, limitarse o verificarse el trabajo.

En cada sesión tenía que volver a explicar las mismas cosas: primero inspecciona, no rompas los patrones existentes, dime qué cambiaste y dime cómo verificarlo.

Así que dejé de escribir prompts aislados para trabajos recurrentes y empecé a mantener un conjunto de instrucciones para agentes especializados: uno para cada tipo de tarea, cada uno con sus propias reglas incorporadas.

Este paquete contiene 25 agentes y lo estoy ofreciendo gratis.

Este es uno de los agentes de Claude que utilizo.

Por qué un formato fijo es mejor que una lista de prompts

Un prompt solicita un resultado.

Un agente define cómo debe gestionarse el trabajo antes, durante y después de producir ese resultado.

El formato que terminé utilizando tiene cinco partes, y los 25 agentes lo siguen:

Trigger es la prueba de una sola línea que determina si ese es realmente el agente adecuado. Evita que utilices el agente de refactorización cuando lo que realmente necesitas es el agente de rendimiento.

Mission es la única responsabilidad que el agente debe proteger. Todo lo que haga debería estar relacionado con esa frase.

Operating Rules es donde reside el verdadero criterio: cómo analiza el código base, dónde establece los límites arquitectónicos y cómo gestiona las decisiones y los compromisos, en lugar de hacer suposiciones.

Output Contract fija la estructura de la respuesta final, para que no tengas que interpretar un formato diferente cada vez.

Quality Gates son las comprobaciones que debe superar antes de poder considerar que el trabajo está terminado.

Una vez que tienes esa estructura, el agente deja de comportarse como un chatbot y empieza a comportarse como un compañero de equipo que ya conoce tus convenciones.

Esta es una lista de los agentes de Claude que tengo.

Qué incluye: 25 agentes, 5 categorías

Foundation incluye los agentes a los que recurro antes que a cualquier otro: Project Planning, iOS Clean Architecture, iOS Code Review, Refactor y Python Quality.

Estos son los que determinan cómo debe abordarse una tarea desde el principio.

Mobile Specialists representa la mayor parte de lo que utilizo personalmente en mi trabajo diario: SwiftUI Architecture, UIKit, UIKit MVVM, iOS Performance & Memory, además de Android Kotlin y React Native para los trabajos multiplataforma que ocasionalmente llegan a mi escritorio.

Web, Backend & Data completa el conjunto para cualquier tarea que no sea estrictamente móvil:

Next.js Frontend, FastAPI Backend, PostgreSQL Database, Supabase Python, FastMCP Server y un Agno Agent Expert para quienes estén construyendo sus propios sistemas de agentes.

Quality, Security & Ops es la parte poco atractiva, pero necesaria: Test Automation, Security Audit, Kubernetes DevOps y un agente de Android Game C++ para trabajos de renderizado nativo.

Product & Docs es la capa en la que más me apoyo cuando trabajo en una aplicación real en producción: Product iOS App, Product Clean Code, Hybrid Mobile y Technical Docs.

Esto se debe a que las buenas prácticas genéricas y las convenciones reales de tu aplicación no siempre coinciden. Estos agentes están diseñados para dar prioridad al repositorio cuando ambas entran en conflicto.

12 formas de ahorrar tiempo en el desarrollo de iOS

12 formas de ahorrar tiempo en el desarrollo de iOS. Consejos que suelen pasarse por alto, pero que permiten ahorrar una cantidad considerable de tiempo...

21zerixpm.medium.com

Los agentes que utilizo en casi todos los proyectos

Como ingeniero de iOS, utilizo cinco de estos agentes constantemente, no solo de vez en cuando.

El iOS Clean Architecture Agent es al que recurro cada vez que una pantalla supera la fase de «simplemente colócalo en el view controller».

Obliga a establecer una separación real entre el renderizado, el mapeo de estados, los casos de uso y los servicios externos. Además, no permite que la lógica de negocio vuelva a introducirse silenciosamente en la capa de interfaz de usuario, que es precisamente el problema que hace que trabajar con un código base resulte doloroso dos años después.

El UIKit MVVM Agent y el agente de UIKit convencional cubren el resto de mi trabajo diario, ya que la mayor parte de mi trabajo se encuentra en un código base que combina UIKit y SwiftUI, en lugar de una aplicación SwiftUI completamente nueva y desarrollada desde cero.

El agente de MVVM es estricto con los contratos de entrada y salida del view model, y mantiene el view controller pasivo: enlaza los datos, renderiza y reenvía las acciones.

Esto hace que el resultado sea realmente comprobable mediante pruebas unitarias, en lugar de ser comprobable únicamente en teoría.

El iOS Performance & Memory Agent es en el que más confío, precisamente porque se niega a hacer suposiciones.

Exige una hipótesis y un plan de medición antes de modificar cualquier cosa: Instruments, signposts y comprobaciones de asignación de memoria. Optimiza la causa real en lugar de ocultar temporalmente un síntoma.

En una pantalla con muchas imágenes, esa disciplina marca la diferencia entre una solución real y una solución que parece haber funcionado hasta que se prueba en el siguiente dispositivo.

El iOS Code Review Agent es el que ejecuto antes de fusionar prácticamente cualquier cambio.

Comprueba ciclos de retención, actualizaciones de la interfaz de usuario en el hilo principal, cancelación de tareas asíncronas y desviaciones de la arquitectura. Además, clasifica los hallazgos por gravedad, en lugar de mostrar un enorme bloque de observaciones menores sobre estilo.

Eso significa que realmente leo el resultado, en lugar de revisarlo superficialmente.

Cómo transferir la memoria de tu IA de ChatGPT a Claude

Cómo transferir la memoria de tu IA de ChatGPT a Claude y por qué todos los desarrolladores deberían tener un perfil de IA. La mayoría de las personas...

21zerixpm.medium.com

Cómo utilizo realmente estos agentes

Todos los agentes del paquete comparten el mismo patrón inicial, y esta es la parte que importa más que cualquier instrucción individual:

Antes de editar, inspecciona los archivos relevantes e identifica los patrones existentes, en lugar de asumir que estás trabajando desde cero.

Señala los riesgos y redacta un plan breve con una lista de tareas para cualquier trabajo que requiera varios pasos.

Implementa únicamente el cambio definido. No realices reescrituras adicionales que no formen parte del alcance.

Finaliza indicando los archivos modificados, los comandos exactos utilizados para verificar los cambios, los resultados obtenidos y cualquier riesgo que continúe abierto.

Esa última parte es la que la mayoría de los prompts omite por completo, y es la que realmente permite ahorrar tiempo, porque dejas de tener que preguntar: «Espera, ¿esto se probó?».

Una versión básica de una de estas instrucciones se ve así cuando se pega en Claude Code:

---
trigger: <cuándo este agente es el adecuado>
mission: <la única responsabilidad que protege>
---

[pega aquí las instrucciones completas del agente]

[añade: ruta del repositorio, reglas de arquitectura, patrones prohibidos,
comandos de pruebas y linting, y tu definición de trabajo terminado]

Ese último bloque —la ruta del repositorio, las reglas de arquitectura y tus comandos reales de prueba— es lo que transforma a un especialista genérico en un agente que comprende específicamente tu aplicación, en lugar de ofrecerte consejos teóricos sobre iOS que ignoran las convenciones reales de tu equipo.

Gracias por leer Código en Casa.
Si esto te a ayudado y te sumo algo Dale un 👏 , compártelo con tu red o dejame un comentario para saber tu opinión.