Technote

개발 워크플로우 심화

연재 개발자를 고용하기 전에 알아야 할 것 8부 중 8부

비개발자가 기술 부채의 신호를 알아채는 법

코드를 읽지 못해도 부채는 보입니다. 신호는 코드가 아니라 일정 · 대화 · 화면에서 먼저 나타납니다.

기술 부채는 “지금 빨리 가기 위해 나중의 비용을 빌려 쓰는 것” 입니다. 급할 때는 합리적인 선택이고 모든 프로젝트에 어느 정도 존재합니다. 문제는 빌린 것을 갚지 않고 계속 빌릴 때 생기고, 그 상태는 코드를 읽지 못해도 알아챌 수 있습니다. 신호가 코드보다 먼저 일정과 대화에 나타나기 때문입니다.

연재의 마지막 회차로, 운영을 시작한 창업가가 매달 한 번쯤 확인해 볼 목록을 정리합니다.

일정에서 나타나는 신호

가장 알아채기 쉬운 신호는 비슷한 크기의 일이 점점 오래 걸리는 것입니다. 처음에는 하루면 끝나던 페이지 추가가 사흘이 되고, 문구 하나 고치는 데 검토가 필요해집니다. 사람이 게을러진 것이 아니라, 건드릴 때마다 다른 곳을 확인해야 하는 구조가 됐다는 뜻입니다.

개념도 — 같은 작업에 드는 노력이 어떻게 늘어나는지를 설명하는 그림이며 측정치가 아니다

두 번째 신호는 수정이 다른 곳을 깨뜨리는 빈도입니다. A를 고쳤는데 B가 안 된다는 보고가 반복되면, 그 사이트는 변경에 취약한 상태입니다. 이때 필요한 것은 사람을 다그치는 것이 아니라 테스트 환경과 점검 절차입니다.

대화에서 나타나는 신호

말에서 드러나는 신호가 있습니다. “그건 건드리면 안 됩니다” 라는 말이 반복되면 주의해야 합니다. 왜 건드리면 안 되는지 설명할 수 있다면 괜찮지만, 이유를 아무도 모르는 채 관행으로 남은 금기는 부채의 전형적인 형태입니다. 그 부분을 만든 사람이 이미 떠났다는 뜻인 경우가 많습니다.

“업데이트하면 깨질 수 있어서 안 하고 있습니다” 도 같은 계열입니다. 이 말 자체는 정직하고, 실제로 그럴 수 있습니다. 다만 이것은 임시 상태여야 하고, 언제 어떻게 해소할 것인지가 함께 나와야 합니다. 그 계획이 없으면 시간이 지날수록 업데이트 격차가 벌어지고, 나중에는 한 번에 넘어야 하는 계단이 됩니다.

화면에서 확인할 수 있는 것

비개발자도 관리자 화면에서 직접 확인할 수 있는 항목이 있습니다. 매달 5분이면 충분합니다.

월 1회 5분 점검 — 코드를 몰라도 전부 확인 가능한 항목이다

이 중 더 이상 갱신되지 않는 플러그인이 가장 중요합니다. 플러그인 목록에서 마지막 업데이트가 오래된 항목은, 문제가 발견되어도 고쳐지지 않는 상태에 있습니다. 대체제를 찾거나 기능을 포기하는 판단이 필요하고, 그 판단을 미루는 것 자체가 부채입니다.

갚는 방법 — 한꺼번에 하지 않습니다

부채가 보인다고 전면 재작업을 결정하는 것은 대개 과한 처방입니다. 재작업은 그동안 쌓은 검색 순위와 콘텐츠와 익숙한 운영 방식을 함께 흔듭니다. 순서를 정해 갚는 편이 거의 항상 낫습니다.

부채를 갚는 순서 — 진단이 먼저이고 재작업은 마지막 선택지다

순서는 이렇습니다. 먼저 진단 — 지금 무엇이 어떤 상태인지 목록으로 만듭니다. 그다음 위험 순으로 정렬합니다. 보안에 직결되는 것이 먼저이고, 불편하지만 안전한 것은 뒤로 갑니다. 그리고 한 번에 하나씩, 각 작업의 전후를 기록하며 진행합니다. 기록이 있어야 다음에 같은 판단을 반복하지 않습니다.

연재를 마치며

여덟 회차 동안 요구사항 쓰는 법에서 시작해 견적 읽기, 소유권 정리, 인수 조건, 인수 목록, 유지보수 계약, 파트너 선택, 그리고 부채의 신호까지 왔습니다. 관통하는 원칙은 하나입니다 — 말로 합의한 것을 문서로 남기면 대부분의 문제가 사라진다. 기술을 몰라도 이 원칙은 쓸 수 있고, 사실 기술을 아는 쪽에서도 같은 원칙으로 일합니다.

그리고 이 연재의 점검표는 우리를 향해서도 그대로 적용됩니다. 이 사이트가 무엇을 하고 무엇을 하지 않는지는 최적화 지원 사업 페이지에 범위와 제외로 적혀 있고, 어떤 순서로 작업하고 무엇을 기록으로 남기는지는 작업 과정에 공개돼 있습니다. 먼저 지금 상태를 스스로 보고 싶다면 무료 도구의 진단 플러그인으로 시작하셔도 좋습니다.

이 주제의 다른 글

노하우 목록으로

개발 워크플로우 실무

워드프레스를 GitHub 에 올릴 때의 .gitignore

워드프레스 저장소에서 커밋해야 할 것과 절대 커밋하면 안 되는 것의 경계는 명확합니다. wp-config.php 한 파일이 저장소에 들어가는 순간 DB 비밀번호와 인증 솔트가 통째로 유출됩니다.

개발자 · 운영 · 관리자 5분 읽기

개발 워크플로우 실무

취향 논쟁을 규칙 확인으로 바꾸는 디자인 리뷰

"좀 답답해 보인다" 는 반박할 수 없고 고칠 수도 없습니다. 간격 척도 밖의 값, 팔레트 밖의 색, 기준 미달 대비, 빠진 상태 — 네 항목만 규칙으로 바꿔도 리뷰의…

디자이너 4분 읽기

₩270,000 · 신청하기