Communitygithub.com

비디오 반복 개발 (Video-Iterative Development)

오케스트레이터가 지정한 인증된 E2E 과제를 로컬 API 계약, 생성된 클라이언트, Patrol/비디오 리뷰, 풀 리퀘스트 루프를 통해 실행하며, 배포 결정은 내리지 않습니다.

비디오 반복 개발 (Video-Iterative Development)란 무엇인가요?

이 스킬은 `video-iterative-orchestration`으로부터 완전한 과제를 할당받은 구현 워커로 작동합니다. 백엔드 전용, 프론트엔드 전용, 또는 크로스 레이어 범위를 재해석 없이 실행하며, 사용자에게 보이는 플로우가 있을 경우 백엔드 응답, 생성된 클라이언트, Android 상호작용을 아우르는 실제 로컬 계약을 증명하고 시각적 증거를 캡처합니다. 중요한 배포 결정은 오케스트레이터에게 요청하며, 구현 에이전트는 결정을 내리지 않습니다. Figma 시각 번들을 사용하여 UI 코드를 변경하기 전에 디자인을 검사하고, 리포지토리 UI 레일을 따르며, 할당된 기능 적합성 행을 승인 대상으로 삼습니다. 최종 검증된 배치를 한 번 푸시하고, PR 설명은 리뷰어 중심으로 작성하며, Jira 작업에는 적절한 링크를 포함합니다. 이 스킬은 로컬 런타임 선택, 커밋 규율, 외부 작업 실행, 리뷰 수정, 그리고 병합되지 않은 PR 교정에 대한 명확한 지침을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MarkTripoli/skills/tree/HEAD/skills/delivery/video-iterative-development

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

작성 가이드와 컬렉션 규칙을 작성, 수정, 또는 답변하기 전에 읽으십시오; 컬렉션의 체크아웃은 두 파일을 모두 shared/ 디렉토리 아래에 가지고 있습니다.

비디오 반복 개발

이 스킬을 video-iterative-orchestration의 완전한 과제를 위한 구현 워커로 사용하십시오. 할당된 백엔드 전용, 프론트엔드 전용, 또는 크로스 레이어 범위를 재해석 없이 실행하십시오. 사용자에게 보이는 플로우가 존재하는 경우, 백엔드 응답, 생성된 클라이언트, Android 상호작용을 아우르는 실제 로컬 계약을 증명한 다음, 리뷰를 위한 시각적 증거를 캡처하십시오.

권한 경계 및 결정 요청

구현 에이전트는 실행만 하며, 중요한 배포 결정을 내리지 않습니다. 소스 해석, 티켓 범위, 제품 또는 디자인 동작, 참여 리포지토리 또는 레이어, 종속성 순서, 브랜치 또는 PR 토폴로지, 필요한 증거, 편차, 차단자 처리, 최종 티켓 상태를 선택하거나 변경해서는 안 됩니다. 프롬프터나 다른 외부 소유자에게 결정을 요청해서는 안 됩니다.

에이전트는 과제를 변경하지 않는, 리포지토리 관례에 따른 가역적인 구현 메커니즘을 선택할 수 있습니다. 여기에는 로컬 코드 구성, 명령 순서, 결정적인 셀렉터 세부 사항, 그리고 범위 내 실패에 대한 진단 또는 재시도가 포함됩니다. 과제에 필수 정보가 누락되었거나, 권위 있는 소스 또는 리포지토리 사실과 충돌하거나, 중요한 선택이 필요한 경우, 이 구조화된 요청을 오케스트레이터에게 반환하고 영향을 받지 않는 작업을 계속하십시오:

decision_request:
  observed_condition: <사실>
  assignment_clause: <누락되거나 충돌하는 조항>
  evidence: <경로, 명령어, 또는 편집된 출력>
  decision_needed: <오케스트레이터를 위한 정확한 질문 하나>
  affected_work: <해당 결정으로 인해 중단된 작업>
  unaffected_work_continued: <계속 진행 중인 작업>

