Git Flow Hygiene + Human Authority Model 가이드 추가
`core/01-git.md`에 금지 명령, 브랜치 규칙, 커밋 규칙은 있지만, 작업 시작 전 소스 현행화, push 전 충돌 사전 확인, 병렬 에이전트 격리 같은 기본 위생 절차가 빠져 있었다. AITEM과 AX-Studio에서는 이미 BRANCH_
changes docs/changes/2026-04-03-git-flow-hygiene.md
배경
core/01-git.md에 금지 명령, 브랜치 규칙, 커밋 규칙은 있지만, 작업 시작 전 소스 현행화, push 전 충돌 사전 확인, 병렬 에이전트 격리 같은 기본 위생 절차가 빠져 있었다. AITEM과 AX-Studio에서는 이미 BRANCH_STRATEGY.md, AI_AGENT_FAILURE_CASEBOOK.md, git-guardian.md에 검증된 패턴이 있었으나 프로젝트별 guide에 흩어져 있었다.
이번에 추가한 것
docs/guide/GIT_FLOW_HYGIENE.md— 도구 중립 + 토큰 비용 인식 형태의 git 위생 절차 가이드docs/guide/HUMAN_AUTHORITY_MODEL.md— 사람 권한 확인 체계 (agent-to-agent 오인 방지, 위험도별 승인, 위임 grant)docs/00_INDEX.mdCore Handbook에 두 문서 링크 추가
의도
- 01-git.md의 "무엇을 해서는 안 되는가"를 "무엇을 먼저 확인해야 하는가"로 보완
- 토큰 비용 인식: 조회/분석 세션에서는 점검을 생략하도록 적용 조건 명시
- 도구 중립: 모든 adapter(Claude Code, Cursor, Windsurf, plain)에서 사용 가능하도록 선언적 표현 사용
- agent-to-agent 지시 오인 방지: 에이전트끼리 주고받는 텍스트와 사람 지시를 구분하는 체계 필요
- 권한 위임은 영구가 아닌 grant(범위+만료+감사) 방식으로 설계
- 향후 core 승격을 위한 태그 내장
Core 승격 후보
| 섹션 | 승격 대상 |
|---|---|
| Pre-Work / Pre-Ship / 브랜치 생성 | 01-git.md |
| 적용 조건 | 04-workflow.md |
| 병렬 에이전트 격리 | 10-subagent-patterns.md |
| 승인 수준 (nonce 규칙) | 03-security.md |
| 권한 수준 / 위임 grant | 04-workflow.md, 10-subagent-patterns.md |
다음 단계
- AITEM, AX-Studio에 먼저 적용 → 2개 프로젝트 검증 후 validated 전환 검토
- core 승격 시 01-git.md에 추가될 분량은 약 10~15줄로 예상