https://www.chiark.greenend.org.uk/~sgtatham/quasiblog/code-review-antipatt

์ฝ”๋“œ๋ฆฌ๋ทฐ๋Š” ๋ฆฌ๋ทฐ์–ด์™€ ๊ฐœ๋ฐœ์ž ๋ชจ๋‘ ๋„์›€์ด ๋˜๋Š” ์ธก๋ฉด์ด ์žˆ๋‹ค. ํ•˜์ง€๋งŒ ๋ฆฌ๋ทฐ์–ด๊ฐ€ ์ž˜๋ชปํ•˜๋ฉด ์ฝ”๋“œ ๊ฐœ์„ ์— ๋งค์šฐ ํฐ ์žฅ์• ๋ฌผ์ด ๋  ์ˆ˜๋„ ์žˆ๋‹ค. ๊ฐœ๋ฐœ์ž๋ฅผ ์งœ์ฆ๋‚˜๊ฒŒํ•˜๊ณ  ๊ฐœ์„ ์„ ํฌ๊ธฐํ•˜๊ฒŒ ํ• ์ˆ˜๋„ ์žˆ๋Š” ๊ฒƒ์ด๋‹ค.

์—ฌ๊ธฐ์„œ๋Š” ์ด๋ฅผ ์˜ˆ๋ฐฉํ•˜๊ธฐ ์œ„ํ•ด ์ฝ”๋“œ๋ฆฌ๋ทฐ ์•ˆํ‹ฐํŒจํ„ด์„ ๋ฐ˜์–ด์ ์œผ๋กœ ์†Œ๊ฐœํ•œ๋‹ค

The Death of a Thousand Round Trips

๋ฌธ์ œ์ ์„ ๋ฐœ๊ฒฌํ•˜์ž๋งˆ์ž ์ฝ”๋ฉ˜ํŠธ๋ฅผ ๋‹ฌ๊ณ  ์ฝ”๋“œ๋ฅผ ๊ทธ๋งŒ ์ฝ์Œ โ†’ ๊ฐœ๋ฐœ์ž๋Š” ์ด๋ฅผ ์ˆ˜์ •ํ•จ โ†’ ์ˆ˜์ •๋ณธ์„ ์ฝ๊ณ  ๋‹ค์‹œ ๋ฌธ์ œ์ (์ฒซ๋ฒˆ์งธ ๋ฌธ์ œ์™€๋Š” ๋…๋ฆฝ์ ์ธ ๋ถ€๋ถ„์—์„œ)์„ ๋ฐœ๊ฒฌํ•จ. โ†’ ๋‹ค์‹œ ์ฝ”๋ฉ˜ํŠธ๋ฅผ ๋‹ฌ๊ณ  ์ฝ”๋“œ๋ฅผ ๊ทธ๋งŒ์ฝ์Œ

๋‘๋ฒˆ์งธ ๋ฌธ์ œ์ ์€ ์ฒ˜์Œ์— ๋ฐœ๊ฒฌํ•  ์ˆ˜ ์žˆ์—ˆ์ง€๋งŒ, ์ฝ”๋“œ๋ฅผ ๋๊นŒ์ง€ ์ฝ์ง€ ์•Š์•˜๊ธฐ์— ๋‚˜๋ˆ ์„œ ์ฝ”๋ฉ˜ํŠธ๊ฐ€ ๋‚˜๊ฐ€๊ฒŒ ๋˜์—ˆ๋‹ค. ์ด๋ ‡๊ฒŒ ๋˜๋ฉด ๊ฐœ๋ฐœ์ž๋Š” ์ˆ˜์ •์„ ํ•˜๊ธฐ๊ฐ€ ์ ์  ๊ท€์ฐฎ์•„์ง€๋ฉฐ ์ˆ˜์ •์ด ๋ฐ˜๋ณต๋˜๋‹ˆ ๋ฐฐํฌ ์‹œ๊ธฐ๋„ ๋Šฆ์ถฐ์ง„๋‹ค

๋ฌธ์ œ์ ์„ ์•Œ๋ฆด๋• ์ฝ”๋“œ๋ฅผ ๋๊นŒ์ง€ ์ฝ๊ณ  ์—ฌ๋Ÿฌ ๋ฌธ์ œ์ ์„ ํ•œ๋ฒˆ์— ๋งํ•˜๋ผ

The Ransom Note

The Double Team

ํ•œ ํŒจ์น˜์— ๋‘๋ช… ์ด์ƒ์˜ ๋ฆฌ๋ทฐ์–ด๊ฐ€ ๋ถ™์€ ๊ฒฝ์šฐ๋‹ค

