@agentsmd/preset-git 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 이태경
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,8 @@
-# Temporary Holding Version
+# @agentsmd/preset-git
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[`agentsmd`](https://www.npmjs.com/package/agentsmd)의 공통 Git 작업 규칙 프리셋입니다. 언어 프리셋(`java`, `typescript`)을 설치하면 함께 설치됩니다.
+
+- 문서: Git 작업 규칙(이슈 → 브랜치 → PR → merge 커밋), 에이전트 작업 흐름, 리뷰 반영 기준, 문체
+- 훅: `commit-msg`(형식·50자·마침표·AI 서명), `pre-commit`(커밋당 파일 수, 언어별 검사 실행)
+- GitHub: PR 규칙 검사 워크플로, 이슈·PR 템플릿
+- Claude Code 설정: 훅 우회와 force push 차단

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 언어와 무관한 Git 작업 규칙 프리셋.
+ *
+ * 이슈 → 브랜치 → PR → merge 커밋 흐름, 에이전트의 커밋 단위 작업 방식, 커밋 훅, PR 규칙 검사를 담는다.
+ * 문서 지도(AGENTS.md)는 언어 프리셋이 가지므로 단독으로 설치하지 않고 언어 프리셋이 요구한다.
+ */
+export declare const gitPreset: {
+    name: string;
+    description: string;
+    filesDir: string;
+    hooksPath: string;
+    nextSteps: string[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,eAAO,MAAM,SAAS;;;;;;CAUJ,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+import { fileURLToPath } from "node:url";
+/**
+ * 언어와 무관한 Git 작업 규칙 프리셋.
+ *
+ * 이슈 → 브랜치 → PR → merge 커밋 흐름, 에이전트의 커밋 단위 작업 방식, 커밋 훅, PR 규칙 검사를 담는다.
+ * 문서 지도(AGENTS.md)는 언어 프리셋이 가지므로 단독으로 설치하지 않고 언어 프리셋이 요구한다.
+ */
+export const gitPreset = {
+    name: "git",
+    description: "Git 작업 흐름 문서, 커밋 훅, Conventions 검사, 이슈·PR 템플릿",
+    filesDir: fileURLToPath(new URL("../files", import.meta.url)),
+    hooksPath: ".githooks",
+    nextSteps: [
+        "GitHub 저장소 설정에서 머지 방식을 'Create a merge commit'만 허용하세요.",
+        "main 브랜치 룰셋의 필수 체크에 Conventions를 추가하세요.",
+        "지침 도입 커밋만 파일 수 한도를 올려 한 번에 커밋하세요: HARNESS_MAX_FILES=99 git commit ...",
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,+CAA+C;IAC5D,QAAQ,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE;QACT,wDAAwD;QACxD,yCAAyC;QACzC,uEAAuE;KACxE;CACe,CAAC"}

package/files/.claude/settings.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "attribution": {
+    "commit": "",
+    "pr": ""
+  },
+  "includeCoAuthoredBy": false,
+  "permissions": {
+    "deny": [
+      "Bash(git commit --no-verify:*)",
+      "Bash(git commit -n:*)",
+      "Bash(git push --force:*)",
+      "Bash(git push -f:*)",
+      "Bash(git push origin main:*)"
+    ]
+  }
+}

package/files/.githooks/commit-msg

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+#
+# 커밋 메시지 검사 훅.
+#   - 형식: <타입>: <요약>  (scope 를 쓰지 않는다)
+#   - 제목 50자 이내, 마침표로 끝나지 않음
+#   - AI 서명 금지
+#
+# 타입 목록은 .github/workflows/conventions.yml 의 TYPES 와 같게 유지한다.
+# 사용: .githooks/commit-msg <메시지 파일>
+# 규칙: docs/git-conventions.md
+
+set -euo pipefail
+
+msg_file="$1"
+
+# 한글 제목 길이를 바이트가 아니라 글자 수로 세기 위해 UTF-8 로케일을 쓴다.
+# macOS 는 C.UTF-8, Ubuntu 는 C.utf8 로 표기가 달라서 실제 목록에서 찾는다.
+utf8_locale="$(locale -a 2>/dev/null | grep -iE '^(c|en_us)\.utf-?8$' | head -n 1 || true)"
+if [ -n "$utf8_locale" ]; then
+  export LC_ALL="$utf8_locale"
+fi
+
+# git 이 넣는 주석(#) 줄은 실제 메시지가 아니므로 제외한다.
+message="$(grep -v '^#' "$msg_file" || true)"
+subject="$(printf '%s\n' "$message" | head -n 1)"
+
+fail() {
+  echo "commit-msg: $1" >&2
+  echo "  제목: $subject" >&2
+  echo "  규칙: docs/git-conventions.md" >&2
+  exit 1
+}
+
+# git 이 자동 생성하는 메시지는 형식 검사 대상이 아니다.
+if [[ "$subject" =~ ^(Merge|Revert|fixup!|squash!|amend!) ]]; then
+  exit 0
+fi
+
+types='feat|fix|refactor|test|docs|chore|ci|build'
+pattern="^(${types}): .+"
+
+if ! [[ "$subject" =~ $pattern ]]; then
+  fail "형식이 '<타입>: <요약>' 이 아닙니다. 타입: ${types//|/, }"
+fi
+
+if [ "${#subject}" -gt 50 ]; then
+  fail "제목이 50자를 넘습니다. (${#subject}자)"
+fi
+
+if [[ "$subject" == *. ]]; then
+  fail "제목을 마침표로 끝내지 않습니다."
+fi
+
+# 사람이 쓴 커밋처럼 보이도록 AI 도구 서명을 막는다. (docs/writing-style.md)
+if printf '%s\n' "$message" | grep -qiE 'co-authored-by:.*(claude|anthropic)|generated with.*claude|🤖'; then
+  fail "AI 서명이 포함돼 있습니다. 해당 줄을 지우세요."
+fi
+
+exit 0

package/files/.githooks/pre-commit

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+#
+# 커밋 단위를 작게 유지하기 위한 pre-commit 훅.
+#   1. 스테이징된 파일 수가 HARNESS_MAX_FILES(기본 5)를 넘으면 커밋을 막는다.
+#   2. .githooks/pre-commit.d/ 에 언어 프리셋이 넣은 검사를 이름 순서로 실행한다.
+#
+# 나누면 빌드가 깨질 때만 한도를 올린다: HARNESS_MAX_FILES=6 git commit ...
+# 규칙: docs/workflow.md
+
+set -euo pipefail
+
+max_files="${HARNESS_MAX_FILES:-5}"
+
+# 병합 충돌 해결 커밋은 여러 파일이 섞일 수밖에 없으므로 검사하지 않는다.
+if git rev-parse -q --verify MERGE_HEAD >/dev/null; then
+  exit 0
+fi
+
+if ! [[ "$max_files" =~ ^[0-9]+$ ]] || [ "$max_files" -lt 1 ]; then
+  echo "pre-commit: HARNESS_MAX_FILES 는 1 이상의 정수여야 합니다. (현재: $max_files)" >&2
+  exit 1
+fi
+
+# -M: 파일 이동(rename)은 삭제+추가 두 개가 아니라 하나로 센다.
+staged="$(git diff --cached --name-only -M)"
+count="$(printf '%s' "$staged" | grep -c . || true)"
+
+if [ "$count" -gt "$max_files" ]; then
+  echo "pre-commit: 스테이징된 파일 ${count}개 (한도 ${max_files}개)" >&2
+  printf '%s\n' "$staged" | sed 's/^/  - /' >&2
+  echo "" >&2
+  echo "  책임별로 커밋을 나누세요: git restore --staged <file>" >&2
+  echo "  나누면 빌드가 깨진다면: HARNESS_MAX_FILES=${count} git commit ..." >&2
+  exit 1
+fi
+
+# 언어별 검사(포맷 등)는 언어 프리셋이 pre-commit.d 에 넣는다. 실행 권한이 있는 파일만 실행한다.
+checks_dir="$(dirname "$0")/pre-commit.d"
+if [ -d "$checks_dir" ]; then
+  for check in "$checks_dir"/*; do
+    if [ -f "$check" ] && [ -x "$check" ]; then
+      "$check"
+    fi
+  done
+fi
+
+exit 0

package/files/.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,43 @@
+name: 버그
+description: 기대와 다르게 동작하는 문제
+title: 'fix: '
+labels: [bug]
+body:
+  - type: textarea
+    id: actual
+    attributes:
+      label: 현상
+      description: 무엇이 잘못 동작하나. 화면 캡처, 로그, 오류 메시지가 있으면 붙인다
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: 재현 방법
+      placeholder: |
+        1.
+        2.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: 기대 동작
+    validations:
+      required: true
+  - type: input
+    id: platform
+    attributes:
+      label: 기기·브라우저·OS
+      description: 화면이나 클라이언트 문제일 때 적는다
+      placeholder: 예) iPhone 15 Safari, macOS Chrome
+  - type: dropdown
+    id: env
+    attributes:
+      label: 환경
+      options:
+        - 로컬
+        - 개발 서버
+        - 운영
+    validations:
+      required: true

package/files/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

package/files/.github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,28 @@
+name: 기능
+description: 기능 추가·변경, 리팩터링, 설정 등 버그가 아닌 작업
+title: 'feat: '
+labels: [enhancement]
+body:
+  - type: textarea
+    id: background
+    attributes:
+      label: 배경
+      description: 왜 이 작업이 필요한가
+    validations:
+      required: true
+  - type: textarea
+    id: tasks
+    attributes:
+      label: 할 일
+      description: 커밋 단위로 나눈 작업 목록
+      value: |
+        - [ ]
+    validations:
+      required: true
+  - type: textarea
+    id: done
+    attributes:
+      label: 완료 조건
+      description: 무엇이 되면 이 이슈를 닫을 수 있나 (동작, 테스트 등)
+    validations:
+      required: true

package/files/.github/pull_request_template.md

@@ -0,0 +1,29 @@
+<!--
+작성 규칙: docs/git-conventions.md, docs/writing-style.md
+- 짧게, 사실만. 빈 섹션은 지운다.
+- 변경 파일 나열 금지.
+-->
+
+Closes #
+
+## 변경 내용
+
+-
+
+## 확인 방법
+
+<!-- 실행한 검증, 추가·수정한 테스트, 확인한 동작 -->
+
+## 확인할 부분
+
+<!-- 리뷰어가 꼭 봐야 할 지점. 없으면 지운다 -->
+
+## 화면
+
+<!-- 화면이 바뀌었다면 변경 전·후 캡처. 없으면 지운다 -->
+
+## 체크리스트
+
+- [ ] PR 제목이 `<타입>: <한국어 요약>` 형식이다
+- [ ] 커밋 하나에 하나의 책임만 담았다
+- [ ] CI가 통과한다

package/files/.github/workflows/conventions.yml

@@ -0,0 +1,41 @@
+name: Conventions
+
+# docs/git-conventions.md의 브랜치 이름·PR 제목·이슈 연결 규칙을 검사한다
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened]
+
+permissions: {}
+
+jobs:
+  # main 룰셋의 필수 체크 이름이라 바꾸면 룰셋도 같이 고친다
+  conventions:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 규칙 검사
+        # PR 제목과 본문은 사용자가 쓴 값이라 스크립트에 직접 넣지 않고 환경변수로 넘긴다
+        env:
+          BRANCH: ${{ github.head_ref }}
+          TITLE: ${{ github.event.pull_request.title }}
+          BODY: ${{ github.event.pull_request.body }}
+          # .githooks/commit-msg 의 types 와 같게 유지한다
+          TYPES: feat|fix|refactor|test|docs|chore|ci|build
+        run: |
+          failed=0
+
+          if [[ ! "$BRANCH" =~ ^($TYPES)/[0-9]+-[a-z0-9]+(-[a-z0-9]+)*$ ]]; then
+            echo "::error::브랜치 이름이 '<타입>/<이슈번호>-<짧은-설명>' 형식이 아닙니다: $BRANCH"
+            failed=1
+          fi
+
+          if [[ ! "$TITLE" =~ ^($TYPES):\ .+ ]]; then
+            echo "::error::PR 제목이 '<타입>: <요약>' 형식이 아닙니다: $TITLE"
+            failed=1
+          fi
+
+          if ! grep -qiE '(^|[^[:alnum:]])closes #[0-9]+' <<< "$BODY"; then
+            echo "::error::PR 본문에 'Closes #<이슈번호>'가 없습니다"
+            failed=1
+          fi
+
+          exit $failed

package/files/docs/code-review.md

@@ -0,0 +1,42 @@
+# 코드 리뷰 반영
+
+사람 리뷰와 AI 리뷰 도구의 코멘트 모두 같은 기준으로 판단한다. 리뷰를 그대로 따르지 않고, 근거를 대서 반영·보류·거절한다.
+
+## 확인
+
+PR 생성 후 사용자가 리뷰 확인을 요청하면 조회한다.
+
+```bash
+gh pr view <PR번호> --json reviews,comments
+gh api repos/{owner}/{repo}/pulls/<PR번호>/comments
+```
+
+- 리뷰가 없으면 "리뷰 없음" 한 줄 보고 후 넘어간다. 대기·재조회하지 않는다.
+- 리뷰 도구가 남기는 변경 요약 코멘트는 판단 대상이 아니다.
+
+## 판단 기준
+
+| 판단 | 기준 |
+| --- | --- |
+| 반영 | 버그, 보안, 예외 누락, 프로젝트 규칙 위반, 명확한 가독성 개선 |
+| 보류 | 맞는 말이지만 PR 범위 밖. 별도 이슈로 분리 제안 |
+| 거절 | 오탐, 취향 차이, 프로젝트 규칙과 충돌, 불필요한 추상화 |
+
+- Nitpick 은 수정 비용이 작고 규칙에 맞을 때만 반영.
+- 판단 근거는 `docs/` 규칙 또는 코드 사실로 댄다.
+
+## 보고 형식
+
+```
+| # | 위치 | 지적 | 판단 | 근거 |
+| 1 | OrderService.java:42 | null 체크 누락 | 반영 | 외부 입력값 |
+| 2 | Order.java:10 | Builder 패턴 제안 | 거절 | 필드 3개, 생성자로 충분 |
+```
+
+## 반영
+
+- 사용자 확인 후 진행한다.
+- 코멘트 하나 = 커밋 하나. 커밋 루프는 [workflow.md](workflow.md) 와 같다.
+- 리뷰 스레드 답글은 사용자 승인 후에만 단다. 짧게 쓴다.
+  - `반영했습니다. (abc1234)`
+  - `PR 범위 밖이라 #15 로 분리했습니다.`

package/files/docs/git-conventions.md

@@ -0,0 +1,90 @@
+# Git 작업 규칙
+
+모든 작업은 **이슈 → 브랜치 → 커밋 → PR → merge 커밋** 순서로 `main`에 붙인다.
+`main`에 직접 커밋·push하지 않는다.
+
+## 1. 이슈
+
+- 작업 전에 GitHub 이슈를 만든다. 기능·버그 템플릿 중 하나를 채운다. 빈 이슈는 만들 수 없다.
+- 이슈 하나는 브랜치 하나, PR 하나로 끝낼 크기로 잡는다. 크면 이슈를 나눈다.
+
+## 2. 브랜치
+
+형식: `<타입>/<이슈번호>-<짧은-설명>` (영어 소문자, 단어는 `-`로 연결)
+
+```sh
+git switch main
+git pull
+git switch -c feat/12-order-cancel
+```
+
+| 타입       | 용도                              |
+| ---------- | --------------------------------- |
+| `feat`     | 기능 추가·변경                    |
+| `fix`      | 버그 수정                         |
+| `refactor` | 동작 변화 없는 구조 개선          |
+| `test`     | 테스트만 추가·수정                |
+| `docs`     | 문서                              |
+| `chore`    | 설정, 의존성 등 기타              |
+| `ci`       | CI 워크플로                       |
+| `build`    | 빌드 설정 (Gradle, Dockerfile 등) |
+
+## 3. 커밋
+
+형식: `<타입>: <한국어 요약>`. 타입은 브랜치 타입과 같은 목록을 쓴다.
+
+- 제목은 50자 이내, 마침표로 끝내지 않는다.
+- 무엇을 왜 바꿨는지 드러나게 쓴다. "~ 추가", "~ 수정", "~ 제거"로 끝낸다.
+- 커밋 하나는 책임 하나만 담는다. 크기는 [workflow.md](workflow.md).
+- 본문은 제목만으로 이유가 안 보일 때만 1~3줄 쓴다. 어떻게 했는지는 diff가 보여 준다.
+- AI 서명, 이모지, 과장 수식어를 쓰지 않는다. → [writing-style.md](writing-style.md)
+
+```
+좋음
+feat: 주문 취소 사유 필드 추가
+fix: 토큰 만료 시 무한 리다이렉트 수정
+
+결제 페이지에서 만료 토큰으로 재진입하면 /login 과 /pay 를 반복함.
+
+나쁨
+feat: 주문 기능 개선 및 코드 품질 향상          ← 모호함
+fix: 인증 로직의 안정성을 강화했습니다.         ← 서술형, 마침표
+feat(order): 주문 취소 사유 필드 추가          ← scope 를 쓰지 않는다
+```
+
+## 4. PR
+
+```sh
+git push -u origin <브랜치>
+gh pr create --base main --title "<커밋과 같은 형식>" --body-file <본문 파일>
+```
+
+- 제목은 커밋 메시지와 같은 형식으로 쓴다.
+- 본문은 PR 템플릿을 채운다. `Closes #<이슈번호>`를 넣어 머지 시 이슈가 자동으로 닫히게 한다.
+- 변경 내용은 3줄 이내 불릿. 변경 파일을 나열하지 않는다. 빈 섹션은 지운다.
+- 커밋 10개, 변경 300줄 이하를 권장한다. 넘으면 PR을 나눈다.
+- CI와 규칙 검사(Conventions)가 통과해야 머지한다. 리뷰 반영 기준은 [code-review.md](code-review.md).
+
+## 5. 머지
+
+- **Create a merge commit**으로 머지한다. squash·rebase 머지는 쓰지 않는다.
+  브랜치의 커밋 이력을 그대로 남기고, 기능 단위로 되돌릴 때 `git revert -m 1 <merge 커밋>`을 쓰기 위해서다.
+- 머지 후 브랜치는 삭제한다.
+- `main`이 앞서 나가면 브랜치에 `main`을 merge해서 충돌을 미리 해결한다. push한 이력은 rebase하지 않는다.
+
+```sh
+git switch feat/12-order-cancel
+git merge main
+```
+
+- `--force` push와 훅 우회(`--no-verify`)는 하지 않는다. 에이전트 설정(`.claude/settings.json`)에서도 막는다.
+
+## 자동 검사
+
+| 위치                 | 검사                                                                  |
+| -------------------- | --------------------------------------------------------------------- |
+| `.githooks/commit-msg` | 커밋 형식, 제목 50자, 마침표, AI 서명                               |
+| `.githooks/pre-commit` | 커밋당 파일 수, `.githooks/pre-commit.d/`의 언어별 검사             |
+| CI `Conventions`     | 브랜치 이름, PR 제목, `Closes #N`. `main` 룰셋의 필수 체크로 건다     |
+
+훅은 `agentsmd init`이 연결한다. 직접 연결하려면 `git config core.hooksPath .githooks`.

package/files/docs/workflow.md

@@ -0,0 +1,51 @@
+# 작업 흐름
+
+## 1. 시작
+
+- 요구사항이 불명확하면 먼저 질문한다.
+- 이슈와 브랜치를 만든다. → [git-conventions.md](git-conventions.md)
+- 커밋 계획을 목록으로 제시하고 승인을 받는다.
+
+```
+1. Order.java, OrderTest.java          — feat: 주문 취소 사유 필드 추가
+2. OrderService.java, OrderServiceTest.java — feat: 주문 취소 로직 추가
+```
+
+## 2. 커밋 루프
+
+1. 커밋 하나에 해당하는 변경을 한다.
+2. 검증한다. (포맷, 빌드, 테스트 — 프로젝트에 있는 것만)
+3. 커밋한다. → [git-conventions.md](git-conventions.md)
+4. 보고하고 **멈춘다.**
+
+보고 형식:
+
+```
+커밋: feat: 주문 취소 사유 필드 추가
+파일: src/main/java/.../Order.java, src/test/java/.../OrderTest.java
+다음: OrderService 에 취소 로직 추가 (2/2)
+```
+
+- 사용자가 진행 또는 피드백을 주기 전까지 다음 커밋을 하지 않는다.
+- 피드백 반영은 새 커밋으로 한다.
+- `--amend` 는 사용자가 요청하고, push 전일 때만 쓴다.
+
+## 3. 커밋 크기
+
+- 커밋 하나는 책임 하나. 파일은 5개 이하.
+- 대상 코드와 그 테스트는 같은 커밋에 둘 수 있다.
+- 5개를 넘기면 책임별로 커밋을 나눈다. 나누면 빌드가 깨질 때만 `HARNESS_MAX_FILES=<n> git commit ...` 로 실행하고, 보고에 이유를 한 줄 적는다.
+- `pre-commit` 훅이 파일 수를 검사한다. (기본 한도 5)
+
+## 4. PR
+
+- 계획한 커밋이 끝나면 push 후 PR 을 만든다. → [git-conventions.md](git-conventions.md)
+- PR 링크를 보고하고 멈춘다.
+- 리뷰 확인은 [code-review.md](code-review.md).
+
+## 금지
+
+- 멈추지 않고 커밋 여러 개 연속 실행
+- 요청 없는 리팩터링·정리 작업 끼워 넣기
+- `--no-verify` 등 훅 우회
+- main 직접 커밋·push

package/files/docs/writing-style.md

@@ -0,0 +1,42 @@
+# 문체
+
+## md 문서
+
+- 개조식. 한 줄에 규칙 하나.
+- 배경, 사연, 도입부, 맺음말 쓰지 않는다. 규칙만 쓴다.
+- 문장은 "~한다", "~하지 않는다" 로 끝낸다.
+- 설명이 길어지면 표·예시 코드로 바꾼다.
+- 문서 하나 150줄 이내. 넘으면 나눈다. (코드 예시 모음 문서는 제외)
+- 같은 내용을 여러 문서에 반복하지 않는다. 링크한다.
+
+```
+좋음
+- 커밋 1개 후 멈춘다.
+
+나쁨
+- 효율적인 협업과 원활한 피드백 루프를 위해, 에이전트는 각 커밋이 완료될 때마다
+  작업을 일시 중지하고 사용자의 의견을 기다리는 것이 바람직합니다.
+```
+
+## 커밋·PR·리뷰 답글
+
+사람이 쓴 것처럼 쓴다.
+
+- 짧게. 사실만.
+- 한 일만 쓴다. 기대 효과, 소감 쓰지 않는다.
+- 불릿은 3개 이내.
+
+금지 표현:
+
+| 종류 | 예 |
+| --- | --- |
+| 서사형 도입 | "이번 PR에서는 ~", "~을 통해 ~을 구현하였습니다" |
+| 과장 수식어 | 강력한, 견고한, 원활한, 효율적인, 종합적인, 체계적인, 향상 |
+| 정리 문구 | "요약하면", "결론적으로", "전반적으로" |
+| 장식 | 이모지, 헤더마다 아이콘, 과도한 볼드 |
+| AI 서명 | `Co-Authored-By: Claude`, `Generated with Claude Code`, 🤖 |
+
+## 코드 주석
+
+- [code-style.md](code-style.md) 의 주석 규칙을 따른다.
+- 주석도 짧게. 이유 한 줄이면 충분하다.

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@agentsmd/preset-git",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "언어와 무관한 Git 작업 규칙 프리셋 (작업 흐름 문서, 커밋 훅, Conventions 검사, 이슈·PR 템플릿)",
+  "keywords": [
+    "agents.md",
+    "ai-agent",
+    "git-hooks",
+    "conventional-workflow"
+  ],
+  "homepage": "https://github.com/xoruddl/agentsmd-kit#readme",
+  "bugs": "https://github.com/xoruddl/agentsmd-kit/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xoruddl/agentsmd-kit.git",
+    "directory": "packages/preset-git"
+  },
+  "license": "MIT",
+  "author": "이태경 (https://github.com/xoruddl)",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "files"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agentsmd/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
 }