Verdent Docs
핵심 기능

개요

Verdent의 AI 기반 개발 기능 개요

Verdent for VS Code는 고급 AI 기능과 전문 개발 워크플로를 결합합니다. 이 가이드는 요구사항 엔지니어링부터 자동화된 품질 보증까지, AI 지원 코딩을 가능하게 하는 핵심 기능을 소개합니다.

배울 내용

  • 핵심 워크플로 기능(Professional Plan, Code Diff, Verify)
  • 컨텍스트 인식과 전문 서브에이전트
  • 협업 모드와 확장성

Verdent의 워크플로는 세 가지 핵심 단계로 구성됩니다.

  • Plan - Plan Mode로 요구사항을 명확히 합니다
  • Code - 안정적인 제공을 위해 Code Diff로 검토하고 다듬습니다
  • Verify - Verify 도구로 테스트를 자동화하고 문제를 조기에 발견합니다

이 기능들은 함께 작동하여 개발 프로세스 전반에서 정밀함과 제어력을 보장합니다.


핵심 워크플로 기능


추가 기능

컨텍스트 인식: 코드베이스에 대한 깊은 이해

Verdent의 컨텍스트 관리 시스템은 프로젝트를 포괄적으로 이해할 수 있게 합니다.

대규모 컨텍스트 창

  • 100만 토큰 용량 - 중간 규모 코드베이스 전체를 수집합니다(약 75만 단어 또는 3,000개 이상의 파일)
  • 스마트 컨텍스트 로딩 - 작업 컨텍스트에 따라 관련 파일의 우선순위를 자동으로 지정합니다
  • 서브에이전트 컨텍스트 최적화 - 전문 작업을 집중형 서브에이전트에 위임합니다

적응형 학습

  • 규칙 감지 - 프로젝트별 패턴(이름 지정, 파일 구성, 오류 처리)을 학습합니다
  • 스타일 모방 - 기존 스타일(들여쓰기, 중괄호 위치, 주석)에 맞는 코드를 생성합니다
  • 라이브러리 인식 - 사용 중인 프레임워크를 인식하고 새 의존성보다 우선합니다

파일 간 일관성

  • 의존성 추적 - import, export, 모듈 관계를 이해합니다
  • 영향 예측 - 제안된 변경의 영향을 받는 컴포넌트를 식별합니다
  • 일관성 적용 - 수정 사항이 기존 아키텍처와 맞도록 보장합니다

전문 서브에이전트: 역할 분담

Verdent는 특정 개발 작업에 최적화된 전문 AI 에이전트를 오케스트레이션합니다.

목적: 빠르고 증거 기반인 코드베이스 탐색 및 분석

기능:

  • 패턴 매칭 - glob 패턴으로 파일을 찾습니다(예: 모든 TypeScript 파일, 백엔드 API 파일)
  • 시맨틱 검색 - 기능을 기준으로 코드를 찾습니다(예: "인증 미들웨어는 어디에 구현되어 있나요?")
  • 다중 위치 종합 - 여러 파일의 정보를 모아 종합합니다

철저함 수준:

  • 빠름: 빠른 답변을 위한 기본 패턴 매칭
  • 중간: 컨텍스트 확인을 포함한 더 넓은 검색
  • 매우 철저함: 변형 확인과 교차 참조를 포함한 포괄적 스캔

사용 사례: "모든 데이터베이스 쿼리 함수를 찾아줘", "설정 로딩 로직을 찾아줘", "앱은 오류를 어떻게 처리하나요?"

목적: 빠른 코드 품질 검사와 검증

기능:

  • Lint 검사 - ESLint, Pylint, Rubocop 등
  • 타입 검증 - TypeScript, mypy, Flow 타입 검사
  • 빠른 테스트 실행 - 30초 미만 예산으로 대상 단위 테스트 실행
  • Diff 중심 검증 - 효율성을 위해 주로 변경된 코드를 검증합니다

빠른 실패 원칙: 실제 문제가 처음 발견되면 구조화된 오류 보고서를 반환하여 시간 낭비를 피합니다

사용 사례: 커밋 전 검사, 수정 후 검증, 빠른 정상 동작 확인 테스트

목적: 코드 품질, 보안, 유지보수성에 대한 종합 감사

기능:

  • 보안 분석 - 취약점 스캔, 자격 증명 노출 감지, 인젝션 위험 평가
  • 아키텍처 리뷰 - 디자인 패턴 검증, SOLID 원칙 준수, 안티패턴 감지
  • 성능 분석 - 알고리즘 복잡도, 리소스 누수, 최적화 기회
  • 문서 리뷰(변경된 파일 대상) - 불명확한 주석이나 명백한 문서 불일치를 표시합니다

리뷰 깊이: Verifier보다 더 철저하며, 병합 전 PR 리뷰에 적합합니다

사용 사례: 기능 완료 리뷰, 보안 감사, 리팩터링 검증


유연한 협업 모드

워크플로에 맞는 자율성 수준을 선택합니다.

  • Auto Run Mode - 잠재적으로 위험한 작업은 알리면서 작업을 자율적으로 실행합니다
  • Manual Accept Mode - 실행 전 모든 변경에 대해 승인이 필요합니다
  • Skip Permissions Mode - 위험한 작업을 포함해 완전히 자율적으로 실행합니다(고급 사용자 전용)

자세한 모드 문서는 실행 모드 및 권한을 참조하세요.


MCP(Model Context Protocol) 연동

