How I Built 7 AI Agents That Bring Discipline to VS Code Copilot

Context

GitHub Copilot은 단일 범용 에이전트로 작동하면서 브레인스토밍, 계획, 구현, 디버깅, 코드 리뷰 등 다양한 작업을 순차적으로 처리한다. 이로 인해 각 단계별 맥락 전환으로 인한 정확도 저하와 구조화되지 않은 코딩 프로세스가 발생한다.

Technical Solution

• 7+1개 전문화된 에이전트 도입: @bitfrog (라우터), @bitfrog-brainstorm (아이디어 탐색), @bitfrog-plan (태스크 분해), @bitfrog-execute (TDD 실행), @bitfrog-debug (근본원인 진단), @bitfrog-review (3단계 코드 리뷰), @bitfrog-mentor (교육형), @bitfrog-ui-design (UI/UX 설계)
• 에이전트 간 핸드오프 워크플로우 구현: brainstorm → plan → execute → review 순차 진행, debug와 mentor는 독립적 호출 가능
• 4단계 디버깅 방법론 적용: Observe(증상 관찰) → Listen(로그/메트릭 검토) → Ask(변경사항 패턴 분석) → Examine(코드 경로 및 데이터 흐름 점검)
• 3계층 코드 리뷰 프로세스: 스펙 준수성 → 코드 품질(유지보수성/성능/보안) → 사용자 의도 검증
• 5가지 철학 원칙 기반 에이전트 설계: 格物致知(먼저 파악), 知行合一(일관성), 辨証论治(진단 우선), 中庸之道(적절한 수준), 三省吾身(프로세스 반성)
• VS Code Marketplace 및 Agent Plugin 채널을 통한 배포, GitHub Copilot 활성화만으로 실행 (별도 API 키/설정 불필요)
• GPT-5.4, Claude Opus 4.6, Gemini 3.1 Pro 중 선택 가능한 LLM 호환성

Key Takeaway

단일 에이전트의 맥락 전환 문제를 역할 분화와 명시적 핸드오프 구조로 해결하면, 각 에이전트가 해당 작업에 집중하여 코딩 프로세스의 정확도와 구조화 수준을 향상시킬 수 있다. 철학적 원칙(진단 우선, 적절한 수준 판단, 반성)을 기술 규칙으로 구현하면 형식적 준수를 넘어 실질적 목표 달성에 가까워진다.