token-optimizer

Analisa squads AIOS existentes e produz otimizacoes priorizadas por ROI — qualidade, velocidade e economia de tokens.

Pipeline sequencial de 5 agentes que escaneia, detecta anti-patterns, planeja, executa e audita otimizacoes usando TOKEN-OPTIMIZATION-GUIDE.md como base de conhecimento.

/sqopt

Seu squad consome 10x mais tokens do que deveria?

Voce construiu um squad funcional. Ele roda, entrega resultados, resolve o problema. Mas toda execucao custa $0.28 e voce sabe que metade desses tokens esta sendo desperdicada em prompts redundantes, retornos verbosos que ninguem le, e Opus fazendo trabalho de Haiku.

O pior? Voce nao sabe onde estao os gargalos. Sao dezenas de arquivos, multiplos agentes, workflows encadeados — e cada um esconde anti-patterns invisiveis a olho nu. Context Bloat, Double-Read, Ghost Tokens, Model Overkill. O custo se acumula silenciosamente, execucao apos execucao.

E se eu te dissesse que 12 tecnicas comprovadas podem reduzir seu custo em ate 78%, aumentar a qualidade dos outputs em 34%, e que tudo isso pode ser aplicado de forma automatica — sem quebrar nada?

O Antes e o Depois

Como Funciona

[/sqopt] --> [Scanner] --> [Detector] --> [Planner] --> [Executor] --> [Auditor] --> [Report]

O pipeline completo percorre 5 fases sequenciais. Cada agente le o output do anterior via arquivo (Files as Contracts), retorna apenas "Done: {path}" ao orquestrador, e o proximo agente continua de onde o anterior parou. Zero tokens desperdicados em transicoes.

Por que token-optimizer?

• 12 tecnicas comprovadas — Nao e achismo. Cada otimizacao e mapeada a uma secao numerada do TOKEN-OPTIMIZATION-GUIDE.md, com fundamentacao tecnica e metricas de impacto documentadas.

• Priorizacao por ROI — Qualidade primeiro, velocidade segundo, custo terceiro. O planner ordena as acoes pelo maior retorno real, nao pela reducao mais facil. Voce melhora o output antes de cortar custos.

• Deteccao automatica de 10+ anti-patterns — Context Bloat, Double-Read, Model Overkill, Compression Rebound, Ghost Tokens, Sequential Launch, Fat Orchestrator — cada um com scoring de severidade 1-10 e estimativa de tokens desperdicados.

• Modo audit-only — Quer apenas um diagnostico sem modificar nenhum arquivo? O workflow squad_audit_only escaneia, detecta e reporta — zero alteracoes, visibilidade total.

Agentes

Tasks

Workflows

Comandos

/sqopt

/sqopt:run

Tech Stack

optimized/