docs: Git 커밋 규칙 문서화 및 architecture.md 연결
External/Aurora/bin 커밋 예외, .gitignore 자체 커밋(-f) 규칙을 GIT_RULES.md로 정리하고 architecture.md에 @import 연결 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
7f464ab2af
commit
de0c1c20df
70
docs/GIT_RULES.md
Normal file
70
docs/GIT_RULES.md
Normal file
@ -0,0 +1,70 @@
|
|||||||
|
# Git 커밋 규칙 — ILSOS 프로젝트
|
||||||
|
|
||||||
|
## 1. 빌드 산출물(bin) 무시 규칙
|
||||||
|
|
||||||
|
`.gitignore`는 전역적으로 빌드 산출물을 커밋에서 제외한다.
|
||||||
|
|
||||||
|
```
|
||||||
|
obj/
|
||||||
|
bin/
|
||||||
|
```
|
||||||
|
|
||||||
|
- `bin/` 은 폴더명이 `bin` 인 모든 디렉터리를 무시한다.
|
||||||
|
- 그 외 프로젝트별 산출물 경로(`_out_*`, `_intermediate/` 등)도 무시 대상이다.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 예외: External/Aurora/bin 은 전체 커밋
|
||||||
|
|
||||||
|
`External/Aurora/bin` 는 외부 Aurora 런타임 산출물로, **전체를 git에 커밋**한다.
|
||||||
|
전역 `bin/` 무시 규칙은 그대로 두고, negation(`!`)으로 해당 폴더만 다시 포함한다.
|
||||||
|
|
||||||
|
### `.gitignore` 설정
|
||||||
|
|
||||||
|
```
|
||||||
|
bin/
|
||||||
|
|
||||||
|
# 예외: External/Aurora 폴더의 bin은 전체 커밋
|
||||||
|
!/External/Aurora/bin/
|
||||||
|
!/External/Aurora/bin/**
|
||||||
|
```
|
||||||
|
|
||||||
|
- `!/External/Aurora/bin/` — 무시된 `bin` 디렉터리 자체를 다시 포함한다.
|
||||||
|
- `!/External/Aurora/bin/**` — 그 하위의 모든 파일/폴더를 다시 포함한다.
|
||||||
|
- 두 줄 모두 필요하다. 디렉터리만 negation 하면 git이 하위로 내려가지 않아 파일이 포함되지 않는다.
|
||||||
|
|
||||||
|
### 검증 방법
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# bin 폴더가 더 이상 무시되지 않는지 확인 (negation 규칙 라인이 출력되어야 함)
|
||||||
|
git check-ignore -v External/Aurora/bin/
|
||||||
|
|
||||||
|
# 스테이징
|
||||||
|
git add External/Aurora/bin
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. `.gitignore` 자체 커밋
|
||||||
|
|
||||||
|
`.gitignore` 는 다음 라인으로 **자기 자신을 무시**한다.
|
||||||
|
|
||||||
|
```
|
||||||
|
/.gitignore
|
||||||
|
```
|
||||||
|
|
||||||
|
따라서 `.gitignore` 변경분을 커밋하려면 `-f` 로 강제 추가해야 한다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git add -f .gitignore
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 빠른 참조
|
||||||
|
|
||||||
|
| 대상 | 처리 |
|
||||||
|
|------|------|
|
||||||
|
| 일반 `bin/` 산출물 | 무시 (커밋 안 함) |
|
||||||
|
| `External/Aurora/bin` | 전체 커밋 (negation 예외) |
|
||||||
|
| `.gitignore` 수정 | `git add -f .gitignore` |
|
||||||
@ -1,4 +1,4 @@
|
|||||||
# ILSOS 프로젝트 아키텍처
|
# ILSOS 프로젝트 아키텍처
|
||||||
|
|
||||||
> CLAUDE.md의 "프로젝트 문서" 섹션에서 import하던 개별 문서들을 통합한 아키텍처 문서입니다.
|
> CLAUDE.md의 "프로젝트 문서" 섹션에서 import하던 개별 문서들을 통합한 아키텍처 문서입니다.
|
||||||
> 세부 내용은 각 원본 문서를 참고하세요.
|
> 세부 내용은 각 원본 문서를 참고하세요.
|
||||||
@ -11,6 +11,7 @@
|
|||||||
4. [AuroraDevices 모듈](#4-auroradevices-모듈)
|
4. [AuroraDevices 모듈](#4-auroradevices-모듈)
|
||||||
5. [빌드 출력 경로](#5-빌드-출력-경로)
|
5. [빌드 출력 경로](#5-빌드-출력-경로)
|
||||||
6. [PTOP 분석 하네스](#6-ptop-분석-하네스)
|
6. [PTOP 분석 하네스](#6-ptop-분석-하네스)
|
||||||
|
7. [Git 커밋 규칙](#7-git-커밋-규칙)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -228,3 +229,9 @@ ILSOS_PrismaticRD_PTOP(PtoP)의 3계층 아키텍처, 구현 상세, 빌드 최
|
|||||||
|
|
||||||
**Workspace:**
|
**Workspace:**
|
||||||
- `_workspace/0X_*.md` (분석 결과 저장)
|
- `_workspace/0X_*.md` (분석 결과 저장)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Git 커밋 규칙
|
||||||
|
|
||||||
|
@import ./GIT_RULES.md — bin 무시/예외(External/Aurora/bin), .gitignore 자체 커밋 규칙
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user