AI를 활용해 딸깍하고 개발하는 프로세스를 단계별로 예를 들어 자세히 설명할게. 요청하신 네 가지 도구(PRD, Speckit, Pumasi, Ralph-loop)를 중심으로 각 단계가 어떻게 이어지는지 차근차근 정리합니다.
1. PRD로 서비스 기획 및 개발 문서 작성
- 서비스의 목표, 주요 기능, 사용자 요구사항 등을 상세히 정리하는 문서
- 예시)
- 목표: 대학생 자녀를 둔 부모를 위한 교육 관리 앱 개발
- 주요 기능: 로그인, 강의 일정 확인, 알림, 성적 관리, 커뮤니케이션 기능
- 요구사항: 모바일과 웹 모두 지원, 보안 인증 반드시 포함
- PRD 작성 과정을 통해 팀과 공유할 명확한 로드맵과 요구사항이 만들어진다.
2. Speckit으로 SDD(설계 문서) 진행
- PRD에서 정의한 기능과 요구사항을 바탕으로 시스템 설계 문서 작성
- 구체적인 데이터 흐름, 아키텍처, 인터페이스, API 명세 등을 명확히 함
- 예시)
- 사용자 로그인 방식: JWT 인증 방식을 채택
- DB 테이블 설계: 사용자, 강의, 알림, 성적 테이블 구조 작성
- API 명세:
/login,/lectures,/notifications등 REST API 설계 - Speckit을 통해 명확하고 일관된 설계 문서 작성, 개발자와 디자이너가 공유
3. Pumasi로 코드 작성 및 병렬 개발
- Claude Code와 Codex 같은 AI 코딩 도구를 병렬로 활용하여 빠르게 코드 생성
- 명확하게 작성된 SDD를 기반으로 AI가 필요한 모듈과 기능을 동시에 개발
- 예시)
- Claude Code가 로그인 모듈을 작성하고, Codex가 강의 조회 API 코드를 동시에 개발
- 이후 병렬로 작성된 코드들을 Pumasi 플랫폼에서 리뷰 및 머지(통합)
- 자동 테스트 및 코드 스타일 검증 병행하여 품질 유지
- AI 도움으로 개발 속도를 극대화하고 병목 없는 병렬 작업 가능
4. Ralph-loop를 통한 끊임없는 SDD 진행 및 개선
- 실제 개발 및 테스트 중 발생한 문제점과 요구 변경을 Ralph-loop에 반영
- SDD 문서를 지속해서 업데이트하고 코드도 개선하는 무한 루프 수행
- 예시)
- 사용자 피드백 반영해 기능 추가 및 설계 변경
- 보안 취약점 발견 시 즉시 SDD에 반영하고 관련 코드 수정
- Ralph-loop에 의해 문서와 코드가 동시에 최신 상태로 유지됨
- 이렇게 반복해서 프로세스가 계속 돌면서 서비스 완성도 상승
요약
| 단계 | 역할 | 주요 작업 | 도구 활용 예시 |
|---|---|---|---|
| 1. PRD | 서비스 구상, 요구사항 정의 | 목표 설정, 기능 리스트 작성 | PRD 문서 작성 |
| 2. Speckit | 시스템 설계(SDD) | 아키텍처, DB 설계, API 명세 | 설계 문서 작성 및 공유 |
| 3. Pumasi | AI 병렬 코드 작성, 병합 | AI 코딩(Claude, Codex), 코드 병합 및 테스트 | AI 코드 자동 생성 및 머지 |
| 4. Ralph-loop | 지속적 설계 및 개선 | 설계 문서 업데이트, 코드 보완 반복 | 무한 루프 피드백 및 개선 |
이 과정을 통해 AI가 촉진하는 개발 프로세스가 어떻게 순환하며 이루어지는지 한눈에 파악할 수 있을 거야. PRD로 시작해 Speckit에서 설계, Pumasi로 AI 병렬코딩, Ralph-loop로 끊임없는 개선을 반복하면서 개발의 효율성·품질을 최대화하는 흐름이지.
각 도구별 활용 구체 사례와 세부 절차를 단계별로 자세히 설명합니다. 이 과정에서는 실제 개발 현장에서 어떻게 활용하는지 이해하기 쉽게 실제 예시와 구체적인 절차 위주로 다뤄볼게.
1. PRD (Product Requirement Document) 작성
구체 사례
- 신입 사원 교육 관리 웹서비스 개발 프로젝트
- 목표: 사용자 친화적인 교육 신청 및 관리 시스템 제공
- 주요 기능: 회원가입/로그인, 강의 신청, 교육 일정 조회, 알림 발송
- 요구사항: PC/모바일 웹환경 모두 지원, 1만 명 동시 접속 가능
세부 절차
- 이해관계자(서비스 기획자, PM, 커스터머) 미팅
- 사용자 요구사항 수집 (인터뷰, 설문 등)
- 기능 목록 작성 및 우선순위 정리
- 서비스 목표 및 핵심 지표(KPI) 정의
- 기능 상세 설명, 비즈니스 규칙 포함 작성
- 문서 공유 및 피드백 반영 후 최종 확정
2. Speckit을 활용한 SDD (Software Design Document) 작성
구체 사례
- PRD 기반 로그인 시스템 설계
- JWT 토큰 기반 인증 설계 및 API 명세 작성
- 데이터베이스 테이블 스키마: Users 테이블 설계 (id, 이메일, 비밀번호(hashed), 가입일 등)
세부 절차
- PRD 기능별 핵심 로직 추출
- 시스템 아키텍처 설계 (클라이언트, 서버, DB 관계)
- API 스펙 정의 (URL, HTTP 메서드, 요청/응답 데이터 형식)
- 데이터베이스 ER(Entity-Relationship) 다이어그램 작성
- 보안, 예외 처리, 오류 코드 정책 등 기술적 상세 명시
- 설계문서 내역 팀원과 공유 및 리뷰 → 승인
3. Pumasi로 AI 병렬코드 작성 및 머지
구체 사례
- Claude Code에 로그인 기능 작성 요청
- Codex에 강의 목록 CRUD API 구현 요청
- AI가 동시에 생성한 코드 충돌 없이 병합
세부 절차
- SDD의 API 스펙과 데이터베이스 설계를 Pumasi에 입력
- 각 AI 엔진에 담당 모듈별 코드 생성 명령 전달
- 자동 생성 코드 초기 검토 및 단위 테스트 실행
- Pumasi 내 코드 자동 병합 기능 사용, 버전 관리(Git과 연동)
- 충돌 발생 시 AI와 사람이 함께 리뷰, 수정 처리
- 통합된 코드 리포지토리에 빌드 및 통합 테스트
4. Ralph-loop를 이용한 지속적 SDD 관리 및 개선
구체 사례
- 고객 피드백 반영해 교육 알림 기능에 푸시 알림 옵션 추가
- 보안 강화 위해 인증 프로토콜 일부 수정 필요 발생
- 성능 이슈로 일부 API 최적화 설계 반영
세부 절차
- 개발 및 배포 후 사용자 또는 QA 피드백 수집
- Ralph-loop에 피드백과 변경 요청 입력 및 설계 변경안 작성
- 변경된 설계문서를 다시 팀 내 공유하고 검토
- 변경된 SDD 기준으로 AI 혹은 개발자가 코드 업데이트
- 변경 사항 테스트 후 배포, 다시 피드백 루프로 이동
- 이 과정을 반복하면서 서비스 완성도 향상
이처럼 각 도구의 특징과 역할별로 명확하게 분리되어 있고, 단계별 절차도 명확해서 업무 효율과 품질을 높이는 데 도움이 된다.