명령과 가드레일
명령은 반복 작업의 입구이고 hook은 품질과 안전을 강제하는 장치다. 둘을 같이 보여줘야 운영 시스템으로 읽힌다.
Claude command surface
guardrails and session automation scripts
Interfaces brief · portfolio detail
01작업 요약
명령은 반복 작업의 입구이고 hook은 품질과 안전을 강제하는 장치다. 둘을 같이 보여줘야 운영 시스템으로 읽힌다.
이 기준이 흐려지면 페이지가 설명 자료로만 남고, 독자는 어떤 근거와 산출물을 확인해야 하는지 다시 물어봐야 합니다.
02입력 의존성
- Commands: 20ready
Claude command surface
- Hooks: 120ready
guardrails and session automation scripts
- Commands & Guardrails 문서watch
commands와 hooks를 하나의 운영 표면으로 설명
- Evidence Dashboard 보기watch
명령과 hook의 결과를 증거로 요약
03리스크 신호
| Signal | Severity | Meaning | First response |
|---|---|---|---|
01_commands | high | Commands | /agent-retro |
02_hooks | medium | Hooks | Safety: branch-flow-guard, env-file-commit-ban, file-size-limit, ai-commit-msg-ban |
03_운영_판단 | low | 운영 판단 | 명령과 hook이 많아질수록 관리 포인트도 늘어난다. 그래서 이 화면에서는 설치 목록만 보여주지 않고, 어떤 명령이 어떤 증거와 연결되는지 정리하는 방향이 필요하다. |
04반복 절차
Commands
이 페이지를 처음 읽을 때명령은 사용자가 반복적으로 호출하는 작업 입구다. 계획, 리뷰, 커밋, PKB, 동기화, 회고처럼 이름이 명확한 작업을 빠르게 실행하기 위해 둔다.
/agent-retro/code-review/commit/daily-scrumHooks
세부 기준을 검토할 때Hook은 사람이 잊기 쉬운 검증과 안전장치를 자동으로 확인한다. 공개 페이지에서는 모든 스크립트를 나열하기보다 어떤 범주의 가드레일이 있는지 보여주는 편이 낫다.
Safety: branch-flow-guard, env-file-commit-ban, file-size-limit, ai-commit-msg-banEvidence: evidence-required, console-errors-verified, db-query-verifyQuality: code-quality-check, design-quality-gate, codex-review-gateSession: context-snapshot, failure-counter, fix-commit-detector운영 판단
세부 기준을 검토할 때명령과 hook이 많아질수록 관리 포인트도 늘어난다. 그래서 이 화면에서는 설치 목록만 보여주지 않고, 어떤 명령이 어떤 증거와 연결되는지 정리하는 방향이 필요하다.
운영 판단CommandsCommands & Guardrails 문서05역할 분담
| Role | Primary work | Handoff |
|---|---|---|
| Owner | 기준과 공개 범위 유지 | Decision / Boundary notes |
| Builder | 문서, 화면, 실행 산출물 반영 | Implementation notes |
| Reviewer | 누락, 과장, 공개 리스크 검토 | Review findings |
| Maintainer | 변경 후 다음 버전 동기화 | Update queue |
06완료 체크리스트
한 문장으로 설명 가능
이 페이지가 어떤 판단을 돕는지 제목, 요약, 첫 절차에서 바로 읽혀야 합니다.
근거와 산출물 연결
설명만 남기지 않고 기준, 결과물, 다음 페이지가 같은 맥락으로 이어져야 합니다.
공개 가능한 범위 확인
내부 경로, 계정, 고객 정보, 미검증 아이디어가 섞이지 않아야 합니다.
다음 행동이 남음
읽은 사람이 어디를 보고 무엇을 검토하면 되는지 링크와 체크 항목으로 남아야 합니다.