@silbaram/artifact-driven-agent 0.1.0

package/bin/cli.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import { setup } from '../src/commands/setup.js';
+import { status } from '../src/commands/status.js';
+import { reset } from '../src/commands/reset.js';
+import { validate } from '../src/commands/validate.js';
+import { sessions } from '../src/commands/sessions.js';
+import { logs } from '../src/commands/logs.js';
+import { run } from '../src/commands/run.js';
+import { interactive } from '../src/commands/interactive.js';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+program
+  .name('ada')
+  .description('Artifact-Driven AI Agent Framework\nAI가 규칙을 어기지 못하게 하는 문서 기반 개발')
+  .version(version);
+
+// Setup command
+program
+  .command('setup [template]')
+  .description('프로젝트 템플릿 세팅 (web, library, game, cli)')
+  .action(setup);
+
+// Status command
+program
+  .command('status')
+  .description('현재 세팅 상태 확인')
+  .action(status);
+
+// Reset command
+program
+  .command('reset')
+  .description('ai-dev-team 초기화')
+  .option('-f, --force', '확인 없이 강제 초기화')
+  .action(reset);
+
+// Validate command
+program
+  .command('validate [doc]')
+  .description('문서 검증 (plan, project, backlog, sprint 또는 전체)')
+  .action(validate);
+
+// Sessions command
+program
+  .command('sessions')
+  .description('AI 실행 세션 목록')
+  .action(sessions);
+
+// Logs command
+program
+  .command('logs [sessionId]')
+  .description('세션 로그 확인')
+  .action(logs);
+
+// Run command
+program
+  .command('run <role> <tool>')
+  .description('AI 에이전트 실행 (예: run backend claude)')
+  .action(run);
+
+// Parse arguments
+const args = process.argv.slice(2);
+
+if (args.length === 0) {
+  // 인자 없으면 대화형 모드
+  interactive();
+} else if (args.length === 2 && !args[0].startsWith('-') && !['setup', 'status', 'reset', 'validate', 'sessions', 'logs', 'run'].includes(args[0])) {
+  // 두 개의 인자가 명령어가 아니면 role tool로 간주
+  run(args[0], args[1]);
+} else {
+  program.parse();
+}

package/core/artifacts/architecture-options.md

@@ -0,0 +1,85 @@
+# Architecture Options
+
+> 아키텍처 협상 과정 기록
+> Architect와 사용자 간 논의 내용
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 상태 | 협의 중 / 확정 |
+| 최종 수정 | YYYY-MM-DD |
+
+---
+
+## 1. 결정 상태
+
+| 항목 | 상태 | 선택 |
+|------|:----:|------|
+| 규모 | ✅ | M (Medium) |
+| 언어 | ✅ | [선택] |
+| 프레임워크 | ⏳ | - |
+| 데이터 저장 | ❌ | - |
+
+상태: ✅ 확정 / ⏳ 협의 중 / ❌ 미정
+
+---
+
+## 2. 규모 분석
+
+### 분석 결과
+
+| 항목 | 값 |
+|------|-----|
+| 핵심 기능 수 | N개 |
+| 예상 복잡도 | 낮음 / 중간 / 높음 |
+| 권장 규모 | S / M / L |
+
+### 규모 근거
+
+[규모 판단 근거 설명]
+
+---
+
+## 3. 옵션 제안
+
+### [항목명] 옵션
+
+| 옵션 | 장점 | 단점 |
+|------|------|------|
+| A: [선택지] | [장점] | [단점] |
+| B: [선택지] | [장점] | [단점] |
+| C: [선택지] | [장점] | [단점] |
+
+### Architect 권장
+
+옵션 [X] 권장
+
+이유: [권장 이유]
+
+---
+
+## 4. 사용자 선택 기록
+
+| 날짜 | 항목 | 선택 | 이유 |
+|------|------|------|------|
+| YYYY-MM-DD | 규모 | M | 기능 수 기준 |
+| YYYY-MM-DD | 언어 | [선택] | [이유] |
+
+---
+
+## 5. 미결정 항목
+
+| 항목 | 옵션 | 결정 예정 |
+|------|------|----------|
+| [항목] | A / B / C | [시점] |
+
+---
+
+## 6. 확정 시 다음 단계
+
+모든 항목 확정 후:
+1. project.md 생성 (Frozen)
+2. 스프린트 계획 시작

package/core/artifacts/backlog.md

