Orca IDE로 Claude Code·Codex 병렬 워크트리 운영하기

Orca는 새 모델이 아니라, 여러 에이전트를 보는 운영층입니다

병렬 작업의 기본 단위 — 작업 분해, 작성자, 검증자, 통합

# 기준 저장소 위치를 기억하고 작성자 작업공간을 분리합니다.
BASE_WORKTREE=$(pwd)
git worktree add ../edu-orca-content -b feature/orca-content

# 작성자 작업공간: 콘텐츠·구현만 담당
cd ../edu-orca-content

# 검증 작업공간은 작성자가 변경을 검증하고 커밋한 뒤 만듭니다.
# 그래야 검증자가 작성 결과를 실제로 볼 수 있습니다.

# 실제 고객 파일, 비밀값, 운영 계정은 이 실습에 넣지 않습니다.

실습 준비 — 비식별 샌드박스와 세 가지 운영 문서

mkdir -p training/orca-parallel-lab
cd training/orca-parallel-lab

cat > sandbox-brief.md <<'EOF'
# 병렬 운영 실습 브리프 (비식별)

- 대상: 가상의 교육 페이지 문구와 샘플 테스트
- 실제 고객사·사건·개인정보·계정정보: 사용하지 않음
- 실제 발송·게시·결제·권한변경·운영 DB 변경: 하지 않음
- 작성자 A: 강의 문구 초안
- 작성자 B: 링크·메타데이터 점검
- 검증자: 요구사항·테스트·diff 검토
- 통합자: 검증 통과 항목만 기준 브랜치에 반영
EOF

touch parallel-task-plan.md worktree-review.md integration-decision.md

Claude Code와 Codex에 주는 역할별 프롬프트

# Claude Code — 작성자 프롬프트
현재 워크트리에서 sandbox-brief.md와 AGENTS.md를 읽고,
parallel-task-plan.md를 작성해 주세요.

필수 항목:
- 작업을 서로 겹치지 않는 2~3개 단위로 분해
- 각 단위의 담당 에이전트, 수정 가능 파일, 금지 파일
- 완료 기준과 검증 명령
- 외부 부작용(발송·게시·삭제·결제·권한변경)은 실행하지 않는 중단선

비식별 샘플만 사용하고, 실제 계정·고객 자료·비밀값을 읽거나 만들지 마세요.

# 터미널 — 작성 결과를 검증하고 커밋한 뒤 작성자 워크트리 루트로 돌아갑니다.
git status --short
git diff --check &&
npm --prefix ../.. test &&
git add . &&
git commit -m "검증할 병렬 운영 계획을 남긴다"
cd ../..

# 작성자 커밋에서 검증자 작업공간을 만듭니다.
git worktree add ../edu-orca-verify -b review/orca-content feature/orca-content
cd ../edu-orca-verify
cd training/orca-parallel-lab

# Codex — 독립 검증자 프롬프트
현재 워크트리에서 sandbox-brief.md와 parallel-task-plan.md를 읽고,
worktree-review.md 초안을 작성해 주세요.

확인할 항목:
- 파일 소유권이 겹치지 않는가
- 완료 기준이 테스트 가능한가
- 실제 고객 자료·비밀값·외부 부작용 위험이 없는가
- 작성자와 검증자의 역할이 분리됐는가
- 통합 전 반드시 확인할 diff와 테스트는 무엇인가
- 프로젝트 테스트 명령을 실제로 실행했고 결과를 기록했는가

코드를 수정하거나 외부 서비스에 접속하지 말고, 근거와 보류 사유만 기록하세요.

Orca에서 보는 화면과 브라우저·디자인 모드의 역할

통합 전 검토와 의사결정 기록

# 검증자 워크트리에서 기준 브랜치와 작성 결과를 비교합니다.
BASE_COMMIT=$(git rev-parse main)
git diff --check "$BASE_COMMIT"..HEAD &&
npm --prefix ../.. test
git diff --stat "$BASE_COMMIT"..HEAD
git log --oneline "$BASE_COMMIT"..HEAD

# Codex가 작성한 검증 기록과 작업 중 변경을 확인합니다.
git diff --check
git status --short
git diff -- worktree-review.md

# 통합자가 검증 기록을 읽고 실제 결정을 채웁니다.
cat > integration-decision.md <<'EOF'
# 통합 결정

- 결정일:
- 통합 대상:
- 결정: 통합 / 보류 / 되돌림
- 근거: 요구사항 충족, 테스트, diff 검토 결과
- 보류 또는 되돌림 사유:
- 다음 확인:
EOF

사람의 통합 승인 후에만 실행합니다

# worktree-review.md와 integration-decision.md를 사람이 먼저 완성합니다.
# integration-decision.md의 결정 줄은 정확히 "- 결정: 통합"으로 적습니다.

test -n "$BASE_WORKTREE" &&
test -s worktree-review.md &&
rg -q '^- 결정: 통합$' integration-decision.md &&
git diff --check &&
npm --prefix ../.. test &&
git add worktree-review.md integration-decision.md &&
git commit -m "병렬 작업의 검증과 통합 판단을 남긴다" &&
cd "$BASE_WORKTREE" &&
git merge --no-ff review/orca-content &&
npm test &&
git status --short

자동화와 모바일은 관제를 보조할 뿐, 책임을 넘기지 않습니다

공식 자료와 입문 강의 연결