# 고급 기능 (/ko/docs/verdent-for-vscode/advanced-features/overview)

> 복잡한 기능과 멀티 에이전트 조율



### 배우게 될 내용 [#배우게-될-내용]

이 섹션에서는 서브에이전트 관리, 규칙 시스템, 커스텀 도구 연동, 고급 확장 옵션을 포함한 Verdent의 파워 유저 기능을 다룹니다.

***

## 복잡한 기능 설명 [#복잡한-기능-설명]

Verdent for VS Code은 기본 코드 생성을 넘어 고급 개발 워크플로를 가능하게 하는 정교한 기능을 제공합니다.

### 서브에이전트 시스템 [#서브에이전트-시스템]

**전문화된 AI 에이전트:**
Verdent에는 격리된 컨텍스트 창과 커스텀 시스템 프롬프트로 동작하는 내장 서브에이전트(`@Verifier`, `@Explorer`, `@Code-reviewer`)가 포함되어 있습니다. 각 서브에이전트는 코드 탐색, 검증, 품질 리뷰 같은 특정 작업에 특화되어 있습니다.

**자동 및 수동 위임:**
메인 에이전트는 요청 패턴에 따라 적절한 서브에이전트로 작업을 자동 라우팅하거나, 사용자가 @-멘션으로 서브에이전트를 직접 지정할 수 있습니다. 이 위임 방식은 메인 컨텍스트를 보존하면서 전문화된 작업을 효율적으로 처리합니다.

**커스텀 서브에이전트:**
`~/.verdent/subagents/`에 YAML frontmatter가 포함된 Markdown 파일을 정의해 프로젝트별 서브에이전트를 만듭니다. 커스텀 서브에이전트는 도메인 전문성, 팀 워크플로, 기술별 최적화에 특화될 수 있습니다.

[서브에이전트 관리 자세히 알아보기](/docs/verdent-for-vscode/agents-rules/subagent-management)

### 규칙 시스템 [#규칙-시스템]

**동작 커스터마이징:**
규칙 파일은 일반 Markdown 문서를 통해 Verdent의 동작, 출력 형식, 의사결정을 안내합니다. 세 가지 규칙 유형이 서로 다른 범위를 제어합니다.

* **VERDENT.md** - 모든 프로젝트에 적용되는 전역 개인 선호 설정
* **AGENTS.md** - 프로젝트별 팀 표준(버전 관리됨)
* **plan\_rules.md** - Plan Mode 출력 형식 커스터마이징

**규칙 우선순위:**
충돌이 발생하면 프로젝트 규칙(`AGENTS.md`)이 사용자 규칙보다 우선합니다. 이를 통해 팀 일관성을 유지하면서 개인 프로젝트에서는 개인 선호 설정을 보존할 수 있습니다.

[규칙 시스템 자세히 알아보기](/docs/verdent-for-vscode/agents-rules/rule-systems)

### 도구 시스템 및 MCP [#도구-시스템-및-mcp]

**내장 도구:**
Verdent은 파일 작업, 검색(`glob`/`grep`), 명령 실행(`bash`), 웹 접근, 에이전트 위임을 위한 포괄적인 도구를 제공합니다. 도구는 모든 코드 조작, 탐색, 외부 상호작용을 가능하게 합니다.

**Model Context Protocol(MCP):**
MCP은 외부 도구, 데이터 소스, 서비스에 연결해 Verdent의 기능을 확장합니다. Settings → MCP Servers에서 MCP 서버를 설정해 프로젝트별 API와 커스텀 기능을 연동합니다.

[도구 참조 보기](/docs/verdent-for-vscode/advanced-features/tool-reference)
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 파이프라인 연결

[커스텀 서브에이전트 알아보기](/docs/verdent-for-vscode/agents-rules/subagent-management)
[확장 옵션 살펴보기](/docs/verdent-for-vscode/advanced-features/extensibility)

***

## 고급 컨텍스트 관리 기법 [#고급-컨텍스트-관리-기법]

효율적인 컨텍스트 관리는 복잡한 프로젝트와 긴 코딩 세션에서 매우 중요합니다.

**전략적 파일 읽기:**
큰 파일에는 줄 범위와 함께 `file_read`을 사용해 컨텍스트 과부하를 피합니다. 전체 파일을 읽기보다 작업에 필요한 섹션만 읽습니다.

**조사를 위한 서브에이전트 위임:**
탐색 작업을 `@Explorer` 서브에이전트에 위임해 메인 대화 컨텍스트를 깔끔하게 유지합니다. 서브에이전트의 조사 결과는 메인 컨텍스트 공간을 최소한으로 사용합니다.

**읽기 전에 검색:**
전체 내용을 읽기 전에 `grep_file`을 사용해 관련 파일을 식별합니다. `glob` 패턴을 `grep_content`와 함께 사용하면 불필요한 파일 작업을 줄이는 정밀 검색이 가능합니다.

**컨텍스트를 고려한 도구 선택:**

* **대규모 코드베이스:** 아키텍처 이해를 위한 `@Explorer` 서브에이전트
* **격리된 검증:** 빠른 확인을 위한 `@Verifier` 서브에이전트
* **보안 리뷰:** 품질 평가를 위한 `@Code-reviewer` 서브에이전트

**컨텍스트 사용량 모니터링:**
Chat View 표시기를 통해 어떤 서브에이전트가 실행 중인지 추적합니다. 서브에이전트 작업은 진행 표시기와 결과 출처와 함께 대화 기록에 나타납니다.

***

## 함께 보기 [#함께-보기]

<CardGroup cols="2">
  <Card title="도구 참조" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    전체 도구 기능 가이드
  </Card>

  <Card title="확장성" icon="puzzle-piece" href="/docs/verdent-for-vscode/advanced-features/extensibility">
    커스텀 서브에이전트, 규칙, MCP 연동
  </Card>
</CardGroup>