외부 도구 및 서비스와의 상호 운용성을 제공합니다.

  • 기존 도구 체인과 커스텀 플러그인을 통해 기능을 확장합니다
  • 서브에이전트와 원활하게 작동하여 분산 작업 실행을 지원합니다
  • 외부 APIs, 데이터베이스, 개발 도구와의 연동을 지원합니다

MCP 설정과 구성은 연동 및 확장을 참조하세요.


추가 기능

지능형 모델 최적화:

Verdent는 복잡도, 성능 요구사항, 비용 고려 사항을 바탕으로 각 작업에 가장 적합한 AI 모델을 자동으로 선택합니다.

기능:

  • 작업 분석 - 작업 복잡도를 평가하여 최적의 모델을 결정합니다
  • 성능 균형 조정 - 속도, 정확도, 비용의 트레이드오프를 고려합니다
  • 컨텍스트 인식 선택 - 프로젝트 규모와 요구사항에 따라 모델 선택을 조정합니다
  • 비용 최적화 - 단순 작업에는 더 가벼운 모델을 사용하고, 복잡한 작업에는 강력한 모델을 배정합니다

이점: 크레딧 사용량을 최소화하면서 효율성을 극대화하여 과도한 지출 없이 최상의 결과를 얻을 수 있습니다.

정밀한 컨텍스트 제어:

채팅에서 @ 멘션을 사용해 특정 파일, 폴더, 코드 섹션을 직접 첨부하여 AI 지원에 필요한 대상 컨텍스트를 제공합니다.

작동 방식:

  • 채팅에 @를 입력하면 사용 가능한 파일과 폴더 목록이 표시됩니다
  • 대화 컨텍스트에 포함할 특정 파일을 선택합니다
  • 더 넓은 컨텍스트를 위해 전체 디렉터리를 참조합니다
  • 특정 코드 섹션이나 문서 페이지를 멘션합니다

사용 사례:

  • 디버깅할 때 AI가 특정 모듈에 집중하도록 합니다
  • 설정을 논의할 때 구성 파일을 포함합니다
  • 기능을 구현할 때 관련 컴포넌트를 참조합니다
  • 정확한 안내를 위해 문서 컨텍스트를 제공합니다

멀티모달 입력:

시각적 요구사항, UI 디자인, 디버깅 상황을 전달하기 위해 이미지를 채팅에 직접 업로드하거나 붙여넣습니다.

지원되는 사용 사례:

  • UI/UX 디자인 - 픽셀 단위로 정확한 구현을 위해 목업, 와이어프레임, 디자인 스크린샷을 업로드합니다
  • 버그 보고 - 더 빠른 진단을 위해 오류 스크린샷이나 시각적 결함을 공유합니다
  • 프런트엔드 개발 - 정확한 스타일링과 레이아웃을 위해 디자인 참고 자료를 제공합니다
  • 문서화 - 다이어그램, 플로차트, 아키텍처 시각화를 포함합니다

기술 사양:

  • 지원 형식: PNG, JPG, JPEG, GIF, BMP, WebP
  • 최대 해상도: 2000×2000픽셀
  • 파일 크기 제한: 5MB(초과 시 자동 압축, 압축 후에도 >5MB이면 오류)

이점: 시각적 요구사항의 모호함을 없애고 프런트엔드 개발 워크플로를 가속합니다.

세션 관리:

대화 기록에 접근하고 관리하여 과거 상호작용, 결정, 구현 세부 정보를 검토합니다.

기능:

  • 세션 로그 - 모든 대화와 AI 응답의 전체 기록
  • 저장소 저장 - 쉽게 접근하고 버전 관리할 수 있도록 프로젝트와 함께 로그를 저장합니다
  • 세션 지우기 - 새로 시작하거나 컨텍스트를 전환할 때 기록을 지웁니다
  • 결정 추적 - 과거 구현 선택의 근거를 검토합니다

이점: 세션 간 연속성을 유지하고, AI 추천을 감사하며, 시간에 따른 프로젝트 변화를 추적할 수 있습니다.

계정 관리:

Verdent 계정, 크레딧, 플러그인 설정을 관리하는 중앙 허브입니다.

사용 가능한 제어 항목:

  • 크레딧 추적 - 일일 크레딧 사용량과 남은 잔액을 모니터링합니다
  • 계정 정보 - 현재 구독 플랜과 프로필 세부 정보를 확인합니다
  • 로그아웃 관리 - 플러그인에서 안전하게 로그아웃하거나 계정을 전환합니다
  • 사용량 모니터링 - 크레딧 소비 패턴을 추적합니다

접근: VS Code의 Verdent 사이드바를 통해 사용할 수 있습니다.

제품 개선:

VS Code에서 직접 피드백, 버그 보고, 기능 요청을 제출하여 Verdent 개선에 기여합니다.

피드백 옵션:

  • 텍스트 메모 - 간단한 텍스트 상자에 문제, 제안, 경험을 설명합니다
  • 직접 제출 - 개발 환경을 떠나지 않고 피드백을 보냅니다
  • 이메일 응답 - 이메일로 후속 연락을 받습니다

보고할 내용:

  • 버그 또는 예상치 못한 동작
  • 기능 요청 또는 워크플로 개선
  • 문서의 누락 또는 불명확한 안내
  • 성능 문제 또는 오류

영향: 피드백은 Verdent의 개발 로드맵에 직접 반영되며 모든 사용자에게 더 나은 경험을 제공하는 데 도움이 됩니다.


함께 보기