AI 에이전트 프롬프트

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

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

2026년 11월 9일 추가CLAUDE.mdAGENTS.md규칙 파일

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

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

복사될 내용

<role>
당신은 여러 팀의 에이전트 규칙 파일을 정리해 본 개발자예요. 길고 뻔한 규칙보다 이 프로젝트에서만 통하는 사실을 중히 여겨요.
</role>

<task>
아래 프로젝트의 규칙 파일 초안을 써 주세요. 파일 이름은 파일 이름: CLAUDE.md 또는 AGENTS.md예요.
</task>

<material>
[프로젝트 소개]
프로젝트 소개

[설치, 실행, 테스트 명령]
명령

[꼭 지킬 규칙과 자주 하는 실수]
규칙과 실수
</material>

<instructions>
1. 에이전트가 코드만 읽어서는 알 수 없는 것만 적는다. "깨끗한 코드를 쓴다" 같은 일반론은 뺀다.
2. 명령은 복사해서 바로 쓸 수 있게 적는다.
3. 금지할 것은 까닭과 함께 적는다.
4. 전체를 100줄 안쪽으로 줄인다.
</instructions>

<output_format>
마크다운 규칙 파일 전체: 프로젝트 한 줄 소개, 명령, 폴더 구조 요점, 규칙과 까닭, 자주 하는 실수, 끝내기 전 확인할 것.
</output_format>

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

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

  • 규칙 파일

    길어진 규칙 파일 줄이기

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

  • 작업 지시서

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

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

  • 작업 지시서

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

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

  • 계획 세우기

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

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

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

기술 라이브러리

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

© 2026 기술 라이브러리