Jig 오케스트레이션
계약
Jig의 현재 설계 계약에 따라 실행 형태의 작업을 조정합니다. 이 스킬은 로컬 컴포지션 실행북(runbook)이며, Jig 런타임 구현, CLI, 공급자 어댑터 또는 레코드 저장소가 아닙니다. 승인된 입력, 현재 도구 표면, 정책 태세 및 기록 가능성이 허용하는 범위 내에서만 사람/Codex 지원 실행을 구성할 수 있습니다.
실행 계획이 범위를 소유합니다. 실행 계획은 이미 docs/design/contracts/execution-plan-contract-v0.md에 설명된 스토리 세트, 의존성, 작업 경계, 완료 및 증거 요구 사항, 권한 기대치, 정책/작업 프로필/저장소 바닥 참조, 제약 조건 및 호환성 태세를 포함해야 합니다. 이 스킬은 거부, 바인딩, 일정 관리, 중지 또는 보고할 수 있습니다. 스토리를 발명하거나, 의존성을 수정하거나, 정책을 약화시키거나, 승인 기준을 추가하거나, 완료 증거를 선택하거나, 범위 외 표면을 재해석하거나, 누락된 계획 사실을 런타임 결정으로 변환해서는 안 됩니다.
레코드가 증거입니다. 모든 통제된 결정, 승인, 중지, 증거 관찰, 검토 결과 및 러너 소유 작업은 docs/design/contracts/observability-records-contract-v0.md에 따라 기록 가능해야 실제로 처리되기 전에 참으로 간주됩니다. 별도의 내러티브, 채팅 요약, 체크리스트 또는 작업자 보고서는 기록 가능한 증거 패킷을 절대 대체하지 않습니다.
참조 경계
은퇴한 workflow-kit 오케스트레이션 제공 스킬은 이전 기술(prior art)일 뿐입니다. 다음 교훈을 Jig 자체 계약을 유지하는 방식으로 가져오십시오:
- 실행 입력을 디스패치 전에 사전 점검(preflight)할 것;
- 런타임 사실은 계획 중이 아닌 사전 점검 후에 바인딩할 것;
- 작업자(worker)가 생성한 변경사항과 러너(runner) 소유의 특권 작업을 분리할 것;
- 완료(done) 또는 안착(landed) 상태 전에 독립적인 증거를 요구할 것;
- 누락된 기능을 추측하는 대신 복구 가능하고 명명된 중지(stop)를 남길 것.
workflow-kit의 실행 패키지 경로, 트래커 스키마, 스토리별 프롬프트 폴더, 모델 라우팅 테이블, 공급자 패키지 레이아웃, v-next 브랜치 정책, 이전 PR 게시 규칙 또는 이전 런타임 주장을 가져오지 마십시오. 이전 기술 규칙이 Jig의 v0 계획 또는 레코드 속성에 매핑되지 않으면 무시하고 대신 중지 또는 설계 격차를 명명하십시오.
입력
작업자 디스패치 또는 특권 작업 전에 다음 모두를 요구하십시오:
execution-plan-contract-v0와 호환되는 승인된 실행 계획;- 계획이 바인딩하는 정책 참조, 작업 프로필 참조 및 저장소 바닥 참조;
- 요청된 경계에서 시작하거나 미리보기(preview)할 소유자 승인;
- 실행 위치에 대한 현재 저장소/작업 트리(repo/worktree) 사실;
- 시작, 실행 또는 안착 경계의 경우: Agent, Execution Host, Forge 및 Work Source에 대한 현재 드라이버/시임(seam) 사실, 또는 필요한 시임을 검사할 수 없는 경우 명시적 중지;
- 미리보기 전용 경계의 경우: 실행 ID, 작업 공간 할당, 공급자 배선 또는 특권 부작용 없이
run.previewed를 기록하기에 충분한 바인딩 사실; - 계획 및 정책의 현재 검증 명령 및 증거 요구 사항;
- 이 로컬 실행에 대해
observability-records-contract-v0속성을 보존할 수 있는 레코드 경로, 레코드 저장소 또는 내구성 레코드 패킷 형식.
알 수 없는 런타임 사실은 검사될 때까지 알 수 없는 상태로 유지됩니다. 누락된 계획 사실은 런타임 사실이 아닙니다. 이는 계획 사전 점검 실패입니다.
사전 점검
디스패치, 편집, 푸시, PR, 병합, 상태 게시 또는 Jig가 시작되었다는 주장 전에 이 게이트를 실행하십시오.
- 관련 표면에 대해 저장소 지침 및 진실 공급원 문서가 읽혀졌는지 확인하십시오:
AGENTS.md,docs/product/jig.md,docs/product/guarantees.md,docs/product/concepts.md,docs/design/README.md,docs/design/contracts/execution-plan-contract-v0.md,docs/design/contracts/observability-records-contract-v0.md,docs/design/core/orchestration.md, 및docs/design/core/records.md. - 계획이 소유자 또는 소유 계획 단계에 의해 승인되었는지 확인하십시오. 승인이 없으면
plan-not-approved로 중지하십시오. - 계획이 v0 필수 속성을 포함하는지 확인하십시오:
- 계획 ID 및 출처;
- 트랙 바인딩;
- 스토리 세트;
- 의존성 및 적격성 모델;
- 완료 및 증거 요구 사항;
- 권한 및 승인 필요 사항;
- 정책 및 작업 프로필 참조;
- 스택 시임 요구 사항;
- 제약 조건 및 한계.
- 계획의 버전 또는 호환성 표시가 이해되는지 확인하십시오. 그렇지 않으면
plan-format-unsupported로 중지하십시오. - 선택된 모든 스토리가 안정적인 ID, 의도된 경계, 의존성 목록, 증거 요구 사항 및 권한 기대치를 가지고 있는지 확인하십시오. 선택된 스토리가 러너 또는 작업자에게 범위를 추론하도록 요청하면
plan-scope-incomplete로 중지하십시오. - 의존성 순서가 계획을 다시 작성하지 않고 도출될 수 있는지 확인하십시오. 그래프가 순환적이거나 모순되거나 순서를 발명해야 하는 경우
plan-dependency-invalid로 중지하십시오. - 정책, 작업 프로필 및 저장소 바닥 참조가 존재하고 요청된 실행과 호환되는지 확인하십시오. 누락되었거나, 호환되지 않거나, 시작 시 정책을 약화시킬 경우
binding-input-missing으로 중지하십시오. - 요청된 경계가 지원되는지 확인하십시오: 미리보기, 로컬 실행 조정, 증거 수집, 러너 소유 게시 또는 중지. 미리보기는 비커밋(non-committing)입니다: 로드, 검증, 바인딩 및 기록 가능한
run.previewed이벤트가 필요하지만 실행 ID, 작업 공간, 공급자 또는 특권 부작용은 필요하지 않습니다. 사용자가 현재 저장소에 존재하지 않는 실제 Jig 동작을 요청하면jig-runtime-unavailable로 중지하십시오.
사전 점검은 제안된 실행 순서, 거부 또는 명명된 중지를 생성할 수 있습니다. 계획을 수리해서는 안 됩니다.
런타임 바인딩
사전 점검 통과 후에만 현재 사실을 바인딩하십시오:
- 작업 트리 경로, 저장소 루트, 브랜치, 베이스 및 청결 상태;
- 적용 중인 정책, 작업 프로필 및 저장소 바닥 참조;
- 계획 그래프의 선택된 스토리 및 현재 적격 스토리;
- 현재 검증 명령, 검토 요구 사항 및 역량 증명 요구 사항;
- 현재 소유자 승인 상태 및 요청된 중지 경계;
- 시작, 실행 또는 안착 경계의 경우: Agent, Execution Host, Forge 및 Work Source 드라이버 가용성 및 증명 태세;
- 미리보기 전용 경계의 경우: 공급자 배선을 강제하지 않고 미리보기 바인딩 태세 및 기록 가능한
run.preedited기반; - 레코드 대상 또는 레코드 패킷 위치 및 해당 편집/내보내기 태세;
- 현재 표면에서 사용 가능한 러너 소유 작업(예: 푸시, PR 생성, 상태/댓글 게시 및 병합).
시작 전에 이러한 바인딩을 기록하십시오. 시작 바인딩은 재개(resume)에 대해 변경 불가능합니다: 재개는 중지된 실행에서 계속할 수 있지만 정책, 작업 프로필, 저장소 바닥, 계획 또는 드라이버 사실을 조용히 교체할 수 없습니다. 변경된 안전 관련 가정은 계속하기 전에 새로운 소유자 승인과 새로운 증거가 필요합니다.
러너 및 작업자 경계
docs/product/concepts.md 및 docs/design/core/orchestration.md의 제품 권한 경계를 유지하십시오.
- 작업자는 승인된 스토리 경계 내에서만 읽기, 편집, 비특권 검사 실행, 차이(diff) 생성, 증거 생성 및 차단기(blocker) 보고를 할 수 있습니다.
- 작업자는 푸시하거나, PR을 열거나 업데이트하거나, 상태/댓글을 게시하거나, 병합하거나, 권한을 확장하거나, 정책 바닥을 편집하거나, 스토리를 안착(landed)으로 표시하거나, 발생한 일의 권한으로 레코드를 작성해서는 안 됩니다.
- 러너는 적격성, 승인, 증거 평가, 레코드, 소유자 에스컬레이션, 푸시, PR 생성, 상태/댓글 게시, 병합, 중지, 재개 및 내보내기를 조정합니다.
- 특권 작업은 러너 권한과 정책/증거 기반이 필요합니다. 작업자 자체 보고는 특권 작업 완료를 표시하기에 결코 충분하지 않습니다.
- 선언된 권한 밖의 요청은 실패(fail closed)하거나 소유자에게 라우팅되며, 더 넓은 암시적 허가가 되지 않습니다.
현재 표면이 이 분할을 실제로 유지할 수 없으면 authority-boundary-unsupported로 중지하십시오.
조정 루프
새로운 상태를 추가하지 않고 계획 그래프와 Jig 수명 주기 용어를 사용하십시오.
- 계획 및 현재 레코드에 따라 모든 선행 조건이 안착(landed)된 스토리만 시작하십시오.
- 적격하지 않은 스토리는 대기 상태로 유지하십시오. 작업자가 스스로 의존성 결정을 내리도록 요청하지 마십시오.
- 적격한 스토리에 대해 스토리 경계, 계획 참조, 권한 기대치, 증거 요구 사항, 검증 명령, 비목표(non-goals) 및 변형 한계와 함께 작업자를 디스패치하십시오.
- 작업자 출력을 제안된 작업 및 증거로 취급하고 상태 권한이 아닌 것으로 취급하십시오.
- 러너 또는 위임된 검토자가 관찰한 정책 정렬 증거에서만 완료(done)를 평가하십시오.
done과landed를 별도의 이정표로 유지하십시오: 스토리는 증거가 충족되면 완료될 수 있지만 병합은 검토, 브랜치 보호, 충돌, 대기열 또는 소유자 경계에 의해 보류될 수 있습니다.- 필요한 증거, 소유자/검토자 승인(필요한 경우) 및 레코드 추가/패킷 준비가 모두 성공한 후에만 러너 소유 작업을 통해 안착(land)하십시오.
- 스토리가 차단되면 이유와 영향을 받는 하위 스토리를 기록하십시오. 독립적인 형제 스토리는 정책과 역량이 허용할 때 계속될 수 있습니다.
향후 Jig 설계 계약에서 도입하지 않는 한 트래커, 스토리 패키지, 프롬프트 패키지 또는 병합백 모델을 추가하지 마십시오.
증거 및 레코드 게이트
상태 전환 또는 통제된 결정을 수락된 것으로 처리하기 전에 요청된 경계에 적용되는 v0 속성을 가진 기록 가능한 패킷을 준비하십시오:
- 커밋된 시작/재개/실행 경로의 경우: 실행 ID, 시도 ID, 계획 참조, 트랙 참조, 정책/작업 프로필/저장소 바닥 참조 및 드라이버 컨텍스트;
- 미리보기 전용 경로의 경우: 계획 참조, 트랙 참조, 정책/작업 프로필/저장소 바닥 참조 및 실행 ID나 드라이버 컨텍스트를 발명하지 않고 비커밋
run.previewed기반; - Jig의 현재 이벤트 패밀리 고도를 사용한 이벤트 패밀리 및 결과;
- 책임이 있는 행위자 또는 구성 요소: 작업자, 러너, 소유자, 위임된 검토자 또는 드라이버;
- 기반: 정책 규칙, 증거 관찰, 승인, 역량 증명, 이전 이벤트 또는 계획 참조;
- 해당되는 경우 스토리 ID;
- 편집/내보내기 태세;
- 재생 또는 재개에 충분한 순서 정보;
- 모든 차단, 중지, 통지, 재개 체크포인트 또는 이중 효과 없음(no-double-effect) 기반.
자동화된 검사, 검토 및 역량 증명은 관찰되거나 독립적으로 검증되어야 합니다. 증거가 누락되었거나, 오래되었거나, 자체 보고만 되었거나, 검증할 수 없거나, 기록할 수 없는 경우 스토리는 완료되지 않으며 evidence-insufficient로 중지해야 합니다.
중지
임시방편 실행보다 명명된 중지를 선호하십시오. 중지 보고서에는 중지 이름, 영향을 받는 실행 또는 스토리, 실패한 게이트, 기록 가능한 기반, 사용 가능한 경우 안전한 재개 체크포인트 및 다음 소유자 조치가 포함되어야 합니다.
더 구체적인 계획 소유 이름이 없는 한 이러한 중지 이름을 사용하십시오:
plan-not-approved— 승인된 실행 계획 또는 시작 승인 없음.plan-format-unsupported— 계획 호환성 표시 또는 형태가 알 수 없음.plan-scope-incomplete— 선택된 스토리 범위, 경계, 증거 또는 권한 필요 사항이 누락됨.plan-dependency-invalid— 의존성 그래프를 작성된 대로 실행할 수 없음.binding-input-missing— 정책, 작업 프로필, 저장소 바닥 또는 호환성 참조가 없거나 호환되지 않음.jig-runtime-unavailable— 요청된 동작에 현재 로컬 드라이런 CLI(jig preview/jig run/jig inspect)를 넘어서는 Jig 런타임 기능이 필요함.driver-capability-unavailable— 필수 Agent, Execution Host, Forge 또는 Work Source 기능을 증명할 수 없음.authority-boundary-unsupported— 현재 표면이 러너 소유 특권 작업과 포함된 작업자 권한을 보존할 수 없음.records-store-unavailable— 내구성 레코드 저장소 또는 기록 가능한 패킷이 v0 레코드 속성을 보존할 수 없음.evidence-insufficient— 필수 증거가 누락되었거나, 검증할 수 없거나, 오래되었거나, 자체 보고만 됨.owner-decision-required— 정책이 좁은 결정을 소유자에게 라우팅함.safety-reapproval-required— 규칙을 관장하거나 안전과 관련된 입력이 재개 또는 안착 전에 변경됨.
중지는 유효한 결과입니다. 누락된 조건이 Jig의 제어, 증거, 복구 또는 관찰 가능성 보장의 일부인 경우 중지를 경고로 부드럽게 만들지 마십시오.
출력
전체 대화 기록 덤프가 아닌 간결한 실행 원장(ledger)을 반환하십시오:
- 계획 참조 및 선택된 스토리 ID;
- 바인딩된 정책, 작업 프로필 및 저장소 바닥 참조;
- 검사된 런타임 사실 및 해결되지 않은 알 수 없는 사실;
- 기록 가능한 적격, 시작됨, 대기됨, 차단됨, 완료됨, 안착됨, 거부됨, 중지됨, 재개됨 또는 완료된 상태;
- 관찰된 증거 및 실행된 검증 명령;
- 취해진 또는 명시적으로 취해지지 않은 러너 소유 작업;
- 중지 이름, 이유, 안전한 재개 체크포인트 및 다음 소유자 조치;
- 레코드 패킷/저장소 참조 및 편집 태세;
- 지원되지 않는 기능 또는 설계 격차를 소유 Jig 설계/계획 표면으로 다시 라우팅.
주장된 상태에 대한 기록 가능한 증거가 없으면 상태를 검증되지 않은 것으로 보고하고 중지하십시오.