@silbaram/artifact-driven-agent 0.1.7 → 0.2.3

package/README.md

@@ -2,7 +2,7 @@
 
 **문서 기반 멀티 AI 에이전트 개발 프레임워크**
 
-4개 핵심 역할(Planner, Developer, Reviewer, Documenter)이 스프린트 단위로 협업하여 안정적인 개발 워크플로우를 만듭니다.
+5개 핵심 역할(Planner, Improver, Developer, Reviewer, Documenter)이 스프린트 단위로 협업하여 안정적인 개발 워크플로우를 만듭니다.
 
 ## 🎯 목표
 
@@ -19,14 +19,17 @@
 
 AI 에이전트 실행 시, 시스템 프롬프트에 다음을 포함합니다:
 
-1. **모든 규칙 파일 내용** (rules/*.md)
-2. **핵심 산출물 내용** (plan.md, project.md, 현재 스프린트 Task 파일)
-3. **인터페이스 문서 내용** (api.md, ui.md 등)
+1. **역할 정의** - 역할의 책임과 권한
+2. **모든 규칙 파일 내용** (rules/*.md)
+3. **전문 스킬** (skills/*.md) - 역할에 지정된 기술 스택 가이드
+4. **핵심 산출물 내용** (plan.md, project.md, 현재 스프린트 Task 파일)
+5. **인터페이스 문서 내용** (api.md, ui.md 등)
 
 이를 통해 AI는:
 - 문서에 명시된 규칙을 따라야만 함
 - 현재 스프린트 범위를 벗어날 수 없음
 - project.md에 없는 기술을 추가할 수 없음
+- 프로젝트의 코딩 패턴과 스타일을 자동으로 준수
 
 **파일명만 나열하지 않고, 내용을 포함**하는 것이 핵심입니다.
 
@@ -44,13 +47,14 @@ npm install -g @silbaram/artifact-driven-agent
 npx @silbaram/artifact-driven-agent setup web
 ```
 
-### 저장소 클론
+### 저장소 클론 (개발자용)
 
 ```bash
 git clone https://github.com/silbaram/artifact-driven-agent.git
 cd artifact-driven-agent
-npm install
-npm link  # 전역 명령어 등록
+npm install        # 의존성 설치
+npm run build      # TypeScript 컴파일
+npm link           # 전역 명령어 등록
 ```
 
 ### 설치 확인
@@ -60,6 +64,36 @@ ada --version
 ada --help
 ```
 
+### 업그레이드
+
+npm 패키지를 업데이트한 후, 기존 작업공간도 최신 버전으로 업그레이드해야 합니다.
+
+```bash
+# npm 패키지 업데이트
+npm install -g @silbaram/artifact-driven-agent@latest
+
+# 작업공간 상태 확인 (버전 불일치 경고 표시)
+ada status
+
+# 변경 사항 미리보기
+ada upgrade --dry-run
+
+# 안전 업그레이드 (백업 + 확인)
+ada upgrade
+
+# 강제 업그레이드 (확인 없이)
+ada upgrade --force
+
+# 문제 발생 시 롤백
+ada upgrade --rollback
+```
+
+**업그레이드 동작:**
+- ✅ `roles/`, `rules/` 디렉토리 업데이트 (프레임워크 파일)
+- ✅ 자동 백업 생성 (`.backups/upgrade-YYYYMMDD-HHMMSS/`)
+- ✅ 사용자 데이터 보존 (`backlog/`, `sprints/`, `decision.md`, `project.md`, `plan.md`)
+- ✅ 버전 추적 (`.ada-version` 파일)
+
 ---
 
 ## 🖥️ 빠른 시작
@@ -98,22 +132,54 @@ ada developer claude  # Task 구현 → DONE 상태로 변경
 ada reviewer claude   # 코드 리뷰 → review-reports/ 생성
 ```
 
-### 6. 스프린트 종료
+### 6. 스프린트 종료 및 문서화
+
+```bash
+# 스프린트 종료 및 정리
+ada sprint close              # 작업 파일을 archive/ 폴더로 이동 (권장)
+ada sprint close --clean      # 작업 파일 완전 삭제 (최종 문서만 유지)
+ada sprint close --keep-all   # 모든 파일 유지
+
+# 문서 작성
+ada documenter claude         # Release Notes, API Changelog 등 생성
+```
+
+### 7. (선택) 프로젝트 문서 관리
 
 ```bash
-ada sprint close               # 스프린트 종료
-ada documenter claude          # 문서 작성
+# 문서 사이트 초기화 (최초 1회)
+ada docs init
+
+# 문서 생성/업데이트
+ada documenter claude         # Documenter가 docs/ 업데이트
+
+# 로컬 미리보기
+ada docs serve
+
+# GitHub Pages 배포 (MkDocs 자동 배포 지원)
+ada docs publish
+```
+
+**종료 후 구조 (기본):**
+```
+sprints/sprint-N/
+├── meta.md                    # 스프린트 정보
+├── docs/                      # 최종 문서 ✅
+└── archive/                   # 작업 과정 보관
+    ├── tasks/
+    └── review-reports/
 ```
 
 ---
 
 ## 👥 역할 시스템
 
-### 핵심 역할 (4개) - 모든 프로젝트 필수
+### 핵심 역할 (5개) - 모든 프로젝트 필수
 
 | 역할 | 책임 | 산출물 |
 |------|------|--------|
-| **Planner** | 요구사항 수집, Task 분해 | plan.md, backlog/*.md |
+| **Planner** | 신규 기능 요구사항 수집, Task 분해 | plan.md, backlog/*.md |
+| **Improver** | 기존 기능 개선 분석 및 기획 | improvement-reports/*.md, backlog/*.md |
 | **Developer** | 코드 구현, Task 완료 | 소스 코드, Task 파일 업데이트 |
 | **Reviewer** | 코드 리뷰, 품질 판정 | review-reports/*.md |
 | **Documenter** | 스프린트 완료 시 문서 작성 | API Changelog, Release Notes, User Guide |
@@ -132,22 +198,38 @@ ada documenter claude          # 문서 작성
 
 ```
 artifact-driven-agent/
-├── bin/cli.js              # CLI 진입점
+├── bin/
+│   └── cli.ts              # CLI 진입점 (TypeScript)
 ├── src/
-│   ├── commands/           # 명령어 구현
-│   │   ├── setup.js
-│   │   ├── run.js
-│   │   ├── sprint.js      # 스프린트 관리
-│   │   └── sessions.js    # 세션 모니터링
-│   └── utils/
-│       ├── files.js
-│       └── sessionState.js
+│   ├── commands/           # 명령어 구현 (TypeScript)
+│   │   ├── setup.ts
+│   │   ├── run.ts
+│   │   ├── sprint.ts       # 스프린트 관리
+│   │   ├── sessions.ts     # 세션 모니터링
+│   │   └── config.ts       # 설정 관리
+│   ├── utils/
+│   │   ├── files.ts
+│   │   ├── config.ts       # 설정 유틸리티
+│   │   └── sessionState.ts
+│   ├── ui/
+│   │   ├── dashboard.ts    # 대시보드
+│   │   └── keyHandler.ts
+│   └── types/              # TypeScript 타입 정의
+│       ├── common.ts
+│       ├── session.ts
+│       ├── config.ts
+│       ├── task.ts
+│       └── index.ts
+├── dist/                   # 빌드 출력 (.js 파일)
+├── tsconfig.json           # TypeScript 설정
 ├── core/                   # 범용 핵심
-│   ├── roles/              # 5개 역할
+│   ├── roles/              # 6개 역할
 │   ├── artifacts/          # 산출물 템플릿
 │   │   └── sprints/
 │   │       └── _template/  # 스프린트 템플릿
-│   └── rules/              # 5개 규칙
+│   ├── rules/              # 5개 규칙
+│   └── skills/             # 🆕 스킬 템플릿
+│       └── _template/
 └── templates/              # 프로젝트 유형별
     ├── web-dev/
     ├── library/
@@ -184,9 +266,17 @@ ai-dev-team/
 │               └── task-005.md
 ├── roles/                  # core + template 병합
 ├── rules/
+├── skills/                 # 🆕 역할별 전문 스킬
+│   ├── _template/
+│   │   └── SKILL.md
+│   ├── spring-boot/
+│   │   └── SKILL.md
+│   └── kotlin/
+│       └── SKILL.md
+├── ada.config.json         # 역할별 AI 도구 + 스킬 설정
+├── .ada-status.json        # 멀티 세션 상태 파일
 └── .sessions/              # 세션 이력
-    ├── logs/
-    └── .ada-status.json    # 멀티 세션 상태 파일
+    └── logs/
 ```
 
 ---
@@ -199,7 +289,15 @@ ai-dev-team/
 |--------|------|
 | `ada` | 대화형 모드 |
 | `ada setup [template]` | 템플릿 세팅 (web, lib, game, cli) |
-| `ada status` | 상태 확인 |
+| `ada status` | 상태 확인 (버전 체크 포함) |
+| `ada config` | 설정 변경 (대화형) |
+| `ada config show` | 현재 설정 보기 |
+| `ada config list` | 현재 설정 보기 (show와 동일) |
+| `ada config get <key>` | 설정 값 조회 |
+| `ada config set <key> <value>` | 설정 값 변경 |
+| `ada upgrade` | 작업공간을 최신 버전으로 업그레이드 |
+| `ada upgrade --dry-run` | 변경 사항 미리보기 |
+| `ada upgrade --rollback` | 이전 백업으로 롤백 |
 | `ada validate [doc]` | 문서 검증 |
 | `ada reset [-f]` | 초기화 |
 
@@ -209,7 +307,11 @@ ai-dev-team/
 |--------|------|
 | `ada sprint create` | 새 스프린트 생성 |
 | `ada sprint add task-001 ...` | Task 추가 |
-| `ada sprint close` | 현재 스프린트 종료 |
+| `ada sprint sync` | meta.md 상태 동기화 (Task 파일 반영) |
+| `ada sprint close` | 스프린트 종료 (작업 파일 archive/) |
+| `ada sprint close --auto` | 스프린트 자동 종료 (회고 기본값) |
+| `ada sprint close --clean` | 스프린트 종료 (작업 파일 삭제) |
+| `ada sprint close --keep-all` | 스프린트 종료 (파일 유지) |
 | `ada sprint list` | 스프린트 목록 |
 
 ### AI 에이전트 실행
@@ -222,12 +324,15 @@ ada run <role> <tool>
 ada <role> <tool>
 
 # 예시
-ada planner claude
+ada planner claude      # 신규 기능 기획
+ada improver claude     # 기존 기능 개선 기획
 ada developer codex
 ada reviewer gemini
 ada documenter claude
 ```
 
+tool을 생략하면 `ada.config.json` 기본값을 사용합니다.
+
 **지원 도구:** claude, codex, gemini, copilot
 
 ### 세션 모니터링
@@ -240,13 +345,81 @@ ada sessions
 ada sessions --watch
 ada sessions -w
 
-# 대기 질문이 있으면 자동으로 응답 프롬프트가 표시됩니다.
 # 세션 로그 확인
 ada logs
 ada logs [session-id]
 ```
 
----
+### 문서 관리
+
+```bash
+# 문서 구조 초기화 (MkDocs/Jekyll)
+ada docs init
+ada docs init -g mkdocs    # MkDocs 템플릿
+ada docs init -g jekyll    # Jekyll 템플릿
+
+# 문서 생성 (Documenter 역할 실행 안내)
+ada docs generate
+
+# 로컬 문서 서버 실행
+ada docs serve
+
+# GitHub Pages 배포 (MkDocs 자동 배포 지원)
+ada docs publish
+```
+
+**참고:** 실제 문서 내용 생성은 Documenter 역할로 수행합니다:
+```bash
+ada documenter claude
+```
+
+### 스킬 관리
+
+스킬은 AI 도구의 **네이티브 스킬 시스템**을 통해 적용됩니다.
+
+| 도구 | 스킬 탐색 경로 |
+|------|---------------|
+| Claude Code | `.claude/skills/` |
+| Gemini CLI | `.gemini/skills/` |
+| Codex | `.agents/skills/` |
+
+```bash
+# 스킬 목록 (ada 저장소)
+ada skills list
+
+# 스킬 상세 정보
+ada skills info spring-boot
+
+# 스킬 적용 (네이티브 경로에 복사)
+ada skills apply spring-boot           # 모든 도구에 적용
+ada skills apply spring-boot claude    # 특정 도구에만 적용
+
+# 스킬 제거
+ada skills remove spring-boot          # 모든 도구에서 제거
+ada skills remove spring-boot gemini   # 특정 도구에서만 제거
+
+# 적용 상태 확인
+ada skills status
+
+# 대화형 적용/삭제 UI
+ada skills ui
+```
+
+**스킬 추가 방법:**
+커뮤니티나 GitHub에서 스킬을 다운로드하여 `ai-dev-team/skills/` 디렉토리에 추가합니다.
+
+```bash
+# 예시: GitHub에서 스킬 다운로드
+cd ai-dev-team/skills/
+git clone https://github.com/awesome-ada/spring-boot-skill.git spring-boot
+
+# 또는 직접 복사
+cp -r /path/to/spring-boot ai-dev-team/skills/
+
+# 확인 및 적용
+ada skills list
+ada skills apply spring-boot
+```
 
 ## 🔄 워크플로우
 
@@ -256,10 +429,9 @@ ada logs [session-id]
 1. Planner: 요구사항 수집
    → plan.md + backlog/*.md 생성
 
-2. Manager: 스프린트 생성/Task 할당
-   → (plan.md Confirmed 후 watch에서 승인하면 자동 실행)
-   → 자동 실행: ada sprint create
-   → 자동 실행: ada sprint add task-001 task-002
+2. 사용자: 스프린트 생성
+   → ada sprint create
+   → ada sprint add task-001 task-002
 
 3. Developer: Task 구현
    → 코드 작성
@@ -273,9 +445,15 @@ ada logs [session-id]
    → ada sprint close
 
 6. Documenter: 문서 작성
-   → docs/*.md 생성 (API Changelog, Release Notes 등)
+   → ada documenter claude
+   → sprints/sprint-N/docs/*.md 생성 (Release Notes, API Changelog 등)
+   → (선택) 프로젝트 docs/ 업데이트 (문서 사이트용)
+
+7. (선택) 문서 사이트 배포
+   → ada docs serve (로컬 미리보기)
+   → ada docs publish (GitHub Pages 배포)
 
-7. 다음 스프린트 시작
+8. 다음 스프린트 시작
    → ada sprint create
 ```
 
@@ -285,11 +463,23 @@ ada logs [session-id]
 0. Analyzer: 코드베이스 분석
    → project.md 역생성
 
-1. Planner: 추가 기능 기획
-   → plan.md 업데이트
-   → backlog/*.md 생성
+1. [분기점]
 
-2. 이후 신규 프로젝트와 동일
+   A) 신규 기능 추가 시:
+      Planner: 추가 기능 기획
+      → plan.md 업데이트
+      → backlog/*.md 생성
+
+   B) 기존 기능 개선 시:
+      Improver: 개선 분석 및 기획
+      → improvement-reports/IMP-NNN.md 생성
+      → backlog/*.md 생성
+
+2. 사용자: 스프린트 생성
+   → ada sprint create
+   → ada sprint add task-001 task-002
+
+3. 이후 신규 프로젝트와 동일 (Developer → Reviewer → Documenter)
 ```
 
 ### Task 상태 흐름
@@ -369,11 +559,6 @@ ada reviewer gemini
 ada sessions --watch
 ```
 
-**세션 모니터링 포인트**
-- 대기 질문이 생성되면 watch 화면이 자동 프롬프트로 전환됩니다.
-- 프롬프트는 사용자가 직접 입력하며, 응답은 `.ada-status.json`에 저장됩니다.
-- 승인형 질문에 '예'로 응답하면 필요한 CLI 작업을 자동 실행합니다.
-
 ### 자동 세션 관리
 
 **세션 시작 시:**
@@ -388,17 +573,262 @@ ada sessions --watch
 ### 상태 파일
 
 ```
-ai-dev-team/.sessions/.ada-status.json
+ai-dev-team/.ada-status.json
 ```
 
 모든 세션이 이 파일을 통해 상태를 공유합니다.
 
 **구성:**
 - `activeSessions[]`: 실행 중인 세션
-- `pendingQuestions[]`: 대기 질문 및 응답 상태
-- `taskProgress[]`: Task 진행 상황
+- `pendingQuestions[]`: 대기 질문
+- `taskProgress{}`: Task 진행 상태
 - `notifications[]`: 세션 간 알림
-- (기존 Manager 관련 필드는 제거됨)
+- `locks{}`: 파일 잠금 상태
+
+---
+
+## ⚙️ 설정 관리
+
+역할별로 사용할 AI 도구를 설정할 수 있습니다.
+
+### 설정 파일
+
+```
+ai-dev-team/ada.config.json
+```
+
+```json
+{
+  "version": "1.0",
+  "defaults": {
+    "tool": "claude"
+  },
+  "roles": {
+    "manager": "claude",
+    "planner": "claude",
+    "developer": "gemini",
+    "reviewer": "claude",
+    "documenter": "claude"
+  }
+}
+```
+
+### 대화형 설정
+
+```bash
+ada config
+```
+
+**메뉴:**
+- 📋 현재 설정 보기
+- 🔧 역할별 도구 설정
+- ⚡ 기본 도구 변경
+- 🎯 빠른 설정 (프리셋)
+
+### 프리셋
+
+| 프리셋 | 설명 |
+|--------|------|
+| All Claude | 모든 역할에 Claude 사용 |
+| All Gemini | 모든 역할에 Gemini 사용 |
+| Mixed Optimal | 역할별 최적 조합 |
+| Dev Gemini + Review Claude | 개발은 Gemini, 리뷰는 Claude |
+
+### 명령어 모드
+
+```bash
+# 개별 역할 설정
+ada config set roles.developer gemini
+ada config set roles.reviewer claude
+
+# 기본 도구 변경
+ada config set defaults.tool gemini
+
+# 설정 확인
+ada config show       # 또는 ada config list
+
+# 특정 값 조회
+ada config get roles.manager
+```
+
+설정을 초기화하려면 `ai-dev-team/ada.config.json` 삭제 후 `ada config`를 실행하세요.
+
+---
+
+## 🎓 스킬 시스템
+
+역할별로 기술 스택, 패턴, 코딩 스타일 등의 전문 지식을 스킬로 정의하여 AI에게 자동으로 제공할 수 있습니다.
+
+### 개념
+
+**스킬(Skill)**은 특정 기술이나 패턴에 대한 가이드를 담은 마크다운 문서입니다.
+
+- 역할별로 필요한 스킬을 지정하면, AI 실행 시 자동으로 로드됩니다.
+- 프로젝트별 기술 스택 표준화 및 코딩 패턴 통일에 유용합니다.
+
+### 스킬 구조
+
+```
+ai-dev-team/skills/
+├── _template/              # 템플릿
+│   └── SKILL.md
+├── spring-boot/            # 사용자 생성 스킬
+│   ├── SKILL.md           # 메인 파일 (필수)
+│   ├── examples/          # 예시 코드 (선택)
+│   └── references/        # 참조 문서 (선택)
+└── kotlin/
+    └── SKILL.md
+```
+
+**SKILL.md 예시:**
+```yaml
+---
+name: spring-boot
+description: Spring Boot 백엔드 개발 시 Kotlin, REST API, JPA 패턴 적용
+---
+
+# Spring Boot + Kotlin 백엔드 개발
+
+## Controller 패턴
+- `@RestController` + `@RequestMapping` 사용
+- 경로는 복수형 명사 (`/api/users`)
+
+## Service 계층
+- `@Service` + `@Transactional` 조합
+
+## Repository
+- Spring Data JPA 사용
+```
+
+### 사용 방법
+
+**1. 스킬 다운로드 또는 생성:**
+
+커뮤니티에서 검증된 스킬을 다운로드하거나, 직접 생성합니다.
+
+```bash
+# 방법 1: 커뮤니티에서 다운로드 (권장)
+cd ai-dev-team/skills/
+git clone https://github.com/awesome-ada/spring-boot-skill.git spring-boot
+git clone https://github.com/awesome-ada/kotlin-skill.git kotlin
+
+# 방법 2: 직접 생성
+mkdir -p ai-dev-team/skills/spring-boot
+touch ai-dev-team/skills/spring-boot/SKILL.md
+code ai-dev-team/skills/spring-boot/SKILL.md
+```
+
+**2. 스킬 확인:**
+```bash
+ada skills list
+```
+
+**3. 스킬 적용 (네이티브 경로에 복사):**
+```bash
+# 모든 도구에 적용
+ada skills apply spring-boot kotlin
+
+# 또는 특정 도구에만 적용
+ada skills apply spring-boot claude
+
+# 적용 상태 확인
+ada skills status
+```
+
+**4. AI 실행:**
+```bash
+ada developer claude
+
+# → Claude가 .claude/skills/에서 스킬을 자동으로 로드
+# → 해당 패턴에 맞춰 코드 생성!
+```
+
+### 네이티브 스킬 경로
+
+각 AI 도구는 자체 스킬 탐색 경로에서 스킬을 자동으로 인식합니다:
+
+| 도구 | 스킬 탐색 경로 |
+|------|---------------|
+| Claude Code | `.claude/skills/` |
+| Gemini CLI | `.gemini/skills/` |
+| Codex | `.agents/skills/` |
+
+`ada skills apply` 명령은 ada 스킬 저장소의 스킬을 이 네이티브 경로로 복사합니다.
+
+```
+ai-dev-team/skills/spring-boot/    →    .claude/skills/spring-boot/
+                                   →    .gemini/skills/spring-boot/
+                                   →    .agents/skills/spring-boot/
+```
+
+### 작동 원리
+
+1. **스킬 저장**: `ai-dev-team/skills/`에 스킬 저장
+2. **스킬 적용**: `ada skills apply`로 네이티브 경로에 복사
+3. **AI 실행**: 각 AI 도구가 자체 스킬 경로에서 자동 로드
+
+이를 통해 AI는 프로젝트의 기술 스택과 코딩 패턴을 자동으로 따르게 됩니다.
+
+### 예시 시나리오
+
+**Spring Boot + Kotlin 프로젝트:**
+
+```bash
+# 1. 스킬 다운로드 (커뮤니티에서)
+cd ai-dev-team/skills/
+git clone https://github.com/awesome-ada/spring-boot-skill.git spring-boot
+git clone https://github.com/awesome-ada/kotlin-skill.git kotlin
+git clone https://github.com/awesome-ada/rest-api-skill.git rest-api
+
+# 2. 확인
+ada skills list
+
+# 3. 스킬 적용 (네이티브 경로에 복사)
+ada skills apply spring-boot
+ada skills apply kotlin
+ada skills apply rest-api
+
+# 4. 개발 실행
+ada developer claude
+
+# → Controller 작성 시 자동으로:
+#   - @RestController + @RequestMapping 패턴 사용
+#   - Kotlin data class 활용
+#   - REST API 네이밍 규칙 준수
+```
+
+**Python FastAPI 프로젝트:**
+
+```bash
+# 커뮤니티에서 스킬 다운로드
+cd ai-dev-team/skills/
+git clone https://github.com/awesome-ada/fastapi-skill.git fastapi
+git clone https://github.com/awesome-ada/pydantic-skill.git pydantic
+
+# 스킬 적용
+ada skills apply fastapi
+ada skills apply pydantic
+
+ada developer claude
+```
+
+### 스킬 관리 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `ada skills list` | 스킬 목록 (적용 상태 포함) |
+| `ada skills info <name>` | 스킬 상세 정보 |
+| `ada skills apply <name> [tool]` | 스킬 적용 (네이티브 경로에 복사) |
+| `ada skills remove <name> [tool]` | 스킬 제거 |
+| `ada skills status` | 도구별 적용 상태 확인 |
+| `ada skills ui` | 대화형 스킬 적용/삭제 |
+
+**지원 도구:** `claude`, `gemini`, `codex`
+
+**스킬 추가 방법:**
+- 커뮤니티 저장소에서 다운로드
+- 직접 `ai-dev-team/skills/<name>/SKILL.md` 생성
+- 팀 내부 스킬 공유
 
 ---
 
@@ -444,9 +874,10 @@ ai-dev-team/.sessions/.ada-status.json
 - 역할 간 blocking 문제 (backend ↔ frontend)
 
 **현재 (v0.2.x):**
-- 4개 핵심 역할 (planner, developer, reviewer, documenter)
+- 5개 핵심 역할 (planner, improver, developer, reviewer, documenter)
 - 사용자 직접 스프린트 관리 (CLI 명령어)
 - 단순화된 워크플로우
+- 신규 기능(Planner)과 개선(Improver) 분리
 
 ### 스프린트 기반 구조
 
@@ -460,16 +891,18 @@ ai-dev-team/.sessions/.ada-status.json
 - Task별 개별 파일 (task-NNN.md)
 - 리뷰/문서도 Task별 분리
 - 완료된 스프린트는 불변 (이력 보존)
+- 종료 시 작업 파일 자동 정리 (archive/ 또는 삭제)
 
 ### 자동화 개선
 
 **추가된 CLI 명령어:**
 - `ada sprint create` - 스프린트 자동 생성
 - `ada sprint add` - Task 자동 추가
-- `ada sprint close` - 스프린트 종료 및 회고 템플릿 생성
+- `ada sprint close` - 스프린트 종료 및 작업 파일 정리 (archive/clean/keep-all 옵션)
 - `ada sprint list` - 스프린트 목록 확인
+- `ada config` - 설정 조회/변경
+
 
----
 
 ## 🔧 개발 환경
 
@@ -483,14 +916,35 @@ ai-dev-team/.sessions/.ada-status.json
 ```bash
 git clone https://github.com/silbaram/artifact-driven-agent.git
 cd artifact-driven-agent
-npm install
-npm link  # 전역 ada 명령어 등록
+npm install        # 의존성 설치
+npm run build      # TypeScript 컴파일
+npm link           # 전역 ada 명령어 등록
 ```
 
-### 테스트
+### 개발 스크립트
 
 ```bash
-npm test   # Node.js 내장 test runner 사용
+npm run build      # TypeScript 컴파일 (dist/ 생성)
+npm run dev        # TypeScript watch 모드 (개발 중)
+npm run typecheck  # 타입 체크만 실행
+npm test           # 테스트 실행 (Node.js 내장 test runner)
+```
+
+### 프로젝트 구조 (TypeScript)
+
+```
+artifact-driven-agent/
+├── bin/
+│   └── cli.ts              # CLI 진입점 (TypeScript)
+├── src/
+│   ├── commands/           # 명령어 구현 (.ts)
+│   ├── utils/              # 유틸리티 (.ts)
+│   ├── ui/                 # UI 컴포넌트 (.ts)
+│   └── types/              # TypeScript 타입 정의
+├── dist/                   # 빌드 출력 (npm run build)
+├── tsconfig.json           # TypeScript 설정
+├── core/                   # 프레임워크 핵심
+└── templates/              # 프로젝트 템플릿
 ```
 
 ---
@@ -524,7 +978,3 @@ MIT License
 - GitHub: [@silbaram](https://github.com/silbaram)
 - npm: [@silbaram/artifact-driven-agent](https://www.npmjs.com/package/@silbaram/artifact-driven-agent)
 
-
-
-
-