한국어 | English

시작하기

현재 공개 README의 빠른 체험을 Wiki용으로 정리한 페이지입니다.

요구 사항

• Node.js 24.0.0 이상
• Codex 또는 Claude Code의 플러그인 기능
• 여러 세션을 연결할 경우 동일한 공용 상태 경로에 접근 가능한 환경

최신 설치 명령은 항상 저장소 README를 기준으로 확인하세요.

Claude Code

Claude Code 안에서:

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

설치 후 새 세션을 시작합니다.

Codex

터미널에서 최신 README의 현재 릴리스 버전을 확인한 뒤 marketplace와 plugin을 설치합니다.

설치 후 새 Codex 세션을 시작하고 /hooks에서 설치된 AGS hook을 검토·신뢰해야 문맥 보존, 세션 현황판과 실행 관측 hook이 동작합니다.

첫 단일 작업

AGS를 설치한 뒤 평소처럼 목표와 완료 조건을 요청할 수 있습니다.

예:

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

전문 스킬은 작업 조건에 따라 필요한 capability를 선택합니다.

두 세션 체험

코드 변경 없이 Session Board와 PEER 메시지를 확인하려면 같은 프로젝트를 연 세션 두 개를 준비합니다.

검토 담당

이번 체험에서 너는 검토 담당이야.
AGS 현황판의 현재 작업을
"AGS-DEMO-REVIEW · 테스트 실행 방법 검토"로 기록해 줘.

조사 담당 세션이 PEER 메시지로 검토를 요청하면
전달받은 파일 위치를 직접 읽고 설명이 맞는지 확인해 줘.
ACK를 남기고, 실제 검토 결과는 별도 PEER 메시지로 회신해 줘.
파일 수정이나 테스트 실행은 하지 마.

조사 담당

AGS 현황판의 현재 작업을
"AGS-DEMO-RESEARCH · 테스트 실행 방법 조사"로 기록해 줘.

이 프로젝트의 문서와 설정에서 테스트 실행 방법을 찾아
명령과 근거 파일 위치를 정리해 줘.
파일 수정이나 테스트 실행은 하지 마.

현황판에서 "AGS-DEMO-REVIEW" 담당 세션을 찾고
조회된 host와 session ID로 PEER 메시지를 보내 검토를 요청해 줘.
ACK와 실제 검토 결과를 구분해 줘.

확인할 것

정상 흐름은 다음과 같습니다.

조사
 ↓
PEER message 전송
 ↓
검토 담당 수신
 ↓
ACK
 ↓
근거 직접 확인
 ↓
검토 결과 회신
 ↓
조사 담당 최종 대조

여기서 ACK와 검토 결과는 서로 다른 사건입니다.

자동 깨우기

메시지 본문이 큐에 존재하는 것과 수신 세션이 자동으로 작업을 재개하는 것은 별개입니다.

Codex queue wake 등 host별 설정이 필요할 수 있습니다.

자세한 내용:

• 메시징과 ACK
• Input boundaries
• Session message lifecycle

공용 상태 경로

샌드박스 등으로 기본 경로가 달라지는 경우 모든 참여 host에 같은 절대 경로의 AGENT_GOVERNANCE_SHARED_STATE_DIR를 전달합니다.

경로 문자열만 같게 설정하는 것으로 끝나지 않습니다. 각 host가 실제로 그 위치를 읽고 쓸 수 있어야 합니다.