i-have-adhd Starter Guide: mejora el flujo de tus AI Coding Agents

Si utilizas con frecuencia Claude Code, Codex, Cursor u otros AI Coding Agents, probablemente te hayas encontrado con un problema muy concreto: el Agent ya ha encontrado la respuesta, pero entierra lo que realmente tienes que hacer dentro de una larga explicación.

i-have-adhd está diseñado precisamente para abordar este problema. No es un modelo de IA ni una herramienta de gestión de tareas, sino un conjunto de reglas de comportamiento destinadas a cambiar la forma en que un Coding Agent presenta sus respuestas y avanza en una tarea. El README oficial lo resume como una forma de evitar que el Agent «entierre» la respuesta, priorizar las acciones, utilizar pasos numerados y mantener al usuario informado sobre el estado actual.

Su objetivo no es proporcionar al modelo mejores capacidades de programación, sino conseguir que un Coding Agent que ya funciona sea más directo y fácil de seguir.

Qué debes saber antes de utilizarlo por primera vez

i-have-adhd es, en esencia, un conjunto de reglas de comportamiento para Agents. A diferencia de un Prompt convencional, estas reglas pueden cargarse como un Skill dentro de un Coding Agent. Frente a configuraciones persistentes como AGENTS.md o Rules, también resulta más sencillo instalarlo, activarlo y modificarlo como un módulo independiente.

En otras palabras:

El modelo sigue siendo el mismo, el Coding Agent sigue siendo el mismo y lo que cambia es la forma en que organiza las respuestas y avanza en las tareas.

La documentación oficial de instalación cubre actualmente distintos entornos, entre ellos Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Qwen Code y Zed, aunque el método de instalación y activación no es exactamente igual en todos ellos.

Por eso, la primera vez no conviene copiar directamente el comando utilizado para otro Agent. Lo mejor es seguir el método de instalación oficial correspondiente al Agent que estés utilizando.

Paso 1: instalar i-have-adhd

Si tu Coding Agent admite un CLI genérico para Agent Skills, la forma más sencilla es:

npx skills add ayghri/i-have-adhd

Si utilizas principalmente Cursor, también puedes instalarlo específicamente para Cursor:

npx skills add ayghri/i-have-adhd -a cursor -y

El INSTALL.md oficial también proporciona métodos de instalación específicos para diferentes Agents. Por ejemplo, Claude Code utiliza su propio marketplace de plugins, Codex dispone de su propio plugin marketplace, Gemini CLI utiliza comandos o extensiones y GitHub Copilot puede cargar directamente Agent Skills.

Si utilizas Claude Code, puedes ejecutar:

claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

Después:

/i-have-adhd

En Codex:

codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd

A continuación se activa explícitamente mediante:

$i-have-adhd

La documentación oficial señala actualmente que Codex no activa automáticamente este Skill.

Paso 2: comprobar que el Skill ha sido reconocido

Que la instalación haya terminado correctamente no significa necesariamente que el Skill esté activo.

Con el CLI genérico de Agent Skills puedes comprobarlo mediante:

npx skills list

En Claude Code:

claude plugin list

En Codex:

codex plugin list

En Cursor y otros entornos compatibles con Agent Skills, puedes comprobar en una nueva sesión del Agent si i-have-adhd aparece entre los Skills disponibles. La documentación oficial también recomienda utilizar los puntos de entrada basados en / para confirmar que i-have-adhd está disponible.

Hay una diferencia importante que conviene recordar:

Instalación correcta ≠ Skill activado en la sesión actual.

Por ejemplo, Codex requiere utilizar explícitamente $i-have-adhd, mientras que Claude Code permite introducir /i-have-adhd. Gemini CLI también requiere invocarlo en una nueva sesión cuando se utiliza mediante su modo de comandos. Cada Agent tiene su propia lógica de activación.

Paso 3: no preguntes «¿quién eres?», haz directamente una tarea real

Para experimentar por primera vez con el Skill, es mejor no utilizar una pregunta sencilla.

Abre un proyecto real y dale una tarea como esta:

Ayúdame a corregir este Bug de inicio de sesión.
Primero analiza el problema y después dime qué archivos hay que modificar y empieza a solucionarlo.

Un Agent convencional podría comenzar explicando el flujo de autenticación, analizar varias posibles causas, ofrecer algunas recomendaciones y solo al final empezar a modificar el código.

i-have-adhd intenta invertir este orden.

El ejemplo de corrección de código incluido en el README oficial muestra precisamente este cambio: en lugar de una explicación extensa con advertencias y recomendaciones adicionales, el Agent pasa directamente a los comandos que hay que ejecutar, los archivos afectados, los pasos de modificación y los comandos de prueba, incluyendo qué hacer si las pruebas fallan.

Una estructura más cercana al comportamiento esperado sería:

Edita src/auth.ts:42.

1. Actualiza jsonwebtoken.
2. Modifica verifyToken.
3. Ejecuta las pruebas de auth.

Estado actual: paso 2.
Siguiente paso: ejecutar npm test -- auth.spec.ts.

