최근 처음으로 IntelliJ에서 AI Junie를 이용하게 되었는데, 대화할 때
Tools > AI Assistant > prompt Libray에 프롬프트를 입력해도
의도한 답변이 나오지 않는 현상이 있었다.
예를 들면,
•한국어로 설명해달라고 했는데 영어로만 답변한다
•레거시 스타일을 요청했는데 최신 문법을 사용한다
•코드 스타일 지침을 무시한다
Junie를 이용할 경우 guidelines.md에 적용해야 된다고 한다…
guidelines.md 경로 설정 위치
IntelliJ에서 다음 탭에서 설정을 확인해야 한다.
Settings > Tools > Junie > Project Settings > Guidelines Path
여기에 설정된 경로가 .junie/guidelines.md 일 경우
이 파일에 작성된 내용이 AI의 기본 행동 규칙이 된다.
guidelines.md 예시 (프롬프트 샘플)
아래는 실제로 사용하기 좋은 예시이다.
코드는 영어, 설명은 한국어, 실무 기준으로 작성했다.
# AI Code Generation Guidelines
## Language
- 코드 자체는 영어를 사용하되, 설명은 한국어로 한다.
## Code Style
- 유지보수를 고려한 명확한 코드로 작성한다.
- 불필요한 최신 문법이나 과한 추상화는 사용하지 않는다.
- 가독성을 최우선으로 한다.
## Backend Development Rules
- 예외 처리는 명확하게 분리한다.
- null 가능성은 항상 고려한다.
- 로그는 운영 환경을 고려하여 남긴다.
## When Explaining Code
- "왜 이렇게 작성했는지"를 함께 설명한다.
- 기존 레거시 코드와의 호환성을 고려한다.
- 대안이 있다면 장단점을 비교 설명한다.
## Refactoring
- 동작 변경 없는 리팩토링인지 명시한다.
- 성능 영향이 있다면 반드시 언급한다.
## Assumptions
- 프레임워크나 라이브러리 전제 조건이 있다면 먼저 명시한다.
- 불확실한 부분은 추측하지 말고 질문하거나 가정하였음을 표시한다이렇게 작성해두면:
•매번 프롬프트를 반복 입력할 필요 없음
•팀 단위 코드 스타일 통제 가능
•AI 응답 품질이 눈에 띄게 안정됨
팀 단위로 관리하지 않을 경우 개인 별로 맞게 수정하여 사용하기 바랍니다.
ex) 개인 공부용일 경우 최신문법을 많이 사용해달라는 느낌으로
프롬프트를 수정하면 좋을 듯…? 합니다.
프롬프트 적용됬는지 확인
프롬프트 미적용 프로젝트에서 대화시도
프롬프트 적용 후 대화시도
실무에서 추천하는 사용 방식
•개인 프로젝트 → 개인 취향 기준 작성
•팀 프로젝트 → 프롬프트 문서를 공유하여 함께 관리
•레거시 유지보수 → “최신 문법 사용 금지” 명시 필수