@silbaram/artifact-driven-agent 0.1.7 → 0.2.3

package/ai-dev-team/.ada-status.template.json

@@ -1,10 +1,10 @@
-{
-  "version": "1.0",
-  "updatedAt": "",
-  "currentPhase": "idle",
-  "activeSessions": [],
-  "pendingQuestions": [],
-  "taskProgress": {},
-  "notifications": [],
-  "locks": {}
-}
+{
+  "version": "1.0",
+  "updatedAt": "",
+  "currentPhase": "idle",
+  "activeSessions": [],
+  "pendingQuestions": [],
+  "taskProgress": {},
+  "notifications": [],
+  "locks": {}
+}

package/ai-dev-team/README.md

@@ -1,44 +1,39 @@
-# AI Dev Team - 작업 디렉토리
-
-이 디렉토리는 AI 에이전트 기반 개발의 **작업 공간**입니다.
-
-## 📋 사용 방법
-
-### 1단계: 개발 스타일 세팅
-
-```bash
-# 대화형으로 템플릿 선택
-../scripts/ai-role.sh setup
-
-# 또는 직접 지정
-../scripts/ai-role.sh setup web      # 웹 서비스 개발
-../scripts/ai-role.sh setup library  # 라이브러리 개발
-../scripts/ai-role.sh setup game     # 게임 개발
-../scripts/ai-role.sh setup cli      # CLI 도구 개발
-```
-
-### 2단계: 역할 실행
-
-```bash
-# 대화형으로 역할/도구 선택
-../scripts/ai-role.sh
-
-# 또는 직접 지정
-../scripts/ai-role.sh backend claude
-../scripts/ai-role.sh planner codex
-```
-
-## 📁 세팅 후 구조
-
-```
-ai-dev-team/
-├── roles/           # Core + 템플릿 역할
-├── artifacts/       # Core + 템플릿 산출물 템플릿
-└── rules/           # Core + 템플릿 규칙
-```
-
-## ⚠️ 주의사항
-
-- `setup` 명령어는 기존 파일을 **덮어씁니다**
-- 산출물(artifacts/)의 내용은 프로젝트 진행 중 수정됩니다
-- 역할(roles/)과 규칙(rules/)은 수정하지 마세요
+# Artifact-Driven AI Agent Workspace
+
+이 디렉토리는 ADA 프레임워크를 통해 관리되는 AI 에이전트 기반 개발 공간입니다.
+
+## 📋 사용 방법
+
+### 1단계: 프로젝트 설정 (최초 1회)
+
+```bash
+ada setup web       # 웹 서비스 (React, Next.js 등)
+ada setup library   # 공통 라이브러리
+ada setup game      # 게임 개발
+ada setup cli       # CLI 도구
+```
+
+### 2단계: 에이전트 실행
+
+```bash
+# 기본 실행 (ada.config.json 설정 사용)
+ada run
+
+# 도구 지정 실행
+ada run developer claude
+ada run planner gemini
+```
+
+## 📁 주요 구조
+
+- `artifacts/`: `plan.md`, `backlog/`, `sprints/` 등 모든 산출물
+- `roles/`: 각 에이전트의 페르소나 및 책임 정의
+- `rules/`: 스프린트 운영 및 코드 품질 규칙
+- `skills/`: 역할별 전문 기술 스택 가이드 (Spring, React 등)
+- `ada.config.json`: 역할별 AI 도구 및 스킬 연결 설정
+
+## ⚠️ 주의사항
+
+- 모든 개발 판단은 `artifacts/` 내의 문서를 기준으로 합니다.
+- `roles/`와 `rules/`의 코어 파일은 직접 수정하지 말고, 설정이나 스킬 추가를 통해 제어하세요.
+- 스프린트 작업 완료 후 반드시 `ada sprint close`를 통해 정리하세요.

package/ai-dev-team/ada.config.json

@@ -0,0 +1,15 @@
+{
+  "version": "1.0",
+  "defaults": {
+    "tool": "claude"
+  },
+  "roles": {
+    "manager": "claude",
+    "planner": "claude",
+    "architect": "claude",
+    "developer": "claude",
+    "reviewer": "claude",
+    "improver": "claude",
+    "documenter": "claude"
+  }
+}

