Agente de Codificación Pi: Flujos de Trabajo Minimalistas en Terminal

Introducción a Pi

• Qué es Pi y su filosofía de minimalismo y control.
• Comparación con Claude Code, Codex CLI y Cursor.
• Las cuatro herramientas integradas: leer, escribir, editar y bash.
• Cuándo elegir Pi sobre agentes más pesados.

Instalación y Configuración

• Instalación de Pi mediante npm y gestores de paquetes.
• Configuración de claves API para más de 15 proveedores compatibles.
• Configuración del directorio de trabajo y archivos de contexto.
• Ejecución de Pi en entornos locales y con Docker.

Flujos de Trabajo Core en Terminal

• Generación de código a partir de simples mensajes.
• Lectura y edición precisa de archivos.
• Ejecución segura de comandos bash dentro del agente.
• Gestión del estado de la sesión y reinicios de contexto.

Creación de Habilidades Personalizadas

• Comprensión de la API de habilidades en TypeScript.
• Escritura de operaciones personalizadas de lectura, escritura y edición.
• Integración con la ejecución de bash para flujos de trabajo especializados.
• Prueba y depuración de habilidades de forma aislada.

Plantillas de Mensajes y Temas

• Adaptación de los mensajes del sistema para diferentes lenguajes y marcos de trabajo.
• Creación de plantillas de mensajes reutilizables para la consistencia del equipo.
• Empaquetado de temas como módulos compartibles.

Extensión de Pi con Paquetes npm

• Agrupación de habilidades como paquetes pi.
• Publicación en npm y Git.
• Instalación de paquetes contribuidos por la comunidad.
• Gestión de versiones de dependencias y compatibilidad.

Flexibilidad del Proveedor

• Cambio entre Anthropic, OpenAI, Google y otros backends.
• Optimización por costo, velocidad y calidad según la tarea.
• Ejecución de modelos completamente locales para código sensible.

Casos de Uso Prácticos

• Automatización de pruebas y flujos de trabajo de generación de pruebas.
• Refactorización de código legado mediante cadenas de habilidades personalizadas.
• Generación y mantenimiento de documentación.
• Integración continua (CI) con mínima sobrecarga del agente.

Seguridad y Control

• Comprensión del límite del mensaje del sistema de 300 palabras.
• Aprobación manual para operaciones de escritura.
• Aislamiento de la ejecución de bash para entornos no confiables.
• Registro de auditoría de todas las acciones del agente.

Resumen y Próximos Pasos

• Repaso de los principios de minimalismo, control y extensibilidad.
• Recursos de la comunidad y directrices de contribución.
• Tópicos avanzados para usuarios experimentados de Pi.