c7b75013c4
- 기능 요건 정의 템플릿 (Confluence 복사용) - AI 프롬프트 템플릿 8종 (플로우차트, 스펙검토, 공수산정 등) - 스펙 검토 체크리스트 48개 항목 + 판정 기준 - 플로우차트 검증 기준 (구조/가독성/Mermaid 문법) - 전체 스펙 검토 워크플로우 (STEP 1-6, RACI, 소요시간)
175 lines
5.6 KiB
Markdown
175 lines
5.6 KiB
Markdown
# 스펙 검토 워크플로우
|
|
|
|
> 신규 기능 개발 시 스펙 문서 작성부터 개발 착수까지의 전체 프로세스입니다.
|
|
|
|
---
|
|
|
|
## 전체 흐름
|
|
|
|
```mermaid
|
|
flowchart TD
|
|
A([신규 기능 요청]) --> B[기획자: 스펙 초안 작성]
|
|
B --> C[AI로 플로우차트 자동 생성]
|
|
C --> D[기획자 셀프 체크리스트 검토]
|
|
D --> E{체크리스트\n통과 90%+?}
|
|
E -->|No| F[스펙 보완]
|
|
F --> D
|
|
E -->|Yes| G[개발자 스펙 검토]
|
|
G --> H{개발 가능\n여부 확인}
|
|
H -->|보완 필요| I[보완 요청 및 재검토]
|
|
I --> G
|
|
H -->|승인| J[Confluence Wiki 등록]
|
|
J --> K([개발 착수])
|
|
```
|
|
|
|
---
|
|
|
|
## 단계별 상세 설명
|
|
|
|
### STEP 1. 스펙 초안 작성 (기획자)
|
|
|
|
**담당**: 기획자 / PM
|
|
**산출물**: 기능 요건 정의서 초안
|
|
**도구**: `01-feature-requirements-template.md` 템플릿 활용
|
|
|
|
**작업 내용**:
|
|
1. `01-feature-requirements-template.md`를 Confluence에 복사
|
|
2. 각 섹션 작성 (기본 정보, 배경, 사용자 스토리, 기능 요건 등)
|
|
3. Figma 디자인 링크 연결
|
|
|
|
**완료 기준**: 템플릿의 모든 필수 섹션 작성 완료
|
|
|
|
---
|
|
|
|
### STEP 2. AI 플로우차트 자동 생성 (기획자)
|
|
|
|
**담당**: 기획자 / PM
|
|
**산출물**: Mermaid 플로우차트
|
|
**도구**: `02-ai-prompt-templates.md` 프롬프트 활용
|
|
|
|
**작업 내용**:
|
|
1. Claude에 작성한 스펙 문서와 함께 **프롬프트 A** 입력
|
|
2. 생성된 Mermaid 코드를 [Mermaid Live Editor](https://mermaid.live)에서 확인
|
|
3. 필요 시 **프롬프트 G**로 수정 요청
|
|
4. 완성된 플로우차트를 스펙 문서 섹션 8에 삽입
|
|
|
|
**추가 옵션**:
|
|
- API 연동이 복잡한 경우: **프롬프트 C** (시퀀스 다이어그램) 추가 생성
|
|
- 스펙 품질 확인이 필요한 경우: **프롬프트 D** (스펙 완성도 검토) 실행
|
|
|
|
**완료 기준**: 플로우차트가 스펙 문서에 포함되고 렌더링 정상 확인
|
|
|
|
---
|
|
|
|
### STEP 3. 셀프 검토 (기획자)
|
|
|
|
**담당**: 기획자 / PM
|
|
**도구**: `03-spec-review-checklist.md`
|
|
|
|
**작업 내용**:
|
|
1. `03-spec-review-checklist.md`의 체크리스트를 Confluence에 복사
|
|
2. 각 항목 순서대로 검토
|
|
3. 통과율 계산 및 판정 결과 기록
|
|
|
|
**통과 기준**: 90% 이상 (48개 중 44개 이상)
|
|
**미통과 시**: 해당 항목 보완 후 재검토
|
|
|
|
---
|
|
|
|
### STEP 4. 개발자 스펙 검토
|
|
|
|
**담당**: 프론트엔드 개발자 (담당 개발자 + 리드 검토)
|
|
**도구**: `03-spec-review-checklist.md`, `04-flowchart-validation.md`
|
|
|
|
**작업 내용**:
|
|
1. 스펙 문서 전체 검토
|
|
2. 플로우차트 검증 기준(`04-flowchart-validation.md`) 적용
|
|
3. 기술적 실현 가능성 검토:
|
|
- API 스펙 충분한가
|
|
- 성능 요건 달성 가능한가
|
|
- 기술 스택(Nuxt 4, TS) 내에서 구현 가능한가
|
|
4. 공수 산정: **프롬프트 F** 활용 후 검토자가 조정
|
|
5. 검토 결과를 Confluence 댓글 또는 체크리스트 검토자 란에 기록
|
|
|
|
**완료 기준**: 개발자 승인 또는 보완 요청 목록 작성
|
|
|
|
---
|
|
|
|
### STEP 5. Confluence Wiki 등록
|
|
|
|
**담당**: 기획자 / PM
|
|
**산출물**: 확정된 스펙 문서 (Wiki 등록 완료)
|
|
|
|
**작업 내용**:
|
|
1. 스펙 문서 상태를 "확정"으로 변경
|
|
2. Confluence 페이지 트리 구조에 등록:
|
|
```
|
|
[프로젝트명]
|
|
└── 기능 스펙
|
|
└── [기능명] - [날짜]
|
|
├── 기능 요건 정의서
|
|
├── 플로우차트
|
|
└── 스펙 검토 결과
|
|
```
|
|
3. 관련 팀원에게 Confluence 알림 발송
|
|
4. 개발 티켓(GitLab Issue/Jira)에 스펙 문서 링크 연결
|
|
|
|
**완료 기준**: Confluence 페이지 공개 상태 확인, 팀 알림 발송 완료
|
|
|
|
---
|
|
|
|
### STEP 6. 개발 착수
|
|
|
|
**담당**: 프론트엔드 개발자
|
|
|
|
**개발 착수 전 최종 확인**:
|
|
- [ ] 스펙 문서 상태: "확정"
|
|
- [ ] 체크리스트 통과율: 90% 이상
|
|
- [ ] 플로우차트: Confluence 등록 완료
|
|
- [ ] Figma 디자인: 확정 상태
|
|
- [ ] API 명세: 백엔드 팀 확인 완료
|
|
- [ ] 개발 티켓: 생성 및 스펙 링크 연결 완료
|
|
|
|
---
|
|
|
|
## 역할별 책임 (RACI)
|
|
|
|
| 활동 | 기획자 | 개발자(담당) | 개발자(리드) | 디자이너 |
|
|
|------|--------|-----------|-----------|---------|
|
|
| 스펙 초안 작성 | **R** | C | C | C |
|
|
| 플로우차트 생성 | **R** | I | I | I |
|
|
| 셀프 체크리스트 | **R** | - | - | - |
|
|
| 개발자 스펙 검토 | C | **R** | **A** | - |
|
|
| Confluence 등록 | **R** | I | I | I |
|
|
| 개발 착수 승인 | A | - | **R** | - |
|
|
|
|
> R: Responsible (실행) / A: Accountable (승인) / C: Consulted (협의) / I: Informed (통보)
|
|
|
|
---
|
|
|
|
## 소요 시간 기준
|
|
|
|
| 단계 | 기능 규모 小 | 기능 규모 中 | 기능 규모 大 |
|
|
|------|-----------|-----------|-----------|
|
|
| 스펙 초안 작성 | 0.5일 | 1~2일 | 3~5일 |
|
|
| AI 플로우차트 생성 | 0.5시간 | 1시간 | 2시간 |
|
|
| 셀프 체크리스트 | 0.5시간 | 1시간 | 2시간 |
|
|
| 개발자 스펙 검토 | 1시간 | 2~4시간 | 1일 |
|
|
| Confluence 등록 | 0.5시간 | 1시간 | 1시간 |
|
|
|
|
> **기능 규모 기준**
|
|
> - 小: 단일 화면, API 1~2개
|
|
> - 中: 2~3개 화면, API 3~5개
|
|
> - 大: 4개 이상 화면, API 6개 이상 또는 복잡한 상태관리 필요
|
|
|
|
---
|
|
|
|
## 관련 문서
|
|
|
|
| 문서 | 설명 | 위치 |
|
|
|------|------|------|
|
|
| 기능 요건 정의 템플릿 | 스펙 작성 양식 | `01-feature-requirements-template.md` |
|
|
| AI 프롬프트 템플릿 | 플로우차트 자동 생성 | `02-ai-prompt-templates.md` |
|
|
| 스펙 검토 체크리스트 | 품질 검증 기준 | `03-spec-review-checklist.md` |
|
|
| 플로우차트 검증 기준 | 다이어그램 품질 기준 | `04-flowchart-validation.md` |
|