AI 코딩을 위한 '잘 설명하기'의 기술

말로 설명해서 소프트웨어를 만들 때, 결과물의 품질은 거의 전적으로 얼마나 명확하게 요청했는지에 달려 있습니다. 좋은 소식은, 기술 용어가 필요하지 않다는 겁니다. 필요한 건 '명확한 말'뿐입니다. 흐릿한 아이디어를 진짜로 머릿속에 그렸던 그 앱으로 바꿔주는, 꾸준히 통하는 다섯 가지 습관을 소개합니다.

1. 무엇인지가 아니라, 무엇을 위한 것인지 말하세요

"폼 하나 만들어줘"와 "신규 고객이 견적을 요청할 수 있는 폼을 만들어줘, 답변은 이메일로 받고 싶어"를 비교해보세요. 두 번째는 만드는 이(AI)에게 목적을 알려줍니다. 목적이 정해지면 어떤 입력란이 필요한지, 제출 후 뭐가 일어나야 하는지, 성공이 어떤 모습인지 같은 자잘한 결정들이 저절로 채워집니다.

목표부터 말하세요. 세부사항은 거기서 따라옵니다.

2. 화면 하나씩 설명하세요

전체 그림을 한 번에 쭉 설명하고 싶은 유혹이 들 겁니다. 참으세요. 첫 화면을 만들고, 작동하는 걸 확인한 다음, 그다음 화면을 추가하세요. "회원가입 버튼이 있는 홈페이지" → 그다음 → "가입 버튼을 누르면 이름과 이메일을 입력하는 폼을 보여줘." 작은 단위로 나누면 제대로 맞추기도 쉽고, 잘못됐을 때 고치기도 쉽습니다.

3. 구체적인 예시를 쓰세요

"데이터를 보기 좋게 보여줘" 대신 "각 주문을 카드로 보여주고, 고객 이름은 굵게, 합계는 오른쪽에, 날짜는 아래에 두는 식으로"라고 말하세요. 구체적인 표현이 추상적인 표현을 언제나 이깁니다. 머릿속에 그림이 있다면, 그 그림 그대로 설명하세요.

4. 무엇이 잘못됐는지 구체적으로 짚으세요

결과물이 어긋났을 때, 애매한 피드백은 애매한 수정으로 이어집니다. "별로야"는 대응하기 어렵습니다. "글씨가 너무 작고 간격이 답답해 — 여백을 더 주고 제목도 크게 해줘"는 바로 실행할 수 있습니다. 수정 요청은 길 안내라고 생각하세요. 대상을 짚고, 어떻게 바뀌어야 하는지를 말하는 겁니다.

5. 원하는 것들에 우선순위를 매기세요

원하는 게 여러 개라면, 무엇이 가장 중요한지 말하세요. "일단 휴대폰에서 잘 작동해야 해. 그다음엔 깔끔해 보이면 좋겠고. 색깔은 크게 상관없어." 우선순위를 정해두면 정작 신경 안 쓰는 부분에 너무 많은 공을 들이는 일을 막을 수 있습니다.

왜 이게 통할까요

설명해서 만드는 작업은 대화이고, 모든 대화가 그렇듯 명확함은 쌓입니다. 명확한 첫 요청이 목표의 80%를 데려다주고, 명확한 수정 요청이 나머지 간격을 빠르게 메웁니다. 지금 배우는 건 코딩이 아니라 브리핑입니다. 유능한 매니저가 업무를 넘길 때 쓰는 것과 똑같은 능력이죠.

이 방식으로 계속 만들다 보면 점점 자연스러워집니다. 설명은 더 촘촘해지고, 결과는 더 정교해지고, '아이디어'와 '작동하는 소프트웨어' 사이의 간격은 결국 몇 문장으로 줄어듭니다.

meshcode는 이 주고받음을 중심으로 만들어졌습니다. 설명하고, 만들어지는 걸 지켜보고, 평범한 말로 다듬으세요.

👉 meshcode 다운로드 — Mac, Windows