Adelie
소프트웨어 프로젝트의 전체 라이프사이클을 자율적으로 운영하는 멀티 에이전트 AI 오케스트레이션 시스템입니다. CLI 하나(npm install -g adelie-ai)로 설치하고, LLM 프로바이더만 연결하면 계획부터 코딩, 리뷰, 테스트, 배포, 진화까지 AI가 스스로 수행합니다.
핵심 기능
- 13+ AI 에이전트 파이프라인: Writer, Expert, Coder, Reviewer, Tester, Runner, Monitor 등이 자율 협업하며 소프트웨어를 만들어냄
- Meta Harness (동적 파이프라인): AI가 프로젝트 요구사항을 분석해 자기 실행 파이프라인을 JSON 상태머신으로 런타임에 재구성
- Policy Engine:
.adelie/constraints.yaml로 선언적 제약 적용 — Python AST 분석, 패턴 매칭으로 위험 코드 자동 차단 - Memory Harness: 페이즈별 Knowledge Base 필터링으로 컨텍스트 혼란 방지, 자동 아카이빙과 요약 트리
- Production Bridge: GitHub Actions / Sentry / MCP 모니터링과 연동, CI 실패 시 자동 핫픽스 생성
- Human Intercept: CLI
/intercept또는 대시보드 ⛔ 버튼으로 언제든 즉시 정지 - 실시간 대시보드:
localhost:5042에서 에이전트 상태, 파이프라인, 정책 위반, 메모리 현황 실시간 확인
기술 스택
| 영역 | 기술 |
|---|---|
| Core | Python 3.10+ · Node.js 16+ |
| CLI | Rich · argparse · 인터랙티브 REPL |
| LLM | Google Gemini · Ollama (로컬) |
| Dashboard | Python http.server · SSE · 내장 HTML/JS |
| Analysis | Python AST · RegEx Pattern Engine |
| CI/CD 연동 | GitHub Actions · Sentry · MCP |
| 배포 | npm · Homebrew · curl/PowerShell 원라인 설치 |
| 테스트 | pytest (748 tests) |
아키텍처
adelie/
├── orchestrator.py # 메인 루프 — 상태 머신 + 하네스 통합
├── harness_manager.py # 동적 파이프라인 설정 + 롤백
├── policy_engine.py # 선언적 제약 엔진
├── memory_harness.py # 선택적 망각 + 페이즈별 KB
├── production_bridge.py # CI/CD + 모니터링 피드백 루프
├── agents/ # 13+ 특화 AI 에이전트
│ ├── expert_ai.py # 전략적 의사결정
│ ├── coder_ai.py # 코드 생성 + 의존성 정렬
│ ├── reviewer_ai.py # 품질 리뷰 (1-10 점수)
│ ├── tester_ai.py # 테스트 실행 + 실패 피드백
│ ├── runner_ai.py # 빌드 & 배포
│ └── dynamic_agent.py # 런타임 생성 에이전트
├── dashboard.py # 실시간 웹 UI (SSE)
├── llm_client.py # LLM 추상화 (Gemini + Ollama + 폴백)
└── sandbox.py # Docker/Seatbelt 격리
설계 철학
- 단일 CLI, 제로 클라우드 백엔드: npm 하나로 설치, 계정이나 외부 서비스 불필요
- 하네스 아키텍처: 단순 코드 생성이 아닌, AI를 제약하고 감시하고 자기교정하는 구조적 프레임워크
- 적응형 라이프사이클:
initial → mid → mid_1 → mid_2 → late → evolve페이즈를 품질 메트릭 기반으로 자동 전환 - 안전 우선: 스테이징 격리, 쉘 인젝션 차단, 경로 순회 방지, 화이트리스트 명령어