레스토랑 데모 오케스트레이터은(는) 무엇을 하나요?

리드 접수부터 로컬에서 검증된 비공개 데모까지 재개 가능한 작업 주문을 실행합니다. 이 Skill과 메인 에이전트를 제어 평면으로 취급하고, 세 개의 제한된 워커 에이전트와 네 개의 전담 Skill을 실행 평면으로 사용합니다.

단계 모델, 아티팩트 종류 또는 전환 규칙을 변경하기 전에 references/orchestration-contract.md를 읽으십시오.

작업 주문 시작 또는 재개

브라우징 전에 프로젝트 컨텍스트를 읽고 로컬 리드 데이터를 검사합니다.
scripts/workflow.py init으로 작업 주문을 초기화합니다. 가능할 때 Sheet 행, Place ID, Maps URL 및 로컬 리드 스냅샷을 시드합니다.
scripts/workflow.py resume을 실행하여 모든 활성 또는 의존성 준비 단계, 워커 레인, 할당된 Skill, 예상 아티팩트 및 단계별 프롬프트를 가져옵니다.
메인 에이전트에서 접수, 리서치, 디자인 잠금 및 이미지 슬롯을 완료한 후 분기합니다.
하위 에이전트를 사용할 수 있을 때 하나의 디자인 워커, 하나의 푸드 워커 및 하나의 외관 워커를 생성합니다. 의존성 준비가 된 세 개의 레인을 함께 시작합니다. 각 워커는 실제 아티팩트를 기록하고 할당된 단계만 passed, blocked 또는 선택적 분기의 경우 skipped(이유 포함)로 표시합니다.
모든 워커를 조인합니다. 메인 에이전트는 계약 검증을 실행하고, 워커 출력을 통합하며, 충돌을 해결하고, 최종 QA를 수행한 후 비공개 데모를 기록합니다.
전환 후 scripts/workflow.py validate를 실행합니다. 팔레트, 푸드 또는 외관 매니페스트가 통과한 후 --run-contracts를 사용합니다.
private_demo가 통과하거나 증거가 진정한 차단 요소를 생성할 때까지 반복합니다. 하위 에이전트를 사용할 수 없는 경우 동일한 레인을 순차적으로 실행하고 단계 노트에 폴백을 기록합니다.

사용자에게 각 Skill을 개별적으로 호출하도록 요청하지 마십시오. 사용자가 데모를 빌드, 실행, 계속 또는 재개하라고 말하면 동일한 태스크에서 차단되지 않은 모든 단계를 계속 진행하십시오. 전문화된 Skill을 전환할 때 간결한 진행 업데이트를 제공하십시오.

전문화자 경계 유지

오케스트레이터 내에서 작업을 재현하는 대신 할당된 Skill을 사용하십시오.

research, design_lock, image_slots, site_design, implementation, qa: $restaurant-demo-builder
brand_palette: $restaurant-brand-palette
food_images: $restaurant-food-image-studio
exterior_image: $restaurant-exterior-image-studio
intake, private_demo: 이 Skill

전문화자 단계를 디스패치하기 전에 메인 에이전트는 해당 Skill을 완전히 읽어야 합니다. 각 워커도 할당된 Skill을 읽고 해당 Skill의 증거 및 검증 게이트를 따라야 합니다. 단계는 필수 아티팩트가 존재할 때만 통과할 수 있습니다. 워크플로우가 기록한 전문화자 매니페스트 상태는 전문화자 검증기를 절대 재정의하지 않습니다.

병렬 에이전트 계약

다음 격리된 레인에서 최대 세 개의 워커 에이전트를 사용하십시오.

design: brand_palette를 실행한 후 계약에서 정의된 이미지 플레이스홀더로 반응형 site_design 셸을 생성합니다. 팔레트/잠금/핸드오프 파일과 사이트 셸을 작성합니다. 워커 이미지 출력을 통합하거나 최종 QA를 수행하지 마십시오.
food: food_images를 실행합니다. 푸드 이미지 스튜디오 작업 주문과 매니페스트만 작성합니다. 사이트 셸이나 최종 데모를 편집하지 마십시오.
exterior: exterior_image를 실행합니다. 외관 이미지 스튜디오 작업 주문과 매니페스트만 작성합니다. 사이트 셸이나 최종 데모를 편집하지 마십시오.

메인 에이전트는 접수, 리서치, 모든 레인이 공유하는 잠금, 최종 implementation, QA, 리포지토리 작업, 게시 결정 및 사용자 핸드오프를 소유합니다. 메인 에이전트만 선택된 워커 자산을 최종 데모에 복사하고, 카피/레이아웃/자산 충돌을 조정하거나 데모 준비 완료를 선언할 수 있습니다.

