Pular para o conteúdo
🦑 Open Source · Python · CLI

Squidy é umFramework de Engenharia de Contexto

Um comando gera os documentos que seu agente precisa para trabalhar com contexto, regras e rastreabilidade.

squidy — bash

Requer Python 3.9+ e pipx

$ diff sem-squidy com-squidy

O problema que o Squidy resolve

Agentes de IA são poderosos — mas sem estrutura, cada sessão é uma tela em branco.

Sem Squidy
  • Agente sem contexto: recomeça do zero a cada sessão
  • Regras do projeto espalhadas em prompts ad hoc
  • Decisões de arquitetura não documentadas
  • Retrabalho por falta de rastreabilidade
Com Squidy
  • Constituição e Oráculo carregados automaticamente no boot
  • Kanban e contexto de sessão sempre atualizados
  • ADRs documentados — decisões nunca se perdem
  • Agente operacional em segundos com contexto completo

$ squidy --features

Por que usar Squidy?

Um comando, tudo pronto

Execute `squidy` e responda algumas perguntas. Em segundos, arquivos de governança são gerados e configurados para o seu projeto.

Contexto que persiste

Constituição, Oráculo e contexto de sessão são lidos pelo agente no boot. Ele retoma exatamente de onde parou, sem perguntas repetidas.

Rastreabilidade total

Kanban integrado com IDs de tarefas, diário de decisões e ADRs. Cada mudança tem histórico e justificativa.

Agnóstico de LLM

Funciona com Claude, GPT-4, Gemini e Cursor. Os documentos gerados seguem um formato universal baseado em Markdown.

Regras e proibições claras

A Constituição define o que o agente deve e nunca deve fazer. Sem surpresas, sem comportamento off-spec.

Zero dependências de runtime

Apenas arquivos Markdown e YAML. Nenhum servidor, nenhum banco de dados. Funciona em qualquer repositório git.

$ squidy init && tree

O que o Squidy gera

10 arquivos estruturados para que qualquer agente de IA entenda o projeto do zero — em qualquer sessão.

meu-projeto/10 arquivos
├─readme-agent.mdbootInstruções de boot para o agente. Lido antes de qualquer ação.
├─AGENT.mdagentInstruções específicas para Claude, Cursor e outros agentes. Carregado automaticamente em sessões AGENT.
├─constituicao.mdregrasPrincípios, proibições e Definition of Done do projeto.
├─oraculo.mdADRsDecisões arquiteturais (ADRs) com contexto, decisão e consequências.
├─kanban.mdtasksBoard de tarefas com IDs sequenciais, status e critérios de aceite.
├─emergencia.mdRegistro de bloqueios críticos que impedem o progresso.
├─contexto-sessao.mdsessãoEstado atual do projeto: o que foi feito, o que falta, próximos passos.
├─politicas.mdConvenções de código, padrões de nomenclatura e estilo do projeto.
└─indice-diario.mdÍndice consolidado de todas as entradas do diário de desenvolvimento.
└─2026-02.mdEntrada do diário: o que foi feito, por que, e qual resultado.