개인
AutoDev - 자율 소프트웨어 딜리버리 시스템 설계
도구 비종속 자율 개발 시스템 설계·스펙 (design-first)
- 기간
- 2026.06 ~ 2026.07약 1개월 (설계·스펙 단계에서 완료, 레포 아카이브)
- 역할
- 1인 설계 / 오픈소스
- 팀
- 개인 오픈소스 프로젝트
- 상태
- 완료
- 자기 적용한 ADR
- 38건
- 설계 문서
- 20여 편
배경
에이전트가 이슈부터 구현·리뷰·머지까지 자율 수행하고, 사람은 되돌리기 어려운 '진짜 결정'만 내리는 자율 소프트웨어 딜리버리 시스템. 특정 오케스트레이터에 종속되지 않도록 Orchestrator/Runtime/Agent/Gate 추상으로 설계하고, 멀티모델 리뷰 건틀릿·리스크 티어 auto-merge·결정을 ADR로 축적하는 Evergreen Decision Graph를 문서와 ADR로 정의한 design-first 리포지토리.
한 일
주요 기능
멀티모델 리뷰 건틀릿
- 구현 → 1차 리뷰 루프 → 2차 리뷰 루프 → CI 게이트 → 머지
- 서로 다른 모델(Claude·Codex)로 교차 검증해 단일 모델 편향 완화
- 게이트를 통과한 변경만 머지 대상으로 승격
리스크 티어 auto-merge
- 안전 레인(패치·문서·포맷·테스트 전용, CI 통과)은 자동 머지
- 위험 레인(공개 API·마이그레이션·auth·.github)은 사람에게 에스컬레이션
- GitHub-native auto-merge + 룰셋으로 main 직접 push 차단
에스컬레이션 = 지식 축적 (하나의 메커니즘)
- 에스컬레이션 페이로드는 decision card(맥락·1줄 결정·2-4개 옵션·트레이드오프·추천·되돌림 가능성·링크)
- 사람이 결정하면 AI가 ADR을 proposed로 작성, 사람이 accepted로 승인
- 결정이 쌓여 Evergreen Decision Graph(살아있는 결정 그래프)로 축적
도구 비종속 설계
- 특정 플랫폼 종속을 없애기 위해 런타임 매핑을 별도 문서로 격리
- 멀티레포는 단일 docs SoT를 N개 레포가 참조 (충돌 시 docs 우선)
- 레포 레지스트리 + 온보딩(문서 스켈레톤 + CI 게이트 + 등록)
문제와 해결
- 완전 자동화와 안전성의 균형
- 전면 auto-merge는 위험하다. 변경 유형을 안전/위험 레인으로 티어링하고 위험 레인만 사람에게 올리는 리스크 티어 게이트로 해결
- 사람 개입은 최소화하되 지식은 남기기
- 결정을 물어보는 행위 자체를 지식 자산으로 전환. decision card → ADR proposed → accepted 루프로 에스컬레이션과 지식화를 하나로 묶음
결과
- 코드보다 문서·ADR를 먼저 쓰는 design-first 방식으로 시스템 스펙 정립
- 특정 오케스트레이터에 종속되지 않는 추상 계층으로 런타임 교체 가능성 확보
- 에스컬레이션과 지식 축적을 ADR 하나의 메커니즘으로 통합하는 Evergreen Decision Graph 개념 정의
배운 점
- 자율 시스템에서 사람의 역할을 '결정자'로 좁히는 경계 설정
- 멀티모델 교차 리뷰로 단일 모델 편향을 줄이는 리뷰 건틀릿 설계
- 에스컬레이션을 지식 자산으로 전환하는 ADR 기반 결정 루프
- design-first: 코드보다 문서·ADR를 SoT로 두는 멀티레포 운영
기술 스택
- 아키텍처
- Orchestrator/Runtime/Agent/Gate 추상Evergreen Decision Graph멀티레포 단일 docs SoT
- 에이전트
- Claude Code (구현·1차 리뷰)Codex (2차 리뷰)CI 게이트
- 에스컬레이션
- Slack DM모바일 push/Telegramdecision card
- 지식 관리
- ADR (proposed→accepted)Git + Markdown 지식 그래프
- 문서
- Markdown docs-as-SoTroadmapMIT