promo-scout
Inteligência de promoção genérica, verificada-primeiro. É o oposto de um raspador de hype: nada chega ao quadro a menos que o estado ao vivo do GitHub o comprove, e o julgamento é feito por consenso sshx (perspectivas isoladas + tabela verdade), não pela opinião de um único modelo.
Requer: gh autenticado com sua autenticação GitHub existente, via gh auth login ou GH_TOKEN, e a skill sshx disponível para o chamador.
Quando usar
Um agente ou operador deseja, para um repositório/organização alvo: o que é genuinamente promovível agora, como as peças se conectam entre repositórios e quais alegações tentadoras NÃO são verificáveis.
Passo 0 — confirme o escopo explícito COM O USUÁRIO
Não há padrão amplo para toda a conta. Exija que o usuário nomeie:
- uma organização inteira (apenas repositórios públicos por padrão),
- um ou mais repositórios específicos (
proprietário/repo), ou - uma lista mista.
Confirme também
REPO_LIMITpara alvos de organização (padrão: 12 repositórios públicos mais recentemente ativos). A coleta de repositórios privados requer aceitação explícita com--include-private; não use essa flag a menos que o usuário a tenha confirmado.
Passo 1 — obtenha o estado ao vivo (determinístico; executa de qualquer lugar)
Execute o buscador incluso com um alvo explícito:
python3 scripts/promo_scout_fetch.py <org | proprietário/repo> [mais...] # escopo público/padrão
python3 scripts/promo_scout_fetch.py --include-private <org | proprietário/repo> [mais...] # somente após confirmação explícita
Ele escreve /tmp/promo_scout_bundle.json: por repositório, cabeçalho do README, commits recentes, releases, PRs abertos, issues recentes. Esta é a ÚNICA evidência que o passo de consenso pode usar.
Passo 2 — execute o consenso sshx real sobre o pacote
Invoque a skill sshx (delegado de trabalho, perspectivas isoladas, workers codex-cli) com esta decisão, alimentando o pacote como entrada fixa:
Dado APENAS este pacote de estado ao vivo do GitHub, produza três listas. (1) Promovível: itens genuinamente dignos de promoção agora — cada um DEVE citar evidência concreta do pacote (uma tag de release, um commit datado, uma capacidade do README). (2) Conexões: links entre repositórios onde o trabalho de um repositório se compõe com o de outro, cada um apoiado por um sinal real no pacote (PRs compartilhados, menções de dependência, capacidade complementar). (3) Descartado: alegações tentadoras que o pacote NÃO suporta, com a evidência ausente. Sem exagero; se a evidência estiver ausente, vai para Descartado, não para Promovível.
Use perspectivas de pensamento sshx distintas, por exemplo: uma lente de promovibilidade, uma lente de conexão entre repositórios e uma lente de cético / caçador de exageros. Exija convergência conforme a tabela verdade sshx; honre abster quando os trabalhadores não puderem estabelecer uma alegação.
Passo 3 — emita o quadro
Escreva o resultado acordado como um quadro (markdown + JSON opcional): ## Promovível agora, ## Conexões, ## Descartado (não verificável). Cada item promovível/de conexão carrega sua evidência do pacote inline. A lista Descartado é obrigatória — é a credibilidade do quadro.
Salvaguardas
- Evidência ou não é enviado. O pacote ao vivo é a única fonte; sem memória externa, sem números inflados.
- As conexões/síntese devem EMERGIR do consenso sobre o estado ao vivo — não injete uma narrativa pré-escrita.
- Honesto por construção: não verificável → Descartado; quando o consenso não puder ser alcançado, reporte
abster, não um palpite.