notque/vexjoy-agent
VexJoy AI Agent with Intelligent Routing - /do routes plain-English requests to the right specialist agent and gates the work with reviews, tests, and a learning loop.
해결하는 문제
VexJoy Agent는 조언형 지시를 구조적 강제성으로 대체함으로써 AI 에이전트가 "단계를 건너뛰는" 혹은 깨진 코드를 배포하는 일을 방지합니다. 에이전트가 실제로 테스트를 실행하거나 변경 사항을 검증하지 않고도 작업이 완료되었거나 "사소한" 일이라고 자신 있게 주장하는 문제를 해결하여, 에이전트의 자신감 수준과 관계없이 고품질 방법론이 적용되도록 합니다.
작동 원리
이 툴킷은 AI CLI 런타임(Claude Code, Codex, Factory, Reasonix 등)에 직접 통합되는 4계층 아키텍처를 통해 동작합니다:
- Agents(에이전트): 실패 모드 카탈로그와 오류‑수정 매핑을 포함한 도메인별 지식을 제공합니다.
- Skills(스킬): 엄격한 종료 기준을 갖는 단계별 방법론을 정의합니다. 에이전트는 성공 증거를 제시하지 않으면 다음 단계로 이동할 수 없습니다.
- Hooks(후크): 라이프사이클 이벤트 트리거로, LLM 비용 없이 미완성 작업을 차단합니다.
- Scripts(스크립트): 실제 실행 및 검증을 담당하는 결정론적 도구(린터, 테스트 러너)로, 검증 과정에서 LLM 판단을 제거합니다.
사용자는 라우터(예: /do 명령)를 통해 시스템과 상호작용하며, 라우터는 의도를 분석하고 올바른 전문 에이전트와 적절한 스킬·방법론을 자동으로 매핑합니다.
대상 사용자
- 개발자: 코드 검증을 보장하고 회귀를 방지하는 에이전시 워크플로가 필요한 사람.
- 지식 근로자: 코드를 작성하지 않고도 연구, 초안 작성, 자체 포함 HTML 산출물(보고서, 슬라이드덱, 프로토타입) 제작을 위해 툴킷을 활용하는 사람.
- AI 파워 유저: 라우팅 테이블, 파이프라인, 후크 등을 커스터마이징하고 싶은 사람.
주요 특징
- 반합리화(Anti‑Rationalization): 종료 게이트와 후크를 사용해 에이전트가 테스트나 검증을 건너뛰지 못하도록 차단하고, 단순 어설션이 아닌 종료 코드를 요구합니다.
- 멀티 런타임 지원: Claude Code, Codex, Factory, Reasonix와 호환됩니다.
- 헬스 통합 라우팅(Harness‑Integrated Routing): 일반 영어 요청을 자동으로 적절한 전문 에이전트와 방법론에 라우팅합니다.
- 지식 작업 엔진: 초안을 AI 패턴에 맞춰 검증하고 고품질 HTML 산출물을 생성하는 콘텐츠 엔진을 포함합니다.
- 증거 기반 진화(Evidence‑Based Evolution): 새로운 스킬은 베이스라인과 A/B 테스트를 거친 후 툴킷에 병합됩니다.