phase-tracking

Phase Tracking Skill

다단계(Multi-Phase) 기능 구현을 체계적으로 추적하고 관리하는 프로세스.

문제 배경

Agent가 Phase 1 MVP 완료 후 Phase 2 항목을 방치하는 문제:

• Phase 2 항목이 "Future Work" 문서로 이동 후 능동적 추적 종료
• "MVP 완료" 선언 후 나머지 항목 시작 트리거 없음
• 외부 의존성 항목이 무기한 대기
• 전체 기능 완료까지의 진행률 파악 어려움

적용 시점

이 skill은 다음 상황에서 적용:

• *_FEATURE.md에서 Phase 1/2 구분 발견 시
• "Phase N complete" 선언 시
• gap-analysis에서 Phase 2 항목 발견 시
• 사용자가 phase 상태 요청 시

Phase 식별 기준

FEATURE 문서에서 Phase 마커 인식

### 인식 패턴

| 패턴 | Phase |
|------|-------|
| "Phase 1", "Phase 1 MVP", "MVP" | Phase 1 |
| "Phase 2", "Future", "향후" | Phase 2 |
| "Phase 3", "Long-term" | Phase 3 |
| 테이블 내 "MVP ✅" | Phase 1 |
| 테이블 내 "Phase 2" 열 | Phase 2 |

### 예시

```markdown
## 1.3 주요 기능

| 기능 | MVP |
|------|-----|
| Quality Spec YML | ✅ |
| Generic Tests | ✅ |
| Airflow DAG | Phase 2 |
| Slack 알림 | Phase 2 |

→ Phase 1: Quality Spec YML, Generic Tests → Phase 2: Airflow DAG, Slack 알림

---

## Phase 관리 프로세스

### Step 1: Phase 파싱

*_FEATURE.md에서 Phase별 항목 추출:

```markdown
## Phase Structure: FEATURE_QUALITY

### Phase 1 (MVP)
| # | Item | Category |
|---|------|----------|
| 1 | Quality Spec YML schema | Core |
| 2 | QualityAPI (list, get, run, validate) | API |
| 3 | CLI commands (list, get, run, validate) | CLI |
| 4 | DLI-6xx error codes | Errors |
| 5 | Built-in Generic Tests (5 types) | Tests |

**Total:** 5 items

### Phase 1.5 (Server Integration) - Inferred
| # | Item | Dependency |
|---|------|------------|
| 1 | QualityAPI.run(mode=SERVER) | Basecamp Server API |
| 2 | QualityAPI.list/get (real server) | Basecamp Server API |

**Total:** 2 items
**Dependency:** feature-basecamp-server

### Phase 2 (Automation)
| # | Item | Dependency |
|---|------|------------|
| 1 | Airflow DAG generation | Airflow |
| 2 | Slack notifications | Basecamp Connect |
| 3 | Email notifications | Basecamp Connect |
| 4 | Expression test type | None |
| 5 | Row Count test type | None |
| 6 | Git Sync | TBD |
| 7 | Basecamp UI integration | Basecamp UI |

**Total:** 7 items

Step 2: Phase 상태 추적

## Phase Status: FEATURE_QUALITY

| Phase | Total | Complete | In Progress | Blocked | Status |
|-------|-------|----------|-------------|---------|--------|
| Phase 1 MVP | 5 | 5 | 0 | 0 | ✅ COMPLETE |
| Phase 1.5 | 2 | 0 | 0 | 2 | ⏳ BLOCKED |
| Phase 2 | 7 | 0 | 0 | 3 | ⏳ NOT STARTED |

**Overall Progress:** 5/14 (36%)

### Blockers

| Phase | Item | Blocked By |
|-------|------|------------|
| 1.5 | SERVER mode | Basecamp Server API 미구현 |
| 1.5 | Real server calls | Basecamp Server API 미구현 |
| 2 | Slack notifications | Basecamp Connect API 미구현 |
| 2 | Email notifications | Basecamp Connect API 미구현 |
| 2 | Basecamp UI | Basecamp UI 미구현 |

Step 3: Phase 전환 관리

## Phase Transition Checklist

### Phase 1 → Phase 1.5 전환 조건

- [x] Phase 1 모든 항목 구현 완료
- [x] completion-gate PASSED
- [x] gap-analysis에서 Phase 1 BLOCKER 없음
- [ ] Phase 1.5 의존성 해결됨

**Status:** Phase 1.5 전환 대기 (의존성 미해결)

### Phase 1.5 → Phase 2 전환 조건

- [ ] Phase 1.5 모든 항목 구현 완료
- [ ] SERVER 모드 E2E 테스트 통과
- [ ] Phase 2 시작 의사결정 완료

Phase 상태 정의

Phase 상태 값

Phase 완료 기준

## Phase Complete 조건

### Phase N 완료 선언 가능 조건

1. **모든 항목 구현**: Phase N 항목 100% 구현
2. **테스트 통과**: 관련 테스트 모두 PASS
3. **BLOCKER 없음**: gap-analysis에서 BLOCKER 0개
4. **문서화 완료**: *_RELEASE.md 작성

### Phase N 부분 완료 (Partial)

의존성으로 인해 일부 미완료 시:
- 완료된 항목 목록 명시
- 미완료 항목 사유 기록
- 예상 해결 시점 기록

Phase 백로그 관리

자동 백로그 생성

Phase 1 완료 시 자동으로 Phase 2 백로그 생성:

## Phase 2 Backlog: QUALITY

> Auto-generated from gap-analysis
> Created: {DATE}

### Backlog Items

