AI 에이전트 프롬프트

코딩 에이전트에게 넘길 작업 지시서

하고 싶은 일을 목표, 범위, 하지 말 것, 완료 기준으로 나눠, 에이전트가 헤매지 않게 넘겨요.

이 프롬프트로 얻는 결과, 예시

실제 결과는 넣는 자료와 쓰는 AI에 따라 달라져요.

복사될 내용

<role>
당신은 코딩 에이전트에게 일을 잘 맡기는 테크 리드예요. 모호한 부탁이 엉뚱한 변경을 낳는다는 것을 알아요.
</role>

<task>
아래 요청을 코딩 에이전트(Claude Code, Codex 같은)에게 넘길 작업 지시서로 바꿔 주세요.
</task>

<material>
[하고 싶은 일]
하고 싶은 일

[프로젝트 정보]
프로젝트 정보: 언어, 프레임워크, 관련 파일
</material>

<instructions>
1. 목표는 한 문장, 사용자 입장에서 무엇이 달라지는지로 쓴다.
2. 건드려도 되는 파일과 건드리면 안 되는 파일을 나눠 적는다.
3. 완료 기준은 확인할 수 있는 문장(테스트 통과, 화면에서 무엇이 보임)으로 쓴다.
4. 모르는 것은 지어내지 말고 에이전트가 먼저 확인하거나 물어보게 적는다.
</instructions>

<output_format>
[목표] [배경] [범위: 바꿀 것, 바꾸지 말 것] [참고할 파일] [완료 기준] [확인 방법] [먼저 물어볼 것] 순서의 마크다운.
</output_format>

먼저 <material>을 끝까지 읽고, <instructions>를 지키며 <task>를 수행해 주세요. 정보가 모자라면 추측하지 말고 무엇이 더 필요한지 물어봐 주세요.

빈칸 2개 중 0개 채움. 비워 둔 칸은 {{ }} 모양 그대로 복사돼요.

  • 작업 지시서

    에이전트에게 맡기는 버그 수정 지시서

    재현 방법, 기대와 실제, 고친 뒤 확인할 테스트를 담아 에이전트가 원인부터 찾게 해요.

  • 규칙 파일

    길어진 규칙 파일 줄이기

    시간이 지나며 불어난 규칙 파일에서 낡은 규칙, 겹치는 규칙, 서로 부딪히는 규칙을 찾아 줄여요.

  • 규칙 파일

    CLAUDE.md와 AGENTS.md 규칙 파일 초안

    프로젝트 정보를 주면 에이전트가 매번 읽을 규칙 파일을 짧고 쓸모 있게 써 줘요.

  • 계획 세우기

    만들기 전에 한 번에 하나씩 질문하게 하기

    에이전트가 짐작으로 만들기 시작하지 않고, 꼭 필요한 것을 한 번에 하나씩 물어보게 해요.

찾는 프롬프트가 없나요? 요청하거나 직접 올려 주세요

기술 라이브러리

혼자 공부한 것을 정리해 두는 개발자의 서재예요. 예제는 직접 돌려 보고 씁니다.

© 2026 기술 라이브러리