프로젝트 소개

Eklavya는 Claude Code 플러그인으로, 에이전트 생성 시간을 학습 시간으로 전환합니다. Claude Code가 작업을 구현하는 동안 Eklavya는 해당 작업의 배후 개념을 가르칩니다 — 방금 작성한 diff에 기반한 적응형 소크라테스식 질문, 로컬 지식 그래프에서 숙달도 추적, 그리고 이해를 입증할 때까지 선택적 커밋 게이트를 제공합니다. 코딩 에이전트는 이해 격차를 만듭니다: 직접 작성하지 않아 디버깅할 수 없는 코드를 배포하게 됩니다. 코드가 생성되는 순간이 가장 효과적인 교육 기회입니다 — 개념이 구체적이고, 코드가 화면에 있으며, 손이 자유롭습니다. 그래서 Eklavya는 작업당 한 번, 같은 질문을 두 번 하지 않으며, 맞힐 때마다 더 어려운 질문을 합니다. 모든 것이 로컬에서 처리됩니다. 계정, 동기화, 원격 측정이 없습니다. ## 설치 **Node 22+**가 필요합니다. macOS, Linux, Windows에서 다른 것은 필요 없습니다. ```bash npm install -g eklavya && eklavya install ``` 이렇게 하면 플러그인과 `eklavya` 명령이 제공됩니다. 그런 다음 Claude Code에서 `/eklavya:setup`을 실행하여 모드를 선택하세요. Claude Code 내 플러그인 마켓플레이스에서도 설치할 수 있으며, 슬래시 명령이 허용되는 작업에 대한 한 가지 주의 사항이 있습니다 — 두 경로와 주의 사항은 문서에 있습니다. 이것은 터미널의 Claude Code와 Claude Desktop의 Code 탭을 다루며, 동일한 엔진과 동일한 구성입니다. **Cowork**도 작동하며 자체 플러그인 목록을 유지하므로 거기에도 설치하세요: Customize → Plugins → Add marketplace → `ProjectAJ14/eklavya`. 모두 하나의 지식 그래프를 공유합니다. ## 작동 방식 무언가를 요청합니다. Claude는 작업이 접촉하는 것을 기록하고, 이 기록 호출은 체크포인트를 트리거합니다: 방금 기록한 개념에 대한 **하나의** 객관식 질문이 코드가 여전히 화면에 있는 동안 제기됩니다. 몇 초 안에 답하면 Claude는 계속 진행합니다. 작업이 끝나면 최대 한 개의 질문이 더 추가됩니다 — 결코 여러 개가 아닙니다. 1단계는 무엇인지 묻습니다. 5단계는 언제 잘못된 접근인지 묻습니다. 맞힐 때마다 올라가며, 이것이 유한한 개념 그래프에서 "같은 질문을 두 번 하지 않는다"가 유지되는 방식입니다. 난이도는 프로젝트별로 획득되므로, 처음 접하는 코드베이스는 경력과 무관하게 쉽게 시작됩니다. ## 매뉴얼 문서는 설치, 네 가지 다이얼(`mode`, `focus`, `cadence`, `difficulty`), 레벨 및 단계, 명령 참조, 구성, 커밋 게이트, 데이터 및 문제 해결을 다룹니다. 생성 중 두 번째 창에서 튜터링을 실행하려면 — 한 세션은 가르치고 다른 세션은 빌드하며 하나의 데이터베이스를 공유 — 병렬 튜터링 문서를 참조하세요. ## 라이선스 MIT