Skip to content

Dúvida de uso! #11

Closed
Closed

Description

@geraistec

Não entendi o uso, como saber se estou usufruindo dos benefícios do Th0th no desenvolvimento do projeto?

Seria bom ter isso no README.

Activity

  1. added
    documentationImprovements or additions to documentation
    questionFurther information is requested
    on Mar 5, 2026
  2. S1LV4 commented on Mar 5, 2026

    @S1LV4
    Owner

    Fala @geraistec! Muito obrigado pelo feedback. Entendi perfeitamente a sua dúvida e faz todo sentido: como o Th0th roda nos bastidores, às vezes fica mesmo difícil "ver" a ferramenta trabalhando.

    Vou explicar como você pode notar a diferença no seu dia a dia e o que estou preparando para deixar isso mais visual.

    Como perceber os benefícios hoje?

    O Th0th funciona de forma invisível e automática quando integrado ao seu assistente de IA (OpenCode, Claude Desktop, Cursor, etc). Você vai notar que ele está agindo através de três frentes:

    • Respostas mais rápidas e focadas: A IA para de "alucinar" porque recebe apenas o trecho exato que precisa, em vez de ler arquivos irrelevantes.
    • Economia de tokens (e custos): Redução de até 98% no envio de contexto para a API da sua IA.
    • Autonomia (Busca Semântica): Você não precisa mais ficar anexando arquivos manualmente no chat. A IA vasculha o repositório sozinha por semântica.

    Para tirar o Th0th dessa "invisibilidade", estou desenvolvendo várias melhorias:

    • Dashboard Web: Uma interface mostrando em tempo real o funcionamento do th0th, histórico de buscas, projetos indexados e gráficos de performance.
    • Novas otimizações de busca contextual, melhorias nos índices de performance, fluxos de pesquisa e leitura.
    • Modo Debug/Verbose: Uma opção para você visualizar o "antes e depois" da compressão de cada arquivo e a pontuação de relevância das buscas.

    Publiquei um artigo recente, trazendo justamente o problema que o Th0th resolve e a arquitetura dele (como funciona a compressão sem LLM). Se tiver curiosidade, dá uma lida:

    👉 Como reduzi em 98% o uso de contexto e os custos de IA no meu workflow

    Vou atualizar o README.md criando uma seção de "Como verificar se está funcionando", com guias de troubleshooting e exemplos visuais.

    Mais uma vez, valeu pela issue! Feedbacks assim ajudam demais a evoluir o projeto. 🤝

  3. geraistec commented on Mar 6, 2026

    @geraistec
    Author

    Teria algum prompt para usar nas regras?
    Caso não tenha, qual seria eficiente?

  4. S1LV4 commented on Mar 7, 2026

    @S1LV4
    Owner

    Teria algum prompt para usar nas regras? Caso não tenha, qual seria eficiente?

    https://github.com/S1LV4/th0th/blob/main/skills/th0th-memory/SKILL.md

    Tenho utilizado apenas a Skill e já está me servindo muito bem, ele não perde o contexto e não para de utilizar a tool; mas você pode usar de prompts específicos para melhorar o resultado, segue alguns exemplos:

    Os prompts abaixo usam o vocabulário exato das tools e seguem o decision flow documentado.


    Prompts para o Th0th

    Onboarding / Início de sessão

    Antes de qualquer coisa, use th0th_recall para recuperar 
    decisões e padrões deste projeto. Em seguida, use th0th_index 
    para indexar o projeto em [PATH] com projectId="[ID]". 
    Ao finalizar, use th0th_search para explorar a arquitetura geral 
    e armazene com th0th_remember (type="decision", importance=0.9) 
    os padrões encontrados: estrutura de pastas, convenções de 
    nomenclatura, stack principal e decisões arquiteturais relevantes.
    

    Implementar feature

    Use th0th_recall para verificar decisões anteriores sobre [ÁREA]. 
    Implemente [FEATURE] seguindo os padrões encontrados. 
    Ao concluir, salve com th0th_remember:
    - A decisão tomada (type="decision", importance=0.8)
    - O padrão seguido (type="pattern", importance=0.7)
    - Qualquer trade-off relevante (type="decision", importance=0.6)
    

    Investigar bug / entender código

    Use th0th_optimized_context com sessionId="debug-[FEATURE]" 
    para buscar "[DESCRIÇÃO DO PROBLEMA]". 
    Cruze com th0th_recall buscando memórias relacionadas. 
    Aponte onde o comportamento diverge do padrão esperado.
    

    Review de consistência

    Use th0th_recall (types=["pattern","decision"]) para recuperar 
    os padrões registrados do projeto. Em seguida, use th0th_search 
    para analisar [ARQUIVO ou MÓDULO]. Aponte inconsistências entre 
    o código atual e os padrões armazenados.
    

    Sessão longa / contexto grande

    O contexto está ficando grande. Use th0th_compress com 
    strategy="code_structure" no conteúdo acumulado antes de continuar. 
    Para as próximas buscas, use th0th_optimized_context com 
    sessionId="[SESSION-ID-ESTÁVEL]" para aproveitar o cache de sessão.
    

    Fechar sessão / salvar aprendizados

    Antes de encerrar: use th0th_remember para salvar tudo que 
    descobrimos nesta sessão que seria útil em conversas futuras.
    Priorize: decisões tomadas (importance≥0.8), padrões identificados 
    (importance≥0.7), problemas conhecidos (importance≥0.6).
    Use tags relevantes para facilitar o recall futuro.
    

    Regra geral para colocar no system prompt

    Sempre use th0th_recall no início de tarefas que envolvam 
    código deste projeto antes de explorar arquivos. 
    Prefira th0th_search e th0th_optimized_context sobre 
    Glob/Grep/Read. Ao identificar padrões, decisões ou 
    trade-offs relevantes, armazene imediatamente com 
    th0th_remember sem esperar ser solicitado.
    

    A regra geral no system prompt é o mais eficiente para uso contínuo — ela força o comportamento correto sem precisar repetir em cada prompt. Os prompts específicos servem para tarefas pontuais onde você quer controle explícito do fluxo.

  5. reopened this on Mar 7, 2026
  6. Repository owner locked and limited conversation to collaborators on Mar 7, 2026
  7. converted this issue into a discussion #12 on Mar 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomersquestionFurther information is requested

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions