Sobre o projeto

Eklavya é um plugin para Claude Code que transforma o tempo de geração do agente em tempo de aprendizado. Enquanto o Claude Code implementa sua tarefa, o Eklavya ensina os conceitos por trás desse trabalho exato — perguntas socráticas adaptativas baseadas no diff que ele acabou de escrever, com domínio rastreado em um grafo de conhecimento local e, opcionalmente, uma trava de commit até que você demonstre compreensão. Agentes de codificação criam uma lacuna de compreensão: você entrega código que não escreveu e não conseguiria depurar. O momento em que esse código está sendo gerado é o momento de ensino de maior alavancagem que existe — os conceitos são concretos, o código está na sua tela e suas mãos estão livres. Então o Eklavya pergunta sobre isso, uma vez por tarefa, nunca a mesma pergunta duas vezes, e cada vez mais difícil conforme você acerta. Tudo é local. Sem contas, sem sincronização, sem telemetria. ## Instalação Requer **Node 22+**. Nada mais, no macOS, Linux ou Windows. ```bash npm install -g eklavya && eklavya install ``` Isso fornece o plugin e o comando `eklavya`. Em seguida, execute `/eklavya:setup` dentro do Claude Code para escolher um modo. Você também pode instalar pelo marketplace de plugins dentro do Claude Code, com uma ressalva sobre o que um comando de barra pode fazer — ambas as rotas e a ressalva estão na documentação. Isso cobre o Claude Code em um terminal e a aba Code no Claude Desktop, que são o mesmo mecanismo na mesma configuração. **Cowork** também funciona e mantém sua própria lista de plugins, então instale lá também: Customize → Plugins → Add marketplace → `ProjectAJ14/eklavya`. Todos compartilham um único grafo de conhecimento. ## Como funciona Você pede algo. O Claude registra o que o trabalho toca, e essa chamada de registro aciona um checkpoint: **uma** pergunta de múltipla escolha sobre o conceito que acabou de registrar, feita enquanto o código ainda está na sua tela. Você responde em alguns segundos e o Claude continua direto. Quando a tarefa termina, no máximo mais uma pergunta — nunca uma pilha. O Nível 1 pergunta o que uma coisa é. O Nível 5 pergunta quando ela é a abordagem errada. Você sobe conforme acerta, que é como "nunca fazer a mesma pergunta duas vezes" sobrevive ao contato com um grafo de conceitos finito. A dificuldade é conquistada por projeto, então um código que você acabou de conhecer começa fácil, independentemente da sua senioridade. ## O manual A documentação cobre instalação, os quatro controles (`mode`, `focus`, `cadence`, `difficulty`), níveis e camadas, referência de comandos, configuração, a trava de commit, seus dados e solução de problemas. Para tutoria que roda *durante* a geração em um segundo painel — uma sessão ensinando enquanto a outra constrói, compartilhando um banco de dados — veja a documentação de tutoria paralela. ## Licença MIT