Construí una base de conocimiento de variación infinita que la IA puede consultar: así es como Kiro lo hizo posible

¿Alguna vez abriste un enlace en tu app de notas y al momento olvidaste qué estabas viendo antes? Esa frustración me llevó a crear NEXUS una plantilla de base de conocimiento en la que al hacer clic en un enlace se abre un panel nuevo a la derecha del actual, no en su lugar. Lo curioso es que lo desarrollé en un fin de semana durante el Kiroween Hackathon gracias a las funciones de Kiro que convirtieron lo que habría sido un mes de trabajo en una carrera de fin de semana.

El problema: las herramientas de conocimiento están rotas. Probé de todo: Obsidian tiene buen enlazado pero al clicar pierdes el contexto; GitBook funciona para documentación lineal pero no para explorar conexiones; Notion es versátil pero no sobresale; las notas de Andy Matuschak son geniales para apilar paneles pero no son open source. Quería combinar apilamiento horizontal con navegación lineal y vista gráfica, y además que fuera nativa para IA de manera que asistentes como Claude pudieran consultar la base de conocimiento directamente.

Presento NEXUS: una plantilla esqueleto que permite infinitas variaciones. Con una misma base de código se pueden crear experiencias totalmente distintas solo cambiando la configuración. Para demostrarlo desarrollé dos aplicaciones con el mismo core: Arcana un baúl personal de conocimiento oscuro y místico y Codex una documentación de API clara y profesional. Mismos fundamentos, configuraciones YAML distintas y experiencias completamente separadas.

Aquí está lo que cambió todo: no solo usé Kiro sino que aproveché todas sus características y la combinación resultó más potente que cada pieza por separado.

1 Especificaciones como motor de desarrollo Antes de escribir código diseñé especificaciones con fases de requisitos diseño y tareas. Para la navegación de múltiples paneles planteé requisitos claros Cuándo un usuario hace clic en un wikilink entonces el sistema deberá abrir un nuevo panel a la derecha y simultáneamente mantener visible el anterior, cómo hacerlo con un NavigationContext un useReducer y un contenedor de scroll horizontal con snap points y qué pasos eran necesarios Crear el contexto implementar la acción OPEN_PANE añadir el contenedor y enlazar los manejadores de clic. En total creé 16 especificaciones que mantuvieron a Kiro enfocado y evitaron la típica deriva de alcance.

2 Hooks de agentes Automatización que realmente funciona Configuré tres hooks automáticos que se ejecutan en cada guardado Revisión de calidad de código que arregla errores TypeScript y añade imports faltantes Generador de documentación para componentes React que añade JSDoc y un escáner de secretos que detecta claves expuestas antes de hacer commit. El resultado cada archivo guardado se tipaba y corregía automáticamente se documentaba y se escaneaba evitando lint manual y commits con credenciales filtradas.

3 Documentos de dirección Contexto que persiste El gran problema de los asistentes es que olvidan entre sesiones. Los steering documents de Kiro solucionan eso. Creé tres archivos en la carpeta de configuración técnica tech md structure md y product md que contienen pila tecnológica convenciones y el producto NEXUS con sus tres modos de navegación horizontal lineal y gráfica. Cada nuevo chat con Kiro ya sabía qué librerías usar cómo estructurar el código y qué funciones existen eliminando correcciones recurrentes.

4 Integraciones MCP No más documentación alucinada Los modelos de IA a veces inventan APIs o usan firmamentos de versiones antiguas. Con integraciones MCP conecté Kiro a fuentes auténticas de documentación Next.js React Query Tailwind y otras para que las sugerencias reflejen la API real y vigente. Un ejemplo pequeño pero crítico cambiar useQuery usuarios por la forma correcta en React Query v5 con queryKey como array ahorra horas de depuración.

Aspectos destacados del desarrollo Algunos retos fluyeron por conversación en vez de especificación Por ejemplo Crear un parser de wikilinks que extraiga [[enlaces]] y maneje alias [[Titulo|texto mostrado]] resultó en un módulo links ts completo con regex manejo de alias y sugerencias de autocompletado. Implementar un endpoint MCP que exponga notas como herramientas para agentes IA se hizo con list_pages get_page search y ask con validación de entradas. Crear un componente de grafo local fue una visualización SVG con fuerza dirigida y transiciones animadas. Cada una de estas piezas que habría llevado un día investigarlas se resolvió en una hora gracias a Kiro.

La parte IA nativa es lo que más me enorgullece Cada despliegue de NEXUS puede exponerse como servidor MCP de forma que asistentes como Claude pueden recibir queries directas desde tu base de conocimiento Apunta tu cliente a la API y pregunta qué notas mencionan autenticación resume patrones de React o cómo se conectan tres conceptos Tu documentación personal o corporativa se vuelve consultable por agentes IA y así cerramos el ciclo de usar IA para construir herramientas para IA.

Números clave 16 especificaciones para funciones mayores 3 hooks de agente automatizando calidad 3 documentos de steering manteniendo contexto 3 integraciones MCP para documentación precisa 2 aplicaciones distintas creadas desde un mismo código 1 fin de semana para montar todo esto Sin Kiro esto habría sido un proyecto de un mes la combinación de especificaciones hooks steering e integraciones MCP creó un flujo de desarrollo nunca antes experimentado.

En Q2BSTUDIO como empresa de desarrollo de software y aplicaciones a medida nos especializamos en llevar ideas a productos reales ofreciendo software a medida servicios de inteligencia artificial y ciberseguridad además de servicios cloud AWS y Azure y soluciones de inteligencia de negocio. Si buscas integrar agentes IA en tu organización o mejorar tus procesos con automatización podemos ayudarte explora cómo trabajamos con soluciones de software a medida y descubre nuestros servicios de inteligencia artificial diseñados para ia para empresas que necesitan seguridad y escalabilidad.

Qué aprendí Las especificaciones evitan el scope creep cuando la IA sabe exactamente qué construir los hooks eliminan trabajo repetitivo permitiéndote centrarte en valor real los steering documents son la diferencia entre un asistente y un compañero de equipo y las integraciones MCP aseguran respuestas precisas en lugar de contenido alucinado. El futuro del desarrollo no es que la IA reemplace a los desarrolladores sino que los potencie Kiro me mostró cómo se ve eso en la práctica.

¿Quieres probar NEXUS o construir una base de conocimiento consultable por IA para tu empresa? En Q2BSTUDIO desarrollamos aplicaciones a medida integrando ciberseguridad despliegues en la nube y soluciones de business intelligence como Power BI para que tus datos trabajen para ti contacta con nosotros para convertir ideas en productos seguros y escalables.