제안 검토

제안은 어떤 아이디어에 대한 에이전트의 계획입니다. 하나 이상의 문서(PRD, 기술 설계)와, 의존 관계가 정의된 작업 초안 묶음으로 이루어집니다. 사람이 그 계획을 읽고 승인하기 전까지는 아무것도 만들어지지 않습니다. 이것이 뒤집힌 대화의 핵심에 있는 결정 관문입니다. 이 가이드는 제출된 제안을 읽고 승인하거나 거부하는 방법을 다룹니다.

제안 찾기

프로젝트 사이드바에서 제안을 선택합니다. 제안 페이지에는 제안이 보드 형태로 나열되고, 배지에 검토 대기 중인 제안 수가 표시됩니다. 에이전트가 검토를 요청하며 제출한 제안은 검토 대기 상태입니다. 제안을 선택하면 상세 페이지가 열립니다.

문서와 작업 초안 읽기

상세 페이지는 계획을 판단하는 데 필요한 모든 것을 보여 줍니다.

설명 — 제안의 요약과, 제안의 기반이 된 출처 아이디어.
문서 초안 — 에이전트가 쓴 PRD, 기술 설계, 또는 명세. 무엇을, 왜, 어떻게를 알기 위해 읽습니다.
작업 초안 — 제안이 만들려는 작업 단위. 각 초안에는 수락 기준 개수와 의존하는 다른 작업 수가 표시됩니다. 초안과 그 의존 관계가 함께 실행 그래프를 이룹니다.
상세 정보 사이드바(상태, 입력 유형, 작성자, 타임스탬프), 출처 아이디어, 그리고 첨부된 참고 자료.

읽으면서, 문서가 요구사항을 명확히 설명하는지, 작업이 범위를 넘어서지 않으면서 요구사항을 모두 다루는지, 각 작업에 명확한 수락 기준이 있는지, 의존 순서가 이치에 맞는지 확인하세요. 토론 패널을 사용해 댓글을 남기거나 에이전트에게 설명을 요청할 수 있습니다.

검토 대기 중인 문서 초안과 작업 초안이 있는 제안 상세 페이지 — 승인하거나 거부하기 전에 제안의 문서와 작업 초안을 읽습니다.

제출 전 유효성 검사 확인

에이전트는 제출 전에 chorus_pm_validate_proposal을 호출합니다. 오류는 제출을 차단합니다. 초안 의존성은 같은 제안 안의 작업 초안을 가리켜야 하며, 자기 참조나 순환은 허용되지 않습니다(E-DEP-UNKNOWN, E-DEP-SELF, E-DEP-CYCLE). 필수 문서, 완료된 요구사항 구체화, 구조화된 수락 기준도 검사합니다. 수정하거나 편집한 뒤 다시 검사하세요. 제출 시에도 서버가 다시 검사합니다.

작업 초안의 kind는 implementation, verification, docs, other 중 하나로 지정할 수 있습니다. 아무것도 지정하지 않으면 I-KIND는 구현 범위를 확인할 수 없다는 정보입니다. 하나라도 지정했지만 implementation이 없으면 W-IMPL 경고가 나오며, 이는 권고 사항이지 제출 차단 오류가 아닙니다. 구현을 어디서 다루는지 또는 문서 전용 변경인 이유를 설명하세요. 경고를 없애려고 구현 작업을 꾸며내지 마세요. 독립 작업에도 의존성이 없다는 경고(W4)를 없애기 위한 인위적인 의존성은 필요하지 않습니다.

검사는 완전성을 확인할 뿐 계획의 품질을 보장하지 않습니다. 작업이 요구사항을 실제로 충족하는지는 검토해야 합니다. Pi의 선택적 제출 전 알림은 기본적으로 꺼진 별도의 클라이언트 기능입니다. Pi를 참고하세요.

승인 또는 거부

제안 오른쪽 위의 작업 메뉴를 엽니다. 검토를 기다리는 제안에 대해 다음을 할 수 있습니다.

승인 — 대화상자에서 제안 작성자에게 남길 메모를 추가(선택)한 뒤 확정합니다. 승인은 계획을 받아들이는 것입니다.
거부 — 대화상자에서 사유를 반드시 입력해야 합니다. 거부는 계획을 되돌려, 에이전트가 초안을 고쳐 다시 제출할 수 있게 합니다. 구체적으로 쓰세요. 문서의 빈틈이나, 수락 기준을 다듬어야 할 작업을 짚어 주면, 다음 버전이 바로 그곳을 고칩니다.

이 연결이 어떻게 동작하는지는 에이전트 플랫폼 참고 문서를 확인하세요.

승인이 만드는 것

승인은 계획이 실제 일이 되는 순간입니다. Chorus는 초안으로부터 다음을 생성합니다.

각 문서 초안은 실제 문서가 되어 프로젝트의 문서 섹션에 나타납니다.
각 작업 초안은 상태가 열림인 실제 작업이 되어 가져가거나 배정할 준비가 되며, 초안의 의존 관계는 실제 작업 의존 관계가 됩니다.

아이디어에 표시되는 상태는 새 제안과 작업에 따라 자동으로 바뀌므로 직접 갱신할 필요가 없습니다. 승인된 제안이 나중에 잘못된 것으로 드러나면 작업 메뉴의 승인 취소를 사용할 수 있습니다. 승인을 취소하면 생성된 작업이 종료되고, 생성된 문서가 삭제되며, 제안이 초안으로 돌아갑니다.

'승인' 항목이 있는 제안의 '작업' 메뉴와, 승인 시 '열림' 상태로 생성될 작업들 — 승인하면 초안이 실제 문서와 '열림' 상태의 작업으로 생성됩니다.

작업이 생성되어 열리면 작업 실행으로 이어가세요.