다단계 작업 예시

Verdent for VS Code는 복잡한 다단계 작업을 자율적으로 나누는 데 뛰어납니다. 이 가이드는 일반적인 다단계 시나리오의 단계별 워크플로를 제공하며, Verdent가 작업 분해, 의존성 관리, 점진적 실행을 어떻게 처리하는지 정확히 보여줍니다.

복잡한 구현에 Plan Mode 사용하기

Verdent가 코드베이스를 변경하기 전에 상세한 플랜을 검토하고 싶다고 가정해 보겠습니다.

Plan Mode(으)로 전환

인터페이스에서 "Switch Mode" 버튼을 선택하고 "Plan Mode"를 선택합니다.

Plan Mode는 읽기 전용입니다. Verdent는 파일을 수정하거나 명령을 실행하지 않고도 코드를 분석하고, 조사를 수행하고, 플랜을 만들 수 있습니다.

복잡한 요청 제출하기

Refactor this codebase to replace our custom authentication with OAuth 2.0

Verdent가 현재 구현을 철저히 분석합니다.

명확화를 위한 질문에 답하기

Verdent가 불확실성을 줄이기 위해 질문할 수 있습니다.

어떤 OAuth 제공자를 사용해야 하나요?
토큰은 localStorage에 저장해야 하나요, 아니면 쿠키에 저장해야 하나요?
여러 OAuth 제공자를 지원해야 하나요?

이 질문들에 답해 플랜을 다듬습니다.

상세 플랜 검토하기

Verdent가 다음 내용을 포함한 종합 플랜을 제시합니다.

생성할 파일
수정할 기존 파일
논리적 순서에 따른 구현 단계
단계 간 의존성

진행하기 전에 이 플랜을 꼼꼼히 검토합니다.

다음 작업 선택하기

플랜을 검토한 뒤 Verdent가 두 가지 옵션을 제시합니다.

수정을 요청하거나 명확화를 위한 질문을 하려면 Edit을 선택합니다
Agent Mode(으)로 전환해 실행을 시작하려면 Start Building을 선택합니다

빌드를 시작하기 전에 필요한 만큼 플랜을 반복해서 다듬을 수 있습니다.

팁:

여러 파일에 영향을 주는 기능에는 Plan Mode를 사용합니다
접근 방식을 다듬기 위해 플랜 검토를 여러 차례 진행합니다
실행 전에 팀 논의를 위해 플랜을 파일로 저장합니다
Plan Mode는 사용자의 기대와 Verdent가 제안한 해결책이 일치하도록 도와줍니다
플랜 형식 사용자 지정: Settings → Rules → Plan Rules에서 플랜 구조, 상세 수준, 서식 기본값을 제어합니다

큰 기능 요청 나누기

여러 통합 컴포넌트가 포함된 복잡한 전자상거래 결제 시스템을 만든다고 가정해 보겠습니다.

상위 목표 제공하기

Build a complete checkout system with cart management, payment processing, order confirmation, and inventory updates

Verdent가 수행해야 할 일을 분석합니다.

Verdent가 논리적 하위 작업 생성

시스템은 이를 자율적으로 다음과 같이 나눕니다.

장바구니 데이터 모델과 API 생성
상품 추가/삭제/수정이 가능한 장바구니 UI 구축
배송지 주소 양식이 포함된 결제 페이지 구현
결제 게이트웨이 통합(Stripe 또는 구성된 제공자)
주문 확인 페이지 생성
재고 업데이트 로직 추가
이메일 확인 시스템 구현
통합 테스트 작성

각 하위 작업은 명확한 설명과 함께 할 일 목록에 표시됩니다.

Verdent가 의존성을 자동으로 처리

Verdent는 올바른 순서로 하위 작업을 실행합니다.

이를 사용하는 API 엔드포인트보다 먼저 데이터 모델을 생성합니다
이를 호출하는 프런트엔드 컴포넌트보다 먼저 백엔드 엔드포인트를 구축합니다
테스트를 추가하기 전에 핵심 기능을 구현합니다

의존성은 수동 개입 없이 자동으로 관리됩니다.

실시간 진행 상황 모니터링

