@agentsmd/preset-java 0.2.0 → 0.3.0

package/README.md

@@ -8,5 +8,6 @@ npx @agentsmd/cli init --preset java       # Java 규칙만
 ```
 
 - Java 코드 규칙 문서: 코드 스타일, 클린 코드 원칙과 예시, Java 체크리스트
-- palantir-java-format(Spotless) 커밋 검사, Gradle CI
-- Git 작업 규칙은 [Git 프리셋](https://www.npmjs.com/package/@agentsmd/preset-git)을 함께 고르면 더해집니다. `AGENTS.md`는 고른 프리셋에 맞춰 만들어집니다.
+- palantir-java-format(Spotless) 설정과 Gradle 검증·CI 명령 문서
+- Git 훅·GitHub 설정은 설치하지 않습니다. CI 문서에는 특정 서비스와 무관하게 실행할 명령만 적습니다.
+- Git 작업 규칙과 훅은 [Git 프리셋](https://www.npmjs.com/package/@agentsmd/preset-git)을 함께 고르면 더해집니다. `AGENTS.md`는 고른 프리셋에 맞춰 만들어집니다.

package/dist/index.d.ts

@@ -1,15 +1,14 @@
 /**
  * Java·Gradle 프로젝트용 프리셋.
  *
- * Java 코드 규칙 문서, Spotless(palantir-java-format) 커밋 검사, Gradle CI를 담는다.
- * Git 작업 규칙은 Git 프리셋을 함께 고르면 더해진다.
+ * Java 코드 규칙 문서와 Spotless(palantir-java-format)·Gradle 검증 명령 문서를 담는다.
+ * Git 훅·GitHub 설정은 넣지 않는다. 필요하면 Git 프리셋을 함께 고른다.
  * `files/`는 빌드 결과(dist/)와 소스(src/) 어디서 실행해도 패키지 루트 기준으로 같은 위치다.
  */
 export declare const javaPreset: {
     name: string;
     description: string;
     filesDir: string;
-    hooksPath: string;
     docs: {
         path: string;
         when: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;CA0BL,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;CAwBL,CAAC"}

package/dist/index.js

@@ -2,16 +2,14 @@ import { fileURLToPath } from "node:url";
 /**
  * Java·Gradle 프로젝트용 프리셋.
  *
- * Java 코드 규칙 문서, Spotless(palantir-java-format) 커밋 검사, Gradle CI를 담는다.
- * Git 작업 규칙은 Git 프리셋을 함께 고르면 더해진다.
+ * Java 코드 규칙 문서와 Spotless(palantir-java-format)·Gradle 검증 명령 문서를 담는다.
+ * Git 훅·GitHub 설정은 넣지 않는다. 필요하면 Git 프리셋을 함께 고른다.
  * `files/`는 빌드 결과(dist/)와 소스(src/) 어디서 실행해도 패키지 루트 기준으로 같은 위치다.
  */
 export const javaPreset = {
     name: "java",
-    description: "Java·Gradle 프로젝트용 지침, 커밋 훅, Spotless·Gradle CI",
+    description: "Java·Gradle 프로젝트용 코드 규칙, Spotless·Gradle 검증 명령",
     filesDir: fileURLToPath(new URL("../files", import.meta.url)),
-    // Spotless 검사(pre-commit.d/spotless)를 연결한다.
-    hooksPath: ".githooks",
     docs: [
         {
             path: "docs/project-direction.md",
@@ -21,11 +19,11 @@ export const javaPreset = {
         { path: "docs/clean-code.md", when: "코드 작성, 설계" },
         { path: "docs/clean-code-examples.md", when: "코드 작성 시 참고 예시" },
         { path: "docs/java-checklist.md", when: "Java 코드 작성·리뷰" },
-        { path: "docs/lint-and-ci.md", when: "훅·린트·CI 설정" },
+        { path: "docs/lint-and-ci.md", when: "린트·포맷·CI 설정" },
     ],
     rules: [
         "코드에는 의도를 설명하는 주석을 적극적으로 단다.",
-        "포맷은 손으로 맞추지 않는다. 커밋 전 `./gradlew spotlessApply`.",
+        "포맷은 손으로 맞추지 않는다. 작업을 마치기 전 `./gradlew spotlessApply`.",
     ],
     verify: "./gradlew spotlessCheck build",
     nextSteps: [

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,gDAAgD;IAC7D,QAAQ,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,4CAA4C;IAC5C,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,2BAA2B;YACjC,IAAI,EAAE,kCAAkC;SACzC;QACD,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,EAAE;QACjD,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,EAAE;QACjD,EAAE,IAAI,EAAE,6BAA6B,EAAE,IAAI,EAAE,eAAe,EAAE;QAC9D,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,eAAe,EAAE;QACzD,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,YAAY,EAAE;KACpD;IACD,KAAK,EAAE;QACL,6BAA6B;QAC7B,kDAAkD;KACnD;IACD,MAAM,EAAE,+BAA+B;IACvC,SAAS,EAAE;QACT,gDAAgD;QAChD,4EAA4E;KAC7E;CACe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,gDAAgD;IAC7D,QAAQ,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,2BAA2B;YACjC,IAAI,EAAE,kCAAkC;SACzC;QACD,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,EAAE;QACjD,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,EAAE;QACjD,EAAE,IAAI,EAAE,6BAA6B,EAAE,IAAI,EAAE,eAAe,EAAE;QAC9D,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,eAAe,EAAE;QACzD,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE;KACrD;IACD,KAAK,EAAE;QACL,6BAA6B;QAC7B,uDAAuD;KACxD;IACD,MAAM,EAAE,+BAA+B;IACvC,SAAS,EAAE;QACT,gDAAgD;QAChD,4EAA4E;KAC7E;CACe,CAAC"}

package/files/docs/code-style.md

@@ -3,7 +3,7 @@
 ## 포맷
 
 - palantir-java-format (Spotless). 들여쓰기 공백 4칸, 줄 길이 120. 수동 정렬하지 않는다.
-- 커밋 전 `./gradlew spotlessApply`. pre-commit 훅이 `spotlessCheck` 를 돌린다.
+- 작업을 마치기 전 `./gradlew spotlessApply`. 검증 명령과 CI 가 `spotlessCheck` 를 돌린다.
 - 설정은 [lint-and-ci.md](lint-and-ci.md).
 
 ## 네이밍
@@ -39,7 +39,7 @@
 
 - 코드를 그대로 읽는 주석 (`// i 증가`)
 - 주석 처리된 코드
