AI 코딩 도구가 같은 실수를 반복하지 않게 하는 ‘Scar’ 방식
Scar는 AI 코딩 도구가 과거에 실패했던 수정이나 건드리면 안 되는 코드를 다시 건드리지 않게 돕는 도구다. 코드 저장소 안에 ‘왜 이 코드는 이상해 보여도 그대로 둬야 하는지’, ‘어떤 라이브러리는 예전에 제거했는지’, ‘어떤 접근은 이미 실패했는지’ 같은 부정 지식을 남긴다. Claude Code 같은 AI 에이전트가 관련 파일을 수정하려는 순간, PreToolUse hooks를 통해 경고를 보여준다. 이렇게 하면 AI가 맥락을 모르고 일부러 만든 구조를 고치거나, 과거에 버린 라이브러리를 되살리거나, 이미 실패한 방법을 다시 시도할 가능성이 줄어든다. 핵심 목적은 AI가 현재 코드만 보는 것이 아니라, 그 코드가 왜 지금 모습이 되었는지도 함께 보게 만드는 것이다.
핵심 포인트
- Scar는 AI 에이전트가 과거 실수를 반복하지 않게 하려는 Git 기반 도구다.
- 부정 지식은 실패한 시도, 일부러 남긴 코드, 다시 쓰면 안 되는 라이브러리 같은 정보를 뜻한다.
- Claude Code가 관련 코드를 만지기 직전에 PreToolUse hooks로 경고를 받을 수 있다.
- 목표는 AI가 코드의 현재 상태뿐 아니라 과거의 결정 이유까지 참고하게 만드는 것이다.
- AI 코딩 도구를 자주 쓰는 개인 프로젝트에서 회귀와 시간 낭비를 줄이는 데 도움이 될 수 있다.
용어 한 줄 설명
- AI 코딩 도구
- 사람의 설명을 바탕으로 코드를 쓰거나 고치는 프로그램입니다.
- 코딩 도구
- 프로그래밍 작업을 더 쉽고 빠르게 할 수 있게 도와주는 소프트웨어입니다.
- 코드 저장소
- 프로젝트 코드를 저장하고 여러 기기에서 같은 내용을 받을 수 있게 해 주는 공간입니다.
- AI 에이전트
- 사람 대신 정보를 찾거나 작업을 처리하도록 만든 AI 프로그램입니다.
- PreToolUse hooks
- AI 도구가 어떤 작업을 실행하기 직전에 끼어들어 확인이나 경고를 넣는 장치입니다.
- 1인 개발자
- 회사에 소속되지 않고 혼자서 기획부터 제작까지 모든 과정을 책임지는 제작자.
- AI 작업 흐름
- 여러 AI 도구를 순서대로 연결해 작업하는 방식
- 작업 흐름
- 사용자가 어떤 일을 끝내기 위해 거치는 순서와 과정입니다.