@silbaram/artifact-driven-agent 0.1.6 → 0.1.9

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

@@ -0,0 +1,10 @@
+{
+  "version": "1.0",
+  "updatedAt": "2026-01-24T16:46:33.177Z",
+  "currentPhase": "planning",
+  "activeSessions": [],
+  "pendingQuestions": [],
+  "taskProgress": {},
+  "notifications": [],
+  "locks": {}
+}

package/ai-dev-team/.ada-version

@@ -0,0 +1,6 @@
+{
+  "packageVersion": "0.1.9",
+  "workspaceVersion": "0.1.9",
+  "template": "web-dev",
+  "lastUpgrade": "2026-01-24T16:43:39.762Z"
+}

package/ai-dev-team/.current-template

@@ -0,0 +1 @@
+web-dev

package/ai-dev-team/.sessions/logs/20260124-014551-00f04724.log

@@ -0,0 +1,5 @@
+[2026-01-24 16:45:51] [INFO] 세션 시작: role=manager, tool=claude, template=web-dev
+[2026-01-24 16:45:51] [INFO] 세션 등록: 20260124-014551-00f04724
+[2026-01-24 16:45:51] [INFO] 시스템 프롬프트 저장: D:\development-code\artifact-driven-agent\ai-dev-team\.sessions\20260124-014551-00f04724\system-prompt.md
+[2026-01-24 16:45:51] [INFO] claude CLI 실행 (automation: perfect, captureOutput: false)
+[2026-01-24 16:46:10] [INFO] 세션 종료 (completed): 정상 종료

package/ai-dev-team/.sessions/logs/20260124-014623-cb2b1d44.log

