Internal Tool · IA & Automatización
Cerebro
Convertir la experiencia acumulada en los proyectos en contexto compartido para developers, agentes y equipos no técnicos.
- Rol
- Concepto, diseño y desarrollo
- Empresa
- Bigbuda
- Año
- 2025–2026
- Node.js
- Claude API
- MCP
- Supabase
- Astro
Arquitectura de Cerebro
El conocimiento crecía, pero seguía disperso
En Bigbuda participé en proyectos desarrollados con Webflow, Shopify y WordPress, alternando entre desarrollo, QA, entrega y mantenimiento.
Con cada proyecto se acumulaban decisiones, reglas, documentación y aprendizajes. Cerebro nació para convertirlos en contexto compartido para developers y agentes, sin reconstruir la historia de cada proyecto desde cero.
El costo de volver a entender un proyecto
Entrar a un proyecto existente no consiste solamente en abrir el codigo o revisar un diseno. Tambien es necesario entender que se construyo, por que se hizo de esa manera, que reglas se deben respetar, que problemas ya se resolvieron y cual es el estado actual.
Cuando esa informacion esta separada entre documentacion, herramientas de gestion, correos y conocimiento individual, cambiar de proyecto toma tiempo y aumenta la posibilidad de repetir errores o tomar decisiones sin suficiente contexto. La documentacion tradicional ayuda, pero sigue siendo pasiva: alguien debe encontrarla, decidir que parte importa y traducirla al trabajo que esta realizando.
Como podemos convertir la experiencia de proyectos reales en contexto disponible durante el trabajo, y no solamente en documentacion para consultar despues?
Un solo Cerebro no era suficiente
La primera aproximación reunía todo en una infraestructura. Centralizarlo ayudó, pero a mayor cantidad de tecnologías y proyectos, más amplio y menos preciso se volvía el contexto.
La arquitectura evolucionó hacia cerebros especializados: Webflow no necesita cargar decisiones de Shopify, ni Shopify reglas que solo tienen sentido en Webflow.
Contexto especializado por tecnología
Cerebro Webflow reúne el contexto de proyectos Webflow y Cerebro Shopify hace lo mismo con Shopify. Ambos pueden conectarse con fuentes similares, pero separan su conocimiento operativo.
Esto entrega contexto más enfocado, reduce información irrelevante y permite añadir nuevos dominios sin diluir los existentes.
El conocimiento vive en los proyectos
Cada cerebro contiene multiples proyectos. Esos proyectos son la fuente real del conocimiento. El objetivo no es copiar todo el contenido de las herramientas externas, sino transformar informacion dispersa en contexto util para una tarea concreta.
- Reglas y convenciones
- Decisiones técnicas
- Estado y estructura del proyecto
- Funcionalidades, problemas resueltos y hallazgos de QA
- Patrones y contexto para continuar el trabajo
Una fuente compartida para todo el equipo
Developers, agentes y skills acceden al mismo contexto especializado del proyecto: qué existe, cómo se organiza, qué decisiones se tomaron y qué validar antes de entregar.
El developer sigue tomando las decisiones. Cerebro ayuda a investigar, comparar, recordar y ejecutar con mayor continuidad.
Replicar una funcionalidad
Un developer puede consultar antecedentes y patrones de una funcionalidad existente en otro proyecto del mismo dominio antes de reproducirla, sin reconstruir todo el razonamiento desde cero.
Agregar una nueva funcionalidad
Antes de proponer una solución, el developer y su agente revisan reglas del proyecto, decisiones anteriores y componentes existentes para mantener una implementación consistente.
Entrar a un proyecto existente
Una persona que no desarrolló originalmente el proyecto puede obtener una vista inicial de su estructura, decisiones y estado, reduciendo la dependencia de quien lo conoce de memoria.
El contexto también mejora las herramientas
Los agentes funcionan dentro del flujo de cada developer y las skills definen capacidades para tareas concretas. Ambos utilizan el contexto que entrega el cerebro especializado.
El valor no está solo en el modelo: depende de información adecuada, herramientas limitadas a la tarea y una colaboración consistente con una persona.
Developer + Agent + Skills + Contexto del proyecto
Cada proyecto hace más útil al siguiente
Durante el desarrollo aparecen decisiones, correcciones y hallazgos de QA. Cuando esa información vuelve al cerebro correspondiente, el conocimiento deja de depender de conversaciones o memoria individual.
El sistema no aprende solo ni modifica su comportamiento sin control: mejora porque el equipo incorpora, valida y organiza conocimiento nuevo.
- Tarea
- Developer + Agent + Skills
- Desarrollo
- QA
- Entrega
- Aprendizajes y decisiones
- Contexto actualizado
- Proxima tarea
Una visión transversal para otras áreas
Cerebro Global es la siguiente capa de la arquitectura: una visión transversal diseñada para consultar conocimiento resumido entre dominios, sin mezclar el contexto operativo de cada cerebro especializado.
Está pensado para apoyar reuniones, estimaciones iniciales y propuestas, orientando qué solución encaja mejor, qué antecedentes existen y qué dudas conviene resolver. Las personas responsables siguen revisando las respuestas.
Mi participación
- Detecté el problema de pérdida y transferencia de contexto entre proyectos.
- Definí el concepto inicial de Cerebro.
- Diseñé la evolución hacia una arquitectura de conocimiento especializada por dominio.
- Modelé los proyectos como unidades de contexto consultable.
- Diseñé la relación entre developers, agentes, skills y herramientas externas.
- Implementé la infraestructura para organizar reglas, documentación, decisiones y estado.
- Trabajé con MCP como capa de conexión entre agentes y herramientas.
- Orienté el sistema al uso durante desarrollo y QA, no solamente al almacenamiento de información.
- Diseñé flujos para incorporar aprendizajes generados durante el trabajo.
- Exploré una capa transversal destinada a consultas de áreas no técnicas.
Decisiones relevantes
Separar el conocimiento por dominio
Un contexto más pequeño y especializado es más útil que uno amplio que intenta cubrir todas las tecnologías.
Mantener una fuente compartida
Developers y agentes trabajan con la misma información para reducir contradicciones y conocimiento aislado.
Mantener al developer dentro del flujo
Los agentes ayudan a recuperar contexto y ejecutar tareas, pero las personas validan decisiones y resultados.
Separar contexto operativo y transversal
Los cerebros especializados ayudan a ejecutar; Cerebro Global está diseñado para consultar experiencia entre dominios.
Qué cambió con Cerebro
Cerebro permitio establecer una forma mas estructurada de conservar y utilizar el conocimiento generado durante los proyectos. El sistema ayuda a:
- Reducir el tiempo necesario para volver a comprender un proyecto.
- Facilitar que otro developer se incorpore y mantener continuidad entre desarrollo, QA y mantenimiento.
- Reutilizar aprendizajes sin copiar soluciones de manera ciega.
- Trabajar con agentes que conocen las reglas relevantes del proyecto.
- Disminuir la dependencia del conocimiento individual y dar a otras áreas una forma de consultar experiencia técnica acumulada.
Lo que aprendí
El principal desafío al incorporar IA no siempre está en el modelo: la calidad depende del contexto, las herramientas, los límites del flujo y la validación humana.
Centralizar todo no produce necesariamente mejores respuestas. Separar por dominio hace que el sistema sea más preciso y mantenible; cuando la documentación participa en el trabajo diario, se convierte en infraestructura.
Una arquitectura en evolución
Cerebro continúa evolucionando a partir de proyectos reales. La arquitectura permite explorar nuevos dominios y flujos para perfiles técnicos y no técnicos, sin buscar automatizar todas las decisiones.
Stack
- Node.js
- Claude API
- MCP
- Supabase
- Astro
Integraciones conceptuales
- Figma
- Webflow
- Shopify
- Documentación
- Gestión de proyectos
- Comunicación interna