KOF - Kaddo-OpenCode Framework

Framework CLI que integra Kaddo + OpenCode + Agentes para desarrollo de proyectos con IA.

---

Español

¿Para qué sirve KOF?

KOF resuelve un problema común al desarrollar software con IA: la falta de contexto. Cuando le pides a una IA que escriba código, ella no conoce tu negocio, tus usuarios ni tus reglas. KOF estructura ese conocimiento para que la IA trabaje con información real, no con suposiciones.

Sin KOF: La IA explora tu código, adivina la arquitectura, inventa requisitos → errores, inconsistencias, pérdida de tiempo.

Con KOF: La IA tiene acceso a tu negocio, producto, stack técnico y roadmap → código preciso, menos alucinaciones, ahorro de tokens.

¿Qué es Kaddo?

Kaddo es una herramienta open source que implementa Knowledge Driven Development (KDD) — un enfoque donde el conocimiento del proyecto (qué hace, por qué existe, cómo se construye) se mantiene junto al código, no disperso en la cabeza de las personas.

Kaddo organiza el conocimiento en 4 capas:

• Business — Por qué existe el proyecto (problema, usuarios, reglas)
• Product — Qué construimos (scope, capacidades, valor)
• Tech — Cómo lo construimos (stack, arquitectura, decisiones)
• Delivery — Cómo evoluciona (roadmap, Work Items)

KOF usa Kaddo como capa de conocimiento determinista: el CLI estructura la información, y tu LLM la interpreta.

¿Por qué OpenCode?

OpenCode es un agente de código abierto que ejecuta código directamente en tu terminal. KOF lo usa como motor de implementación porque:

• Open source — Sin vendor lock-in
• Multi-modelo — Soporta Claude, GPT, Gemini, modelos locales
• LSP integrado — Entiende tu código (tipos, imports, estructura)
• Multi-sesión — Puede trabajar en paralelo
• Privacidad — No almacena tu código ni contexto

KOF prepara el contexto con Kaddo, y OpenCode ejecuta la implementación con ese contexto.

Flujo completo

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   kof init  │ ──► │  kof build  │ ──► │   kof plan  │
│ Inicializa  │     │ Conocimiento│     │ Roadmap +   │
│ proyecto    │     │ (3 capas)   │     │ Work Items  │
└─────────────┘     └─────────────┘     └─────────────┘
                                              │
                                              ▼
                    ┌─────────────┐     ┌─────────────┐
                    │  kof status │ ◄── │kof implement│
                    │  Ver estado │     │ OpenCode +  │
                    │             │     │ contexto    │
                    └─────────────┘     └─────────────┘

Instalación Rápida

Requisitos Previos

Herramienta	Instalación	Propósito
Go 1.21+	go.dev/dl	Compilar el framework
Kaddo CLI	npm install -g @kaddo/cli	Gestión de conocimiento
OpenCode (opcional)	curl -fsSL https://opencode.ai/install | bash	Implementación con IA

Compilar el Framework

# Clonar el repositorio
git clone <url-del-repositorio>
cd framework

# Descargar dependencias
make deps

# Compilar
make build

# (Opcional) Instalar globalmente
make install

Comandos Disponibles

Comando	Descripción
kof init	Inicializar proyecto (pregunta todo desde terminal)
kof build	Construir conocimiento (negocio, producto, técnico)
kof plan	Generar roadmap (IA o manual) y crear Work Items
kof implement	Implementar con OpenCode
kof quality	Validar calidad y drift
kof status	Mostrar estado del proyecto
kof explain	Generar resumen del proyecto

Ejemplo de uso

# 1. Inicializar proyecto
kof init
# → Pregunta nombre, estado, idioma, equipo

# 2. Construir conocimiento
kof build
# → Pregunta problema, usuarios, reglas, restricciones
# → Pregunta producto, scope, capacidades
# → Pregunta stack, arquitectura, decisiones

# 3. Planificar roadmap y Work Items
kof plan
# → Genera roadmap con IA (o manualmente)
# → Crea Work Items desde el roadmap

