전체 x-워크플로우 조정
현재 세션은 부모 코디네이터입니다. 작업을 분배하기 전에 references/workflow.md를 읽으십시오. 필요에 따라 다른 세 가지 스킬도 읽으십시오; 각 단계의 의미론과 공유 계약은 모든 작업자에게 적용됩니다. 요청의 이름 오타로 인해 관련 없는 kauto 워크플로우를 실행하지 마십시오.
준비 및 할당
- 요청된 결과, 제약 조건 및 범위를 설정합니다. Git 루트, 현재 브랜치/HEAD, 적용 가능한 지침, 더티/인덱스 상태를 찾습니다. Git은 필수입니다; 자동으로 초기화하지 말고 중단하십시오. 하나의 깨끗하고 배타적인 작업 체크아웃을 선택합니다. 관련 없는 작업은 보존합니다; 가능하면 격리하고, 그렇지 않으면 필요한 처리를 문의합니다. 별도 브랜치에서 작업할 때 사용자의 원래 브랜치에 커밋을 약속하지 마십시오.
- 작업 ID와 표준 아티팩트 경로를 할당합니다. 플래너는 여러 개의 경계가 있는 단위와 공유 설계를 제안할 수 있습니다. 부모는 중앙에서 추가 ID를 할당하고 전체 요청의 적용 범위를 보존합니다.
- 사용 가능한 위임 도구를 발견합니다. 자식 세션을 우선 사용하고, 사용 불가능한 경우에만 하위 에이전트를 사용합니다. 호스트의 위임/수명 주기 규칙을 따릅니다. 도구 이름을 가정하거나 부모에서 다른 메시지로 새 컨텍스트를 위조하지 마십시오. 두 메커니즘 모두 없으면 중단하고 독립적인 조정 워크플로우를 사용할 수 없다고 설명하십시오. 모든 역할을 인라인으로 자동 실행하지 마십시오.
- 사용자 또는 적용 가능한 지침에서 선택하지 않는 한 모델/하네스/노력을 상속합니다. 작성자의 사적 추론을 포함하는 포크가 아닌 새로운 검토자 컨텍스트를 사용하십시오. 검토자는 요청, 코드, 아티팩트 및 이전 공개 발견 사항을 볼 수 있지만, 검토된 계획/구현을 작성한 작업자는 아닙니다.
- 공유 계약을 사용하여 부모 세션의 프로비넌스를 캡처합니다. 각 작업자의 코디네이터 ID와 네이티브 대화 ID를 핸드오프에서 요청하고, 일시적인 작업자 이름뿐만 아니라 정리 전에 작업 로그에 보존합니다.
명시적 단계 브리프 전달
각 작업자는 목표, 관련 사용자 제약 조건, 스킬 및 호출, 작업 ID, 정확한 체크아웃 및 시작 HEAD, 입력/출력 경로, 허용된 편집, 커밋 권한, 검사 요구 사항 및 기존 검증 증거, 예상 핸드오프(세션 프로비넌스 포함) 및 중지 조건을 받습니다. 결과가 사용될 위치를 포함하십시오. 작업자가 독립적으로 검증해야 한다고 가정하는 것이 아니라 계획 또는 요청을 제공하십시오.
단계는 공유 체크아웃에서 순차적입니다. 기본적으로 한 번에 한 명의 작성자로 설정하고, 파일과 종속성이 실제로 독립적이고 통합/검토 소유권이 명시적인 경우에만 별도 단위를 동시에 실행하십시오. 각 자식의 실제 디렉토리/HEAD를 확인하고, 공유 계약에 설명된 대로 다음 단계 전에 격리된 작업자 핸드오프 커밋을 통합하십시오. 전송되지 않은 결과를 절대 삭제하지 마십시오.
계획 → 계획 검토
xplan <request>로 플래너를 시작하고 프로덕션 코드 편집 권한은 없앱니다. 플래너는 까다로운 질문을 조사하고, 엔지니어링 결정을 확정하며, 준비된 계획, 소규모 태스크 브리프 또는 구체적인 차단 요소를 반환합니다.- 반환된 아티팩트와 적용 범위를 검사합니다. 계획/공유 설계 레코드를
plan으로 커밋한 다음, 각 실행 계획을xreview plan .agents/plans/ID.md를 사용하여 독립적인 작업자에게 보냅니다. 검토 라운드를plan-review로 커밋합니다. - 발견 사항이 있으면 플래너에게 구체적인 수정 과제를 반환합니다. 수정된 계획을 커밋합니다. 부모는 발견 사항 및 관련 증거에 대한 수정 사항을 확인하고, 그 처분과 최종 계획/지침 블롭을 기록하며, 중대한 결함이 남지 않으면 진행합니다. 이것은 검토자가 보지 않은 수정 사항을 승인했다는 주장이 아니라 부모의 실행 결정입니다. 모든 수정 사항을 전체 계획 검토에 다시 보내지 마십시오. 추가 독립 평가는 이전 검토와 수정 확인으로 해결할 수 없는 특정 중대한 질문이 필요합니다. 그 질문을 명명하고 필요한 평가만 요청하십시오. 문구, 메타데이터 및 일상적인 수정 사항은 검토 재시작을 정당화하지 않습니다. 공유 설계 편집은 영향을 받는 단위를 확인해야 하며, 각 단위에 대해 자동으로 다른 검토를 위임하지 않아야 합니다.
- 진정으로 소규모 작업의 경우, xwork를 위해 플래너의 경계가 있는 브리프를 유지하고 별도의 계획/검토 아티팩트는 건너뜁니다. 이후 작업 로그에 이유를 기록합니다. 큰 미해결 과제를 브리프라고 부르며 정규화를 우회하지 마십시오.
- 분할된 요청은 첫 번째 단위 후에 완료되지 않습니다. 공유 설계에서 단위 종속성을 추적하고, 요청된 모든 단위를 순서대로 실행하며, 종속성이 변경되면 공유 인터페이스/중간 상태를 다시 확인합니다.
작업 → 구현 검토
xwork .agents/plans/ID.md또는 명시적 소규모 태스크 브리프를 사용하여 구현자를 파견합니다. 승인된 검토/계획 및 연결된 지침 블롭을 제공합니다. 태그 소유 코드 및 로그 커밋만 승인합니다. xwork는 고정된 Code 베이스를 기록하고, 검증된 코드를 커밋한 다음, 알려진 Code 헤드로 로그를 별도로 커밋합니다.- Git 및 기록된 테스트 출력에 대해 핸드오프를 확인합니다. 자식의 "완료" 메시지는 올바른 트리, 완료된 검사 또는 커밋된 파일의 증거가 아닙니다. 통합 매핑을 해결하고 최종 로그에 작업 체크아웃 해시를 사용합니다.
xreview work .agents/work/ID.md를 사용하여 독립적인 검토자를 시작합니다. 요청, 계획/브리프, 전체 Code 베이스..Code 헤드 범위, 작업 로그 및 관련 저장소 지침을 제공합니다. 검토자는 로그뿐만 아니라 코드와 테스트를 읽고, 구현을 수정하지 않고 리뷰를 작성합니다. 리뷰를work-review로 커밋합니다.- 기록된 Code 헤드에 대한 검사 가능한 검사 결과를 전달합니다. 검토자에게 먼저 해당 증거를 검사/재사용하고 신선한 검사를 선택하기 전에 남은 불확실성을 식별하도록 요청하십시오. 동일한 변경되지 않은 코드에 대해 집중된 반복, 전체 패키지 실행 및 저장소 스위트를 일상적으로 요청하지 마십시오. 명시적인 신규 실행 요구 사항은 여전히 적용됩니다.
- 실행 가능한 발견 사항을 구현자에게 보냅니다. 구현자는 수정 사항을 커밋하고 로그 항목을 추가하며 원래 베이스를 유지합니다. 전체 업데이트된 변경 사항을 독립적인 검토자에게 반환합니다. 이전 발견 사항은 신선한 빈 체크리스트가 아닌 해결 증거가 필요합니다. 모든 검토 라운드를 보존합니다. 검토자는 작성자와 독립적인 동안 재사용될 수 있습니다. 어떤 역할도 방금 작성한 코드를 승인할 수 없습니다.
- 구현이 유효하지 않은 설계를 드러내면 계속하기 전에 결정을 플래너와 부모를 통해 다시 라우팅합니다. 영향을 받는 종속 단위에 동일한 수정 확인을 적용합니다. 추가 독립 평가는 단순히 변경된 계획 블롭이 아닌 특정 중대한 불확실성이 필요합니다. xwork가 조용히 범위를 확장하거나 어려운 선택을 코딩할 때까지 남겨두지 못하게 하십시오.
발견 사항 해결 및 정직하게 마무리
일상적인 확인 없이 진행하되, 의도, 범위, 권한 또는 중요한 트레이드오프가 진정으로 사용자를 필요로 할 때는 질문하십시오. 필요한 도구/검사를 사용할 수 없거나 논쟁 중인 결정이 있을 때 중단하십시오. 진전이 있는 동안 일반적인 수리를 계속하십시오. 라운드가 동일한 실패한 접근 방식을 반복하거나, 사용자 결정이 필요하거나, 명시적 예산을 초과하면 중단하고 무한 검토 루프를 생성하는 대신 해결되지 않은 증거를 보고하십시오. 주기를 완료하기 위해 결함을 수락하지 마십시오.
성공 전에 부모는 다음을 확인합니다:
- 요청된 모든 실행 단위가 구현되고, 필요한 검사가 실제로 통과되었으며, 최종 코드에 대해 독립적으로 수락된 작업 검토가 있습니다.
- 단위의 검토된 Code 헤드 이후의 모든 코드/테스트/구성 변경 사항은 통합된 작업 체크아웃에 대한 이후 단위의 수락된 검토 범위에 포함되거나, 검증 및 작업 검토를 다시 거쳐야 합니다. 알려진 워크플로우-레코드 전용 변경 사항은 코드 재검토가 필요하지 않습니다. 경로 이름을 일치시키는 것뿐만 아니라 모든 커밋/차이를 설명하십시오. 통합 충돌 수정 및 이전 계약 위반은 갱신된 검사/검토가 필요합니다. 이후에 수락된 단위가 자동으로 이를 면제하지 않습니다.
- 작업 로그에는 수락된 계획/브리프, 고정된 베이스, 최종 검토된 헤드, 실제 커밋, 부모/작업자의 네이티브 대화 ID(또는 명시적 사용 불가 사유), 실행/재사용된 검증 증거 및 검토 경로가 포함됩니다. 로그를
complete로 설정하고 나머지 태그 소유 레코드를complete로 커밋합니다. - 모든 태그 소유 변경 사항과 새 레코드는 보고된 브랜치에 커밋됩니다. Git으로 확인하고, 관련 없는 작업을 보존하며, 푸시하거나 다른 브랜치에 자동으로 병합하지 마십시오. 원래 코드 헤드는 최종 HEAD와 같을 필요가 없습니다. 이후 커밋에 레코드 또는 다른 독립적으로 수락된 단위가 포함될 수 있기 때문입니다.
- 각 자식의 세션 프로비넌스를 저장하고, 브랜치/워크트리를 제거하는 세션을 종료하기 전에 모든 결과를 통합/저장합니다. 도달 가능한 커밋된 결과를 남기고 호스트의 정리 규칙을 따릅니다. 실패한 주기는 부분 커밋과 차단 요소를 보고하며 성공을 보고하지 않습니다.
간결한 결과, 작업 ID, 아티팩트 경로, 브랜치 및 최종 커밋 ID, 검사, 검토 결과 및 남은 제한 사항을 반환하십시오. 부모는 이 검증 및 최종 보고서를 소유합니다. 작업자 요약을 단순히 연결하지 마십시오.