AI 코딩 어시스턴트를 위한 자기 진화 시스템 (no-no-debug)

AI 코딩 어시스턴트를 위한 자기 진화 (self-evolution) 시스템

v1.3.0 — 주기적 검토 (periodic review) 기능이 이제 실제로 작동합니다. 이전 버전들은 "3일마다 자동 트리거"를 약속했지만 강제 메커니즘이 없었습니다. 즉, 검토는 수동으로 호출할 때만 실행되었고, 트래커 (tracker)는 조용히 오래된 상태로 방치되었습니다. v1.3.0에는 hooks/review_reminder.py가 포함되어 있습니다.

이것은 매 메시지마다 트래커를 확인하고, 검토 시기가 지났을 때 AI에게 검토를 실행하도록 상기시키는 UserPromptSubmit 훅 (hook)입니다. v1.2.0에서 한 단계로 마이그레이션하는 방법은 CHANGELOG.md를 참조하세요.

10분 동안 코드를 작성하고, 2시간 동안 디버깅(debugging)을 합니다.

이 기술은 AI의 세션 간 오류 기억 (cross-session error memory)의 공백을 메워주며, 세 가지를 제공합니다:

• 디버깅 시간의 획기적인 단축
• 더 높은 코드 품질
• 자기 진화 피드백 루프 (self-evolution feedback loop)

사용 기간이 길어질수록, 실수가 반복되는 횟수는 줄어듭니다.

AI가 수정될 때, 코드 오류가 발생할 때, 배포 (deploy)가 실패할 때, 또는 테스트 (test)를 통과하지 못할 때 — 시스템은 타임스탬프와 함께 로컬 error_log.md에 자동으로 내용을 추가합니다. "그 내용을 기록해 둬"라고 말할 필요가 없습니다.

변경 전: 이것이 무엇에 영향을 미치는가? 변경 후: 실제로 검증했는가? 배포 전: 관리자 계정이 아닌 계정으로 테스트했는가?

조용히 실행됩니다. 모든 게이트 (gates)를 통과하면 아무런 출력도 나오지 않습니다.

error_log.md를 읽고, 차원별로 분류하며, error_tracker.md를 업데이트하고, 진화 보고서 (evolution report)를 출력합니다. 검토 빈도는 설정 가능합니다: 1일 / 3일 (기본값) / 7일.

새로운 오류 유형 → 방지 규칙 (prevention rule)을 자동으로 생성합니다. 반복되는 위반 → 카운터가 증가하며 규칙이 강화됩니다. 4회 연속 깨끗한 기간 유지 → 해결된 것으로 표시됩니다.

규칙은 세션 간에 유지됩니다 — 아무것도 유실되지 않습니다.

다음 상황에서는 진행하기 전에 사용자의 확인이 필요합니다:

• 새로운 기능 개발 (버그 수정이 아닌 경우)
• 데이터베이스 (database), 환경 (environment) 또는 배포 (deployment)와 관련된 변경
• 외부 플랫폼으로의 게시
• 작업 도중 사용자가 새로운 아이디어나 새로운 방향을 제시할 때

설치 시 Claude Code 훅 (hooks)을 자동으로 구성합니다:

• 명령 오류 (Command errors) → error_log.md에 자동 기록
• 파일 편집 후 → 검증을 위한 자동 리마인더 (auto-reminder)
• 사용자가 AI를 수정할 때 → 수정 내용 자동 기록
• 리뷰 지연 시 → 메커니즘 3 (Mechanism 3) 리뷰 시작을 위한 자동 리마인더

차원 (Dimension)	추적 항목
데이터 정확도 (Data Accuracy)	표시된 숫자/공식이 실제 코드와 일치하는가
...
기간 (Period)	오류 (Errors)
---	---
1주차 (Week 1)	29
...

claude skill add summerliuuu/no-no-debug

설정이 필요 없습니다 (Zero configuration). 추적 파일과 훅 (hooks)은 첫 실행 시 자동으로 초기화됩니다.

수동으로 설치하거나 v1.1.0에서 업그레이드하는 경우, 훅 스크립트도 복사하십시오:

mkdir -p ~/.claude/hooks
cp hooks/user_prompt_filter.py ~/.claude/hooks/
cp hooks/post_tool_failure.sh ~/.claude/hooks/
...

그 다음 SKILL.md의 PostToolUseFailure / UserPromptSubmit 블록을 ~/.claude/settings.json의 메커니즘 6 (Mechanism 6)으로 병합하십시오.

전제 조건 (Prerequisites). 제공되는 훅은 python3 (UserPromptSubmit 필터)와 jq (PostToolUseFailure 파서)를 사용합니다. 두 도구 모두 최신 macOS 및 대부분의 Linux 배포판에 기본적으로 포함되어 있습니다. 만약 둘 중 하나가 없다면 해당 훅은 기능이 저하된 상태로 부드럽게 작동합니다. python3가 없으면 수정 탐지기 (correction detector)가 조용히 아무 작업도 수행하지 않으며 (no-ops), jq가 없으면 로그에 일회성 jq_not_installed 마커를 작성합니다. 완전한 기능을 원한다면 macOS의 경우 brew install jq를 사용하거나 해당 패키지 관리자로 설치하십시오.

• SKILL.md의 내용을 복사합니다.
• 이를 시스템 프롬프트 (system prompt) 또는 사용자 지정 지침 (custom instructions)에 붙여넣습니다.
• 핵심 기능 (3단계 게이트 체크포인트, 정기 리뷰, 규칙 축적)이 즉시 작동합니다.
• 자동 훅 (Auto hooks)은 Claude Code 전용입니다. 다른 도구들은 AI가 SKILL.md의 규칙을 따르는 것에 의존합니다.

Claude Code — 자동 훅과 한 줄 설치로 완전한 경험 제공
기타 AI 코딩 어시스턴트 (ChatGPT, Cursor, Copilot 등) — 핵심 기능을 사용하려면 SKILL.md 내용을 시스템 프롬프트에 붙여넣으십시오

• 모든 프로젝트, 모든 언어 지원
• claude-mem (세션 검색용)과 함께 사용 시 효과적

설치 과정에서 이 프로젝트에 Star를 눌러주셔서 감사합니다.

📕 Xiaohongshu @Summer的AI日常 — 실전 AI 코딩

🇨🇳 중국어 버전

MIT — @summerliuuu