ํ•œ ๋ฆฌ๋ทฐ์–ด๊ฐ€ ์ฝ”๋ฉ˜ํŠธ๋ฅผ ๋‚จ๊ธฐ๊ณ , ๊ฐœ๋ฐœ์ž๊ฐ€ ์ˆ˜์ •ํ•˜๊ณ , ๋‹ค์‹œ ๋‹ค๋ฅธ ๋ฆฌ๋ทฐ์–ด๋Š” ๊ฑฐ๊ธฐ์— ๋ฐ˜๋Œ€ํ•  ์ˆ˜ ์žˆ๋‹ค. ์ด๋•Œ ๋ฆฌ๋ทฐ์–ด๋ผ๋ฆฌ ์–˜๊ธฐ๋ฅผ ์•ˆํ•˜๊ณ  ๊ฐœ๋ฐœ์ž์—๊ฒŒ๋งŒ ๊ฐ์ž ์›ํ•˜๋Š” ๋ฐ”๋ฅผ ์–˜๊ธฐํ•˜๋ฉด ๊ฐœ๋ฐœ์ž๋Š” ์ˆ˜์ •์„ ํฌ๊ธฐํ•  ๊ฒƒ์ด๋‹ค.

๊ฐœ๋ฐœ์ž์—๊ฒŒ๋Š” ํ†ต์ผ๋œ, ์ผ๊ด€๋œ ์˜๊ฒฌ์„ ์ „๋‹ฌํ•˜๋ผ

The Guessing Game

์–ด๋–ค ๋ฌธ์ œ๊ฐ€ ์žˆ๊ณ  ์—ฌ๋Ÿฌ ํ•ด๊ฒฐ์ฑ…์ด ์žˆ์„ ๋•Œ, ๊ฐœ๋ฐœ์ž๊ฐ€ ์–ด๋–ค ํ•œ ํ•ด๊ฒฐ์ฑ…์„ ๊ณจ๋ž๋‹ค๊ณ  ํ•ด๋ณด์ž

์ด๋•Œ ํ•ด๋‹น ๋ฌธ์ œ์™€ ๊ด€๋ จ์—†๋Š” ๋ช‡๊ฐ€์ง€ ๊ทผ๊ฑฐ๋กœ ๊ทธ ํ•ด๊ฒฐ์ฑ…์„ ๋น„ํŒํ•ด๋ณด์ž. ์ด๋•Œ ๋น„ํŒ๋„ ์ถ”์ƒ์ ์ด๊ณ  ๋ชจํ˜ธํ•ด์•ผํ•œ๋‹ค. (๋””์ž์ธํŒจํ„ด, ๋ฏธ๋ž˜ ๊ธฐ์ˆ ๊ณผ์˜ ํ˜ธํ™˜์„ฑ ๋“ฑ). ๊ทธ๋Ÿผ ๊ฐœ๋ฐœ์ž๋Š” ๊ทธ ํ•ด๊ฒฐ์ฑ…์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์—†๊ณ  ์™„์ „ํžˆ ๋‹ค๋ฅธ ํ•ด๊ฒฐ์ฑ…์„ ๊ฐ€์ ธ์˜ฌ ๊ฒƒ์ด๋‹ค. ๊ทธ๊ฒƒ๋„ ๋น„ํŒํ•˜๋ผ.

๊ฐœ๋ฐœ์ž๊ฐ€ ์ทจํ•œ ๋ฐฉ๋ฒ•์— ๋ฌธ์ œ๊ฐ€ ์žˆ๋‹ค๋ฉด ๋ช…ํ™•ํ•œ ํ•ด๊ฒฐ์ฑ…์ด๋‚˜ ๊ทผ๊ฑฐ๋ฅผ ์ œ์‹œํ•˜๋ผ

The Priority Inversion

์ž‘์€ ๋ฌธ์ œ์ ์„ ๋จผ์ € ์ง€์  โ†’ ๊ฐœ๋ฐœ์ž๊ฐ€ ์ˆ˜์ • โ†’ ์ดํ›„ ํฐ ๋ฌธ์ œ๋ฅผ ์ง€์ ํ•˜์—ฌ ๊ฐœ๋ฐœ์ž๊ฐ€ ์ˆ˜์ •ํ•œ ์˜์—ญ์„ ํ†ต์งธ๋กœ ๋‹ค์‹œ ์ž‘์„ฑํ•˜๊ฒŒ ๋งŒ๋“ฆ

ํฐ ๋ฌธ์ œ๋ฅผ ๋จผ์ € ์ง€์ ํ•˜๋ผ

