코딩 에이전트가 더 나은 코드를 작성하게 하려면 어떻게 해야 할까요?

가장 먼저 추천하는 건 훅(hook)을 설정하는 겁니다. 훅은 AI 모델의 결과물이 특정 요구사항을 충족하지 못할 때, 예를 들어 테스트를 통과하지 못하거나 새 파일을 만들 때 규칙을 따르지 않으면 출력을 차단할 수 있죠. 제 메인 설정은 파일당 350줄 제한을 엄격히 적용하고, 모델이 처음부터 깔끔한 코드를 계획하도록 요구합니다. 목표는 나중에 지저분한 코드를 수정하는 게 아니라, 애초에 제대로 작성되게 만드는 거죠. 여기에는 app.js 같은 일반적인 보일러플레이트 대신 명확하고 구체적인 파일 이름을 문서화하는 것도 포함됩니다. 일반적인 이름을 피하면 AI가 나중에 필요한 것을 찾기가 훨씬 쉬워지고, 코드베이스 전체가 더 깔끔하게 유지됩니다.

또한 AI가 새로운 코드를 작성하기 전에 기존 코드를 확인하도록 설정해 뒀습니다. 비슷한 기능을 하는 로직이 이미 있다면, 모델은 중복해서 만드는 대신 단일 공유 파일로 리팩터링하거나 기존 코드를 업데이트해야 합니다.

공유 라이브러리를 갖추는 것도 똑같이 중요합니다. AI가 매번 똑같은 로직이나 스타일을 처음부터 다시 쓰게 하고 싶지는 않을 테니까요. UI 디자인의 경우 보통 프로젝트 전체에서 일관된 모습을 원하기 때문에, 전용 UI 및 코드 라이브러리를 만드는 것이 할 수 있는 가장 좋은 일 중 하나입니다. 예를 들어, AI가 헥스 코드, 컨테이너 스타일, 폰트 규칙을 모든 컴포넌트에 하드코딩하게 두는 대신, 저는 훅을 사용해 원시 값을 차단하고 theme.css나 constants.js 같은 중앙 참조 파일에서 가져오도록 강제합니다.

저는 CLAUDE.md에만 전적으로 의존하는 것은 피하는 편입니다. 유용하고 모델을 안내하는 데 도움이 되긴 하지만, 전역 훅 설정이 훨씬 더 신뢰할 수 있습니다. 긴 마크다운 파일 속에 숨겨진 규칙을 모델이 놓치지 않길 바라는 대신, 훅은 실수가 발생하는 것을 적극적으로 차단합니다. 컨텍스트도 절약되죠. Claude가 매번 방대한 지침 파일을 읽게 하는 대신, 훅은 모델이 실수할 때만 개입해서 수정합니다. 예를 들어, 대시(em-dash) 사용을 차단하는 훅이 있는데 모델이 그걸 쓰려고 하면, 훅이 출력을 거부하고 모델에게 규칙을 상기시킵니다. 그 시점부터 세션 내내 모델은 그걸 쓰지 말아야 한다는 걸 알게 되죠.

다른 분들은 이 부분에 대해 어떻게 생각하시는지 궁금합니다. 저는 항상 모델의 결과물을 개선할 새로운 방법을 찾고 있거든요.

현재 제 주된 목표는 모델을 극도로 자율적으로 만들어서, 제가 원하는 앱에 대해 논의하고 몇 시간 뒤에 돌아왔을 때, 엣지 케이스나 문제 없이 완전히 깔끔한 코드로 완성되어 있게 하는 겁니다. 덜 관리하면서도 혜택은 그대로 누리는 게 목표죠.

이미 잘 개발된 프로젝트에 이런 설정을 적용하려면 Claude에게 보낼 수 있는 프롬프트가 따로 있을까요?

상상에 맡기는 부분이 너무 많네...

claude.md 파일 크기가 얼마나 됨? 어떤 소스를 골랐는데? 보니까 깃허브에 작년 기여도가 0이던데, 코딩은 하긴 함?

트위터 링크도 Claude한테 시키면 쉽게 만들 수 있었을 사이트 대신 미디엄 도메인으로 연결해 놨네. 특히나 Claude가 "거의 항상 더 나은 코드"를 짠다면서 말이야.

트위터 팔로워 많은 건 인정하지만, 코딩 조언으로 얘 추천은 안 들을래.

AI는 내 엉망진창 코딩 스타일도 기꺼이 받아줘서, 얘가 생성한 코드를 이해하는 데는 문제없음. 근데 확실히 Opus 5.5 같은 애들이 나보다 코딩 잘함.

난 코더는 아니지만, 상업용 권리 분석 보고서 검토 스킬을 개발할 때 비슷한 방식을 썼음. Claude는 주거용 보고서에 더 익숙해서 표준 학습 데이터에 나쁜 습관이 많이 배어 있었거든.

내 전략은 Claude한테 내가 종사하는 통신탑 건설 사업과 관련된 상업용 권리 분석 보고서 검토 과정을 가르쳐달라고 한 거였음. Claude한테 내가 보고서 검토 스킬을 만드는 중이니까 그 스킬에 도움 될 만한 정보를 다 기록하라고 했지. 과정이 끝날 때쯤엔 중요한 내용을 다 요약해 놨더라고.

이건 스킬을 구축한 방법 중 하나일 뿐임. 출력 형태를 위한 템플릿이랑 상위 수준 설계 문서(High Level Design Document)도 만들었음. 이 세 가지가 준비되고 나서야 비로소 스킬을 구축했지.