시니어 개발자의 34일간 클로드 코드 프로젝트: 탄탄한 엔지니어링, 치명적인 시각적 사각지대

프로젝트 개요

35년 이상의 경력을 가진 시니어 기술 임원(VP Engineering, CIO, Head of Software Engineering 역할)이 34일 동안 Claude Code를 사용해 단독 프로젝트를 진행했습니다. 개발자는 제품 소유자, 아키텍트, 팀 리더 역할을 수행했으며 Claude가 모든 코드를 작성했습니다.

기술적 결과

프로젝트는 34일 동안 300개 이상의 커밋을 생성했습니다. Claude와 ChatGPT가 독립적으로 코드베이스를 검토한 결과:

• 깔끔한 아키텍처와 명확한 관심사 분리
• 좋은 테스트 커버리지(272개 테스트)
• "프로젝트 단계에 비해 예외적으로 철저한" 문서화
• "이상적인 것이 아니라 구현된" 아키텍처

프로젝트 관리 접근법

개발자는 AI 어시스턴트 관리를 위한 작업 규칙이 담긴 CLAUDE-md 파일을 생성했습니다:

• 코드를 먼저 읽지 않고 설명하지 않기
• 허락 없이 진행하지 않기
• 수정하기 전에 진단하기

이 관리 문서는 검토자들로부터 "본인이 본 최고의 AI 코딩 어시스턴트 관리 문서 중 하나"라고 평가받았습니다. Claude Code 관리는 "매우 빠르고 매우 문자 그대로인 주니어 개발자를 관리하는 것 같았다"고 합니다.

프로젝트: 문서 변환 파이프라인

프로젝트는 다섯 단계로 구성된 복잡한 문서 변환 파이프라인입니다:

1. 웹 페이지에서 콘텐츠 추출
2. 콘텐츠 정제
3. 구조화된 모델로 파싱
4. 접근성 있는 HTML로 렌더링

원래 개념은 개발자가 자신의 앱에 내장할 수 있는 CLI와 라이브러리였습니다.

중요한 놓친 기회

개발자는 Firefox의 Reader Mode 추출 엔진(Readability.js)에 대해 알고 있었지만 "이것도 사용할 수 있는 독립형 라이브러리일까?"라고 묻지 않았습니다. 대신 브라우저 기능으로만 보았습니다. 이 단 하나의 질문이 다음을 드러냈을 것입니다:

• 어려운 부분은 이미 해결되었음
• 진정한 가치(타이포그래피, 테마, 접근성 있는 출력)는 기존 엔진 위에 브라우저 확장 프로그램이 될 수 있음

개발자 자신의 엔지니어링 규칙인 "이미 해결책이 존재한다면 절대 만들지 말 것"에도 불구하고, 개발자나 Claude 모두 이 대안적 접근법을 제시하지 않았습니다.

사용자 인터페이스 전환

대상 사용자(부모, 교사, 학생)는 CLI나 파이프라인을 사용할 수 없었습니다. 개발자는 처음에 피드백을 위한 간단한 HTML 테스트 페이지를 시도했지만, 결국 완전한 웹 인터페이스를 구축했습니다:

• 8일 동안 100개 이상의 커밋
• 다섯 가지 테마
• 반응형 디자인
• 브랜딩 및 배포

이 인터페이스는 단순한 피드백 메커니즘이 아니라 제품 자체가 되었습니다.

테스트 인프라 확장

프로젝트는 광범위한 테스트 인프라를 개발했습니다:

• 16가지 품질 지표를 가진 평가 하네스
• 4,000개 이상의 웹 페이지에 대한 벤치마크
• 비교 파이프라인
• 스크리닝 도구

누적 효과는 "제품 코드 한 줄당 다섯 줄의 테스트 인프라"였습니다.

개발자 경험

개발자는 보고했습니다: "Claude Code와 작업하는 것은 다시 팀을 관리하는 것 같았습니다. 문제를 해결하기 위한 브레인스토밍, 아키텍처 결정 내리기, 빠른 속도로 모든 것이 이루어지는 것을 지켜보기. Justice League가 내 코드를 작성하는 것 같았습니다."

그러나 이것은 함정을 만들었습니다: "내가 올바른 길을 가고 있는지에 대한 불안한 의심이 들 때마다, 다른 인상적인 것을 만들어내며 그것을 밀어낼 수 있었습니다. 작업의 질이 계속 진행하기 위한 정당화가 되었습니다."

사용자 피드백은 34일 중 30일째에야 수집되었습니다.