아크-에이전트

AI 지원 개발을 위한 구조화된 아키텍처 설계.

arch-agent는 Claude Code를 의견이 반영된 아키텍처 리뷰어로 바꾸어 팀이 엄격한 단계별 설계 과정을 거치도록 안내합니다. 이 도구는 가정을 검증하고, 의사결정 게이트를 적용하며, 단순한 텍스트 생성이 아닌 문서화된 아키텍처를 생성합니다.

문제점

아키텍처 결정은 뒤집기 가장 비용이 많이 듭니다. 하지만 대부분의 팀은 다음 중 하나를 선택합니다:

• 정식 설계를 건너뛰고 나중에 재작업 비용을 지불
• AI 문서를 생성하여 모든 것에 '예'라고 답하고 실제 제약 조건을 반영하지 않음
• 문서를 한 번 작성하고 나중에는 오래되어 현실과 단절됨

arch-agent는 AI 추론과 인간 통제 게이트를 결합하여 이를 해결합니다. AI가 제안하고 검증하면, 사용자가 결정합니다. 모든 결정은 근거, 대안, 트레이드오프와 함께 기록됩니다.

arch-agent의 위치

입력: .arch/ 디렉토리에 위치한 PRD 및 조직 컨텍스트(팀 규모, 기술 스택, 제약 조건).

출력: 결정 로그, 상세 컴포넌트 사양, 적대적 리뷰 결과 및 포괄적인 아키텍처 문서 — 모든 선택에는 근거와 대안이 뒷받침됩니다. 산출물은 단계가 진행됨에 따라 생성되며, 최종 단계에만 국한되지 않습니다.

엔드 투 엔드 워크플로

요구사항부터 아키텍처 산출물까지의 전체 여정은 다음과 같습니다:

1. 프로젝트 골격 만들기

이는 .arch/ (상태 머신, 검증 스크립트, 작업 파일) 및 .claude/ (슬래시 명령어)를 생성합니다

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.