팀이 성장하면서 코드 품질을 어떻게 유지합니까?

Question

Accepted Answer

한 명의 신중한 사람이 머릿속에 담아둘 수 있는 품질은 성장하는 팀에서 살아남지 못합니다. headcount가 늘면 **영웅적 활약에서 시스템으로 전환**해야 합니다. 즉 당신이 모든 줄을 리뷰하지 않아도 기준을 지키는 자동화와 공유 표준입니다.

## 품질을 시스템에 내장하라

```text
✓ 지루한 검사를 AUTOMATE하라 — CI에서 linting, formatting, type check
✓ critical path에 TEST를 요구하라; 허영 숫자가 아니라 coverage 추세를 추적
✓ STANDARDS를 적어라 — style guide, architecture 문서
✓ code review를 명확한 기대치와 함께 규범으로 만들어라
✓ 템플릿/scaffolding을 써서 새 코드가 일관되게 시작하게 하라
✓ 문제를 일찍 잡아라 — pre-commit hook, CI gate
```

## 구체적인 예시

모든 PR에 "이거 포맷하세요"라고 직접 코멘트하는 대신, formatter와 linter를 CI에 추가하십시오. 이제 기계가 즉각, 일관되게, 감정 상함 없이 강제하고, 사람은 실제로 판단이 필요한 것을 리뷰합니다.

## 원칙

규율이나 기억에 의존하지 말고, **기본값과 자동화**에 의존하십시오. 올바른 방법을 쉬운 방법으로 만드십시오. 모든 엔지니어가 기억하는 것에 의존하는 것은 결국 규모에서 실패합니다.

## 트레이드오프

gate가 너무 많으면 팀이 옥죄임을 느끼고 우회합니다. 보정하십시오. critical path는 엄격하게, 저위험 코드는 가볍게. 표준은 엄격함을 과시하는 것이 아니라 속도를 가능하게 해야 합니다.

## 왜 중요한가

한 사람의 경계심에 의존하는 품질은 팀이 성장하거나 그 사람이 바쁜 순간 무너집니다.

시스템은 확장되고, 영웅적 활약은 그렇지 않습니다.

기준을 자동화하면 사람들은 기계가 리뷰할 수 없는 것, 즉 설계와 정확성에 집중할 수 있습니다.