Proyectos

Herramienta interna · IA y automatización

Cerebro

Un espacio de conocimiento compartido para el equipo: contexto, reglas y decisiones de los proyectos, disponibles para developers y agentes de IA.

Rol
Concepto, diseño y desarrollo
Empresa
Bigbuda
Año
2025–2026
  • Node.js
  • Claude API
  • MCP
  • Supabase
  • Astro

Resumen del caso

Problema
El contexto de cada proyecto (reglas, decisiones y estado) vivía en la cabeza de quien lo había desarrollado. Retomar un proyecto ajeno o cambiar entre varios tenía un costo alto.
Usuario y contexto
Un equipo de Bigbuda con proyectos de Webflow, Shopify y WordPress en paralelo, donde developers y agentes de IA necesitaban el mismo contexto.
Mi responsabilidad
Detecté el problema, propuse Cerebro, construí la primera versión y su arquitectura por dominios, y dejé el repositorio abierto para que el equipo lo ampliara.
Decisión difícil
Separar el conocimiento por dominio, Webflow y Shopify, en vez de un solo cerebro. Un contexto más pequeño resultó más preciso y más fácil de mantener.
Evidencia
Lo usaron 4 personas en 8 a 12 proyectos. Permitió traspasar trabajo durante vacaciones y después de mi salida. Con Cerebro y otros flujos con IA, la carga pasó de 2 a 2–3 proyectos activos por developer (ClickUp).
Estado actual
Hasta donde sé, el equipo lo sigue usando. La reducción de preguntas repetidas está pendiente de medición.

Antes, intervención y resultado

Antes

  • El conocimiento de cada proyecto estaba repartido entre personas y herramientas.
  • La documentación existía, pero había que encontrarla, interpretarla y mantenerla al día.
  • Retomar un proyecto ajeno exigía reconstruir qué existía, qué se decidió y cómo continuar.
  • Cada proyecto dependía de quien lo había desarrollado.
  • Los agentes de IA trabajaban sin el contexto del proyecto.

Intervención

  • Reglas, decisiones, documentación y estado de cada proyecto, reunidos como contexto consultable.
  • La misma fuente para developers y agentes de IA.
  • Integraciones con Figma, Webflow y Shopify mediante MCP.
  • Repositorio abierto al equipo, para que cada persona pudiera corregirlo y ampliarlo, y para que lo aprendido en cada proyecto volviera al cerebro correspondiente.
  • Adopción en el trabajo diario del equipo.

Resultado

personas del equipo lo usaron
4
proyectos cubiertos, aproximadamente
8–12
proyectos activos por developer, con Cerebro y otros flujos asistidos por IA Fuente: Seguimiento en ClickUp
2 → 2–3
  • Cuando una persona salió de vacaciones, el equipo pudo continuar su trabajo con el contexto de Cerebro.
  • Cuando dejé Bigbuda, el equipo incorporó mis proyectos a sus tareas.
  • El CTO encontró oportunidades de mejora y perfeccionó partes del sistema, y otro developer empezó a sumar sus propias skills.
  • Hasta donde sé, el equipo lo sigue usando después de mi salida.

Sin evidencia todavía

  • Reducción de preguntas repetidas: pendiente de medición.
  • Onboarding de personas nuevas: sin evidencia, porque nadie nuevo se incorporó durante mi periodo.

Arquitectura de Cerebro

Cerebro Global consulta experiencia transversal de Cerebro Webflow y Cerebro Shopify. Cada cerebro especializado reúne proyectos, fuentes y acceso compartido para developers, agentes y skills. La explicación completa continúa en las secciones siguientes.

Arquitectura de Cerebro

Arquitectura de Cerebro: Cerebro Global consulta experiencia transversal de Cerebro Webflow y Cerebro Shopify. Cada cerebro especializado reúne proyectos alimentados por Webflow o Shopify, Figma, documentación, Gmail y ClickUp. Developers, agentes y skills comparten el contexto para replicar o agregar funcionalidades y resolver incidencias durante desarrollo, QA y entrega. Las decisiones y aprendizajes actualizan el conocimiento y permiten crear nuevos cerebros especializados.

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 y aprendizajes, y gran parte quedaba en la cabeza de una persona. Quería armar algo como una burbuja para todos: que cada uno pudiera trabajar con autonomía, pero conectado al conocimiento del equipo.

El costo de volver a entender un proyecto

Entrar a un proyecto existente no consiste solamente en abrir el código o revisar un diseño. También es necesario entender qué se construyó, por qué se hizo de esa manera, qué reglas se deben respetar, qué problemas ya se resolvieron y cuál es el estado actual.

Cuando esa información está separada entre documentación, herramientas de gestión, correos y conocimiento individual, cambiar de proyecto toma tiempo y aumenta la posibilidad de repetir errores o tomar decisiones sin suficiente contexto. La documentación tradicional ayuda, pero sigue siendo pasiva: alguien debe encontrarla, decidir qué parte importa y traducirla al trabajo que está realizando.

¿Cómo podemos convertir la experiencia de proyectos reales en contexto disponible durante el trabajo, y no solamente en documentación para consultar después?

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 múltiples proyectos. Esos proyectos son la fuente real del conocimiento. El objetivo no es copiar todo el contenido de las herramientas externas, sino transformar información dispersa en contexto útil 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, sin depender tanto 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 depende menos de conversaciones o de la memoria de una persona.

El sistema no aprende solo ni modifica su comportamiento sin control: mejora porque el equipo incorpora, valida y organiza conocimiento nuevo.

  1. Tarea
  2. Developer + Agent + Skills
  3. Desarrollo
  4. QA
  5. Entrega
  6. Aprendizajes y decisiones
  7. Contexto actualizado
  8. Próxima 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: el contexto de cada proyecto quedaba en la cabeza de quien lo había desarrollado.
  • Propuse Cerebro y construí la primera versión.
  • Organicé reglas, documentación, decisiones y estado de cada proyecto como contexto que se puede consultar durante el trabajo.
  • Conecté los agentes con las herramientas del equipo mediante MCP.
  • Separé el conocimiento por dominio, Webflow y Shopify, cuando un solo contexto se volvió demasiado amplio.
  • Dejé el repositorio abierto para que el resto del equipo pudiera corregirlo y ampliarlo.
  • Planteé Cerebro Global como siguiente capa, para consultar conocimiento entre dominios.

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.

Lo que aprendí

Lo que más me gustó fue ver que otros lo mejoraban. Una herramienta así funciona de verdad cuando deja de depender de quien la creó.

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 hizo el sistema más preciso y más fácil de mantener.

Una arquitectura en evolución

Hasta donde sé, el equipo sigue usando y ampliando Cerebro después de mi salida. La idea no es automatizar todas las decisiones, sino que el contexto esté disponible cuando hace falta.

Stack

  • Node.js
  • Claude API
  • MCP
  • Supabase
  • Astro

Integraciones conceptuales

  • Figma
  • Webflow
  • Shopify
  • Documentación
  • Gestión de proyectos
  • Comunicación interna