요청에서 대안을 추천하거나 조용히 선택하지 마십시오. 과제에 선택된 범위, 작성 표면, 브랜치 및 PR 대상, 승인 동작, 또는 증거 게이트가 없는 경우, 구현 전에 decision_request를 반환하십시오.

제공된 Figma 시각 번들 사용

과제에 extract-figma-visuals 번들이 포함된 경우, UI 코드를 변경하기 전에 metadata.json, screen.png, 및 명명된 하위 이미지를 검사하십시오. 매니페스트의 표준 노드 ID와 URL을 사용하여 Figma MCP를 통해 세부 구현 정보를 검색하십시오; 해당 컨텍스트에서 구현할 때, 먼저 Figma의 필수 figma-design-to-code 지침을 따르고 관련 루트 또는 노드에 대해 get_design_context를 호출하십시오. 프레임을 다시 내보내거나, 번들을 폐기하거나, 텍스트만으로 디자인을 추론하지 마십시오. 구현 및 시각 리뷰에 어떤 루트 및 하위 이미지가 사용되었는지 기록하십시오. 오케스트레이터의 기록된 Figma 해상도를 적용하십시오. 검색된 컨텍스트가 해당 해상도와 충돌하거나 해결되지 않은 제품 선택을 드러내는 경우, decision_request를 반환하십시오; 소스를 재해석하지 마십시오.

번들은 최종 증거가 아닌 구현 참조입니다. 아래에 필요한 실제 Android 녹화, 사용자 플로우 증명 또는 시각 리뷰를 대체하지 않습니다.

리포지토리 UI 레일 따르기

편집하기 전에 참여 리포지토리의 AGENTS.md, 엔지니어링 가이드, UI/컴포넌트 인벤토리, 로컬라이제이션 규칙, 및 문서화된 검증 명령을 읽으십시오. 공개 디자인 시스템 컨트롤과 토큰을 재사용하십시오; 구체적인 요구 사항 없이 내부 컴포넌트를 가져오거나 기능-로컬 대체물을 도입하지 마십시오. 가능한 경우 리포지토리의 읽기 전용 컴포넌트 인벤토리(대체 계약 및 공개 매개변수 포함)를 검사하십시오. 과제 범위를 변경하는 누락된 컴포넌트는 decision_request를 반환합니다.

터치된 대화형 액션 및 상태 보고 요소에 안정적인 의미 식별자를 제공하십시오. 여러 액션을 보유한 컨테이너에 대해 하나의 식별자를 사용하지 마십시오. 서비스 액세스를 해당 소유 레이어에 유지하고, 리포지토리 로컬라이제이션을 사용하며, 문서화된 E2E 키 규칙을 따르십시오. 새로운 공개 컴포넌트는 리포지토리에서 요구하는 경우에만 필수 계약 주석, 컴포넌트 스토리, 및 검토된 골든 커버리지를 받습니다. 문서화된 변경 라인 및 컴포넌트 검증을 완전히 실행하십시오; 분석기 단독으로는 구성된 린트 플러그인을 대체하지 않습니다. 핸드오프에 인벤토리 선택, 명령 결과, 적용 가능한 스토리, 검토된 이미지, 및 정당화된 예외를 보고하십시오.

할당된 기능 적합성 행 사용

과제에 기능 계약 경로와 관련 행이 포함된 경우, 해당 행을 이 티켓의 승인 대상으로 취급하십시오. 생성된 클라이언트 또는 서비스 경계 증명과 여정 또는 시각 증거를 핸드오프의 해당 행에 첨부하십시오. 오케스트레이터만이 agent_decided, decision_needed, 또는 편차 기록을 생성하거나 변경할 수 있습니다. 행을 할당된 대로 구현할 수 없는 경우, decision_request를 반환하고 영향을 받지 않는 행을 계속 진행하십시오. 필요한 증거 또는 오케스트레이터가 기록한 approved_deviation 없이 행이 전달되었다고 주장하지 마십시오.

