Windsurf Cascade & Flows로 대규모 코드베이스 작업하기

High class 약 20분활용 사례

💡 Windsurf의 Cascade 에이전트는 코드베이스 전체를 이해하고 복잡한 리팩토링을 자율적으로 수행해요. MCP 통합으로 외부 도구도 AI가 직접 사용합니다.

🔒 windsurf.com

실제 화면

실수 방지 체크리스트

1Agentic Mode에서 Accept All 무분별 사용 → 의도치 않은 파일 수정 — 변경 파일 목록 확인 후 중요 파일은 개별 승인
2대규모 작업 전 Git commit 생략 → 문제 발생 시 되돌리기 불가 — 항상 작업 전 Git commit으로 체크포인트 확보
3MCP 토큰을 설정 파일에 평문 저장 → 보안 위험 — 환경변수로 분리하거나 OS 키체인에 저장

STEP 1 / 4…

STEP 1. Windsurf Cascade 에이전트 활용

🔒 codeium.com

실제 화면

Cascade는 Windsurf의 핵심 에이전트 기능입니다.

프롬프트

# Cascade 패널 열기
Ctrl+L (Mac: ⌘+L)  # Cascade 채팅 열기
Ctrl+I (Mac: ⌘+I)  # 인라인 편집 모드

# Cascade 모드
Chat Mode    # 질문·분석 (파일 수정 없음)
Write Mode   # 코드 작성·수정 (기본)
Agentic Mode # 자율 에이전트 (파일 탐색·실행 포함)

# Agentic Mode 작업 예시
'이 Python Flask 앱을 FastAPI로 마이그레이션해줘.
모든 라우트, 미들웨어, 에러 핸들러 포함'

'이 코드베이스에서 SQL 인젝션 취약점을 찾아
모두 파라미터화 쿼리로 수정해줘'

'테스트 커버리지 50% 미만인 파일을 찾아
Pytest 유닛 테스트를 작성해줘'

# 컨텍스트 추가
@파일명   # 특정 파일 참조
@폴더명   # 폴더 전체
@Web     # 웹 검색
@Docs    # 공식 문서 참조

💡

Agentic Mode는 스스로 파일을 탐색하고 터미널 명령도 실행합니다. 변경 범위가 크면 Git commit을 먼저 하고 진행하세요. Accept All 전에 변경 목록을 반드시 확인하세요.

이 단계를 완료했나요?