안티그래비티 AI 에이전트, 제대로 다루는 12가지 대원칙

안티그래비티 AI 에이전트, 제대로 다루는 12가지 대원칙

AI 코딩 에이전트인 안티그래비티(Antigravity)를 쓰다 보면 순정 상태 그대로 사용하기엔 아쉬운 부분들이 생기곤 합니다. 스레드의 i.conatus님께서 클로드 코드(Claude Code)의 대원칙(CLAUDE.md)을 바탕으로 안티그래비티에 맞춰 각색한 8가지 핵심 원칙과 추가 가이드라인(총 12가지)을 정리해 주셨는데, AI 에이전트 활용에 정말 유용한 내용이라 소개합니다.

1. 생각하고 계획하는 리서치 & 수립 원칙

• 1. 리서치 강제 (Think Before Coding): 코딩 작업 전 깊은 분석을 선행하게 하고 RESEARCH.md로 정리하게 합니다. 특히 "기능 없음/불가" 판단을 내릴 때는 반드시 2개 이상 검증 및 교차 검색을 거친 뒤에만 말하도록 제약을 겁니다.
• 2. 독립된 계획 수립 (Root Cause & Tradeoffs): 임시방편 식의 패치는 금지합니다. 문제의 근본 원인을 분석하고 PLAN.md 문서에 트레이드오프(장단점)가 포함된 대안을 2~3가지 제안받도록 합니다.
• 3. 파일럿(PoC) 최우선 검증 (Fail Fast): 처음부터 전체 구현으로 가지 않고, 핵심 로직을 검증할 파일럿 후보를 먼저 제안받아 소규모로 검증한 후 확장합니다.

2. 정밀한 코드 수정 & 통제 원칙

• 4. 정밀한 수술적 변경 (Surgical Fix) & 롤백: 요청 범위를 벗어나 기존 코드를 임의로 변형하는 행위를 엄격히 통제합니다. 로직이 꼬이면 임시로 덧대지 않고 즉시 git reset으로 되돌리는 롤백을 우선시합니다.
• 5. Git 위생 강제 (Git Hygiene): _v2, _fix 같은 버저닝 사본 파일 생성을 엄금합니다. 또한 커밋과 푸시는 에이전트가 독단으로 처리하지 않고 항상 사전 확인을 거치도록 합니다.
• 6. 프로젝트 문서화: 프로젝트 루트의 규칙 및 진행 이력을 최신 상태로 유지합니다. 진행 상황, 완료 이력, 할 일 목록은 PLAN.md 등의 문서로 관리해 개발 연속성을 확보합니다.

3. 보안 & 프로젝트 연동 원칙

• 7. 보안 및 환경 변수 통제: 민감 정보의 하드코딩은 절대 금지합니다. .env 파일은 직접 읽거나 수정하려는 시도조차 원천 차단합니다.
• 8. 상황별 워크플로우 연동: 기획, 설계, 회고 등 프로젝트 상황별 워크플로우와 스킬에 맞춰 체계적으로 단계를 진행합니다.
• 9. 도메인 자료 및 참조 인덱싱: 특수 도메인 로직이 존재하는 프로젝트의 경우, 참조 인덱스 문서를 적극 활용하도록 인덱싱 작업을 진행합니다.

4. 피드백, 테스트 & 가이드라인

• 10. 평가 및 피드백 원칙 (순환논리 차단): 근거 없는 칭찬이나 사용자의 말을 앵무새처럼 되풀이하는 순환논리를 차단합니다. 검증할 수 없는 판단은 명확히 "확인 불가"로 표기하게 합니다.
• 11. 회귀 방지(Regression) 단위 테스트 강제: 본격적인 배포나 확장 단계로 전환할 때는 기존 기능이 깨지지 않도록 회귀 방지 단위 테스트 통과를 의무화합니다.
• 12. 추가 실행 가이드라인: 관련 파일 언급 시 클릭 가능한 마크다운 링크 형식을 제공하며, 의도가 모호한 요구사항은 자의적으로 추측하기보다 사용자에게 즉시 확인 질문을 던지도록 설정합니다.

📌 게시글 출처

본 포스팅은 스레드 유저 i.conatus님의 작성글을 기반으로 작성되었습니다.

출처 링크: https://www.threads.com/@i.conatus/post/DbDELMEE5-v