Este es uno de los aspectos que más merece la pena probar personalmente con i-have-adhd.

¿Qué cambia realmente i-have-adhd?

Su objetivo principal no es simplemente hacer las respuestas más cortas, sino hacerlas más ejecutables.

Action First

Primero indica qué hay que hacer, en lugar de comenzar con una explicación extensa del contexto.

Numbered Steps

Cuando una tarea tiene varios pasos, los divide mediante una numeración limitada para que quede claro qué debe hacerse a continuación.

State Tracking

Durante un desarrollo de varias etapas, mantiene visible el estado actual en lugar de volver a explicar todo el problema en cada turno.

Concrete Time Estimates

Cuando es necesario estimar un tiempo, utiliza unidades concretas en lugar de expresiones como «espera un momento» o «será rápido».

Visible Wins

Cuando una modificación está terminada, indica claramente qué parte ya funciona para que el resultado sea evidente.

Matter-of-fact Errors

Cuando aparece un error, señala directamente dónde está, cuál es su causa y cómo solucionarlo, sin añadir grandes cantidades de lenguaje tranquilizador.

Suppress Tangents

Evita abrir recomendaciones o temas secundarios mientras la tarea principal todavía está pendiente.

One Next Step

Al final proporciona un siguiente paso claro, en lugar de presentar cinco o seis opciones simultáneamente.

Estas reglas encajan especialmente bien con los Coding Agents porque el desarrollo de software funciona como un proceso continuo de estados:

análisis → modificación → pruebas → corrección → nuevas pruebas

Si el Agent vuelve a explicar todo el contexto en cada turno, el desarrollador tiene que buscar continuamente entre grandes cantidades de texto para descubrir «qué hay que hacer ahora».

Experimenta con una tarea completa

Puedes probarlo con una tarea sencilla de Next.js:

Añade una función para cambiar el avatar en la página de configuración de usuario de este proyecto Next.js.
Primero revisa la estructura de código existente y después empieza a implementarla.

Un proceso razonablemente estructurado sería:

Revisar la página de configuración de usuario y el campo de avatar existente.

Después:

1. Localizar el componente de configuración.
2. Revisar la API del perfil de usuario.
3. Añadir el procesamiento de subida del avatar.
4. Actualizar la base de datos o la API del perfil.
5. Ejecutar las pruebas correspondientes.

El Agent debería informar del estado actual a medida que completa cada parte.

Si las pruebas fallan, en lugar de volver a escribir una explicación extensa, podría indicar directamente:

Prueba fallida: src/api/user.ts:84.

Causa: el endpoint de subida no procesa multipart/form-data.

Solución: actualizar la lógica de análisis de la petición.

Siguiente paso: volver a ejecutar las pruebas de la API de usuario.

Al finalizar:

La subida del avatar ya funciona.
Pruebas superadas: 8/8.

Siguiente paso: subir una imagen desde el navegador para verificar la UI real.

El cambio fundamental no es que el Agent haya adquirido de repente mejores capacidades de programación, sino que se reduce el coste de entender su estado actual, decidir qué hacer a continuación y mantener el trabajo en marcha.

¿Qué cambia en una conversación de varias rondas?

La prueba realmente interesante aparece con una tarea continua.

Primera ronda:

Primero revisa este Bug.

Segunda ronda:

Soluciónalo.

Tercera ronda:

Ejecuta las pruebas.

Cuarta ronda:

Las pruebas han fallado. Continúa trabajando en ello.

En ese momento puedes observar si el Agent sigue respondiendo de forma consistente a cuatro preguntas:

¿En qué paso estamos?

¿Qué se ha completado?

¿Qué problema existe ahora?

¿Cuál es el siguiente paso?

Esta es también una diferencia importante respecto a un simple Prompt de una sola ejecución: las reglas de i-have-adhd están diseñadas específicamente alrededor de un workflow de Coding Agent con múltiples rondas. Las reglas oficiales exigen mantener el estado visible, completar primero el problema actual y, después de cierto número de intentos fallidos, dejar de probar soluciones a ciegas y señalar las hipótesis que podrían estar equivocadas.

Errores habituales al empezar

Primero, instalarlo pero no activarlo. Especialmente en Codex, la documentación oficial indica actualmente que hay que utilizar explícitamente $i-have-adhd.

Segundo, pensar que mejorará automáticamente la calidad del código. Su objetivo principal es cambiar la organización de las respuestas y la interacción, no convertir el modelo en un programador más capaz.

Tercero, tratarlo como un gestor de tareas. No administra Issues, Sprints ni listas de tareas del proyecto. Su función principal es modificar la forma en que el Agent trabaja contigo.

Cuarto, pedirle al Agent que nunca explique nada para conseguir respuestas más cortas. Las reglas oficiales no significan «hablar siempre menos». Si el usuario solicita una explicación detallada, el Agent debe proporcionarla; las operaciones destructivas requieren confirmación y, cuando los requisitos no están claros, debe plantear una pregunta breve.

Quinto, ignorar las reglas propias del proyecto. i-have-adhd modifica principalmente la forma de salida y de interacción. Los AGENTS.md, Rules, estándares de pruebas y demás instrucciones del proyecto siguen teniendo que respetarse.

