first-fluke/oh-my-agent

해결하는 문제

많은 AI 에이전트는 내부적인 서사에 기반해 성공을 주장하지만, 이는 오해를 불러일으키거나 모순될 수 있습니다. oh-my-agent는 에이전트의 요약이 아니라 실제 아티팩트(예: 테스트 결과 및 파일)를 검사하는 기계적 검증 시스템을 구현함으로써, 작업이 실제로 완료되고 검증되었음을 보장합니다.

작동 방식

이 프로젝트는 전문 에이전트(예: 백엔드, 프론트엔드, QA)를 가상의 엔지니어링 팀으로 조직하는 다중 에이전트 하네스를 제공합니다. 품질을 보장하기 위해 여러 기계적 게이트를 사용합니다:

• 스톱훅 게이트: 특정 스크립트(예: typecheck 또는 test)가 성공적으로 종료될 때까지 세션을 종료하지 않습니다.
• 회피 방지 게이트: 계획 JSON 및 QA 결과 파일과 같은 특정 아티팩트의 존재를 검증하여 워크플로우가 실제로 실행되었음을 확인합니다.
• 독립된 심사관: 구현자의 주장에 편향되지 않도록 새 컨텍스트로 별도의 에이전트를 시작하여 기준을 재검증합니다.
• 이벤트 소싱 상태: 모든 결정과 게이트 결과를 추가 전용 JSON 로그에 기록하여 감사 가능하게 합니다.

이 프로젝트는 다양한 에이전트 런타임(Claude Code, Cursor, Codex 등)에 걸쳐 단일 진실의 소스(.agents/ 디렉터리)를 제공하며, 구성 파일을 통해 공급업체를 쉽게 전환할 수 있습니다.

대상 사용자

간단한 채팅 기반 AI 코딩을 넘어, 자동 검증과 다중 공급업체 유연성을 갖춘 엄격한 다중 에이전트 워크플로우를 구현하고자 하는 개발자 및 엔지니어링 팀.

주요 특징

• 역할 기반 아키텍처: 아키텍처, DB 설계, 프론트엔드, 백엔드, 보안을 위한 전문 에이전트.
• 다중 공급업체 지원: Claude Code, Cursor, Qwen Code 등 여러 AI 런타임에서 작동.
• 기계적 검증: LLM 기반의 "보기에 맞는지" 평가 대신 하드 에그지트와 파일 체크를 사용.
• 토큰 효율성: 컨텍스트 창 사용을 줄이기 위해 이중 레이어 기술 로딩 시스템을 구현.
• 모노레포 인식: pnpm, nx, turbo, lerna 프로젝트에서 자동으로 워크스페이스를 감지하고 에이전트에 라우팅합니다.