aiag-cli

AI 에이전트 하네스 CLI - Anthropic의 접근 방식을 기반으로 한 장기 실행 에이전트 개발 도구

개요

aiag-cli는 Anthropic의 "Long-Running Agent" 아키텍처를 사용하여 AI 에이전트 개발 세션을 관리하는 커맨드라인 도구입니다. 다음 기능을 제공합니다:

• 상태 외부화: AI 메모리가 아닌 파일에 진행 상황 추적
• 점진적 진행: 테스트와 함께 한 번에 하나의 기능
• 세션 관리: 명확한 시작/종료 시퀀스
• 기능 추적: 테스트 명령이 포함된 JSON 기반 기능 목록

설치

# npm
npm install -g aiag-cli

# 또는 npx로 직접 사용
npx aiag-cli init

빠른 시작

# 1. 프로젝트에서 초기화
aiag init

# 2. .aiag/feature_list.json에 기능 편집

# 3. 상태 확인
aiag status

# 4. 다음 작업할 기능 가져오기
aiag next

# 5. 구현 후 완료 표시
aiag complete FEATURE-001

# 6. 변경사항 커밋
aiag commit

명령어

| 명령어 | 설명 | | -------------------- | ----------------------------------- | | aiag init | 현재 디렉토리에 AIAG 초기화 | | aiag status | 프로젝트 진행 상황 표시 | | aiag next | 다음 기능 추천 받기 | | aiag work [id] | 단일 기능 작업 시작 (세션 + 프롬프트) | | aiag auto [count] | 자동 연속 구현 모드 | | aiag test [id] | 기능 테스트 실행 | | aiag complete <id> | 기능을 완료로 표시 | | aiag commit | 자동 메시지로 변경사항 커밋 | | aiag session start | 코딩 세션 시작 | | aiag session end | 현재 세션 종료 |

작업 지시 명령어

# 단일 기능 작업 시작 (세션 컨텍스트 업데이트 + 프롬프트)
aiag work
aiag work AUTH-001

# 자동 연속 구현 (비대화형)
aiag auto           # 기본 5개
aiag auto 10        # 10개 기능
aiag auto --dry-run # 시뮬레이션
aiag auto --loop    # 무한 루프 (Ctrl+C로 중단)
aiag auto --resume  # 진행 중인 작업부터 이어서 시작
aiag auto --loop --resume  # 이어서 + 무한 루프
aiag auto -v        # 상세 로그 출력 (Claude Code 출력 포함)
aiag auto --timeout 15  # Claude Code 타임아웃 15분 설정

디렉토리 구조

aiag init 실행 후:

.aiag/
├── feature_list.json    # 상태가 포함된 모든 기능
├── progress.md          # 세션 로그 (추가 전용)
├── init.sh              # 환경 설정 스크립트
├── session_context.md   # 현재 세션 정보
└── templates/           # 에이전트 프롬프트 템플릿
    ├── initializer.md
    └── coding.md

기능 형식

{
  "id": "CORE-001",
  "category": "core",
  "priority": "critical",
  "description": "기능 설명",
  "acceptanceCriteria": ["기준 1", "기준 2"],
  "testCommand": "bun test",
  "passes": false,
  "lastTestedAt": null,
  "implementedBy": null
}

세션 워크플로우

세션 시작

aiag session start
# 1. 컨텍스트 확인을 위해 progress.md 확인
# 2. init.sh 실행
# 3. aiag next로 작업 찾기

세션 종료

aiag session end
# 체크리스트:
# □ 기능 완료 또는 클린 상태
# □ 모든 테스트 통과
# □ 변경사항 커밋됨
# □ progress.md 업데이트됨

카테고리

| 카테고리 | 설명 | | -------- | ----------------- | | core | 핵심 인프라 | | cli | CLI 명령어 | | api | API 엔드포인트 | | ui | 사용자 인터페이스 | | test | 테스트 인프라 | | data | 데이터 처리 | | docs | 문서화 | | devops | 빌드/배포 |

우선순위 레벨

1. critical - 다른 기능의 선행 조건
2. high - 핵심 사용자 가치
3. medium - 중요하지만 연기 가능
4. low - 있으면 좋은 것

핵심 원칙

Anthropic의 Long-Running Agent 아키텍처 기반:

1. 하나의 기능 규칙 - 한 번에 하나의 기능만 작업
2. 완료 전 테스트 - passes: true 표시 전 항상 테스트
3. 클린 상태 - 코드를 절대 깨진 상태로 두지 않음
4. 진행 상황 문서화 - 매 세션마다 progress.md 업데이트

Author

주식회사 기반 (Giban Co., Ltd.)

• Website: aiag.co.kr
• Email: [email protected]
• Maintainer: Yunchan Park

라이선스

MIT