도입
본 영상은 최신 AI 코딩 어시스턴트인 Claude Code를 활용하여 Ruby on Rails 8.1 애플리케이션인 'CreatorSignal'을 구축하는 과정을 실시간으로 보여줍니다. 개발자는 suspenders 젬을 사용하여 프로젝트를 부트스트래핑하고, Claude Code의 'Plan Mode'를 통해 복잡한 구현 계획을 수립합니다. 특히 외부 인증 젬(Devise 등)에 의존하지 않고 Rails 내장 기능을 활용하여 가벼운 인증 시스템을 구축하는 현대적인 개발 워크플로우를 제시하며, AI와 협업하여 고품질의 코드를 작성하는 방법을 중점적으로 다룹니다.
1. 프로젝트 초기화 및 Claude Code 설정
- 부트스트래핑:
suspenders 젬을 사용하여 Rails 8.1 및 Ruby 3.4 기반의 기본 구조를 생성했습니다.
- Claude Code 초기화:
slashinit 명령어를 통해 프로젝트 구조를 분석하고 claude.md 파일을 생성하여 AI가 프로젝트의 기술 스택(Linting, Testing, DB 등)을 이해하도록 설정했습니다.
- TDD 스킬 추가: AI가 테스트 주도 개발을 엄격히 따르도록 커스텀 스킬을 주입하여, 시스템 테스트부터 단위 테스트로 이어지는 ‘Outside-in’ 방식을 강제했습니다.
2. 인증 시스템 구현 (has_secure_password)
- Plan Mode 활용:
has_secure_password를 사용하는 상세 구현 계획을 수립하고, BCrypt 설정부터 마이그레이션 생성까지 단계별로 진행했습니다.
- Outside-in 테스트:
- 사용자 등록(Registration) 시스템 테스트를 먼저 작성하여 실패를 확인한 후 컨트롤러와 뷰를 구현했습니다.
shoulda-matchers를 활용하여 모델 유효성 검사(Email 정규화, 고유성 등)를 강화했습니다.
- 세션 관리:
SessionsController를 통해 로그인/로그아웃 로직을 구현하고, 보안을 위해 reset_session 패턴을 적용했습니다.
3. UI 및 사용성 개선
- Tailwind CSS 통합: Rails 8의 표준 방식에 따라 Tailwind CSS를 설치하고, 인증 관련 폼(로그인, 회원가입)과 플래시 메시지에 스타일을 적용했습니다.
- 인증 흐름 최적화: 로그인된 사용자가 로그인 페이지에 다시 접근할 수 없도록 리다이렉션 로직을 추가하고, 가상의 대시보드 페이지를 구축했습니다.
4. 고급 AI 협업 및 최적화 기법
- 서브 에이전트 코드 리뷰: 메인 에이전트 외에 별도의 서브 에이전트를 실행하여 코드 리뷰를 수행했습니다. 이를 통해 비밀번호 최소 길이 검증 누락과 같은 세밀한 보안 이슈를 발견하고 수정했습니다.
- Backdoor 패턴 구현: 시스템 테스트 속도를 높이기 위해 Thoughtbot의
clearance 젬 스타일의 백도어 미들웨어를 구현했습니다. 이는 폼을 직접 채우지 않고도 테스트 중에 빠르게 로그인 상태를 시뮬레이션할 수 있게 합니다.
- CI/CD 트러블슈팅: GitHub Actions에서 발생하는 데이터베이스 설정 오류와 마스터 키(Master Key) 관련 이슈를 Claude Code가 GitHub CLI를 활용해 직접 디버깅하고 해결했습니다.
결론
결론적으로, Claude Code는 단순한 코드 생성을 넘어 TDD 원칙 준수, 서브 에이전트를 이용한 코드 리뷰, 복잡한 CI/CD 트러블슈팅까지 수행할 수 있는 강력한 파트너임을 입증했습니다. 특히 'Claude.md'를 통한 프로젝트 컨텍스트 관리와 커스텀 'Skills'를 활용한 워크플로우 최적화는 AI 기반 개발의 생산성을 극대화합니다. 이러한 방식은 Rails의 '설정보다 관습(CoC)' 철학과 결합되어 개발자가 비즈니스 로직에 더 집중할 수 있는 환경을 제공하며, 향후 웹 개발의 표준적인 모습이 될 것임을 시사합니다.