# AI-WORKS 프로젝트 생성기 업그레이드 계획서 v2.2

## 1. v2.2 Goal

**"Framework 안정성과 운영 규칙을 강화하여, v2.1 도입된 협업 안전장치를 완성도 있게 만든다."**

- v2.1 협업 안전장치(Working Workspace, Decision Gate, Apply Gate)를 보완하여 공식화
- Improvement Priority Rule 도입으로 운영 우선순위 체계화
- Release Ready Freeze Rule으로 Release 프로세스 일관성 보장
- 프로젝트 생성 경로 버그 수정을 통한 안정성 제고

---

## 2. Scope

### Must (v2.2 필수 구현)

| 순번 | 항목 |
|------|------|
| 1 | 프로젝트 생성 경로 버그 수정 |
| 2 | Release Ready Freeze Rule |
| 3 | Improvement Priority Rule |
| 4 | Working Workspace 보완 |
| 5 | Decision Gate 보완 |
| 6 | Apply Gate 보완 |

### Should (설계/준비 단계)

| 순번 | 항목 |
|------|------|
| 1 | Snapshot 정책 설계 (자동화는 제외) |
| 2 | Baseline 생성 절차 설계 (자동화는 제외) |

### Could (미래 버전 검토)

| 순번 | 항목 |
|------|------|
| 1 | 자동 Snapshot |
| 2 | Baseline 자동 생성 |
| 3 | 충돌 해결 자동화 |
| 4 | working/ 정리 자동화 |
| 5 | 고급 Rollback 자동화 |

### Won't (v2.2 범위 외)

| 순번 | 항목 | 사유 |
|------|------|------|
| 1 | Decision Gate 재구현 | v2.1 완료, 보완 수준 |
| 2 | Apply Gate 재구현 | v2.1 완료, 보완 수준 |
| 3 | Snapshot 규칙 재정의 | v2.1 규칙 정의, 보완 수준 |

### Must NOT (절대 구현 금지)

| 항목 | 이유 |
|------|------|
| GUI 추가 | v1.0 명시 보류 |
| Git 자동 초기화 | v1.0 보류 기능 |
| 다중 템플릿 지원 | 정책 준수 (`templates/default`만) |
| 인터넷 연결 기능 | Security 리스크 |
| 외부 라이브러리 의존 | v1.0 원칙 준수 |
| 기존 프로젝트 수정 기능 | v1.0 보류 기능 |
| 폴더 구조 대규모 변경 | 안정성 유지 우선 |
| Template 구조 전체 개편 | 호환성 유지 |
| 대규모 리팩터링 | Framework 안정화 우선 |

### Out of Scope (명확히 제외)

| 항목 | 사유 |
|------|------|
| Template 구조 대규모 변경 | v2.1 안정된 템플릿 구조 유지 |
| Template 내용 변경 (불필요한 수정) | Framework 규칙 반영 외의 변경 제한 |
| Template 내용 변경 (필요한 범위 외) | Framework 반영을 위한 최소한의 변경만 허용 |

---

## 3. Implementation Order

| 순번 | 작업 항목 | 비고 |
|------|----------|------|
| 1 | 프로젝트 생성 경로 버그 수정 | Bug fix - 최우선 |
| 2 | Working Workspace 보완 | v2.1 도입 내용 체계화, Decision Gate/Appy Gate 기반 |
| 3 | Decision Gate 보완 | Working Workspace 기반, 순차적 적용 |
| 4 | Apply Gate 보완 | Working Workspace 기반, 순차적 적용 |
| 5 | Improvement Priority Rule | Framework 규칙 통합 |
| 6 | Release Ready Freeze Rule | Release 프로세스 완성 |

---

## 4. Dependencies

```
프로젝트 생성 경로 버그 수정
    ├── 독립 작업 (의존성 없음)
    └── 후속: 없음

Working Workspace 보완
    ├── 의존: 없음
    └── 후속: Decision Gate 보완, Apply Gate 보완
    └── 기반: Decision Gate, Apply Gate의 선행 기반

Decision Gate 보완
    ├── 의존: Working Workspace 보완 완료
    └── 후속: Improvement Priority Rule

Apply Gate 보완
    ├── 의존: Working Workspace 보완 완료
    └── 후속: Release Ready Freeze Rule

Improvement Priority Rule
    ├── 의존: Decision Gate, Apply Gate 보완 완료
    └── 후속: Release Ready Freeze Rule

Release Ready Freeze Rule
    └── 의존: 모든 Must 항목 완료 (최종 통합)
```

---

## 5. Risk Assessment

| 항목 | 위험도 | 사유 |
|------|--------|------|
| 프로젝트 생성 경로 버그 수정 | **Low** | 경로 로직 수정만, 영향 범위 제한 |
| Working Workspace 보완 | **Medium** | 규칙 명확화 필요, 사용자 승인 과정 포함 |
| Decision Gate 보완 | **Low** | 기존 규칙 정리 수준 |
| Apply Gate 보완 | **Low** | 기존 규칙 정리 수준 |
| Improvement Priority Rule | **Medium** | Framework 전반에 영향, 적용 기준 명확화 필요 |
| Release Ready Freeze Rule | **Low** | Release 프로세스 추가, 기존 흐름 변경 없음 |

### 추가 위험 요소

| 항목 | 위험도 | 사유 |
|------|--------|------|
| Baseline 호환성 | **Medium** | v2.1 Baseline과의 호환성 확보 필요 |
| Template 업데이트 | **Medium** | 템플릿 변경 시 새 프로젝트에 즉시 반영됨 |

---

## 6. Definition of Done

v2.2 완료 기준:

- [ ] 모든 Must 항목 설계 완료
- [ ] Working Workspace 보완 규칙 공식 반영
- [ ] Decision Gate 보완 규칙 공식 반영
- [ ] Apply Gate 보완 규칙 공식 반영
- [ ] Improvement Priority Rule 공식 반영
- [ ] Release Ready Freeze Rule 공식 반영
- [ ] Should 항목 설계안 작성 완료
- [ ] 회귀 테스트 통과 (v2.1 베이스라인 호환)
- [ ] 모든 변경사항 검증 완료
- [ ] Release Ready 확인 완료
- [ ] Official Baseline 생성 승인
- [ ] v2.2 Release 완료

---

*작성일: 2026-07-05*