package/ai-dev-team/artifacts/api.md

@@ -0,0 +1,2 @@
+# API Documentation
+This is the API documentation.

package/ai-dev-team/artifacts/features/_template/api.md

@@ -1,19 +1,19 @@
-# Feature API: [Feature명]
-
-## 엔드포인트
-
-### [API명]
-
-```http
-POST /api/v1/[path]
-```
-
-**요청:**
-```json
-{ "field": "value" }
-```
-
-**응답 (200):**
-```json
-{ "success": true, "data": {} }
-```
+# Feature API: [Feature명]
+
+## 엔드포인트
+
+### [API명]
+
+```http
+POST /api/v1/[path]
+```
+
+**요청:**
+```json
+{ "field": "value" }
+```
+
+**응답 (200):**
+```json
+{ "success": true, "data": {} }
+```

package/ai-dev-team/artifacts/features/_template/review.md

@@ -1,14 +1,14 @@
-# Feature Review: [Feature명]
-
-## Task별 리뷰
-
-### TASK-001
-
-| 항목 | 값 |
-|------|-----|
-| 결과 | PASS / REJECT |
-| 리뷰어 | - |
-| 일시 | YYYY-MM-DD |
-
-**코멘트:**
-- 코멘트 1
+# Feature Review: [Feature명]
+
+## Task별 리뷰
+
+### TASK-001
+
+| 항목 | 값 |
+|------|-----|
+| 결과 | PASS / REJECT |
+| 리뷰어 | - |
+| 일시 | YYYY-MM-DD |
+
+**코멘트:**
+- 코멘트 1

package/ai-dev-team/artifacts/features/_template/spec.md

@@ -1,28 +1,28 @@
-# Feature: [Feature명]
-
-> Feature ID: F000
-> 상태: Draft / In Progress / Done
-
-## 1. 개요
-
-### 기능 설명
-(한 문단으로 요약)
-
-### 목표
-- 목표 1
-
-### 비목표
-- 이 Feature에서 다루지 않는 것
-
-## 2. 수용 조건
-
-### AC-001: [조건명]
-- Given: [전제 조건]
-- When: [행동]
-- Then: [기대 결과]
-
-## 3. 관련 Task
-
-| Task ID | 설명 | 상태 |
-|---------|------|------|
-| TASK-000 | [설명] | BACKLOG |
+# Feature: [Feature명]
+
+> Feature ID: F000
+> 상태: Draft / In Progress / Done
+
+## 1. 개요
+
+### 기능 설명
+(한 문단으로 요약)
+
+### 목표
+- 목표 1
+
+### 비목표
+- 이 Feature에서 다루지 않는 것
+
+## 2. 수용 조건
+
+### AC-001: [조건명]
+- Given: [전제 조건]
+- When: [행동]
+- Then: [기대 결과]
+
+## 3. 관련 Task
+
+| Task ID | 설명 | 상태 |
+|---------|------|------|
+| TASK-000 | [설명] | BACKLOG |

package/ai-dev-team/artifacts/features/_template/ui.md

@@ -1,14 +1,14 @@
-# Feature UI: [Feature명]
-
-## 화면 목록
-
-| ID | 화면명 | 설명 |
-|----|--------|------|
-| SCR-001 | [화면명] | [설명] |
-
-## 상태별 UI
-
-- Loading: 스켈레톤
-- Empty: 빈 상태 메시지
-- Error: 에러 + 재시도
-- Success: 데이터 표시
+# Feature UI: [Feature명]
+
+## 화면 목록
+
+| ID | 화면명 | 설명 |
+|----|--------|------|
+| SCR-001 | [화면명] | [설명] |
+
+## 상태별 UI
+
+- Loading: 스켈레톤
+- Empty: 빈 상태 메시지
+- Error: 에러 + 재시도
+- Success: 데이터 표시

package/ai-dev-team/artifacts/improvement-reports/IMP-0000-template.md