| # | Item | Priority | Dependency | Owner | Status |
|---|------|----------|------------|-------|--------|
| 1 | SERVER mode execution | P0 | Basecamp Server | TBD | Blocked |
| 2 | Airflow DAG generation | P1 | Airflow | TBD | Not Started |
| 3 | Slack notifications | P1 | Basecamp Connect | TBD | Blocked |
| 4 | Email notifications | P2 | Basecamp Connect | TBD | Blocked |
| 5 | expression test type | P2 | None | feature-interface-cli | Not Started |
| 6 | row_count test type | P2 | None | feature-interface-cli | Not Started |
| 7 | Git Sync | P3 | TBD | TBD | Not Started |

### Dependency Summary

| Dependency | Items Blocked | Contact |
|------------|---------------|---------|
| Basecamp Server API | 1 | feature-basecamp-server |
| Basecamp Connect API | 2 | feature-basecamp-connect |
| Airflow | 1 | expert-devops-cicd |

우선순위 할당 기준

백로그 → Serena Memory 저장

# Phase 백로그를 Serena memory에 저장
mcp__serena__write_memory(
    memory_file_name="quality_phase2_backlog",
    content="""
# Quality Feature Phase 2 Backlog

## Items
1. SERVER mode - P0, Blocked (Basecamp Server)
2. Airflow DAG - P1, Not Started
...

## Last Updated: {DATE}
"""
)

Phase 진행 보고

진행률 요약

## Phase Progress Report: QUALITY

**Report Date:** 2026-01-01
**Feature:** Quality Spec

### Progress Overview

Phase 1 MVP: [████████████████████] 100% ✅ Phase 1.5: [ ] 0% ⏳ Blocked Phase 2: [ ] 0% ⏳ Not Started ────────────────────────────────────────── Overall: [███████ ] 36%

### Timeline

| Phase | Start | End | Duration |
|-------|-------|-----|----------|
| Phase 1 MVP | 2025-12-30 | 2025-12-31 | 1 day |
| Phase 1.5 | TBD | TBD | - |
| Phase 2 | TBD | TBD | - |

### Blockers to Resolve

| Blocker | Impact | Resolution Path |
|---------|--------|-----------------|
| Basecamp Server API | Phase 1.5 blocked | Request API from basecamp-server team |
| Basecamp Connect API | Phase 2 Slack/Email blocked | Request API from connect team |

completion-gate 연동

completion-gate 강화를 위한 Phase 경계 검사:

## Completion Gate: Phase Boundary Check

### Phase 1 MVP 완료 선언 시

completion-gate PASSED (코드/테스트) ↓ [phase-tracking skill] ↓ Phase 1 항목 100% 확인 ↓ ┌─────────────────────────────┐ │ Phase 2 항목 존재 시 │ │ → 백로그 자동 생성 │ │ → "Phase 1 Complete" 허용 │ └─────────────────────────────┘ ↓ "Phase 1 MVP Complete" 승인

• "Phase 2 백로그 생성됨" 안내

### 출력 예시

```markdown
## Completion Gate: PASSED (Phase 1 MVP) ⚠️

### Code/Test Verification: ✅ PASSED
[기존 completion-gate 결과]

### Phase Boundary: Phase 2 Items Pending

Phase 1 MVP 완료가 승인되었습니다.

| Phase | Status |
|-------|--------|
| Phase 1 MVP | ✅ Complete (5/5) |
| Phase 1.5 | ⏳ Blocked (0/2) |
| Phase 2 | ⏳ Not Started (0/7) |

### Phase 2 Backlog Created

다음 항목이 Phase 2 백로그로 등록되었습니다:
1. SERVER mode execution (P0)
2. Airflow DAG generation (P1)
3. Slack notifications (P1)
... (7 items total)

### Declaration Options

1. **"Phase 1 MVP Complete"** ✅
   - STATUS.md: Phase 1 ✅, Phase 2 ⏳
   - Phase 2 백로그 추적 시작

2. **"Feature Complete"** ❌ (불가)
   - Phase 2 항목 존재로 전체 완료 불가

관련 Skills

• gap-analysis: Gap 분석에서 Phase 항목 식별 (선행)
• completion-gate: 완료 조건 검증 + Phase 경계 검사
• dependency-coordination: 의존성 추적 (후속)
• implementation-checklist: 항목별 구현 추적

Agent Integration

feature-interface-cli Agent 워크플로우

## Multi-Phase Feature Workflow

### FEATURE 문서 수신 시

1. **Phase 파싱**
   - *_FEATURE.md에서 Phase 1/2 항목 추출
   - phase-tracking으로 구조 생성

2. **Phase 1 구현**
   - implementation-checklist로 Phase 1 항목 추적
   - 구현 완료 시 completion-gate 실행

3. **Phase 1 완료 선언**
   - completion-gate PASSED
   - phase-tracking으로 Phase 2 백로그 생성
   - "Phase 1 MVP Complete" 선언

4. **Phase 2 준비**
   - 백로그 항목 우선순위 확인
   - 의존성 해결 요청 (dependency-coordination)
   - Phase 2 시작 시점 결정

Serena Memory 활용

# Phase 상태 저장
mcp__serena__write_memory(
    "cli_phase_status",
    """
# CLI Feature Phase Status

## Quality
- Phase 1: Complete
- Phase 1.5: Blocked (Basecamp Server API)
- Phase 2: Not Started

## Workflow
- Phase 1: Complete
- Phase 2: Not Started

## Catalog
- Phase 1: Complete
- Phase 2: Partial
"""
)

사용 예시

# Phase 상태 확인
"Quality 기능 phase 상태 보여줘"
→ phase-tracking 실행, 진행률 출력

# Phase 전환
"Phase 1 완료, Phase 2 백로그 생성해줘"
→ Phase 2 백로그 자동 생성

# 전체 진행률
"전체 기능 phase 진행률 보여줘"
→ 모든 FEATURE의 Phase 상태 요약