The Late-Breaking Design Review

ํฐ ์ž‘์—…์ด ์—ฌ๋Ÿฌ ํŒจ์น˜๋กœ ๋‚˜๋ˆ„์–ด ์ž‘์—…๋˜๊ณ  ์žˆ๊ณ  ์ ˆ๋ฐ˜์ •๋„๊ฐ€ ์™„๋ฃŒ๋˜์—ˆ์„๋•Œ, ์ „์ฒด์ ์ธ ๋””์ž์ธ์„ ๋น„ํŒํ•˜๋ผ. ์ด๊ฒƒ์€ ์ฒ˜์Œ ์˜๊ฒฌ์— ํฌํ•จ๋˜์ง€ ์•Š์•˜๋˜ ๊ฒƒ์ด์–ด์•ผํ•œ๋‹ค.

์ž‘์—… ๋„์ค‘ ์ž‘์ง€๋งŒ ์ค‘์š”ํ•œ ์ž‘์—…(๋ฒ„๊ทธํ”ฝ์Šค ๋“ฑ)์ด ์žˆ์„๋•Œ๊ฐ€ ์ข‹์€ ๊ธฐํšŒ์ด๋‹ค. ์ „์ฒด์ ์ธ ๋””์ž์ธ์„ ๋น„ํŒํ•˜๋ผ. ๊ทธ๋Ÿผ ๊ฐœ๋ฐœ์ž๋Š” ๋ญ˜ ๊ณ ์ณ์•ผํ• ์ง€ ๋ชจ๋ฅด๋Š” ์ƒํ™ฉ์ด ๋ฐœ์ƒํ•œ๋‹ค.

์ฒ˜์Œ์— ๊ฒฐ์ •ํ•œ ๋””์ž์ธ ํŒจํ„ด์„ ์ค€์ˆ˜ํ•˜์—ฌ ๋ฆฌ๋ทฐํ•˜๋ผ. ์ „์ฒด์ ์œผ๋กœ ๋ฐ”๋€Œ์–ด์•ผํ•œ๋‹ค๋ฉด ์ „์ฒด ๊ฐœ๋ฐœ์ž์™€ ํ•จ๊ป˜ ํ† ๋ก ํ•˜์—ฌ ์ •ํ•˜๋ผ

The Catch-22

ํฐ ํŒจ์น˜๊ฐ€ ์žˆ์„๋•Œ ์•Œ์•„๋ณด๊ธฐ ํž˜๋“œ๋‹ˆ ์ž‘๊ฒŒ ๋‚˜๋ˆ ๋‹ฌ๋ผ๊ณ  ์š”๊ตฌํ•˜๋ผ. ๊ทธ๋Ÿฐ๋ฐ ๋งŒ์•ฝ ์ž‘์€ ํŒจ์น˜๊ฐ€ ์—ฌ๋Ÿฌ๊ฐœ ์žˆ์œผ๋ฉด ํ•˜๋‚˜ํ•˜๋‚˜๋Š” ์˜๋ฏธ๊ฐ€ ์—†์œผ๋‹ˆ ํฌ๊ฒŒ ํ•˜๋‚˜๋กœ ๋ฌถ์–ด๋‹ฌ๋ผ๊ณ  ํ•˜๋ผ.

์ด๋Ÿฐ ๊ฒƒ์ฒ˜๋Ÿผ trade-off ๊ด€๊ณ„์˜ ๊ฒƒ์„ ์ง€์ ํ•˜๋ผ (ex : ๊ฐ€๋…์„ฑ์ด ์ข‹๋‹ค๋ฉด ์„ฑ๋Šฅ์„ ์ง€์ , ์„ฑ๋Šฅ์ด ์ข‹๋‹ค๋ฉด ๊ฐ€๋…์„ฑ์„ ์ง€์ )

trade-off ๊ด€๊ณ„์˜ ๊ฒƒ์„ ์ง€์ ํ• ๋•Œ๋Š” ์กฐ์‹ฌํ•˜๋ผ

The Flip Flop

