Syshin0116 홈
프로젝트 목록

개인

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/Telegram
decision card
지식 관리
ADR (proposed→accepted)
Git + Markdown 지식 그래프
문서
Markdown docs-as-SoT
roadmap
MIT