Agent Governance Suite

한국어 | English

Agent Governance Suite(AGS)는 Claude Code, Codex, Antigravity(agy)에 설치하는 로컬 플러그인입니다. 에이전트가 요청에 맞는 전문 스킬을 쓰고, 여러 단계의 일을 완료 기준에 따라 진행하며, 사용자의 교정과 남은 일을 이어 가도록 돕습니다. 문서·조사·의사결정·안내물·소프트웨어 작업에 쓸 수 있습니다. 세 호스트는 같은 MCP 서버와 공통 규칙을 쓰며, hook 이벤트·깨우기 방식·설치 형식처럼 호스트마다 다른 부분은 호스트별 어댑터가 맡습니다.

설치 · 사용하기 · 스킬 · 문서

어떤 일에 쓰나요?

Related MCP server: GLOBAL Hybrid MCP v2

구성

• 스킬: 전문 스킬 23개, 흐름을 잇는 orchestrator, 현황판 사용을 돕는 session-board

• 로컬 MCP 서버: workflow, 작업 기록, 현황판, 세션 메시지, 상태 정리 도구

• 호스트 hook: 세션·턴·도구 경계에서 안내를 넣고 편집 대상을 관측합니다.

• 로컬 관리자 페이지: 전역 컨텍스트, 역할, JEV처럼 사람이 정하는 설정을 패스키로 서명해 바꿉니다. 기본 주소는 http://localhost:47615/입니다.

안내가 있다는 사실만으로 에이전트가 지시를 따랐거나 결과가 검증됐다고 볼 수는 없습니다. AGS가 보장하지 않는 것은 사용하기에 있습니다.

설치

필요한 것은 Node.js 24.0.0 이상과 호스트의 플러그인 기능입니다. 협업할 호스트마다 설치합니다. 플러그인을 쓰는 데 이 저장소를 clone하거나 pnpm install을 실행할 필요는 없습니다.

현재 공개 릴리스는 v5.1.1이며 아래 설치 예시는 이 버전 기준입니다. 4.0.0부터 JEV는 관리자 페이지에서만 설정합니다(4.0.0 릴리스 노트의 업그레이드 전 확인). 3.x는 2.x와 호환하지 않습니다. 버전별 변경 사항은 GitHub 릴리스와 docs/release-notes/release-notes-v<버전>.md에 있습니다.

이미 설치했다면 업데이트와 이전을 따릅니다.

패키지와 언어

패키지는 호스트마다 하나입니다. 모델이 읽는 AGS 문구는 언어 설정 없이 문구마다 토큰이 적은 형태 하나로 고정됩니다. 그래서 hook 안내, MCP 도구 설명·결과, 오류, 스킬·hook CLI 출력, 스킬 description은 영어이고 MCP instructions의 공통 접수 기준은 한국어이며, 스킬 본문은 원문(대부분 한국어) 그대로입니다. 3.x의 영어 전용 패키지(agent-governance-suite-en)를 설치했다면 업데이트와 이전을 따릅니다.

Claude Code

Claude Code 안에서 실행하고, 설치 뒤 새 세션을 시작합니다.

/plugin marketplace add jaeseongs95/agent-governance-suite
/plugin install agent-governance-suite@agent-governance-claude

Codex

터미널에서 실행합니다.

codex plugin marketplace add jaeseongs95/agent-governance-suite --ref v5.1.1
codex plugin add agent-governance-suite@agent-governance

새 Codex 세션을 시작한 뒤 /hooks에서 AGS hook을 검토하고 신뢰합니다. 신뢰하기 전에는 플러그인 hook이 실행되지 않아 턴 안내, 작업 기록, 현황판, 메시지 전달이 동작하지 않습니다. hook 정의가 바뀐 판으로 업데이트하면 다시 검토합니다.

Antigravity (agy)

agy plugin install은 로컬 디렉터리만 받습니다. 릴리스에 첨부한 설치본을 받아 풀고 그 디렉터리를 설치합니다. 설치본에는 agy가 읽는 파일만 들어 있습니다. 저장소 전체를 설치하면 Antigravity 앱의 설치됨 화면이 멈출 수 있습니다. 설치하는 동안 Antigravity 앱을 닫아 둡니다. 앱이 켜져 있으면 기존 설치 폴더를 지우지 못해 설치가 실패합니다. Windows에서는 Expand-Archive로 풉니다.

curl -LO https://github.com/jaeseongs95/agent-governance-suite/releases/download/v5.1.1/agent-governance-suite-antigravity-v5.1.1.zip
unzip agent-governance-suite-antigravity-v5.1.1.zip
agy plugin install ./agent-governance-suite
agy plugin list

agy CLI가 없는 Antigravity 네이티브 앱에서는 공식 수동 설치 안내를 따릅니다. 앱을 정상 종료하고 기존 AGS 폴더를 플러그인 검색 경로 밖에 복구용으로 보존한 뒤, 릴리스에 첨부된 Antigravity 설치용 ZIP의 agent-governance-suite 폴더를 ~/.gemini/config/plugins/ 아래에 둡니다(Windows: %USERPROFILE%/.gemini/config/plugins/agent-governance-suite). 앱을 다시 시작하고 Customizations > Installed에서 AGS 버전을 확인합니다. 저장소 전체를 복사하지 마십시오. 이 방식에는 CLI 추가 설치가 필요하지 않습니다.

설치본에는 MCP 서버 등록(mcp_config.json, 서버 이름 ags, AGENT_GOVERNANCE_HOST_ATTESTATION=antigravity)과 hook(hooks.json)이 함께 들어 있어 따로 설정할 것이 없습니다. 이 저장소의 GEMINI.md와 AGENTS.md는 AGS 자체를 개발할 때 쓰는 지침이며 설치본에 들어 있지 않습니다.

설치 뒤 확인

• 새 세션에서 AGS 스킬과 MCP 도구가 보이는지 확인합니다. 보이지 않으면 문제 해결을 봅니다.

• 관리자 페이지(http://localhost:47615/)를 열어 첫 패스키를 등록합니다. 첫 키는 확인 없이 받으므로 먼저 등록해 두는 것이 좋습니다. 관리자 페이지와 컨텍스트

사용하기

원하는 결과와 확인할 조건, 바꾸면 안 되는 대상을 함께 알려 주십시오. 모든 요청에 스킬이나 workflow를 직접 지정할 필요는 없습니다. 에이전트가 요청 목적과 스킬의 적용·제외 조건을 대조하고, 단계가 이어지는 변경에는 workflow를 씁니다.

이 기능을 구현하고 검증해 줘. 수정 범위와 완료 기준을 먼저 정리하고,
최종 결과에는 실제로 실행한 검사와 아직 해결하지 못한 문제를 함께 적어 줘.

설치하면 달라지는 동작, workflow와 편집 관문, 작업 기록은 사용하기에, 여러 세션의 협업은 세션 협업에 있습니다.

스킬

전문 스킬 23개의 버전과 출처는 registry와 source lock을 따릅니다. 이 밖에 흐름을 잇는 orchestrator와 현황판 사용법을 담은 session-board가 있습니다. 작업 기록은 스킬이 아니라 MCP 도구와 hook이 맡습니다.

언제 어떤 스킬을 쓰는지는 사용하기의 스킬을 쓰는 시점에 있습니다.

문서

라이선스

MIT License