@@ -0,0 +1,5 @@
+[2026-01-24 16:46:23] [INFO] 세션 시작: role=manager, tool=codex, template=web-dev
+[2026-01-24 16:46:23] [INFO] 세션 등록: 20260124-014623-cb2b1d44
+[2026-01-24 16:46:23] [INFO] 시스템 프롬프트 저장: D:\development-code\artifact-driven-agent\ai-dev-team\.sessions\20260124-014623-cb2b1d44\system-prompt.md
+[2026-01-24 16:46:23] [INFO] codex CLI 실행 (automation: manual, captureOutput: false)
+[2026-01-24 16:46:33] [INFO] 세션 종료 (completed): 정상 종료

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,212 @@
+# API Specification
+
+> Backend와 Frontend의 공식 계약 문서
+> 변경 시 rules/api-change.md 절차를 따른다
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 버전 | v1.0 |
+| Base URL | /api/v1 |
+| 최종 수정 | YYYY-MM-DD |
+
+---
+
+## 1. 공통 규칙
+
+### 1.1 HTTP 메서드
+
+| 메서드 | 용도 | 멱등성 |
+|--------|------|:------:|
+| GET | 조회 | ✅ |
+| POST | 생성 | ❌ |
+| PUT | 전체 수정 | ✅ |
+| PATCH | 부분 수정 | ❌ |
+| DELETE | 삭제 | ✅ |
+
+### 1.2 경로 규칙
+
+- 리소스명: 복수형 소문자 (예: `/users`, `/posts`)
+- 단일 리소스: `/{resource}/{id}`
+- 중첩 리소스: `/{parent}/{parentId}/{child}`
+
+---
+
+## 2. 인증/권한
+
+| 항목 | 값 |
+|------|-----|
+| Status | 사용 / 미사용 |
+| Scheme | Bearer Token / Cookie / API Key |
+| Token Location | Authorization: Bearer {token} |
+
+---
+
+## 3. 응답 규격 (Response Envelope)
+
+### 3.1 Success Response
+
+```json
+{
+  "success": true,
+  "data": { },
+  "error": null,
+  "meta": {
+    "requestId": "uuid",
+    "timestamp": "2024-01-01T00:00:00Z"
+  }
+}
+```
+
+### 3.2 Failure Response
+
+```json
+{
+  "success": false,
+  "data": null,
+  "error": {
+    "code": "ERROR_CODE",
+    "message": "사용자에게 표시할 메시지",
+    "details": { }
+  },
+  "meta": {
+    "requestId": "uuid",
+    "timestamp": "2024-01-01T00:00:00Z"
+  }
+}
+```
+
+---
+
+## 4. 공통 에러 코드
+
+| HTTP | 에러 코드 | 설명 |
+|------|----------|------|
+| 400 | BAD_REQUEST | 잘못된 요청 |
+| 400 | VALIDATION_ERROR | 유효성 검사 실패 |
+| 401 | UNAUTHORIZED | 인증 필요 |
+| 403 | FORBIDDEN | 권한 없음 |
+| 404 | NOT_FOUND | 리소스 없음 |
+| 409 | CONFLICT | 충돌 |
+| 500 | INTERNAL_ERROR | 서버 오류 |
+
+---
+
+## 5. 페이지네이션
+
+### Request
+
+```
+GET /resources?page=1&size=20&sort=createdAt,desc
+```
+
+### Response
+
+```json
+{
+  "success": true,
+  "data": {
+    "content": [...],
+    "page": {
+      "number": 1,
+      "size": 20,
+      "totalElements": 100,
+      "totalPages": 5
+    }
+  }
+}
+```
+
+---
+
+## 6. API 엔드포인트 정의
+
+### 6.1 [리소스명]
+
+#### GET /resources
+
+**설명:** 목록 조회
+
+**Request:**
+```
+Query Parameters:
+- page: number (default: 1)
+- size: number (default: 20)
+```
+
+**Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "content": [
+      {
+        "id": "uuid",
+        "name": "string",
+        "createdAt": "datetime"
+      }
+    ],
+    "page": { ... }
+  }
+}
+```
+
+**에러:**
+| 상황 | 코드 |
+|------|------|
+| 잘못된 파라미터 | BAD_REQUEST |
+
+---
+
+#### POST /resources
+
+**설명:** 생성
+
+**Request:**
+```json
+{
+  "name": "string (required)",
+  "description": "string (optional)"
+}
+```
+
+**Response (201):**
+```json
+{
+  "success": true,
+  "data": {
+    "id": "uuid",
+    "name": "string",
+    "createdAt": "datetime"
+  }
+}
+```
+
+**에러:**
+| 상황 | 코드 |
+|------|------|
+| 필수 필드 누락 | VALIDATION_ERROR |
+| 중복 | CONFLICT |
+
+---
+
+## 7. API 목록 요약
+
+| 메서드 | 경로 | 설명 | 상태 | Task |
+|--------|------|------|:----:|------|
+| GET | /resources | 목록 조회 | ✅ | TASK-001 |
+| POST | /resources | 생성 | ⏳ | TASK-001 |
+| GET | /resources/{id} | 단일 조회 | 📋 | TASK-002 |
+
+상태: ✅ 완료 / ⏳ 진행중 / 📋 예정
+
+---
+
+## 8. 변경 이력
+
+| Task | 날짜 | 변경 내용 |
+|------|------|----------|
+| [TASK-001] | YYYY-MM-DD | 초기 API 작성 |

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

@@ -0,0 +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 | [사유] | [조치] |

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/plan.md

@@ -0,0 +1,187 @@
+# [프로젝트명] 기획서
+
+> 문서 상태: Draft / Confirmed
+> 버전: v0.1
+> 최종 수정: YYYY-MM-DD
+
+---
+
+## ✅ 문서 완성도 체크리스트
+
+> ⚠️ 모든 필수 항목이 체크되어야 Confirmed 상태로 전환 가능
+
+### 필수 섹션 (Required)
+- [ ] 서비스 개요 작성 완료
+- [ ] 기능 목록 최소 1개 이상 정의
+- [ ] 사용자 흐름 최소 1개 이상 정의
+- [ ] 비기능 요구사항 정의
+- [ ] 제약 사항 명시
+- [ ] 미확정 항목(TBD) 3개 이하
+
+### 품질 체크 (Quality)
+- [ ] 모든 기능에 우선순위(P0/P1/P2) 지정됨
+- [ ] 모호한 표현 제거됨 (예: "빠르게", "적절히" → 구체적 수치)
+- [ ] 용어 정의에 도메인 용어 포함됨
+- [ ] 사용자와 합의 내용 기록됨
+
+### 연결성 체크 (Linkage)
+- [ ] 각 기능이 최소 1개 이상의 Task로 분해됨
+- [ ] 모든 Task가 backlog/ 디렉토리에 등록됨
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 상태 | Draft / Confirmed |
+| 버전 | v0.1 |
+| 작성자 | Planner |
+| 승인자 | - |
+
+---
+
+## 1. 서비스 개요
+
+(한 문단으로 프로젝트 요약)
+
+- 무엇을 만드는가:
+- 누가 사용하는가:
+- 왜 필요한가:
+
+---
+
+## 2. 기능 목록
+
+| ID | 기능명 | 설명 | 우선순위 |
+|----|--------|------|:--------:|
+| F001 | [기능명] | [한 줄 설명] | P0/P1/P2 |
+| F002 | [기능명] | [한 줄 설명] | P0/P1/P2 |
+| F003 | [기능명] | [한 줄 설명] | P0/P1/P2 |
+
+### 우선순위 정의
+
+- **P0**: 필수 (없으면 서비스 불가)
+- **P1**: 중요 (초기 버전에 포함)
+- **P2**: 향후 (나중에 추가)
+
+---
+
+## 3. 사용자 흐름 (User Flow)
+
+### 주요 시나리오 1: [시나리오명]
+
+```
+[시작점]
+    ↓
+[단계 1]
+    ↓
+[단계 2]
+    ↓
+[종료점]
+```
+
+### 주요 시나리오 2: [시나리오명]
+
+```
+[흐름 설명]
+```
+
+---
+
+## 4. 비기능 요구사항
+
+| 항목 | 요구사항 | 비고 |
+|------|----------|------|
+| 성능 | [요구사항] | - |
+| 보안 | [요구사항] | - |
+| 가용성 | [요구사항] | - |
+| 확장성 | [요구사항] | - |
+
+---
+
+## 5. 제약 사항
+
+- 일정: [제약]
+- 예산: [제약]
+- 기술: [제약]
+- 기타: [제약]
+
+---
+
+## 6. 가정 사항 (Assumptions)
+
+> 기획 시 전제한 가정들. 가정이 틀리면 기획 변경 필요.
+
+- [가정 1]
+- [가정 2]
+
+---
+
+## 7. 미확정 항목 (TBD)
+
+| ID | 항목 | 설명 | 결정 예정 |
+|----|------|------|----------|
+| TBD-001 | [항목] | [설명] | [시점] |
+| TBD-002 | [항목] | [설명] | [시점] |
+
+> ⚠️ 미확정 항목 3개 초과 시 개발 진행 전 명확화 필요
+
+---
+
+## 8. 용어 정의 (Glossary)
+
+| 용어 | 정의 |
+|------|------|
+| [용어] | [정의] |
+| [용어] | [정의] |
+
+---
+
+## 9. 참고 자료
+
+- [자료 1]
+- [자료 2]
+
+---
+
+## 10. 사용자 합의 요약
+
+> Planner와 사용자가 합의한 내용 요약
+
+### 확정된 사항
+- [합의 1]
+- [합의 2]
+
+### 논의 중인 사항
+- [논의 1]
+
+---
+
+## 11. 기능 → Task 매핑
+
+> plan.md 확정 후 Planner가 작성
+
+| 기능 ID | 기능명 | Task ID | Task 설명 |
+|---------|--------|---------|----------|
+| F001 | [기능명] | TASK-001 | [Task 설명] |
+| F001 | [기능명] | TASK-002 | [Task 설명] |
+| F002 | [기능명] | TASK-003 | [Task 설명] |
+
+---
+
+## 12. 변경 이력
+
+| 버전 | 날짜 | 변경 내용 | 작성자 |
+|------|------|----------|--------|
+| v0.1 | YYYY-MM-DD | 초안 작성 | Planner |
+
+---
+
+## 13. 다음 단계
+
+plan.md가 Confirmed 상태가 되면:
+
+1. **사용자**: project.md 작성 (기술 스택 결정, 선택사항)
+2. **Planner**: backlog/ 디렉토리에 Task 분해 (task-NNN.md 파일 생성)
+3. **사용자**: 첫 스프린트 계획 (ada sprint create)