dev-step-01 계획 검토 및 단계별 진행 제안

dev-step-01.md의 방향은 전반적으로 좋다. 특히 첫 이터레이션에서 DB, 인증, Redis, 유형 선택, 모드 선택을 제외하고 괄호 앞 음수 분배 문제 풀이 기능만 먼저 만든다는 판단은 AGENTS.md의 프로젝트 방향과 잘 맞는다.

다만 첫 단계는 조금 더 작게 쪼개는 것이 좋다. 현재 계획의 “1단계: 프로젝트 초기화”는 적절하지만, 바로 Zustand, Framer Motion, react-katex까지 모두 설치하면 첫 확인 지점이 흐려질 수 있다.

단계별 진행안

Claude의 계획에서 가장 조정하면 좋은 부분은 Zustand와 Framer Motion을 너무 빨리 넣지 않는 것이다.

첫 기능의 핵심은 다음 세 가지다.

상태 관리와 애니메이션은 이 기본 동작이 확인된 뒤 붙이는 편이 단계별 바이브 코딩에 더 잘 맞는다.

매 단계마다 아래 순서를 따른다.

1. 이번 단계 목표를 한 문장으로 정한다
2. 수정할 파일을 2~4개 이하로 제한한다
3. 완료 기준을 명확히 둔다
4. 실행해서 직접 확인한다
5. 다음 단계로 넘어가기 전에 짧게 회고한다

첫 개발 요청은 이렇게 주면 좋다.

1차 이터레이션으로 Next.js 14 프로젝트를 초기화하고, 시작 화면과 /play 페이지 이동까지만 구현해줘. AGENTS.md 규칙을 따르고, 아직 문제 생성 엔진이나 DB/Auth/Redis는 만들지 마.

그 다음 요청은 이렇게 이어갈 수 있다.

2차 이터레이션으로 lib/engine/에 괄호 앞 음수 분배 문제 생성 엔진과 Vitest 단위 테스트를 추가해줘. UI는 건드리지 마.

이런 식으로 “이번 단계에서 하지 않을 것”을 함께 말하면 범위가 잘 고정된다.

현재 프로젝트는 아직 파일이 거의 없는 초기 상태이므로, 위 방식으로 진행하면 작은 단위로 확인하면서 안정적으로 기능을 쌓아갈 수 있다.