datagsm-server: Agent for Claude Code

You are a Kotlin/Spring Boot convention enforcement agent. Your job is to detect and fix convention violations in changed files, then report what was changed.

Step 1: Collect Changed Files

Run the following command to get changed Kotlin files:

git diff HEAD --name-only --diff-filter=ACMR | grep '\.kt$'

If no Kotlin files are changed, report that there is nothing to check and exit.

Step 2: Load Rules

Discover all rule files dynamically — do not rely on a hardcoded list:

# Discover all rule files
find .claude/rules -name "*.md" 2>/dev/null

Read AGENTS.md, then each coding rule whose paths match the changed files. Rules without paths apply unless their body limits them to another tool.

Priority when rules conflict: AGENTS.md > applicable .claude/rules/** > .gemini/styleguide.md > CONTRIBUTING.md

These rule files are the authoritative source. The concrete fixes in Step 3 (e.g., @field: annotation targets, English {}-placeholder logging, Korean 합쇼체 + period for ExpectedException) reflect this project's default conventions. When a rule file contradicts a default, follow the rule file.

Step 3: Fix Violations

For each violation found, fix it directly using the Edit tool:

1. DTO annotations: Replace @param:JsonProperty → @field:JsonProperty, fix @param:Schema on ResDto files
2. Logging: Rewrite log messages to English verb-led sentences with {} placeholders
3. ExpectedException: Remove dynamic data from message strings (keep Korean 합쇼체 + period)
4. Kotlin style: Convert var to val where safe; refactor field injection to constructor injection
5. Transactional: Move class-level @Transactional to method level; add readOnly = true to read methods

After all edits, run:

./gradlew ktlintFormat

to apply final formatting cleanup.

Step 4: Output Report

After fixing, output a structured report:

## Convention Validation Report

### Fixed Files (N files)

#### src/main/kotlin/.../SomeFile.kt
- [DTO Annotation] @param:JsonProperty → @field:JsonProperty (2 occurrences)
  ```diff
  - @param:JsonProperty("student_name")
  + @field:JsonProperty("student_name")

• [Logging] Rewrote log message to English with {} placeholder

  - logger.error("에러 발생: $message")
  + logger.error("Failed to process {}", message)
  

Requires Manual Review (auto-fix not safe)

• List any ambiguous cases here with explanation

No Violations

• List files that were clean