자율 범위를 명시하고 회수
기본은 자율 승인 없음입니다. 필요할 때만 사람이 범위와 종료 조건을 정합니다.
가이드 검토 기준: Holmes-Kit 0.40.0 · 2026-11-05 · 설치 대상: 실행 시점의 latest
CLI·OS·설치 방식을 선택하면 해당 명령만 표시합니다. 이 페이지는 컴퓨터를 검사하거나 명령을 실행하지 않습니다.
AGY CLI 일반 연동은 지원 대상입니다. 0.40.0의 AGY run start는 거절되므로 이 오케스트레이션 편에는 실행할 AGY 시작 절차가 없습니다. 다른 CLI를 직접 선택하거나 기본편을 확인하세요.
준비 사항·검증 범위·설치 방식 비교
시작하기 전에
- 기초 과정을 마친 내 작업 폴더와 연결된 MCP 세션. 이 터미널에서 설치 단계의 HOLMES_CLI 또는 PowerShell HolmesCli 경로를 정의하고 파일·버전을 확인합니다.
- 운영자가 정한 작업 범위·시간·비용·네트워크 제한
자율 상태를 확인하고 허용 밖 요청은 거절 또는 공식 검토로 돌립니다.
0.40.0 문서 기준 · 2026-11-04 릴리스 계약 검토. 네이티브 실행 근거는 2026-11-01의 0.39.0 기록입니다. macOS 독립 작업 폴더에서 Codex·Claude의 읽기 전용 binding 일치를 관찰했습니다. Claude 훅 이벤트는 있으나 routing 미검증, Codex 훅은 미관찰입니다. 0.40.0 네이티브 재검증과 승인된 작은 변경의 RED/GREEN 검증은 미완료입니다. Windows/Linux는 문서 안내이며 네이티브 검증이 없습니다.
- 1. 별도 사용자 폴더
- 프로젝트 의존성과 전역 npm 설치를 유지하며 버전별로 관리합니다. 설치 경로·업데이트를 별도로 관리합니다. 연결한 프로젝트가 있으면 폴더를 보존해야 합니다.
- 2. 프로젝트 로컬
- 팀·프로젝트별 버전을 잠금 파일로 관리합니다. 공통 실습에 권장합니다. package.json과 잠금 파일을 변경합니다. 비 Node 프로젝트에는 npm 구성이 추가될 수 있습니다.
- 3. 전역 npm
- 여러 프로젝트에서 공통 설치를 사용하기 편리합니다. 쓰기 권한과 업데이트 영향을 확인합니다. 같은 설치를 공유한 프로젝트들에 영향을 줍니다.
패키지 설치 위치와 AI 도구 설정은 별개입니다. 프로젝트 로컬 설치도 Codex 연결 시 사용자 수준 설정을 변경할 수 있습니다.
단계 1 / 4
현재 권한부터 확인한다
이번 작업에 자율 승인이 필요한지 결정합니다.
내 작업 폴더의 터미널
node "$HOLMES_CLI" autonomy status내 작업 폴더의 터미널
node "$HOLMES_CLI" autonomy status내 작업 폴더의 터미널
node "$HolmesCli" autonomy status예상 결과 — 실제 출력을 직접 확인하세요
- 현재 상태가 명시되고 꺼진 상태를 임의로 켜지 않습니다.
예상과 다르거나 막혔다면
세션을 껐는데 프로젝트 기본값이 여전히 켜져 있습니다.
출력의 남은 권한을 확인하고 운영자가 공식 설정 절차로 해결합니다.
에이전트가 할 일 · 용어 설명
autonomy status를 읽고 활성 범위와 만료, 프로젝트 기본값을 구분합니다.
- MCP
- AI가 Holmes 도구를 호출하는 연결입니다.
- REQ → H-SPEC → A-SPEC → T-SPEC
- 요구 → 상위 설계 → 구현 설계 → 테스트 명세입니다. 실제 반환된 ID를 사용합니다.
- 훅 / binding
- 실행 전후 검사 / 현재 세션이 의도한 프로젝트·서버와 연결됐는지 확인하는 것입니다.
단계 2 / 4
허용할 일과 멈출 조건을 정한다
정확한 작업 폴더, 시간, 요청 수, 비용, 네트워크, push/publish 허용 여부를 결정합니다.
에이전트에게 요청
자율 실행 전에 정확한 root, 시간·비용·요청 수 한도, 네트워크, 복구점, 중단 조건을 제안해. 권한을 직접 발급하지 말고 현재 설치 버전에서 지원되는 사람의 승인 경로를 확인해.예상 결과 — 실제 출력을 직접 확인하세요
- 사람이 검토할 구체적 범위가 있고 기본 push/publish 허용은 없습니다.
예상과 다르거나 막혔다면
전체 디스크나 무제한 네트워크처럼 범위가 너무 넓습니다.
작업에 필요한 최소 경계로 줄이고 범위 밖 작업을 별도 결정으로 남깁니다.
에이전트가 할 일 · 용어 설명
허용 범위를 문서로 제안하고 에이전트가 자기 권한을 발급하지 않습니다.
- MCP
- AI가 Holmes 도구를 호출하는 연결입니다.
- REQ → H-SPEC → A-SPEC → T-SPEC
- 요구 → 상위 설계 → 구현 설계 → 테스트 명세입니다. 실제 반환된 ID를 사용합니다.
- 훅 / binding
- 실행 전후 검사 / 현재 세션이 의도한 프로젝트·서버와 연결됐는지 확인하는 것입니다.
단계 3 / 4
지원되는 경로에서만 실행한다
autonomy full --scope의 범위와 --allow-push, --allow-publish, --no-architecture를 직접 검토합니다. 재발급은 모든 플래그를 교체하므로 유지할 플래그를 모두 명시합니다.
내 작업 폴더의 터미널
node "$HOLMES_CLI" autonomy --help내 작업 폴더의 터미널
node "$HOLMES_CLI" autonomy --help내 작업 폴더의 터미널
node "$HolmesCli" autonomy --help에이전트에게 요청
현재 프로필과 push/publish 플래그를 확인해. full-autonomy.refused라면 요청이 생성되지 않았음을 알리고 운영자가 직접 실행하거나 필요한 플래그로 재발급하도록 안내해. 범위 밖 쓰기와 사람 승인 공백을 차단 보장으로 설명하지 마.예상 결과 — 실제 출력을 직접 확인하세요
- 선택한 프로필의 허용 범위와 실제 차단 한계를 함께 확인합니다.
예상과 다르거나 막혔다면
플래그 누락 또는 현재 하네스의 승인 경로 미검증입니다.
반복 요청이나 우회 대신 운영자가 프로필을 검토합니다. 사람이 필요한 작업은 프로필 회수 후 일반 승인 흐름으로 진행합니다.
에이전트가 할 일 · 용어 설명
훅이 인식하는 실제 실행 명령에서 push/publish 플래그가 없으면 full-autonomy.refused가 반환되며 요청은 생성되지 않습니다. help/dry-run은 통과하지만 push 허용이 없는 force push는 예외입니다. 스크립트 내부처럼 인식하지 못하는 실행까지 차단한다고 보장하지 않습니다. 기존 grant로 해제되지 않습니다. 훅은 사고 예방 장치이며 보안 경계로 검증되지 않았습니다. 범위 밖 일반 쓰기는 차단되지 않는 공백이 있습니다. full 안에서는 사람이 필요한 봉인 계약 수정에도 사람의 승인을 요청할 방법이 없어, 해당 작업 전에 프로필을 회수하고 일반 검토로 돌아가야 합니다.
- MCP
- AI가 Holmes 도구를 호출하는 연결입니다.
- REQ → H-SPEC → A-SPEC → T-SPEC
- 요구 → 상위 설계 → 구현 설계 → 테스트 명세입니다. 실제 반환된 ID를 사용합니다.
- 훅 / binding
- 실행 전후 검사 / 현재 세션이 의도한 프로젝트·서버와 연결됐는지 확인하는 것입니다.
단계 4 / 4
끝난 권한을 회수하고 확인한다
사용한 모드에 맞는 회수를 결정합니다.
내 작업 폴더의 터미널
node "$HOLMES_CLI" autonomy off내 작업 폴더의 터미널
node "$HOLMES_CLI" autonomy off내 작업 폴더의 터미널
node "$HolmesCli" autonomy off내 작업 폴더의 터미널
node "$HOLMES_CLI" autonomy status내 작업 폴더의 터미널
node "$HOLMES_CLI" autonomy status내 작업 폴더의 터미널
node "$HolmesCli" autonomy statusfull 전용 · status의 실제 scope로 대체한 뒤 운영자가 실행
node "$HOLMES_CLI" autonomy full --revoke "<ACTUAL_SCOPE_FROM_STATUS>"full 전용 · status의 실제 scope로 대체한 뒤 운영자가 실행
node "$HOLMES_CLI" autonomy full --revoke "<ACTUAL_SCOPE_FROM_STATUS>"full 전용 · status의 실제 scope로 대체한 뒤 운영자가 실행
node "$HolmesCli" autonomy full --revoke "<ACTUAL_SCOPE_FROM_STATUS>"예상 결과 — 실제 출력을 직접 확인하세요
- 잔여 프로젝트·세션·프로필 권한이 출력에 명확합니다.
예상과 다르거나 막혔다면
off가 0이 아니거나 full 프로필이 남습니다.
출력 이유를 읽고 해당 모드의 공식 회수 명령을 사용합니다. off 한 번으로 모든 권한이 끝났다고 보고하지 않습니다.
에이전트가 할 일 · 용어 설명
일반 세션은 autonomy off, full 프로필은 설치 도움말의 --revoke 경로를 사용하고 status로 남은 권한을 확인합니다.
- MCP
- AI가 Holmes 도구를 호출하는 연결입니다.
- REQ → H-SPEC → A-SPEC → T-SPEC
- 요구 → 상위 설계 → 구현 설계 → 테스트 명세입니다. 실제 반환된 ID를 사용합니다.
- 훅 / binding
- 실행 전후 검사 / 현재 세션이 의도한 프로젝트·서버와 연결됐는지 확인하는 것입니다.
내 프로젝트에 적용
이 문서는 자율 프로필을 발급하거나 실제 무인 실행을 주장하지 않습니다. 내 작업의 제한을 작성하고 현재 하네스가 지원하는 승인 경로를 확인하는 개념 예시입니다.
연결된 사례 ↗내 프로젝트에 적용하기
명세 없는 기존 코드는 도입 편으로, 명세가 있는 프로젝트의 새 변경은 요구 관리 편으로 이어가세요. 다른 심화편은 각 선행 조건을 확인합니다.