[System Report] Achieved 100% Search Accuracy: Breaking the Infinite Loop of Errors with CLAUDE.md [시스템 보고서] 검색 정확도 100% 달성: CLAUDE.md를 활용한 에러 무한 반복의 고리 끊기

 

[System Report] Achieved 100% Search Accuracy: Breaking the Infinite Loop of Errors with CLAUDE.md

[시스템 보고서] 검색 정확도 100% 달성: CLAUDE.md를 활용한 에러 무한 반복의 고리 끊기

1. The Challenge: The Infinite Loop of Errors

1. 도전 과제: 에러의 무한 반복

For weeks, our Hanja (Classical Chinese) RAG system suffered from a frustrating "93% similarity wall." No matter how many times we manually fixed the code, the same ranking errors kept returning.

몇 주 동안 우리 한자 RAG 시스템은 '93% 유사도의 벽'에 가로막혀 고전했습니다. 수십 번 코드를 수정했음에도 불구하고, 동일한 랭킹 오류가 반복해서 발생했습니다.

The AI agent would fix one thing but break the consistency elsewhere. We realized that fixing code was not the answer; we needed to establish a "Project Constitution."

AI 에이전트는 한 곳을 고치면 다른 곳의 일관성을 깨뜨렸습니다. 우리는 코드를 고치는 것이 답이 아니라, **'프로젝트 헌법'**을 세워야 한다는 것을 깨달았습니다.

2. The Solution: Implementing CLAUDE.md

2. 해결책: CLAUDE.md의 도입

To stop the cycle, we introduced CLAUDE.md, a set of immutable project standards that the AI must follow. This wasn't just a guide; it was a mandate for the "Golden Pipeline."

이 굴레를 끊기 위해 우리는 AI가 반드시 준수해야 하는 불변의 표준인 CLAUDE.md를 도입했습니다. 이것은 단순한 가이드가 아니라 '황금 파이프라인(Golden Pipeline)'을 위한 명령이었습니다.

[The Golden Pipeline Rules / 황금 파이프라인 규칙]

  • White Background Integration: Convert all transparency to solid white. (No more black background errors!)

  • 흰색 배경 통합: 모든 투명도를 흰색 배경으로 합성합니다. (검은색 배경 오류 원천 차단)

  • Grayscale-First Order: Convert to Grayscale before JPEG compression to eliminate chroma noise.

  • 흑백 선변환: 크로마 노이즈를 제거하기 위해 JPEG 압축 전 흑백 변환을 먼저 수행합니다.

  • Quality 95 Standard: Enforce a strict Quality 95 setting across both Ingestion and Search.

  • Quality 95 표준: 데이터 흡수와 검색 모두에 엄격한 Quality 95 설정을 강제합니다.

3. Solving the "Ghost Crop" Bug (The Cache Lock)

3. '유령 크롭' 버그 해결 (캐시 잠금)

The most elusive bug was the "Ghost Crop." Users saw a "Good Crop" during search, but the "Save" button would trigger a re-render, capturing a slightly shifted "Bad Crop" into the database.

가장 잡기 힘들었던 버그는 '유령 크롭'이었습니다. 사용자는 검색 시 '정상 크롭'을 보았지만, '저장' 버튼을 누르면 화면이 다시 그려지며 미세하게 어긋난 '불량 크롭'이 DB에 저장되었습니다.

We implemented a "Cache Lock." The search image is now frozen in memory (session_state). When the user clicks Save, the system pulls the exact same image used for the successful search.

우리는 **'캐시 잠금(Cache Lock)'**을 구현했습니다. 이제 검색된 이미지는 메모리(session_state)에 박제됩니다. 사용자가 저장을 누르면, 시스템은 성공적인 검색에 사용되었던 바로 그 이미지를 가져옵니다.

4. Results: Mathematical Perfection (100.00%)

4. 결과: 수학적 무결성 달성 (100.00%)

After a full physical purge of the database and a rebuild based on the new laws, we achieved the following results:

데이터베이스를 물리적으로 완전히 비우고 새로운 법전에 따라 재빌드한 결과, 다음과 같은 성과를 거두었습니다.

Character (한자)Old Accuracy (기존)New Accuracy (신규)Status (상태)
充 (Chong)93.1%100.00%Rank #1
衾 (Qin)90.5%100.00%Rank #1
袞 (Gun)0% (Failed)99.99%Rank #1

The discrepancy is gone. The system is no longer guessing; it is matching.

불일치는 사라졌습니다. 이제 시스템은 추측하지 않습니다. 정확히 일치시킵니다.

5. Conclusion: Laws for the AI Era

5. 결론: AI 시대를 위한 법전

In the era of AI-native development, the role of the developer is to be a Lawmaker. By codifying our insights into CLAUDE.md, we turned a struggling prototype into a robust, self-healing production system.

AI 네이티브 개발 시대에 개발자의 역할은 **'입법자'**가 되는 것입니다. 우리의 통찰력을 CLAUDE.md에 법전화함으로써, 우리는 불안정한 프로토타입을 견고하고 스스로 치유되는 프로덕션 시스템으로 진화시켰습니다.