워커는 workflow.py set-stage를 통해 자체 워크플로우 단계를 업데이트할 수 있습니다. 상태 도구는 동시 쓰기를 직렬화합니다. 워커는 다른 레인의 파일이나 상태를 편집해서는 안 됩니다. 워커 완료 시 메시지만 신뢰하는 대신 실제 아티팩트를 검사하고 검증기를 실행하십시오.

단계 규칙

다음 순서를 따르십시오.

intake
  -> research
  -> design_lock
  -> image_slots
  -> [design: brand_palette -> site_design]
     [food: food_images]                 (병렬)
     [exterior: exterior_image]
  -> implementation by main agent
  -> qa
  -> private_demo

food_images와 exterior_image는 결정 분기지, 묵시적 생략이 아닙니다. 적격 자산이 생성되면 통과시키고, 페이지가 텍스트 중심으로 남거나 외관이 도착 가치를 추가하지 않을 때는 증거 기반 이유와 함께 건너뜁니다. brand_palette는 절대 건너뛰지 마십시오. 레스토랑 증거가 브랜드 기반 팔레트를 지원할 수 없을 때 명시적으로 레이블이 지정된 Recipe 폴백을 사용하십시오.

다음 상태만 사용하십시오. 의존성 독립적인 워커 단계는 최대 세 개까지 in_progress일 수 있지만, 워커 레인당 하나씩만 가능하며 메인 에이전트 단계는 워커 단계와 중복될 수 없습니다.

pending: 시작되지 않음
in_progress: 활발히 실행 중, 한 번에 하나의 단계만 가능
passed: 의존성, 아티팩트 및 관련 검증기 통과
blocked: 진행 불가, 구체적인 차단 요소 기록
skipped: 선택적 분기를 의도적으로 생략, 이유 기록

워크플로우를 진행하기 위해 불완전한 작업을 passed로 표시하지 마십시오. 증거나 출력이 변경되면 --reopen으로 터미널 단계를 다시 여십시오.

명령어

<orchestrator-skill>을 설치된 이 Skill 폴더로 바꾸십시오. 레스토랑 프로젝트 디렉토리에서 작업 주문 명령어를 실행하십시오.

초기화:

python3 <orchestrator-skill>/scripts/workflow.py init \
  --project-root . \
  --restaurant "레스토랑 이름" \
  --slug restaurant-name \
  --place-id "PLACE_ID" \
  --maps-url "GOOGLE_MAPS_URL" \
  --lead-json output/leads.json \
  --source-sheet-id "SHEET_ID" \
  --source-sheet-title "Sheet 제목" \
  --source-tab Sheet1 \
  --source-row 28 \
  --sheet-checked-at 2026-07-13

검사 및 재개; resume은 분기 후 여러 실행 가능한 단계를 반환할 수 있습니다.

python3 <orchestrator-skill>/scripts/workflow.py status \
  --workflow orchestration/restaurant-name/workflow.json

python3 <orchestrator-skill>/scripts/workflow.py resume \
  --workflow orchestration/restaurant-name/workflow.json

단계 기록:

python3 <orchestrator-skill>/scripts/workflow.py set-stage \
  --workflow orchestration/restaurant-name/workflow.json \
  --stage research --status passed \
  --artifact research_record=orchestration/restaurant-name/research/RESEARCH.md \
  --artifact restaurant_profile=orchestration/restaurant-name/research/restaurant-profile.json

검증:

python3 <orchestrator-skill>/scripts/workflow.py validate \
  --workflow orchestration/restaurant-name/workflow.json --run-contracts

가드레일

모든 새 작업 주문은 기본적으로 private-local로 유지하십시오.
자동 배포, 업로드, 이메일, Messenger 또는 아웃리치 명령어를 추가하지 마십시오.
확인된 사실, 스냅샷 사실, 추론, 창의적 결정 및 미해결 질문을 구분하여 유지하십시오.
페이지에서 사용하기 전에 현재 영업 시간, 메뉴, 평점, 리뷰 수, 웹사이트 상태, 서비스 및 연락처 링크를 다시 확인하십시오.
작업 주문에 비밀, 서비스 계정 파일, 토큰 또는 개인 자격 증명을 배치하지 마십시오.
private_demo에서 멈추십시오. 게시 및 아웃리치는 별도의 명시적인 사용자 승인이 필요합니다.

핸드오프

작업 주문 경로, 현재 단계, 사용 가능한 경우 로컬 데모 경로 또는 URL, 검증 결과, 차단 요소, 소유자 확인 항목 및 게시 허가 공백을 보고하십시오. 별도로 승인되지 않는 한 게시 또는 아웃리치가 발생하지 않았음을 명시적으로 밝히십시오.

레스토랑 데모 오케스트레이터