AI 코딩 도구에 시간을 어디에 써야 할까

설정의 함정

엔지니어는 도구 최적화를 좋아한다. Claude Code 같은 AI 코딩 도구에서는 skills, hooks, 프롬프트 설정을 정교하게 만드는 문화가 퍼지고 있다. 생산적인 것 같지만 — 정말 그럴까?

질문은 “설정이 쓸모 있는가”가 아니다. 쓸모 있을 수 있다. 질문은 “그 시간을 설정에 쓰는 것과 무언가를 만드는 데 쓰는 것 중 어느 쪽의 수익이 더 큰가”이다.

Skills와 CLAUDE.md의 본질적인 차이

설정에는 두 가지 종류가 있다.

프로젝트의 사실과 규칙 (CLAUDE.md):

• 디렉토리 구조
• 커밋 메시지 규약
• 네이밍 패턴
• 팀 고유의 워크플로우

이것들은 “프로젝트에 대해 무엇이 사실인가”를 기술한다. 모델이 바뀌어도 업데이트가 필요 없고, 프로젝트 자체가 바뀔 때만 수정하면 된다.

모델의 동작을 제어하는 지시 (skills, hooks):

• 단계별 추론 가이드
• 출력 형식 강제
• 모델의 약점을 보완하는 우회 방법

이것들은 “모델을 어떻게 조종할 것인가”를 기술한다. 모델의 능력이나 특성이 바뀌면 깨진다.

Skills의 유통기한이 짧은 이유

수작업으로 만든 skills의 가치는 두 가지 힘에 의해 시간이 지나면서 감소한다.

1. 모델 진화로 재조정이 필요해진다

현재 모델에 맞춘 프롬프트는 다음 모델에서 불필요하거나 오히려 방해가 될 수 있다. 약점을 보완하는 우회 방법은 약점이 수정되면 죽은 코드가 된다. 유지보수 비용은 지속적이고 예측할 수 없다.

2. 플랫폼에 흡수된다

많은 사용자가 skills로 구현하는 패턴은 플랫폼 팀이 주목하고 제품에 내장하게 된다. jQuery → 네이티브 DOM API, webpack 플러그인 → 브라우저 표준과 같은 사이클이다. 커스텀 솔루션은 불필요해진다.

더 나은 판단 프레임워크

“AI 도구를 어떻게 설정해야 하는가” 대신 이렇게 물어보자:

1. 반복적으로 발생하는 마찰인가? 매주 부딪히는 문제라면 가벼운 해결책(프롬프트 템플릿, CLAUDE.md 규칙)은 투자할 가치가 있다.
2. 프로젝트의 사실인가, 모델의 우회책인가? 사실은 안정적이다. 우회책은 일시적이다. 투자의 무게를 다르게 두어야 한다.
3. 이 시간을 무언가를 만드는 데 쓰는 게 더 낫지 않은가? 설정에 쓰는 1시간은 아웃풋에 쓰지 못한 1시간이다. AI와 함께 무언가를 출시하는 경험 — 언제 맡기고, 언제 개입하고, 어떻게 개선할지의 판단력 — 이것이 도구와 모델이 바뀌어도 남는 힘이다.

진정으로 복리가 되는 것

장기적으로 AI 도구의 혜택을 가장 많이 받는 엔지니어는 가장 정교한 설정을 가진 사람이 아니다. AI를 써서 가장 많은 것을 출시한 사람이다. 왜냐하면 거기서 기르는 판단력은 도구, 모델, 플랫폼을 넘어서 통용되기 때문이다.

설정은 유지보수 비용. 아웃풋은 복리.