AI 에이전트와 함께 소프트웨어 설계도를 작성하고, 새로운 눈으로 검토하는 방법
프로젝트의 맥락을 기억하는 '코끼리'가 설계 초안을 쓰고, 이전 대화를 잊은 '금붕어'가 그 초안을 다시 읽으며 숨겨진 전제와 빈틈을 찾아냅니다. 이 플러그인은 AI 코딩 어시스턴트에 설치하여 문서 기반의 소프트웨어 설계 과정을 돕는 도구입니다. 사용자가 최종적인 아키텍처 판단을 내리고 승인하기 전까지, 에이전트들이 초안 작성과 검토를 반복합니다.
컨텍스트를 분리한 설계와 검토
이 도구의 핵심은 컨텍스트를 분리하는 것입니다. '코끼리' 에이전트는 프로젝트의 요구사항과 이전 결정 사항을 모두 기억하며 문제를 탐색하고 명세 초안을 작성합니다. 반면 '금붕어' 리뷰어는 이전 대화 내용을 알지 못한 채 문서와 참조된 소스 코드만 보고 검토합니다. 이렇게 함으로써 개발자가 의식하지 못한 전제 조건이나 명확하지 않은 요구사항, 구현 리스크를 드러냅니다. 최종적으로 사용자가 트레이드오프를 해결하고 설계를 승인하면, 코딩 에이전트가 이를 구현합니다.
설계부터 검토까지의 흐름
작업은 아이디어 탐색으로 시작합니다. /egm-brainstorm 명령어로 기능을 논의하고, 합의된 방향을 concepts_brief.md 파일로 저장합니다. 이후 /egm-draft를 실행하면 에이전트가 이 브리프를 design_draft.md로 변환하며, 각 섹션마다 사용자의 피드백을 기다립니다. 초안이 완성되면 /egm-review 명령어로 새로운 에이전트들이 문서의 명확성, 코드와의 부합 여부, 구현 계획을 점검합니다. 사용자가 검토 결과를 선택적으로 반영하고 최종 승인을 하면, 해당 설계에 따라 코드를 작성할 수 있습니다.
기존 문서와 코드 불일치 확인
새로운 설계를 만드는 것 외에도, 기존 문서가 현재 코드와 얼마나 일치하는지 확인할 수 있습니다. /egm-drift-report 명령어를 사용하면 에이전트가 폴더 내 문서와 현재 소스 코드를 비교하여 차이점을 보고합니다. 사용자가 문서를 업데이트할지 코드를 수정할지 결정하는 데 이 보고서를 활용할 수 있습니다. 또한 /egm-review-loop를 통해 특정 리뷰어 그룹과 기준을 설정하여 다른 유형의 문서도 검토할 수 있습니다.
설치와 사용 환경
이 플러그인은 Python으로 작성되며, Claude Code, Codex CLI, Antigravity CLI 등 다양한 AI 코딩 에이전트에서 사용할 수 있습니다. Codex CLI와 Antigravity CLI도 각각의 플러그인 설치 명령어를 제공합니다. 설치 후 새 세션을 시작해야 하며, 리뷰 기능을 사용하려면 새로운 서브 에이전트를 생성할 수 있는 환경이 필요합니다. 서브 에이전트 생성이 불가능한 환경에서는 리뷰 과정이 중단됩니다.
사용 전 확인 사항
이 도구는 소프트웨어 명세 설계에 특화되어 있으며, 리뷰 과정이 테스트나 인간의 판단을 대체하지는 않습니다. Apache 2.0 라이선스로 공개되었지만, 구글의 공식 지원 제품은 아닙니다. 특히 복잡한 아키텍처 결정은 여전히 사용자가 최종적으로 책임져야 하므로, 에이전트의 출력을 맹신하지 않고 비판적으로 검토하는 과정이 필수적입니다.