초안 작성, 수정 또는 답변 전에 작성 가이드와 컬렉션 규칙을 읽으십시오; 컬렉션의 체크아웃에는 shared/ 아래에 두 파일이 모두 있습니다.
비디오 반복 오케스트레이션
스킬 유형: 엄격 — 티켓 범위, 중단된 작업, 의존성 계보 및 증거 게이트를 보존합니다. 일반적인 실패는 복구 절차로 전환되며 구현 시도를 종료하지 않습니다.
목적 및 소유권
Jira 에픽, GitHub 이슈 큐 또는 명시적 요구사항 목록(선택적으로 명명된 티켓으로 좁힐 수 있음)을 내구성 있는 전달 큐로 전환합니다. 각 선택된 티켓 또는 수정 사항은 전용 구현 에이전트와 작업 트리를 받습니다. 디스패치 전에 오케스트레이터는 백엔드 전용, 프론트엔드 전용 또는 교차 계층 범위를 선택하고 완전한 실행 계약을 제공합니다. 모든 구현 에이전트는 video-iterative-development를 사용하여 해당 계약을 실행하고 검증된 제출물을 생성합니다.
오케스트레이터는 결정 권한이 아닌 실행을 위임합니다. 이는 소스 해석, 티켓 범위, 제품 동작, 저장소 및 계층 선택, 의존성 순서, 브랜치 및 PR 구조, 편차, 블로커 처리, 라이프사이클 상태, 최종 승인, 티켓 보고를 독점적으로 소유합니다. 오케스트레이터는 동반 기능을 호출할 뿐 다시 설명하지 않습니다:
resume-and-reconcile.md는 중단된 작업 발견 및 매핑된 소스 변경 감지를 소유합니다.extract-figma-visuals는 Figma 계층 선택, 내보내기 및 번들 검증을 소유합니다.feature-conformance는 소스 권위, 결정 기록, 추적 가능성 및 전달 청구 검증을 소유합니다.video-iterative-development는 할당된 구현, 복구 메커니즘, 증거 및 제출을 소유합니다. 관찰 및 구조화된 결정 요청을 반환하며, 실행 계약을 변경하거나 전달 상태를 할당하지 않습니다.agent-implementation-reviewer는 독립적인 읽기 전용 계획-대-차이 보고서를 소유합니다. 오케스트레이터는 해당 공유 검토자를 변경하지 않고 기능 계약 어댑터를 적용합니다.- 엔지니어링 지침 검토는 최종 차이점을 적용 가능한 저장소 규칙과 비교하여 검사합니다. 선호도를 새로운 티켓 요구사항으로 전환하지 않고 구체적인 결과와 정당화된 예외를 기록합니다.
결정 권한
중대한 결정은 소스 해석, 범위, 제품 또는 디자인 동작, 참여 저장소 또는 계층, 의존성 순서, 브랜치 또는 PR 구조, 필수 증거, 승인된 편차, 블로커 처리 또는 최종 티켓 상태를 변경하는 모든 선택입니다. 오케스트레이터는 디스패치 전이나 작업자 요청에 응답하여 모든 중대한 결정을 내리고 기록합니다. 이 스킬에 의해 승인된 자동 소스 해결도 오케스트레이터 결정입니다.
구현 에이전트는 실행 계약을 변경하지 않는 되돌릴 수 있고 저장소 관례적인 메커니즘(예: 로컬 코드 구성, 명령 순서, 결정적 선택기 세부 사항, 또는 범위 내 실패 진단 및 재시도 방법)만 선택할 수 있습니다. 지침이 불완전하거나 충돌하거나 중대한 선택이 필요한 경우, 작업자는 추측하거나 범위를 확장하거나 프롬프터에게 연락하거나 스스로 최종 상태를 할당해서는 안 됩니다. 구조화된 decision_request를 오케스트레이터에 반환하고 영향을 받지 않는 모든 할당 작업을 계속합니다.
입력
- Jira 에픽 키/링크, GitHub 이슈 큐, 또는 명시적 우선순위 요구사항 목록. 요청에서 선택된 큐를 해결하고, GitHub 또는 추적기 중립 실행에 Jira를 요구하지 마십시오.
- 수정 모드의 경우, 읽기 전용 결과 Markdown 문서.
- 작업 공간에서 발견할 수 없는 저장소 루트.
- 선택적 읽기 전용 디자인 문서 또는 링크. 아키텍처는 문서 하위 유형일 뿐 별도의 입력 범주가 아닙니다.
- 적용 가능한 UI 티켓에 대해
node-id를 포함하는 선택적 읽기 전용 Figma 루트 프레임 링크. - Slack을 통한 실행 조정 요청(명시적으로 명명된 단일 채널 또는 직접 메시지 실행 요청 포함). 대상이 없으면
slack-coordinator는 저장소 기본값을 사용합니다. - 명시적 외부 권한 또는 마감일.
기능 ID, 계약 파일, 승인 플래그, Figma 개정 또는 계층 분류를 요청하지 마십시오. 선택적 Figma 또는 디자인 문서 컨텍스트가 누락되어도 블로커가 아닙니다.
Slack 조정이 요청된 경우, 오케스트레이션의 일부로 slack-coordinator를 직접 호출하고 별도의 Slack 에이전트 또는 창을 생성하지 마십시오. 오케스트레이션에 하나의 Slack 실행 및 스레드를 사용하십시오. 오케스트레이터는 유일한 Slack 연락 창구이자 run_id의 유일한 소비자입니다; 구현 에이전트는 오케스트레이터에 보고하고 코디네이터를 호출하거나 소유자 입력을 직접 소비하지 않습니다.
읽기 전용 인테이크가 에픽과 선택된 티켓을 해결한 후, 활성 코디네이터 run_id에 대한 기존 원장을 검사하십시오. 있으면 해당 실행을 재개하십시오. 그렇지 않으면 실행 파일을 사용할 수 있는지 확인하고 첫 번째 상태 변경 작업 전에 run start를 호출하되, 작업을 에픽으로, 목표를 요청된 결과로, 범위를 선택된 티켓으로 설정하십시오. --channel은 현재 지침에 명시적으로 명명된 단일 채널에 대해서만 전달하고, --dm은 프롬프터가 직접 메시지 실행을 명시적으로 요청할 때만 전달하며, 그렇지 않으면 코디네이터가 저장소 기본값을 사용하도록 하십시오. 반환된 run_id, 채널, 스레드 타임스탬프 및 퍼머링크를 첫 번째 허용된 쓰기 시점에 원장에 기록하십시오. 단지 티켓이 시작, 재개, 재시도 또는 소유자를 변경했다고 해서 두 번째 코디네이터 실행을 시작하지 마십시오.
모든 오케스트레이터 상태 변경 작업 직전과 구현 작업을 승인하는 각 디스패치 또는 후속 조치 직전에 run check를 실행하십시오. 종료 코드 0은 작업을 허용합니다. 종료 코드 10에서는 run resolve로 소유자 입력을 적용, 답변 또는 거부한 후 다시 확인하십시오. 종료 코드 11에서는 일시 중지하고, 잠시 대기 후 재시도하며 이유를 보고하십시오; 조정을 사용할 수 없는 동안 상태를 변경하거나, 작업을 디스패치하거나, 다른 Slack 경로로 대체하지 마십시오. 종료 코드 12는 운영자의 명시적인 비상 결정이며 추가 Slack 호출 없이 실행을 계속할 수 있습니다.
오케스트레이션 단계 변경, 티켓 라이프사이클 변경, 블로커 시작 또는 해제에 run event를 사용하십시오; 데몬은 조용한 간격 상태 재게시를 소유합니다. 오케스트레이션이 최종 완료, 실패 또는 취소된 결과에 도달하면 run finish를 한 번 호출하십시오. 명령, 채널 선택, 메시지 및 실패 계약에 대한 독립형 스킬의 규칙을 준수하고 여기서 약화시키지 마십시오. Slack 조정이 요청되지 않은 경우 실행을 시작하지 말고 Slack 게이트를 추가하지 마십시오.
실행 모드 선택
결과 없이 전달 모드를 사용하십시오: Jira의 경우 Jira 전달 워크플로를 읽고, GitHub 및 추적기 중립 큐의 경우 전달 모드를 읽으십시오. 선택된 큐에 결과 문서가 포함된 경우 수정 모드를 사용하십시오. 수정 워크플로를 읽으십시오.
어느 모드에서든 작업 트리를 생성하기 전에 재개 및 소스 조정을 실행하십시오. Jira의 경우 상태가 결정적입니다: In Progress 및 Code Review는 resume_required이며 기본에서 시작하는 대신 기존 작업을 채택해야 합니다.
티켓 범위 및 디자인 권한
선택된 티켓의 요구사항 및 승인 기준이 작업 경계를 정의합니다. 에픽은 구성원, 순서 및 의존성 컨텍스트를 제공합니다; Figma 또는 디자인 문서에 표시된 모든 동작을 포함한다고 가정하지 마십시오. 선택된 티켓을 명확히 하는 Figma 노드 및 문서 섹션만 매핑하십시오. 매핑되지 않은 디자인 내용은 컨텍스트일 뿐 누락, 연기 또는 범위를 벗어난 작업이 아닙니다.
티켓 경계 내에서:
- 매핑된 Figma는 시각 및 상호 작용 동작(모호하거나 충돌하는 티켓 세부 사항 포함)에 대한 기본 권한입니다.
- 매핑된 Figma는 충돌하는 디자인 문서를 자동으로 재정의합니다.
- 적용 가능한 Figma가 없는 경우, 매핑된 디자인 문서가 모호한 티켓 세부 사항을 해결합니다.
- 저장소 및 API 규칙이 나머지 구현 세부 사항을 해결합니다.
각 자동 해결을 .agent-evidence/orchestration/<run-id>/decision-log.md에 기록하십시오. 대안이 제품 범위나 사용자 동작을 실질적으로 변경하는 드문 해결되지 않은 선택에 대해서만 영향을 받는 티켓을 일시 중지하십시오. 권위 있는 소스에서 명시적으로 승인된 이탈은 approved_deviation입니다; 일반적인 구현 결정 및 Figma 해결은 편차가 아닙니다.
.agent-evidence/orchestration/<run-id>/design-documents/manifest.json에 실행 수준 디자인 문서 매니페스트를 하나 생성하십시오. 소스 ID, 전체 문서 SHA-256, 그리고 선택된 티켓에 매핑된 섹션의 안정적인 ID, 제목 및 SHA-256 값만 기록합니다. feature-conformance는 이 매니페스트를 참조하며 다른 매니페스트를 생성하지 않습니다.
제공된 각 UI 루트에 대해 디스패치 전에 extract-figma-visuals를 호출하고 검증된 번들을 적용 가능한 작업자에게 전달하십시오. 액세스 확인 후에도 읽을 수 없고 실질적으로 다른 재시도에도 동일한 Jira, Figma 또는 디자인 문서 소스는 영향을 받는 티켓만 차단합니다. 오래된 콘텐츠, 재생성된 모형 또는 추측된 요구사항으로 대체하지 마십시오.
실행 상태 설정
디스패치 전:
- 선택된 에픽 작업에 대해 하나의 목표를 생성하거나 계속하십시오. 티켓에 복구 가능하거나 독립적인 작업이 있는 동안 활성 상태를 유지하십시오.
- 저장소 지침, 현재 상태, 작업 트리, 티켓 브랜치, 열린 PR, 생성된 코드 규칙 및 문서화된 확인 명령을 검사하십시오. 기존 PR의 경우 소스 작업 트리와 해당 작업 트리를 사용할 수 없는 이유를 식별하십시오. 교차 계층 작업의 경우 참여 저장소의 문서화된 복합 실행 구성을 완전한 프로세스 토폴로지로 해결하십시오: 모든 명령, 인수, 작업 디렉터리, 환경 소스, 의존성 순서, 포트, 상태/기능 프로브, 마이그레이션/픽스처 단계, 클라이언트 생성 단계, 런타임 정의 및 Android Patrol 명령. 선택된 작업 트리, 확인 명령 및 해결된 토폴로지를 구현 에이전트에 전달하십시오. 저장소에 문서화된 IDE 복합은 토폴로지 정의일 뿐 IDE를 호출하라는 지침이 아닙니다.
- 선택된 추적기의 인증된 인터페이스를 통해 티켓 및 의존성을 해결한 다음 재개/소스 조정을 실행하십시오. Jira는 Jira MCP를 사용합니다; GitHub 또는 명시적 목록 실행은 자체 범위 및 상태 권한을 유지합니다.
- 적용 가능한 Figma 번들을 추출하고 검증하십시오. 제공된 경우 단일 디자인 문서 매니페스트를 생성하십시오.
feature-conformance를 사전 점검 모드로 호출하십시오. 에이전트 생성 스키마 또는 매핑 오류를 수정하고 다시 실행하십시오; 티켓 차단기로 제시하지 마십시오.- 명시적 작업 디렉터리 또는 구성된 작업 루트를 해결하십시오. 아래 설명된 대로 불변 인덱스 영수증을 사용하십시오. 무시된 원장,
decision-log.md, 및 재구성 가능한resume-state.json및source-index.json캐시를 생성하십시오. 캐시가 없거나 오래된 경우 Jira, Git, PR, 현재 매니페스트 및 현재 소스 읽기가 권위를 유지합니다. - 의존성 테이블을 작성하고 소유자, 선택된 범위 및 변경되지 않은 계층, 채택 또는 새 쓰기 표면, PR 대상, 소스 매핑, 계약 행, 오케스트레이터 결정, 증거 게이트, 표준 런타임 임대 상태, 복구 상태 및 최종 상태를 기록하십시오. Slack 조정이 활성화된 경우 실행 수준에서
run_id, 채널, 스레드 타임스탬프, 퍼머링크 및 현재 조정 상태도 기록하십시오.
표준 snake_case 기계 상태 사용: ready, waiting, resume_required, resume_needs_lineage, resume_source_missing, active, source_update_detected, reconciliation_active, correction_active, needs_product_decision, locally_verified, submitted, submitted_verified, blocked.
인덱스된 기록 및 증명 보존
index.json은 작업 아티팩트에 대해 권위 있습니다. 계약 영수증을 feature-contract (design.contract), 적합성을 feature-conformance (review.conformance), 제안된 차단기를 delivery-disposition (delivery.disposition), 검증된 제출 영수증을 submission-closure (delivery.closure)로 기록하십시오. 모든 내구성 개정에 대해 새로운 불변 반복을 할당하고 정확한 JSON 스냅샷 경로/해시, 티켓, 소스 헤드 및 관련 계약/검토 기록을 바인딩하십시오. 사용하기 전에 현재 기록을 선택하고 다이제스트 검증하십시오; 잘못된 인덱스는 스캔으로 대체되지 않습니다. 인접한 선택적 작업 아티팩트 도우미 또는 정확한 수동 규칙을 사용하십시오. 진정으로 인덱싱되지 않은 레거시 작업만 번호가 매겨진 기록을 사용합니다.
실행 원장, 재개 인벤토리 및 소스 인덱스는 재구성 가능한 운영 캐시일 뿐 불변 승인 또는 검토 영수증을 대체하지 않습니다. 원시 시각적 번들과 캡처는 제외된 로컬 증거로 유지됩니다. GitHub PR 본문, 별도의 증거 댓글, 직접 호스팅된 캡처 및 현재 헤드 읽기백은 게시 권한으로 유지됩니다; 설치된 게시 후크 또는 기준/현재 증명 요구 사항을 약화시키지 마십시오.
티켓 작업 격리 및 스태킹
각 활성 구현 에이전트에게 수정하는 모든 저장소에서 하나의 독점 작업 트리와 브랜치를 제공하십시오. 변경 가능한 체크아웃을 공유하거나 중단된 변경 사항을 폐기하지 마십시오.
In Progress및Code Review티켓의 경우 해당 티켓에 속하는 변경 사항이 있는 더티 작업 트리를 포함하여 선택된 소스를 채택하십시오.- 채택된 작업이 없는 적격 티켓에 대해서만 새 작업을 생성하십시오.
- 전제 조건의 검증된 제출된 원격 헤드에서 종속 브랜치를 생성하십시오.
- 종속 PR을 해당 사전 조건 브랜치로 대상으로 지정하여 PR에 해당 티켓의 델타만 포함되도록 하십시오. 스택된 계보를 기록하십시오.
- 기존 수정 PR 소스 브랜치 및 PR을 재사용하십시오. 이전 작업 트리를 사용할 수 없는 경우에만 해당 정확한 브랜치의 체크아웃을 다시 생성하십시오.
- 중단된 작업을 단순히 설정을 단순화하기 위해 재설정, 정리, 스태시, 강제 푸시 또는 다시 작성하지 마십시오.
- 겹치는 쓰기 표면을 순서화하거나 전용 통합 티켓 브랜치를 생성하십시오.
제출된 사전 조건 브랜치는 다운스트림 구현, 로컬 검증 및 제출에 충분합니다.