Skip to content

docs(agent-rules): main이 움직이는 경로를 하나로 못박는다 - #9

Merged
TurnaboutHero merged 1 commit into
mainfrom
docs/rule-main-merge-path
Aug 5, 2026
Merged

docs(agent-rules): main이 움직이는 경로를 하나로 못박는다#9
TurnaboutHero merged 1 commit into
mainfrom
docs/rule-main-merge-path

Conversation

@TurnaboutHero

Copy link
Copy Markdown
Collaborator

뭘 바꿨나

docs/AGENT_RULES.md §7 한 줄. 1파일 4줄.

- **원격 `main`에는 푸시하지 않는다.** 예외 없음. 브랜치 푸시·PR은 요청받았을 때만 한다.
+ **원격 `main`에 직접 푸시하지 않는다.** 예외 없음.
+ 브랜치 푸시·PR 생성·머지는 **명시적으로 지시받았을 때만** 하고, **머지는 반드시 PR을 경유한다.**
+ 즉 `main`이 움직이는 경로는 하나뿐이다 — **PR → CI 초록 → 사람의 지시.**
+ 이 경로를 지키면 무엇이 왜 들어갔는지가 PR 본문에 남는다. 직접 푸시하면 그게 사라진다.

규칙과 실제 행동이 어긋났습니다. #8을 지시받고 머지했는데, §7은 여전히
"원격 main에는 푸시하지 않는다. 예외 없음"이라고 적혀 있었습니다.

규칙이 현실과 어긋난 채 남는 것 자체가 §8이 경고하는 재료입니다 —
안 지켜지는 조항이 하나 생기면 나머지 조항의 신뢰도가 같이 내려갑니다.
그래서 규칙을 느슨하게 푸는 게 아니라, 금지선을 정확한 자리로 옮깁니다.

금지 대상 "main을 움직이는 것" (사실과 다름) "직접 푸시하는 것"
머지 언급 없음 → 해석 여지 PR 경유 + 명시적 지시일 때만
직접 푸시 금지 그대로 금지

느슨해진 게 아닙니다. 직접 푸시 금지는 그대로고, 머지 경로가 명시됐을 뿐입니다.

덤으로 갈라져 있던 것 하나가 붙습니다

design/README.md:30은 이미 이렇게 적고 있었습니다:

design/ 아래 파일은 main에 직접 푸시하지 않는다. 반드시 브랜치 → PR → 머지.

같은 계약이 두 곳에 선언돼 있었고 §7 쪽만 낡아 있었습니다.
§3("계약이 두 곳에 선언되면 반드시 갈라진다")이 말하는 결함이
규칙 문서 자체에서 일어난 사례라, 이 PR로 두 문구가 일치합니다.


기획 변경일 때

  • 해당 없음 — 절차 규칙 변경이지 기획 변경이 아닙니다

코드 변경일 때

  • 해당 없음 — 코드 파일 0건

날짜와 경위는 규칙 본문에 넣지 않았습니다. 이 파일은 서두에서 스스로
*"절차만 담는다 — 수치·버전·개수는 여기 쓰지 않는다"*고 정하고 있어서,
변경 이력은 커밋 메시지와 이 PR에 둡니다.

🤖 Generated with Claude Code

https://claude.ai/code/session_01CHG1t18Lw1HRS64WVLdnqC

§7이 "원격 main에는 푸시하지 않는다. 예외 없음"이었는데,
PR #8을 지시받고 머지하면서 그 문장과 실제 행동이 어긋났다.

규칙이 현실과 어긋난 채 남는 것 자체가 §8이 경고하는 재료다.
그래서 실제로 하는 일에 맞춰 정확하게 다시 적는다 —
금지되는 건 "main을 움직이는 것"이 아니라 "직접 푸시하는 것"이고,
머지는 PR을 경유해 지시받았을 때만 한다.

이 변경으로 design/README.md:30("main에 직접 푸시하지 않는다.
반드시 브랜치 -> PR -> 머지")과 문구가 일치한다.
같은 계약이 두 곳에 선언돼 갈라져 있었던 것으로, §3이 말하는 유형의
결함이 규칙 문서 자체에서 일어난 사례다.

날짜와 경위는 본문에 넣지 않는다. 이 파일은 서두에서 스스로
"절차만 담는다 - 수치·버전·개수는 여기 쓰지 않는다"고 정하고 있다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CHG1t18Lw1HRS64WVLdnqC
@TurnaboutHero
TurnaboutHero merged commit b9c3979 into main Aug 5, 2026
2 checks passed
@TurnaboutHero
TurnaboutHero deleted the docs/rule-main-merge-path branch August 5, 2026 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant