Original em inglês: https://argusic.com/subject/keep-the-why
keep-the-why
A camada de motivação (why) da memória nativa do repositório: a lógica por trás de um código-fonte como Markdown no repositório, versionada pelo Git, para agents de código e humanos, para que nada rejeitado seja proposto duas vezes. Sem banco de dados, sem daemon, sem conta.
Executafonte: GitHubpágina do projetoJavaScriptMITcommit 8268a33c00ba
JavaScript, licença MIT. O projeto se descreve como: agent skills, ai agents, architecture decision records, coding agents, context engineering, developer tools, documentation e git.
keep-the-why executa. Em uma máquina limpa sem GPU, um agent da Argusic o instalou em 2 minutos e não encontrou nenhum erro, e a sessão inteira foi gravada.
keep-the-why-lint 0.20.0.0 and keep-the-why-dashboard 0.7.3 are installed and functional. The linter validates this project's context/ (0 errors, 0 warnings, schema 0.20.0). The dashboard serves its UI at localhost:8765 (HTTP 200), exports static pages, and both packages' test suites pass completely (116+61+65 = 242 tests).
O que o agent conseguiu em uma máquina limpa, nas palavras dele. Como isto é medido
Medido pela Argusic em uma máquina nova, todas as vezes. Cada número tem link para as suas evidências. Pontuação Argusic 100 de 100 (a média das pontuações das execuções deste projeto).
Visão geral
Dados do projeto de GitHub, com link no topo desta página, atualizado em . Dados de teste da Argusic (CC BY 4.0); cada número tem link para uma página de execução com o log completo, a gravação e os hashes sha256 deles.
O que foi medido
Da execução que decidiu este veredito. Cada linha é um valor registrado, não uma estimativa.
- Tempo de instalação
- 2 minutos
- Da máquina limpa até o fim
- 4 minutos
- Erros encontrados e corrigidos
- 0 encontrados, 0 corrigidos sem ajuda humana
- Como o resultado foi comprovado
- ktw-lint . returned 0 errors, 0 warnings; ktw-dashboard --json produced valid state with 130 entries; ktw-dashboard server responded HTTP 200; pytest lint/tests/ returned 116 passed; pytest dashboard/tests/ returned 61 passed; pytest tools/evals/tests/ returned 65 passed. Export generated index.html, state.json, badge-entries.svg.
- Tokens de modelo usados
- 232.871
- Commit exato testado
- 8268a33c00ba
- Imagem do container
- sha256:cdd920bce783
O que não foi medido
A outra metade, para você ver exatamente até onde estas evidências vão. Uma lacuna é mostrada como lacuna e nunca é preenchida.
- Pico de memória da GPU
- esta execução foi em uma máquina com CPU, então não havia GPU para medir
- Comportamento em uma execução longa
- cada tentativa usa as menores configurações documentadas e um orçamento de tempo fixo, então isto mede se ele executa, não como ele se comporta sob carga
O fim da gravação
As últimas linhas da sessão de terminal que decidiu este veredito, exatamente como foram gravadas.
=== Dashboard version === ktw-dashboard 0.7.3 === Lint version === ktw-lint 0.20.0.0 === Build time calc === Started around 2026-10-29 11:00:17 Good. The total time spent is about 2 minutes. Let me calculate more precisely and compile the fina… Here is the final summary: tokens used 232,871 Good. The total time spent is about 2 minutes. Let me calculate more precisely and compile the fina… Here is the final summary:
Reproduzir a sessão inteira, cada comando desde a máquina limpa até este ponto.
Como foi testado
Um agent, um container, nenhuma ajuda humana. Ele instala o projeto do jeito que a própria documentação do projeto manda, executa o projeto e corrige o que quebra. Tudo abaixo é registrado como aconteceu: a sessão de terminal, o log e o commit exato. A metodologia completa.
Pontos fortes e limites
Fatos medidos, não opiniões. Como este conteúdo é escrito.
O que deu certo
- Chegou a um estado de execução em uma máquina limpa, com a sessão gravada.
- Instalado em 2 minutos, mais rápido que a mediana dos 106 projetos comparáveis que a Argusic mediu.
- Nada quebrou no caminho: zero erros entre o clone e a execução.
- Executou sem GPU, então não precisa de uma para iniciar.
- Licença MIT, segundo a plataforma onde o projeto está hospedado.
O que não deu certo, ou não se sabe
- Medido uma vez até agora. Uma única tentativa mostra que ele pode executar, não que executa de forma confiável.
Dos 107 projetos de agent-skills que a Argusic instalou e cronometrou, keep-the-why foi o 35º mais rápido a chegar a um estado de execução, e 78 de 107 chegaram a esse estado.
Para que é uma escolha razoável
- Testar em um laptop ou em um servidor pequeno: ele chegou a um estado de execução sem GPU.
- Uma avaliação rápida: ele estava executando 2 minutos depois do clone.
- Seguir o próprio README: o caminho documentado funcionou sem nada para corrigir.
Também testados, na mesma área
Cada um destes foi instalado e executado pela Argusic em uma máquina limpa. Nada aparece aqui sem ter sido testado.
Histórico de execuções
Tópicos (de GitHub)
agent-skillsai-agentsarchitecture-decision-recordscoding-agentscontext-engineeringdeveloper-toolsdocumentationgitknowledge-managementllm-agentsproject-memoryrepo-local-memoryrepo-native
Incorporar o selo
Markdown para o README do projeto. Ele tem link de volta para esta página; os termos estão na página de termos.
[](https://argusic.com/subject/keep-the-why)Perguntas
- keep-the-why executa?
- Sim. keep-the-why executa. A Argusic o instalou e iniciou em uma máquina limpa em 2 minutos, encontrando 0 erros no caminho, e gravou a sessão.
- Como a Argusic testou keep-the-why?
- Em uma máquina nova e descartável, com cada comando gravado e o repositório fixado no commit 8268a33c00ba. Há uma tentativa registrada, e a metodologia completa está na página da metodologia.
- Quanto custou testar keep-the-why?
- A execução que produziu este veredito custou US$ 0,04: custo real de computação e de modelo, não um preço de tabela por milhão de tokens. Esse valor está registrado na página da execução.
- Quanto tempo leva para instalar keep-the-why?
- 2 minutos na execução que decidiu este veredito, de uma máquina limpa até um estado de execução. É uma tentativa medida, não uma média.
- keep-the-why precisa de GPU?
- Não para iniciar. A Argusic chegou a um estado de execução em uma máquina sem GPU.
- O que dá errado ao instalar keep-the-why?
- Nada deu errado na execução registrada: zero erros entre o clone e a execução.
- Como keep-the-why se compara às alternativas?
- Dos 107 projetos de agent-skills que a Argusic instalou e cronometrou, keep-the-why foi o 35º mais rápido a chegar a um estado de execução, e 78 de 107 chegaram a esse estado.
- Onde estão as evidências de keep-the-why?
- A execução registrada está nesta página, cada uma com link para o seu log completo e a sua gravação do terminal, guardados com uma impressão digital sha256 para que não possam ser alterados discretamente.