26시간 AI 무료 강의 공개! 클로드 코드+하네스 엔지니어링 실전 완벽 가이드

AI가 똑똑하게 일하게 만드는 비법: 하네스 엔지니어링

AI 모델은 똑같은데 왜 어떤 날은 기가 막히게 일을 하고, 어떤 날은 엉뚱한 짓을 할까? 🤔

그건 모델 자체의 문제가 아니라 AI가 일하는 환경 때문이야. 마치 똑똑한 신입도 아무런 정보 없이 던져주면 헤매는 것처럼 말이지. AI도 마찬가지야. AI가 제대로 일하려면 하네스(Harness)라는 튼튼한 환경을 만들어줘야 해.

이번 강의에서는 이 하네스 엔지니어링에 대해 자세히 알아볼 거야.

왜 하네스 엔지니어링이 중요할까?

• 모델 성능보다 효과적: 모델을 바꾸는 것보다 환경을 개선하는 게 훨씬 더 큰 성능 향상을 가져올 수 있어. (무려 14% 이상!)
• 일관성 유지: 매번 똑같은 프롬프트를 써도 AI가 일관성 있게 좋은 결과를 내도록 도와줘.
• 통제권 확보: AI 모델은 우리가 만들 수 없지만, AI가 일하는 환경은 우리가 직접 만들고 개선할 수 있어.

하네스 엔지니어링, 어떻게 발전해왔을까?

1. 프롬프트 엔지니어링: "이렇게 말하면 AI가 더 잘 알아들어!" 처럼 AI에게 말을 잘 거는 방법이었지.
2. 컨텍스트 엔지니어링: 아무리 말을 잘 걸어도 AI가 상황을 이해 못 하면 소용없다는 걸 깨닫고, AI에게 필요한 정보(프로젝트 구조, 규칙 등)를 미리 알려주는 거야.
3. 하네스 엔지니어링: 이제는 맥락뿐만 아니라 AI가 스스로 일할 수 있는 전체적인 작업 환경을 설계하는 단계야.

하네스 엔지니어링, 뭘 만드는 걸까?

AI가 혼자서도 잘 일할 수 있는 작업 환경을 만드는 거야. 크게 네 가지를 포함해.

1. 맥락 (Context): AI가 알아야 할 정보들 (프로젝트 정보, 규칙 등)
2. 제한 (Constraints): AI가 하면 안 되는 것들 (예: 메인 브랜치에 함부로 푸시 금지)
3. 작업 흐름 (Workflow): 일을 어떤 순서로 할지, 계획-실행-검증 같은 루프를 만드는 것
4. 검증 (Validation): AI가 일을 잘 끝냈는지 확인하는 방법 (테스트 돌리기, 다른 AI가 리뷰하게 하기 등)

이 네 가지가 AI 모델을 둘러싸서 제대로 돌아가게 도와주는 거지. 마치 자동차의 엔진(모델)을 받쳐주는 차체(하네스)처럼 말이야.

하네스 엔지니어링, 어떻게 설계할까? (6가지 축)

하네스 엔지니어링은 크게 6가지 축으로 나눌 수 있어.

1. 구조 (Structure): 폴더 구성, 도구 배치 등 환경의 뼈대를 만드는 것
2. 맥락 (Context): AI에게 어떤 정보를 줄지 설계하는 것
3. 계획 (Planning): AI가 어떤 일을 해야 할지 계획을 세우는 것
4. 실행 (Execution): AI에게 일을 어떻게 시킬지 정하는 것 (어떤 AI를 쓸지 등)
5. 검증 (Validation): 결과물을 어떻게 테스트하고 믿을 수 있는지 확인하는 것
6. 개선 (Improvement): 만든 하네스를 계속해서 더 좋게 만드는 것

이 6가지 축은 서로 연결되어 있어서, 한 바퀴 돌 때마다 AI 환경이 점점 더 똑똑해지는 거야.

맥락 설계, 얼마나 많이 줄까?

맥락은 많이 주는 게 아니라, 필요한 것을 적재적소에 주는 것이 중요해. 너무 많은 정보는 오히려 AI를 헷갈리게 할 수 있거든.

• 설정 파일:

  • 유저 레벨: 나만의 습관이나 스타일 (모든 세션에 적용)
  • 프로젝트 레벨: 프로젝트의 기술 스택, 규칙, 제약 등 (팀과 공유)
  • 모듈 레벨: 특정 폴더나 기능에만 적용되는 규칙 (예: 데이터베이스 관련 규칙)
  • 규칙: 아래로 갈수록 범위가 좁고 우선순위가 높아. 즉, 아래 규칙이 위에 규칙과 충돌하면 아래 규칙이 이겨.
  • 주의: clouder.md 파일은 너무 길어지지 않게, 핵심만 담고 나머지는 rules 폴더에 따로 문서화해서 필요할 때 찾아 읽게 하는 게 좋아. (Progressive Discover)

• 대화 맥락 관리:

  • 대화창이 20~30%를 넘어가면 성능이 떨어지기 시작해.
  • 40% 이상 넘어가면 새로운 세션을 시작하거나 다른 세션으로 넘기는 걸 추천해.
  • clear나 compact 명령어보다는 그냥 새 세션을 시작하는 게 더 효과적일 때가 많아.
  • 핵심: 책상이 꽉 차면 안 되듯, AI의 대화 맥락도 주기적으로 비워주는 게 중요해.

다음 시간에는 계획, 실행, 검증, 개선에 대해 더 자세히 알아볼 거야! 😊