Category AI

Claude가 “구현을 완료했습니다”라고 말해도 그게 맞다는 뜻은 아니다. 에이전트는 품질이 평범해도 자기 작업을 자신 있게 칭찬하는 경향이 있다. 그래서 좋은 구조는 책임을 잘게 나누고, 만든 것과 검증하는 것을 분리하며, 최종 결정권은 사람에게 남긴다. 앞 글에서 코어 루프와 Context·Permission·Tool 하네스를 다뤘다.…

문제를 받으면 “이렇게 구현하면 되겠다” 싶어 곧장 코드로 넘어가는 경우가 많다. 그런데 Claude Code가 강력한 이유는 모델이 똑똑해서가 아니다. 모델을 둘러싼 하네스(harness) 구조가 강력해서다. 같은 원리를 사람의 문제 설계에도 적용할 수 있다. 이 글은 Claude Code의 코어 루프와 하네스를 분해한…

Claude Code에게 “이 기능 구현해줘”라고 한 문장만 던지면 동작하는 코드는 나온다. 처음에는 그럴듯해 보이지만 엣지 케이스 한두 개만 추가해도, 유효하지 않은 입력이 한 번만 들어와도 쉽게 무너진다. CodeCraft 유형의 설계 문제는 코드를 치기 전에 다섯 단계로 먼저 분해해야 한다. 이…

Claude Code를 쓰다 보면 어느 순간 Claude가 이상하게 움직인다. 아까 하지 말라고 했던 파일을 건드리거나, 작업 범위를 스스로 넓히거나, 검증 없이 작업 완료를 선언한다. 모델이 나빠진 게 아니다. 컨텍스트가 무너진 것이다 이 글은 Claude Code의 Context Harness를 설계하는 세 가지…

Claude Code는 대화 도구가 아니다 Anthropic 공식 문서는 Claude Code를 “코드베이스를 읽고, 파일을 수정하고, 명령을 실행하고, 개발 도구와 통합하는 에이전틱 코딩 툴”로 정의한다. 핵심은 질문에 답하는 것이 아니라 작업을 이어서 수행하는 데 있다 백엔드 개발에서 Claude Code를 사용하면 워크플로우는 다음과…

Claude Code를 본격적으로 쓰기 시작하면 한 달 토큰 사용량을 보고 한 번쯤 놀란다. 똑같은 작업을 시켰는데 어떤 날은 컨텍스트가 가볍고 어떤 날은 무거워진다. 토큰이 어디서 새는지 모르면 절약 전략도 세울 수 없다는 결론에 도달한다. Anthropic 공식 마켓플레이스에는 이 문제를 정면으로…

같은 Claude 모델을 두고도 어느 날은 멀쩡한 패치를 만들어내고, 어느 날은 엉뚱한 파일을 고친 채 “완료했다”고 내미는 경험이 있을 것이다. 이 차이를 모델 탓으로 돌리기 쉽지만, 실제로는 모델이 일하는 환경, 곧 하네스(Harness)가 결과를 가른다. 모델이 똑같아도 컨텍스트가 흐리면 엉뚱한 파일을…

같은 모델에게 같은 작업을 시켰는데 결과가 완전히 다르게 나온 경험이 있을 것이다. 어떤 날은 멀쩡한 코드를 만들어내고, 어떤 날은 작동하지 않는 결과물을 자신 있게 내민다. 이 차이를 모델 탓으로 돌리기 쉽지만, 최근에는 다른 결론이 자리 잡고 있다. 모델이 아니라 모델이…

로드맵 + Shrimp Task Manager 워크플로우 AI에게 “쇼핑몰 만들어줘”, “인스타그램 같은 SNS 만들어줘” 한마디로 통째로 던져본 사람이라면 결과가 만족스럽지 않았을 것이다. 똑똑한 작업 관리 도구를 붙여도 마찬가지다. 큰 단위는 사람이 직접 로드맵으로 쪼개고, 세부 작업만 Shrimp Task Manager에 위임하는 분업이…

n개월 동안 견적서 발행 웹을 만들었다. 이메일 자동 발송, 다양한 템플릿, 클라이언트 댓글, 승인·거절, 결제 연동까지 모두 넣었다. 클라이언트에게 보여주자 한 마디가 돌아온다. “그냥 카카오톡으로 보내는 게 편한데요.” 스타트업이 실패하는 가장 큰 이유는 시장이 원하지 않는 제품을 만들었기 때문이다. Claude…