Document 01READ · PRACTICE · VERIFY
01. 설치와 코드베이스 이해
Windsurf를 설치하고 저장소를 열어 에이전트가 맥락을 파악하게 합니다.
- 설치와 로그인
- 저장소 열기
- 인덱싱 확인
- 첫 구조 설명 요청
이 프로젝트의 진입점과 데이터 흐름을 먼저 설명해줘 활용 도구Windsurf 공식 문서
Codeium · Resource folder
Windsurf
에이전트가 코드베이스를 넘나들며 작업하는 흐름(Cascade)을 규칙과 검증으로 안전하게 다룹니다.
학습 자료4개 문서
Document 02READ · PRACTICE · VERIFY
02. 규칙으로 경계 정하기
프로젝트 규칙으로 확인 명령과 수정 금지 영역, 완료 조건을 고정합니다.
- 규칙 파일 작성
- 확인 명령 명시
- 금지 영역 지정
- 완료 조건 정의
# rules
- 변경 전 관련 테스트를 먼저 읽기
- 마이그레이션 파일은 함부로 수정 금지 Document 03READ · PRACTICE · VERIFY
03. Cascade 에이전트 작업
큰 작업을 계획 후 단계로 나눠 실행하고 각 단계를 승인하며 진행합니다.
- 계획 먼저 요청
- 단계별 승인
- 다중 파일 변경 추적
- 실패 시 롤백
바로 수정하지 말고 변경 계획과 영향 파일을 먼저 보여줘 Document 04READ · PRACTICE · VERIFY
04. 검토와 검증
에이전트 변경을 diff로 확인하고 테스트로 동작을 고정합니다.
- diff 검토
- 예상 밖 변경 거절
- lint·test 실행
- 커밋 단위 정리
git diff
npm run lint && npm testApply what you learned