Cómo personalizarlo

Uno de los aspectos más interesantes de i-have-adhd es que, en esencia, consiste en un conjunto de reglas de comportamiento que se pueden leer y modificar.

El repositorio utiliza:

skills/i-have-adhd/SKILL.md

como canonical skill, es decir, como fuente principal de las reglas de comportamiento.

Si las reglas predeterminadas no encajan con tu forma de trabajar, puedes hacer Fork del proyecto, modificar este archivo e instalar tu propia versión. El README oficial también incluye un procedimiento específico para personalizarlo en Claude Code.

Otra posibilidad es no instalar el Skill y trasladar las reglas que te resulten útiles a AGENTS.md, Cursor Rules, las instrucciones de Copilot u otras configuraciones persistentes.

El INSTALL.md oficial proporciona métodos similares para Codex, Cursor, Copilot, OpenCode y otros entornos.

Esto significa que i-have-adhd no tiene por qué funcionar necesariamente como un plugin permanente.

También puede entenderse como una plantilla de normas de salida para Coding Agents.

Qué hacer después de la primera prueba

Primero, instala el Skill y completa una tarea sencilla de Coding.

Después, elige un Bug que requiera modificar varios archivos y observa cómo funcionan los pasos numerados y el seguimiento del estado.

A continuación, realiza entre 3 y 5 rondas consecutivas de desarrollo y comprueba si el Agent mantiene correctamente el estado de la tarea.

Después puedes modificar una o dos reglas, por ejemplo, ajustar las estimaciones de tiempo, la longitud de las listas o la forma de finalizar una tarea.

Por último, puedes trasladar las reglas que realmente quieras mantener a largo plazo a AGENTS.md o a la configuración persistente del Agent que estés utilizando.

Al final, probablemente la parte más interesante de i-have-adhd no sea hacer que la IA sea más inteligente.

Su objetivo es otro: partiendo de un Coding Agent que ya puede comprender, modificar y ejecutar código, conseguir que la respuesta llegue antes al usuario y que resulte mucho más fácil saber «qué hay que hacer ahora».

Para quienes utilizan AI Coding con frecuencia y consideran que las respuestas son demasiado largas, las explicaciones excesivas o el estado de la tarea poco claro, este tipo de cambio puede resultar más directo que simplemente añadir otro modelo.

FAQ

¿Qué es i-have-adhd?

i-have-adhd es un Skill para Coding Agents que utiliza un conjunto de reglas de salida e interacción para que el Agent dé más importancia a las acciones siguientes, los pasos numerados, el seguimiento del estado, los resultados visibles y las próximas acciones concretas. No es un modelo de IA ni una herramienta de diagnóstico o tratamiento del TDAH.

¿Cómo se instala i-have-adhd?

Si el Agent admite un CLI genérico de Agent Skills, puedes utilizar:

npx skills add ayghri/i-have-adhd

Algunos Agents también disponen de métodos de instalación propios. En esos casos, conviene seguir el INSTALL.md oficial.

¿Qué AI Coding Agents son compatibles con i-have-adhd?

La documentación oficial de instalación cubre actualmente Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Qwen Code y Zed, entre otros entornos, y continúa incorporando compatibilidad con otros Agents. Los métodos de instalación y activación varían según el entorno.

¿i-have-adhd se activa automáticamente?

No necesariamente. El comportamiento depende del Agent. Por ejemplo, Claude Code puede activarlo explícitamente mediante /i-have-adhd, mientras que Codex utiliza $i-have-adhd. Claude Code, OpenCode, Pi y otros entornos también ofrecen opciones de activación permanente.

¿Cuál es la diferencia entre i-have-adhd y AGENTS.md?

i-have-adhd es un Skill que puede instalarse, activarse y actualizarse de forma independiente, mientras que AGENTS.md funciona más como un archivo de reglas persistentes a nivel de proyecto o entorno. La documentación oficial también explica cómo trasladar las reglas de i-have-adhd a AGENTS.md.

¿Se puede utilizar i-have-adhd con Cursor y Codex?

Sí. En Cursor puedes instalarlo mediante Agent Skills CLI, por ejemplo:

npx skills add ayghri/i-have-adhd -a cursor -y

Codex dispone de un proceso independiente de instalación mediante plugins y utiliza $i-have-adhd para activarlo explícitamente.

¿i-have-adhd permite que la IA escriba mejor código?

Su objetivo principal no es mejorar la capacidad de generación de código del modelo, sino modificar la forma de salida y colaboración. La calidad del código sigue dependiendo del modelo utilizado por el Coding Agent, el contexto disponible, las reglas del proyecto, las herramientas y los resultados de las pruebas.

¿Se pueden modificar las reglas de i-have-adhd?

Sí. El proyecto utiliza skills/i-have-adhd/SKILL.md como canonical skill. Puedes hacer Fork, modificarlo y utilizar tu propia versión. También puedes trasladar las reglas que te resulten útiles a AGENTS.md, Rules u otras configuraciones persistentes del Agent.