dashboard

프로젝트 라이프사이클 대시보드

프로젝트의 전체 흐름을 조망하고, 현재 단계를 파악하며, 다음 단계로 안내한다. ALM(Application Lifecycle Management) 관점에서 각 단계 간의 추적성과 거버넌스를 관리한다.

실행 절차

Step 1: 프로젝트 상태 스캔

프로젝트 루트의 .claude/ 디렉토리를 스캔하여 각 단계별 산출물 존재 여부를 확인:

.claude/
├── 00-setup/        → Phase 0 산출물
├── 01-ideation/     → Phase 1 산출물
├── 02-planning/     → Phase 2 산출물
├── 03-architecture/ → Phase 3 산출물
├── 04-design/       → Phase 4 산출물
├── 05-implementation/ → Phase 5 산출물
├── 06-infra/        → Phase 6 산출물
├── 07-qa/           → Phase 7 산출물
├── 08-maintenance/  → Phase 8 산출물
├── lifecycle.md     → 프로젝트 메타 정보 (ALM 추적)
├── tech-debt-registry.md → 기술 부채 기록부
└── kpi-definitions.md    → 성공 지표 정의서

Step 2: 상태 리포트 출력

각 단계의 완료 상태를 표로 보여준다:

Phase | 단계명         | 상태   | 핵심 산출물              | 거버넌스 상태
------|---------------|--------|------------------------|-------------
0     | 초기 설정      | ✅/⬜  | project-config.md, CLAUDE.md | PRE 완료/미시작
1     | 아이디어 수집   | ✅/⬜  | idea-brief.md           | PRE 완료/미시작
2     | 기획           | ✅/⬜  | prd.md, user-stories.md, kpi | PRE 완료/미시작
3     | 아키텍처/설계   | ✅/⬜  | tech-stack.md, api-spec.md   | PRE 완료/미시작
4     | 디자인/프로토   | ✅/⬜  | design-system.md, interaction-specs | PRE 완료/미시작
5     | 구현           | ✅/⬜  | conventions.md + 코드 + 셀프리뷰 | PRE 완료/미시작
6     | 인프라/DevOps  | ✅/⬜  | Dockerfile, CI/CD, IaC  | PRE 완료/미시작
7     | QA/테스트      | ✅/⬜  | test-strategy.md, 인수테스트 | PRE 완료/미시작
8     | 운영/회고      | 🔄/⬜  | retrospective.md        | 지속 반복

거버넌스 상태 (PRE = Plan-Review-Execute-Reverify):

• 미시작 → 계획 수립됨 → 승인됨 → 실행 중 → 재검증 중 → 완료

Step 3: 다음 단계 안내

미완료된 가장 첫 번째 단계를 안내하되, 사용자가 특정 단계를 직접 선택할 수도 있음을 알려준다.

순차 진행이 권장되지만 필수는 아님. 사용자가 특정 단계만 필요하다면 해당 단계로 바로 진행.

Step 4: lifecycle.md 관리

프로젝트 루트에 .claude/lifecycle.md 파일을 생성/업데이트하여 ALM 추적 정보를 관리:

# 프로젝트 라이프사이클

## 프로젝트 정보
- 프로젝트명:
- 시작일:
- 현재 단계:
- 마지막 업데이트:

## 단계별 이력
| 단계 | 시작일 | 완료일 | 거버넌스 판정 | 주요 결정 사항 | 교훈 |
|------|--------|--------|-------------|--------------|------|

## 변경 관리 로그
| 날짜 | 단계 | 변경 내용 | 사유 | 영향 범위 |
|------|------|----------|------|----------|

## 기술 부채 요약
| 총 건수 | Critical | High | Medium | Low | 상환율 |
|---------|----------|------|--------|-----|--------|

ALM (Application Lifecycle Management) 관점

추적성 (Traceability)

각 단계의 산출물은 이전 단계의 산출물로부터 도출된다:

