oh-my-openagent-toolkit - Un toolkit de operación local que empezó en Claude Code y se estableció en OpenCode/oh-my-openagent
(github.com/HanTechnology)Hola.
Desde que usaba Claude Code de forma intensiva, sentía que cuando conectas un agente de codificación con IA a un proyecto real, al final más que el código en sí necesitas una capa que explique “cómo se debe trabajar en este proyecto”.
Por ejemplo, cosas como estas:
- a dónde se debe enrutar cada solicitud
- qué built-in helper conviene conectar
- hasta dónde llega el alcance de soporte que hoy se puede afirmar con solidez
- dónde crear trabajo nuevo y cómo tratar los proyectos existentes
- desde dónde y cómo conviene agregar refinement del lado de UI
Al principio fui puliendo esto a mi manera dentro de Claude Code, luego probé moverme a OpenCode por un tiempo, y ahora terminé estableciéndolo sobre oh-my-openagent y empaquetándolo en una forma que pueda usarse con más consistencia en proyectos locales.
Esta vez lo publiqué con el nombre de oh-my-openagent-toolkit.
GitHub:
https://github.com/HanTechnology/oh-my-openagent-toolkit
¿Qué es esto?
Si lo resumiera en una línea,
es un companion toolkit local al proyecto que se usa sobre OpenCode + oh-my-openagent.
Dicho de forma un poco más concreta,
no busca reemplazar el harness upstream, sino más bien montarse encima para hacer más clara la capa de operación local.
Lo que este repositorio agrega es principalmente esto.
- thin routing
- organiza a dónde debe enviarse cada solicitud
- guía con más claridad sobre qué category / helper corresponde
- skill surface
- organiza los top-level entrypoint bajo
.opencode/skills/ - por ahora hay 43 entrypoint, de los cuales 40 son core surface y 3 son planned adjacent pack
- organiza los top-level entrypoint bajo
- support boundary
- separa validated / guided / planned
- para distinguir entre “parece que funciona” y “lo que hoy se puede decir públicamente con firmeza”
- workspace convention
- organiza cómo leer desde el repo root y qué tomar como base para trabajar
- UI refinement layer
- agrupa la línea impeccable de forma local
- para que, al trabajar en UI, se pueda agregar una refinement layer encima de la ruta principal
¿Por qué lo hice?
Cuando conectas un agente de codificación con IA a un proyecto real, llega un momento en que importa más “bajo qué reglas debe moverse el agente dentro de este proyecto” que “si el agente es inteligente”.
Esto se vuelve aún más cierto cuando se mezclan varios dominios.
- frontend / backend / systems / data / security / QA
- el límite entre implementación y validación
- la diferencia entre documentación y validated surface real
- cuándo conectar agent helper y cuándo no
En vez de escribir todo esto cada vez en prompts largos, o dejarlo solo en la cabeza de una persona, pensé que sería mejor dejarlo como una capa de operación delgada dentro del proyecto.
También dejé claramente escrito lo que este repositorio no pretende hacer.
Esto no es una de estas tres cosas.
- (X) la distribución oficial upstream de oh-my-openagent
- (X) un nuevo runtime que reemplace al harness
- (X) otro control plane más en local
Es decir, es un companion toolkit que se monta sobre el upstream,
no va en la dirección de crear otro framework nuevo.
¿Hasta dónde llega hoy?
Tampoco quise imponer restricciones excesivas aquí.
Ahora mismo este repositorio tiene una broad skill surface (43 habilidades que cubren desarrollo en general),
pero las 4 que actualmente están marcadas como validated son estas.
- frontend-product-delivery
- backend-service-delivery
- cloud-release-readiness
- ai-data-product-delivery
El resto está clasificado como guided o planned.
¿Para quién encaja?
Puede encajarles a personas como estas.
- quienes ya usan OpenCode o quieren probarlo
- quienes quieren dejar más clara la capa de operación local del proyecto sobre oh-my-openagent
- quienes ejecutan agentes de codificación con IA a nivel real de repo/worktree y quieren ordenar routing / support boundary / workspace rule
- quienes, en vez de escribir prompts cada vez más largos, quieren dejar conocimiento operativo dentro del proyecto
Probarlo rápido
Este repositorio se puede usar más o menos en este orden.
- Instalar OpenCode
- Configurar oh-my-openagent
- Clonar el repo
- Ejecutar opencode
- Hacer vibe coding con la combinación Sisyphus o Prometheus + Atlas de oh-my-openagent
Por último
Más que una versión terminada,
se parece a un toolkit de operación local que fui ordenando porque realmente lo necesitaba mientras me movía de Claude Code → OpenCode → oh-my-openagent.
Si alguien ha tenido inquietudes parecidas, agradeceré mucho su feedback.
Aún no hay comentarios.