Relatório de Custo do Agente

Claude-Mem / Claude Code skill. O tempo de execução é o pipeline scripts/ (transcrições → tokens → dólares → relatório estilo Timing) mais uma passagem de revisão progressiva do Mem Search que confirma os rótsulos elaborados. O rascunho do Notion é apenas histórico de ESPECIFICAÇÕES — nunca o produto, nunca o tempo de execução, nunca o veículo de envio.

Resolva o diretório absoluto que contém este SKILL.md; todos os caminhos auxiliares são relativos a esse diretório. ${CLAUDE_SKILL_DIR} é o atalho: python3 "${CLAUDE_SKILL_DIR}/scripts/acr.py" …. Apenas a biblioteca padrão do Python 3.9+, com dados de fuso horário IANA para America/Los_Angeles; sem instalações pip. tzdata é a única exceção à regra de não instalar pip, e apenas quando acr.py sair dizendo que os dados de fuso horário não estão disponíveis (o Python padrão do Windows não envia nenhum): mostre ao usuário as linhas que ele imprimiu e pergunte (AskUserQuestion) antes de instalá-lo. Em um sim, execute a linha para seu shell (a linha entre aspas simples no Bash ou cmd, a linha PowerShell: no PowerShell), então execute novamente o comando com falha. Definir PYTHONTZPATH em vez disso não requer instalação. A aparência fica em scripts/acr/render.py, nunca aqui.

Propósito

Transformar a atividade do Claude-Mem em um relatório de custo e falha legível pelo gerente.

Ideia de produto: uma skill reutilizável que pesquisa o Claude-Mem via Mem Search, reconstrói unidades reais de trabalho, atribui categorias de custo e falha e gera um relatório imprimível.

Estrela guia de insights

O título principal são os dólares, com duas casas decimais, rotulados. Os dólares vêm das transcrições do Claude Code (uso exato de tokens por resposta) precificados pelos preços públicos da OpenRouter, portanto são ESTIMADOS. O gasto medido do provedor aparece apenas quando uma fonte sancionada o fornece. Diretamente abaixo dos dólares: o custo dos erros, o que foi enviado e ambos em um eixo de tempo.

Perguntas que o relatório deve responder

1. Que trabalho foi concluído?
2. Quanto custou cada resultado?
3. O que foi desperdiçado por meio de loops, hesitações, caminhos errados, retrabalho ou roteamento inadequado?
4. Alguma ação não autorizada foi tentada?
5. O que o gerente deve mudar a seguir?

Unidade primária = custo por resultado concluído (não custo por observação).

Quando usar

• "Relatório de custo do agente" / "custo por resultado" / "economia de falhas" / "esta sessão valeu a pena" / "quanto custaram os agentes esta semana"
• Após uma escavação real da sessão do Mem quando a liderança precisa de economia de resultados
• Pacotes de amostra / envio que precisam de HTML + JSON + CSV + evidências autocontidos

Mecânica de escavação de memória: a skill claude-mem mem-search (recuperação progressiva).

Escopo padrão (SEMPRE)

• A menos que o usuário nomeie uma sessão / intervalo / projeto específico, a janela é os últimos 7 dias completos em PT, sem contar hoje: end = a meia-noite PT que começou hoje (exclusivo), start = end − 7 days. A janela padrão nunca contém um dia parcial (G3, Alex 2026-09-25).
• Janelas explícitas: --start YYYY-MM-DD --end YYYY-MM-DD (dias de calendário PT, fim exclusivo). Um --end explícito posterior a hoje marca o último dia "parcial, gerado HH:MM PT".
• Uma sessão: --session <content_session_id>. Um projeto mais um período: --project <name> --start … --end … (as árvores de trabalho do projeto são incluídas).
• A barra Escopo do relatório mostra o intervalo PT, e os Detalhes listam cada ID de sessão em escopo.

Mem Search Progressivo (SEMPRE)

Siga as três camadas do claude-mem mem-search. Mantenha os gastos baixos.

1. Pesquisa — obtenha um índice de IDs (títulos, tipos, dicas de token).
2. Linha do tempo — apenas em torno de âncoras que você se importa.
3. Observações — get_observations para os IDs filtrados que você citará como evidência.

Receita:

1. Resolva o escopo (padrão: os últimos 7 dias completos em PT).
2. Pesquisar → coletar IDs.
3. Linha do tempo apenas para contexto fino.
4. Observações para pretendido / real / resultado / desperdício / retrabalho / bloqueado / não autorizado / status.
5. Agrupar em itens de trabalho nomeados + eventos de falha.
6. Calcular custos por item.
7. Gerar HTML + PDF opcional (+ json/csv/evidências).
8. Mantenha os IDs de evidência no apêndice — não despeje linhas do tempo inteiras no relatório principal.

Tópicos do processo TDAH:

• Pesquisar primeiro → escolher IDs → linha do tempo apenas se o contexto for fino → buscar apenas observações necessárias.
• Títulos de itens de trabalho são inventados para gerentes ("Restaurar pesquisa após loop de falha do Chroma"); títulos de observações permanecem apenas para evidências.
• O apêndice de evidências lista IDs de observações + títulos curtos; as seções principais permanecem focadas no resultado.

…