Kaddo

Kaddo es un toolkit open source de Knowledge Driven Development (KDD) que ayuda a proyectos nuevos, pre-IA y legacy a construir una capa de conocimiento viva cerca del código. Estructura el conocimiento del producto, gestiona el ciclo de vida completo de Work Items — desde la intención capturada hasta el handoff de implementación, evidencia y verificación — y mantiene el conocimiento vivo mientras el sistema evoluciona.

El CLI prepara y estructura el contexto; tus agentes LLM lo convierten en entendimiento del producto. El ahorro de tokens es una consecuencia, no el objetivo.

Toolkit KDD · CLI + MCP + Admin + Agents · Bilingüe (EN/ES) · Open Source

kaddo

# Inicia un proyecto nuevo
$ npx @kaddo/cli init
$ kaddo bootstrap

# Prepara contexto para tu LLM
$ kaddo scan
$ kaddo add agents
$ kaddo context

# Crea un Work Item y avanza por el lifecycle
$ kaddo create —from roadmap
$ kaddo verify
$ kaddo guard
FYI src/payments/payments.service.ts coincide con WI-001
    WI-001 no se modificó en este diff — considera revisarlo.

De código disperso a conocimiento de producto observable.

¿Por qué Kaddo?

Tu proyecto ya tiene conocimiento. Solo está disperso.

En proyectos nuevos, las decisiones desaparecen rápido. En proyectos pre-IA, el contexto nunca se preparó para los agentes. En proyectos legacy, el conocimiento suele vivir en la cabeza de las personas. Con IA, esto empeora: los agentes construyen sobre suposiciones cuando les falta contexto.

Kaddo mantiene el conocimiento mínimo necesario vivo junto al código — sin convertir el desarrollo en burocracia.

El modelo de conocimiento

Kaddo organiza el conocimiento en cuatro capas: Business, Product, Tech y Delivery. Cada una alimenta a la siguiente. Los agentes no adivinan — leen contexto estructurado.

Business

Problema, usuarios, propuesta de valor, restricciones — por qué existe el proyecto.

Product

Capacidades, decisiones, atributos de calidad — qué hace el sistema.

Tech

Arquitectura, stack, codebase, ADRs, módulos — cómo está construido.

Delivery

Roadmap, Work Items, build contract, evidencia — cuándo y qué tan bien se entrega.

El lifecycle de Kaddo

Los Work Items siguen el Kaddo-native Build Contract — un ciclo de vida que asegura que cada cambio es trazable desde la intención hasta la entrega verificada:

Captured Intent

Una idea o elemento externo se convierte en un Work Item borrador — kaddo create o import desde GitHub Issues, Jira o Azure DevOps.

Refinement → Ready

El work-item-agent enriquece ACs, alcance, módulos afectados. Una persona revisa y marca como ready.

Implementation Handoff

Ensamblaje de contexto agent-agnostic: prompts de deliberación de diseño, instrucciones de implementación, agente y skills recomendados.

Evidence → Verification → Learning

kaddo verify recolecta evidencia, verifica ACs contra release gates y captura aprendizajes para trabajo futuro.

Los Work Items se mueven físicamente entre directorios: draft/ → ready/ → in-progress/ → completed/. El lifecycle se aplica por convención — sin lock-in, sin dependencia de plataforma.

Cuatro interfaces, una capa de conocimiento

CLI

Comandos determinísticos: init, scan, context, create, verify, guard, explain. Sin LLM, sin API key. → Comandos

Servidor MCP

Servidor Model Context Protocol — expone conocimiento, herramientas de lifecycle y prompts de agentes a IDEs y agentes. → Servidor MCP

Admin

Interfaz web para gestión de Work Items, configuración de integraciones y provenance de imports. → Admin

Agentes

Packs de prompts LLM: business, product, architecture, work-item, implementation, graph, capsule y más. → Agentes

Integraciones

Kaddo se conecta a sistemas de trabajo externos a través de la Integration Adapter Foundation: discovery → import → refinement. Explora elementos externos (GitHub Issues, Jira, Azure DevOps), importa como borradores de Work Items con confirmación humana, y luego refina a través del lifecycle estándar. Los secretos permanecen en variables de entorno y nunca se exponen.

Knowledge Capsules

Para repos que no puedes mapear como módulos — otros equipos, acceso restringido, contexto solo de integración — intercambia Knowledge Capsules: kaddo capsule export comparte un resumen mínimo; kaddo capsule add lo importa como External Knowledge en el context pack. Sin mapeo multirepo, sin acceso al código.

Elige tu punto de partida

Proyecto nuevo

Empieza con conocimiento estructurado desde el día uno. → Proyecto nuevo

Proyecto pre-IA

Prepara un repo existente para personas y agentes LLM. → Proyecto pre-IA

Proyecto legacy

Entiende antes de cambiar sistemas riesgosos. → Proyecto legacy

Mira el loop completo

El flujo completo de principio a fin con los artefactos esperados. → Flujo completo

¿Prefieres verlo primero? La Guía visual mapea todo el loop, el reparto CLI/LLM y Guard como diagramas. ¿No sabes qué hace y qué no hace Kaddo? Lee el Alcance del proyecto.

Escala a multirepo

Kaddo modela sistemas distribuidos en muchos repositorios. Desde el repo de arquitectura mapeas repos secundarios como módulos y mantienes su conocimiento junto al código:

kaddo modules map        # registra un repo secundario como módulo
kaddo modules list       # lista los módulos mapeados
kaddo add standards|security|stack|git-strategy   # artefactos globales del sistema

Conocimiento por módulo

modules map genera artefactos module-design, stack, security y standards bajo knowledge/tech/modules/<id>/.

Context module-aware

kaddo context y kaddo explain muestran los módulos mapeados y su cobertura de artefactos.

Guard de workspace

El opt-in kaddo guard --workspace revisa los repos locales mapeados y señala posible drift.

Artefactos globales

Estándares, seguridad, stack y estrategia de Git documentan lo transversal una sola vez.

Self-hosting

Kaddo construye Kaddo con Kaddo. El proyecto usa su propio lifecycle para gestionar Work Items, recolectar evidencia, verificar ACs y capturar aprendizajes. El directorio knowledge/ contiene el conocimiento de producto propio de Kaddo. Este self-hosting valida el lifecycle de extremo a extremo y asegura que la fricción interna retroalimenta mejoras.

Míralo en acción

Cuatro repositorios de demostración reproducibles vienen con artefactos .kaddo/ y knowledge/ ya versionados — cada uno incluye un prompt-flow.md con un diagrama Mermaid y handoffs de prompts para copiar/pegar.

Task Pilot

App nueva · new — conocimiento estructurado desde el día uno; loop completo.

Loyalty Lite

App existente · pre-ai — scan + agentes + demo de drift con Guard.

Old Orders

App MVC legacy · legacy — entender antes de cambiar; riesgos e incógnitas.

Commerce Stack

Varios repos · multirepo — modules map + artefactos por módulo.

Explóralos en la guía de Ejemplos, o revisa las Plantillas que capturan el conocimiento mínimo suficiente para cada artefacto.

Kaddo es una implementación práctica de Knowledge Driven Development para el desarrollo de software asistido por IA — aplica los principios de KDD; no afirma haberlos inventado.

Empieza con un repo que recuerda

Desde proyectos nuevos hasta sistemas legacy, Kaddo mantiene el conocimiento del producto junto al código — y el lifecycle trazable.

Empezar →