Cursor에서 하네스 엔지니어링 적용하기

작심오십년·2026년 4월 10일

AI

목록 보기

2/5

이전 포스팅에서 AI 에이전트를 안전하고 효율적으로 제어하기 위한 환경 구축, 즉 '하네스 엔지니어링'에 대해 학습했다. 그렇다면 코딩할 때 사용하는 AI 에디터인 Cursor에서는 이 개념을 어떻게 적용할 수 있을까?

단순히 프롬프트를 잘 쓰는 것을 넘어, "Cursor 내의 AI가 스스로 규칙을 지키고, 에러를 고치며 안전하게 일할 수 있는 환경"을 세팅하는 4가지 실전 기법을 정리해 보았다.

AI 하네스의 가장 기본은 '규칙(Guardrails)'을 설정하는 것이다. AI가 내 프로젝트의 코딩 컨벤션을 무시하고 마음대로 코드를 짜지 못하도록 통제해야 한다.

적용 방법: 프로젝트 최상단 루트 디렉토리에 .cursorrules 라는 파일을 만든다.
하네스 엔지니어링적 접근: 이 파일 안에 프로젝트의 아키텍처, 언어 버전, 네이밍 규칙, 린터(Linter) 규칙 등을 명시한다.
효과: Cursor의 AI(Composer나 Chat)는 코드를 생성하기 전에 무조건 이 규칙을 먼저 읽는다. 즉, AI가 내 프로젝트 환경을 망가뜨리지 않도록 안전벨트(Harness)를 채워두는 것과 같다.

(예시)

# .cursorrules
1. 모든 변수명은 snake_case를 사용한다.
2. 에러 처리는 반드시 try-except 문을 사용하고 로그를 남긴다.
3. 테스트 코드는 pytest 프레임워크 규칙을 따른다.

하네스 엔지니어링의 핵심 중 하나는 AI에게 '제한된 샌드박스 환경'을 제공하여 환각이나 엉뚱한 파일 수정을 막는 것이다.

.cursorignore 활용: AI가 읽을 필요가 없는 가상환경(venv), 로그 파일(.log), 보안 키(.env) 등을 제외하여, AI의 시야를 좁히고 시스템 보안을 지킨다.
@Files 및 @Folders 활용: 프롬프트를 작성할 때 무작정 질문하지 않고, @ 기호를 통해 AI가 참고해야 할 파일만 정확히 주입(Context Injection)해 준다.
효과: AI는 딱 주어진 컨텍스트 내에서만 사고하므로, 엉뚱한 결론을 도출할 확률이 획기적으로 낮아진다.

AI는 완벽하지 않기 때문에 코드를 짜다 보면 문법 오류나 린터 에러(Linter Error)를 발생시킨다. 이때 사람이 직접 고치는 것이 아니라, 시스템이 에러를 AI에게 다시 먹여 스스로 고치게 만드는 루프가 하네스의 핵심이다.

적용 방법:
1. Cursor 터미널에서 코드를 실행하거나 테스트(pytest)를 돌린다.
2. 에러가 발생하면, 터미널에 뜬 에러 로그를 그대로 복사하거나 "Add to Chat" 버튼을 누른다.
3. AI에게 "이 에러 로그를 분석하고, 기존 코드를 수정해"라고 지시한다.
하네스 엔지니어링적 접근: 에러(결과) -> AI 주입 -> 자가 수정(Self-correction)으로 이어지는 자동화된 파이프라인 경험을 에디터 내에서 구현하는 것이다.

단일 질문에 답하는 Chat(Ctrl + L)과 달리, Composer는 여러 파일을 동시에 수정하고 생성할 수 있는 작은 'AI 에이전트'다.

하네스 역할로서의 인간: Composer가 코드를 짤 때, 개발자는 코딩을 하는 것이 아니라 'AI가 올바른 파일을 수정하고 있는지(Diff 확인), 에러는 없는지 승인(Accept)하거나 거절(Reject)하는 감독관' 역할을 수행한다.
효과: AI에게 자율성을 주되, 최종 결정권은 하네스를 통제하는 인간이 가짐으로써 효율성과 안전성을 동시에 챙길 수 있다.

자동화 QA 위주