Verdent가 각 하위 작업을 처리하는 동안 할 일 목록이 실시간으로 업데이트되는 것을 확인합니다. 할 일 항목은 대기 중 → 진행 중 → 완료로 전환됩니다.

팁:

대부분의 작업에서는 Verdent가 자율적으로 분해를 처리하도록 둡니다
실행 전에 분해 내용을 검토하고 싶다면 Plan Mode를 사용합니다
Verdent는 엣지 케이스나 새 요구사항을 만나면 접근 방식을 조정합니다
표시되는 할 일 목록은 다단계 실행 과정을 투명하게 보여줍니다

다단계 리팩터링 프로젝트

큰 코드베이스를 리팩터링하면서 관리 가능한 단계로 접근하고 싶다고 가정해 보겠습니다.

다단계 접근 방식 정의하기

In Plan Mode: Refactor this codebase to replace our custom authentication with OAuth 2.0. I want this done in phases so we can test incrementally.

Verdent가 단계 분해 제안

Verdent가 다단계 플랜을 제안합니다.

1단계: OAuth 라이브러리 추가 및 엔드포인트 구성
2단계: 사용자 모델과 데이터베이스 스키마 업데이트
3단계: 기존 인증 로직 마이그레이션
4단계: 더 이상 사용하지 않는 인증 코드 제거
5단계: 테스트와 문서 업데이트

각 단계는 독립적으로 테스트할 수 있습니다.

단계별로 실행하기

1단계를 승인하고 Verdent가 실행하도록 한 뒤 테스트합니다.

npm test

1단계가 정상 동작하는 것을 확인하면 2단계로 이동합니다.

필요하면 이후 단계 조정하기

1단계에서 배운 내용을 바탕으로 남은 단계의 접근 방식을 조정할 수 있습니다.

For Phase 2, let's also add user role migration to the database schema changes

모든 단계를 점진적으로 완료하기

각 단계 사이에 테스트와 검증을 거치며 모든 단계를 진행합니다. 이를 통해 안전성을 확보하고 방향을 수정할 수 있습니다.

팁:

다단계 리팩터링은 점진적 테스트를 가능하게 해 위험을 줄입니다
각 단계가 끝난 뒤에도 코드베이스는 동작 가능한 상태여야 합니다
필요할 때 쉽게 롤백할 수 있도록 각 단계 후 커밋합니다
이전 단계에서 배운 내용을 바탕으로 이후 단계를 조정합니다

백엔드와 프런트엔드 변경 조율하기

백엔드 API와 프런트엔드 컴포넌트를 함께 업데이트해야 하는 기능을 추가한다고 가정해 보겠습니다.

풀스택 기능 설명하기

Add a commenting system where users can add comments to blog posts. Include backend API, database schema, and frontend UI

Verdent가 백엔드 우선 접근 방식 조율

Verdent는 일반적으로 풀스택 기능을 백엔드부터 작업합니다.

댓글 테이블을 위한 데이터베이스 마이그레이션 생성
댓글 생성을 위한 API 엔드포인트 추가
댓글 조회를 위한 API 엔드포인트 추가
댓글 데이터용 TypeScript 인터페이스 정의
프런트엔드 댓글 양식 컴포넌트 구축
댓글 표시 컴포넌트 생성
프런트엔드를 API 엔드포인트에 연결

Verdent가 일관성 보장

Verdent는 다음을 보장합니다.

프런트엔드 TypeScript 인터페이스가 백엔드 데이터 구조와 일치합니다
API 엔드포인트 URL이 프런트엔드 코드에서 올바르게 참조됩니다
요청/응답 형식이 백엔드와 프런트엔드 사이에서 일치합니다
스택 전반의 오류 처리가 일관됩니다

통합 테스트

Write integration tests for the commenting system covering the full stack

Verdent가 백엔드와 프런트엔드가 함께 올바르게 동작하는지 검증하는 테스트를 만듭니다.

팁:

백엔드 우선 접근 방식은 프런트엔드가 연동할 수 있는 동작 중인 API를 확보해 줍니다
Verdent는 백엔드 코드와 프런트엔드 코드 사이의 일관성을 자동으로 유지합니다
TypeScript 인터페이스는 컴파일 시점에 통합 문제를 찾는 데 도움이 됩니다
통합 테스트는 전체 기능이 처음부터 끝까지 동작하는지 검증합니다

