프로젝트 로드맵 구조와 본문 원본에서 시작하기
프로젝트 통합 관점의 PR 리뷰 관리하기
CLI 와 IDE 장점을 모두 활용해 프롬프팅하며 리뷰하기
CLI 에이전트 활용 — 리뷰 아웃라인의 빠른 확인과 자동화 테스트 일괄 리포팅
IDE 시각 탭 활용 — 어떤 브랜치 사용중인지 눈으로 보면서 리뷰하기
보너스 — Goal Setting 스킬 사용 시 활용 가능한 최적의 작업 결과 상황판
*[/goal
1) 작업 핵심 목표 및 범위
- lecture-hub 프로젝트의 후속 구현 작업을 자동화 루프로 진행한다.
- 시작 지점: 선행 이슈가 모두 해소된 다음 착수 지점.
- 작업 대상: ISSUE_LIST.md 순서(ISSUE-002~ISSUE-024)의 열린 GitHub 이슈 중 선행 이슈가 해소되어 있고 아직 PR이 없는 것을 차례로 구현.
- 작업 자율성: 사용자의 권한 승인 및 컨펌을 받기 위한 작업 중단 없이, 최대한 모든 권한을 가지고 종료 조건에 도달하거나 모든 구현이 끝날 때까지 작업한다.
2) 작업 세부 규칙
- 브랜치 전략: 각 이슈는 프로젝트 TDD 사이클(Red→Green→Refactor→Report→PR)을 따르고, 그 선행 이슈의 기존 feat/* 브랜치 위에 스택형 draft PR로 분기한다.
- 각 이슈별 TDD 작업 순서:
- TEST 작성
- 코드 구현
- TEST 수행
- TEST 기준 미달성 항목 개선
**5) TEST 기준 모두 충족 시 보고서 작성
- 변경 내용을 상세 기록한 PR 작성 — 다음 작업 수행
7) 작업 내용 중 사용자가 직접 확인 및 외부 플랫폼 연동 수행해야 하는 내용이 있다면 "작업 순서 & 상세 작업 방법 가이드"로 작성**
- 의사결정 로그:
**- docs/PRD_v1.0.md 또는 docs/issues/ISSUE_LIST.md에서 기존에 확정되어 있지 않은 모든 추가 의사결정을 docs/loop/DECISION_LOG.md 에 기록한다.
- 의사결정 각 항목은 CORE(아키텍처·보안·외부의존 선택) 또는 MINOR(네이밍·디렉터리·UI 디테일·로그 포맷)로 분류한다.**
- grep 가능한 카운터를 각각 별도 줄에
CORE: N 과 MINOR: M 으로 유지한다.
3) 종료 조건 및 종료 방법
- 종료 조건 (아래 중 하나라도 충족되는 순간 루프를 즉시 멈춘다):
**- CORE 카운터가 3에 도달 →
STOP REASON: CORE_BUDGET
- MINOR 카운터가 10에 도달 →
STOP REASON: MINOR_BUDGET**
- 선행 이슈가 해소된 열린 이슈가 더 없음 →
STOP REASON: NO_UNBLOCKED_ISSUES
- 평가-진행 라운드(turn = /goal 평가자가 진행 상태를 한 번 점검하는 메인 에이전트 응답 사이클)가 누적 40회에 도달 →
STOP REASON: TURN_CAP (= or stop after 40 turns)
- 종료 방법:
- docs/loop/DECISION_LOG.md 마지막 줄에
STOP REASON: <원인 코드> 한 줄을 덧붙인다.
pnpm typecheck && pnpm test && pnpm lint && pnpm build 를 실행해 네 명령 모두 exit 0 인 출력을 대화에 남겨 증명한다.cat docs/loop/DECISION_LOG.md 를 실행해 CORE: N · MINOR: M 카운터 줄과 STOP REASON: 줄이 보이는 출력을 대화에 남긴다.gh pr list 를 실행해 루프가 연 draft PR 목록을 대화에 남긴다.
4) 기타 제약조건
동작 자체를 리뷰해야 할 때
1. 로컬에서 서비스 실행해줘 → 돌려보기
2. 이미 배포해 뒀기 때문에 → Vercel 에서 Preview 배포 확인
- 각 작업 PR 시점의 배포를 버전별로 개별 확인할 수 있음 → 지난 버전도 다 유지가 됨!