설정 → 아이디어 → 요구사항+KPI → 설계 → 디자인+명세 → 코드+리뷰 → 인프라 → 테스트+인수 → 운영+회고
(base)  (why)     (what)       (how)   (look)      (build)     (deploy) (verify)    (improve)
                                                                                       ↓
                                                                              다음 이터레이션으로 순환

• 프로젝트 설정(Phase 0) → 전체 Phase의 컨벤션 기준
• 유저 스토리(Phase 2) ← 아이디어 브리프(Phase 1)
• KPI 정의(Phase 2) → 인수 테스트(Phase 7) → 성과 측정(Phase 8)
• API 설계(Phase 3) ← PRD의 기능 요구사항(Phase 2)
• 인터랙션 명세(Phase 4) → 프론트엔드 구현(Phase 5)
• 테스트 케이스(Phase 7) ← 유저 스토리의 Acceptance Criteria(Phase 2)
• 기술 부채(Phase 3~) → 기술 부채 상환(Phase 8)
• 회고(Phase 8) → 프로세스 개선 → 다음 이터레이션에 반영

거버넌스 (Governance)

각 단계는 Plan → Review → Execute → Re-verify 4단계 프로세스를 따른다:

1. PLAN — 실행계획서 수립 (목표, 범위, 성공 기준)
2. REVIEW — 사용자 검증 및 명시적 수락
3. EXECUTE — 수락된 계획에 따라 실행
4. RE-VERIFY — 실행 결과의 재검증 (성공 기준 대조, 정합성 확인, 교훈 기록)

형상 관리 (Configuration Management)

• 모든 산출물은 Git으로 버전 관리
• 주요 결정 변경 시 관련 산출물 모두 업데이트 (연쇄 영향)
• .claude/ 디렉토리 구조를 통한 산출물 체계적 관리

변경 영향 분석 (Impact Analysis)

특정 단계의 산출물이 변경되면 후속 단계에 미치는 영향:

변경 단계	영향받는 단계	확인 필요 산출물
Phase 0 (설정)	1~8	전체 컨벤션 재확인
Phase 1 (아이디어)	2~8	전체 재검토 필요
Phase 2 (기획)	3~8	설계, 디자인, 코드, 테스트, KPI
Phase 3 (설계)	4~6	디자인, 코드, 인프라, 기술 부채
Phase 4 (디자인)	5	프론트엔드 코드, 인터랙션 명세
Phase 5 (구현)	6, 7	인프라 설정, 테스트
Phase 6 (인프라)	7	배포 관련 QA
Phase 7 (QA)	8	운영 모니터링 기준

ALM Manager 연동

어플리케이션 전체 수명주기의 장기적 관점이 필요할 때 alm-manager 에이전트와 연동:

• 수명주기 단계 판단 — 현재 어플리케이션이 탄생/성장/성숙/쇠퇴/퇴역 중 어디인가
• 릴리즈 로드맵 — 다중 이터레이션에 걸친 버전 계획
• 기술 부채 트렌드 — 이터레이션별 부채 축적/상환 추이
• 건강도 추적 — 릴리즈/코드/운영/사용자 건강 지표

.claude/alm/ 디렉토리가 존재하면 ALM 전략 정보도 대시보드에 반영한다.

가이드라인

• 대시보드는 언제든 호출하여 현재 상태를 확인할 수 있다
• Phase 0 (초기 설정)을 가장 먼저 수행하는 것을 권장
• 단계를 건너뛰는 것은 허용되지만, 건너뛴 단계는 "스킵됨"으로 기록
• 이전 단계로 돌아가 보완하는 것은 자연스러운 반복(iteration)
• Phase 8 (운영/회고)은 일회성이 아닌 지속적으로 반복되는 단계
• lifecycle.md는 프로젝트의 "항해 일지" — 주요 결정과 변경을 기록

참고 자료

• references/alm-guide.md — ALM 개념 및 실무 가이드