할당된 변경 범위 실행

구현 전에 두 리포지토리, 현재 API 계약, 생성된 클라이언트 종속성, 및 관련 UI 플로우를 검사하여 할당된 범위를 검증하고 메커니즘을 식별하십시오. 재분류하지 마십시오:

  • 백엔드 전용: 서버 계약을 변경하고 직접 검증하십시오; 프론트엔드 변경을 만들어내지 마십시오. 과제에서 증거로 요구하는 경우에만 기존 UI 플로우를 사용하십시오.
  • 프론트엔드 전용: 기존 생성된 클라이언트와 계약을 사용하십시오; 클라이언트를 재생성하거나 백엔드를 변경하지 마십시오. 구현이 계약 간극을 드러내는 경우 decision_request를 반환하십시오.
  • 크로스 레이어: 가장 작은 백엔드 계약 변경을 만들고, 클라이언트를 재생성한 다음, 종속적인 프론트엔드 동작을 구현하십시오.

E2E 증명은 할당된 변경된 레이어와 실제 종속성 경계를 포함해야 합니다. 의미 있는 사용자-가시적 플로우가 없는 할당된 API 전용 변경의 경우, 계약 중심의 유효 및 무효 요청/응답 증거로 충분합니다; 비디오 전용 UI 변경을 조작하지 마십시오. 리포지토리 검사 결과 할당된 범위가 필요한 동작을 생성할 수 없는 경우, 다른 레이어를 추가하는 대신 decision_request를 반환하십시오.

PR 설명을 리뷰어 중심으로 유지하고 리포지토리의 PR 템플릿을 따르십시오. Jira 에픽 작업의 경우, 존재할 때 구현 서브태스크와 상위 스토리를 링크하십시오; QA 승인은 스토리에 남아 있습니다. 티켓, 최종 구현된 동작, 및 적용 가능한 증명 링크를 명시하십시오. Figma가 매핑된 UI 변경의 경우, 각 변경된 영역과 검토 결과가 매핑된 프레임과 일치하는지 여부를 명명하십시오. “OpenAPI/클라이언트 변경 없음” 또는 “발명된 UI/비디오 증명 없음”과 같은 부정적 범위 상용구를 추가하지 마십시오; “수정 적용됨”과 같은 반복 이력; 파이프라인이 이미 보고하는 로컬 테스트 수, 린트, 형식, 또는 후크 결과; 또는 내부 소스 브랜치, 종속성, 및 릴리스 영향 관리 정보를 추가하지 마십시오. 구체적인 리뷰어 조치, 호환성 문제, 또는 릴리스 조정 요구 사항을 생성하는 경우에만 예외를 포함하십시오.

커밋 및 푸시 규율

과제의 커밋 계획 및 명명된 푸시 경계를 따르십시오. push_policy: final_verified_batch, final_push_authorized: true, checkpoint_pushes: prohibited, additional_boundary_authority: orchestrator, 및 missing_boundary_state: decision_request_not_blocked를 요구하십시오. 하나가 없거나 명시적인 대체 정책 없이 다른 경우, decision_request를 반환하고 영향을 받지 않는 로컬 작업을 계속하십시오. 티켓이 차단되었다고 호출하지 마십시오.

최종 검증된 배치 경계는 상시 권한이며, 할당된 로컬 검증 및 증거 게이트가 통과된 후 한 번 푸시하라는 지시입니다. 프롬프터나 오케스트레이터에게 다시 승인을 요청하지 마십시오. 해당 게이트가 통과될 때까지 active 또는 복구 상태에서 로컬로 계속 작업하십시오; 아직 푸시하지 않은 것은 예상된 상황이며 결코 차단 요소가 아닙니다.

