메인 칼럼 개발일지 작업물 연락처
← 작업물

작업물 · WORK

Adelie

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

Year
2026
Stack
PythonAI AgentLLMCLI
Devlog
6개의 기록

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 페이즈를 품질 메트릭 기반으로 자동 전환
  • 안전 우선: 스테이징 격리, 쉘 인젝션 차단, 경로 순회 방지, 화이트리스트 명령어
개발일지 / DEVLOG 6개의 기록
  1. 개발일지 v0.3.0 찍고 실전에서 터진 것들 Production Bridge, Human Intercept, 그리고 실전 투입 후 연쇄 버그 수정 v0.3.0Production Bridge버그 헌팅
  2. 개발일지 AI가 자기 파이프라인을 바꾸게 하다 정적 6단계 파이프라인에서 동적 JSON 상태머신으로의 전환 Meta Harness아키텍처동적 파이프라인
  3. 개발일지 정책 엔진이랑 선택적 망각 Policy Engine과 Memory Harness로 AI를 제약하고 컨텍스트를 관리하다 Policy EngineMemory HarnessAST
  4. 개발일지 Windows 호환성 — 이 고생을 왜 했나 WinError 87, 쉘 인젝션, 경로 순회, 크로스플랫폼 테스트 지옥 Windows보안크로스플랫폼
  5. 개발일지 대시보드가 안 뜨는데 루프는 돌아간다 대시보드 빈 화면 버그, Expert AI의 소스 없는 배포 시도, 그리고 루프 디텍터 대시보드버그픽스루프 디텍터
  6. 개발일지 npm에 처음 패키지 올려봤다 v0.2.0 첫 퍼블리시, 에이전트 파이프라인이 돌아가기까지 npm초기 릴리즈LLM