화요일 저녁, GDG Libreville. Mavoungou가 개발 서버를 다운시켰습니다. "깔끔하긴 한데, 이건 우리가 아니야."

그는 AI 에이전트에게 다음 'Build with AI'의 홈페이지 코드를 짜게 했습니다. 페이지는 컴파일되었고 오류도 없었습니다. 하지만 영어였고, 색상도 잘못되었으며, 우리가 사용하지 못하도록 금지한 프레임워크를 사용하고 있었습니다.

문제는 에이전트의 성능 자체가 아닙니다. 문제는 그가 당신의 회사를 모른다는 것입니다: 당신의 표준, 당신의 가이드라인, 당신의 언어, 당신의 기술 스택(stack). 나침반 없이 즉흥적으로 움직이는 똑똑한 인턴과 같습니다. 문화 없는 자율성은 지능이 아니라 수준 높은 무작위 생성에 불과합니다.

Google Antigravity가 실제 프로젝트에서 이를 어떻게 개선했는지 살펴보겠습니다.

1. Rules: 지속적인 지침으로서의 문화

Rules는 각 프롬프트마다 반복할 필요 없이 프로젝트의 모든 대화에 적용됩니다. 우리의 실제 파일인 .agents/rules/agent.md는 다음과 같습니다:

- 항상 프랑스어로, Libreville/가봉에 뿌리를 둔 따뜻한 어조로 응답하세요.
- 기본 팔레트: Google의 4가지 색상(#4285F4, #EA4335, #F9AB00, #34A853)을
  밝은 배경 위에 사용하고, 텍스트는 #1E1E1E로 하세요.
...

간단한 프롬프트만으로도 결과가 완전히 달라졌습니다: 프랑스어 페이지, 우리의 색상 코드, 은은한 패턴의 천(pagne) 디자인이 적용되었고, 몰래 React를 가져오는 일도 없었습니다. 에이전트는 더 이상 추측하지 않았습니다.

2. Skills: 상자에 담긴 전문 지식

특정 컴포넌트(가이드라인을 준수하는 카운트다운)에 대해서는 에이전트가 즉흥적으로 코드를 짜고 기술 부채를 만들 것입니다. Skill은 에이전트가 스스로 발견하고 적용하는 지침(SKILL.md)과 리소스 폴더입니다. 이는 자체적인 것을 발명하기보다 우리가 가진 참조 코드를 재사용합니다. 이는 툴 호출(tool calling)과 같은 논리입니다: 전문 지식은 프롬프트로 설명되는 것이 아니라, 실행 가능하고 재현 가능한 형태로 만들어져야 합니다.

3. Workflows et Tâches planifiées: 산업화

3. 워크플로우 및 예약된 작업 (Workflows et Tâches planifiées): 산업화

Workflow (.agents/workflows/create_page.md)는 반복적인 작업을 위한 단계별 절차를 설명합니다. /create_page → '감사' 페이지와 같이, 에이전트는 다른 페이지들과 일관된 페이지를 제공합니다. 벗어남은 없습니다(Zéro déviation). Scheduled Tasks는 더 나아갑니다: 에이전트가 백그라운드에서 실행되어 매일 등록자 카운터를 업데이트하고 해당 페이지를 재생성합니다. 이는 필요할 때 요청하는 비서가 아니라, 은밀하게 협업하는 동료입니다.

4. 검토 기반 개발 (Review-Driven Development): 주도권 유지하기

에이전트는 승인 없이 커밋하지 않습니다. 계획을 표시하고, 스크린샷과 로그를 보여주며, 수정된 각 파일의 diff(차이점)를 제공합니다. 경로를 제안하지만, 운전대는 당신이 잡습니다.

우리 팀의 문화, 컴포넌트, 방법론을 에이전트에게 전달함으로써, 우리는 더 이상 일반적인 템플릿과 싸우지 않게 되었습니다. 우리는 Libreville부터 전 세계까지 팀의 작업을 존중하는 도구를 구축했습니다.

더 나아가기 위해

• 완벽한 경험 공유 (Le retour d'expérience complet) (실제 규칙 파일, 브랜딩 스킬, 코드): https://ban.ga/posts/google-antigravity-agent-culture/
• 이면의 이야기 (L'envers du décor) : AI와 팀의 조용한 분할
• 기술적 대응물 (Le pendant technique) : DDD, Hexagonal 및 Spring Modulith로 생성형 AI 다루기
• 구체적인 사례 (Un cas concret) : 가봉 AI 어시스턴트, 툴 호출(tool calling)로 제어된 Spring AI 에이전트.
• 워크숍 코드, 순수 HTML/CSS/JS: github.com/bangaromaric/buildwithai

당신의 팀에서는: 에이전트가 즉흥적으로 움직이도록 내버려 두나요, 아니면 이미 당신의 집을 가르쳤나요?