ai-rules handbook Git Flow Hygiene + Human Authority Model 가이드 추가

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.md Core 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줄로 예상