# 4. Implementar
kof implement
# → Genera contexto actualizado
# → Abre OpenCode para implementar

# 5. Validar
kof quality
# → Verifica drift de conocimiento
# → Valida estructura y contenido

Documentación Completa

• Guía de Uso - Paso a paso detallado
• Arquitectura - Diseño del framework
• Agentes - Guía de agentes de Kaddo
• Comandos - Referencia de todos los comandos

---

English

What is KOF for?

KOF solves a common problem when developing software with AI: lack of context. When you ask AI to write code, it doesn't know your business, users, or rules. KOF structures that knowledge so AI works with real information, not assumptions.

Without KOF: AI explores your code, guesses the architecture, invents requirements → errors, inconsistencies, wasted time.

With KOF: AI has access to your business, product, tech stack, and roadmap → precise code, fewer hallucinations, token savings.

What is Kaddo?

Kaddo is an open source tool that implements Knowledge Driven Development (KDD) — an approach where project knowledge (what it does, why it exists, how it's built) is kept close to the code, not scattered in people's heads.

Kaddo organizes knowledge into 4 layers:

• Business — Why the project exists (problem, users, rules)
• Product — What we build (scope, capabilities, value)
• Tech — How we build it (stack, architecture, decisions)
• Delivery — How it evolves (roadmap, Work Items)

KOF uses Kaddo as a deterministic knowledge layer: the CLI structures the information, and your LLM interprets it.

Why OpenCode?

OpenCode is an open source agent that runs code directly in your terminal. KOF uses it as the implementation engine because:

• Open source — No vendor lock-in
• Multi-model — Supports Claude, GPT, Gemini, local models
• LSP enabled — Understands your code (types, imports, structure)
• Multi-session — Can work in parallel
• Privacy — Doesn't store your code or context

KOF prepares the context with Kaddo, and OpenCode executes the implementation with that context.

Complete flow

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   kof init  │ ──► │  kof build  │ ──► │   kof plan  │
│ Initialize  │     │ Knowledge   │     │ Roadmap +   │
│ project     │     │ (3 layers)  │     │ Work Items  │
└─────────────┘     └─────────────┘     └─────────────┘
                                              │
                                              ▼
                    ┌─────────────┐     ┌─────────────┐
                    │  kof status │ ◄── │kof implement│
                    │ Check status│     │ OpenCode +  │
                    │             │     │ context     │
                    └─────────────┘     └─────────────┘

Quick Installation

Prerequisites

Tool	Installation	Purpose
Go 1.21+	go.dev/dl	Compile the framework
Kaddo CLI	npm install -g @kaddo/cli	Knowledge management
OpenCode (optional)	curl -fsSL https://opencode.ai/install | bash	AI-powered implementation

Compile the Framework

# Clone the repository
git clone <repository-url>
cd framework

# Download dependencies
make deps

# Compile
make build

# (Optional) Install globally
make install

Available Commands

Command	Description
kof init	Initialize project (asks everything from terminal)
kof build	Build knowledge (business, product, technical)
kof plan	Generate roadmap (AI or manual) and create Work Items
kof implement	Implement with OpenCode
kof quality	Validate quality and drift
kof status	Show project status
kof explain	Generate project summary

Usage Example

# 1. Initialize project
kof init
# → Asks name, state, language, team size

# 2. Build knowledge
kof build
# → Asks problem, users, rules, constraints
# → Asks product, scope, capabilities
# → Asks stack, architecture, decisions

# 3. Plan roadmap and Work Items
kof plan
# → Generates roadmap with AI (or manually)
# → Creates Work Items from roadmap

# 4. Implement
kof implement
# → Generates updated context
# → Opens OpenCode to implement

# 5. Validate
kof quality
# → Checks knowledge drift
# → Validates structure and content

Complete Documentation

• Usage Guide - Step-by-step detailed guide
• Architecture - Framework design
• Agents - Kaddo agents guide
• Commands - Complete command reference

---

Licencia / License

MIT