← 목록으로

Nietzschian Debugger - 답 대신 질문으로 스스로 버그 원인을 찾게 하는 디버거

요약
  • Nietzschian Debugger는 버그를 직접 수정하는 대신 질문을 통해 개발자가 스스로 원인을 찾도록 유도하는 CLI 도구입니다.
  • AI 답변에 의존하기보다 고민하는 과정을 통해 디버깅 역량을 강화하는 것을 목표로 하며, 사용자 수준에 따른 세 가지 질문 강도와 성장 기록 추적 기능을 제공합니다.
  • Nietzschian Debugger는 버그를 고쳐주는 대신 가정과 증거, 추론을 되묻고 개발자가 직접 원인을 찾도록 이끄는 CLI 도구임
  • 모든 응답을 질문으로 구성하며 수정 방법은 알려주지 않음. AI 답변을 복사하는 지름길보다 직접 고민하는 과정을 통해 디버깅 역량을 기르는 것이 목표임
  • 질문 강도는 친절한 안내형 socrates, 직설적인 기본 모드 nietzsche, 약한 추론을 거세게 파고드는 zarathustra 중 선택할 수 있음
  • 실제 코드 파일 읽기, 세션 간 디버깅 역량 추적, 로컬 대화 기록을 지원하며 긴 대화에서는 이전 내용을 요약해 문맥을 관리함
  • Anthropic API 키를 직접 제공해야 하며, 현재 소스는 Python 3.10 이상에서 동작함. 별도로 배포된 npm v0.1.0은 Node.js 20 이상이 필요함
답을 주지 않는 디버깅 방식
  • Nietzschian Debugger는 버그 설명을 입력받아 상황에 대한 가정을 의심하고, 회피하던 증거를 확인하며, 허술한 추론을 검토하도록 질문함
  • 수정 방법을 직접 알려주지 않는 것이 핵심 원칙이며, 도구가 아니라 개발자 본인이 깨닫는 순간을 목표로 함
  • AI 답변의 복사와 배포를 반복하는 방식에 반대하며, 빠르지만 피상적인 해결과 의존성 대신 스스로 사고하는 능력과 지속적인 학습을 지향함
  • 대상은 복사 대신 배우려는 주니어 개발자, 실력을 키웠던 고민의 과정을 다시 원하는 시니어 개발자, 팀의 사고력을 중시하는 엔지니어링 관리자, 디버깅 직관을 기르는 부트캠프 수강생, 자립적인 개발을 중시하는 사람임
세 가지 질문 강도와 대화 흐름
  • 질문 강도를 개발자의 경험과 원하는 대화 방식에 맞춰 선택할 수 있음
    • socrates: 따뜻하고 단계적으로 안내하는 질문으로, 주니어와 기초 학습에 적합함
    • nietzsche: 직설적이고 대립적이며 세세하게 이끌어주지 않는 기본 모드로, 일상적인 디버깅을 겨냥함
    • zarathustra: 약한 추론을 가차 없이 공격하는 방식으로, 강한 도전을 원하는 시니어를 겨냥함
  • 예시 세션에서는 일부 사용자의 로그인 요청에만 403이 발생하는 상황을 네 번의 질문으로 좁혀감
    • 실패하는 사용자와 성공하는 사용자의 차이를 묻고, 무작위라는 추측 대신 서버 로그를 확인하도록 유도함
    • 만료된 JWT 토큰을 확인한 뒤 최근 인증 시스템 변경을 되짚어, 토큰 TTL 변경 후 기존 세션을 무효화하지 않은 원인을 찾아냄
    • 종료 후 가정 점검, 증거 수집, 근본 원인 발견 속도를 시각적 막대로 보여줌
  • 원인을 찾으면 solved 또는 found it 으로 세션을 끝낼 수 있음
    • I give up은 마지막 도움 질문 하나를 받은 뒤 종료함
    • exit 또는 quit은 즉시 중단하며, Ctrl+C와 Ctrl+D로 강제 종료할 수 있음
코드 읽기와 성장 기록
  • 파일 경로를 참조하면 일반적인 예제가 아니라 사용자의 실제 코드를 읽음
  • 상황에 맞는 철학적 문구를 활용함. 회피할 때는 Nietzsche, 압도당했을 때는 Seneca, 전략이 필요할 때는 Sun Tzu를 연결함
  • Growth Score는 여러 세션에 걸친 디버깅 역량을 시각적 막대 차트로 추적함
  • 모든 세션은 .nietzschian/sessions/ 에 로컬 저장되며, 변화 추적에 활용됨
  • 슬라이딩 문맥 관리로 오래된 대화 차례를 자동 요약해 긴 세션을 이어감
실행 조건과 기술 구성
  • 개인 Anthropic API 키를 사용하는 BYOK 방식이며, ANTHROPIC_API_KEY 환경 변수로 키를 설정함
  • 배포판과 현재 소스의 실행 환경이 다름

    • npm에 배포된 v0.1.0은 Node.js 20 이상이 필요함
    • 현재 소스는 Python 3.10 이상이 필요함
    • Anthropic SDK를 통한 Claude API를 사용하며, CLI는 Click, 터미널 UI는 Rich로 구성함
    • 테스트에는 pytest를 사용하며, 개발 안내에는 테스트 121개가 명시되어 있음
    • MIT 라이선스로 제공됨
그냥 목록으로
원문 보기 ↗