Claude Code
문제
팀 개발에서 코드 컨벤션 준수, 테스트 실행, 반복 검증 같은 작업이 사람의 기억력에 의존하고 있었고, AI 도구를 써도 프로젝트 맥락을 매번 다시 설명해야 했습니다.
해결
CLAUDE.md에 프로젝트 규칙과 구조를 문서화해 세션마다 컨텍스트가 자동 주입되게 만들었습니다.
/test 같은 반복 작업은 skill로 정의해 명령 한 번으로 일관되게 실행되도록 했습니다.
계획 에이전트와 구현 에이전트를 분리해, 설계 검토를 거친 뒤에만 구현이 진행되는 워크플로를 만들었습니다.
post-edit-check 훅으로 편집 후 검증 스크립트가 강제로 실행되게 해, 검증을 잊는 실수 자체를 구조적으로 제거했습니다.
한계와 배운 점
하네스는 만들고 끝이 아니라 규칙이 실제로 지켜지는지 계속 관찰하며 다듬어야 했습니다. 규칙 문서가 코드와 어긋나는 순간 AI의 출력 품질이 함께 떨어졌습니다.