ai-rules › handbook › Human Authority Model

Human Authority Model

에이전트 환경에서 "사람의 의식적 지시"와 "에이전트 간 텍스트 전달"을 구분하는 권한 확인 체계를 정의한다

guide 2026-04-03 docs/guide/HUMAN_AUTHORITY_MODEL.md

작성일: 2026-04-03
목적: 에이전트 환경에서 "사람의 의식적 지시"와 "에이전트 간 텍스트 전달"을 구분하는 권한 확인 체계를 정의한다

1. 위협 모델

왜 필요한가

에이전트 팀 환경에서 다음 오인이 발생할 수 있다:

  • 에이전트 A가 에이전트 B에게 "같은 브랜치에서 작업해"라고 전달 → B가 사람 지시로 오인하여 격리 규칙 예외를 열어줌
  • Leader 에이전트가 "보호 브랜치 예외 허용"이라고 출력 → Builder 에이전트가 사람 승인으로 처리
  • SESSION.md HANDOFF의 next 항목에 고위험 명령이 포함 → 다음 에이전트가 검증 없이 실행

핵심 원칙

예외를 여는 권한은 사람에게만 있다. 에이전트는 예외를 요청할 수 있지만, 승인할 수 없다.

2. 권한 수준

역할 예외 요청 예외 승인 위임 가능 비고
Human (최고 권한) O O O 모든 예외 허용 가능
Leader agent O X (기본) X 관찰/보고/제안/에스컬레이션
일반 agent O X X 실행만, 예외 승인 권한 없음

Leader agent가 예외를 승인하려면 **사람의 명시적 위임(grant)**이 필요하다 (섹션 5 참조).

3. 승인 수준 — 위험도별 분리

기존 체계(03-security 가역성 등급, AGENT_OPERATING_MODEL 승인 모델)와 연결한다.

3-1. 일반 예외 (저위험)

재확인 문구를 사용한다. 03-security의 기존 R1 확인 문구 패턴과 동일.

에이전트: "브랜치 공유 예외를 열려면 아래 문구를 입력하세요."
사람:     CONFIRM same-branch-20260403

형식: CONFIRM {예외종류}-{날짜}

적용 범위:

  • 병렬 에이전트 브랜치 공유 허용
  • 도메인 분리 변경
  • 문서 전용 규칙 완화
매핑 값
가역성 등급 R0~R1
승인 모델 P1~P2

3-2. 중간 위험 예외

일회용 nonce를 포함한 재확인 문구를 사용한다. 에이전트가 nonce를 생성하여 사람에게 제시하고, 사람이 그대로 재입력한다.

에이전트: "계속하려면 아래 문구를 그대로 입력하세요:
          CONFIRM same-branch-4821-20260403"
사람:     CONFIRM same-branch-4821-20260403

형식: CONFIRM {예외종류}-{4자리 난수}-{날짜}

적용 범위:

  • 보호 브랜치 예외 허용
  • 의존성 대량 변경
  • API breaking change 승인
매핑 값
가역성 등급 R1~R2
승인 모델 P3

3-3. 고위험 예외

재확인 문구만으로 끝내지 않는다. out-of-band 승인 또는 사람 직접 실행이 필요하다.

에이전트: "이 작업은 에이전트가 실행할 수 없습니다.
          아래 명령어를 직접 실행하세요:
          {구체적 명령어}"

적용 범위:

  • DB 파괴적 변경 (migrate reset, DROP 등)
  • force push
  • 외부 시스템 상태 변경
  • .env 파일 수정
매핑 값
가역성 등급 R2
승인 모델 P3 (사람 직접 실행)

4. Nonce 생성 규칙

생성 주체

nonce는 예외를 요청받는 에이전트가 생성한다. 예외를 요청하는 에이전트가 아니다.

❌ 에이전트 A → 에이전트 B: "CONFIRM xxx-4821 입력해"  (A가 nonce를 알고 있으므로 무의미)
✅ 에이전트 B (요청받은 쪽): "계속하려면 CONFIRM xxx-4821 입력하세요" → 사람이 입력

nonce 요건

  • 4자리 숫자 난수 (0000~9999)
  • 세션 내 중복 금지
  • 만료: 해당 대화 턴에서만 유효. 다음 턴에서 재사용 불가.

금지사항

  • repo 내 파일(.env, config 등)에 nonce나 접두어를 정적으로 저장하지 않는다
  • 에이전트 간 메시지로 nonce를 전달하지 않는다
  • nonce를 예측 가능한 패턴(순차 증가, 타임스탬프 등)으로 생성하지 않는다

