매번 비슷한 지시문을 다시 작성하면서도 '생각한 대로 답변이 돌아오지 않는다'고 고민하곤 했다. 특히 코드 생성이나 요약, 설계 리뷰 등에서 미묘한 뉘앙스 차이가 결과에 큰 영향을 준다는 것을 깨닫고, 프롬프트 유형을 정리하여 사용하게 되었다.

예전에는 단순히 '코드를 작성해 주세요'라고 요청만 하면 초보자용 설명이 섞여서 장황해지기 일쑤였다.

당신은 시니어 백엔드 엔지니어입니다. 
아래 요구사항에 따라 Go의 HTTP 핸들러를 구현해 주세요.

역할을 처음에 명시하는 것만으로도 톤, 용어, 세부 수준이 현장 레벨로 맞춰져 리뷰 공수가 약 30% 감소했다.

✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨

최신 도구/트렌드 정보를 ずんだもん×めたん이 해설하는 YouTube 채널을 운영하고 있습니다!

좋아요와 채널 구독을 해주시면 감사하겠습니다🙇♂️

hajimeru.dev: https://hajimeru-dev.vercel.app/

'혼자 계속하기는 어렵다', '무엇부터 배워야 할지 모르겠다'는 분들을 위해,

프로그래밍의 1대1 레슨 서비스 'hajimeru.dev'도 운영하고 있습니다.

미경험 OK, 온라인 완결, 월정액제/위약금 없음으로 부담 없이 무료 상담을 받아보세요🙇♂️

해외 기술 뉴스를 추적하고 싶지만, 영어나 정보량이 많아서 힘들다는 분들을 위해,

Hacker News의 화제를 일본어로 간편하게 따라잡을 수 있는 'HackerNews 일본어 요약 & AI 요약'

을 개인 개발했습니다!

기술 트렌드 수집에 사용해 주시면 감사하겠습니다🔥🙇♂️

→ HackerNews 일본어 요약 & AI 요약: https://hn-matome-2ht.pages.dev/

'냐은파이아 서바이버(ニャンパイアサバイバー)'라는 뱀파이어 서바이버를 리스펙트한 게임을 만들었습니다!

혹시 괜찮으시면 플레이해 주시면 감사하겠습니다😭

학원 선생님들을 위해, SNS 게시물 작성, 학생 모집, 학부모 통지 문구를 AI로 생성하는 웹 서비스 'おしらせAI'를 개인 개발했습니다. Next.js + Supabase + LLM으로 구성되어 있으며, 무료로 월 10회까지 체험할 수 있습니다. 한번 사용해 보세요.

→ おしらせAI: https://oshirase-ai.vercel.app/

말하고 싶은 것이 제대로 전달되지 않는다'는 분들을 위해, 대화 표현을 교정하는 '伝え方ラボ(전달 방식 연구소)'를 개발 중입니다.

상황에 맞춰 자신의 말로 답변하면, 무엇이 전달되지 않았는지 지적과 함께 바로 사용할 수 있는 대체 표현이 돌아옵니다.

ChatGPT에게 상담하면 칭찬으로 시작하고 고쳐야 할 부분이 남는 경향이 있어, 지적하는 측면에 집중했습니다.

현재는 공개 시 공지 이메일 등록만 받고 있습니다🙇♂️

→ 伝え方ラボ: https://tsutaekata-lab.pages.dev/

✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨

복잡한 리팩토링을 한 번에 요청했더니, 중간 설계 판단이 생략되어 버그가 끼어들었다.

1. 현재 코드를 읽고 책임을 목록으로 정리해 주세요.
2. 단일 책임 원칙(SRP)에 따라 함수를 분할하는 안을 3가지 제시해 주세요.
3. 각각의 장점과 단점을 비교표로 출력해 주세요.

단계별로 구분하여 요청하자, 모델이 내부적으로 정리하며 답변하기 때문에 제안의 질이 안정되었고, 나중에 수정해야 할 횟수가 크게 줄었다.

Markdown이나 JSON으로 돌려받길 바랐는데 자유문으로 돌아와 파싱에 실패하는 경우가 많았다.

출력은 반드시 다음 JSON 스키마를 따르세요.
{

사고 과정이 시각화되니, 저희가 로직을 검증하기 쉬워졌고, 버그 혼입률이 체감상 절반 이하로 떨어졌다.

한 번의 프롬프트로 완벽함을 요구하면, 세부적인 요구사항 누락이 나중에 발견된다.

다음 순서에 따라 반복해 주세요.

1. 초안 작성
2. 스스로 코드 리뷰를 하고 개선점 3가지를 제시하기
   ...

자기 평가를 유도하자, 모델 자신이 결함을 보완하여 최종 결과물의 완성도가 첫 시도 대비 크게 향상되었다.

거대한 리포지토리 전체를 붙여넣으면 토큰 제한으로 잘리거나 중요한 부분이 누락된다.

--- 파일 A ---
[코드]
--- 파일 B ---
...

필요한 단편만 구분 기호로 전달하니, 토큰을 절약할 수 있을 뿐 아니라 관련 정보가 빠짐없이 포함되어 리뷰 정확도가 높아졌다.

창의적인 명명(naming)과 엄격한 코드 생성에 같은 설정을 사용하자, 어느 한쪽이 흐트러졌다.

명명 아이디어 도출

temperature: 0.9
top_p: 0.95
...

용도별로 파라미터를 변경하니, 명명은 다양성이 생기고 코드 생성은 결정적이 되어 재작업이 줄었다.

대화 도중에 '이번에는 다른 언어로'라는 지시를 받으면, 이전 규칙이 무너져 혼란스러웠다.

system:
당신은 항상 TypeScript의 strict 모드로 코드를 출력합니다.
주석은 JSDoc 형식으로 통일해 주세요.

시스템 메시지로 전제를 고정하니, 사용자 측 지시가 바뀌어도 기본 규칙이 지켜지고 리뷰 지적 사항인 '타입 정의 누락'이 거의 사라졌다.

프롬프트의 형식을 저장하여 사용하기만 해도, AI와의 상호작용이 '시행착오'에서 '확실한 도구'로 바뀐다. 일단 하나를 시도해 보길 바란다.