채택된 히스토리를 보존하고 할당된 계보 조정만 수행하십시오; 히스토리를 보존한다고 해서 모든 복구 시도를 커밋하거나 푸시해야 하는 것은 아닙니다. 기존 원격 커밋은 변경되지 않지만, 이미 게시된 브랜치라고 해서 이후 실험이 커밋이나 푸시가 되어야 하는 것은 아닙니다.

셀렉터 실험, 임시 대기, 디버그 로깅, 하네스 프로브, 및 기타 진단 편집은 결과가 알려질 때까지 작업 트리에 유지하십시오. 커밋하기 전에 대체된 시도를 제거하십시오. 브랜치에 이미 원격이 있다는 이유만으로 복구 시도를 커밋하지 마십시오; 의도된 최종 차이에 남아 있는 변경 사항, 즉 일관된 제품 또는 계약 변경과 내구성 있는 회귀 커버리지, 필수 생성된 아티팩트, 또는 기능을 증명하는 데 필요한 최종 테스트 하네스 변경만 커밋하십시오. 중단-안전 체크포인트가 유용한 경우, 브랜치 커밋을 생성하는 대신 무시된 증거 디렉토리 아래에 편집된 패치나 메모를 기록하십시오. 비밀 또는 일시적 런타임 값을 절대 포함하지 마십시오.

여러 의미 있는 커밋이 로컬에 남아 함께 푸시될 수 있습니다. 다른 권한 요청 없이 최종 검증된 배치를 한 번 푸시하십시오. 원격 종속성 핸드오프 또는 일관된 리뷰 수정과 같은 과제-명명된 경계에서만 더 일찍 또는 다시 푸시하십시오. 런타임 임대, 증거 보존, 또는 하나의 성공적인 진단 단계는 푸시를 정당화하지 않습니다. 푸시하기 전에 발신 커밋과 최종 차이를 검사하십시오; 진단 전용 또는 대체된 커밋을 게시하지 마십시오. 다른 푸시 경계가 필요한 경우, 푸시하기 전에 decision_request를 반환하고 영향을 받지 않는 작업을 계속하십시오; 누락된 경계는 차단 요소가 아닙니다.

명시적 승인 없이 기존 원격 히스토리를 정리하기 위해 수정, 리베이스, 강제 푸시 또는 기타 방법으로 다시 쓰지 마십시오. 원격 히스토리가 이미 존재하는 경우 일반적인 수정 커밋으로 계속하십시오.

승인된 외부 작업 실행

과제의 명명된 푸시 및 제출 경계는 할당된 브랜치, PR, 및 증거에 대한 워크플로 승인입니다. 런타임 관리 승인 게이트를 우회하지 않습니다. 명령 실행기가 승인된 푸시, PR 작업, 또는 증거 업로드에 승인을 요구하는 경우, 동일한 좁은 범위의 작업을 실행기의 관리 승인 또는 에스컬레이션 메커니즘을 통해 즉시 재시도하고, 정확한 대상과 목적을 명명하십시오. 런타임이 필요한 경우 승인 제어를 표시하도록 하십시오.

해당 메커니즘을 프롬프터에게 “계속하세요”라고 말하라는 대화형 요청으로 대체하지 말고, 관리 승인이 필요하다는 이유만으로 decision_request, recovery_exhausted, 또는 차단자를 반환하지 마십시오. 런타임 승인을 약화시키거나, 회피하거나, 확장하지 마십시오. 관리 승인 시도에 의해 반환된 명시적 거부만이 외부 작업 실패입니다; 정확한 편집된 도구 응답을 보존하고, 티켓을 비종결 상태로 유지하며, 집중 복구를 위해 오케스트레이터에게 반환하십시오. 경고, 추론된 개인 정보 우려, 또는 시도되지 않은 에스컬레이션은 거부가 아닙니다.

모든 외부 작업 후, 명령 종료만 신뢰하지 말고 결과 원격 상태를 검증하십시오: 원격 브랜치 커밋을 확인하고, GitHub를 통해 PR을 가져오며, PR 설명 및 인증된 다운로드에서 업로드된 증명을 확인하십시오. 오케스트레이터의 제출-종료 게이트를 위해 핸드오프에 해당 사실을 반환하십시오.

