fr-goal은(는) 무엇을 하나요?
운영자가 목표에서 리뷰된 PR까지 단일 터치포인트로 연결: 브레인스토밍 → 원스톱 배치 Q&A → 명세 → 리뷰 → fr-plan → 리뷰 → TDD 구현 → 리뷰 → 단일 PR. 모든 리뷰는 발견된 모든 문제를 수정합니다. 운영자의 자율 명령어는 각 슈퍼파워 승인 중단을 리뷰-수정 패스로 대체합니다. 막혔을 경우: 멈추고, 무엇이 막혔고 무엇을 시도했는지 말한 후 질문하세요 — 잘못된 추측을 PR로 배송하는 것은 중단된 실행보다 더 큰 비용이 듭니다.
시작 시 알림: "저는 fr-goal을 사용하여 이 목표를 자율적으로 실행하고 있습니다."
대화형으로 유지되는 부분
| 순간 | 이유 |
|---|---|
| 배치 Q&A (한 번, 브레인스토밍 중) | 디자인 결정은 운영자가 소유 — 답변 없음 = 중단, 기본값으로 대체 금지 |
| 다중 프로젝트 리포지토리 위치 | 접근 질문 — 파일 시스템이 답할 수 없는 경우에만 |
| 수동 단계 | 비밀, UI 작업, 배포는 인간 전용 — 배치 정책 참조 |
| PR 병합 | 에이전트는 절대 스스로 병합하지 않음 |
| 병합 후 테스트 계획 | 실제 배포를 증명하며 운영자 환경이 필요 |
1. 격리 상태에서 배치 Q&A로 브레인스토밍
fr-brainstorming 호출 (fr isolation up을 먼저 실행; devcontainer 프로필이 없으면 → fr-init 인터뷰를 위해 일시 중지). 격리는 모든 것보다 먼저 수행됩니다 — 탐색, 측정, 클러스터 작업 포함; 운영자가 "X로 시작"하면 첫 번째 작업 항목이 변경될 뿐, 첫 번째 작업은 변경되지 않습니다. 탐색하고, 모든 운영자 소유 결정을 수집하고, 모든 질문을 하나의 AskUserQuestion 호출(최대 4개 질문, 첫 번째 권장)로 질문하세요. 딜리버러블이 배포되는 경우(서비스/봇/인프라)에만 병합 후 테스트 계획 질문을 포함하고, 순수 코드의 경우 포함하지 마세요. 지연 질문을 배치 처리하세요. 하드 게이트: 답변되지 않은 호출은 중지 신호입니다 — 턴을 종료하고 열린 질문을 다시 설명하며 기다리세요. 절대 기본값을 실제 답변으로 대체하지 마세요.
2. 명세 작성 후 리뷰
docs/superpowers/specs/<YYYY-MM-DD-slug>-design.md를 작성한 후, Q&A 답변 및 코드베이스 현실(파일/헬퍼/서비스가 존재하는지?)을 기준으로 리뷰하세요. 모든 발견 사항을 수정하세요. 테스트 계획이 선택되면 명세에는 ## 테스트 계획 섹션에 병합 후 단계가 포함됩니다.
3. 다중 프로젝트 확인
교차 리포지토리 명세(owner/repo:path 형식)의 경우, 이 세션은 하나의 리포지토리에 대한 계획과 PR만 소유합니다. 다른 각 리포지토리에 대해: 작업 복사본을 직접 찾고(형제 디렉토리, 일반적인 루트), 찾을 수 없는 경우에만 경로/클론을 요청하세요 — Q&A에 배치 처리합니다. 리포지토리당 하나의 에이전트(isolation: "worktree")를 명세 참조 및 4단계부터의 파이프라인과 함께 디스패치합니다. 리포지토리당 하나의 계획, 하나의 PR.
4. 계획 수립 — fr-plan 후 리뷰
fr-plan을 호출하고, 섹션별 승인은 건너뜁니다(명세가 디자인을 인코딩합니다). v2 계획-폴더 형태, TDD 형태의 단계를 유지하세요. 리뷰: fr plan self-review가 통과해야 하고, 단계를 명세와 대조하여 다시 읽어야 합니다(모두 포함되었는지 확인). 수정하고 구현하세요.
5. 수동 단계 — 기본적으로 백로드
fr-plan의 에이전트 순수성 게이트는 수동 작업을 전용 [manual] 단계로 수집합니다. fr-goal은 배치 정책을 추가합니다(계획 중간의 수동 단계는 실행을 지연시킵니다):
- 기본적으로 백로드: 모든 수동 작업은 마지막 단계에, 에이전트 단계는 이에 의존하지 않음. PR은 의도적으로 구현되지 않은 상태로 배송되며, 운영자용으로 표시되고, 운영자가 구현하여 동일한 PR에 푸시합니다(
fr plan edit --complete-phase N --note). - 에이전트 작업이 진정으로 의존하는 경우에만 프론트로드. 계획 + 리뷰 완료 후, 명세 + 계획의 PR을 열고(수동 지침이 딜리버러블임), 일시 중지; 운영자의 진행 신호가 있을 때만 재개.
- 다중 리포지토리: 교차 리포지토리 종속성 모델링 —
depends_on은 계획 내에서만 유효하므로, 순서는 명세와 PR 시퀀싱에 따라 결정됩니다(한 리포지토리의 비밀이 다른 리포지토리의 단계를 게이트할 수 있음).
6. 구현 — fr-execute 로컬 모드, TDD, 서브에이전트 없음
1단계 격리 워크스페이스가 작업 복사본입니다 — 모든 명령은 fr isolation exec를 통해 실행합니다. fr-execute를 LOCAL 모드(계획-디렉토리 + 단계)로 실행하고, 디스패치하지 마세요(명세/계획이 main에 없으며, fr apply --yes가 거부함). 서브에이전트 없이 인라인으로 구현합니다(컨텍스트에 Q+A + 명세 이력이 필요함). 각 단계별 TDD; 단계 체크 / 단계 완료는 fr plan edit를 통해 수행합니다. 수동 단계는 절대 없습니다.
구현 레이어는 브랜치만 푸시합니다 — PR은 열지 않습니다(인라인 또는 위임된 다중 리포지토리 빌더). 여기서 PR을 열면 전달(8)이 리뷰(7)보다 앞서게 되어, 운영자가 수정 사항이 존재하기 전에 병합할 수 있습니다 — 병합된 브랜치에 고립됩니다(#320, 3회). 오케스트레이터는 가시성을 위해 초안 PR을 엽니다 — 8단계까지 병합 불가능하며, "초안" 배지는 "아직 병합하지 마세요"를 의미합니다.
7. 마일스톤에서 리뷰 — 발견된 모든 것 수정
각 마일스톤(완료된 단계 또는 소규모 계획의 전체 구현) 후에, 명세 + 계획 + 코드에 대해 superpowers:requesting-code-review를 호출하세요. 모든 발견 사항을 즉시 수정하고 테스트를 추가하세요. 사실적으로 잘못된 발견 사항은 반박 근거(superpowers:receiving-code-review)를 제시하고, 절대 조용히 무시하지 마세요. 발견 사항 목록을 유지하세요.
8. 전달 — 리포지토리당 하나의 PR, 모든 아티팩트 포함
먼저 검증(superpowers:verification-before-completion): 전체 테스트 스위트 출력, 자체 리뷰 통과, 단계 체크 완료. PR은 지금(7단계 수정 후)에만 병합 가능 상태가 됩니다: 초안 PR에 gh pr ready 실행 — 이전에는 절대 "병합 준비 완료"라고 말하지 마세요. PR 본문: 요약 + 명세/계획 경로; 리뷰 발견 사항 및 수정 사항(반박된 발견 사항 포함); 백로드된 수동 단계는 "구현되지 않음 — 운영자가 이 PR에 푸시"로 표시; 테스트 계획은 그대로, "병합 후 — 운영자 주도" 레이블. 중지; 운영자가 병합합니다.
9. 병합 후 마무리
운영자가 병합을 보고하면: 먼저 수정 사항이 main에 도달했는지 확인하세요 — fr isolation verify-merge --branch <b> 실행(squash/재배치/병합 안전; 종료 코드 1 = 확인되지 않음). 확인되지 않음 → 중지하고 복구(체리픽 / 새 PR). 그런 다음 테스트 계획이 있으면 실행하고(에이전트가 검사 실행, 운영자가 접근 불가능한 항목 확인), 단계 완료 확인(fr status), fr archive <plan-dir>, 하우스키핑 PR을 통해 커밋, fr isolation down 실행.