@@ -0,0 +1,177 @@
+# Backlog (Task 목록)
+
+> 모든 Task의 단일 진실 (Single Source of Truth)
+> Planner가 생성, Manager가 상태 관리
+
+---
+
+## ✅ Task 완성도 체크리스트
+
+> ⚠️ Task가 READY 상태가 되려면 모든 항목 충족 필요
+
+### 필수 항목 (Required)
+- [ ] Task ID 부여됨 (TASK-NNN)
+- [ ] 출처(기능 ID)가 plan.md에 존재함
+- [ ] 수용 조건 최소 1개 이상
+- [ ] 크기(S/M/L) 결정됨
+- [ ] 우선순위(P0/P1/P2) 결정됨
+
+### 품질 체크 (Quality)
+- [ ] 수용 조건이 테스트 가능함
+- [ ] 의존성이 명시됨 (없으면 "-")
+- [ ] Task 설명이 구체적임 (모호한 표현 없음)
+- [ ] L 크기 Task가 분해 검토됨
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 총 Task 수 | N개 |
+| READY | N개 |
+| IN_SPRINT | N개 |
+| DONE | N개 |
+| 최종 갱신 | YYYY-MM-DD |
+
+---
+
+## 1. Task 상태 정의
+
+| 상태 | 설명 | 다음 상태 |
+|------|------|----------|
+| BACKLOG | 정의됨, 상세화 필요 | READY |
+| READY | 스프린트 투입 가능 | IN_SPRINT |
+| IN_SPRINT | 현재 스프린트에 포함 | IN_DEV |
+| IN_DEV | 개발 중 | IN_REVIEW |
+| IN_REVIEW | 리뷰 중 | IN_QA, IN_DEV |
+| IN_QA | QA 검증 중 | DONE, IN_DEV |
+| DONE | 완료 | - |
+| BLOCKED | 차단됨 | (해결 후 원래 상태) |
+| DEFERRED | 보류/이월 | BACKLOG |
+
+---
+
+## 2. Task 목록
+
+### TASK-001: [Task 이름]
+
+| 항목 | 값 |
+|------|-----|
+| 상태 | BACKLOG |
+| 우선순위 | P0 / P1 / P2 |
+| 크기 | S / M / L |
+| 출처 | F001 (plan.md 기능 ID) |
+| 담당 | - |
+| 의존성 | - |
+
+**수용 조건 (Acceptance Criteria):**
+- [ ] 조건 1
+- [ ] 조건 2
+- [ ] 조건 3
+
+---
+
+### TASK-002: [Task 이름]
+
+| 항목 | 값 |
+|------|-----|
+| 상태 | BACKLOG |
+| 우선순위 | P1 |
+| 크기 | M |
+| 출처 | F001 |
+| 담당 | - |
+| 의존성 | TASK-001 |
+
+**수용 조건:**
+- [ ] 조건 1
+- [ ] 조건 2
+
+---
+
+### TASK-003: [Task 이름]
+
+| 항목 | 값 |
+|------|-----|
+| 상태 | BACKLOG |
+| 우선순위 | P1 |
+| 크기 | S |
+| 출처 | F002 |
+| 담당 | - |
+| 의존성 | - |
+
+**수용 조건:**
+- [ ] 조건 1
+- [ ] 조건 2
+
+---
+
+## 3. 완료된 Task (Archive)
+
+> DONE 상태 Task는 여기로 이동
+
+### ~~TASK-000: [Task 이름]~~ ✅
+
+| 항목 | 값 |
+|------|-----|
+| 상태 | DONE |
+| 완료일 | YYYY-MM-DD |
+| 스프린트 | Sprint 1 |
+
+---
+
+## 4. Task 작성 규칙
+
+### 4.1 Task 분해 원칙
+
+- 기능 1개 = Task 1개 이상
+- Task는 독립적으로 완료 가능해야 함
+- 의존성이 있으면 명시
+
+### 4.2 크기 기준
+
+| 크기 | 설명 | 예상 시간 |
+|:----:|------|----------|
+| S | 단순 구현 | 1-2시간 |
+| M | 일반 기능 | 반나절 |
+| L | 복합 기능 | 1일+ |
+
+### 4.3 수용 조건 규칙
+
+- 검증 가능해야 함 (테스트 가능)
+- 구체적이어야 함 (모호함 금지)
+- 완료 기준이 명확해야 함
+
+---
+
+## 5. 상태 전환 규칙
+
+### 5.1 전환 권한
+
+| 전환 | 권한 |
+|------|------|
+| BACKLOG → READY | Planner |
+| READY → IN_SPRINT | Manager |
+| IN_SPRINT → IN_DEV | Developer |
+| IN_DEV → IN_REVIEW | Developer |
+| IN_REVIEW → IN_QA | Reviewer (PASS 시) |
+| IN_REVIEW → IN_DEV | Reviewer (REJECT 시) |
+| IN_QA → DONE | Manager (PASS 후 승인) |
+| IN_QA → IN_DEV | QA (FAIL 시) |
+| * → BLOCKED | 누구나 (사유 명시) |
+| * → DEFERRED | Manager |
+
+### 5.2 역전환 규칙
+
+- REJECT/FAIL 시에만 역전환 가능
+- 역전환 시 사유 필수 기록
+
+---
+
+## 6. 변경 이력
+
+| 날짜 | Task ID | 변경 내용 | 작성자 |
+|------|---------|----------|--------|
+| YYYY-MM-DD | TASK-001 | 생성 | Planner |
+| YYYY-MM-DD | TASK-001 | BACKLOG → READY | Planner |
+| YYYY-MM-DD | TASK-001 | READY → IN_SPRINT | Manager |

