@silbaram/artifact-driven-agent 0.1.6 → 0.1.9

package/core/docs-templates/mkdocs/docs/contributing/contributing.md

@@ -0,0 +1,60 @@
+# 기여 가이드
+
+## 기여자 환영!
+
+[프로젝트명]에 기여를 고려해주셔서 감사합니다!
+
+## 기여 방법
+
+### 버그 보고
+
+1. [이슈](https://github.com/username/repo/issues)에 이미 보고된 버그인지 확인
+2. 보고되지 않았다면 다음 정보와 함께 새 이슈 생성:
+   - 명확한 제목
+   - 상세한 설명
+   - 재현 단계
+   - 예상 동작 vs 실제 동작
+   - 환경 정보
+
+### 기능 제안
+
+1. [토론](https://github.com/username/repo/discussions) 확인
+2. 다음 정보와 함께 새 토론 생성:
+   - 기능 설명
+   - 사용 사례
+   - 제안 구현 (선택 사항)
+
+### Pull Request 제출
+
+1. 저장소 Fork
+2. 기능 브랜치 생성: `git checkout -b feature/your-feature`
+3. 변경사항 작성
+4. 테스트 작성 또는 업데이트
+5. 테스트 실행: `npm test`
+6. 명확한 메시지로 커밋: `git commit -m "Add feature X"`
+7. Push: `git push origin feature/your-feature`
+8. Pull Request 생성
+
+## 개발 환경 설정
+
+[개발 가이드](development.md)를 참고하세요.
+
+## 코드 스타일
+
+- 기존 코드 스타일 준수
+- 린터 실행: `npm run lint`
+- 코드 포맷팅: `npm run format`
+
+## 테스트
+
+```bash
+# 전체 테스트 실행
+npm test
+
+# 특정 테스트 실행
+npm test -- tests/specific.test.js
+```
+
+## 행동 강령
+
+[행동 강령](code-of-conduct.md)을 참고하세요.

package/core/docs-templates/mkdocs/docs/getting-started/configuration.md

@@ -0,0 +1,51 @@
+# 설정
+
+## 설정 파일
+
+설정 파일은 일반적으로 `config.yml` 또는 `.configrc`에 위치합니다.
+
+```yaml
+# 설정 예시
+option1: value1
+option2: value2
+```
+
+## 설정 옵션
+
+### 기본 옵션
+
+| 옵션 | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| `option1` | string | `"default"` | 설명 |
+| `option2` | number | `0` | 설명 |
+
+### 고급 옵션
+
+| 옵션 | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| `advanced1` | boolean | `false` | 설명 |
+| `advanced2` | array | `[]` | 설명 |
+
+## 환경 변수
+
+| 변수 | 설명 | 기본값 |
+|------|------|--------|
+| `ENV_VAR_1` | 설명 | - |
+| `ENV_VAR_2` | 설명 | - |
+
+## 예시
+
+### 개발 환경 설정
+
+```yaml
+mode: development
+debug: true
+```
+
+### 프로덕션 환경 설정
+
+```yaml
+mode: production
+debug: false
+optimization: true
+```

package/core/docs-templates/mkdocs/docs/getting-started/installation.md

@@ -0,0 +1,41 @@
+# 설치
+
+## 사전 요구사항
+
+필요한 의존성 및 환경 설정 목록을 확인하세요.
+
+## 설치 방법
+
+### npm 사용
+
+```bash
+npm install [package-name]
+```
+
+### yarn 사용
+
+```bash
+yarn add [package-name]
+```
+
+### 소스 코드에서 설치
+
+```bash
+git clone https://github.com/username/repo.git
+cd repo
+npm install
+npm run build
+```
+
+## 설치 확인
+
+설치가 제대로 되었는지 확인하세요:
+
+```bash
+[command] --version
+```
+
+## 다음 단계
+
+- [빠른 시작 가이드](quick-start.md)
+- [설정](configuration.md)

package/core/docs-templates/mkdocs/docs/getting-started/quick-start.md

@@ -0,0 +1,56 @@
+# 빠른 시작
+
+몇 분 안에 [프로젝트명]을 시작해보세요.
+
+## 1단계: 설치
+
+아직 설치하지 않았다면 [설치 가이드](installation.md)를 참고하세요.
+
+## 2단계: 기본 설정
+
+[기본 설정 지침을 제공합니다]
+
+```bash
+# 명령어 예시
+[command] init
+```
+
+## 3단계: 첫 번째 프로젝트
+
+[첫 사용을 위한 단계별 튜토리얼]
+
+```bash
+# 사용 예시
+[command] create my-project
+cd my-project
+[command] start
+```
+
+## 4단계: 동작 확인
+
+[설정을 확인하는 방법]
+
+```bash
+[command] test
+```
+
+예상 출력:
+```
+✓ All tests passed
+```
+
+## 다음 단계
+
+- [설정 가이드](configuration.md)
+- [사용자 가이드](../guides/user-guide.md)
+- [API 레퍼런스](../guides/api-reference.md)
+
+## 자주 발생하는 문제
+
+### 문제 1
+**증상:** [설명]
+**해결:** [해결 방법]
+
+### 문제 2
+**증상:** [설명]
+**해결:** [해결 방법]

package/core/docs-templates/mkdocs/docs/guides/api-reference.md

@@ -0,0 +1,83 @@
+# API 레퍼런스
+
+## 개요
+
+[프로젝트명]의 완전한 API 레퍼런스입니다.
+
+## REST API
+
+### 인증
+
+```http
+POST /api/auth/login
+```
+
+**요청:**
+```json
+{
+  "email": "user@example.com",
+  "password": "password"
+}
+```
+
+**응답:**
+```json
+{
+  "token": "eyJhbGc...",
+  "user": {
+    "id": 1,
+    "email": "user@example.com"
+  }
+}
+```
+
+### 엔드포인트
+
+#### GET /api/resource
+
+[설명]
+
+**매개변수:**
+- `param1` (string, 필수): 설명
+- `param2` (number, 선택): 설명
+
+**응답:**
+```json
+{
+  "data": []
+}
+```
+
+## SDK/라이브러리 API
+
+### 클래스: MainClass
+
+```javascript
+const instance = new MainClass(options);
+```
+
+#### 메서드
+
+##### method1(param1, param2)
+
+[설명]
+
+**매개변수:**
+- `param1` (타입): 설명
+- `param2` (타입): 설명
+
+**반환값:** 타입
+
+**예시:**
+```javascript
+const result = instance.method1('value1', 123);
+```
+
+## 에러 코드
+
+| 코드 | 메시지 | 설명 |
+|------|--------|------|
+| 400 | Bad Request | 잘못된 요청 |
+| 401 | Unauthorized | 인증 필요 |
+| 404 | Not Found | 리소스를 찾을 수 없음 |
+| 500 | Internal Server Error | 서버 오류 |

package/core/docs-templates/mkdocs/docs/index.md

@@ -0,0 +1,32 @@
+# [프로젝트명]에 오신 것을 환영합니다
+
+!!! info "문서 정보"
+    이 문서는 ADA (Artifact-Driven Agent) 프레임워크에 의해 자동으로 관리됩니다.
+
+## 개요
+
+[프로젝트 간단 설명 - Documenter 역할이 작성 예정]
+
+## 주요 기능
+
+- 기능 1
+- 기능 2
+- 기능 3
+
+## 빠른 링크
+
+- [설치 가이드](getting-started/installation.md)
+- [빠른 시작](getting-started/quick-start.md)
+- [API 레퍼런스](guides/api-reference.md)
+- [기여 가이드](contributing/contributing.md)
+
+## 도움말
+
+- 📖 [사용자 가이드](guides/user-guide.md)
+- 💡 [자주 묻는 질문](guides/faq.md)
+- 🐛 [이슈 트래커](https://github.com/username/repo/issues)
+- 💬 [토론](https://github.com/username/repo/discussions)
+
+## 라이선스
+
+[라이선스 정보]

package/core/docs-templates/mkdocs/mkdocs.yml

@@ -0,0 +1,86 @@
+site_name: Project Documentation
+site_description: Project documentation powered by ADA
+site_author: Development Team
+
+# Repository
+repo_name: username/repo
+repo_url: https://github.com/username/repo
+
+# Theme
+theme:
+  name: material
+  palette:
+    - scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - navigation.top
+    - search.suggest
+    - search.highlight
+    - content.code.copy
+
+# Navigation
+nav:
+  - Home: index.md
+  - Getting Started:
+      - Installation: getting-started/installation.md
+      - Quick Start: getting-started/quick-start.md
+      - Configuration: getting-started/configuration.md
+  - Guides:
+      - User Guide: guides/user-guide.md
+      - Developer Guide: guides/developer-guide.md
+      - API Reference: guides/api-reference.md
+  - Architecture:
+      - Overview: architecture/overview.md
+      - Design Decisions: architecture/design-decisions.md
+      - Tech Stack: architecture/tech-stack.md
+  - Contributing:
+      - How to Contribute: contributing/contributing.md
+      - Code of Conduct: contributing/code-of-conduct.md
+      - Development Setup: contributing/development.md
+  - Changelog: changelog.md
+
+# Extensions
+markdown_extensions:
+  - admonition
+  - codehilite
+  - footnotes
+  - meta
+  - toc:
+      permalink: true
+  - pymdownx.arithmatex
+  - pymdownx.betterem
+  - pymdownx.caret
+  - pymdownx.critic
+  - pymdownx.details
+  - pymdownx.emoji:
+      emoji_index: !!python/name:materialx.emoji.twemoji
+      emoji_generator: !!python/name:materialx.emoji.to_svg
+  - pymdownx.highlight
+  - pymdownx.inlinehilite
+  - pymdownx.keys
+  - pymdownx.magiclink
+  - pymdownx.mark
+  - pymdownx.smartsymbols
+  - pymdownx.superfences
+  - pymdownx.tabbed
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - pymdownx.tilde
+
+# Plugins
+plugins:
+  - search
+  - minify:
+      minify_html: true

package/core/roles/analyzer.md

@@ -29,7 +29,14 @@
 
 ---
 
-## 4. 분석 절차
+## 4. 참고 규칙 문서
+
+- rules/document-priority.md (문서 우선순위)
+- rules/escalation.md (에스컬레이션 시)
+
+---
+
+## 5. 분석 절차
 
 ### Phase 1: 코드베이스 스캔
 
@@ -52,7 +59,7 @@
 
 ---
 
-## 5. 대화 규칙 (CLI)
+## 6. 대화 규칙 (CLI)
 
 ### 세션 시작 시
 
@@ -92,7 +99,7 @@
 
 ---
 
-## 6. project.md 역생성 형식
+## 7. project.md 역생성 형식
 
 ```markdown
 # [프로젝트명] 기술 기준서
@@ -140,21 +147,36 @@
 
 ---
 
-## 7. 금지 사항 (CRITICAL)
+## 8. 금지 사항 (CRITICAL)
 
 - ❌ **코드 수정/구현 (절대 금지)**
 - ❌ **기존 코드 삭제/변경 (절대 금지)**
 - ❌ **plan.md 작성 (Planner 역할)**
-- ❌ **backlog.md 작성 (Planner 역할)**
+- ❌ **backlog/ Task 파일들 작성 (Planner 역할)**
 - ❌ 분석 없이 가정으로 문서 작성
 - ❌ 사용자 확인 없이 문서 확정 (Frozen)
 
 > ⚠️ **중요**: Analyzer는 오직 분석과 project.md 역생성만 수행합니다.
-> 코드 수정, plan.md, backlog.md 작성은 수행하지 않습니다.
+> 코드 수정, plan.md, backlog/ Task 파일들 작성은 수행하지 않습니다.
+
+---
+
+## 9. 완료 조건 (Definition of Done)
+
+Analyzer 작업 완료 = 다음 조건 충족:
+
+- [ ] 코드베이스 스캔 완료
+- [ ] 기술 스택 정확히 파악됨
+- [ ] project.md 역생성 완료 (Draft 상태)
+- [ ] 사용자 확인 완료
+- [ ] 다음 단계 안내 제공
+
+**참고**: project.md는 Draft 상태로 생성됩니다.
+사용자가 검토 후 수정하고 확정(Frozen)해야 합니다.
 
 ---
 
-## 8. 분석 범위 조절
+## 10. 분석 범위 조절
 
 사용자가 범위를 지정할 수 있음:
 
@@ -166,7 +188,7 @@ Analyzer: 백엔드 코드만 분석하겠습니다.
 
 ---
 
-## 9. 에스컬레이션
+## 11. 에스컬레이션
 
 다음 상황에서 사용자에게 확인:
 
@@ -176,7 +198,7 @@ Analyzer: 백엔드 코드만 분석하겠습니다.
 
 ---
 
-## 10. 다음 단계 안내
+## 12. 다음 단계 안내
 
 분석 완료 후 상황별 안내:
 
@@ -199,7 +221,7 @@ Planner가 plan.md와 backlog.md를 작성합니다."
 
 ---
 
-## 11. 세션 예시
+## 13. 세션 예시
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━