field-test

Nova Field Test

실제 프로젝트에 서브에이전트를 파견하여 Nova 커맨드를 사용하게 하고, 마찰 포인트를 수집한다.

핵심 원칙

• 오케스트레이터는 코드에 개입하지 않는다. 관찰자 역할만 한다.
• 서브에이전트에게 자연어로 지시한다. 실제 팀원에게 말하듯이.
• 워크트리로 격리한다. 테스트 후 삭제하여 흔적을 남기지 않는다.
• Nova 개선 포인트 수집이 목적이다. 코드 품질 자체가 목적이 아니다.

Execution

Phase 1: 프로젝트 설정 (인터랙티브)

사용자에게 순서대로 질문한다:

Q1: "몇 개 프로젝트로 필드 테스트를 진행할까요?"

사용자가 개수를 답하면, 각 프로젝트별로 반복:

Q2: "프로젝트 {N}/{총개수}의 경로를 알려주세요."

Q3: "이 프로젝트에서 어떤 작업을 시켜볼까요? 아래에서 골라도 되고, 자유롭게 말씀해도 됩니다."

시나리오 메뉴를 제시한다:

1. 탐색 + 리뷰 — "코드 전체적으로 훑어보고 개선점 찾아봐"
2. 레거시 정리 — "오래된 코드 찾아서 리팩토링해봐"
3. 기능 구현 — "TODO/FIXME 하나 골라서 구현해봐"
4. 검증 — "기존 코드 테스트 돌리고 갭 분석해봐"
5. 설계 — "새 기능 하나 기획해서 plan → design까지"
6. 자유 — 직접 지시 입력
7. 알아서 — 프로젝트 상태 보고 자동 판단

모든 프로젝트 설정이 끝나면 확인 요약을 보여주고 승인을 받는다:

━━━ Field Test 설정 확인 ━━━
  1. zippit/ — 레거시 정리
  2. ccm-hub/ — 탐색 + 리뷰
  3. planreview/ — 기능 구현

  진행할까요? (y/n)
━━━━━━━━━━━━━━━━━━━━━━━━━━━

Phase 2: 워크트리 생성

각 대상 프로젝트 레포에서 워크트리를 생성한다.

기존 워크트리 재사용: EnterWorktree 도구의 path 파라미터를 활용하여, 이전 필드 테스트에서 생성한 워크트리가 남아있으면 새로 생성하지 않고 재사용한다.

# 기존 워크트리 확인
EXISTING=$(git -C {프로젝트_경로} worktree list | grep "nova-field-test" | awk '{print $1}')

if [ -n "$EXISTING" ]; then
  # 기존 워크트리 재사용 (EnterWorktree path 파라미터 활용)
  cd "$EXISTING"
else
  # 새 워크트리 생성
  cd {프로젝트_경로}
  git worktree add /tmp/nova-field-test-{프로젝트명}-{timestamp} -b nova-field-test-{timestamp}
fi

워크트리 생성 실패 시 해당 프로젝트는 건너뛰고 사유를 기록한다.

Phase 3: 서브에이전트 파견

각 프로젝트별로 서브에이전트를 생성한다. 병렬 실행한다.

서브에이전트 지시 원칙

1. 자연어로 말한다 — 커맨드를 나열하지 않는다
2. 목적을 설명한다 — "Nova 커맨드 써봐"가 아니라 "코드 좀 봐줘"
3. 자유도를 준다 — 구체적 파일/라인을 지정하지 않는다
4. Nova 사용을 유도하되 강제하지 않는다 — "필요하면 리뷰도 돌려봐" 정도

시나리오별 지시 템플릿

각 시나리오에 대해 아래 템플릿을 기반으로 자연어 지시를 생성한다. 그대로 복사하지 말고, 프로젝트 상태에 맞게 변형한다.

탐색 + 리뷰:

"{프로젝트명} 프로젝트를 맡게 됐어. 전체 구조를 파악하고 코드 품질이 어떤지 봐줘. 개선할 점이 보이면 리뷰 돌려서 정리해줘. 큰 문제 있으면 알려주고."

레거시 정리:

"이 프로젝트에 오래된 코드가 좀 있을 거야. 훑어보고 레거시 느낌나는 부분 찾아줘. 정리할 수 있는 건 정리하고, 큰 건 계획만 세워줘. 끝나면 리뷰 한번 돌려봐."

기능 구현:

"코드에 TODO나 FIXME가 있을 텐데, 하나 골라서 구현해봐. 너무 큰 거 말고 적당한 거로. 끝나면 검증까지 해줘."