package/core/artifacts/current-sprint.md

@@ -0,0 +1,125 @@
+# Current Sprint
+
+> 현재 진행 중인 스프린트의 작업 범위
+> Manager가 관리
+
+---
+
+## 0. 스프린트 메타
+
+| 항목 | 값 |
+|------|-----|
+| 스프린트 | Sprint N |
+| 시작일 | YYYY-MM-DD |
+| 종료 예정 | YYYY-MM-DD |
+| 상태 | 계획 / 진행 / 완료 |
+
+---
+
+## 1. 스프린트 목표
+
+> 이번 스프린트에서 달성하고자 하는 것
+
+- [목표 1]
+- [목표 2]
+
+---
+
+## 2. 스프린트 Task 목록
+
+| Task | 상태 | 담당 | 우선순위 | 크기 |
+|------|:----:|------|:--------:|:----:|
+| TASK-001 | IN_DEV | Developer | P0 | M |
+| TASK-002 | IN_SPRINT | - | P1 | S |
+| TASK-003 | IN_REVIEW | Developer | P1 | M |
+
+### 상태 요약
+
+| 상태 | 개수 |
+|------|:----:|
+| IN_SPRINT | N |
+| IN_DEV | N |
+| IN_REVIEW | N |
+| IN_QA | N |
+| DONE | N |
+| **총합** | **N** |
+
+---
+
+## 3. 역할별 현재 작업
+
+### Developer
+
+| Task | 상태 | 비고 |
+|------|------|------|
+| TASK-001 | IN_DEV | 진행 중 |
+
+### Reviewer
+
+| Task | 상태 | 비고 |
+|------|------|------|
+| TASK-003 | IN_REVIEW | 리뷰 대기 |
+
+### QA
+
+| Task | 상태 | 비고 |
+|------|------|------|
+| - | - | 대기 중 |
+
+---
+
+## 4. 차단 사항 (Blockers)
+
+> 현재 진행을 막는 이슈
+
+| Task | 차단 사유 | 담당자 | 상태 |
+|------|----------|--------|------|
+| - | - | - | - |
+
+---
+
+## 5. 스프린트 중 변경 사항
+
+> 스프린트 시작 후 발생한 변경
+
+| 날짜 | 변경 내용 | 사유 | 승인 |
+|------|----------|------|------|
+| - | - | - | - |
+
+---
+
+## 6. 스프린트 회고 (완료 시)
+
+> 스프린트 종료 후 Manager가 작성
+
+### 완료된 Task
+
+| Task | 설명 |
+|------|------|
+| TASK-XXX | [설명] |
+
+### 미완료 Task
+
+| Task | 사유 | 처리 |
+|------|------|------|
+| TASK-XXX | [사유] | 이월 / 취소 |
+
+### 잘된 점
+
+- [내용]
+
+### 개선할 점
+
+- [내용]
+
+### 다음 스프린트 제안
+
+- [제안]
+
+---
+
+## 7. 스프린트 히스토리
+
+| 스프린트 | 기간 | 목표 | 완료 Task | 결과 |
+|----------|------|------|:---------:|:----:|
+| Sprint 1 | MM/DD ~ MM/DD | [목표] | N개 | ✅ / ⚠️ |

package/core/artifacts/decision.md

@@ -0,0 +1,72 @@
+# Decision Log
+
+> Manager의 모든 판단을 기록
+> 시간순으로 기록
+
+---
+
+## 현재 상태
+
+| 항목 | 값 |
+|------|-----|
+| 현재 단계 | 기획 / 아키텍처 / 개발 / 완료 |
+| 스프린트 | 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/core/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.md에 등록됨
+
+---
+
+## 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개 초과 시 Architect 단계 진행 불가
+
+---
+
+## 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. **Architect**: project.md 작성 (기술 스택 결정)
+2. **Planner**: backlog.md에 Task 분해
+3. **Manager**: 첫 스프린트 계획