github-workflow

Files (1)

• SKILL.md

SKILL.md (first lines)

# GitHub Workflow

이 스킬은 이 프로젝트의 GitHub 운영 전반을 다룬다.

## 언제 사용하나

- 커밋을 만들거나 푸시할 때
- 새 브랜치를 만들 때
- PR을 열거나 정리할 때
- 이슈를 만들거나 업데이트할 때
- 릴리즈/태그를 만들 때
- GitHub 운영 상태를 점검할 때

## 반드시 읽을 파일

1. `.agent/AGENTS.md`
2. `.agent/system/ops/PLAN.md`
3. `.agent/system/ops/PROGRESS.md`
4. `.agent/system/contracts/workspace-contract.md`
5. `.agent/rules/logging.md`
6. `_MOC/_04_증빙_MOC.md`
7. 필요 시 `.agent/skills/workspace-sync/SKILL.md`
8. issue 운영이면 `.agent/skills/github-issue-ops/SKILL.md`
9. project 보드 운영이면 `.agent/skills/github-project-ops/SKILL.md`
10. release 작업이면 `_system/tools/github/release-policy.md`

## 기본 원칙

- GitHub 작업도 증빙의 일부다.
- 의미 있는 GitHub 작업은 `04_증빙/01_핵심로그/`에 남긴다.
- 사용자 승인 없이 destructive action을 하지 않는다.
- `commit/push` 전에는 secret/privacy preflight를 먼저 통과한다.
- release는 기본값이 `draft` 또는 보류다. 사용자가 명시적으로 원할 때만 final로 간다.
- release는 배포만이 아니라 `운영 업데이트 기록`으로도 사용한다.
- GitHub 관련 note, changelog, release note 초안도 Obsidian note 규칙에 맞춰 관리한다.

## 표준 순서

### 1. Preflight

먼저 아래를 확인한다.

1. `git status --short`
2. 현재 브랜치와 원격
3. 변경 범위가 요청과 맞는지
4. 증빙 로그 업데이트 필요 여부
5. `bash _system/tools/github/pre-push-safety-check.sh`

### 2. Commit / Push

커밋 전 체크:

1. 변경 파일이 요청 범위 안에 있는지 확인
2. `PROGRESS.md` 또는 관련 증빙 로그 반영 여부 확인
3. 테스트/검증 가능하면 최소 1개 이상 수행
4. staged diff에 secret, token, credentials, runtime profile이 없는지 확인
5. 커밋 메시지는 의도와 범위를 짧게 설명

푸시 전 체크:

1. 브랜치명이 목적을 설명하는지 확인
2. 원격이 올바른지 확인
3. release 준비가 아닌데 main 직푸시는 피한다
4. `pre-push-safety-check.sh` 결과를 다시 확인한다

### 3. Pull Request

#### 2인 협업 브랜치 규칙 (이승보 + 김주용)

main 브랜치는 직접 push 불가 (브랜치 보호 활성화). 모든 변경은 PR을 통해 병합한다.

**브랜치 네이밍**

```
river/<작업명>    ← 이승보
juyong/<작업명>   ← 김주용
```

예시:
```
river/배포-railway
river/E2E-검증
juyong/AI-리포트
juyong/데모-스크립트
```

**작업 플로우**

```bash
# 1. 항상 최신 main에서 시작
git checkout main && git pull
git checkout -b river/배포-railway

# 2. 작업 후 커밋
git add <파일> && git commit -m "feat: ..."
git push -u origin river/배포-railway

# 3. PR 생성
gh pr create --title "feat: ..." --assignee "@me"

# 4. 상대방이 리뷰 → Approve → Merge (squash 권장)
gh pr merge --squash
```

**PR 본문 최소 항목**

```markdown
## 변경 내용
- 

## 검증
- [ ] 로컬 실행 확인

## 관련 태스크
- 
```

**병렬 작업 시 주의**

From River-181/hagent-os, MIT.

More from River-181/hagent-os