oh-my-openagent-toolkit - toolkit operacional local que começou no Claude Code e se estabeleceu no OpenCode/oh-my-openagent
(github.com/HanTechnology)Olá.
Desde quando eu usava bastante o Claude Code, senti que, quando você realmente conecta um agente de codificação com IA a um projeto, no fim das contas surge a necessidade de uma camada que explique “como se deve trabalhar neste projeto”, mais do que do próprio código em si.
Por exemplo, coisas como estas:
- para onde certas solicitações devem ser roteadas
- qual built-in helper faz mais sentido acoplar
- até onde vai o escopo de suporte que dá para afirmar com convicção neste momento
- onde criar novos trabalhos e como lidar com projetos existentes
- de onde e como faz mais sentido adicionar refinement na parte de UI
No começo, fui refinando isso do meu jeito no Claude Code, depois em determinado momento também tentei migrar para o OpenCode, e agora acabei me estabelecendo sobre o oh-my-openagent, reunindo tudo em um formato que dá para usar com mais consistência em projetos locais.
Desta vez, publiquei isso com o nome de oh-my-openagent-toolkit.
GitHub:
https://github.com/HanTechnology/oh-my-openagent-toolkit
O que é isso?
Em uma linha,
é um companion toolkit local ao projeto usado sobre OpenCode + oh-my-openagent.
Mais especificamente,
em vez de substituir o harness upstream, ele está mais para algo que se apoia sobre ele e torna a camada operacional local mais clara.
O que este repositório adiciona é principalmente o seguinte.
- thin routing
- organiza para onde as solicitações devem ser enviadas
- orienta com mais clareza qual category / helper é o mais adequado
- skill surface
- organiza os entrypoints de nível superior em
.opencode/skills/ - no momento há 43 entrypoints, dos quais 40 são core surface e 3 são planned adjacent pack
- organiza os entrypoints de nível superior em
- support boundary
- separa validated / guided / planned
- distinguindo entre “parece funcionar” e “o que já dá para afirmar publicamente com segurança neste momento”
- workspace convention
- organiza como ler a partir da raiz do repositório e qual referência usar para trabalhar
- UI refinement layer
- agrupa localmente a linha impeccable
- permitindo adicionar uma refinement layer por cima da rota principal ao trabalhar com UI
Por que foi criado?
Quando você conecta de fato um agente de codificação com IA a um projeto real, chega um momento em que se torna mais importante do que “o agente é inteligente?” a questão “segundo quais regras o agente deve se mover dentro deste projeto?”.
Isso é ainda mais verdadeiro quando vários domínios se misturam.
- frontend / backend / systems / data / security / QA
- a fronteira entre implementação e validação
- a distinção entre documentação e a validated surface real
- quando acoplar agent helper e quando não acoplar
Em vez de escrever tudo isso em prompts longos toda vez, ou depender apenas do que está na cabeça das pessoas,
achei melhor deixar isso registrado dentro do projeto como uma camada operacional enxuta.
Também deixei claro o que este repositório não pretende fazer.
Isto não é uma destas três coisas.
- (X) a distribuição upstream oficial do oh-my-openagent
- (X) um novo runtime para substituir o harness
- (X) mais um control plane local
Ou seja, é um companion toolkit que fica sobre o upstream,
não uma iniciativa para criar mais um framework novo.
Até onde isso funciona hoje?
Aqui também procurei não impor restrições excessivas.
Atualmente este repositório tem uma broad skill surface (43 habilidades abrangendo o desenvolvimento em geral),
mas o que está marcado como validated neste momento são estas 4.
- frontend-product-delivery
- backend-service-delivery
- cloud-release-readiness
- ai-data-product-delivery
O restante está classificado como guided ou planned.
Para quem isso faz sentido?
Pode fazer sentido para pessoas como estas.
- quem já usa OpenCode ou está pensando em experimentar
- quem quer deixar mais clara a camada operacional local do projeto sobre o oh-my-openagent
- quem opera agentes de codificação com IA em nível real de repo/worktree
e quer organizar routing / support boundary / workspace rule - quem quer deixar conhecimento operacional dentro do projeto em vez de escrever apenas prompts longos
Testando rápido
Neste repositório, a ordem seria mais ou menos esta.
- instalar o OpenCode
- configurar o oh-my-openagent
- clonar o repositório
- executar o opencode
- fazer vibe coding com a combinação Sisyphus ou Prometheus + Atlas do oh-my-openagent
Por fim
Mais do que algo já acabado,
isso está mais para um toolkit operacional local que organizei por necessidade real ao migrar de Claude Code → OpenCode → oh-my-openagent.
Se houver pessoas que passaram por preocupações parecidas, ficarei grato pelo feedback.
Ainda não há comentários.