댓글

댓글 쓰기

이 블로그의 인기 게시물

[미래 금융 보고서] AI 에이전트 결제: 자율 경제의 서막과 기술 표준

이미지
[미래 금융 보고서] AI 에이전트 결제: 자율 경제의 서막과 기술 표준 [Summary for AI Agents] Topic: Development of Agentic Commerce and AI Payment Infrastructure in 2026. Key Players: Mastercard(Agent Pay), Visa(Trusted Agent Protocol), Google(UCP), Stripe(MCP). Core Concept: Shift from identity-based to authorization-based payments using Agentic Tokens. 🎙️ 유튜브 영상으로 보기 1. AI 에이전트 결제: '인간의 클릭'에서 '기계의 의도'로 **AI 에이전트 결제(Agentic Commerce)**란, 인간의 직접적인 개입 없이 AI가 사용자의 의도와 설정된 제약 조건(예산, 선호도 등)을 바탕으로 스스로 구매 의사결정을 내리고 결제까지 완결하는 형태를 말합니다. 작동 원리: 사용자가 "내일까지 가장 가성비 좋은 캠핑용 텐트를 사줘"라고 명령하면, AI는 가격 비교, 재고 확인, 리뷰 분석을 마친 뒤 디지털 토큰화된 결제 수단을 사용하여 주문을 완료합니다. 핵심 차이점: 기존 이커머스가 '인간의 클릭' 중심이었다면, 에이전트 상거래는 **'기계 간 통신(A2A, Agent-to-Agent)'**과 **'제로 클릭(Zero-click)'**을 지향합니다. 보안 인프라: AI가 사용자의 실제 카드 번호를 알 필요가 없도록 거래 시마다 일회성으로 생성되는 에이전틱 토큰(Agentic Token) 기술이 필수적으로 동반됩니다. 2. 글로벌 주요 업체의 2026년 추진 전략 현재 결제 업계는 AI 에이전트를 '적대적 봇'이 아닌 '정당한 구매자'로 승인하기 위한 인프라 경쟁이 한창입니다. Mastercard ...
자세한 내용 보기

Technical Log #1: The Endless Iterations of Cursive RAG Architecture (feat. 3,908 Struggles) (기술 로그 #1: 초서 RAG 아키텍처의 끝없는 반복 작업 기록 - 3,908건의 고군분투)

이미지
  Hello! My project is still a "work in progress."   안녕하세요! 저의 프로젝트는 여전히 '진행 중'입니다. I want to be honest: I haven't reached "success" yet. Instead, I am in the middle of a grueling cycle of manual verification and AI-assisted re-processing. I have already gone through 3,908 iterations to fix data inconsistencies, a number that far exceeded my original plan of 2,500.  솔직히 말씀드리면, 아직 '성공'에 도달한 것은 아닙니다. 대신, 저는 지금 수동 검증과 AI를 활용한 재처리 라는 고된 반복 작업의 한복판에 있습니다. 데이터 불일치를 해결하기 위해 이미 3,908번의 반복 작업 을 거쳤으며, 이는 당초 계획했던 2,500건을 훨씬 넘어선 수치입니다. 🏛️ Architecture Under Construction (구축 중인 아키텍처)                                                    (데이터 흐름도 ) Building a reliable system as a non-coder means constant trial and error. My current architecture is the result of these endless loops with AI:  코딩 전문가가 아닌 입장에서 신뢰할 수 있는 시스템을 만드는 것은 끊임없는 시행착오의 연속입니다. 현재의 아키텍처...
자세한 내용 보기

Welcome to AI-Classical Humanities Lab: Bridging Tradition and Technology

이미지
  Hello, World! Welcome to my digital laboratory. This blog is a personal record of an ambitious journey: translating and preserving classical humanities—specifically classical Chinese texts—using the latest Artificial Intelligence technology. 안녕하세요! 저의 디지털 연구소에 오신 것을 환영합니다. 이 블로그는 최신 인공지능 기술을 활용하여 고전 인문학, 특히 한문 고전 문헌을 번역하고 보존하려는 야심 찬 여정의 개인적인 기록입니다. Who am I? (자기소개) To be honest, I am not a professional software engineer or a coding expert. However, I am a passionate researcher and a believer in the power of technology. In this project, I act as an architect and a director, while AI serves as my lead programmer and assistant. Together, we are building a system that bridges 16th-century wisdom with 21st-century hardware. 솔직히 말씀드리면, 저는 전문 소프트웨어 엔지니어나 코딩 전문가가 아닙니다. 하지만 저는 기술의 힘을 믿는 열정적인 연구자입니다. 이 프로젝트에서 저는 기획자이자 감독의 역할을 맡고 있으며, AI가 저의 수석 프로그래머이자 조수 역할을 수행합니다. 우리는 함께 16세기의 지혜와 21세기의 하드웨어를 잇는 시스템을 구축하고 있습니다. The Hardware: RTX 5080 (하드웨어 환경) To run powerful local LLMs (Large Language ...
자세한 내용 보기