@silbaram/artifact-driven-agent 0.1.6 → 0.1.9

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

@@ -0,0 +1,193 @@
+# Project Standards (Frozen)
+
+> 🔒 이 문서는 **Frozen** 상태입니다.
+> 변경 시 RFC(Request for Change) 절차 필수.
+> 모든 개발자는 이 문서의 규칙을 따릅니다.
+
+**작성 주체:** 사용자와 팀이 함께 프로젝트 초기에 작성합니다.
+**작성 시점:** plan.md 확정 후, 개발 시작 전에 작성하여 Frozen 상태로 전환합니다.
+
+---
+
+## ✅ 문서 완성도 체크리스트
+
+> ⚠️ 모든 필수 항목이 체크되어야 Frozen 상태로 전환 가능
+
+### 필수 섹션 (Required)
+- [ ] 프로젝트 규모 정의 완료 (S/M/L)
+- [ ] 기술 스택 전체 항목 결정됨
+- [ ] 프로젝트 구조 정의됨
+- [ ] 명명 규칙 정의됨
+- [ ] 품질 기준 정의됨
+
+### 품질 체크 (Quality)
+- [ ] 모든 기술 선택에 근거 명시됨
+- [ ] 버전 번호가 구체적으로 명시됨 (예: "1.x" 금지, "1.21.0" 필요)
+- [ ] 금지 사항이 명확히 정의됨
+
+### 연결성 체크 (Linkage)
+- [ ] plan.md의 비기능 요구사항과 일관성 확인됨
+
+---
+
+## ⚠️ Frozen 문서 변경 절차 (RFC)
+
+> 이 문서가 Frozen 상태가 된 후에는 아래 절차로만 변경 가능
+
+### RFC 절차
+1. `rfc/` 디렉토리에 변경 제안서 작성
+   - 파일명: `RFC-NNNN-<title>.md`
+2. RFC 문서에 포함할 내용:
+   - 변경 사유
+   - 영향 범위 분석
+   - 대안 검토
+   - 롤백 계획
+3. Manager 승인
+4. decision.md에 기록
+5. project.md 업데이트
+
+### RFC 없이 변경 가능한 항목
+- 오타 수정
+- 예시 추가 (규칙 변경 없이)
+- 설명 보완 (의미 변경 없이)
+
+---
+
+## 0. 프로젝트 규모 정의 (Mandatory)
+
+| 항목 | 값 |
+|------|-----|
+| 규모 | S / M / L |
+| 판단 근거 | [근거] |
+| 핵심 기능 수 | N개 |
+| 예상 복잡도 | 낮음 / 중간 / 높음 |
+
+---
+
+## 1. 선택 요약 (Decision Summary)
+
+> 프로젝트 기술 스택 및 아키텍처 선택 사항
+
+| 항목 | 선택 | 근거 |
+|------|------|------|
+| [항목1] | [선택] | [근거] |
+| [항목2] | [선택] | [근거] |
+
+---
+
+## 2. 기술 스택 (Frozen)
+
+| 영역 | 선택 | 버전 | 비고 |
+|------|------|------|------|
+| 언어 | [선택] | [버전] | - |
+| 프레임워크 | [선택] | [버전] | - |
+| 데이터 저장 | [선택] | [버전] | - |
+| 테스트 | [선택] | [버전] | - |
+| 빌드 | [선택] | [버전] | - |
+
+---
+
+## 3. 아키텍처 규칙
+
+### 3.1 프로젝트 구조
+
+```
+src/
+├── [디렉토리]/
+│   └── [설명]
+├── [디렉토리]/
+│   └── [설명]
+└── [디렉토리]/
+    └── [설명]
+```
+
+### 3.2 명명 규칙
+
+| 대상 | 규칙 | 예시 |
+|------|------|------|
+| 파일 | [규칙] | [예시] |
+| 클래스/구조체 | [규칙] | [예시] |
+| 함수/메서드 | [규칙] | [예시] |
+| 변수 | [규칙] | [예시] |
+
+### 3.3 코드 스타일
+
+- 들여쓰기: [스페이스/탭, 개수]
+- 최대 줄 길이: [N자]
+- 린트 도구: [도구명]
+- 포매터: [도구명]
+
+---
+
+## 4. 품질 기준
+
+### 4.1 테스트
+
+| 항목 | 기준 |
+|------|------|
+| 테스트 프레임워크 | [선택] |
+| 최소 커버리지 | [N%] |
+| 필수 테스트 유형 | [단위/통합/E2E] |
+
+### 4.2 코드 품질
+
+| 항목 | 기준 |
+|------|------|
+| 린트 통과 | 필수 |
+| 타입 체크 | [필수/권장] |
+| 정적 분석 | [필수/권장] |
+
+---
+
+## 5. 의존성 관리
+
+### 5.1 허용된 의존성
+
+| 패키지 | 버전 | 용도 |
+|--------|------|------|
+| [패키지명] | [버전] | [용도] |
+
+### 5.2 의존성 추가 규칙
+
+- 새 의존성 추가 시: Manager 승인 필요
+- 버전 업그레이드 시: [규칙]
+- 금지된 패키지: [목록]
+
+---
+
+## 6. 문서화 규칙
+
+### 6.1 코드 문서화
+
+- 공개 인터페이스: 문서화 필수
+- 내부 구현: [규칙]
+- 문서화 형식: [형식]
+
+### 6.2 산출물 문서
+
+- 인터페이스 문서: [파일명]
+- 변경 시 갱신 필수
+
+---
+
+## 7. 제약 및 금지 사항 (Enforcement)
+
+### 7.1 금지 사항
+
+- ❌ 이 문서에 없는 기술/라이브러리 도입
+- ❌ 규칙 무시한 코드 커밋
+- ❌ 문서 없는 구조 변경
+- ❌ Manager 승인 없는 의존성 추가
+
+### 7.2 예외 처리
+
+- 예외 필요 시: Manager에게 에스컬레이션
+- 승인된 예외는 decision.md에 기록
+
+---
+
+## 8. 변경 이력
+
+| 버전 | 날짜 | 변경 내용 | 승인 |
+|------|------|----------|------|
+| v1.0 | YYYY-MM-DD | 초기 확정 | Manager |

