AI 에이전트에게 단순히 "버그를 고쳐줘"라고 말하며 파일 하나만 붙여넣는 것을 멈추세요

AI 에이전트에게 "버그를 고쳐줘"라고 말하며 파일 하나만 붙여넣는 것을 멈추세요.
이해하지 못하는 코드를 다시 쓰게 내버려 두지 마세요.
리뷰할 때 설명할 수 없는 차이점(diffs)을 수락하는 것을 멈추세요.

당신의 에이전트는 멍청한 것이 아닙니다. 컨텍스트(context)가 부족한 것입니다. 당신은 시니어 엔지니어에게 400페이지 분량의 코드베이스 중 단 한 페이지만 건네주며 왜 추측했느냐고 묻고 있는 것과 같습니다.

"AI 슬롭 (AI slop)"과 "프로덕션 배포 (ships to prod)" 사이의 격차는 전적으로 당신이 문제를 어떻게 프레이밍(frame)하느냐에 달려 있습니다.

Claude를 코드를 작성하기 전에 추론하는 엔지니어로 만드는 7가지 프롬프트

AI 코딩의 추악한 비밀: 모델은 대개 당신이 준 프롬프트보다 더 똑똑합니다.

진정한 엔지니어링은 코드를 타이핑하는 것이 아닙니다. 시스템의 멘탈 모델 (mental model)을 구축하고, 실제 근본 원인 (root cause)을 찾아내며, 코드베이스에 이미 존재하는 제약 사항을 존중하고, 기존 시스템을 망가뜨리지 않는 것입니다.

프롬프트 1: 먼저 멘탈 모델 (mental model)을 구축하세요

시니어 개발자는 코드를 쓰기 전에 읽습니다. 이는 에이전트가 단 한 줄을 수정하기 전에 시스템을 매핑하고 스스로의 가정을 드러내도록 강제합니다.

"코드를 작성하기 전에, 이 시스템에 대한 당신의 멘탈 모델 (mental model)을 구축하여 나에게 보여주세요.

관련된 내용은 다음과 같습니다: [내용]

프롬프트 2: 증상이 아닌 근본 원인 (root cause)

대부분의 AI "수정 (fixes)"은 증상만을 패치하고 버그를 한 단계 더 깊은 곳으로 밀어 넣습니다. 이는 실제 진단을 강제합니다.

"제1원리 (first principles)로부터 이 버그를 진단하세요. 아직 수정안을 제안하지 마세요.

증상: [발생하는 현상 vs 발생해야 하는 현상, 정확한 조건].
관련된 내용은 다음과 같습니다: [내용]