@@ -0,0 +1,57 @@
+# IMP-NNNN: [개선 제목]
+
+| 항목 | 값 |
+|------|-----|
+| 일시 | YYYY-MM-DD |
+| 작성자 | improver |
+| 상태 | PLANNED / IN_PROGRESS / DONE |
+
+## 1. 현황
+
+- 대상: [개선 대상 기능/모듈]
+- 현재 문제: [구체적인 문제점]
+- 측정 지표: [성능, UX 지표 등]
+
+## 2. 분석
+
+### 병목 지점 / 문제점
+1. [문제 1] - [영향도]
+2. [문제 2] - [영향도]
+3. [문제 3] - [영향도]
+
+### 코드 위치
+- [파일명]:[라인 번호]
+- [파일명]:[라인 번호]
+
+### 원인 분석
+[왜 이 문제가 발생했는지]
+
+## 3. 개선 방향 (선택된 옵션)
+
+**옵션 [A/B/C]: [옵션명]**
+- 개선 방법: [구체적 방법]
+- 예상 효과: [개선 효과]
+- 장점: [장점 나열]
+- 단점: [단점 나열]
+
+### 기술 변경 (있다면)
+- [추가/변경되는 기술 스택]
+- project.md 업데이트 필요 여부: Y/N
+
+## 4. Task 목록
+
+- task-NNN: [Task 제목] (S/M/L)
+- task-NNN: [Task 제목] (S/M/L)
+- task-NNN: [Task 제목] (S/M/L)
+
+## 5. 영향 범위
+
+- Breaking Change: Y/N
+- 데이터 마이그레이션: 필요 / 불필요
+- 인프라 변경: [변경 사항]
+- 다른 기능 영향: [영향받는 기능들]
+
+## 6. 고려사항 / 참고
+
+- [기타 고려사항]
+- [참고 링크/문서]

package/ai-dev-team/artifacts/project.md

@@ -0,0 +1,2 @@
+# Project Rules
+This is the core project file.

package/ai-dev-team/artifacts/rfc/RFC-0000-template.md

@@ -1,49 +1,49 @@
-# RFC-0000: [변경 제목]
-
-> 상태: Draft / Under Review / Approved / Rejected
-> 작성자: -
-> 작성일: YYYY-MM-DD
-
-## 1. 요약
-
-(한 문단으로 변경 사항 요약)
-
-## 2. 동기
-
-### 현재 문제점
-- 문제점 1
-
-### 변경이 필요한 이유
-- 이유 1
-
-## 3. 제안
-
-### 변경 내용
-(구체적인 변경 사항)
-
-### 변경 대상 문서
-| 문서 | 변경 내용 |
-|------|----------|
-| project.md | [변경 내용] |
-
-## 4. 영향 분석
-
-| 영역 | 영향도 | 설명 |
-|------|:------:|------|
-| 기존 코드 | 높음/중간/낮음 | [설명] |
-
-## 5. 대안 검토
-
-### 대안 1: [대안명]
-**채택하지 않은 이유:** [이유]
-
-## 6. 롤백 계획
-
-1. 롤백 단계 1
-2. 롤백 단계 2
-
-## 7. 결정
-
-- **결정**: Approved / Rejected
-- **결정자**: Manager
-- **일시**: YYYY-MM-DD
+# RFC-0000: [변경 제목]
+
+> 상태: Draft / Under Review / Approved / Rejected
+> 작성자: -
+> 작성일: YYYY-MM-DD
+
+## 1. 요약
+
+(한 문단으로 변경 사항 요약)
+
+## 2. 동기
+
+### 현재 문제점
+- 문제점 1
+
+### 변경이 필요한 이유
+- 이유 1
+
+## 3. 제안
+
+### 변경 내용
+(구체적인 변경 사항)
+
+### 변경 대상 문서
+| 문서 | 변경 내용 |
+|------|----------|
+| project.md | [변경 내용] |
+
+## 4. 영향 분석
+
+| 영역 | 영향도 | 설명 |
+|------|:------:|------|
+| 기존 코드 | 높음/중간/낮음 | [설명] |
+
+## 5. 대안 검토
+
+### 대안 1: [대안명]
+**채택하지 않은 이유:** [이유]
+
+## 6. 롤백 계획
+
+1. 롤백 단계 1
+2. 롤백 단계 2
+
+## 7. 결정
+
+- **결정**: Approved / Rejected
+- **결정자**: Manager
+- **일시**: YYYY-MM-DD