package/ai-dev-team/artifacts/sprints/_template/docs/release-notes.md

@@ -0,0 +1,37 @@
+# Release Notes - Sprint N
+
+## 버전: v1.N.0
+
+## 날짜: YYYY-MM-DD
+
+### 새로운 기능
+
+- [기능명]: [설명]
+- [기능명]: [설명]
+
+### 개선 사항
+
+- [개선 내용]
+- [개선 내용]
+
+### 버그 수정
+
+- task-NNN: [버그 설명] → [수정 내용]
+- task-NNN: [버그 설명] → [수정 내용]
+
+### Breaking Changes
+
+> ⚠️ 기존 사용자에게 영향있는 변경
+
+- [변경 내용]
+- Migration: [마이그레이션 가이드]
+
+### 알려진 이슈
+
+- [알려진 문제와 임시 해결책]
+
+### 의존성 변경
+
+- 추가: [라이브러리명@버전]
+- 업데이트: [라이브러리명] v1.0 → v2.0
+- 제거: [라이브러리명]

package/ai-dev-team/artifacts/sprints/_template/meta.md

@@ -0,0 +1,54 @@
+# Sprint N 메타정보
+
+| 항목 | 값 |
+|------|-----|
+| 스프린트 번호 | N |
+| 상태 | active / completed |
+| 시작일 | YYYY-MM-DD |
+| 종료 예정 | YYYY-MM-DD (또는 완료일) |
+| 목표 | [스프린트 목표 설명] |
+
+## Task 목록
+
+| Task | 제목 | 상태 | 우선순위 | 크기 |
+|------|------|:----:|:--------:|:----:|
+| task-NNN | [Task 제목] | BACKLOG | P0/P1/P2 | S/M/L |
+
+**상태 범례:**
+- BACKLOG: 스프린트에 할당됨, 작업 미시작
+- IN_DEV: 개발 중
+- DONE: 완료
+- REJECTED: 리뷰 거부 (재작업 필요)
+
+## 이월된 Task
+
+> 이전 스프린트에서 미완료된 Task
+
+| Task | 원 스프린트 | 이월 사유 |
+|------|------------|----------|
+| - | - | - |
+
+## 차단 사항
+
+> 현재 진행을 막고 있는 이슈
+
+| Task | 차단 사유 | 담당자 | 상태 |
+|------|----------|--------|------|
+| - | - | - | - |
+
+## 스프린트 회고 (완료 시 작성)
+
+### 완료된 Task
+- task-NNN: [설명]
+
+### 미완료 Task (이월/취소)
+- task-NNN: [사유]
+
+### 잘된 점
+- [내용]
+
+### 개선할 점
+- [내용]
+
+### 다음 스프린트 제안
+- [제안]

