DanMcInerney/architect-loop

architect‑loop – 자율적인 LLM 기반 소프트웨어 팩토리

개요 – architect-loop는 대규모 언어 모델 에이전트(설계/검토용 Claude, 코드 생성용 Codex)로 구동되는 완전 자동화된 개발 파이프라인을 실행할 수 있는 명령줄 오케스트레이터입니다. 고수준 제품 요청을 받아 독립적인 이슈로 분해하고, 각 이슈를 새로운 Git worktree에서 구현하는 'builder' 에이전트를 생성하며, 테스트를 실행하고, 최종적으로 사람의 승인 없이 단일 PR(또는 로컬 완료 기록)을 생성합니다.

작동 방식

• 오케스트레이터 (Orchestrator) – 시작하는 세션(/architect, /architect‑fast 또는 /architect‑research)이 마스터 프로세스입니다. 사양을 초안 작성하는 전략가 (strategist) 하위 에이전트를 생성한 다음, 각 이슈를 처리하는 builder 에이전트를 생성합니다.
• 타입화된 증거 및 감시자 (Typed evidence & watchdog) – 각 builder는 JSON 메타 파일, 하트비트 및 종료 상태를 기록하는 래핑된 CLI 작업 내에서 실행됩니다. 감시자는 타입화된 증거만 기록하며 작업을 강제로 종료하지 않습니다. 멈춘 작업은 kill-job으로 수동으로 종료합니다.
• 추적기 (Tracker) – 상태는 GitHub(이슈/PR) 또는 로컬 docs/issues/<run>/ 아래의 markdown 파일에 저장됩니다. 모든 실행 메타데이터는 docs/runs/<run>/ 아래에 있습니다.
• 결정론적 게이트 (Deterministic gates) – builder가 실행되기 전에 고정된 검사가 커밋됩니다. 최종 검토는 전략가가 수행하는 읽기 전용 패스로, 통합하거나 수정 이슈를 생성합니다.
• 패스트 레인 (Fast lane) – /architect‑fast는 실행을 3개 이하의 builder 이슈와 약 400줄의 변경 사항으로 제한하며, 전략가 단계와 고정된 검사를 건너뛰어 빠르고 제한적인 변경을 수행합니다.
• 연구 레인 (Research lane) – /architect‑research는 구조화된 문헌 조사 스타일의 조사를 수행하여 출처가 포함된 보고서를 생성합니다.

주요 명령어

/architect-research <topic>   # 주제별 연구, 답변 우선 보고서
/architect <hours+ request>   # 전체 다시간 팩토리 실행
/architect-fast <small change># 빠르고 제한적인 변경 레인

런타임 도우미에는 run-job.sh|ps1, kill-job, status.sh|ps1 및 정리를 위한 sweep‑deferred가 포함됩니다.

설치

git clone https://github.com/DanMcInerney/architect-loop
cd architect-loop && ./install.sh        # Windows: .\install.ps1
npm i -g @openai/codex@latest            # 선택적 builder 백엔드

설치 프로그램은 skills/ 디렉토리를 적절한 Claude 및 Codex 스킬 위치로 복사합니다. --project를 사용하면 사용자 프로필 대신 현재 저장소에 스킬이 설치됩니다.

설정 (선택 사항, ~/.architect/config 또는 .architect/config)

strategist = claude/best       # 설계/검토 에이전트
builders   = codex/best        # 코드 생성 에이전트
tracker    = markdown          # 또는 github

설정을 통해 모델 제품군을 교체하거나, 노력 수준을 고정하거나, 추적기 모드를 변경할 수 있습니다.

유효성 검사 및 테스트

uv run --no-project python tests/validate_skills.py

유효성 검사기는 스킬 정의, 래퍼 및 계약이 프로젝트의 아키텍처 불변량을 준수하는지 확인합니다.

라이선스 – MIT.

---

결론 – architect-loop는 LLM으로 오케스트레이션되는 자율적인 개발 프레임워크로, 사양에서 PR까지의 전체 주기를 자동화합니다. 전체 기능 레인과 경량 패스트 레인을 모두 지원하며, GitHub 또는 순수 markdown 이슈 추적을 지원합니다.