telos

Ingeniería del Propósito

Trabaja con LLMs desde propósito explícito en lugar de partir de contexto abundante.

La Ingeniería del Propósito propone que el centro del trabajo con IA no sea la acumulación de información, sino la formulación explícita del fin que debe gobernar la solución. Todo cambio se articula en cuatro horizontes:

• Funcional: qué problema desaparece o qué capacidad nueva aparece.
• Arquitectónico: qué principio de diseño debe protegerse.
• Restricción: qué no puede ocurrir bajo ninguna circunstancia.
• Autoría: cómo debe leerse, mantenerse o evolucionar el resultado.

Propósito claro + contexto mínimo + evaluación por horizontes = colaboración útil con LLMs

Plugin telos

Este repositorio es un marketplace de Claude Code que distribuye el plugin telos: skills y comandos para aplicar la metodología directamente en tu flujo de trabajo.

Comandos disponibles

Comando	Descripción
/telos:brief	Convierte una petición en una ficha de propósito
/telos:review	Revisa una propuesta contra la ficha de propósito
/telos:retro	Captura aprendizaje reutilizable tras cerrar un cambio
/telos:init	Iniciar un proyecto nuevo
/telos:resume	Retomar un proyecto existente
/telos:plan	Planificar: diseño, requisitos, tareas, roadmap
/telos:exec	Ejecutar el plan guiado por el propósito
/telos:check	Validar contra propósito + tests + commit + PR
/telos:sync	Sincronizar cambios remotos

Instalación

# Añadir el marketplace
/plugin marketplace add jllopis/ingenieria-del-proposito

# Instalar el plugin
/plugin install telos

# Recargar en la sesión actual
/reload-plugins

Actualización

# Refrescar el marketplace
/plugin marketplace update ingenieria-del-proposito

# Actualizar el plugin
/plugin update telos@ingenieria-del-proposito

# Recargar en la sesión actual
/reload-plugins

Para actualizaciones automáticas: /plugin → pestaña Marketplaces → seleccionar ingenieria-del-proposito → Enable auto-update.

Flujo típico

/telos:brief  →  (implementación)  →  /telos:review  →  /telos:retro

Con ciclo de proyecto completo:

/telos:init o /telos:resume
    → /telos:plan (incluye brief)
    → /telos:exec
    → /telos:check (incluye review + commit + PR)
    → /telos:sync

Documentación

• Ingeniería del Propósito — documento conceptual completo
• Manifiesto — tesis central en formato breve
• Guía práctica para equipos — procesos, plantillas y criterios
• Integración con LLMs — arquitectura del plugin
• Infografía — resumen visual

Origen

Este enfoque nace del artículo La Tiranía del Contexto.

Otras plataformas

El repositorio incluye .agents/skills/ compatible con el estándar abierto Agent Skills. Funciona con:

• OpenAI Codex — instalar vía $skill-installer con URL del repo
• Cursor, VS Code Copilot, Gemini CLI, y cualquier herramienta compatible — clonar el repo
• OpenCode — adaptador en dist/opencode/

Autor

Joan Llopis

Licencia

MIT