<aside> ⚙️ AI 작업 6 규약 · 이슈/PR 라벨 매핑 · CI 머지 게이트 · Required status check 단일 소스 · 원본: [.claude/rules/07-workflow.md + docs/ci/](https://github.com/EinSofINTEREST/IssueTracker/blob/main/.claude/rules/07-workflow.md + docs/ci/)

</aside>

AI 작업 진행 6 규약

1. 이슈 먼저 (issue-first) — 코드 수정 전 GitHub 이슈 생성. 큰 작업은 메인 + sub-issue 분할 (Sub-issue Relation 활성화)
2. 자율 진행 — 시스템 / destructive / 외부 영향 / 모호 영역만 사용자 확인. 그 외는 묻지 않고 진행
3. Commit-per-TODO — 논리적 변경 단위마다 즉시 commit (몰아치기 금지)
4. PR 자동 생성 — 컨벤션 + 템플릿 준수, Closes #N 명시. 마지막 sub-issue PR 에서 메인도 close
5. 권한 최소화 — 새 permission / 외부 의존성은 작업 필수일 때만
6. Label · Issue Type 필수 — scripts/gh-meta.sh issue / pr 사용. 수동 gh api graphql 금지

자율 진행 — 예외 영역 (반드시 사용자 확인)

• 시스템 변경: apt-get install, sudo systemctl, 시스템 서비스 enable 등
• Destructive: git push --force, branch 삭제, DB DROP, git reset --hard, 무인 PR merge
• 외부 시스템: PR merge / issue close / 배포 / 외부 API 비용 / DM 발송
• 모호한 작업 범위: 다중 해석 가능 / scope 불명확

자율 진행 — 즉시 실행 영역

• 코드 작성 / 수정 / 리팩토링 / 삭제, 테스트 추가
• 새 파일 / 디렉토리 생성, 의존성 추가 (go get)
• 정상 branch 생성 + push (force-push 제외)
• scripts/ 하위 스크립트 실행
• scripts/gh-meta.sh 로 라벨 / type 부여
• lint / fmt / test / build (make 또는 scripts/lint.sh)