๊ฐ™์€ ๋ถ€๋ถ„์„ ๋งŽ์€ ์‚ฌ๋žŒ์ด ์ˆ˜์ •ํ•˜๋Š” ๊ฒฝ์šฐ๊ฐ€ ์žˆ๋‹ค. (๋ฆฌ์ŠคํŠธ ๋“ฑ). ๊ฐœ๋ฐœ์ž๊ฐ€ ์ด์ „ ๊ด€์Šต์„ ์ค€์ˆ˜ํ•˜์—ฌ ์ˆ˜์ •์„ ํ•˜์˜€๊ณ , ์ด์ œ๊นŒ์ง€ ๊ทธ๋Ÿฌํ•œ ๊ด€์Šต์€ Approve ๋˜์—ˆ๋‹ค. ๊ทธ๋Ÿฐ๋ฐ ๊ฐ‘์ž๊ธฐ ์ด์ „์— ๋ฌธ์ œ ์‚ผ์ง€ ์•Š์•˜๋˜ ๋ถ€๋ถ„์„ ๋ฌธ์ œ์‚ผ์•„๋ผ.

๋งŒ์•ฝ ๊ฐœ๋ฐœ์ž๊ฐ€ ์ด์ œ๊นŒ์ง€์™€์˜ ๋ถˆ์ผ์น˜๋ฅผ ์ง€์ ํ•œ๋‹ค๋ฉด, ์ด์ œ๊นŒ์ง€์˜ ์ฝ”๋“œ๋„ ์ˆ˜์ •ํ•ด์•ผํ•œ๋‹ค๊ณ  ๋งํ•˜๋ผ. ๋ฌผ๋ก  ๋„ˆ๊ฐ€ ๊ณ ์น˜๊ฒ ๋‹ค๊ณ  ์ž์›ํ•˜์ง€๋งˆ๋ผ.

But seriously, folks

๋ฌผ๋ก  ์œ„ ์˜ˆ์‹œ๋Š” ๋†๋‹ด์ด๊ณ  ๋ฐ˜๋Œ€๋กœ ์–˜๊ธฐํ•œ ๊ฒƒ์ด๋‹ค.

Authority

์—ฌ๊ธฐ์„œ ์ค‘์š”ํ•œ ์ ์€ ์ฝ”๋“œ ๋ฆฌ๋ทฐ์–ด๊ฐ€ ๊ฐœ๋ฐœ์ž์— ๋Œ€ํ•ด ๊ถŒ์œ„๋ฅผ ๊ฐ€์ง€๊ฒŒ ๋œ๋‹ค๋Š” ์ ์ด๋‹ค. ๋ฆฌ๋ทฐ์–ด๋Š” ์ฝ”๋“œ๋ฅผ ์Šน์ธํ•˜์ง€ ์•Š์„ ๊ถŒ์œ„๊ฐ€ ์ƒ๊ธฐ๊ฒŒ ๋œ๋‹ค.

๊ถŒ์œ„๋Š” ํ•„์š”ํ•œ๋งŒํผ๋งŒ ์‚ฌ์šฉ๋˜์–ด์•ผํ•œ๋‹ค. ์ด๋Ÿฌํ•œ ๊ฒฝ์šฐ ์ฝ”๋“œ๋ฅผ ๊ฐ€๋Šฅํ•œ ์ข‹๊ฒŒ ๋งŒ๋“ค์–ด์•ผํ•˜๋Š” ๊ฑธ ๋งํ•˜๋Š”๋ฐ, ์ด ์ข‹๋‹ค๋Š” ๊ฐœ๋ฐœํŒ€ ์ „์ฒด๊ฐ€ ๋™์˜ํ•˜๋Š” ์ •์˜๋ฅผ ๋”ฐ๋ฅธ๋‹ค.

๋”ฐ๋ผ์„œ ์ด๋Ÿฌํ•œ ์•ˆํ‹ฐํŒจํ„ด๋“ค์€ ๊ถŒ์œ„๋ฅผ ๋‚จ์šฉํ•˜์—ฌ ๋ฐœ์ƒํ•œ๋‹ค. ๋ฆฌ๋ทฐ์–ด๋Š” ์ฝ”๋“œ์˜ ์žฅ์ ์„ ๋ฌด์‹œํ•˜๊ณ  ๊ฐœ์ธ์ ์ธ ๋‹ค๋ฅธ ์˜์ œ๋ฅผ ๊บผ๋‚ด์–ด ์ฝ”๋“œ๋ฅผ ์Šน์ธํ•˜์ง€ ์•Š์„ ์ˆ˜ ์žˆ๋‹ค. ์ด๋Ÿฌํ•œ ๊ฐœ์ธ์  ์˜์ œ๋Š” ์•ˆํ‹ฐํŒจํ„ด์— ๋”ฐ๋ผ ๋‹ค์–‘ํ•˜๋‹ค.