package/core/artifacts/decision.md

@@ -1,72 +1,72 @@
-# Decision Log
-
-> 사용자의 모든 판단을 기록
-> 시간순으로 기록
-
----
-
-## 현재 상태
-
-| 항목 | 값 |
-|------|-----|
-| 현재 단계 | 기획 / 아키텍처 / 개발 / 완료 |
-| 스프린트 | Sprint N |
-| 마지막 결정 | YYYY-MM-DD |
-
----
-
-## Decision Log
-
-### Decision #1
-
-| 항목 | 값 |
-|------|-----|
-| 일시 | YYYY-MM-DD HH:MM |
-| 유형 | 단계 전환 / 예외 승인 / 되돌림 / 스프린트 |
-| 요청자 | [역할] |
-
-**내용:**
-[결정 내용]
-
-**근거:**
-[판단 근거]
-
-**결과:** ✅ 승인 / ❌ 거부 / ⏸️ 보류
-
----
-
-### Decision #2
-
-| 항목 | 값 |
-|------|-----|
-| 일시 | YYYY-MM-DD HH:MM |
-| 유형 | [유형] |
-| 요청자 | [역할] |
-
-**내용:**
-[결정 내용]
-
-**근거:**
-[판단 근거]
-
-**결과:** ✅ 승인 / ❌ 거부 / ⏸️ 보류
-
----
-
-## 예외 승인 이력
-
-> 규칙 예외로 승인된 항목들
-
-| # | 날짜 | 내용 | 사유 |
-|---|------|------|------|
-| 1 | YYYY-MM-DD | [예외 내용] | [사유] |
-
----
-
-## 되돌림 이력
-
-> REJECT/FAIL로 인한 되돌림 기록
-
-| # | 날짜 | 대상 | 사유 | 조치 |
-|---|------|------|------|------|
-| 1 | YYYY-MM-DD | TASK-XXX | [사유] | [조치] |
+# Decision Log
+
+> 사용자의 모든 판단을 기록
+> 시간순으로 기록
+
+---
+
+## 현재 상태
+
+| 항목 | 값 |
+|------|-----|
+| 현재 단계 | 기획 / 아키텍처 / 개발 / 완료 |
+| 스프린트 | Sprint N |
+| 마지막 결정 | YYYY-MM-DD |
+
+---
+
+## Decision Log
+
+### Decision #1
+
+| 항목 | 값 |
+|------|-----|
+| 일시 | YYYY-MM-DD HH:MM |
+| 유형 | 단계 전환 / 예외 승인 / 되돌림 / 스프린트 |
+| 요청자 | [역할] |
+
+**내용:**
+[결정 내용]
+
+**근거:**
+[판단 근거]
+
+**결과:** ✅ 승인 / ❌ 거부 / ⏸️ 보류
+
+---
+
+### Decision #2
+
+| 항목 | 값 |
+|------|-----|
+| 일시 | YYYY-MM-DD HH:MM |
+| 유형 | [유형] |
+| 요청자 | [역할] |
+
+**내용:**
+[결정 내용]
+
+**근거:**
+[판단 근거]
+
+**결과:** ✅ 승인 / ❌ 거부 / ⏸️ 보류
+
+---
+
+## 예외 승인 이력
+
+> 규칙 예외로 승인된 항목들
+
+| # | 날짜 | 내용 | 사유 |
+|---|------|------|------|
+| 1 | YYYY-MM-DD | [예외 내용] | [사유] |
+
+---
+
+## 되돌림 이력
+
+> REJECT/FAIL로 인한 되돌림 기록
+
+| # | 날짜 | 대상 | 사유 | 조치 |
+|---|------|------|------|------|
+| 1 | YYYY-MM-DD | TASK-XXX | [사유] | [조치] |