고급 기능
복잡한 기능과 멀티 에이전트 조율
배우게 될 내용
이 섹션에서는 서브에이전트 관리, 규칙 시스템, 커스텀 도구 연동, 고급 확장 옵션을 포함한 Verdent의 파워 유저 기능을 다룹니다.
복잡한 기능 설명
Verdent for VS Code은 기본 코드 생성을 넘어 고급 개발 워크플로를 가능하게 하는 정교한 기능을 제공합니다.
서브에이전트 시스템
전문화된 AI 에이전트:
Verdent에는 격리된 컨텍스트 창과 커스텀 시스템 프롬프트로 동작하는 내장 서브에이전트(@Verifier, @Explorer, @Code-reviewer)가 포함되어 있습니다. 각 서브에이전트는 코드 탐색, 검증, 품질 리뷰 같은 특정 작업에 특화되어 있습니다.
자동 및 수동 위임: 메인 에이전트는 요청 패턴에 따라 적절한 서브에이전트로 작업을 자동 라우팅하거나, 사용자가 @-멘션으로 서브에이전트를 직접 지정할 수 있습니다. 이 위임 방식은 메인 컨텍스트를 보존하면서 전문화된 작업을 효율적으로 처리합니다.
커스텀 서브에이전트:
~/.verdent/subagents/에 YAML frontmatter가 포함된 Markdown 파일을 정의해 프로젝트별 서브에이전트를 만듭니다. 커스텀 서브에이전트는 도메인 전문성, 팀 워크플로, 기술별 최적화에 특화될 수 있습니다.
규칙 시스템
동작 커스터마이징: 규칙 파일은 일반 Markdown 문서를 통해 Verdent의 동작, 출력 형식, 의사결정을 안내합니다. 세 가지 규칙 유형이 서로 다른 범위를 제어합니다.
- VERDENT.md - 모든 프로젝트에 적용되는 전역 개인 선호 설정
- AGENTS.md - 프로젝트별 팀 표준(버전 관리됨)
- plan_rules.md - Plan Mode 출력 형식 커스터마이징
규칙 우선순위:
충돌이 발생하면 프로젝트 규칙(AGENTS.md)이 사용자 규칙보다 우선합니다. 이를 통해 팀 일관성을 유지하면서 개인 프로젝트에서는 개인 선호 설정을 보존할 수 있습니다.
도구 시스템 및 MCP
내장 도구:
Verdent은 파일 작업, 검색(glob/grep), 명령 실행(bash), 웹 접근, 에이전트 위임을 위한 포괄적인 도구를 제공합니다. 도구는 모든 코드 조작, 탐색, 외부 상호작용을 가능하게 합니다.
Model Context Protocol(MCP): MCP은 외부 도구, 데이터 소스, 서비스에 연결해 Verdent의 기능을 확장합니다. Settings → MCP Servers에서 MCP 서버를 설정해 프로젝트별 API와 커스텀 기능을 연동합니다.
도구 참조 보기 MCP 연동 알아보기](/docs/verdent-for-vscode/advanced-features/mcp)
멀티 에이전트 조율
Verdent의 멀티 서브에이전트 아키텍처는 자동 라우팅과 조율을 통해 병렬 작업 실행을 가능하게 합니다.
메인 에이전트(오케스트레이터): 기본 에이전트는 요청을 분석하고, 복잡한 작업을 나누며, 대화 컨텍스트를 유지하고 결과를 통합하면서 전문 작업을 서브에이전트에 위임합니다.
병렬 실행: 복잡한 작업에서는 여러 서브에이전트가 동시에 실행됩니다. 예: Explorer 서브에이전트가 코드베이스를 검색하는 동안 Code-reviewer가 보안을 동시에 분석해 더 빠르게 결과를 제공합니다.
컨텍스트 격리: 각 서브에이전트는 자체 컨텍스트 창에서 동작합니다. 최종 결과만 메인 에이전트의 컨텍스트 공간을 사용하므로, 여러 단계의 작업 중 컨텍스트가 소진되는 것을 방지합니다.
작업 라우팅: 패턴 기반 자동 감지가 작업을 라우팅합니다.
- 코드베이스 질문 →
@Explorer서브에이전트 - 보안 리뷰 →
@Code-reviewer서브에이전트 - 검증 확인 →
@Verifier서브에이전트
커스텀 워크플로 만들기
고급 사용자는 팀 프로세스와 프로젝트 요구사항에 맞게 Verdent의 동작을 커스터마이징할 수 있습니다.
커스텀 서브에이전트 워크플로: 도메인별 요구에 맞는 전문 서브에이전트를 만듭니다.
- API 문서 생성기 - 코드에서 엔드포인트와 매개변수 추출
- 데이터베이스 마이그레이션 리뷰어 - 스키마 변경의 안전성 검증
- 접근성 감사 도구 - 프론트엔드 코드의 WCAG 준수 여부 확인
규칙 기반 커스터마이징: 규칙 파일을 통해 코딩 표준, 테스트 요구사항, 출력 선호 설정을 정의합니다.
- 팀 컨벤션 적용(들여쓰기, 이름 지정, 패턴)
- 문서 스타일과 주석 상세 수준 지정
- Plan Mode 출력 구조와 세분화 수준 제어
MCP을 통한 확장성: 외부 도구와 서비스를 연동합니다.
- 데이터베이스 쿼리 도구
- 클라우드 서비스 APIs(AWS, Azure, GCP)
- 프로젝트 관리 연동(Jira, Linear)
- CI/CD 파이프라인 연결
고급 컨텍스트 관리 기법
효율적인 컨텍스트 관리는 복잡한 프로젝트와 긴 코딩 세션에서 매우 중요합니다.
전략적 파일 읽기:
큰 파일에는 줄 범위와 함께 file_read을 사용해 컨텍스트 과부하를 피합니다. 전체 파일을 읽기보다 작업에 필요한 섹션만 읽습니다.
조사를 위한 서브에이전트 위임:
탐색 작업을 @Explorer 서브에이전트에 위임해 메인 대화 컨텍스트를 깔끔하게 유지합니다. 서브에이전트의 조사 결과는 메인 컨텍스트 공간을 최소한으로 사용합니다.
읽기 전에 검색:
전체 내용을 읽기 전에 grep_file을 사용해 관련 파일을 식별합니다. glob 패턴을 grep_content와 함께 사용하면 불필요한 파일 작업을 줄이는 정밀 검색이 가능합니다.
컨텍스트를 고려한 도구 선택:
- 대규모 코드베이스: 아키텍처 이해를 위한
@Explorer서브에이전트 - 격리된 검증: 빠른 확인을 위한
@Verifier서브에이전트 - 보안 리뷰: 품질 평가를 위한
@Code-reviewer서브에이전트
컨텍스트 사용량 모니터링: Chat View 표시기를 통해 어떤 서브에이전트가 실행 중인지 추적합니다. 서브에이전트 작업은 진행 표시기와 결과 출처와 함께 대화 기록에 나타납니다.