Skip to content
Back to search

gbertelli-skills

MarketplaceWorks with Claude CodeGitHub

Skills e agentes para orquestrar trabalho com varios agentes no Claude Code

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gbertelliti-collab--claude-skills/badge.svg)](/listings/gbertelliti-collab--claude-skills)

HTML

<a href="/listings/gbertelliti-collab--claude-skills"><img src="/api/listings/gbertelliti-collab--claude-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 21 lines
  1. {
  2. "name": "gbertelli-skills",
  3. "description": "Skills e agentes para orquestrar trabalho com varios agentes no Claude Code",
  4. "owner": {
  5. "name": "Gabriel Bertelli"
  6. },
  7. "plugins": [
  8. {
  9. "name": "orquestrador",
  10. "source": "./plugins/orquestrador",
  11. "description": "Orquestrador de operarios (Haiku e Sonnet) com ficha que aprende, modo god, auditoria adversarial, prova na tela e conferencia de valores",
  12. "category": "productivity",
  13. "tags": [
  14. "orchestration",
  15. "subagents",
  16. "multi-agent",
  17. "cost"
  18. ]
  19. }
  20. ]
  21. }
README.md · README · 427 lines
  1. <!-- uso-real:img-banner:inicio -->
  2. <picture>
  3. <source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/img/banner-escuro-estreito.svg">
  4. <source media="(prefers-color-scheme: dark)" srcset="docs/img/banner-escuro.svg">
  5. <source media="(max-width: 600px)" srcset="docs/img/banner-claro-estreito.svg">
  6. <img alt="orquestrador: plugin do Claude Code com um chefe, operários Haiku e Sonnet e uma ficha que aprende" src="docs/img/banner-claro.svg" width="100%">
  7. </picture>
  8. <!-- uso-real:img-banner:fim -->
  9. <p align="center"><b>Português</b> · <a href="README.en.md">English</a></p>
  10. <p align="center">
  11. <img alt="Plugin do Claude Code" src="https://img.shields.io/badge/Claude%20Code-plugin-D97757">
  12. <img alt="Python 3, sem dependências" src="https://img.shields.io/badge/Python%203-sem%20depend%C3%AAncias-3776AB">
  13. <a href="https://github.com/gbertelliti-collab/claude-skills/actions/workflows/testes.yml"><img alt="Testes" src="https://github.com/gbertelliti-collab/claude-skills/actions/workflows/testes.yml/badge.svg"></a>
  14. <img alt="Licença MIT" src="https://img.shields.io/badge/licen%C3%A7a-MIT-blue">
  15. <img alt="Último commit" src="https://img.shields.io/github/last-commit/gbertelliti-collab/claude-skills?label=%C3%BAltimo%20commit">
  16. </p>
  17. <p align="center">
  18. <a href="#números-de-uso-real">Uso real</a> ·
  19. <a href="#como-funciona">Como funciona</a> ·
  20. <a href="#instalar">Instalar</a> ·
  21. <a href="#receber-atualizações">Atualizações</a> ·
  22. <a href="#como-usar">Como usar</a> ·
  23. <a href="#o-que-vem-no-plugin">O que vem</a>
  24. </p>
  25. Sessão longa do Claude Code em modelo grande fica cara porque relê o contexto inteiro a cada resposta. O **orquestrador** faz a sessão trabalhar como chefe: ela quebra o trabalho em partes independentes, entrega cada parte a um operário barato (Haiku ou Sonnet) com um brief desenhado, confere a entrega rodando o aceite ela mesma e registra o resultado. Desse registro sai uma ficha que diz, por tipo de tarefa, qual modelo recebe a próxima e quanto detalhe o brief precisa.
  26. ```bash
  27. claude plugin marketplace add gbertelliti-collab/claude-skills
  28. claude plugin install orquestrador@gbertelli-skills
  29. ```
  30. Depois é só pedir trabalho com 2 ou mais partes ("usa os operários", "divide o trabalho", "faz em paralelo").
  31. ## Números de uso real
  32. <!-- uso-real:periodo:inicio -->
  33. Tudo abaixo saiu do registro do próprio motor e dos transcripts do Claude Code, em trabalho de verdade entre 15 e 17/11/2026. Nada é estimativa: são contagens. O retrato agregado está em [`docs/uso-real.json`](docs/uso-real.json) e os gráficos são gerados dele por [`docs/graficos.py`](docs/graficos.py).
  34. <!-- uso-real:periodo:fim -->
  35. <!-- uso-real:img-numeros:inicio -->
  36. <picture>
  37. <source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/img/numeros-escuro-estreito.svg">
  38. <source media="(prefers-color-scheme: dark)" srcset="docs/img/numeros-escuro.svg">
  39. <source media="(max-width: 600px)" srcset="docs/img/numeros-claro-estreito.svg">
  40. <img alt="144 tarefas delegadas, 82% aprovadas de primeira, 2 voltaram para o chefe, 3,2% do custo nos agentes Haiku e Sonnet" src="docs/img/numeros-claro.svg" width="100%">
  41. </picture>
  42. <!-- uso-real:img-numeros:fim -->
  43. ### O que os operários acertam e onde erram
  44. <!-- uso-real:img-tipos:inicio -->
  45. <picture>
  46. <source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/img/tipos-escuro-estreito.svg">
  47. <source media="(prefers-color-scheme: dark)" srcset="docs/img/tipos-escuro.svg">
  48. <source media="(max-width: 600px)" srcset="docs/img/tipos-claro-estreito.svg">
  49. <img alt="Resultado por tipo de tarefa: revisão 37 de 37 de primeira; leitura 30 de 31 de primeira; edição lógica 13 de 26 de primeira; front 13 de 21 de primeira; pesquisa web 10 de 10 de primeira; texto 5 de 6 de primeira; coordenação 5 de 5 de primeira; teste 2 de 4 de primeira; outros 3 tipos 3 de 4 de primeira" src="docs/img/tipos-claro.svg" width="100%">
  50. </picture>
  51. <!-- uso-real:img-tipos:fim -->
  52. <!-- uso-real:tipos-texto:inicio -->
  53. - **Ler, pesquisar e revisar:** 77 de 78 tarefas passaram de primeira; o Haiku recebeu 28 delas e passou 28 de primeira.
  54. - **Escrever código (edição lógica e front):** 26 de 47 passaram de primeira; das outras 21, 20 o próprio operário corrigiu e 1 o chefe terminou.
  55. - **No total:** das 26 que não passaram de primeira, 24 o próprio operário corrigiu em até 2 rodadas e 2 o chefe terminou.
  56. <!-- uso-real:tipos-texto:fim -->
  57. Ler, pesquisar e revisar é o que mais vale delegar. Escrever código é onde a conferência paga: o que não passa de primeira só fecha porque o chefe roda o aceite, vê falhar e manda corrigir, em vez de aceitar o "feito" do operário.
  58. <!-- uso-real:modelos:inicio -->
  59. | modelo | tarefas | de primeira | respostas por tarefa | saída por tarefa | contexto máximo |
  60. |---|---:|---:|---:|---:|---:|
  61. | Haiku | 32 | 31 (97%) | 4 | 13 mil tokens | 103 mil |
  62. | Sonnet | 86 | 71 (83%) | 10 | 15 mil tokens | 107 mil |
  63. | Opus | 26 | 16 (62%) | 114 | 182 mil tokens | 381 mil |
  64. <!-- uso-real:modelos:fim -->
  65. As três últimas colunas são medianas. A taxa menor do Opus não quer dizer que ele erra mais: ele recebeu as tarefas mais difíceis (edição lógica pesada, telas grandes, coordenação de frente), que são longas e raramente saem de primeira com qualquer modelo. As colunas de respostas e de saída mostram o tamanho delas.
  66. <details>
  67. <summary>Tabela completa: tipo de tarefa por modelo</summary>
  68. <br>
  69. Cada célula é "passaram de primeira / tarefas".
  70. <!-- uso-real:tipo-modelo:inicio -->
  71. | tipo | Haiku | Sonnet | Opus |
  72. |---|---:|---:|---:|
  73. | revisão | | 31 / 31 | 6 / 6 |
  74. | leitura | 22 / 22 | 8 / 9 | |
  75. | edição lógica | | 11 / 18 | 2 / 8 |
  76. | front | | 12 / 17 | 1 / 4 |
  77. | pesquisa web | 6 / 6 | 3 / 3 | 1 / 1 |
  78. | texto | | 5 / 6 | |
  79. | coordenação | | | 5 / 5 |
  80. | teste | 1 / 2 | 1 / 1 | 0 / 1 |
  81. | edição mecânica | 2 / 2 | | |
  82. | debug | | | 1 / 1 |
  83. | outro | | 0 / 1 | |
  84. <!-- uso-real:tipo-modelo:fim -->
  85. </details>
  86. ### Para onde vai o custo
  87. <!-- uso-real:img-custo:inicio -->
  88. <picture>
  89. <source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/img/custo-escuro-estreito.svg">
  90. <source media="(prefers-color-scheme: dark)" srcset="docs/img/custo-escuro.svg">
  91. <source media="(max-width: 600px)" srcset="docs/img/custo-claro-estreito.svg">
  92. <img alt="Parcela dos agentes e parcela do custo por modelo: Opus 58,1% dos agentes e 71,3% do custo; Fable 3,7% dos agentes e 25,5% do custo; Sonnet 27,9% dos agentes e 3,0% do custo; Haiku 10,3% dos agentes e 0,1% do custo" src="docs/img/custo-claro.svg" width="100%">
  93. </picture>
  94. <!-- uso-real:img-custo:fim -->
  95. <!-- uso-real:custo-texto:inicio -->
  96. Medição do `custo.py` nas mesmas 5 sessões, inteiras: 351 agentes (os 5 chefes de sessão entram na conta) e 17.604 respostas.
  97. - **Haiku e Sonnet na conta:** os 134 agentes Haiku e Sonnet são 38% dos agentes e 3,2% do custo.
  98. - **Reler ou escrever:** 78% do custo é reler contexto a cada resposta (46% leitura de cache, 32% escrita de cache); o que os modelos escrevem é 22%.
  99. - **Por papel:** os 5 chefes de sessão ficam com 34%; agentes genéricos (`general-purpose`), 24%; executores `orq-executor`, 20%; revisores `orq-revisor`, 2,6%; mestres `orq-mestre`, 1,1%; leitores `orq-leitor`, 0,2%; agentes de fora do plugin, 18%.
  100. - **Simulação:** 20% menos respostas corta 20% do custo; encolher em 20 mil tokens o contexto inicial de cada agente corta 3,3%.
  101. <!-- uso-real:custo-texto:fim -->
  102. Modelo barato trabalhando quase não aparece na conta, e o que custa é reler, não escrever. Por isso a skill manda juntar chamadas e escrever brief bem desenhado, em vez de economizar no texto do brief.
  103. ### O que a ficha aprendeu sozinha
  104. Lições que o registro guardou de tarefas que passaram de primeira e que hoje entram nos briefs seguintes:
  105. | tipo | lição |
  106. |---|---|
  107. | leitura | Perguntas fechadas, cada uma com letra, e a ordem de responder "não diz" quando o material não diz. A resposta volta conferível linha a linha. |
  108. | pesquisa web | Pedir o trecho copiado, não parafraseado, e ler a documentação pelo `.md` da página: o resumo automático troca palavras. |
  109. | edição lógica | Listar no brief todas as ocorrências do padrão (um grep), não só a do achado. O operário conserta uma e deixa a irmã. |
  110. | front | CSS do operário em arquivo próprio, com prefixo obrigatório em todo seletor. Não vaza para o resto e confere com 1 grep. |
  111. | teste | Ambiente pronto pelo chefe e roteiro numerado: 9 checagens de primeira em 3,5 minutos. |
  112. | revisão | Pedir prova por execução. Numa revisão do motor, 15 achados e os 15 confirmados. |
  113. | coordenação | Planta com os fatos já medidos e aceite numérico: uma frente inteira em 16 respostas do mestre. |
  114. > [!NOTE]
  115. > Leia os números com o tamanho que eles têm: um usuário e poucos dias de uso. "De primeira" quer dizer que passou na primeira conferência do chefe, que roda o aceite ele mesmo. Custo é token ponderado pelo preço de API de cada modelo, não fatura. A sua ficha começa vazia e vai chegar aos seus próprios números.
  116. ## Como funciona
  117. <!-- uso-real:img-ciclo:inicio -->
  118. <picture>
  119. <source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/img/ciclo-escuro-estreito.svg">
  120. <source media="(prefers-color-scheme: dark)" srcset="docs/img/ciclo-escuro.svg">
  121. <source media="(max-width: 600px)" srcset="docs/img/ciclo-claro-estreito.svg">
  122. <img alt="Ciclo do chefe: ficha, quebrar, brief, despachar, conferir (se não passou, corrigir em até 3 rodadas) e registrar; o registro volta para a ficha, que aprende" src="docs/img/ciclo-claro.svg" width="100%">
  123. </picture>
  124. <!-- uso-real:img-ciclo:fim -->
  125. - **O chefe decide, o operário executa.** Arquitetura, regra de negócio, deploy e o veredito de "pronto" ficam com a sessão. Operário recebe objetivo, escopo, fontes, restrições, formato de entrega e o aceite que será rodado.
  126. - **"Feito" sem prova não é feito.** O chefe roda o aceite ele mesmo, e aceite que não consegue falhar não vale: em dinheiro, acesso e segurança, desfaz a mudança, vê o teste cair e restaura.
  127. - **Quem erra ganha brief melhor antes de modelo maior.** A escada é brief mais desenhado, depois mais esforço, depois um modelo acima. Na terceira rodada sem resolver, o chefe faz.
  128. - **A rota é medida, não opinião.** Um modelo mais barato só vira a rota de um tipo de tarefa depois de provar que aguenta, e a ficha propõe o experimento onde ainda não há prova.
  129. - **O modelo que rodou é conferido.** `operarios.py conferir` lê no transcript o modelo real de cada operário e acusa quem saiu diferente do pedido.
  130. ### Os papéis
  131. | papel | modelo padrão | faz | não faz |
  132. |---|---|---|---|
  133. | `orq-leitor` | Haiku | busca, leitura, pesquisa com fonte | editar arquivo |
  134. | `orq-executor` | Sonnet | código, teste, script de dados, tela, texto, só nos arquivos do escopo | decidir design, sair do escopo |
  135. | `orq-revisor` | Sonnet (Opus em dinheiro e segurança) | revisar a entrega de outro e dar veredito | consertar |
  136. | `orq-mestre` | Opus | tocar uma frente inteira no modo god | mudar o contrato entre as frentes |
  137. | `orq-engenheiro` | Fable | as 3 visitas do modo god | despachar operário, editar código |
  138. ### Modo god, para obra grande
  139. Quando o trabalho se parte em 2 frentes que não se tocam e passa de umas 8 tarefas, o chefe vira engenheiro e sai da obra: faz 3 visitas (a análise que vira a planta, a consulta quando um mestre trava, a vistoria no fim) e deixa 2 mestres de obras tocando os operários.
  140. <!-- uso-real:img-modo-god:inicio -->
  141. <picture>
  142. <source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/img/modo-god-escuro-estreito.svg">
  143. <source media="(prefers-color-scheme: dark)" srcset="docs/img/modo-god-escuro.svg">
  144. <source media="(max-width: 600px)" srcset="docs/img/modo-god-claro-estreito.svg">
  145. <img alt="Modo god: um engenheiro em Fable faz 3 visitas; 2 mestres de obras em Opus tocam uma frente cada, cada um com leitor Haiku, executor Sonnet e revisor Sonnet" src="docs/img/modo-god-claro.svg" width="100%">
  146. </picture>
  147. <!-- uso-real:img-modo-god:fim -->
  148. <!-- uso-real:modo-god-texto:inicio -->
  149. No uso real, 34 dos 351 agentes rodaram assim, no segundo andar (operário aberto por um mestre), e custaram 0,9% do total; os 3 mestres somaram 1,1%.
  150. <!-- uso-real:modo-god-texto:fim -->
  151. O andar caro é o engenheiro, e é por isso que ele só faz visita. Detalhes em [`modo-god.md`](plugins/orquestrador/skills/orquestrador/modo-god.md).
  152. ## Instalar
  153. No terminal:
  154. ```bash
  155. claude plugin marketplace add gbertelliti-collab/claude-skills
  156. claude plugin install orquestrador@gbertelli-skills
  157. ```
  158. Dentro de uma sessão, o equivalente é `/plugin marketplace add gbertelliti-collab/claude-skills` e `/plugin install orquestrador@gbertelli-skills`. Confira com `claude plugin list` e abra uma sessão nova: papéis instalados no meio de uma sessão só aparecem na seguinte.
  159. **Requisitos**
  160. - Claude Code com suporte a plugins e marketplaces.
  161. - Python 3 no PATH (`python`, `python3` ou `py -3`). O motor usa só a biblioteca padrão.
  162. - Os modelos `haiku`, `sonnet` e `opus` disponíveis na conta (e `fable`, se for usar o engenheiro do modo god).
  163. - Opcional, para a skill `provar-na-tela`: a CLI `playwright-cli`, ou o navegador embutido do app desktop do Claude Code, ou Chrome, Chromium ou Edge com o pacote Python `websocket-client`.
  164. ## Receber atualizações
  165. O Claude Code só liga atualização automática sozinho nos marketplaces oficiais. Em marketplace de terceiro, como este, ela vem desligada e quem publica não consegue ligar por você. É um ajuste, uma vez só, e o plugin te ajuda a fazer:
  166. **O plugin pergunta.** Na primeira sessão depois de instalar, ele percebe que a atualização está desligada e pede ao Claude que te avise e pergunte se você quer ligar. Respondeu sim, o Claude roda um comando do motor que acrescenta `autoUpdate: true` na entrada do marketplace no seu `settings.json` (e guarda uma cópia do arquivo ao lado). Respondeu não, ele não pergunta mais. Sem resposta, ele lembra no máximo uma vez por semana, três vezes no total. Ele nunca liga sozinho.
  167. **No app desktop precisa de mais uma chave.** O app desktop abre toda sessão com a atualização em segundo plano desligada (`DISABLE_AUTOUPDATER=1`), e com isso a de plugins também não roda, mesmo ligada no marketplace. Quando o plugin percebe esse caso, o mesmo "sim" grava também `FORCE_AUTOUPDATE_PLUGINS=1` no bloco `env` do `settings.json`, que é a variável do Claude Code para manter só a atualização de plugins.
  168. **Ou pelo menu**, no terminal:
  169. 1. Numa sessão, rode `/plugin` e abra a aba **Marketplaces**.
  170. 2. Selecione `gbertelli-skills` e escolha **Enable auto-update**.
  171. Para conferir a qualquer hora: `operarios.py atualizacao` diz se está ligada e por quê; `operarios.py atualizacao --ligar` liga; `--nao-perguntar` cala o aviso (a variável `ORQ_SEM_AVISO_ATUALIZACAO=1` também).
  172. Daí em diante cada mudança deste repositório chega sozinha. O Claude Code confere em segundo plano nos primeiros minutos de cada sessão, avisa `Plugin updated: orquestrador · Run /reload-plugins to apply` e, mesmo que você ignore o aviso, a versão nova já vale na sessão seguinte.
  173. O plugin não fixa número de versão de propósito: assim cada commit conta como versão nova e nenhuma melhoria fica presa esperando alguém lembrar de subir o número.
  174. Para atualizar na mão, sem ligar nada:
  175. ```bash
  176. claude plugin marketplace update gbertelli-skills
  177. claude plugin update orquestrador@gbertelli-skills
  178. ```
  179. <details>
  180. <summary>Para um time: ligar a atualização automática por configuração</summary>
  181. <br>
  182. Em `settings.json` (do usuário, do projeto ou gerenciado pela organização), a entrada do marketplace aceita `autoUpdate`:
  183. ```json
  184. {
  185. "extraKnownMarketplaces": {
  186. "gbertelli-skills": {
  187. "source": { "source": "github", "repo": "gbertelliti-collab/claude-skills" },
  188. "autoUpdate": true
  189. }
  190. }
  191. }
  192. ```
  193. As variáveis `DISABLE_AUTOUPDATER=1` e `DISABLE_UPDATES=1` desligam também a atualização de plugins; `FORCE_AUTOUPDATE_PLUGINS=1` mantém a dos plugins ligada mesmo assim.
  194. </details>
  195. ## Como usar
  196. Peça trabalho com 2 ou mais partes independentes e a skill abre sozinha. Também dá para chamar pelo nome: `/orquestrador:orquestrador`. Um exemplo de como a conversa anda, num projeto fictício:
  197. ```text
  198. você adiciona o limite de estoque no carrinho e mostra o erro na tela. usa os operários
  199. chefe Ficha lida. São 3 partes:
  200. [haiku:leitura] mapear quem chama adicionarItem
  201. [sonnet:edicao-logica] regra do limite + testes (2 arquivos)
  202. [sonnet:front] mensagem de erro na tela do carrinho
  203. Despachei a leitura e a regra. Enquanto isso escrevo o brief da tela.
  204. chefe Leitura voltou: 3 chamadores, todos passam pela mesma função.
  205. Regra voltou: rodei os testes, passaram; desfiz a checagem e os 2 casos
  206. de erro caíram, então o teste prova. Tela despachada. Falta só ela.
  207. chefe Pronto. operarios: 3 tarefas, 3 de primeira | haiku fez 1 de 3
  208. ```
  209. O brief que o executor recebeu nesse exemplo está inteiro em [`exemplos/brief-nivel3-edicao.md`](plugins/orquestrador/skills/orquestrador/exemplos/brief-nivel3-edicao.md): trecho atual colado, decisão literal, tabela de casos e um aceite que consegue falhar.
  210. ### Se você já tem um fluxo próprio
  211. A skill abre sozinha em trabalho com várias partes, e isso não muda em projeto comum. Só quando o seu projeto já entrega um tipo de tarefa a alguém (um agente especialista de redação, uma regra no `CLAUDE.md` dizendo quem faz) é que ela cede naquela parte: a tarefa vai para o seu agente, e o orquestrador cuida do resto.
  212. Para apertar mais, do mais leve ao mais firme:
  213. | Você quer | Faça |
  214. |---|---|
  215. | Que ela só abra quando você pedir | Uma linha no `CLAUDE.md` do projeto (ou no `~/.claude/CLAUDE.md`, para valer em tudo): `Use a skill orquestrador só quando eu pedir pelo nome.` |
  216. | Que o Claude não consiga abrir sozinho | Regra de negação em `permissions.deny` do `settings.json`: `Skill(orquestrador:orquestrador)`. Digitando `/orquestrador:orquestrador` ela continua abrindo. |
  217. | Desligar tudo por um tempo | `/plugin` e desative o `orquestrador` |
  218. A configuração `skillOverrides` do Claude Code não vale para skill de plugin, então ela não serve aqui.
  219. ### O motor
  220. ```bash
  221. python <pasta da skill>/operarios.py <status|ficha|registrar|conferir|retomar|resumo|atualizar|atualizacao>
  222. python <pasta da skill>/custo.py [--do-registro] [--precos tabela.json] [--mostrar-precos]
  223. ```
  224. O Claude Code informa a pasta da skill quando ela carrega, e quem roda esses comandos no dia a dia é o próprio chefe. Para ter ideia do que sai, isto é um trecho da ficha real em 17/11/2026 (lições encurtadas):
  225. ```text
  226. leitura -> haiku brief 2 (rota padrao)
  227. licao: conferir doc pelo curl do .md da pagina; o WebFetch resume
  228. stats: haiku b1 1a 1/1 ok 1/1; b2 1a 19/19 ok 19/19 ~10k | sonnet b2 1a 8/9 ok 8/9 ~22k
  229. edicao-logica -> sonnet brief 3 (rota padrao)
  230. licao: dar no brief TODAS as ocorrencias do padrao (grep), nao so a do achado
  231. stats: sonnet b2 1a 0/1 ok 1/1; b3 1a 10/16 ok 16/16 ~27k | opus b2 1a 0/5 ok 5/5 ~272k; b3 1a 2/3 ok 3/3
  232. teste -> sonnet brief 3 (rota padrao)
  233. experimento: haiku brief 3 (sem prova com brief 3 (n=2); feitos 2 de 4)
  234. stats: haiku b3 1a 1/2 ok 2/2 ~61k | sonnet b3 1a 1/1 ok 1/1 ~8k | opus b2 1a 0/1 ok 1/1 ~215k
  235. ```
  236. Como ler: `b2 1a 19/19` é "com brief nível 2, 19 de 19 passaram de primeira"; `ok` conta também as que fecharam depois de correção; `~10k` é a saída mediana em tokens. A ficha olha os últimos 20 registros de cada par, então erro que parou de acontecer sai sozinho. E a linha que fecha um trabalho, também real, do mesmo dia:
  237. ```text
  238. operarios: 144 tarefas, 118 de primeira, 24 corrigidas, 0 escaladas, 2 falharam | haiku 31/32 de primeira; sonnet 71/86 de primeira; opus 16/26 de primeira | saida: haiku 0,41M · sonnet 0,77M · opus 3,8M | haiku fez 32 de 144
  239. ```
  240. ### Configuração (tudo opcional)
  241. | variável | para que serve | padrão |
  242. |---|---|---|
  243. | `ORQ_REGISTRO` | arquivo do registro de tarefas | `~/.claude/orquestrador/registro.jsonl` |
  244. | `ORQ_FICHA` | arquivo `.md` onde `operarios.py atualizar` grava a ficha | sem ela, `atualizar` só avisa e sai com código 0 |
  245. | `ORQ_PROJECTS` | pasta dos transcripts do Claude Code | `~/.claude/projects` |
  246. | `ORQ_PRECOS` | arquivo JSON que sobrescreve preços da tabela do `custo.py` (o mesmo que `--precos`; `--mostrar-precos` imprime a tabela atual para você salvar e editar) | tabela interna, com a data em que foi lida |
  247. | `ORQ_SEM_AVISO_ATUALIZACAO` | `1` cala o aviso de atualização automática desligada | avisa (no máximo 3 vezes) |
  248. - **Nome dos agentes:** agente de plugin leva o prefixo do plugin, então o `subagent_type` é `orquestrador:orq-leitor`, `orquestrador:orq-executor` e assim por diante. Se a sua versão do Claude Code mostrar os agentes sem prefixo, use o nome simples.
  249. - **`PROJETOS.md`:** `provar-na-tela` e `bater-valores` leem um `PROJETOS.md` opcional na pasta de cada skill (como subir, entrar e conferir cada projeto seu). Copie o `PROJETOS.exemplo.md` e preencha; sem ele, as skills usam o README do projeto.
  250. ## O que vem no plugin
  251. | skill | quando abre | o que faz |
  252. |---|---|---|
  253. | [`orquestrador`](plugins/orquestrador/skills/orquestrador/SKILL.md) | trabalho com 2 ou mais partes independentes | o ciclo completo: ficha, quebra, brief, despacho, conferência, correção e registro, além do modo god |
  254. | [`auditoria-adversarial`](plugins/orquestrador/skills/auditoria-adversarial/SKILL.md) | "varredura", "auditoria do projeto", "análise adversarial" | varre o projeto inteiro com vários agentes, prova cada achado e corrige no mesmo dia |
  255. | [`provar-na-tela`](plugins/orquestrador/skills/provar-na-tela/SKILL.md) | antes de dizer "pronto" numa mudança visual | abre a tela de verdade, tira o print e compara com o pedido |
  256. | [`bater-valores`](plugins/orquestrador/skills/bater-valores/SKILL.md) | "não bate", "faltando", "pagou 2x" | roteiro para divergência de valor, com as causas comuns e a prova |
  257. | [`placar`](plugins/orquestrador/skills/placar/SKILL.md) | só quando você digita `/orquestrador:placar` | mostra o que a sessão despachou e ainda não registrou, quem acerta de primeira por modelo e para onde foi o token |
  258. **Retomada automática.** O plugin traz um hook de início de sessão que só age depois que o contexto compacta ou a sessão é retomada: se a sessão já tinha despachado operários, ele devolve ao chefe a lista de quem ficou sem registro (o mesmo que `operarios.py retomar`). Sem operários, não imprime nada. Ele só lê os transcripts locais e precisa de Python 3 e de `sh` (no Windows, o Git Bash).
  259. ```text
  260. .claude-plugin/marketplace.json o marketplace (gbertelli-skills)
  261. plugins/orquestrador/
  262. .claude-plugin/plugin.json o plugin (sem número de versão: cada commit é uma versão)
  263. agents/ os 5 papéis orq-*, cada um com sua cor na lista de tarefas
  264. hooks/ retomada depois de compactar; aviso de atualização desligada
  265. skills/
  266. orquestrador/
  267. SKILL.md o ciclo do chefe
  268. modo-god.md engenheiro, mestres de obras e operários
  269. fundamentos.md de onde saiu cada regra, com fonte e marca de medido ou opinião
  270. operarios.py registro, ficha, conferência de modelo, resumo
  271. custo.py para onde foram os tokens
  272. exemplos/ briefs e planta prontos para copiar
  273. tests/ os testes do motor
  274. auditoria-adversarial/
  275. provar-na-tela/
  276. bater-valores/
  277. placar/ o comando /orquestrador:placar
  278. docs/
  279. uso-real.json os números agregados deste README
  280. graficos.py gera os gráficos a partir deles
  281. readme_blocos.py preenche os trechos com número deste README
  282. tests/ testes do gerador e da estrutura do plugin
  283. ```
  284. Para rodar os testes:
  285. ```bash
  286. cd plugins/orquestrador/skills/orquestrador
  287. python -m unittest discover -s tests
  288. ```
  289. Os testes da estrutura do plugin e do gerador do README rodam da raiz:
  290. ```bash
  291. python -m unittest discover -s docs/tests
  292. ```
  293. Para gerar o mesmo retrato com o seu uso (lê o seu registro e os seus transcripts, grava só números agregados):
  294. ```bash
  295. python docs/graficos.py --coletar
  296. ```
  297. E `python docs/graficos.py --conferir` acusa se o README ou alguma imagem saiu do passo com o JSON; é o que roda a cada push.
  298. O que mudou em cada data está no [CHANGELOG](CHANGELOG.md). Para contribuir, veja o [CONTRIBUTING](CONTRIBUTING.md); para relatar falha de segurança, o [SECURITY](SECURITY.md).
  299. ## Privacidade
  300. O repositório traz só números agregados do uso: nenhum brief real, nenhum nome de projeto e nenhuma tabela de projetos. A ficha de quem instala começa vazia e aprende com o próprio uso. O registro, a ficha e o `PROJETOS.md` que você preencher ficam só na sua máquina (estão no `.gitignore`).
  301. Os dois hooks do plugin só leem arquivos locais e não usam a rede. O de atualização lê a configuração de plugins do Claude Code para saber se a atualização automática está ligada e guarda a data do último aviso; o seu `settings.json` só é alterado quando você aceita, pelo comando `atualizacao --ligar`.
  302. ## Licença
  303. [MIT](LICENSE). Pode usar, copiar, mudar e redistribuir, mantendo o aviso de copyright.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.