10년 차 소프트웨어 엔지니어의 경험담: Claude Code를 사용하여 코드를 읽지 않고 스마트폰으로 사이드 프로젝트를 '바이브

1. 플랜 모드(plan mode)로 시작하세요.

2. 계획(plan)을 읽으세요.

3. 다시 한번 말씀드리겠습니다: 계획을 읽으세요.

4. 계획을 가능한 한 많이 이해하세요. 계획의 일부가 불분명하거나 말이 되지 않는다면 질문하세요. Claude Code에서 저는 4. Tell Claude what to change 기능을 사용하여 "<section>이 무엇에 관한 것인가요? 무슨 뜻인가요?"라고 물어보는 것을 아주 자주 사용합니다. 여러분이 소프트웨어 엔지니어가 아니더라도, 모델이 무엇을 하고 있는지 더 많이 이해할수록 더 나은 결정을 내릴 수 있습니다. 코드를 전혀 보지 않더라도, 최대한 높은 수준(high level)에서 모든 것을 이해하려고 노력하세요.

5. 에이전트(agent)와 가능한 한 많이 주고받으세요. 플랜 모드(plan mode) 단계가 절대적으로 가장 중요합니다. 좋거나 나쁜 결정은 연쇄적으로 발생하며 증폭됩니다.

6. 만약 계획이 이해하기에 너무 방대하고 머릿속에 쉽게 들어오지 않는다면, 그것은 너무 큰 것입니다. 에이전트에게 계획을 더 작고 소화하기 쉬운 덩어리(chunks)로 나누어 달라고 요청하고, 이 단계들을 하나씩 차례대로 따르세요.

7. 계획이 완료된 후 모든 것을 git에 커밋(commit)하는 스킬(skill)이나 메모리(memory)를 만드세요. 로컬(local)이어도 상관없습니다. git이 무엇인가요? 그것은 본질적으로 특정 시점의 코드 상태를 저장하는 방법입니다. 이를 통해 무언가 고장 나더라도 과거로 돌아갈 수 있으므로 자신감을 가지고 앞으로 나아갈 수 있습니다. 참고: 이것은 데이터베이스 관련 작업과는 별개입니다. 오직 코드 자체에만 적용됩니다. 하지만 핵심 아이디어는 계획을 완료하면 코드의 상태를 저장한다는 것입니다. 만약 과거의 어느 시점으로 돌아가고 싶다면, 이제 매우 쉽게 할 수 있습니다. Claude나 에이전트에게 설정을 요청하세요, 후회하지 않을 것입니다.

8. 테스트(TESTS). 테스트란 무엇인가요? 테스트는 여러분의 코드가 의도한 대로 작동하는지 검증하는 데 도움을 주는, 여러분이 직접 작성하는 코드입니다.

예시: 두 숫자 a와 b를 더해서 결과를 반환하는 함수를 작성한다고 가정해 봅시다. 1과 2를 전달하면 3이 반환될 것으로 기대할 것입니다. 하지만 음수를 전달한다면 어떻게 될까요? 값을 전달하지 않는다면 어떻게 될까요? 여러분은 이 모든 것들을 검증하는 테스트를 작성할 수 있습니다.

테스트는 크게 두 가지 방식으로 도움을 줍니다:

- 특히 바이브 코딩 (vibe coding)을 하는 동안, 코드가 예상대로 작동하는지 확인하고 올바르게 완료되었다는 확신을 줍니다.

- 향후 변경 사항을 적용할 때 기존 기능이 망가지지 않도록 보장해 줍니다.

참고: 이것들이 완벽하거나 100% 신뢰할 수 있는 것은 아니지만, 반드시 갖춰야 할 요소입니다.

9. 에이전트가 계획 (plan) 단계에서 읽을 수 있는 테스트 케이스 (test cases)를 생성하도록 하세요. 테스트 코드 자체를 읽거나 이해할 필요는 없지만, 위의 예시를 활용한다면 다음과 같은 내용을 확인하는 것이 유용할 것입니다:

- 테스트 케이스:

- 두 개의 양의 정수를 확인하는지

- 음수 값을 전달했을 때를 확인하는지

- 아무 값도 전달하지 않았을 때를 확인하는지

10. 변경 사항이 복잡하다면, 다음 작업을 수행할 세 개의 하위 에이전트 (subagents)를 가동하세요:

- 계획 (plan)에 대한 비판적 검토

- 보안 검토 (security review)

- 테스트 감사 (testing audit)

11. 이 부분은 논란의 여지가 있지만, 초기에는 에이전트가 데이터베이스 (db)에 접근하기를 원할 수도 있습니다 (이는 본인의 책임하에 진행하세요). 항상 데이터베이스 백업을 수행하거나 예약된 백업을 설정하여, 만약 완전히 망가지는 상황이 발생하더라도 즉시 롤백 (roll back)할 수 있도록 하세요. 우리는 모두 운영 데이터베이스 (prod db)를 실수로 삭제하여 낭패를 보는 사람들의 게시물을 본 적이 있습니다. 그런 일이 발생한다면, 적어도 인터넷에서 약간의 관심을 얻을 수는 있지 않을까요?

12. 가장 멋진 부분: 오토 모드 (AUTO MODE) 가즈아! 사전 작업을 미리 해두었습니다. 이제 바이브 (vibes)를 타는 겁니다오오오오.

13. 에이전트에게 Chrome DevTools MCP (또는 선호하는 도구)에 대한 접근 권한을 부여하고, 코드가 라이브 (live) 상태가 되면 엔드 투 엔드 (end to end) 테스트도 수행하도록 하세요.

14. ???

15. 그리고 저처럼, 아무도 사용하지 않는 무언가를 만들 수도 있습니다.

제 사이드 프로젝트 중 하나를 보고 싶다면 제 프로필을 확인해 주세요. 그 외에는, 읽어주셔서 감사하며 즐거운 수요일 되세요!