centinela Academy
Lecciones 01 Rules before code 02 Reliability floor 03 Raw Deep Agent 04 Skill generation 05 Cognee + autonomía acotada
🧶
CTL Academy · PyCon Colombia 2026

Construí un Deep Agent que aprende sus propios skills.

Un taller de 90 minutos. El agente arranca crudo, detecta un gap, escribe un SKILL.md siguiendo el estándar de agentskills.io, ingesta tu data en Cognee, y responde preguntas de negocio con evidencia. Todo con receipts inspeccionables.

Lecciones
5
Duración
90 min
Stack
DeepAgents · Cognee · Neo4j
Modelo
OpenRouter
La historia

Del "no puedo responder" a "acá está la evidencia".

Cada motion del agente pasa por un gate. Cada transición emite un receipt. Al final tenés un lifecycle.jsonl que cuenta cómo tu agente pasó de crudo a útil, en 4 pasos:

Flujo esperado
[t=0]  ask: "¿cuánto facturó Café del Valle en Q3?"
       agent: "no tengo esa capacidad. voy a aprender."
[t=1]  agent lee agentskills.io spec → escribe .skills/query_cognee/SKILL.md
[t=2]  agent ingiere data/acme/*.md en Cognee (Neo4j backend)
[t=3]  agent invoca el skill que acaba de escribirse a sí mismo
       agent: "Café del Valle facturó 58.300.000 COP en Q3 (fuente: invoices-q3.md)"
[t=4]  .receipts/lifecycle.jsonl muestra: raw → learning → answering
Path del workshop

5 lecciones · 14 minutos cada una

  1. Lesson 01 · 14 min Rules before code Antes de que el DeepAgent exista, **negociás las reglas del juego**: qué preguntas de negocio va a resolver, qué puede tocar, qué gates lo detienen. Sin esto, cualquier autonomía e…
  2. Lesson 02 · 14 min Reliability floor Hacer que **input malformado falle fuerte y con contexto**. Antes de darle capacidades al agente, sus estructuras de datos deben rechazar basura visiblemente.
  3. Lesson 03 · 14 min Raw Deep Agent Instanciar un DeepAgent **crudo** — cero custom tools, cero dominio — y hacer que **falle explícitamente** en la primera pregunta. Vamos a leer las cuatro primitivas de DeepAgents …
  4. Lesson 04 · 14 min Skill generation Enseñarle al agente a **escribirse sus propios skills** siguiendo la spec de [`agentskills.io`](https://agentskills.io/home) (resumida en `.skills/README.md`).
  5. Lesson 05 · 14 min Cognee + autonomía acotada Si algo está rojo: - `cognee status` → [`setup.md#4-cognee-elegí-una-ruta`](../setup.md#4-cognee-elegí-una-ruta) - Directorios o embeddings mal seteados → [`setup.md#bugs-de-integr…
Stack

Python-native, sin sorpresas.

Harness DeepAgents (LangChain) Planning tool, virtual filesystem, sub-agents, human-in-the-loop. El agente es autónomo pero acotado.
Memoria Cognee sobre Neo4j Grafo persistente. El agente lo ingiere una vez y luego consulta con Cypher generado.
Lifecycle python-statemachine Transiciones explícitas: raw → learning → answering → refining → escalated. Sin booleanos escondidos.
Reliability Pydantic · Ruff · mypy --strict Un solo comando: academy check. Rojo = no avanzás.