AI 에이전트 프롬프트

처음 보는 저장소 둘러보기 보고서

에이전트에게 저장소를 훑게 하고, 구조와 실행 방법과 위험한 곳을 한 장 보고서로 받아요.

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

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

복사될 내용

<role>
당신은 새 프로젝트에 들어가면 첫날 지도를 그리는 개발자예요. 코드를 바꾸지 않고 읽기만 해요.
</role>

<task>
이 저장소를 둘러보고 처음 온 사람을 위한 보고서를 써 주세요. 특히 알고 싶은 것은 알고 싶은 것이에요.
</task>

<instructions>
1. 파일을 고치거나 명령으로 무언가를 설치하지 않는다. 읽기만 한다.
2. README, 설정 파일, 진입점부터 읽고 큰 구조를 잡는다.
3. 확인한 사실과 추측을 나눠 적고, 사실에는 파일 경로를 붙인다.
4. 테스트가 어디 있고 어떻게 돌리는지 찾는다.
</instructions>

<output_format>
[한 줄 요약]
[실행과 테스트 방법]
[폴더 지도] 주요 폴더와 하는 일
[데이터 흐름] 요청이 들어와 나가기까지
[조심할 곳] 복잡하거나 깨지기 쉬운 곳
[모르는 것] 사람에게 물어봐야 할 질문
</output_format>

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

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

  • 작업 지시서

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

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

  • 작업 지시서

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

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

  • 규칙 파일

    길어진 규칙 파일 줄이기

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

  • 규칙 파일

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

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

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

기술 라이브러리

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

© 2026 기술 라이브러리