-- 변경 이력 주석 (git 이 한다)
+- 변경 이력 주석 (버전 관리 도구가 한다)
 
 ```java
 /**

package/files/docs/lint-and-ci.md

@@ -1,16 +1,4 @@
-# 훅 · 린트 · CI
-
-## Git 훅
-
-`.githooks/pre-commit` 이 `.githooks/pre-commit.d/` 의 검사를 이름 순서로 실행한다.
-Java 프리셋은 포맷 검사를 넣는다. Git 프리셋을 함께 설치했다면 커밋 형식·파일 수 검사도 같이 돈다.
-
-| 파일 | 검사 |
-| --- | --- |
-| `.githooks/pre-commit.d/spotless` | `gradlew` 가 있고 `.java` 가 스테이징됐으면 `spotlessCheck` |
-
-- 클론한 뒤 훅이 동작하지 않으면 `git config core.hooksPath .githooks` 로 연결한다.
-- `--no-verify` 금지.
+# 린트 · CI
 
 ## 린트 (Spotless + palantir-java-format)
 
@@ -38,15 +26,18 @@ spotless {
 | 명령 | 용도 |
 | --- | --- |
 | `./gradlew spotlessApply` | 포맷 적용 |
-| `./gradlew spotlessCheck` | 포맷 검사 (훅, CI) |
+| `./gradlew spotlessCheck` | 포맷 검사 (작업 마무리, CI) |
+
+작업을 마치기 전에 `./gradlew spotlessApply` 로 포맷을 맞추고 아래 검증 명령을 실행한다.
 
 ## CI
 
-[.github/workflows/ci.yml](../.github/workflows/ci.yml)
+어떤 CI 서비스를 쓰든 아래 명령을 실행한다. 작업을 마치기 전에 돌리는 검증 명령과 같다.
 
-| job | 실행 | 검사 |
-| --- | --- | --- |
-| `build` | PR, main push | `spotlessCheck build`. `gradlew` 없으면 건너뜀 |
+```bash
+./gradlew spotlessCheck build
+```
 
-- 커밋 규칙(파일 수, 메시지 형식)은 CI 에서 검사하지 않는다. 로컬 훅만 검사한다.
-- 버전을 올릴 때는 이 문서의 스니펫과 CI 를 같이 고친다.
+- JDK 21 을 쓴다.
+- `gradlew` 가 없는 저장소(지침만 있는 저장소)에서는 건너뛴다.
+- 버전을 올릴 때는 이 문서의 스니펫과 CI 설정을 같이 고친다.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agentsmd/preset-java",
-  "version": "0.2.0",
-  "description": "Java·Gradle 프로젝트용 AI 작업 지침 프리셋 (코드 규칙 문서, Spotless 커밋 검사, Gradle CI)",
+  "version": "0.3.0",
+  "description": "Java·Gradle 프로젝트용 AI 작업 지침 프리셋 (코드 규칙 문서, Spotless·Gradle 검증 명령)",
   "keywords": [
     "agents.md",
     "ai-agent",
@@ -36,7 +36,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@agentsmd/core": "0.2.0"
+    "@agentsmd/core": "0.3.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/files/.githooks/pre-commit.d/spotless

@@ -1,14 +0,0 @@
-#!/usr/bin/env bash
-#
-# Java 포맷 검사. 공통 pre-commit 훅이 실행한다.
-# Gradle 프로젝트가 붙어 있고 Java 파일이 스테이징됐을 때만 spotlessCheck 를 돌린다.
-# 규칙: docs/lint-and-ci.md
-
-set -euo pipefail
-
-if [ -x ./gradlew ] && git diff --cached --name-only | grep -q '\.java$'; then
-  if ! ./gradlew -q spotlessCheck; then
-    echo "pre-commit: 포맷 위반. ./gradlew spotlessApply 후 다시 스테이징하세요." >&2
-    exit 1
-  fi
-fi

package/files/.github/workflows/ci.yml

@@ -1,33 +0,0 @@
-# 규칙: docs/lint-and-ci.md
-name: CI
-
-on:
-  pull_request:
-  push:
-    branches: [main]
-
-jobs:
-  # 커밋 규칙(파일 수, 메시지 형식)은 CI 에서 막지 않는다. 로컬 훅만 검사한다.
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v7
-
-      # 지침 전용 저장소일 때는 Gradle 프로젝트가 없으므로 빌드를 건너뛴다.
-      - name: Gradle 프로젝트 확인
-        id: detect
-        run: |
-          if [ -f gradlew ]; then echo "gradle=true" >> "$GITHUB_OUTPUT"; fi
-
-      - uses: actions/setup-java@v6
-        if: steps.detect.outputs.gradle == 'true'
-        with:
-          distribution: temurin
-          java-version: 21
-
-      - uses: gradle/actions/setup-gradle@v6
-        if: steps.detect.outputs.gradle == 'true'
-
-      - name: 포맷 검사 + 빌드
-        if: steps.detect.outputs.gradle == 'true'
-        run: ./gradlew spotlessCheck build