package/ai-dev-team/artifacts/sprints/_template/retrospective.md

@@ -0,0 +1,50 @@
+# Sprint N 회고
+
+## 기간
+- 시작: YYYY-MM-DD
+- 종료: YYYY-MM-DD
+
+## 목표 달성도
+
+| 목표 | 달성 여부 | 비고 |
+|------|:--------:|------|
+| [목표 1] | ✅ / ⚠️ / ❌ | [설명] |
+| [목표 2] | ✅ / ⚠️ / ❌ | [설명] |
+
+## 완료된 Task (N개)
+
+- task-001: [설명]
+- task-002: [설명]
+
+## 미완료 Task (N개)
+
+| Task | 사유 | 처리 |
+|------|------|------|
+| task-NNN | [사유] | 이월 / 취소 |
+
+## 잘된 점 (Keep)
+
+- [구체적 내용]
+- [구체적 내용]
+
+## 개선할 점 (Problem)
+
+- [구체적 문제점]
+- [구체적 문제점]
+
+## 시도할 것 (Try)
+
+- [다음 스프린트에서 시도할 개선 방안]
+- [다음 스프린트에서 시도할 개선 방안]
+
+## 메트릭
+
+- 계획 Task 수: N개
+- 완료 Task 수: N개
+- 완료율: X%
+- 이월 Task 수: N개
+
+## 다음 스프린트 제안
+
+- [제안 1]
+- [제안 2]

package/ai-dev-team/artifacts/sprints/_template/review-reports/review-template.md

@@ -0,0 +1,49 @@
+# Review Report: task-NNN
+
+## Task 정보
+- Task: task-NNN [Task 이름]
+- Reviewer: reviewer
+- Review Date: YYYY-MM-DD
+
+## 수용 조건 체크
+
+- [x] 조건 1 - 충족
+- [x] 조건 2 - 충족
+- [ ] 조건 3 - 미충족 (사유: ...)
+
+## 기술 품질 체크
+
+- [x] project.md 규칙 준수 (있으면)
+- [x] 코드 스타일 준수
+- [x] 테스트 작성 (필요 시)
+- [ ] 문제 항목 (있으면)
+
+## 판정: PASS / REJECT / WARN
+
+**PASS** - 모든 조건 충족
+
+또는
+
+**REJECT** - 수용 조건 미충족
+- 사유 1: [구체적 설명]
+- 사유 2: [구체적 설명]
+
+또는
+
+**WARN** - 개선 권장
+- 경미한 문제: [설명]
+- 개선 제안: [내용]
+
+## 코멘트
+
+- [리뷰어의 전반적인 의견]
+- [개선 제안 또는 칭찬]
+
+## 수정 필요 사항 (REJECT인 경우)
+
+1. [구체적 수정 지시]
+2. [구체적 수정 지시]
+
+### 참고
+- project.md 섹션 X.X (있으면)
+- 수용 조건 N번

package/ai-dev-team/artifacts/sprints/_template/tasks/task-template.md

@@ -0,0 +1,43 @@
+# TASK-NNN: [Task 이름]
+
+| 항목 | 값 |
+|------|-----|
+| 상태 | BACKLOG / IN_DEV / DONE / REJECTED |
+| 우선순위 | P0 / P1 / P2 |
+| 크기 | S / M / L |
+| 출처 | F001 (plan.md 기능 ID) |
+| 담당 | - / developer |
+| 의존성 | - 또는 task-NNN |
+
+## 수용 조건 (Acceptance Criteria)
+
+- [ ] 조건 1
+- [ ] 조건 2
+- [ ] 조건 3
+
+## 구현 노트 (Developer 작성)
+
+> Developer가 작업하면서 기록
+
+- 구현 방식 설명
+- 기술적 결정 사항
+- 알려진 제약사항
+
+## 이슈 (있으면)
+
+> 작업 중 발견된 문제나 질문
+
+### 이슈 제목
+- 상황: [설명]
+- 영향: [영향도]
+- 제안: [해결 방안]
+
+→ 사용자 승인 대기 / 해결됨
+
+## 변경 이력
+
+| 날짜 | 상태 변경 | 작성자 | 비고 |
+|------|----------|--------|------|
+| YYYY-MM-DD | BACKLOG 생성 | planner | 초기 생성 |
+| YYYY-MM-DD | IN_DEV | developer | 작업 시작 |
+| YYYY-MM-DD | DONE | developer | 구현 완료 |

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

@@ -0,0 +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 | 목록 화면 추가 |