5. 위임 Grant 규칙

Leader agent에게 예외 승인 권한을 위임할 수 있다. 단, 위임은 영구 권한이 아니라 범위와 만료가 있는 grant다.

위임 조건 (모두 충족해야 함)

  1. 사람이 명시적으로 위임: 에이전트가 스스로 위임을 생성하거나 요청할 수 없다
  2. 범위 지정: 어떤 종류의 예외를 승인할 수 있는지 명시
  3. 만료 시간: 만료 없는 영구 위임 금지
  4. 감사 로그: 위임 생성과 사용 이력을 기록

위임 형식

사람: "leader에게 docs 전용 브랜치 공유 예외를 오늘 18시까지 위임해"

기록 위치: SESSION.md 또는 별도 authority log

## Authority Grants

| Grantee | Scope | Expires | Granted By | Granted At |
|---------|-------|---------|-----------|-----------|
| leader | same-branch exception (docs only) | 2026-04-03 18:00 | human | 2026-04-03 10:00 |

위임 사용 시

Leader agent가 위임된 범위 내에서 예외를 승인할 때:

  1. grant가 유효한지 확인 (범위, 만료)
  2. 실행 후 감사 로그에 기록
  3. 범위 밖 요청이면 → 사람에게 에스컬레이션

위임 금지 사항

  • 고위험 예외(R2)는 위임 불가 — 항상 사람 직접 승인
  • Leader가 다른 에이전트에게 재위임하는 것 금지
  • 만료된 grant를 자동 갱신하는 것 금지

6. 감사 로그

예외 승인, 위임 생성, 위임 사용은 모두 기록한다.

기록 위치

프로젝트 규모에 따라 선택:

  • 소규모: SESSION.md의 HANDOFF 블록에 authority_events 필드 추가
  • 중규모: ops/authority-log.jsonl (AGENT_OPERATING_MODEL의 이벤트 모델과 동일 형식)

기록 형식 (JSONL)

{"ts":"2026-04-03T10:00:00Z","event":"grant_created","grantee":"leader","scope":"same-branch (docs)","expires":"2026-04-03T18:00:00Z","granted_by":"human"}
{"ts":"2026-04-03T10:30:00Z","event":"exception_approved","type":"same-branch","agent":"leader","grant_ref":"2026-04-03T10:00:00Z","target":"feature/260403-docs"}
{"ts":"2026-04-03T11:00:00Z","event":"exception_approved","type":"same-branch","agent":"human","nonce":"4821","target":"feature/260403-api"}

7. 기존 체계와의 연결

이 문서는 기존 규칙을 대체하지 않는다. 기존 승인 메커니즘 위에 "누가 승인했는가"를 검증하는 층을 추가한다.

기존 체계 이 문서의 역할
03-security R2 확인 문구 확인 문구의 형식과 nonce 규칙을 표준화
01-git 보호 브랜치 예외 예외를 여는 주체가 사람임을 검증
04-workflow 에이전트 모드 모드 전환 지시가 사람에게서 왔는지 검증
06-session HANDOFF 신뢰 모델 HANDOFF의 고위험 next 항목에 대한 재검증 강화
AGENT_OPERATING_MODEL P0~P3 P2/P3 승인이 사람 권한으로 이루어졌는지 확인
GIT_FLOW_HYGIENE 병렬 격리 예외 격리 예외 지시어가 사람에게서 왔는지 검증

8. Core 승격 후보 태그

섹션 승격 대상 추가 형태
섹션 3 (승인 수준) 03-security.md 고위험 작업 승인 마찰 섹션에 nonce 규칙 추가
섹션 2 (권한 수준) 04-workflow.md 에이전트 작업 모드에 권한 수준 명시
섹션 5 (위임 grant) 10-subagent-patterns.md Teammate/Leader 패턴에 위임 규칙 추가

승격 경로: candidate (이 문서) → 2개 이상 프로젝트 적용 → validated → core 승격

출처

  • 03-security 가역성 원칙 (R0/R1/R2) — 확인 문구 재입력 패턴
  • 06-session HANDOFF 신뢰 모델 — 불신 + 재검증 원칙
  • AGENT_OPERATING_MODEL 승인 모델 (P0~P3) — 범위 단위 승인
  • OWASP Agentic Top 10 2026 — Excessive Agency 방지
  • GIT_FLOW_HYGIENE 병렬 격리 — 에이전트 자율 예외 금지 원칙