개발환경뿐 아니라 협업환경도 찬찬히 조직해 간다

프로젝트 데이비드: 다시 개발을 시작하다

Apr 24. 2026

<페어 프로그래밍이 아니라 나를 지원하는 동료들로>에 이어 협업을 합니다.

표정 변화 없이 거짓말을 던지는 클로드에 적응하기

인용한 사진이 나름 그럴싸합니다. '표정 변화 없이' 거짓말을 하는 클로드를 조심해야 합니다. 이때는 둘과 함께 하는 상황이 유리합니다. 제가 직접 사실 확인을 하기 전에 둘에게 번갈아 물어볼 수 있거든요. 한편, '협업'이라고 생각하면 사람인 동료들도 종종 사실 확인이 안 되었거나 부정확한 이야기들을 합니다. 그래서, 일잘러라면 크로스 체크하는 요령들이 있죠.

개발 환경 구축 단계의 마지막 작업으로 Github Actions활용을 위해 원격 로그인 설정을 했습니다.

Secrets 등록을 하는 김에 보안 점검을 요청했더니 클로드 코드가 DBMS 관련 보안 조치를 수행했습니다.

클로드 코드가 작성한 코드를 Github에 저장하기

github 저장소에서 code 탭에 가 보니 코드가 올라와 있었습니다. 그리고, 긱뉴스로 알게 된 Entire를 바로 깔았었는데, 자동으로 연동이 되어 entire.io에 로그인하면 정보가 보인다는 사실도 확인했습니다. 어떤 목적으로 어떻게 쓸 수 있는지는 차차 알게 될 것이라 짐작하고 지금을 더 살펴보지 않습니다.

서버 배포 결과를 빌드하고 서버 실행 과정에서 누락된 작업을 보완했습니다. 그러고 나서 CLAUDE.md 파일 업데이트를 요청했습니다. 클로드 코드는 간략하게 진행된 내용을 요약해서 제시하고, CLAUDE.md을 98줄로 업데이트했습니다.

알 수 없는 미래를 열어 두고 의도적인 숨 고르기

개발 환경 구성 측면에서 클로드의 가이드에 따르고, 클로드 코드 운전(?)에 초점을 맞추다 보니 프로토콜이나 URL이 엉망(?)이었습니다. 그래서 URL 변경 작업과 인증서 설치 따위를 했는데, 빠르게 진행하는 대신에 일부러 속도를 늦추며 의미를 곱씹어 보기로 합니다.

이미 앞서도 의도적인 속도 조절을 한 일이 있지만 이번에는 다른 목표 설정을 하게 될지도 모른다는 생각이 들었습니다. 어쩌면 작년 9월 이후 포기했던 <리더십은 자기 자신을 불필요하게 만드는 방향으로 나간다>에 이어 <인공지능 시대의 소프트웨어 공학>에 대한 연구 결과가 나올 수도 있겠네요.[1]

도메인 낱말의 뜻을 깊고 넓게 묻고 따지기

URL 설정 현황을 점검하고 목표 구성을 떠올려 봅니다. 그 과정에서 먼저 제가 입에 붙은 말이 보편적인 표현이 아니었던 것을 깨닫고 해당 용어를 다시 살펴보기 위해 클로드에 질문을 던집니다.

REST를 열심히 적용하던 시절 입에 붙은 야매(?) 용어 'end-point'가 아니라 라우트나 경로라는 말이 적절했습니다. 그런데 두 용어는 정확히 같은 것일까요?

관계를 보아야 바탕이 드러나고 의미가 명확해진다

여기서 또 제 취향을 가미해 UML 도식화를 요구했습니다. 유관 개념의 관계를 함께 보면 의미가 더 명확해지기도 하니까요.

그리기를 잘했습니다. 아니, 그려 보라고 지시하길 잘했습니다. 도메인은 정(main)-부(sub) 이분법을 속성으로 합니다. 반면에 경로는 조각(segments)들로 이뤄진 문자열 배열일 뿐이었습니다. 그에 반에 라우트는 해당 경로(path)에 매핑된 패턴과 핸들러를 의미했습니다. 표면적으로 드러나는 상징(문자열)이 같거나 비슷할 뿐 의미는 전혀 다르다고 할 수도 있습니다.[2]