From 68785892291f602f96b93fd21c95b5f9bad0f409 Mon Sep 17 00:00:00 2001
From: manNomi <hanmw110@naver.com>
Date: Sat, 14 Feb 2026 18:39:00 +0900
Subject: [PATCH 1/2] docs: add AGENTS bootstrap and commit-push-pr skill

---
 AGENTS.md                              | 39 +++++++++++++++++++++++
 docs/skills/commit-push-pr-subagent.md | 44 ++++++++++++++++++++++++++
 2 files changed, 83 insertions(+)
 create mode 100644 AGENTS.md
 create mode 100644 docs/skills/commit-push-pr-subagent.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..d472b7d5
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,39 @@
+# AGENTS Knowledge Base
+
+## Project Overview
+
+- Monorepo managed with `pnpm` + `turbo`.
+- Main apps live in `apps/web` (Next.js) and `apps/admin`.
+- Root scripts are orchestrated via Turbo:
+  - `pnpm dev`
+  - `pnpm build`
+  - `pnpm lint`
+  - `pnpm typecheck`
+  - `pnpm ci:check`
+
+## Structure
+
+- `apps/web`: user-facing web app (App Router based).
+- `apps/admin`: admin web app.
+- `packages`: shared package workspace.
+- `docs`: project docs and workflow references.
+
+## Working Rules
+
+- Use `pnpm` as the package manager.
+- Use Node.js `22.x` (see root `package.json`).
+- Follow existing code style and architecture docs before changing behavior.
+- Prefer small, focused changes and preserve current patterns.
+
+## Git / Workflow Notes
+
+- Branch from `main` for new work.
+- Keep commit messages aligned with repository conventions.
+- Run `pnpm typecheck` (and relevant app checks) before push.
+
+## Architecture References
+
+- High-level architecture: `ARCHITECTURE.md`.
+- Web app auth/details: `apps/web/AUTHENTICATION.md`.
+- Web component guidance: `apps/web/COMPONENTS.md`.
+- Team workflow: `docs/development-workflow.md` and `CLAUDE.md`.
diff --git a/docs/skills/commit-push-pr-subagent.md b/docs/skills/commit-push-pr-subagent.md
new file mode 100644
index 00000000..623c842b
--- /dev/null
+++ b/docs/skills/commit-push-pr-subagent.md
@@ -0,0 +1,44 @@
+# Skill: Commit + Push + PR Subagent
+
+## Goal
+
+한 번의 실행으로 변경사항을 커밋하고, 원격에 푸시한 뒤, PR까지 생성한다.
+
+## Inputs
+
+- `branch`: 작업 브랜치명 (예: `parser`)
+- `base`: PR 기준 브랜치 (기본값 `main`)
+- `title`: PR 제목
+- `summary`: PR 본문 요약 bullet (1~3개)
+
+## Required Checks
+
+1. 작업 브랜치 확인: `git branch --show-current`
+2. 변경사항 확인: `git status --short --branch`, `git diff --stat`
+3. 커밋 스타일 준수: 저장소 규칙(`<type>: <subject>`) 사용
+
+## Execution Steps
+
+```bash
+git add <files>
+git commit -m "docs: add commit-push-pr subagent skill"
+git push -u origin <branch>
+gh pr create --base <base> --head <branch> --title "<title>" --body "$(cat <<'EOF'
+## Summary
+- <summary bullet 1>
+- <summary bullet 2>
+EOF
+)"
+```
+
+## Safety Rules
+
+- 이미 원격에 있는 브랜치라도 강제 푸시(`--force`)는 기본적으로 사용하지 않는다.
+- 커밋에는 의도하지 않은 생성 산출물(`.output`, `.next`, `node_modules`)을 포함하지 않는다.
+- PR 생성 전 `git status`가 clean인지 확인한다.
+
+## Output Contract
+
+- 생성된 커밋 해시
+- 푸시 결과(업스트림 연결 여부)
+- PR URL

From 824803ae3e2f0127ba3af666ee5cf1bcfd585ca0 Mon Sep 17 00:00:00 2001
From: manNomi <hanmw110@naver.com>
Date: Sat, 14 Feb 2026 18:43:30 +0900
Subject: [PATCH 2/2] =?UTF-8?q?docs:=20=EC=BB=A4=EB=B0=8B/PR=20=ED=95=9C?=
 =?UTF-8?q?=EA=B5=AD=EC=96=B4=20=EC=9E=91=EC=84=B1=20=EA=B7=9C=EC=B9=99=20?=
 =?UTF-8?q?=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md                              |  1 +
 docs/skills/commit-push-pr-subagent.md | 15 +++++++++++----
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index d472b7d5..622e7e6d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -29,6 +29,7 @@
 
 - Branch from `main` for new work.
 - Keep commit messages aligned with repository conventions.
+- Write commit messages and PR title/body in Korean by default.
 - Run `pnpm typecheck` (and relevant app checks) before push.
 
 ## Architecture References
diff --git a/docs/skills/commit-push-pr-subagent.md b/docs/skills/commit-push-pr-subagent.md
index 623c842b..4ef92ff9 100644
--- a/docs/skills/commit-push-pr-subagent.md
+++ b/docs/skills/commit-push-pr-subagent.md
@@ -16,17 +16,18 @@
 1. 작업 브랜치 확인: `git branch --show-current`
 2. 변경사항 확인: `git status --short --branch`, `git diff --stat`
 3. 커밋 스타일 준수: 저장소 규칙(`<type>: <subject>`) 사용
+4. 커밋 메시지와 PR 제목/본문은 한국어로 작성
 
 ## Execution Steps
 
 ```bash
 git add <files>
-git commit -m "docs: add commit-push-pr subagent skill"
+git commit -m "docs: 커밋/푸시/PR 서브에이전트 스킬 문서 추가"
 git push -u origin <branch>
 gh pr create --base <base> --head <branch> --title "<title>" --body "$(cat <<'EOF'
-## Summary
-- <summary bullet 1>
-- <summary bullet 2>
+## 요약
+- <요약 항목 1>
+- <요약 항목 2>
 EOF
 )"
 ```
@@ -42,3 +43,9 @@ EOF
 - 생성된 커밋 해시
 - 푸시 결과(업스트림 연결 여부)
 - PR URL
+
+## Language Policy
+
+- 커밋 메시지는 한국어를 기본으로 사용한다.
+- PR 제목과 본문은 한국어로 작성한다.
+- 영문 용어가 필요한 경우에도 설명 문장은 한국어로 유지한다.