메인 칼럼 개발일지 작업물 연락처
← Projects
2026
PythonAI AgentLLMCLI

Adelie

자율 AI 오케스트레이션 CLI — 13개 에이전트가 코드를 짜고, 리뷰하고, 배포까지 하는 자기구성형 시스템

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에서 에이전트 상태, 파이프라인, 정책 위반, 메모리 현황 실시간 확인

기술 스택

영역기술
CorePython 3.10+ · Node.js 16+
CLIRich · argparse · 인터랙티브 REPL
LLMGoogle Gemini · Ollama (로컬)
DashboardPython http.server · SSE · 내장 HTML/JS
AnalysisPython 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 페이즈를 품질 메트릭 기반으로 자동 전환
  • 안전 우선: 스테이징 격리, 쉘 인젝션 차단, 경로 순회 방지, 화이트리스트 명령어

개발 일지

6개의 기록