GitAgent by Lyzr

GitAgent: Git 리포지토리를 AI 에이전트로 활용하는 오픈 표준

GitAgent는 AI 에이전트를 정의, 버전 관리 및 실행하기 위한 Git 네이티브 방식의 프레임워크 제약 없는 오픈 표준입니다. GitAgent를 사용하면 코드 저장소(Repository)가 곧 에이전트가 되며, 익숙한 Git 워크플로우를 통해 AI의 행동과 기술을 관리할 수 있습니다.

What's GitAgent?

GitAgent는 AI 에이전트의 구성을 파일 시스템 기반으로 구조화하여 Git의 강력한 버전 관리 기능을 AI 설계에 이식한 표준입니다. agent.yaml, SOUL.md, SKILL.md와 같은 단순한 파일 정의만으로 에이전트를 생성할 수 있으며, 한 번의 정의로 Claude Code, OpenAI Agents SDK, CrewAI, Lyzr 등 다양한 플랫폼으로 내보내거나 실행할 수 있습니다.

이 프로젝트는 Lyzr 팀에 의해 유지 관리되며, 에이전트의 투명성, 재사용성 및 규정 준수(Compliance)를 최우선으로 설계되었습니다.

GitAgent의 주요 특징 (Features)

1. Git 네이티브 아키텍처

에이전트의 모든 변경 사항은 Git 커밋으로 기록됩니다. 브랜치를 통해 에이전트의 새로운 기능을 테스트하고, 문제가 발생하면 이전 버전으로 즉시 롤백할 수 있습니다. git diff를 통해 에이전트의 프롬프트나 기술이 어떻게 변했는지 한눈에 파악할 수 있습니다.

2. 프레임워크 독립성 (Framework-Agnostic)

GitAgent는 특정 AI 프레임워크에 종속되지 않습니다. 하나의 정의를 통해 다음과 같은 다양한 환경으로 내보낼 수 있습니다:

• Claude Code: CLAUDE.md 및 기술 매핑 지원
• OpenAI Agents SDK: Python 코드 및 도구 스터브 생성
• CrewAI: 역할 및 목표 기반의 YAML 구성
• 기타: OpenClaw, Nanobot, Lyzr Studio, GitHub Models 등

3. 실시간 에이전트 메모리 및 상태 관리

에이전트가 실행되는 동안 발생하는 실시간 지식(결정 사항, 일일 로그 등)을 memory/runtime/ 폴더에 기록합니다. Git을 상태 저장소로 활용하여 에이전트의 실행 이력을 추적하고 복구할 수 있는 감사 추적(Audit Trail)을 제공합니다.

4. SkillsFlow: 결정론적 워크플로우

YAML을 통해 기술(Skill), 에이전트, 도구를 체인으로 연결하는 다단계 워크플로우를 정의합니다. LLM의 자의적인 판단이 아닌, 정의된 순서와 데이터 흐름에 따라 안정적으로 작동합니다.

5. 강력한 규정 준수 및 거버넌스

FINRA, SEC, Federal Reserve 등 금융권 수준의 규제 프레임워크를 지원합니다. gitagent audit 명령어를 통해 에이전트의 위험 요소를 점검하고 규정 준수 보고서를 생성할 수 있습니다.

사용 사례 (Use Case)

• 인간 개입형(HITL) 학습: 에이전트가 새로운 기술을 배우거나 메모리를 수정할 때 PR(Pull Request)을 생성하여 사람이 검토 후 병합합니다.
• 에이전트 포킹 및 리믹스: 공개된 에이전트 리포지토리를 포크하여 자신만의 SOUL.md를 추가하고 커스터마이징합니다.
• CI/CD를 통한 에이전트 배포: GitHub Actions에서 gitagent validate를 실행하여 에이전트의 품질을 자동으로 검증하고 배포합니다.
• 모노레포 기반 기술 공유: 루트 폴더의 기술과 컨텍스트를 여러 하위 에이전트가 공유하여 중복 개발을 방지합니다.

사용 방법 (How to Use)

퀵 스타트 가이드

7단계 명령어로 에이전트를 설치하고 실행할 수 있습니다.

1. CLI 설치: $ npm install -g gitagent
2. 에이전트 스캐폴딩: $ gitagent init --template standard
3. 유효성 검사: $ gitagent validate
4. 로컬 에이전트 실행: $ gitagent run -d ./my-agent
5. 특정 어댑터로 실행 (예: GitHub Models): $ gitagent run -a github -p "Review"
6. 타 프레임워크로 내보내기: $ gitagent export --format openai
7. 원격 리포지토리 실행: $ gitagent run -r <repo_url> -a claude

자주 묻는 질문 (FAQ)

Q: GitAgent란 무엇인가요? A: AI 에이전트를 Git 리포지토리 파일 시스템으로 정의하고 관리하는 오픈 표준이자 CLI 도구입니다.

Q: 다른 에이전트 프레임워크와 어떻게 다른가요? A: 특정 런타임에 갇히지 않고 Git의 버전 관리 기능을 활용하여 에이전트를 '코드'처럼 관리할 수 있다는 점이 가장 큰 차별점입니다.

Q: 기술(Skill)은 어떻게 추가하나요? A: skills/ 폴더에 SKILL.md 파일을 작성하거나, gitagent skills install 명령어를 통해 외부 리포지토리의 기술을 가져올 수 있습니다.

Q: 규정 준수(Compliance) 기능은 어떻게 작동하나요? A: agent.yaml에 정의된 규제 맵을 기반으로 gitagent audit을 실행하면 위험 계층별 감사 보고서를 생성합니다.