์ด๋ ‡๊ฒŒ๋˜๋ฉด ๋‹ค์Œ์— ๋ฆฌ๋ทฐ์–ด๊ฐ€ ๊ฐœ๋ฐœ์ž๊ฐ€ ๋˜๊ณ , ๊ทธ ๊ฐœ๋ฐœ์ž๊ฐ€ ๋ฆฌ๋ทฐ์–ด๊ฐ€ ๋˜์—ˆ์„๋•Œ ๋ณต์ˆ˜๊ฐ€ ์‹œ์ž‘๋  ์ˆ˜ ์žˆ๋‹ค. ์ด๋Ÿฌํ•œ ๋ณต์ˆ˜์˜ ์—ฐ์‡„๊ฐ€ ๋˜๋ฉด ํ”„๋กœ์ ํŠธ๋Š” ๋งํ•œ๋‹ค.

Gatekeeping code review

๋”ฐ๋ผ์„œ ํ•„์ž๋Š” peer code review ์— ์ดˆ์ ์„ ๋งž์ถ˜๋‹ค. ๊ฐœ๋ฐœํŒ€ ๋‚ด๋ถ€์—์„œ ์„œ๋กœ ๋ฆฌ๋ทฐ์–ด๊ฐ€ ๋˜๋Š” ๊ฒƒ์ด๋‹ค. ๋ฆฌ๋ทฐ์–ด์™€ ๊ฐœ๋ฐœ์ž๋Š” ๋™๋ฃŒ์ด๊ณ , ์ด ๊ด€๊ณ„๋Š” ์–ธ์ œ๋“  ๋ฐ”๋€” ์ˆ˜ ์žˆ๋‹ค. peer code review ์—์„œ๋Š” ๋ฆฌ๋ทฐ์–ด์™€ ๊ฐœ๋ฐœ์ž๊ฐ€ ๊ฐ™์€ ๋ชฉํ‘œ๋ฅผ ๊ฐ€์งˆ ์ˆ˜ ์žˆ๋‹ค.

๊ทธ๋Ÿฐ๋ฐ ๋งŒ์•ฝ ๊ฐœ๋ฐœํŒ€ ์™ธ๋ถ€์˜ ์ฝ”๋“œ๋ฅผ ๋ฆฌ๋ทฐํ• ๋•Œ๋Š” ์ƒํ™ฉ์ด ๋‹ค๋ฅด๋‹ค. ๋ฆฌ๋ทฐ์–ด๋Š” ๊ทธ ์ฝ”๋“œ๋ฅผ ์Šน์ธํ•˜์ง€ ์•Š์„ ๊ฐ€๋Šฅ์„ฑ์ด ํ›จ์”ฌ ํฌ๋‹ค. ์ด๋Ÿฌํ•œ ๊ฒฝ์šฐ๋Š” ๊ถŒ์œ„๋ฅผ ๋‚จ์šฉํ•œ ๊ฒƒ์ด ์•„๋‹ˆ๋‹ค. ์šฐ๋ฆฌ ํ”„๋กœ์ ํŠธ๋Š” ์šฐ๋ฆฌํŒ€์—์„œ ๊ฒฐ์ •ํ•  ๊ถŒํ•œ์ด ์žˆ๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค. ์ด์ฒ˜๋Ÿผ ๋ฆฌ๋ทฐ์–ด๊ฐ€ ๊ฒŒ์ดํŠธํ‚คํผ ์—ญํ• ์„ ํ•  ๊ฒฝ์šฐ, ๋ฆฌ๋ทฐ์–ด๋Š” ๊ทผ๋ณธ์ ์ธ ๋””์ž์ธํŒจํ„ด์„ ์ง€์ ํ•  ์ˆ˜ ์žˆ๋‹ค.

ํ•˜์ง€๋งŒ ์ด๋•Œ๋„ ์•„๋ฌด๋Ÿฐ ์„ค๋ช…์—†์ด ๊ทธ์ € ๊ฑฐ๋ถ€๋งŒํ•˜๋Š” ๊ฒƒ์€ ์ข‹์ง€ ์•Š๋‹ค (Guessing Game ์ฒ˜๋Ÿผ). ์–ด๋–ป๊ฒŒ ์ˆ˜์ •ํ•˜๋ฉด ์ข‹์„์ง€ ์„ค๋ช…ํ•˜๊ณ  ์ž˜ ๋ชจ๋ฅด๊ฒ ์œผ๋ฉด ๋ชจ๋ฅด๊ฒ ๋‹ค๊ณ  ๋งํ•˜๋Š” ๊ฒƒ์ด ์ข‹๋‹ค. ๋˜ํ•œ ์—ญ์‹œ Thousand Round Trip ์˜ˆ์‹œ๋Š” ํ•˜๋ฉด ์•ˆ๋œ๋‹ค.