병렬 실행에 서브에이전트 사용하기

동시에 처리할 수 있는 여러 독립 작업이 있다고 가정해 보겠습니다.

병렬화 가능한 작업 식별하기

Generate unit tests for all service classes in the src/services directory

이 테스트 파일들은 서로 독립적이며 병렬로 생성할 수 있습니다.

Verdent가 여러 서브에이전트에 위임

Verdent는 독립 작업을 동시에 처리하기 위해 여러 서브에이전트를 자동으로 사용합니다.

서브에이전트 1: UserService 테스트 생성
서브에이전트 2: PaymentService 테스트 생성
서브에이전트 3: NotificationService 테스트 생성
서브에이전트 4: AuthService 테스트 생성

모든 작업이 병렬로 진행되어 시간을 절약합니다.

결과 통합

각 서브에이전트가 결과를 반환합니다. Verdent가 모든 테스트 파일을 적절한 이름과 구조로 프로젝트에 통합합니다.

순차 검증

병렬 생성이 끝난 뒤 테스트를 순차적으로 실행해 모두 정상 동작하는지 확인합니다.

npm test

팁:

Verdent는 서브에이전트를 사용해 독립 작업을 자동으로 병렬화합니다
결합도가 낮은 작업(별도 테스트 파일, 독립 컴포넌트)은 병렬화의 이점을 얻습니다
결합도가 높은 작업(의존성이 있는 파일)은 정확성을 위해 순차적으로 처리됩니다
병렬 실행은 대규모 변경 속도를 크게 높입니다

자주 묻는 질문

다단계 작업 중간에 Verdent를 멈출 수 있나요?

예. 언제든지 실행을 중단할 수 있습니다. Verdent는 현재 작업 중인 단계를 완료한 뒤 멈춥니다. 그 시점까지의 진행 상황은 보존됩니다. 완료된 내용을 검토하고, 조정한 다음, 계속 진행하거나 다른 접근 방식을 선택할 수 있습니다.

긴 작업에서 Verdent가 지금 무엇을 하는지 어떻게 알 수 있나요?

할 일 목록을 확인합니다. 이 목록은 실시간 상태를 보여주며, 언제든 하나의 항목만 "in progress"로 표시됩니다. 활성 항목은 Verdent가 현재 정확히 무엇을 작업 중인지 보여줍니다. 완료된 항목은 완료로 표시되고, 대기 중인 항목은 남은 작업을 보여줍니다.

Verdent가 제 작업을 나눈 방식이 마음에 들지 않으면 어떻게 하나요?

실행 전에 Plan Mode를 사용해 분해 내용을 검토하고 조정합니다. Plan Mode에서 "프런트엔드 작업을 별도 컴포넌트로 나눠 주세요" 또는 "저 두 단계를 합쳐 주세요"처럼 피드백을 제공할 수 있습니다. 코드가 작성되기 전에 Verdent가 입력을 바탕으로 플랜을 수정합니다.

모든 다단계 작업에 Plan Mode를 사용해야 하나요?

반드시 그렇지는 않습니다. 많은 파일에 영향을 주는 복잡한 기능, 큰 리팩터링, 또는 접근 방식을 먼저 검토하고 싶을 때 Plan Mode를 사용합니다. 익숙하고 단순한 작업의 경우 Verdent가 실시간 할 일 목록 가시성과 함께 바로 실행할 수 있습니다. Plan Mode는 위험도가 높은 변경에 검토 단계를 추가합니다.

실행이 시작된 뒤 Verdent의 플랜을 수정할 수 있나요?

Verdent가 작업하는 동안 수정 지침을 제공할 수 있습니다. "실제로는 API 연동에 다른 접근 방식을 사용해 주세요"라고 말하면 Verdent가 남은 단계를 조정합니다. 큰 플랜 변경의 경우 멈춘 뒤 완료된 내용을 커밋하고, 수정된 접근 방식으로 새 세션을 시작하는 편이 좋습니다.