Si pones a cinco desarrolladores a trabajar con cinco herramientas de codificación con IA diferentes, lo más probable es que obtengas cinco resultados distintos para el mismo ticket. Cada integrante del equipo utiliza un conjunto diferente de prompts y ha desarrollado hábitos distintos al trabajar con un determinado agente de IA. Una persona copiará y pegará los requisitos manualmente en una ventana de chat. Otra podría pasar por alto los criterios de aceptación especificados en una página de Confluence. La IA es perfectamente capaz de generar algo plausible, pero a menudo se ve obligada a adivinar el contexto que estuvo a una pestaña de distancia todo el tiempo.
Helper AI
La Importancia de un Contexto Compartido
La parte difícil de adoptar IA en un equipo de ingeniería es asegurarse de que el modelo realmente entienda el trabajo, sin importar lo bueno que sea. Al final, cada desarrollador termina creando sus propios prompts, sus propias convenciones y atajos, y su propia forma de copiar un ticket en una ventana de chat. El problema es que esto genera resultados inconsistentes y no hay una forma confiable de saber por qué el trabajo asistido por IA de un desarrollador se ve diferente al de otro.
HAI simplemente hace que las herramientas que tu equipo ya utiliza funcionen mejor juntas. Prioriza la consistencia por encima de la comodidad: todos deben ponerse de acuerdo desde el principio en una única forma de trabajar. Los beneficios son claros: todo el equipo obtiene el mismo contexto, las mismas herramientas y muchos menos resultados inconsistentes que resolver más adelante.
Características de HAI
- HAI se adapta a tu proyecto y las herramientas de IA que tu equipo ya utiliza. Tras la configuración, ofrece un comando para adaptar los prompts y agentes a la estructura y el código de tu proyecto, evitando el uso de textos genéricos. Se configura dentro de tu agente de programación por IA preferido y se ajusta a la configuración de cada herramienta, por lo que no es necesario hacer nada manualmente. Los equipos que no tengan una preferencia marcada por un editor también pueden confiar en la configuración general de HAI, que funciona en cualquier entorno.
- Convierte tickets y especificaciones en información útil para la IA. Las incidencias de Jira y las páginas de Confluence se descargan como archivos de texto legibles, incluyendo comentarios, enlaces y estructura. Si un ticket hace referencia a otros, estos también se recuperan, permitiendo que la IA obtenga una visión global en lugar de un ticket aislado sin contexto.
- Gestiona capturas de pantalla y archivos adjuntos. Los archivos adjuntos a un ticket suelen requerir inicio de sesión, lo que normalmente impide que una IA pueda verlos. HAI recupera esos archivos con las credenciales adecuadas y los pone a disposición de forma local.
- Divide el trabajo de forma eficiente. Internamente, HAI utiliza un conjunto de roles especializados: uno que investiga la tarea, otro que la planifica, otros dedicados a escribir código de backend, frontend y refactorización, y otros que revisan el resultado para garantizar la seguridad y la precisión. Estos roles trabajan en paralelo en lugar de forma secuencial, lo que reduce el tiempo desde el ticket hasta el código funcional.
- Reduce el trabajo con tickets a un solo comando. Una vez configurado, el desarrollador solo tiene que proporcionar a HAI el número de ticket de Jira y el sistema se encarga del resto: extraer el contexto, investigar el código base, redactar un plan y, tras su aprobación, implementar el cambio.
¿Para Quién Está Pensado HAI?
Está diseñado para:
- Líderes que buscan estandarizar la forma en que su equipo utiliza la IA. Los desarrolladores tienden naturalmente a preferir herramientas diferentes. HAI les permite mantener esa preferencia mientras garantiza que el flujo de trabajo subyacente y los resultados que produce se mantengan consistentes.
- Equipos que trabajan con Jira y Confluence, donde el ticket y la especificación que lo describe se encuentran en lugares distintos a los que un asistente de IA no puede acceder por sí solo. HAI cierra automáticamente esa brecha.
- Organizaciones que no quieren otra plataforma, base de datos o panel de control, y prefieren tener los tickets y las especificaciones como archivos que puedan leer, revisar, versionar mediante commits como cualquier otro archivo del repositorio. HAI no introduce un nuevo panel de control ni una nueva base de datos que administrar.
- Líderes de ingeniería que están cansados del "conocimiento tribal" y buscan unificar el uso de la IA. En otras palabras, personas que quieren que el asistente de cada desarrollador esté configurado de la misma forma, en lugar de depender de cómo cada uno decidió configurarlo.
Primeros Pasos
La configuración se realiza una sola vez y está diseñada para ser sencilla.
1npm install -g @2amtech/hai
2hai initAl ejecutar hai init, el equipo es guiado para elegir un proveedor de IA y definir de dónde deben obtenerse los tickets y las especificaciones. También ejecuta automáticamente la primera sincronización, por lo que no hay un paso de configuración adicional antes de empezar a usar la herramienta. Según sus preferencias, los equipos pueden:
- Conectar HAI con Jira y Confluence.
- Apuntar HAI a archivos locales si prefieren mantener la documentación en el repositorio.
- Omitir por completo la integración con tickets y utilizar HAI únicamente por su flujo de trabajo compartido y sus roles.
Gratuito, de Código Abierto y con Licencia Apache 2.0
HAI se distribuye bajo la licencia Apache 2.0, lo que significa que puedes usarlo, modificarlo e incorporarlo en proyectos comerciales sin restricciones. Los datos obtenidos de fuentes externas, como tickets, especificaciones y credenciales, permanecen en tu equipo y, de forma predeterminada, se excluyen de Git. HAI no añade una capa de servicios propietaria ni redirige los datos de tu proyecto a través de infraestructura adicional.
En otras palabras, todos los datos siguen siendo tuyos y se mantienen de forma local; nada se envía a un servidor. No hay ningún sistema nuevo que administrar.
Si tu equipo ya está repartido entre distintos editores de código con IA, o si el contexto sigue perdiéndose entre el ticket, la especificación de Confluence y la IA que realiza el trabajo, HAI realmente vale la pena.
