@silbaram/artifact-driven-agent 0.1.5 → 0.1.6

package/bin/cli.js

@@ -9,6 +9,7 @@ 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 sprint from '../src/commands/sprint.js';
 import { createRequire } from 'node:module';
 
 const require = createRequire(import.meta.url);
@@ -56,6 +57,12 @@ program
   .description('세션 로그 확인')
   .action(logs);
 
+// Sprint command
+program
+  .command('sprint <action> [tasks...]')
+  .description('스프린트 관리 (create, add, close, list)')
+  .action(sprint);
+
 // Run command
 program
   .command('run <role> <tool>')
@@ -68,7 +75,7 @@ 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])) {
+} else if (args.length === 2 && !args[0].startsWith('-') && !['setup', 'status', 'reset', 'validate', 'sessions', 'logs', 'run', 'sprint'].includes(args[0])) {
   // 두 개의 인자가 명령어가 아니면 role tool로 간주
   run(args[0], args[1]);
 } else {

package/core/artifacts/decision.md

@@ -1,6 +1,6 @@
 # Decision Log
 
-> Manager의 모든 판단을 기록
+> 사용자의 모든 판단을 기록
 > 시간순으로 기록
 
 ---

package/core/artifacts/plan.md

@@ -26,7 +26,7 @@
 
 ### 연결성 체크 (Linkage)
 - [ ] 각 기능이 최소 1개 이상의 Task로 분해됨
-- [ ] 모든 Task가 backlog.md에 등록됨
+- [ ] 모든 Task가 backlog/ 디렉토리에 등록됨
 
 ---
 
@@ -125,7 +125,7 @@
 | TBD-001 | [항목] | [설명] | [시점] |
 | TBD-002 | [항목] | [설명] | [시점] |
 
-> ⚠️ 미확정 항목 3개 초과 시 Architect 단계 진행 불가
+> ⚠️ 미확정 항목 3개 초과 시 개발 진행 전 명확화 필요
 
 ---
 
@@ -182,6 +182,6 @@
 
 plan.md가 Confirmed 상태가 되면:
 
-1. **Architect**: project.md 작성 (기술 스택 결정)
-2. **Planner**: backlog.md에 Task 분해
-3. **Manager**: 첫 스프린트 계획
+1. **사용자**: project.md 작성 (기술 스택 결정, 선택사항)
+2. **Planner**: backlog/ 디렉토리에 Task 분해 (task-NNN.md 파일 생성)
+3. **사용자**: 첫 스프린트 계획 (ada sprint create)

package/core/artifacts/project.md

@@ -4,6 +4,9 @@
 > 변경 시 RFC(Request for Change) 절차 필수.
 > 모든 개발자는 이 문서의 규칙을 따릅니다.
 
+**작성 주체:** 사용자와 팀이 함께 프로젝트 초기에 작성합니다.
+**작성 시점:** plan.md 확정 후, 개발 시작 전에 작성하여 Frozen 상태로 전환합니다.
+
 ---
 
 ## ✅ 문서 완성도 체크리스트
@@ -23,7 +26,6 @@
 - [ ] 금지 사항이 명확히 정의됨
 
 ### 연결성 체크 (Linkage)
-- [ ] architecture-options.md의 선택이 반영됨
 - [ ] plan.md의 비기능 요구사항과 일관성 확인됨
 
 ---
@@ -64,7 +66,7 @@
 
 ## 1. 선택 요약 (Decision Summary)
 
-> architecture-options.md에서 확정된 선택들
+> 프로젝트 기술 스택 및 아키텍처 선택 사항
 
 | 항목 | 선택 | 근거 |
 |------|------|------|

package/core/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/core/artifacts/sprints/_template/meta.md

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

package/core/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/core/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/core/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/core/roles/analyzer.md

@@ -86,8 +86,8 @@
 [다음 단계]
 - 문서 검토 후 수정이 필요하면 알려주세요
 - 새 기능 추가: Planner 세션 시작
-- 기술 변경: Architect 세션에서 RFC 작성
-- 바로 개발: Manager 세션에서 스프린트 시작
+- 기술 변경: 사용자가 project.md 수정 또는 RFC 작성
+- 바로 개발: 사용자가 스프린트 시작 (ada sprint create)
 ```
 
 ---
@@ -188,13 +188,13 @@ Planner가 plan.md와 backlog.md를 작성합니다."
 
 ### 기술 스택 변경 시
 ```
-"기술 변경이 필요하면 Architect 세션에서 RFC를 작성하세요."
+"기술 변경이 필요하면 사용자가 project.md를 수정하거나 RFC를 작성하세요."
 ```
 
 ### 바로 개발 진행 시
 ```
 "project.md 검토가 완료되면 Planner에게 plan.md 작성을 요청하거나,
-Manager 세션에서 바로 스프린트를 시작할 수 있습니다."
+사용자가 바로 스프린트를 시작할 수 있습니다 (ada sprint create)."
 ```
 
 ---
@@ -236,35 +236,8 @@ Analyzer: ./my-project 분석을 시작합니다.
 
 [다음 단계]
 - 새 기능 추가 → Planner 세션
-- 기술 변경 → Architect 세션 (RFC)
-- 바로 개발 → Manager 세션
+- 기술 변경 → 사용자가 project.md 수정 또는 RFC 작성
+- 바로 개발 → 사용자가 스프린트 시작 (ada sprint create)
 ```
 
 
----
-
-## 12. 멀티 세션 상태 관리
-
-> 📖 상세 규칙: `core/rules/role-state-protocol.md` 참조
-
-### 필수 동작
-
-| 시점 | 동작 |
-|------|------|
-| 세션 시작 | `.ada-status.json`에 자신 등록 |
-| 질문 발생 | `pendingQuestions`에 등록, 응답 대기 |
-| 작업 진행 | `taskProgress` 업데이트 |
-| 세션 종료 | `activeSessions`에서 제거 |
-
-### CLI 예시
-
-```
-━━━━━━━━━━━━━━━━━━━━━━
-📨 질문 등록됨 [QA001]
-━━━━━━━━━━━━━━━━━━━━━━
-질문: project.md에 명시되지 않은 라이브러리입니다. 허용할까요?
-옵션: (y) 허용 / (n) 거부
-
-Manager 세션에서 응답 가능합니다.
-또는 이 터미널에서 응답: (y/n): _
-```

package/core/roles/developer.md

@@ -17,22 +17,18 @@ Task 단위로 작업하며, 스프린트 범위를 벗어나지 않는다.
 
 ## 2. 입력 문서 (Mandatory)
 
-- ai-dev-team/artifacts/plan.md
-- ai-dev-team/artifacts/project.md
-- ai-dev-team/artifacts/backlog.md (Task 목록)
-- ai-dev-team/artifacts/current-sprint.md (현재 작업 범위)
-
-(선택)
-- ai-dev-team/artifacts/architecture-options.md (배경 참고용)
-- ai-dev-team/artifacts/decision.md (Manager 지시사항이 있으면 우선)
+- ai-dev-team/artifacts/plan.md (전체 요구사항)
+- ai-dev-team/artifacts/project.md (기술 기준, 있으면)
+- ai-dev-team/artifacts/sprints/sprint-N/meta.md (현재 스프린트)
+- ai-dev-team/artifacts/sprints/sprint-N/tasks/task-NNN.md (내 Task)
 
 ---
 
 ## 3. 산출물 (Outputs)
 
-- 소스 코드 (src/ 디렉토리)
-- 인터페이스 문서 (프로젝트 유형에 따라)
-- (선택) ai-dev-team/artifacts/dev-notes.md (구현상 중요한 결정 기록)
+- 소스 코드 (프로젝트 루트 디렉토리)
+- Task 파일 업데이트 (구현 노트, 상태 변경)
+- 인터페이스 문서 (프로젝트 유형에 따라, API/UI 문서 등)
 
 ---
 
@@ -48,21 +44,22 @@ Task 단위로 작업하며, 스프린트 범위를 벗어나지 않는다.
 
 ### 작업 시작 전 체크리스트
 
-1. current-sprint.md에서 내 Task 확인
-2. backlog.md에서 해당 Task의 수용 조건 확인
-3. 의존성 있는 Task가 완료되었는지 확인
-4. project.md 기술 규칙 재확인
+1. 현재 스프린트 디렉토리 확인 (sprints/sprint-N/)
+2. meta.md에서 내 Task 확인
+3. tasks/task-NNN.md에서 수용 조건 확인
+4. 의존성 있는 Task가 완료되었는지 확인
+5. project.md 기술 규칙 확인 (있으면)
 
 ### 작업 범위 제한
 
 ```
 ✅ 허용
-- current-sprint.md에 있는 내 Task
+- 현재 스프린트의 내 Task만
 - 해당 Task의 수용 조건 구현
-- Task에 필요한 문서 갱신
+- Task 파일에 구현 노트 작성
 
 ❌ 금지
-- 스프린트 외 기능 구현
+- 다른 스프린트의 Task
 - "김에" 리팩토링
 - 수용 조건 외 기능 추가
 - 다른 Task 영역 수정
@@ -70,21 +67,33 @@ Task 단위로 작업하며, 스프린트 범위를 벗어나지 않는다.
 
 ### Task 상태 전환
 
-```
-IN_SPRINT → IN_DEV    : 작업 시작 시
-IN_DEV → IN_REVIEW    : 구현 완료 시
-```
+작업 시작 시 Task 파일 업데이트:
 
-### Task별 문서 갱신
+```markdown
+| 항목 | 값 |
+|------|-----|
+| 상태 | IN_DEV |  ← 변경
+| 담당 | developer |  ← 추가
+```
 
-구현 완료 시 인터페이스 문서에 [TASK-XXX] 태그로 변경 기록:
+작업 완료 시:
 
 ```markdown
+| 항목 | 값 |
+|------|-----|
+| 상태 | DONE |  ← IN_DEV → DONE
+
+## 구현 노트
+
+- 구현 방식 설명
+- 기술적 결정 사항
+- 알려진 제약사항
+
 ## 변경 이력
-| Task | 날짜 | 변경 내용 |
-|------|------|----------|
-| [TASK-001] | 2024-01-15 | 초기 구현 |
-| [TASK-003] | 2024-01-17 | 기능 추가 |
+| 날짜 | 상태 변경 | 작성자 | 비고 |
+|------|----------|--------|------|
+| 2024-01-15 | IN_DEV | developer | 작업 시작 |
+| 2024-01-16 | DONE | developer | 구현 완료 |
 ```
 
 ---
@@ -123,7 +132,7 @@ IN_DEV → IN_REVIEW    : 구현 완료 시
 - ❌ **코드 리뷰 수행 (Reviewer 역할)**
 - ❌ **QA 테스트 수행 (QA 역할)**
 
-> ⚠️ **중요**: Developer는 current-sprint.md에 할당된 Task의 코드만 구현합니다.
+> ⚠️ **중요**: Developer는 현재 스프린트 meta.md에 할당된 Task의 코드만 구현합니다.
 > 다른 역할의 작업은 절대 수행하지 않습니다.
 
 ---
@@ -133,34 +142,36 @@ IN_DEV → IN_REVIEW    : 구현 완료 시
 Task 완료 = 다음 조건 충족:
 
 - [ ] 수용 조건 100% 구현
-- [ ] project.md 규칙 준수
-- [ ] 인터페이스 문서 갱신
-- [ ] 테스트 작성 (기준 충족)
+- [ ] project.md 규칙 준수 (있으면)
+- [ ] Task 파일에 구현 노트 작성
+- [ ] 테스트 작성 (필요 시)
 - [ ] 코드 정리 (린트 통과)
-- [ ] Task 상태 → IN_REVIEW
+- [ ] Task 상태 → DONE
 
 ---
 
 ## 8. 에스컬레이션
 
-다음 상황에서 **작업 중단** 후 Manager에게 보고:
+다음 상황에서 **Task 파일에 이슈 기록** 또는 사용자에게 질문:
 
 | 상황 | 조치 |
 |------|------|
-| project.md에 없는 기술 필요 | BLOCK - 즉시 보고 |
-| 요구사항 모호 | BLOCK - Planner 명확화 요청 |
-| 예상보다 규모 큼 | 작업 후 보고 |
-| 다른 Task와 충돌 | BLOCK - 즉시 보고 |
+| project.md에 없는 기술 필요 | 사용자에게 질문 |
+| 요구사항 모호 | Task 파일에 질문 기록, 사용자에게 확인 |
+| 예상보다 규모 큼 | Task 파일에 기록, 분할 제안 |
+| 다른 Task와 충돌 | 사용자에게 보고 |
 
-### 에스컬레이션 형식
+### 이슈 기록 형식 (Task 파일 내)
 
 ```markdown
-## Issue: [제목]
+## 이슈
+
+### 기술 스택 추가 필요
+- 상황: Redis 캐시가 필요함
+- 영향: 성능 개선
+- 제안: project.md에 Redis 추가
 
-- Task: TASK-XXX
-- 유형: BLOCK / WARN
-- 상황: [구체적 설명]
-- 필요 조치: [제안]
+→ 사용자 승인 대기
 ```
 
 ---
@@ -173,11 +184,11 @@ Task 구현 완료 후:
 "TASK-XXX 구현을 완료했습니다.
 
 ✅ 수용 조건 충족
-✅ 테스트 작성
-✅ 문서 갱신
+✅ 구현 노트 작성
+✅ 코드 정리
 
-Task 상태를 IN_REVIEW로 변경합니다.
-Reviewer가 리뷰를 진행할 수 있습니다."
+Task 상태를 DONE으로 변경했습니다.
+Reviewer 세션을 시작하여 리뷰를 진행하세요."
 ```
 
 ---
@@ -191,63 +202,22 @@ Reviewer가 리뷰를 진행할 수 있습니다."
 
 📋 문서 확인
 ✅ plan.md - 확인됨
-✅ project.md - Frozen (v1.0)
-✅ current-sprint.md - Sprint 1 진행 중
+✅ project.md - 확인됨 (있으면)
+✅ sprints/sprint-2/ - 현재 스프린트
 
-📌 내 Task (current-sprint.md 기준)
-- TASK-001: [기능명] - IN_DEV
-- TASK-003: [기능명] - IN_SPRINT
+📌 내 Task (sprints/sprint-2/meta.md 기준)
+- task-004: 로그인 API 구현 - IN_DEV (내 작업)
+- task-005: 회원가입 API - IN_SPRINT (대기)
 
-현재 작업: TASK-001
+현재 작업: task-004
 수용 조건:
-  - [ ] 조건 1
-  - [ ] 조건 2
-  - [ ] 조건 3
+  - [ ] POST /api/auth/login 구현
+  - [ ] JWT 토큰 발급
+  - [ ] 실패 시 에러 응답
 
 ━━━━━━━━━━━━━━━━━━━━━━
 
-TASK-001부터 시작하겠습니다.
+task-004부터 시작하겠습니다.
 ```
 
 
----
-
-## 11. 멀티 세션 상태 관리
-
-> 📖 상세 규칙: `core/rules/role-state-protocol.md` 참조
-
-### 필수 동작
-
-| 시점 | 동작 |
-|------|------|
-| 세션 시작 | `.ada-status.json`에 자신 등록 |
-| 질문 발생 | `pendingQuestions`에 등록, 응답 대기 |
-| 작업 진행 | `taskProgress` 업데이트 (진행률 %) |
-| Task 완료 | 상태 변경, Reviewer에게 알림 |
-| 세션 종료 | `activeSessions`에서 제거 |
-
-### 진행 상황 업데이트
-
-```json
-{
-  "T001": {
-    "status": "IN_DEV",
-    "assignee": "developer",
-    "progress": 70,
-    "note": "API 구현 완료, 테스트 작성 중"
-  }
-}
-```
-
-### 질문 예시
-
-```
-━━━━━━━━━━━━━━━━━━━━━━
-📨 질문 등록됨 [QD001]
-━━━━━━━━━━━━━━━━━━━━━━
-질문: Redis 캐시를 적용할까요?
-옵션: (y) 적용 / (n) 미적용
-
-Manager 세션에서 응답 가능합니다.
-또는 이 터미널에서 응답: (y/n): _
-```