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

## 1. AI-WORKS Standard v2.1 목표

- v2.0에서 발견된 협업 문제 해결
- AI와 사용자 간의 안전한 협업 프로세스 구축
- 공식 문서 무결성 보장
- v2.0 Baseline을 기반으로 개발

## 2. v2.1 범위

### 2.1 필수 포함

| 순서 | 항목 | 설명 |
|------|------|------|
| 1 | Working Workspace | `working/` 폴더 도입, 모든 수정 작업은 working에서 먼저 수행 |
| 2 | Decision Gate 규칙 | 결정이 필요한 시점에는 새 작업 시작 금지, 현재 안건 완결 후 이동 |
| 3 | Apply Gate 규칙 | 사용자 "확정/적용" 요청 전까지 공식 문서 반영 금지 |
| 4 | RULES.md 협업 안전장치 섹션 | 섹션 7로 추가, Working/Decision/Apply/Snapshot 규칙 명시 |
| 5 | build/dist/baseline 역할 문서화 | 폴더별 역할과 삭제 가능 기준을 RULES.md에 추가 |
| 6 | v2.1 작업 시작 절차 | v2.0 Baseline 확인, STATE.json 변경, CHANGELOG/TODO 업데이트 절차 |

### 2.2 권장 포함

| 항목 | 설명 |
|------|------|
| Snapshot 기본 규칙 | `working/snapshots/`에 중요한 중간 결과 보존 가능. 자동화는 하지 않고 규칙만 정의 |

### 2.3 보류 (v2.2 이후 검토)

| 항목 | 사유 |
|------|------|
| 자동 Snapshot | 자동화보다 사용자 의도 기반 보존이 우선 |
| 충돌 해결 자동화 | v2.1에서는 수동 검토 원칙 유지 |
| working/ 정리 스크립트 | 규칙 정립 후 필요 시 추가 |
| Baseline 자동 생성 | v2.1 수동 생성 유지, v2.2에서 검토 |
| 고급 Rollback 자동화 | 수동 Rollback 절차 유지 |

## 3. 설계 방향

### 3.1 협업 안전장치 시스템

Working Workspace, Decision Gate, Apply Gate, Snapshot은 독립 기능이 아니라 하나의 시스템으로 설계한다.

### 3.2 Working Directory 규칙

- 모든 수정 작업은 `working/`에서 먼저 수행
- 공식 문서는 사용자 확정 전까지 수정하지 않음
- 확정 후에만 공식 위치로 반영

### 3.3 Decision Gate 규칙

- 질문/답변, 결정이 필요한 시점마다 게이트 적용
- 현재 안건이 종료되기 전 새 안건 시작 금지
- Kilo가 "결정해 주세요" 요청 시 새 아이디어 추가 금지

### 3.4 Apply Gate 규칙

- 사용자가 "확정", "적용", "승인"을 명시적으로 요청한 경우에만 공식 반영
- 반영 후 `working/` 초기화
- 반영 내용은 CHANGELOG.md에 기록

### 3.5 Snapshot 규칙

- 중요한 중간 결과는 `working/snapshots/`에 저장 가능
- 자동 Snapshot 생성은 v2.2 이후 검토

## 4. 작업 계획

### Phase 1: 필수 기능

1. `working/` 폴더 규칙 정의
2. Decision Gate 규칙 정의
3. Apply Gate 규칙 정의
4. RULES.md 섹션 7 추가
5. build/dist/baseline 역할 문서화
6. v2.1 작업 시작 절차 정리

### Phase 2: 권장 기능

7. Snapshot 기본 규칙 추가

### Phase 3: 검증

8. v2.1 범위 검증
9. 문서 일관성 확인
10. Baseline 관리 규칙 확인

## 5. 검증 계획

- RULES.md 협업 안전장치 섹션 검증
- build/dist/baseline 역할 정의 검증
- v2.1 작업 시작 절차 검증
- Working Workspace 규칙 검증

## 6. Rollback 계획

- 문제 발생 시 v2.0 Baseline으로 복원
- 복원 후 문제 해결 후 v2.1 다시 진행
- v2.1 작업 내용은 별도 브랜치/폴더로 관리

## 7. Baseline

- v2.1 개발은 `baseline/v2.0/`을 기반으로 시작
- v2.1 Release 시 `baseline/v2.1/` 생성

## 8. 참고

- v2.0 Release: 2026-07-05
- v2.0 Baseline: `baseline/v2.0/`
- v2.1 대상: 00-프로젝트생성기
