wastech-orchestrator
Convierte una tarea escrita en un pull request para tu revisión.
Los agentes hacen los cambios, y el orquestador dirige el flujo y todo el trabajo con Git a su alrededor, desde la rama hasta el pull request. Cada paso se guarda en una base de datos SQLite local, así que cada ejecución deja un registro que puedes seguir después.
Por qué está aquí
Uso este orquestador yo mismo para desarrollar funcionalidades, escribir textos y explorar ideas. Es un ejemplo de lo que podría configurar para ti y tu equipo, y su código y su documentación son públicos, así que puedes leer cómo funciona antes de decidir nada.
Problema
Antes de que un revisor pueda seguir el cambio de un agente, hacen falta varios pasos a su alrededor. Cuando nadie se encarga de esos pasos, el pull request de un agente es difícil de revisar y su resultado, difícil de repetir. Es una de las razones por las que el trabajo con agentes se estanca, junto con la calidad del contexto que lee el agente.
Solución
El orquestador asume el proceso y el trabajo con Git, y a los agentes no se les pide hacer commit ni push. Un flujo describe los pasos, y las tareas se escriben conforme a él. El pull request se abre cuando han pasado las comprobaciones que configuraste y la revisión de un agente, con un resumen escrito de lo que cambió.
- Una tarea va a un agente y vuelve como pull request cuando han pasado las comprobaciones que configuraste para tu repositorio.
- Los pasos quedan escritos como un flujo, así que cada ejecución sigue las etapas que definiste para él.
- Un commit de auditoría opcional deja el archivo de la tarea y su resumen junto al código.
Funcionalidades principales
- De la tarea al pull requestUna tarea en Markdown se convierte en una rama, un cambio, las comprobaciones de tu repositorio y un pull request con un resumen escrito.
- Dos agentes, una interfazOpenAI Codex y Anthropic Claude Code son intercambiables, y si ambos están configurados, una ejecución pasa al otro ante un fallo de infraestructura.
- Git queda en manos del orquestadorA los agentes no se les pide hacer commit ni push. Con el aislamiento estricto activado y un host capaz de ejecutarlos en un sandbox, no pueden escribir en .git, y preflight avisa cuando falta esa protección.
- Ejecuciones reanudablesCada paso se guarda en un punto de control, así que un reinicio retoma la tarea en curso sin hacer dos veces el commit ni volver a abrir un pull request.
Pipeline
- TareaUn archivo Markdown en tu repositorioTú
- RamaCreada a partir de tu rama baseOrquestador
- Pasos del flujoPlanificación y cambios, un paso cada vezAgentes de IA
- ComprobacionesTus propios comandos de test y lint, después de cada cambioOrquestador
- RevisiónLeen el cambio y devuelven sus observaciones para corregirloAgentes de IA
- CommitUn commit limitado a la tarea y después el pushOrquestador
- Pull requestAbierto con un resumen para tu revisiónOrquestador
Para quién es
- Personas y equipos que quieren trabajar con agentes de IA.
- Tech leads que quieren que cada cambio de un agente pase por una revisión y deje un registro.
Stack tecnológico
- Núcleo
- Python 3.12+
- Agentes
- OpenAI Codex CLI
- Anthropic Claude Code CLI
- Estado
- SQLite (estado con puntos de control, tablas de auditoría)
- Git
- git
- GitHub CLI (gh)
Instalación
pipx install "git+https://github.com/VladimirMakarevich/wastech-orchestrator.git"cd path/to/your-repoworc install .worc preflightLimitaciones
- Ejecuta una sola tarea a la vez, de principio a fin.
- Abre pull requests solo en GitHub, a través de la CLI gh.
- El paso de comprobaciones solo bloquea una tarea después de que incluyas tus comandos de test y lint en la configuración; una instalación nueva no incluye ninguno.
- Una instalación nueva deja el aislamiento estricto desactivado, y un host sin sandbox del sistema operativo, como Windows nativo, no puede bloquear la escritura en .git.