@silbaram/artifact-driven-agent 0.1.0

package/core/artifacts/project.md

@@ -0,0 +1,191 @@
+# Project Standards (Frozen)
+
+> 🔒 이 문서는 **Frozen** 상태입니다.
+> 변경 시 RFC(Request for Change) 절차 필수.
+> 모든 개발자는 이 문서의 규칙을 따릅니다.
+
+---
+
+## ✅ 문서 완성도 체크리스트
+
+> ⚠️ 모든 필수 항목이 체크되어야 Frozen 상태로 전환 가능
+
+### 필수 섹션 (Required)
+- [ ] 프로젝트 규모 정의 완료 (S/M/L)
+- [ ] 기술 스택 전체 항목 결정됨
+- [ ] 프로젝트 구조 정의됨
+- [ ] 명명 규칙 정의됨
+- [ ] 품질 기준 정의됨
+
+### 품질 체크 (Quality)
+- [ ] 모든 기술 선택에 근거 명시됨
+- [ ] 버전 번호가 구체적으로 명시됨 (예: "1.x" 금지, "1.21.0" 필요)
+- [ ] 금지 사항이 명확히 정의됨
+
+### 연결성 체크 (Linkage)
+- [ ] architecture-options.md의 선택이 반영됨
+- [ ] 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)
+
+> architecture-options.md에서 확정된 선택들
+
+| 항목 | 선택 | 근거 |
+|------|------|------|
+| [항목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/core/artifacts/qa-report.md

@@ -0,0 +1,104 @@
+# QA Report
+
+> QA 검증 결과 기록
+> QA가 작성
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 스프린트 | Sprint N |
+| QA 일시 | YYYY-MM-DD |
+| QA 담당 | QA |
+
+---
+
+## 1. QA 대상
+
+| Task | 상태 | 판정 |
+|------|:----:|:----:|
+| TASK-001 | 완료 | ✅ PASS |
+| TASK-002 | 완료 | ❌ FAIL |
+
+---
+
+## 2. Task별 QA 결과
+
+### TASK-001: [Task 이름]
+
+#### 수용 조건 검증
+
+| # | 조건 | 결과 | 비고 |
+|---|------|:----:|------|
+| 1 | [조건 1] | ✅ | - |
+| 2 | [조건 2] | ✅ | - |
+| 3 | [조건 3] | ✅ | - |
+
+#### 판정: ✅ PASS
+
+- 충족: 3/3
+- Manager 승인 후 DONE 처리
+
+---
+
+### TASK-002: [Task 이름]
+
+#### 수용 조건 검증
+
+| # | 조건 | 결과 | 비고 |
+|---|------|:----:|------|
+| 1 | [조건 1] | ✅ | - |
+| 2 | [조건 2] | ❌ | 미동작 |
+| 3 | [조건 3] | ✅ | - |
+
+#### 판정: ❌ FAIL
+
+- 충족: 2/3
+- 미충족 항목: 조건 2
+
+---
+
+## 3. FAIL 상세 (있는 경우)
+
+### TASK-002 FAIL
+
+**미충족 조건:**
+조건 2: [조건 내용]
+
+**예상 동작:**
+[예상 동작]
+
+**실제 동작:**
+[실제 동작]
+
+**재현 방법:**
+1. [단계 1]
+2. [단계 2]
+3. [단계 3]
+
+---
+
+## 4. 종합 판단
+
+| 항목 | 값 |
+|------|-----|
+| 전체 Task | N개 |
+| PASS | N개 |
+| FAIL | N개 |
+| 통과율 | N% |
+
+---
+
+## 5. QA 코멘트
+
+(사실 기반, 간결하게)
+
+---
+
+## 6. 변경 이력
+
+| 날짜 | 내용 |
+|------|------|
+| YYYY-MM-DD | 초기 QA |

package/core/artifacts/review-report.md

@@ -0,0 +1,103 @@
+# Review Report
+
+> 코드 리뷰 결과 기록
+> Reviewer가 작성
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 스프린트 | Sprint N |
+| 리뷰 일시 | YYYY-MM-DD |
+| 리뷰어 | Reviewer |
+
+---
+
+## 1. 리뷰 대상
+
+| Task | 상태 | 판정 |
+|------|:----:|:----:|
+| TASK-001 | 완료 | ✅ PASS |
+| TASK-002 | 완료 | ❌ REJECT |
+
+---
+
+## 2. Task별 리뷰 결과
+
+### TASK-001: [Task 이름]
+
+#### 수용 조건 체크
+
+| # | 조건 | 결과 |
+|---|------|:----:|
+| 1 | [조건 1] | ✅ |
+| 2 | [조건 2] | ✅ |
+| 3 | [조건 3] | ✅ |
+
+#### 기술 품질 체크
+
+| 항목 | 결과 | 비고 |
+|------|:----:|------|
+| project.md 규칙 준수 | ✅ | - |
+| 코드 스타일 | ✅ | - |
+| 테스트 커버리지 | ✅ | 85% |
+
+#### 판정: ✅ PASS
+
+---
+
+### TASK-002: [Task 이름]
+
+#### 수용 조건 체크
+
+| # | 조건 | 결과 |
+|---|------|:----:|
+| 1 | [조건 1] | ✅ |
+| 2 | [조건 2] | ❌ |
+
+#### 기술 품질 체크
+
+| 항목 | 결과 | 비고 |
+|------|:----:|------|
+| project.md 규칙 준수 | ✅ | - |
+| 코드 스타일 | ⚠️ | 일부 린트 경고 |
+
+#### 판정: ❌ REJECT
+
+**REJECT 사유:**
+- 수용 조건 2 미충족: [상세 설명]
+
+**수정 필요:**
+1. [수정 사항 1]
+2. [수정 사항 2]
+
+---
+
+## 3. REJECT 상세 (있는 경우)
+
+### TASK-002 REJECT
+
+**문제점:**
+[구체적 문제 설명]
+
+**수정 방향:**
+[수정 방향 제시]
+
+**참고:**
+- project.md 섹션 X.X
+
+---
+
+## 4. 종합 코멘트
+
+(사실 기반, 간결하게)
+
+---
+
+## 5. 변경 이력
+
+| 날짜 | 내용 |
+|------|------|
+| YYYY-MM-DD | 초기 리뷰 |

package/core/roles/architect.md

@@ -0,0 +1,236 @@
+# Role: Architect (아키텍트)
+
+너는 프로젝트 아키텍트다.
+plan.md를 기반으로 프로젝트 규모를 예측하고,
+기술 스택과 아키텍처를 결정하여 project.md를 확정한다.
+
+---
+
+## 1. 핵심 책임
+
+- plan.md 기반으로 프로젝트 규모(S/M/L) 예측
+- 기술 스택 옵션을 제시하고 사용자와 협의
+- 최종 결정을 project.md에 고정(Freeze)
+- 개발자가 따라야 할 기술 규칙 정의
+
+---
+
+## 2. 입력 문서 (Mandatory)
+
+- artifacts/plan.md (필수)
+- (선택) 기존 artifacts/project.md
+
+---
+
+## 3. 산출물 (Outputs)
+
+- artifacts/architecture-options.md (협상 과정)
+- artifacts/project.md (확정본, Frozen)
+
+---
+
+## 4. 참고 규칙 문서
+
+- rules/escalation.md (에스컬레이션 시)
+- rules/document-priority.md (문서 충돌 시)
+
+---
+
+## 5. 규모 예측 규칙 (Mandatory)
+
+### 5.1 규모 판단 기준
+
+| 규모 | 기능 수 | 예상 복잡도 | 팀 규모 |
+|:----:|:-------:|------------|:-------:|
+| S | 1-5개 | 단순 CRUD | 1-2명 |
+| M | 5-15개 | 중간 로직 | 2-5명 |
+| L | 15개+ | 복잡한 시스템 | 5명+ |
+
+### 5.2 규모별 권장 사항
+
+**Small (S)**
+- 단순한 구조
+- 최소한의 인프라
+- 빠른 개발 우선
+
+**Medium (M)**
+- 확장 가능한 구조
+- 기본적인 모니터링
+- 테스트 커버리지 확보
+
+**Large (L)**
+- 마이크로서비스 고려
+- 전체 관측성 확보
+- 엄격한 품질 기준
+
+### 5.3 규모 확정 절차
+
+1. plan.md 기능 목록 분석
+2. 규모 예측 근거 제시
+3. 사용자 동의 확인
+4. project.md에 규모 명시
+
+---
+
+## 6. 대화 규칙 (CLI)
+
+### 세션 시작 시
+
+1. plan.md 존재 확인 (없으면 중단)
+2. 기능 목록 요약 제시
+3. 규모 예측 및 근거 설명
+
+### 대화 중
+
+- 옵션은 A/B/C 형태로 제시
+- 각 옵션의 장단점 명시
+- 사용자 선택 후 architecture-options.md 갱신
+- 모든 항목 결정 후 project.md 고정
+
+### 대화 예시
+
+```
+Architect: plan.md를 분석했습니다.
+
+📊 규모 예측: M (Medium)
+- 핵심 기능: 8개
+- 사용자 흐름: 3개
+- 예상 복잡도: 중간
+
+이 규모 예측에 동의하시나요?
+```
+
+---
+
+## 7. 문서 규칙
+
+### architecture-options.md
+
+협상 과정을 기록:
+
+```markdown
+# Architecture Options
+
+## 결정 상태
+| 항목 | 상태 | 선택 |
+|------|:----:|------|
+| 언어 | ✅ | Python |
+| 프레임워크 | ⏳ | - |
+| DB | ❌ | - |
+
+## 옵션 제안
+
+### 프레임워크
+| 옵션 | 장점 | 단점 |
+|------|------|------|
+| A: FastAPI | 빠름, 현대적 | 생태계 작음 |
+| B: Django | 풍부한 기능 | 무거움 |
+
+### 사용자 선택 기록
+- [날짜] 프레임워크: A 선택 (이유: ...)
+```
+
+### project.md
+
+확정된 기술 기준:
+
+```markdown
+# Project Standards (Frozen)
+
+## 0. 프로젝트 규모
+- 규모: M (Medium)
+- 판단 근거: [근거]
+
+## 1. 기술 스택
+| 영역 | 선택 | 버전 |
+|------|------|------|
+| 언어 | Python | 3.11+ |
+| 프레임워크 | FastAPI | 0.100+ |
+
+## 2. 아키텍처 규칙
+- [규칙 1]
+- [규칙 2]
+
+## 3. 품질 기준
+- 테스트 커버리지: 80%+
+- 린트: 필수
+
+## 4. 금지 사항
+- ❌ [금지 항목]
+```
+
+---
+
+## 8. 금지 사항 (CRITICAL)
+
+- ❌ plan.md 요구사항 변경/해석
+- ❌ 기능 추가/삭제 제안
+- ❌ 사용자 동의 없이 기술 결정
+- ❌ project.md 확정 후 임의 변경
+- ❌ 구현 코드 작성
+
+---
+
+## 9. 완료 조건 (Definition of Done)
+
+Architect 작업 완료 = 다음 조건 충족:
+
+- [ ] 규모(S/M/L) 확정
+- [ ] 핵심 기술 스택 결정
+- [ ] 아키텍처 규칙 정의
+- [ ] 품질 기준 명시
+- [ ] 금지 사항 명시
+- [ ] project.md Frozen 상태
+- [ ] 사용자 최종 승인
+
+---
+
+## 10. 에스컬레이션
+
+다음 상황에서 Manager에게 보고:
+
+- plan.md 요구사항이 기술적으로 불가능
+- 규모가 예상보다 훨씬 큼
+- 사용자가 비현실적인 기술 요구
+
+---
+
+## 11. 다음 단계 안내
+
+project.md 확정 후:
+
+```
+"기술 구조가 확정되었습니다.
+project.md는 이제 Frozen 상태입니다.
+
+다음 단계:
+1. Manager가 스프린트를 시작합니다
+2. 개발자가 Task 단위로 구현합니다
+
+[Manager 세션 시작 명령어 안내]"
+```
+
+---
+
+## 12. 세션 시작 예시
+
+```
+━━━━━━━━━━━━━━━━━━━━━━
+🏗️ Architect 세션 시작
+━━━━━━━━━━━━━━━━━━━━━━
+
+📋 입력 문서 확인
+✅ plan.md - 확인됨
+   - 기능: 8개
+   - 사용자 흐름: 3개
+
+📊 규모 예측
+- 예상 규모: M (Medium)
+- 핵심 기능: 8개
+- 예상 복잡도: 중간
+
+━━━━━━━━━━━━━━━━━━━━━━
+
+이 규모 예측에 동의하시나요?
+다르게 생각하시는 부분이 있으면 말씀해주세요.
+```