여러 LLM 에이전트를 조율하는 셀프 호스팅 TypeScript 런타임으로, 사람의 승인 절차와 오프라인에서 검사할 수 있는 실행 로그를 제공합니다.
tiagovilasboas/grok-bot-architecture
재사용 가능한 역할별 스킬, MCP 커넥터, 사람의 승인 게이트를 활용해 AI 에이전트 팀을 구성하는 MIT 라이선스 참조 아키텍처입니다.
- 스타
- 49
- 포크
- 11
- 열린 이슈
- 0
- 마지막 커밋
- 9일 전
어떤 프로젝트인가요?
이 저장소는 모델이나 프레임워크에 종속되지 않는 AI 에이전트 팀 구성 참조 아키텍처입니다. 비서실장 에이전트가 목표를 범위가 명확한 업무로 나누고 엔지니어링, 퍼블리싱, 보안, 받은편지함 분류, 커리어 심사 등의 전문 역할에 배정합니다. 각 역할은 재사용 가능한 SKILL.md 레시피로 정의되며, 무제한 접근 권한이 아니라 호스트가 적용하는 도구 권한에 따라 작동합니다.
핵심은 사람이 참여하는 승인 절차입니다. 권한이 필요한 작업은 인증된 사용자가 정확한 작업과 리비전을 기준으로 결정할 때까지 대기하며, 제한 시간이 지나도 작업을 진행하지 않고 대기 상태를 유지합니다. 형식이 지정된 핸드오프 기록과 Markdown 보드를 통해 역할 간 업무와 근거를 전달하며, 저장소에는 JSON 검증기, 보드 도구, 범위가 제한된 로컬 승인 수명 주기 예제가 포함되어 있습니다.
또한 이 프로젝트는 설정 단계, 승인 정책 지침, 단계별 안내를 통해 이 패턴을 Grok Bot에 적용하는 방법을 설명합니다. Grok Bot 제품의 소스 코드는 포함하지 않으며 xAI와 제휴 관계도 없습니다.
핵심 기능
- 01전문 역할의 업무 범위를 정하고 배정하며 검토하는 비서실장 에이전트
- 02SKILL.md 레시피로 정의된 재사용 가능한 역할별 스킬 9개
- 03각 결정을 정확한 작업 리비전에 연결하고 제한 시간이 지나면 대기하는 승인 게이트
- 04상태와 근거를 공유하기 위한 형식이 지정된 핸드오프 기록과 Markdown 보드
- 05외부 의존성 없이 사용할 수 있는 JSON 검증기와 로컬 승인 수명 주기 예제
활용 사례
- 이메일이나 코드처럼 서로 다른 영역을 각각 담당하는 지속형 AI 어시스턴트 팀 설계
- 에이전트가 메시지를 보내거나 코드를 병합하거나 외부 시스템을 변경하기 전에 사람의 승인을 추가
- 기존 에이전트 호스트에 역할 기반 권한과 핸드오프 적용
- 프로덕션 코드를 작성하기 전에 에이전트 시스템의 신뢰 경계 패턴 학습
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/tiagovilasboas/grok-bot-architecture.git - 2
프로젝트 폴더로 이동합니다
cd grok-bot-architecture - 3
로컬 검증 및 승인 라이프사이클 검사를 실행합니다
bash scripts/check.sh
사용 전 알아둘 점
- 이것은 참조 아키텍처이자 문서화 패턴이며, 독립 실행형 런타임 에이전트 시스템이 아닙니다.
- Grok Bot 설정 경로는 소스 코드가 포함되지 않은 별도의 Grok Bot 제품에 의존합니다.
- 검증기는 파일 형식만 확인하며, 사람 승인자를 인증하거나 부수 효과를 실행하지 않습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- grok-bot-architecture은(는) 무엇인가요?
- 재사용 가능한 역할별 스킬, MCP 커넥터, 사람의 승인 게이트를 활용해 AI 에이전트 팀을 구성하는 MIT 라이선스 참조 아키텍처입니다. 이 저장소는 모델이나 프레임워크에 종속되지 않는 AI 에이전트 팀 구성 참조 아키텍처입니다. 비서실장 에이전트가 목표를 범위가 명확한 업무로 나누고 엔지니어링, 퍼블리싱, 보안, 받은편지함 분류, 커리어 심사 등의 전문 역할에 배정합니다. 각 역할은 재사용 가능한 SKILL.md 레시피로 정의되며, 무제한 접근 권한이 아니라 호스트가 적용하는 도구 권한에 따라 작동합니다.
- grok-bot-architecture은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- grok-bot-architecture은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- grok-bot-architecture은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. grok-bot-architecture의 마지막 커밋은 2026년 10월 29일입니다.
- grok-bot-architecture은(는) 어디에 사용할 수 있나요?
- 이메일이나 코드처럼 서로 다른 영역을 각각 담당하는 지속형 AI 어시스턴트 팀 설계 에이전트가 메시지를 보내거나 코드를 병합하거나 외부 시스템을 변경하기 전에 사람의 승인을 추가 기존 에이전트 호스트에 역할 기반 권한과 핸드오프 적용 프로덕션 코드를 작성하기 전에 에이전트 시스템의 신뢰 경계 패턴 학습
- grok-bot-architecture는 어떻게 설치하나요?
- 저장소를 클론합니다: git clone https://github.com/tiagovilasboas/grok-bot-architecture.git 프로젝트 폴더로 이동합니다: cd grok-bot-architecture 로컬 검증 및 승인 라이프사이클 검사를 실행합니다: bash scripts/check.sh
- grok-bot-architecture은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tiagovilasboas/grok-bot-architecture
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
AI 에이전트용 셀프 호스팅 이메일 인박스로, REST 및 MCP API, SMTP, 위험한 메일에 대한 사람의 승인, 서명된 웹훅을 제공합니다.
에이전트 기반 시스템과 결정론적 워크플로를 구축·실행·관찰·제어하는 셀프 호스팅 런타임 및 시각적 플랫폼입니다.
AI 에이전트와 사람이 검토를 거쳐 변경 사항을 반영하며 구조화된 기록, 문서, 스킬, 앱을 공유하는 오픈소스 데이터베이스 및 워크스페이스입니다.
지속적으로 작동하는 퀸 에이전트가 작업을 계획하고, 워커 에이전트를 병렬로 실행하며, 공유 SQLite 트래커에서 결과를 추적하는 오픈소스 런타임입니다.
브라우저 WebUI, 터미널 클라이언트, 채팅 앱 채널, 도구, 메모리 및 MCP를 지원하는 Python 기반 셀프 호스팅 개인 AI 에이전트 프레임워크입니다.