@silbaram/artifact-driven-agent 0.1.9 → 0.2.3

package/templates/web-dev/artifacts/api.md

@@ -1,212 +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 작성 |
+# 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/templates/web-dev/artifacts/ui.md

@@ -1,104 +1,104 @@
-# UI Specification
-
-> 프론트엔드 화면 설계 문서
-> plan.md 사용자 흐름과 api.md 연동 기준
-
----
-
-## 0. 문서 메타
-
-| 항목 | 값 |
-|------|-----|
-| 버전 | v1.0 |
-| 최종 수정 | YYYY-MM-DD |
-
----
-
-## 1. 라우팅 구조
-
-| 경로 | 화면명 | 설명 | 상태 | Task |
-|------|--------|------|:----:|------|
-| / | 홈 | 메인 화면 | ✅ | TASK-001 |
-| /list | 목록 | 목록 화면 | ⏳ | TASK-002 |
-| /detail/:id | 상세 | 상세 화면 | 📋 | TASK-003 |
-
-상태: ✅ 완료 / ⏳ 진행중 / 📋 예정
-
----
-
-## 2. 화면별 상태 정의 (필수)
-
-### 2.1 [화면명]: /path
-
-#### API 연동
-
-| API | 용도 | 상태 |
-|-----|------|------|
-| GET /resources | 데이터 조회 | 연동 |
-
-#### 화면 상태
-
-| 상태 | 조건 | 표시 |
-|------|------|------|
-| Loading | API 호출 중 | 로딩 스피너 |
-| Empty | data.length === 0 | "데이터가 없습니다" |
-| Error | API 실패 | 에러 메시지 + 재시도 |
-| Success | data.length > 0 | 데이터 목록 |
-
-#### 사용자 액션
-
-| 액션 | 트리거 | 결과 |
-|------|--------|------|
-| 새로고침 | 버튼 클릭 | 목록 재조회 |
-| 항목 클릭 | 목록 아이템 | 상세 화면 이동 |
-
----
-
-### 2.2 [화면명]: /path
-
-(동일 형식으로 작성)
-
----
-
-## 3. API 연동 매핑
-
-| 화면 | API | 상태 관리 |
-|------|-----|----------|
-| 목록 | GET /resources | 로컬 |
-| 상세 | GET /resources/{id} | 로컬 |
-| 생성 폼 | POST /resources | 로컬 |
-
----
-
-## 4. 컴포넌트 구조 (요약)
-
-```
-src/
-├── pages/
-│   ├── HomePage/
-│   ├── ListPage/
-│   └── DetailPage/
-├── components/
-│   ├── common/
-│   └── [feature]/
-└── hooks/
-    └── [feature]/
-```
-
----
-
-## 5. 공통 컴포넌트
-
-| 컴포넌트 | 용도 | Props |
-|----------|------|-------|
-| Loading | 로딩 표시 | - |
-| Empty | 빈 상태 | message |
-| Error | 에러 표시 | message, onRetry |
-
----
-
-## 6. 변경 이력
-
-| Task | 날짜 | 변경 내용 |
-|------|------|----------|
-| [TASK-002] | YYYY-MM-DD | 목록 화면 추가 |
+# UI Specification
+
+> 프론트엔드 화면 설계 문서
+> plan.md 사용자 흐름과 api.md 연동 기준
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 버전 | v1.0 |
+| 최종 수정 | YYYY-MM-DD |
+
+---
+
+## 1. 라우팅 구조
+
+| 경로 | 화면명 | 설명 | 상태 | Task |
+|------|--------|------|:----:|------|
+| / | 홈 | 메인 화면 | ✅ | TASK-001 |
+| /list | 목록 | 목록 화면 | ⏳ | TASK-002 |
+| /detail/:id | 상세 | 상세 화면 | 📋 | TASK-003 |
+
+상태: ✅ 완료 / ⏳ 진행중 / 📋 예정
+
+---
+
+## 2. 화면별 상태 정의 (필수)
+
+### 2.1 [화면명]: /path
+
+#### API 연동
+
+| API | 용도 | 상태 |
+|-----|------|------|
+| GET /resources | 데이터 조회 | 연동 |
+
+#### 화면 상태
+
+| 상태 | 조건 | 표시 |
+|------|------|------|
+| Loading | API 호출 중 | 로딩 스피너 |
+| Empty | data.length === 0 | "데이터가 없습니다" |
+| Error | API 실패 | 에러 메시지 + 재시도 |
+| Success | data.length > 0 | 데이터 목록 |
+
+#### 사용자 액션
+
+| 액션 | 트리거 | 결과 |
+|------|--------|------|
+| 새로고침 | 버튼 클릭 | 목록 재조회 |
+| 항목 클릭 | 목록 아이템 | 상세 화면 이동 |
+
+---
+
+### 2.2 [화면명]: /path
+
+(동일 형식으로 작성)
+
+---
+
+## 3. API 연동 매핑
+
+| 화면 | API | 상태 관리 |
+|------|-----|----------|
+| 목록 | GET /resources | 로컬 |
+| 상세 | GET /resources/{id} | 로컬 |
+| 생성 폼 | POST /resources | 로컬 |
+
+---
+
+## 4. 컴포넌트 구조 (요약)
+
+```
+src/
+├── pages/
+│   ├── HomePage/
+│   ├── ListPage/
+│   └── DetailPage/
+├── components/
+│   ├── common/
+│   └── [feature]/
+└── hooks/
+    └── [feature]/
+```
+
+---
+
+## 5. 공통 컴포넌트
+
+| 컴포넌트 | 용도 | Props |
+|----------|------|-------|
+| Loading | 로딩 표시 | - |
+| Empty | 빈 상태 | message |
+| Error | 에러 표시 | message, onRetry |
+
+---
+
+## 6. 변경 이력
+
+| Task | 날짜 | 변경 내용 |
+|------|------|----------|
+| [TASK-002] | YYYY-MM-DD | 목록 화면 추가 |