fe-agent/docs/spec-review/05-workflow.md

스펙 검토 워크플로우

신규 기능 개발 시 스펙 문서 작성부터 개발 착수까지의 전체 프로세스입니다.

---

전체 흐름

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에서 확인
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개
• 中: 23개 화면, API 35개
• 大: 4개 이상 화면, API 6개 이상 또는 복잡한 상태관리 필요

---

관련 문서

문서	설명	위치
기능 요건 정의 템플릿	스펙 작성 양식	01-feature-requirements-template.md
AI 프롬프트 템플릿	플로우차트 자동 생성	02-ai-prompt-templates.md
스펙 검토 체크리스트	품질 검증 기준	03-spec-review-checklist.md
플로우차트 검증 기준	다이어그램 품질 기준	04-flowchart-validation.md