-
Notifications
You must be signed in to change notification settings - Fork 0
2주차 회고
- 데이터 파이프라인 구현 완료 — 867,024개 문서 전처리, R2 병렬 업로드 + Supabase bulk INSERT (articles 571,375건 / redirects 295,649건 적재)
- Supabase 클라이언트 연동 및 RLS 정책 적용
- R2 fetch 유틸 구현 (에러 4종 세분화)
- namumark-clone-core
ArticleViewer구현 — npm 미배포 패키지 GitHub 설치, vite alias + crypto shim 통합 - Mintlify 연동 및 docs-as-spec 원칙 확립 —
docs/를 기술 스펙으로 관리하는 흐름 구축 - vitest + @testing-library/react 테스트 환경 구축
-
useRedirect/useGame/useMainPage훅 구현 - 메인 화면 / 게임 화면 / 결과 화면 / 리더보드 전체 화면 구현
- gzip 압축 적용으로 R2 fetch 성능 개선 (288KB →
60KB, 약 7080%) - 자동화 개발 파이프라인 skill 5종 추가 (
auto-develop/auto-plan/auto-implement/auto-sync/auto-pr) -
create-issueskill 및 GitHub 이슈 템플릿 5종(feat/fix/refactor/chore/test) 추가
이번 주의 가장 큰 성과는 AI agent 활용을 이슈 생성부터 PR까지 전 과정 자동화로 발전시킨 것이다. 1주차에 수동 워크플로우(/plan-sprint → /implement → /commit-msg → /create-pr)를 세팅해뒀는데, 이번 주에는 /auto-develop <이슈번호> 단일 명령으로 plan → implement → docs-sync → PR 전 과정이 무승인으로 실행되는 파이프라인을 완성했다. 이슈가 충분히 구체화되어 있으면 사람이 직접 할 일은 이슈 작성과 최종 리뷰뿐이다.
또한 /create-issue skill을 통해 이슈 품질도 끌어올렸다. 자유형 설명을 입력하면 코드베이스를 직접 탐색해 탐색 시작점 파일 경로를 채우고, 모호한 항목을 질문으로 구체화해 최종 이슈를 생성한다. 이슈 템플릿 5종도 함께 추가해 타입별 필수 필드를 강제했다. 1주차에 이슈가 추상적이면 작업 방향 파악에 시간이 걸린다는 것을 배웠는데, 이 문제를 도구 레벨에서 해결한 셈이다.
docs-as-spec 원칙도 실제 자동화와 연결되면서 더 단단해졌다. auto-implement가 구현 전 스펙을 반드시 확인하고, auto-sync가 구현 후 코드와 docs 불일치를 자동 수정하는 구조 덕분에 "코드는 바뀌었는데 문서는 옛날 것"인 상태가 생기지 않는다.
자동화 파이프라인을 구축하면서 이슈를 잘 쓰는 것이 얼마나 중요한지 체감했다. auto-implement는 이슈 코멘트의 작업 계획을 읽어 구현을 진행하기 때문에, 이슈가 모호하거나 탐색 시작점이 빠져 있으면 엉뚱한 방향으로 구현되거나 중간에 stop comment를 남기고 멈춘다. 자동화의 품질 상한선이 이슈의 구체성에 달려 있다는 것을 직접 확인했다. 이슈 하나를 잘 쓰는 데 투자하는 시간이 구현 과정 전체를 단축시킨다.
완전 자동화가 가능해지면서 개발 속도가 실질적으로 달라진다는 것도 배웠다. 수동 워크플로우에서는 각 단계마다 직접 명령어를 입력하고 출력을 확인한 뒤 다음 단계를 실행했는데, 자동화 파이프라인은 그 사이 시간을 모두 없애준다. 결과적으로 개발자가 "무엇을 만들지"에만 집중할 수 있게 된다.
배포
- Vercel 배포 설정 — 프로덕션 환경변수 구성 및 빌드 파이프라인 확인
- 도메인 연결 및 최종 URL 확정
- R2 커스텀 도메인 캐시 설정으로 fetch 속도 개선 — 목표 1초 이내
디자인
- UI 디자인 확정 및 전체 화면 통일 — 기능 구현 우선으로 진행해온 만큼, 배포 전 디자인 시스템 정리 및 전체 화면 일관성 확보
기능 완성
-
daily_prompts데이터 채우기 — 오늘의 문제 실제 운영 시작 - 리다이렉트 체인 엣지케이스 처리 — 연속 리다이렉트 시 무한 루프 방지
- 에러 바운더리 추가 — 프로덕션 화이트스크린 방지
QA
- 전체 게임 플로우 엔드투엔드 검증 (메인 → 게임 → 결과 → 리더보드)
- README 배포 URL 업데이트