병합되지 않은 PR 수정

리뷰 수정 작업의 경우, 아티팩트를 변경하기 전에 PR 소스 브랜치를 대상 브랜치와 비교하십시오. 병합되지 않은 PR에 의해서만 도입된 모든 것(마이그레이션, 경로, 생성된 클라이언트, API 필드, UI 컴포넌트, 테스트, 또는 하네스 포함)은 변경 가능합니다. 최종 PR 차이가 올바르도록 원래 아티팩트를 수정, 이름 변경, 또는 제거하십시오; PR의 중간 구현과의 호환성을 유지하기 위한 목적으로만 보상 아티팩트를 추가하지 마십시오. 일반적인 후속 커밋으로 충분합니다; 명시적으로 승인되지 않는 한 원격 히스토리를 다시 쓰거나 강제 푸시하지 마십시오.

이미 대상 브랜치에 있거나, 병합되었거나, 배포되었거나, 외부에서 소비된 모든 것은 리포지토리의 일반 호환성 및 정방향 마이그레이션 정책을 따릅니다. 아티팩트의 출처가 불분명한 경우, 진행하기 전에 대상/소스 차이 및 히스토리를 검사하십시오; 릴리스되지 않은 예외를 가정하지 마십시오. 해당하는 경우 깨끗한 상태 마이그레이션 또는 생성 검사를 다시 실행한 다음, 영향을 받는 최종 증명을 수정된 동작의 증거로 교체하십시오.

문서화된 로컬 런타임 선택

리포지토리 정의 싱글톤 풀스택 컨테이너는 선택 사항이며 컬렉션 전제 조건이 아닙니다. 과제는 runtime_mode: shared_canonical 또는 runtime_mode: isolated_local을 명명합니다. 아래 임대 규칙은 shared_canonical에만 적용하십시오. isolated_local의 경우, 할당된 리포지토리 문서화된 로컬 설정, 포트 및 소유 프로세스를 사용하십시오; 회사 호스트 토폴로지를 만들지 않고 소스 아이덴티티, 준비, 픽스처, 인증, 및 증거 검사를 보존하십시오. 누락된 프로젝트별 구성은 진단 트리거이며, 회사 기본값을 설치할 권한이 아닙니다.

오케스트레이터가 부여한 표준 런타임만 사용

소스 작업 트리는 병렬로 진행될 수 있습니다. 리포지토리의 표준 풀스택 개발 컨테이너는 그렇지 않습니다: 한 번에 하나의 할당된 브랜치 또는 커밋을 허용하며, 오케스트레이터 소유 런타임 임대 하에 있습니다. 과제는 이 워커가 해당 임대를 보유하고 있는지 명시적으로 말해야 합니다.

임대 없이, 표준 컨테이너에서 소스를 마운트하거나 전환하지 마십시오; 해당 서비스를 시작, 중지 또는 재시작하지 마십시오; 로컬 데이터에 마이그레이션이나 픽스처를 적용하지 마십시오; 해당 서비스에 대해 인증하지 마십시오; Android E2E를 실행하지 마십시오; 증거를 기록하지 마십시오. 영향을 받지 않는 모든 소스 전용 작업을 완료한 다음, 다음을 반환하십시오:

runtime_lease_request:
  ticket: <할당된 티켓>
  exact_sources: <리포지토리 작업 트리, 브랜치 및 커밋, 배포 준비 완료>
  required_runtime_work: <마이그레이션, 픽스처, 프로브, E2E, 및 증거 여전히 필요>
  unaffected_work_completed: <구현 및 비-런타임 검증 이미 완료>

임대를 보유한 경우, 할당된 리포지토리 문서화된 개발-컨테이너 토폴로지, 표준 포트, 완전한 환경 소스, 마이그레이션, 픽스처만을 사용하십시오.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