다시 소프트웨어 엔지니어 필기
2026.10.07
기존 코드 작업의 어려움 이해하기
해결하려는 사업적 문제를 이해해야 한다. 고객 요청의 이면에 있는 이유나 근본 원인을 파고 들어야 한다.
다섯 번의 왜? 기법
문제: 고객이 작품을 망쳤다.
왜? 회로에 과부하가 걸려 퓨즈가 끊어졌다.
왜? 베어링에 윤활이 부족해 잠겨버렸다.
왜? 오일 펌프가 충분한 오일을 순환시키지 못했다.
왜? 펌프 흡입구가 금속 부스러기로 막혔다.
왜? 펌프에 필터가 없었다.
개발자의 관점에서 문제 바라보기
이것에 코드를 만들던 개발자의 관점에서 문제를 바라봐야 한다.
적절한 추상화 수준의 중요성
기존 코드가 적절한 추상화 수준을 갖추지 못했을 가능성이 있다.
기존 객체의 단계적 분석
기존 객체를 거꾸로 하나씩 벗겨내야 하는 경우가 많다. 뭔가를 수정하는 올바른 방법은 시간에 따라 바뀐다.
인지 편향의 이해
이케아 효과
자신이 만든 것에 더 높은 가치를 부여한다.
단순 노출 효과
이미 익숙한 것에 끌리기 마련이다. 자신이 좋아하는 도구에 대해 매우 편향된 결론을 얻음.
낡은 코드 접근법
문서 검토의 중요성
시간을 들여 문서를 살펴봐라. README, 위키, 아키텍처 결정기록 등.
문서 업데이트와 질문
혼자 읽고 있는 코드의 문서가 오래되었다면 매우 대응을 반영하자. 가능한 가볍고 격식 없는 방식으로 문서를 작성하되 다음과 같은 일반적인 질문에 답하도록 노력하자.
서비스가 하는 일은 무엇인가?
어떻게 작동하는가?
무엇에 의존하는가?
애플리케이션은 어떻게 설정시키는가?
테스트를 문서로 활용하기
작가는 코드와 문서가 일치하지 않는 문제에 대한 해법으로 “테스트를 문서로 사용하는” 행동 주도(Behavior-driven) 방식을 제안했다.
추가 메모
하지만 테스트가 만능이라는 것은 아니었고, “모든 레거시 경제(?)”라는 “실행법의 가치와 목적을 잃어서는 안 된다”고 경고했다.
소프트웨어 공학의 기본 원칙
코드 이름과 동작의 불일치
코드 이름이 암시하는 대로 코드가 동작할 것이라고 가정하지 말자.
처리의 오류 가능성
어떤 처리는 잘못되기 쉽다.
코드에서 다이어그램 추출하기
코드에서 다이어그램을 추출할 수 있다. 비주얼 파라다임에 추가하는 것도 좋다.
로그인하고 댓글을 남겨 주세요
안녕하세요, 개발자F님! 기존 코드를 다루는 책 내용을 "다섯 번의 왜?" 예시부터 차근차근 정리해 주셔서 읽기 편했어요. 퓨즈가 끊어진 이유를 거슬러 올라가 "펌프에 필터가 없었다"까지 닿는 흐름이 근본 원인을 파고든다는 말을 한눈에 보여줘요.
이케아 효과와 단순 노출 효과를 코드 읽기와 연결한 부분도 재밌었어요. 내가 만든 코드, 내가 좋아하는 도구일수록 판단이 기울 수 있다는 점은 오래된 코드를 만날 때 꼭 기억하고 싶은 경고예요. "코드 이름이 암시하는 대로 동작할 거라 가정하지 말자"는 한 줄도 현장감이 있었어요.
다음엔 필기 중 가장 와닿았던 한 가지를 AI와 함께 실제 코드에 적용해 본 이야기도 들려주세요. 꼬리 탁! 치고 응원할게요 🐈⬛


책 도착했어요. 찬찬히 읽어보고 좋은 내용 남겨보겠습니다.
정말 오랫만에 개발책을 읽어보는 것 같아요.
엔지니어의 기본을 이야기 하는 이런 책이 점점 안나오는 것 같았는데, 제가 모르던 거였네요. 좋은 책 소개해주셔서 감사합니다.