Montamos la base de conocimiento que comparten producto, QA, desarrollo y sus IAs: los estándares técnicos, de QA y de desarrollo, versionados en el repositorio, y el conocimiento funcional del producto en un RAG con Qdrant que cualquier modelo puede consultar. Así el discovery parte de lo que el producto ya sabe y el código no depende de qué modelo use cada persona ni de sus prompts.
capas: estándares en el repositorio y producto en RAG
~0,1×
precio de releer la parte fija del contexto desde la caché
El problema
Qué duele hoy.
Cuando cada persona usa su modelo, sus prompts y su copia de las normas, el código acaba dependiendo de quién lo escribió y con qué herramienta.
Estándares de código y de QA en una wiki que la IA no lee y el equipo no recuerda.
Cada dev con sus propios prompts: el mismo problema resuelto de cinco formas distintas.
Reglas de negocio repartidas entre documentos, tickets y la cabeza de dos personas.
Documentación entera pegada en el prompt: caro, lento y sin saber de dónde sale cada respuesta.
Qué hacemos con IA
Lo que hacemos contigo.
01
Estándares en el repositorio, exigidos en CI
Reglas técnicas, de QA y de desarrollo en un AGENTS.md, skills y guías versionadas junto al código, que lee cualquier agente sea cual sea el modelo. Las reglas orientan; los hooks, los tests y la integración continua obligan: lo que no cumple el estándar no se mergea.
02
RAG de producto con Qdrant
Reglas de negocio, especificaciones y decisiones indexadas en Qdrant, clasificadas (regla o referencia, vigente o en revisión) y servidas por API a cualquier modelo o agente, con un presupuesto de tokens por pregunta.
03
Un chat que cita sus fuentes
Un chat con IA generativa sobre el contexto de vuestro producto y vuestras reglas. Cada respuesta cita el documento del que sale y, si la base no tiene la respuesta, lo dice en vez de inventarla.
04
Discovery con el contexto del producto
Producto pregunta por reglas de negocio, casos de uso y decisiones anteriores, y hace el discovery sobre lo que el producto ya sabe: del chat sale el business case, y de ahí épicas e historias con criterios en Gherkin, con la fuente citada.
La IA revisa cada pull request contra los estándares de vuestra organización, no contra los suyos. Ya lo hemos montado para un cliente, con sus reglas de desarrollo estandarizadas en una base compartida.
La base la escriben y la mantienen vuestros profesionales; la IA la consulta. Delegamos en la IA la escritura del código, pero las reglas que la guían, el criterio y las decisiones son siempre de las personas.
La IA
Consulta las reglas y el contexto del producto antes de escribir.
Responde citando la fuente de cada afirmación.
Revisa código y tests contra el estándar de la organización.
Avisa cuando la base no tiene la respuesta.
Nuestros profesionales
Escriben y aprueban las reglas, como cualquier cambio de código.
Deciden qué es regla obligatoria y qué es referencia.
Marcan qué está vigente y qué hay que revisar.
Revisan las respuestas y corrigen la base cuando falla.
Cómo se nota
Antes y con IA.
Estándares
Antes
En una wiki que nadie lee
Con IA
Versionados en el repositorio y leídos por cualquier agente
Consistencia del código
Antes
Depende del modelo y del dev
Con IA
Mismas reglas para todos, exigidas en CI
Discovery
Antes
Cada iniciativa empieza de cero
Con IA
Parte de lo que el producto ya sabe, con fuentes
Conocimiento de producto
Antes
Repartido en documentos y personas
Con IA
Consultable por API y por chat, con citas
Coste de contexto
Antes
Documentación entera en cada prompt
Con IA
Solo lo relevante, con presupuesto y caché
Stack
Con qué trabajamos.
Base de conocimiento
QdrantBM25Clasificación regla / referencia
Estándares
AGENTS.mdSkillsHooksIntegración continua
API y chat
FastAPIClaudeAPI agnóstica del proveedorPrompt caching
Evaluación
Golden setrecall@kMRRnDCG
Prueba
Lo hemos montado en casa y en cliente.
LeanPortfolio
El módulo de contexto de producto de nuestra plataforma, en piloto: sirve reglas y referencias por API a cualquier modelo, con presupuesto de tokens, caché de la parte fija y citas a la fuente. Lo consumen su chat de Discovery, que genera el business case, y la generación de épicas e historias.
2.000
tokens de reglas por conversación, por defecto
1.500
tokens de contexto por pregunta, por defecto
Revisión de PRs para un cliente
Revisión de pull requests con IA a partir de las reglas y estándares de desarrollo del cliente, estandarizados en una base compartida.
Preguntas frecuentes
Dudas habituales.
¿Necesitamos un RAG para nuestros estándares de código?
Normalmente no. Los estándares técnicos y de QA caben enteros en el contexto y funcionan mejor versionados en el repositorio, junto al código. El RAG tiene sentido para el conocimiento de producto: mucho volumen, que cambia y no cabe entero.
¿De verdad ahorra tokens?
Frente a meter toda la documentación en cada prompt, sí: solo entra lo relevante, con un presupuesto fijo, y la parte estable va en caché, que los principales proveedores cobran a una fracción del precio normal. Frente a no dar contexto, añade tokens, pero evita respuestas inventadas. Y si vuestra base es pequeña os lo diremos: a veces basta con meterla entera y cachearla.
¿Funciona con cualquier modelo?
Sí. La base y la búsqueda no dependen de ningún modelo: se consultan por API desde Claude, OpenAI, Gemini o un agente propio. Cambiar de modelo no obliga a cambiar las reglas.
¿Sirve solo para equipos técnicos?
No. Producto la usa para preguntar por reglas de negocio y hacer discovery sobre lo que ya existe; QA y desarrollo, para trabajar con el mismo estándar. Es la misma base para todos.
¿Cómo sabéis que encuentra lo correcto?
Lo medimos. Preparamos un conjunto de preguntas reales con su respuesta esperada y comprobamos si la búsqueda trae el fragmento correcto (recall@k, MRR) antes de dar la base por buena, y volvemos a medir cuando cambia.
¿Y la seguridad?
Qdrant se puede autoalojar, así que la base puede vivir en vuestra infraestructura. El contenido recuperado se marca como dato no fiable y las instrucciones fijas le dicen a la IA que no siga órdenes que aparezcan dentro de un documento.
¿Cómo empezamos?
Con una sesión de 30 minutos para ver dónde viven hoy vuestras reglas y vuestro conocimiento de producto. De ahí sale qué va al repositorio, qué va al RAG y por dónde empezar.