문서

첫 번째 작업 실행하기

작업 내용을 설명하고 계획을 승인하면, Coroid가 해당 작업을 구축 및 검증하는 과정을 확인할 수 있습니다.

하나의작업은 하나의 완성된 pull request로 이어지는 단위 작업입니다. 새 작업에서 시작해 보세요.새 작업.

적합한 첫 번째 작업을 선택하세요

가장 적합한 첫 번째 작업은 규모가 작고 실제로 구현 가능하며 기존 테스트와 연계된 내용입니다. 예를 들어 "export 명령어에--json플래그를 추가하여, import 명령어가 이미 지원하는 출력 형태와 일치시키는 경우 Coroid는 명확한 목표를 갖게 되며 사용자도 결과를 쉽게 확인할 수 있습니다.

첫 번째 작업으로는 다음을 피하세요:

  • 인증, 결제 또는 데이터 마이그레이션과 관련된 모든 작업
  • 아직 결정하지 못한 설계 방향이 필요한 작업
  • 모호한 정리 작업 — '오류 처리 개선'은 완료 기준이 명확하지 않습니다.

원하는 결과를 구체적으로 설명하세요.

구현 방식이 아닌 최종 결과를 기술하세요. 작업이 완료된 후에 반드시 충족되어야 할 조건과 중요한 파일, 준수해야 할 규칙, 수정해서는 안 되는 부분 등을 명시하세요.

계획서를 직접 작성할 필요는 없습니다. 이는 Coroid가 가장 먼저 생성하는 결과물이며, 이를 승인하는 것이 바로 사용자의 역할입니다.

코드에 포함되지 않은 추가적인 맥락 — 아키텍처 결정 기록, 스타일 가이드, 티켓 등이 있다면 이를 첨부하세요.프로젝트 맥락을 참고하면 Coroid가 별도의 지시 없이 이미 인지하고 있는 정보를 확인할 수 있습니다.

사양 내용을 검토하세요.

Coroid는 사용자의 설명을 다음과 같은사양으로 변환합니다. 여기에는 구축 대상, 제외 범위, 성공을 판단하는 수용 기준 등이 포함되며, 이 사양은 해당 작업의 '사양' 탭에서 확인할 수 있습니다.

작업을 시작하기 전에 이 내용을 반드시 확인하세요. 수락 기준이 실제 원하는 내용과 일치하지 않으면 즉시 수정하십시오. 이 기준은 이후 검증 단계에서 테스트의 근거가 되기 때문입니다. 자세한 내용은사양.

계획 승인하기

간단한 변경 사항이 아닌 경우에는 사양이계획이 됩니다. 즉, 순서가 정해진 단계들의 집합이죠. 코드를 작성하기 전에 이 계획을 승인해야 합니다.

이 시점이 개입하기에 가장 경제적인 타이밍입니다. 계획을 거부하는 데 드는 비용은 단 1분에 불과하지만, 완성된 pull request를 다시 처리하는 데는 전체 작업 시간이 소요됩니다.

실행 과정 확인하기

계획이 승인되면 해당 작업은PENDING에 들어가서 에이전트 슬롯이 확보될 때까지 대기합니다.IN_PROGRESS. 실행 과정을 실시간으로 확인할 수 있습니다. 수행된 단계, 호출된 도구, 수정된 파일 및 누적되는 테스트 결과 등을 모두 볼 수 있습니다.

직접 지켜볼 필요는 없습니다. 필요한 조치를 취해야 하거나 작업이 완료되면 알림을 통해 알려드립니다.

예상되는 상황

  • 소요 시간은 변경 사항의 규모와 테스트 스위트의 실행 시간에 따라 결정되며, 보유한 에이전트 슬롯 수와는 무관합니다. 슬롯은 동시에 실행되는 작업의 수를 제어합니다.
  • **NEEDS_HUMAN_REVIEW은 오류가 아닙니다.**이는 Coroid가 오직 사용자만이 내릴 수 있는 결정을 요청했음을 의미합니다. 해당 요청에 응답하면 작업은 계속 진행됩니다.
  • **재작업은 정상적인 과정입니다.**리뷰어가 문제를 발견하면 사용자가 확인하기 전에 개발자에게 다시 전달됩니다.

다음 단계

결과물을 리뷰하고 병합하기— 도착하는 결과물과 확인해야 할 사항을 안내합니다.