기획과 개발, 어떻게 연결할 것인가

전통적 프로세스 (몇 주~몇 달)

기획서 작성 → 디자인 시안 → 개발 착수 → QA → 배포
     ↑                                      |
     └──────── 수정 요청 (반복) ──────────────┘

오늘의 파이프라인 (5시간)

AI 기획 → 핸드오프 문서 → AI 개발 → 즉시 피드백 → 배포
    ↑                                    |
    └──────── 실시간 수정 ────────────────┘

파이프라인 전체 다이어그램

 1.기획    →  2.핸드오프  →   3.개발    →  4.피드백   →   5.완성
 ·컨셉       ·문서작성      ·코드생성     ·기획검토      ·통합
 ·페르소나    ·항목정리      ·API구현     ·수정요청      ·테스트
 ·기능정의    ·전달         ·UI구현      ·반영          ·배포
 ·시나리오
 (기획자)    (기획자)      (개발자)    (기획자+개발자) (개발자)

Claude AI를 전 과정에서 활용합니다.

모노레포 전략

기획과 개발을 하나의 저장소에서

workshop-monorepo/
├── planning/        ← 기획자 (React 웹)
│   └── 와이어프레임, 화면 내용, 스토리
├── app/             ← 개발자 (React Native)
│   └── 기획 결과물을 기반으로 앱 구현
└── api/             ← Git Submodule (별도 저장소)
    └── Cloudflare Workers API

왜 모노레포인가?

기획자와 개발자가 같은 코드베이스에서 작업

• 기획자: React로 와이어프레임 + 화면 내용 작성
• 개발자: 기획자의 React 결과물을 보며 React Native로 구현
• 같은 저장소이므로 변경사항이 즉시 공유됨

기획자가 만든 화면을 개발자가 바로 참조할 수 있습니다

API 분리 — Git Submodule

보안을 위한 저장소 분리

# API를 서브모듈로 추가
git submodule add git@github.com:team/api.git api

외부 공개의 장점

기획 내용을 누구나 볼 수 있다

• 포트폴리오로 활용 가능
• 외부 피드백을 받을 수 있음
• API 키·비밀 정보는 private 저장소에 안전하게 보관

핸드오프 문서 — 항목 1~4

기획자가 개발자에게 전달해야 할 필수 항목:

핸드오프 문서 — 항목 5~7

7가지를 빠짐없이 정리하면, 개발자가 질문 없이 작업을 시작할 수 있습니다.

왜 추적 기록이 중요한가

• 무엇을 시도했고, 무엇이 실패했는지 추적
• 기획 변경 이력을 남겨 혼선 방지
• AI에게 맥락을 제공할 때도 유용

추적 기록 양식 (예시)

## 2026-03-21 워크샵 기록

### 오전 — 기획 단계
- [완료] 앱 컨셉 확정: "산책메이트"
- [변경] 타겟 사용자: 20대 → 전 연령대로 확대
- [이슈] 채팅 기능 범위 논의 필요

추적 기록이 없으면 "왜 이렇게 했지?"에 답할 수 없습니다.

소통 원칙 (1)

1. 구체적으로 말하기

• "이거 좀 이상해요"
• "로그인 버튼 누르면 홈으로 안 넘어가요"

2. 시각 자료 활용하기

• 스크린샷을 찍어서 공유
• "여기" 대신 정확한 위치 설명

소통 원칙 — 우선순위 명시하기

3. 우선순위 명시하기

• 필수 — 이것 없이는 앱이 안 됨
• 권장 — 있으면 좋지만 없어도 동작
• 선택 — 시간이 남으면 추가