MFR 변경 추적
스펙의 모든 변화를 기록하기
MFR 구조에서 발생하는 모든 변경 사항을 _changes를 통해 추적하고, 영향도를 분석하는 시나리오.
언제 사용하나?
- 최근 스펙 변경 사항을 팀원들과 공유할 때
- 특정 변경이 다른 문서에 미치는 영향을 파악할 때
- 변경 히스토리를 보고 롤백 여부를 판단할 때
- 외부 시스템(Jira, Slack)에 변경 알림을 보낼 때
흐름도
MFR 변경 발생
(생성/수정/삭제/상태전환)
│
▼
┌─────────────────┐
│ _changes 기록 │
│ │
│ 시점 │
│ 에이전트 │
│ 대상 문서 │
│ 변경 유형 │
│ 요약 │
└────────┬────────┘
│
┌─────┴─────┐
▼ ▼
영향도 분석 외부 연동
│ │
▼ ▼
영향받는 Jira 티켓
_pages, Slack 알림
Task 식별 이메일 통보
추적 대상
| 변경 유형 | 설명 | 기록 예시 |
|---|---|---|
| MFR 변경 | Module/Feature/Requirement 생성·수정·삭제 | "Feature '에스크로 결제' 추가" |
| 상태 변경 | status 전환 | "REQ '사진 업로드' draft → confirmed" |
| 페이지 변경 | _pages 생성·수정 | "Page 05 와이어프레임 갱신" |
| 태스크 변경 | Task 생성·완료·취소 | "TASK '차량 등록 API' 완료" |
구체적 예시: 중고차 거래 앱
변경 내역 타임라인
2026-04-01 09:00 [UIA] created vehicle/registration/REQ-basic-info.md
"차량 기본정보 입력 Requirement 생성"
2026-04-01 09:00 [UIA] created vehicle/registration/REQ-photo-upload.md
"차량 사진 업로드 Requirement 생성 (draft)"
2026-04-01 14:00 [사용자] status vehicle/registration/REQ-photo-upload.md
"draft → confirmed (사진 규격 확정: 10장, 5MB)"
2026-04-01 14:30 [PDA] updated _pages/vehicle/05_registration.md
"사진 업로드 영역 와이어프레임 추가"
2026-04-02 10:00 [TMA] created vehicle/registration/REQ-photo-upload/_tasks/
"사진 업로드 Task 3건 생성 (server/frontend/design)"
2026-04-02 16:00 [사용자] created trade/purchase/REQ-escrow-payment.md
"에스크로 결제 Requirement 추가 (draft)"
2026-04-03 09:00 [사용자] deleted vehicle/inspection/REQ-manual-check.md
"수동 검수 Requirement 삭제 (AI 검수로 대체)"
영향도 분석 예시
Requirement "차량 사진 업로드"가 수정되었을 때:
변경: REQ-photo-upload.md (사진 규격 변경: 10장 → 20장)
│
├── 영향받는 _pages:
│ └── _pages/vehicle/05_registration.md
│ └── 와이어프레임의 사진 영역 갱신 필요
│
├── 영향받는 Task:
│ ├── TASK-photo-upload-server
│ │ └── 업로드 제한 수 변경 필요
│ └── TASK-photo-upload-frontend
│ └── UI 갤러리 그리드 변경 필요
│
└── 외부 연동:
├── Jira: 관련 티켓에 코멘트 추가
└── Slack: #dev-vehicle 채널에 알림
변경 내역 파일 예시
# _changes/2026-04-01.md
- timestamp: "2026-04-01T09:00:00"
agent: UIA
target: vehicle/registration/REQ-basic-info.md
type: created
summary: "차량 기본정보 입력 Requirement 생성"
- timestamp: "2026-04-01T14:00:00"
agent: user
target: vehicle/registration/REQ-photo-upload.md
type: status_changed
from: draft
to: confirmed
summary: "사진 규격 확정 — 최대 10장, 5MB, JPEG/PNG"
impact:
- _pages/vehicle/05_registration.md
디렉터리/파일 구조
{mfr_root}/
├── _changes/
│ ├── 00_index.md # 변경 내역 인덱스 (최신순)
│ ├── 2026-04-01.md # 일별 변경 내역
│ ├── 2026-04-02.md
│ └── 2026-04-03.md
활용 방법
| 활용 | 설명 | 예시 |
|---|---|---|
| 팀 동기화 | 데일리 스크럼에서 최신 변경 확인 | "어제 사진 업로드 스펙이 확정되었습니다" |
| 영향도 분석 | 변경으로 인한 파급 효과 파악 | "인증 방식 변경 → 5개 페이지 갱신 필요" |
| 롤백 판단 | 변경 이전 상태로 복구 여부 결정 | "에스크로 결제 삭제 → 관련 Task도 정리" |
| 외부 연동 | Jira/Slack 등에 자동 알림 | "스펙 변경 → Jira 티켓 코멘트 자동 추가" |
관련 에이전트
- UIA, PDA, TMA: 각 에이전트가 MFR을 변경할 때마다 _changes에 기록
- 변경 추적 자체는 HanSpec 코어 시스템이 처리
관련 페이지
- MFR 수정 — 변경이 발생하는 주요 시나리오
- MFR 동기화 — 동기화로 인한 변경 추적
- _changes 상세 — _changes 개념과 구조