docs(agents): AGENTS 지침 문서를 정리한다

docs/20260429_AGENTS정리.md

@@ -0,0 +1,88 @@
+# 20260429 AGENTS 정리
+
+## 개요
+- `AGENTS.md`를 정비한 전체 작업 이력을 하나로 합친 문서다.
+- 작업 범위는 다음 3단계였다.
+  - `oh-my-openagent`, `superpowers`, `andrej-karpathy-skills` 통합
+  - 우선순위 기준 재배치 및 중복 정리
+  - 핵심 규칙 중심 경량화 및 세부 문서 분리
+- 현재 기준의 관련 세부 문서는 아래와 같다.
+  - `docs/agent-guides/build-test-style.md`
+  - `docs/agent-guides/workflow-docs-commits.md`
+  - `docs/agent-guides/safety-repo-rules.md`
+
+## 작업 체크리스트
+- [x] 기존 `AGENTS.md` 구조와 중복 규칙을 분석한다.
+- [x] 공식 `andrej-karpathy-skills` 원문 `CLAUDE.md`를 확인하고 통합한다.
+- [x] 우선순위/충돌 해결/실행 모드 정책을 추가한다.
+- [x] 우선순위 기준으로 섹션을 재배치하고 중복 표현을 줄인다.
+- [x] `AGENTS.md`에는 핵심 규칙만 남기고 세부 규칙은 참조 문서로 분리한다.
+- [x] 관련 작업 문서를 하나로 통합하고 중복 문서를 정리한다.
+
+## 결과 요약
+### 1) 통합
+- `AGENTS.md`에 `CORE EXECUTION PRINCIPLES (andrej-karpathy-skills)`를 공식 원문 그대로 포함했다.
+- `oh-my-openagent`, `superpowers`, 프로젝트 지침 사이의 우선순위와 충돌 해결 규칙을 추가했다.
+
+### 2) 재배치
+- 우선순위가 높은 정책을 상단으로 이동했다.
+- `충돌 해결 규칙`은 `실행 우선순위 및 통합 정책`에 통합했다.
+- 실행 모드/실행 계층/에이전트 동작 규칙은 하나의 묶음으로 정리했다.
+
+### 3) 경량화
+- `AGENTS.md`에는 핵심 원칙, 저장소 요약, 참조 문서 링크, 핵심 금지사항만 남겼다.
+- 빌드/테스트/스타일, 작업 절차/커밋, 보안/저장소 세부 규칙은 `docs/agent-guides/` 아래 별도 문서로 분리했다.
+
+## 검증 기록
+- 2026-04-29
+  - 무엇/왜/어떻게: 기존 `AGENTS.md`의 구조와 중복 규칙을 먼저 확인한 뒤, 공식 `andrej-karpathy-skills` 원문을 raw URL에서 검증하고, 기존 유용한 규칙은 유지한 채 상단에 우선순위/통합 정책 섹션을 추가했다.
+  - 실행 명령/도구:
+    - `read(AGENTS.md)`
+    - `grep("oh-my-openagent|openagent|superpowers|andrej|karpathy|plugin|workflow|우선순위|priority", include="AGENTS.md")`
+    - `webfetch("https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md")`
+    - `task(subagent_type="explore", run_in_background=true)`
+    - `task(subagent_type="librarian", run_in_background=true)`
+    - `apply_patch`
+  - 결과:
+    - 기존 `AGENTS.md`에는 `oh-my-openagent`, `superpowers`, `andrej-karpathy-skills` 관련 명시 섹션이 없음을 확인했다.
+    - 공식 raw `CLAUDE.md` 원문을 확인했고, 영문 본문은 변경 없이 `CORE EXECUTION PRINCIPLES (andrej-karpathy-skills)` 섹션에 삽입했다.
+    - 우선순위 체계, oh-my-openagent 정책, superpowers 정책, 충돌 해결 규칙, 실행 모드를 한국어로 추가했다.
+
+- 2026-04-29
+  - 무엇/왜/어떻게: `AGENTS.md`를 읽고 배경 탐색 결과를 합쳐, 우선순위가 높은 정책을 앞에 배치하고 중복되던 충돌 규칙/실행 계층/에이전트 동작 문장을 상위 섹션으로 흡수하는 방향으로 재배치를 수행했다.
+  - 실행 명령/도구:
+    - `read(AGENTS.md)`
+    - `grep("^## |^### |추측하지 말고|요청 범위를 우선|최소 변경|검증 가능한 결과|commit-policy|한국어|oh-my-openagent|superpowers|CORE EXECUTION PRINCIPLES", include="AGENTS.md")`
+    - `task(subagent_type="explore", run_in_background=true)` x2
+    - `apply_patch`
+    - `grep("^## |^### ", include="AGENTS.md")`
+  - 결과:
+    - `실행 우선순위 및 통합 정책`을 최상단으로 올리고 `충돌 해결 규칙`을 해당 섹션에 통합했다.
+    - `실행 모드`, `oh-my-openagent 사용 정책`, `superpowers 사용 정책`, `에이전트 동작 원칙`을 `실행 원칙 및 계층 사용 정책` 아래로 묶었다.
+    - 중복되던 문장을 줄이고 운영성 정보의 배치를 정리했다.
+
+- 2026-04-29
+  - 무엇/왜/어떻게: `AGENTS.md`는 핵심 정책만 남기고, 긴 운영 규칙은 별도 문서로 분리하기 위해 본문과 배경 탐색 결과를 합쳐 인라인 유지 항목과 분리 항목을 나눈 뒤, 3개 참조 문서와 링크 구조로 재구성했다.
+  - 실행 명령/도구:
+    - `read(AGENTS.md)`
+    - `grep("^## |^### ", include="AGENTS.md")`
+    - `glob("docs/*.md")`
+    - `task(subagent_type="explore", run_in_background=true)` x2
+    - `apply_patch`
+    - `read(수정된 AGENTS.md 및 분리 문서)`
+  - 결과:
+    - `AGENTS.md`에는 우선순위, 커뮤니케이션, `CORE EXECUTION PRINCIPLES`, 실행 계층 정책, 저장소 요약, 참조 문서 링크, 핵심 금지사항만 남겼다.
+    - 빌드/린트/테스트/스타일은 `docs/agent-guides/build-test-style.md`로 분리했다.
+    - 작업 절차/docs/커밋 규칙은 `docs/agent-guides/workflow-docs-commits.md`로 분리했다.
+    - 저장소 세부 규칙/보안/Git 안전 수칙은 `docs/agent-guides/safety-repo-rules.md`로 분리했다.
+
+- 2026-04-29
+  - 무엇/왜/어떻게: `AGENTS.md` 관련 작업 문서가 3개로 쪼개져 있어 관리 비용이 생겨, 같은 날의 연속 작업 이력을 하나의 문서로 합치고 중복 문서를 제거했다.
+  - 실행 명령/도구:
+    - `read(docs/20260429_AGENTS통합정리.md)`
+    - `read(docs/20260429_AGENTS재배치정리.md)`
+    - `read(docs/20260429_AGENTS경량화정리.md)`
+    - `apply_patch`
+  - 결과:
+    - 세 문서의 개요/체크리스트/검증 기록을 하나의 이력 문서로 통합했다.
+    - 중복되던 계획 생성 기록은 단일 문서 기준으로 정리했다.