실전 프로젝트: SDD Workflow Runner (고급)

프로젝트 목표

터미널에서만 동작하던 SDD 파이프라인을 비개발자도 사용할 수 있도록 웹에서 시각화한다. 자연어 한 문장으로 Plan → Design → Build → Review 전 과정을 실시간으로 보여주는 웹 애플리케이션이다.

왜 웹 시각화가 필요한가?

아키텍처

핵심 기술: SSE (Server-Sent Events)

AI의 결과물이 생성되는 과정을 실시간으로 웹 UI에 스트리밍하기 위해 SSE 방식을 사용한다.

MVP 기능 3가지

인증 방식: OAuth vs API Key

MVP 단계에서는 구현 복잡도를 낮추기 위해 API Key 입력 방식으로 시작할 수 있다. 다만 운영 서비스로 확장할 때는 키 보관 방식, 권한 위임 범위, 계정 기반 로그인 설계를 별도로 검토해야 한다.

핸드오프 문서로 세션 연속성 확보

이 프로젝트처럼 대규모 작업에서는 핸드오프 문서 자동 생성이 중요하다.

전역 설정(CLAUDE.md)에 "작업 종료 시 핸드오프 문서를 작성하라"고 명시해두면 AI가 자동으로 작성한다.

핵심 교훈

교훈	상세
SSE로 실시간 스트리밍	AI 생성 과정을 웹 UI에 실시간 표시
인증 복잡도 관리	MVP에서는 API Key 방식으로 먼저 검증
핸드오프 문서 필수	대규모 작업의 세션 연속성 확보
비개발자 접근성	터미널 → 웹 시각화로 사용자층 확대
운영 단계 인증 재설계	확장 시 OAuth/SSO 같은 계정 기반 로그인 검토

SDD 전체 학습 정리

이 강의를 통해 구축한 SDD 시스템의 전체 모습이다.