EricJujianZou/rederive

rederive는 힌트로 질문만 사용하여 코드베이스가 어떻게 작동하는지 스스로 처음부터 재설계하게 함으로써 가르치는 도구입니다. 코드를 직접 설명하지 않습니다. 스스로 설계를 재발견하도록 안내합니다.

기능

프로젝트에서 rederive를 실행하면 코드베이스가 대화형 퍼즐로 변합니다. 설명이나 문서를 읽는 대신 원래 개발자가 직면했던 것과 동일한 설계 문제를 해결하도록 요청받습니다. 해결책을 제안하면 rederive가 제약 조건으로 반박하고, 실제 설계에 도달할 때까지 답변을 다듬습니다. 아이디어는 누군가가 말한 것을 암기하는 것이 아니라 직접 도출했기 때문에 코드를 진정으로 이해한다는 것입니다.

작동 방식

1. "왜"에서 시작합니다. 자신의 프로젝트에서 실행하면 왜 만들었는지 묻습니다. 다른 사람의 프로젝트에서 실행하면 프로젝트가 해결하려고 했던 원래 문제를 파악하고 어떻게 해결할지 묻습니다.
2. 답변하는 동안 백그라운드 에이전트가 저장소를 연구합니다. 코드를 읽고, 파일이 서로 가져오는 방식을 추적하고, 설계가 변경된 커밋을 살펴봅니다. 커밋 메시지는 의도적으로 무시하므로 AI가 몇 개의 큰 커밋으로 만든 저장소도 잘 작동합니다.
3. 5~10개의 설계 문제 맵을 구축합니다. 시스템이 실제로 구축되는 순서대로 나열됩니다. 각 문제에는 제약 조건과 실제 해결책이 포함됩니다. 이 맵은 .rederive/map.md 파일에 저장되며, 답변이 포함되어 있으므로 완료할 때까지 들여다보지 말라는 지시를 받습니다.
4. 막히면 문제를 몇 가지 가능한 접근 방식으로 좁힙니다. 두 번 연속으로 잘못된 답변을 하면 문제를 스케치해 주겠다고 제안합니다.
5. 진행 상황 로그를 유지합니다. .rederive/log.md에 저장됩니다. 어디에서 어려움을 겪었고 무엇을 스스로 알아냈는지 기록됩니다. 마지막에 읽어서 무엇을 연습해야 할지 확인할 수 있습니다.

설치

터미널에서 다음 명령을 실행하세요.

npx skills add EricJujianZou/rederive

이렇게 하면 Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, opencode, Windsurf, Amp, Goose 및 약 15개의 다른 코딩 에이전트에 설치됩니다. -g를 추가하면 현재 프로젝트뿐만 아니라 모든 프로젝트에 설치됩니다. 설치 후 에이전트에서 /rederive를 입력하세요.

머신에 git, bash, python3가 필요합니다.

대체 설치 방법도 있습니다. Claude Code 플러그인으로 설치하거나, 저장소를 수동으로 클론하여 스킬 폴더를 에이전트의 스킬 디렉토리에 복사하는 방법입니다.

사용법

/rederive                                       # 현재 있는 저장소
/rederive ~/code/myapp                          # 로컬 저장소
/rederive https://github.com/expressjs/express  # 원격 저장소를 현재 폴더에 클론

평범한 말로 대화합니다. 막혔다고 말하거나, 문제를 건너뛰도록 요청하거나, 처음부터 다시 시작하고 싶다고 말할 수 있습니다.

개인정보 보호

모든 것이 사용자 머신에 유지됩니다. .rederive/ 폴더는 저장소의 로컬 git 제외 목록에 추가되므로 커밋에 나타나지 않습니다. rederive는 텔레메트리를 보내지 않습니다.

라이선스

MIT.

이 프로젝트는 "인간의 호기심을 회복하려는 좌절한 개발자의 시도"라고 자칭합니다.