Communitygithub.com

fr-goal

Claude Code 플러그인 스위트: 강력한 계획 수립, devcontainer+worktree 격리, 목표에서 PR까지의 자율성, VibeKanban 실행기로의 단계 디스패치

fr-goal란 무엇인가요?

fr-goal은 개발자가 단일 상호작용 지점(operator touchpoint)을 통해 목표 설정부터 코드 리뷰를 거친 PR 생성까지 전 과정을 자동화하는 AI 에이전트 스킬입니다. 이 스킬은 브레인스토밍, Q&A, 명세 작성 및 리뷰, 계획 수립, TDD 기반 구현, 단계별 리뷰, 그리고 최종 PR 생성을 단계별로 처리합니다. 특히 모든 작업은 격리된 환경(isolation)에서 수행되며, devcontainer나 worktree를 활용하여 기존 개발 환경과 완전히 분리된 상태로 작업합니다. 주요 특징으로는 모든 디자인 결정은 운영자가 소유하고(기본값으로 대체 금지), 수동 작업은 마지막 단계로 백로드되며, 에이전트는 절대 스스로 PR을 병합하지 않습니다. 또한 다중 리포지토리 프로젝트를 처리할 수 있으며, 각 리포지토리별로 별도의 에이전트를 디스패치하여 작업합니다. 이 스킬은 Claude Code 플러그인으로 동작하며, fr-plan, fr-execute, fr-isolation 등의 하위 스킬과 통합되어 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add derio-net/super-fr

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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 실행.

관련 스킬