@silbaram/artifact-driven-agent

v0.2.3

Published

2 months ago

CLI 기반 멀티 AI 에이전트 개발 프레임워크 - AI가 규칙을 어기지 못하게 하는 문서 기반 개발

0High
0Medium
0Low

silbaram

ai agent cli development framework artifact multi-agent claude codex automation

Artifact-Driven AI Agent Framework

문서 기반 멀티 AI 에이전트 개발 프레임워크

5개 핵심 역할(Planner, Improver, Developer, Reviewer, Documenter)이 스프린트 단위로 협업하여 안정적인 개발 워크플로우를 만듭니다.

🎯 목표

AI가 감으로 개발하지 못하게 한다
모든 판단을 문서 기준으로 고정한다
스프린트/Task 단위 반복 개발 파이프라인을 만든다

💡 핵심 개념

이 구조는 AI가 똑똑해서 돌아가는 시스템이 아니다. AI가 규칙을 어기지 못해서 안정적으로 돌아간다.

문서 기반 제약 구현

AI 에이전트 실행 시, 시스템 프롬프트에 다음을 포함합니다:

역할 정의 - 역할의 책임과 권한
모든 규칙 파일 내용 (rules/*.md)
전문 스킬 (skills/*.md) - 역할에 지정된 기술 스택 가이드
핵심 산출물 내용 (plan.md, project.md, 현재 스프린트 Task 파일)
인터페이스 문서 내용 (api.md, ui.md 등)

이를 통해 AI는:

문서에 명시된 규칙을 따라야만 함
현재 스프린트 범위를 벗어날 수 없음
project.md에 없는 기술을 추가할 수 없음
프로젝트의 코딩 패턴과 스타일을 자동으로 준수

파일명만 나열하지 않고, 내용을 포함하는 것이 핵심입니다.

🚀 설치

npm 설치 (권장)

# 전역 설치
npm install -g @silbaram/artifact-driven-agent

# 또는 npx로 바로 실행
npx @silbaram/artifact-driven-agent setup web

저장소 클론 (개발자용)

git clone https://github.com/silbaram/artifact-driven-agent.git
cd artifact-driven-agent
npm install        # 의존성 설치
npm run build      # TypeScript 컴파일
npm link           # 전역 명령어 등록

설치 확인

ada --version
ada --help

업그레이드

npm 패키지를 업데이트한 후, 기존 작업공간도 최신 버전으로 업그레이드해야 합니다.

# npm 패키지 업데이트
npm install -g @silbaram/artifact-driven-agent@latest

# 작업공간 상태 확인 (버전 불일치 경고 표시)
ada status

# 변경 사항 미리보기
ada upgrade --dry-run

# 안전 업그레이드 (백업 + 확인)
ada upgrade

# 강제 업그레이드 (확인 없이)
ada upgrade --force

# 문제 발생 시 롤백
ada upgrade --rollback

업그레이드 동작:

✅ roles/, rules/ 디렉토리 업데이트 (프레임워크 파일)
✅ 자동 백업 생성 (.backups/upgrade-YYYYMMDD-HHMMSS/)
✅ 사용자 데이터 보존 (backlog/, sprints/, decision.md, project.md, plan.md)
✅ 버전 추적 (.ada-version 파일)

🖥️ 빠른 시작

1. 프로젝트 세팅

ada setup web       # 웹 서비스
ada setup lib       # 라이브러리
ada setup game      # 게임
ada setup cli       # CLI 도구

2. 기획 시작

ada planner claude  # 요구사항 수집 → plan.md + backlog/*.md 생성

3. 스프린트 생성

ada sprint create                # 새 스프린트 생성
ada sprint add task-001 task-002 # Task 추가

4. 개발

ada developer claude  # Task 구현 → DONE 상태로 변경

5. 리뷰

ada reviewer claude   # 코드 리뷰 → review-reports/ 생성

6. 스프린트 종료 및 문서화

# 스프린트 종료 및 정리
ada sprint close              # 작업 파일을 archive/ 폴더로 이동 (권장)
ada sprint close --clean      # 작업 파일 완전 삭제 (최종 문서만 유지)
ada sprint close --keep-all   # 모든 파일 유지

# 문서 작성
ada documenter claude         # Release Notes, API Changelog 등 생성

7. (선택) 프로젝트 문서 관리

# 문서 사이트 초기화 (최초 1회)
ada docs init

# 문서 생성/업데이트
ada documenter claude         # Documenter가 docs/ 업데이트

# 로컬 미리보기
ada docs serve

# GitHub Pages 배포 (MkDocs 자동 배포 지원)
ada docs publish

종료 후 구조 (기본):

sprints/sprint-N/
├── meta.md                    # 스프린트 정보
├── docs/                      # 최종 문서 ✅
└── archive/                   # 작업 과정 보관
    ├── tasks/
    └── review-reports/

👥 역할 시스템

핵심 역할 (5개) - 모든 프로젝트 필수

| 역할 | 책임 | 산출물 | |------|------|--------| | Planner | 신규 기능 요구사항 수집, Task 분해 | plan.md, backlog/.md | | Improver | 기존 기능 개선 분석 및 기획 | improvement-reports/.md, backlog/.md | | Developer | 코드 구현, Task 완료 | 소스 코드, Task 파일 업데이트 | | Reviewer | 코드 리뷰, 품질 판정 | review-reports/.md | | Documenter | 스프린트 완료 시 문서 작성 | API Changelog, Release Notes, User Guide |

선택 역할 (1개) - 기존 프로젝트 도입 시

| 역할 | 책임 | 사용 시점 | |------|------|----------| | Analyzer | 기존 코드베이스 분석, project.md 역생성 | 레거시 프로젝트에 ada 도입 시 |

📂 디렉토리 구조

프로젝트 루트

artifact-driven-agent/
├── bin/
│   └── cli.ts              # CLI 진입점 (TypeScript)
├── src/
│   ├── commands/           # 명령어 구현 (TypeScript)
│   │   ├── setup.ts
│   │   ├── run.ts
│   │   ├── sprint.ts       # 스프린트 관리
│   │   ├── sessions.ts     # 세션 모니터링
│   │   └── config.ts       # 설정 관리
│   ├── utils/
│   │   ├── files.ts
│   │   ├── config.ts       # 설정 유틸리티
│   │   └── sessionState.ts
│   ├── ui/
│   │   ├── dashboard.ts    # 대시보드
│   │   └── keyHandler.ts
│   └── types/              # TypeScript 타입 정의
│       ├── common.ts
│       ├── session.ts
│       ├── config.ts
│       ├── task.ts
│       └── index.ts
├── dist/                   # 빌드 출력 (.js 파일)
├── tsconfig.json           # TypeScript 설정
├── core/                   # 범용 핵심
│   ├── roles/              # 6개 역할
│   ├── artifacts/          # 산출물 템플릿
│   │   └── sprints/
│   │       └── _template/  # 스프린트 템플릿
│   ├── rules/              # 5개 규칙
│   └── skills/             # 🆕 스킬 템플릿
│       └── _template/
└── templates/              # 프로젝트 유형별
    ├── web-dev/
    ├── library/
    ├── game/
    └── cli/

작업 디렉토리 (setup 후)

ai-dev-team/
├── artifacts/
│   ├── plan.md             # 전체 요구사항
│   ├── project.md          # 기술 기준 (선택)
│   ├── backlog/            # 스프린트 미할당 Task
│   │   ├── task-001.md
│   │   └── task-002.md
│   └── sprints/            # 스프린트별 디렉토리
│       ├── sprint-1/       # 완료된 스프린트
│       │   ├── meta.md
│       │   ├── tasks/
│       │   │   ├── task-003.md
│       │   │   └── task-004.md
│       │   ├── review-reports/
│       │   │   ├── task-003.md
│       │   │   └── task-004.md
│       │   ├── docs/
│       │   │   ├── api-changelog.md
│       │   │   └── release-notes.md
│       │   └── retrospective.md
│       └── sprint-2/       # 진행 중인 스프린트
│           ├── meta.md
│           └── tasks/
│               └── task-005.md
├── roles/                  # core + template 병합
├── rules/
├── skills/                 # 🆕 역할별 전문 스킬
│   ├── _template/
│   │   └── SKILL.md
│   ├── spring-boot/
│   │   └── SKILL.md
│   └── kotlin/
│       └── SKILL.md
├── ada.config.json         # 역할별 AI 도구 + 스킬 설정
├── .ada-status.json        # 멀티 세션 상태 파일
└── .sessions/              # 세션 이력
    └── logs/

🖥️ CLI 명령어

기본 명령어

| 명령어 | 설명 | |--------|------| | ada | 대화형 모드 | | ada setup [template] | 템플릿 세팅 (web, lib, game, cli) | | ada status | 상태 확인 (버전 체크 포함) | | ada config | 설정 변경 (대화형) | | ada config show | 현재 설정 보기 | | ada config list | 현재 설정 보기 (show와 동일) | | ada config get <key> | 설정 값 조회 | | ada config set <key> <value> | 설정 값 변경 | | ada upgrade | 작업공간을 최신 버전으로 업그레이드 | | ada upgrade --dry-run | 변경 사항 미리보기 | | ada upgrade --rollback | 이전 백업으로 롤백 | | ada validate [doc] | 문서 검증 | | ada reset [-f] | 초기화 |

스프린트 관리

| 명령어 | 설명 | |--------|------| | ada sprint create | 새 스프린트 생성 | | ada sprint add task-001 ... | Task 추가 | | ada sprint sync | meta.md 상태 동기화 (Task 파일 반영) | | ada sprint close | 스프린트 종료 (작업 파일 archive/) | | ada sprint close --auto | 스프린트 자동 종료 (회고 기본값) | | ada sprint close --clean | 스프린트 종료 (작업 파일 삭제) | | ada sprint close --keep-all | 스프린트 종료 (파일 유지) | | ada sprint list | 스프린트 목록 |

AI 에이전트 실행

# 정식 형식
ada run <role> <tool>

# 단축 형식 (run 생략)
ada <role> <tool>

# 예시
ada planner claude      # 신규 기능 기획
ada improver claude     # 기존 기능 개선 기획
ada developer codex
ada reviewer gemini
ada documenter claude

tool을 생략하면 ada.config.json 기본값을 사용합니다.

지원 도구: claude, codex, gemini, copilot

세션 모니터링

# 세션 목록 및 상태
ada sessions

# 실시간 모니터링 대시보드
ada sessions --watch
ada sessions -w

# 세션 로그 확인
ada logs
ada logs [session-id]

문서 관리

# 문서 구조 초기화 (MkDocs/Jekyll)
ada docs init
ada docs init -g mkdocs    # MkDocs 템플릿
ada docs init -g jekyll    # Jekyll 템플릿

# 문서 생성 (Documenter 역할 실행 안내)
ada docs generate

# 로컬 문서 서버 실행
ada docs serve

# GitHub Pages 배포 (MkDocs 자동 배포 지원)
ada docs publish

참고: 실제 문서 내용 생성은 Documenter 역할로 수행합니다:

ada documenter claude

스킬 관리

스킬은 AI 도구의 네이티브 스킬 시스템을 통해 적용됩니다.

| 도구 | 스킬 탐색 경로 | |------|---------------| | Claude Code | .claude/skills/ | | Gemini CLI | .gemini/skills/ | | Codex | .agents/skills/ |

# 스킬 목록 (ada 저장소)
ada skills list

# 스킬 상세 정보
ada skills info spring-boot

# 스킬 적용 (네이티브 경로에 복사)
ada skills apply spring-boot           # 모든 도구에 적용
ada skills apply spring-boot claude    # 특정 도구에만 적용

# 스킬 제거
ada skills remove spring-boot          # 모든 도구에서 제거
ada skills remove spring-boot gemini   # 특정 도구에서만 제거

# 적용 상태 확인
ada skills status

# 대화형 적용/삭제 UI
ada skills ui

스킬 추가 방법: 커뮤니티나 GitHub에서 스킬을 다운로드하여 ai-dev-team/skills/ 디렉토리에 추가합니다.

# 예시: GitHub에서 스킬 다운로드
cd ai-dev-team/skills/
git clone https://github.com/awesome-ada/spring-boot-skill.git spring-boot

# 또는 직접 복사
cp -r /path/to/spring-boot ai-dev-team/skills/

# 확인 및 적용
ada skills list
ada skills apply spring-boot

🔄 워크플로우

신규 프로젝트

1. Planner: 요구사항 수집
   → plan.md + backlog/*.md 생성

2. 사용자: 스프린트 생성
   → ada sprint create
   → ada sprint add task-001 task-002

3. Developer: Task 구현
   → 코드 작성
   → Task 상태를 DONE으로 변경

4. Reviewer: 코드 리뷰
   → review-reports/*.md 생성
   → PASS/REJECT 판정

5. 사용자: 스프린트 종료
   → ada sprint close

6. Documenter: 문서 작성
   → ada documenter claude
   → sprints/sprint-N/docs/*.md 생성 (Release Notes, API Changelog 등)
   → (선택) 프로젝트 docs/ 업데이트 (문서 사이트용)

7. (선택) 문서 사이트 배포
   → ada docs serve (로컬 미리보기)
   → ada docs publish (GitHub Pages 배포)

8. 다음 스프린트 시작
   → ada sprint create

기존 프로젝트

0. Analyzer: 코드베이스 분석
   → project.md 역생성

1. [분기점]

   A) 신규 기능 추가 시:
      Planner: 추가 기능 기획
      → plan.md 업데이트
      → backlog/*.md 생성

   B) 기존 기능 개선 시:
      Improver: 개선 분석 및 기획
      → improvement-reports/IMP-NNN.md 생성
      → backlog/*.md 생성

2. 사용자: 스프린트 생성
   → ada sprint create
   → ada sprint add task-001 task-002

3. 이후 신규 프로젝트와 동일 (Developer → Reviewer → Documenter)

Task 상태 흐름

BACKLOG → IN_DEV → DONE → (리뷰 후) → 스프린트 완료

📋 규칙 시스템

Core 규칙 (5개)

| 규칙 | 용도 | |------|------| | iteration.md | 스프린트/Task 단위 작업 규칙 | | escalation.md | 에스컬레이션 기준 | | rollback.md | REJECT 시 처리 절차 | | document-priority.md | 문서 충돌 시 우선순위 | | rfc.md | Frozen 문서 변경 절차 |

템플릿별 규칙

| 템플릿 | 규칙 | 용도 | |--------|------|------| | web-dev | api-change.md | API 변경 절차 | | library | versioning.md | Semantic Versioning | | game | system-change.md | 게임 시스템 변경 | | cli | command-change.md | CLI 명령어 변경 |

📄 산출물

Core 산출물

| 문서 | 관리자 | 용도 | |------|--------|------| | plan.md | Planner | 전체 요구사항 | | project.md | 사용자/팀 (선택) | 기술 기준 (Frozen) | | backlog/.md | Planner | 스프린트 미할당 Task | | sprints/sprint-N/meta.md | 자동 생성 | 스프린트 메타정보 | | sprints/sprint-N/tasks/.md | Developer | Task별 상세 정보 | | sprints/sprint-N/review-reports/.md | Reviewer | 리뷰 결과 | | sprints/sprint-N/docs/.md | Documenter | 릴리스 문서 | | sprints/sprint-N/retrospective.md | 사용자 | 회고 |

템플릿별 산출물

| 템플릿 | 문서 | 용도 | |--------|------|------| | web-dev | api.md, ui.md | API 계약, 화면 설계 | | library | public-api.md, changelog.md | 공개 API, 변경 이력 | | game | game-systems.md, assets.md | 시스템, 에셋 | | cli | commands.md, output-format.md | 명령어, 출력 형식 |

🖥️ 멀티 세션 모드

여러 터미널에서 동시에 다른 역할을 실행할 수 있습니다.

사용 예시

# 터미널 1: Planner
ada planner claude

# 터미널 2: Developer
ada developer codex

# 터미널 3: Reviewer
ada reviewer gemini

# 터미널 4: 실시간 모니터링
ada sessions --watch

자동 세션 관리

세션 시작 시:

.ada-status.json에 자동 등록
터미널 타이틀 설정 (예: "ADA: developer (codex)")
역할 이모지 배너 표시

세션 종료 시:

상태 파일에서 자동 제거
세션 로그 저장

상태 파일

ai-dev-team/.ada-status.json

모든 세션이 이 파일을 통해 상태를 공유합니다.

구성:

activeSessions[]: 실행 중인 세션
pendingQuestions[]: 대기 질문
taskProgress{}: Task 진행 상태
notifications[]: 세션 간 알림
locks{}: 파일 잠금 상태

⚙️ 설정 관리

역할별로 사용할 AI 도구를 설정할 수 있습니다.

설정 파일

ai-dev-team/ada.config.json

{
  "version": "1.0",
  "defaults": {
    "tool": "claude"
  },
  "roles": {
    "manager": "claude",
    "planner": "claude",
    "developer": "gemini",
    "reviewer": "claude",
    "documenter": "claude"
  }
}

대화형 설정

ada config

메뉴:

📋 현재 설정 보기
🔧 역할별 도구 설정
⚡ 기본 도구 변경
🎯 빠른 설정 (프리셋)

프리셋

| 프리셋 | 설명 | |--------|------| | All Claude | 모든 역할에 Claude 사용 | | All Gemini | 모든 역할에 Gemini 사용 | | Mixed Optimal | 역할별 최적 조합 | | Dev Gemini + Review Claude | 개발은 Gemini, 리뷰는 Claude |

명령어 모드

# 개별 역할 설정
ada config set roles.developer gemini
ada config set roles.reviewer claude

# 기본 도구 변경
ada config set defaults.tool gemini

# 설정 확인
ada config show       # 또는 ada config list

# 특정 값 조회
ada config get roles.manager

설정을 초기화하려면 ai-dev-team/ada.config.json 삭제 후 ada config를 실행하세요.

🎓 스킬 시스템

역할별로 기술 스택, 패턴, 코딩 스타일 등의 전문 지식을 스킬로 정의하여 AI에게 자동으로 제공할 수 있습니다.

개념

**스킬(Skill)**은 특정 기술이나 패턴에 대한 가이드를 담은 마크다운 문서입니다.

역할별로 필요한 스킬을 지정하면, AI 실행 시 자동으로 로드됩니다.
프로젝트별 기술 스택 표준화 및 코딩 패턴 통일에 유용합니다.

스킬 구조

ai-dev-team/skills/
├── _template/              # 템플릿
│   └── SKILL.md
├── spring-boot/            # 사용자 생성 스킬
│   ├── SKILL.md           # 메인 파일 (필수)
│   ├── examples/          # 예시 코드 (선택)
│   └── references/        # 참조 문서 (선택)
└── kotlin/
    └── SKILL.md

SKILL.md 예시:

---
name: spring-boot
description: Spring Boot 백엔드 개발 시 Kotlin, REST API, JPA 패턴 적용
---

# Spring Boot + Kotlin 백엔드 개발

## Controller 패턴
- `@RestController` + `@RequestMapping` 사용
- 경로는 복수형 명사 (`/api/users`)

## Service 계층
- `@Service` + `@Transactional` 조합

## Repository
- Spring Data JPA 사용

사용 방법

1. 스킬 다운로드 또는 생성:

커뮤니티에서 검증된 스킬을 다운로드하거나, 직접 생성합니다.

# 방법 1: 커뮤니티에서 다운로드 (권장)
cd ai-dev-team/skills/
git clone https://github.com/awesome-ada/spring-boot-skill.git spring-boot
git clone https://github.com/awesome-ada/kotlin-skill.git kotlin

# 방법 2: 직접 생성
mkdir -p ai-dev-team/skills/spring-boot
touch ai-dev-team/skills/spring-boot/SKILL.md
code ai-dev-team/skills/spring-boot/SKILL.md

2. 스킬 확인:

ada skills list

3. 스킬 적용 (네이티브 경로에 복사):

# 모든 도구에 적용
ada skills apply spring-boot kotlin

# 또는 특정 도구에만 적용
ada skills apply spring-boot claude

# 적용 상태 확인
ada skills status

4. AI 실행:

ada developer claude

# → Claude가 .claude/skills/에서 스킬을 자동으로 로드
# → 해당 패턴에 맞춰 코드 생성!

네이티브 스킬 경로

각 AI 도구는 자체 스킬 탐색 경로에서 스킬을 자동으로 인식합니다:

| 도구 | 스킬 탐색 경로 | |------|---------------| | Claude Code | .claude/skills/ | | Gemini CLI | .gemini/skills/ | | Codex | .agents/skills/ |

ada skills apply 명령은 ada 스킬 저장소의 스킬을 이 네이티브 경로로 복사합니다.

ai-dev-team/skills/spring-boot/    →    .claude/skills/spring-boot/
                                   →    .gemini/skills/spring-boot/
                                   →    .agents/skills/spring-boot/

작동 원리

스킬 저장: ai-dev-team/skills/에 스킬 저장
스킬 적용: ada skills apply로 네이티브 경로에 복사
AI 실행: 각 AI 도구가 자체 스킬 경로에서 자동 로드

이를 통해 AI는 프로젝트의 기술 스택과 코딩 패턴을 자동으로 따르게 됩니다.

예시 시나리오

Spring Boot + Kotlin 프로젝트:

# 1. 스킬 다운로드 (커뮤니티에서)
cd ai-dev-team/skills/
git clone https://github.com/awesome-ada/spring-boot-skill.git spring-boot
git clone https://github.com/awesome-ada/kotlin-skill.git kotlin
git clone https://github.com/awesome-ada/rest-api-skill.git rest-api

# 2. 확인
ada skills list

# 3. 스킬 적용 (네이티브 경로에 복사)
ada skills apply spring-boot
ada skills apply kotlin
ada skills apply rest-api

# 4. 개발 실행
ada developer claude

# → Controller 작성 시 자동으로:
#   - @RestController + @RequestMapping 패턴 사용
#   - Kotlin data class 활용
#   - REST API 네이밍 규칙 준수

Python FastAPI 프로젝트:

# 커뮤니티에서 스킬 다운로드
cd ai-dev-team/skills/
git clone https://github.com/awesome-ada/fastapi-skill.git fastapi
git clone https://github.com/awesome-ada/pydantic-skill.git pydantic

# 스킬 적용
ada skills apply fastapi
ada skills apply pydantic

ada developer claude

스킬 관리 명령어

| 명령어 | 설명 | |--------|------| | ada skills list | 스킬 목록 (적용 상태 포함) | | ada skills info <name> | 스킬 상세 정보 | | ada skills apply <name> [tool] | 스킬 적용 (네이티브 경로에 복사) | | ada skills remove <name> [tool] | 스킬 제거 | | ada skills status | 도구별 적용 상태 확인 | | ada skills ui | 대화형 스킬 적용/삭제 |

지원 도구: claude, gemini, codex

스킬 추가 방법:

커뮤니티 저장소에서 다운로드
직접 ai-dev-team/skills/<name>/SKILL.md 생성
팀 내부 스킬 공유

⚠️ 핵심 원칙

금지 사항

❌ 문서 없는 진행
❌ 기준 없는 판단
❌ 감으로 추가된 기술
❌ 스프린트 외 작업
❌ "김에" 리팩토링
❌ 역할 간 경계 침범

필수 사항

✅ 문서 기준 판단
✅ 역할별 책임 분리
✅ Task 단위 반복 개발
✅ 스프린트 단위 관리
✅ REJECT 시 원인 분석

📊 템플릿 비교

| 템플릿 | 설명 | 특화 문서 | |--------|------|----------| | web-dev | 웹 서비스/API 서버 | api.md, ui.md | | library | npm/pip 라이브러리 | public-api.md, changelog.md | | game | 게임 개발 | game-systems.md, assets.md | | cli | CLI 도구 | commands.md, output-format.md |

🎯 주요 개선 사항 (v0.2.0)

역할 시스템 간소화

이전 (v0.1.x):

7개 Core 역할 + 템플릿별 특화 역할 (총 13개)
Manager 중심의 복잡한 승인 프로세스
역할 간 blocking 문제 (backend ↔ frontend)

현재 (v0.2.x):

5개 핵심 역할 (planner, improver, developer, reviewer, documenter)
사용자 직접 스프린트 관리 (CLI 명령어)
단순화된 워크플로우
신규 기능(Planner)과 개선(Improver) 분리

스프린트 기반 구조

이전:

단일 파일 (backlog.md, current-sprint.md)
Git 충돌 위험
Task별 독립성 부족

현재:

디렉토리 기반 (sprints/sprint-N/)
Task별 개별 파일 (task-NNN.md)
리뷰/문서도 Task별 분리
완료된 스프린트는 불변 (이력 보존)
종료 시 작업 파일 자동 정리 (archive/ 또는 삭제)

자동화 개선

추가된 CLI 명령어:

ada sprint create - 스프린트 자동 생성
ada sprint add - Task 자동 추가
ada sprint close - 스프린트 종료 및 작업 파일 정리 (archive/clean/keep-all 옵션)
ada sprint list - 스프린트 목록 확인
ada config - 설정 조회/변경

🔧 개발 환경

필수 요구사항

Node.js 18+
npm 7+

로컬 개발

git clone https://github.com/silbaram/artifact-driven-agent.git
cd artifact-driven-agent
npm install        # 의존성 설치
npm run build      # TypeScript 컴파일
npm link           # 전역 ada 명령어 등록

개발 스크립트

npm run build      # TypeScript 컴파일 (dist/ 생성)
npm run dev        # TypeScript watch 모드 (개발 중)
npm run typecheck  # 타입 체크만 실행
npm test           # 테스트 실행 (Node.js 내장 test runner)

프로젝트 구조 (TypeScript)

artifact-driven-agent/
├── bin/
│   └── cli.ts              # CLI 진입점 (TypeScript)
├── src/
│   ├── commands/           # 명령어 구현 (.ts)
│   ├── utils/              # 유틸리티 (.ts)
│   ├── ui/                 # UI 컴포넌트 (.ts)
│   └── types/              # TypeScript 타입 정의
├── dist/                   # 빌드 출력 (npm run build)
├── tsconfig.json           # TypeScript 설정
├── core/                   # 프레임워크 핵심
└── templates/              # 프로젝트 템플릿

📄 문서

CLAUDE.md: Claude Code AI를 위한 상세 가이드
core/roles/*.md: 각 역할의 상세 규칙
core/rules/*.md: 핵심 규칙 문서
templates/*/: 템플릿별 특화 문서

🤝 기여

이슈 및 PR 환영합니다!

보고 위치:

GitHub Issues: https://github.com/silbaram/artifact-driven-agent/issues

📄 라이선스

MIT License

📮 연락처

GitHub: @silbaram
npm: @silbaram/artifact-driven-agent