← AGENTS.md Generator

AGENTS.md for Java + Spring Boot

A ready-to-use instructions file for Claude Code, Cursor, Codex and other coding agents in Java + Spring Boot repos. Save as AGENTS.md (or CLAUDE.md) at the repo root.

# Project agent instructions (Java + Spring Boot)

## Commands
- Test: `./mvnw test`
- Lint/typecheck: `./mvnw verify`
- Run both before saying a task is done; paste the output.

## Stack rules
- Constructor injection only. Do not change public API signatures without asking.

## Workflow
1. Read relevant files first. Never guess APIs.
2. Plan in 3-5 bullets, then make the smallest diff that works.
3. No drive-by refactors. Stay in scope.
4. If uncertain, stop and ask.

## Guardrails
- No new dependencies without asking.
- Never read, print or commit secrets (.env, keys).
- No destructive commands (rm -rf, force push, DB drops).
- Never delete or skip failing tests to go green.

Customize in the generator

Why these rules

Agents fail most on: guessing APIs, sprawling diffs, adding dependencies, and "fixing" tests by deleting them. Each line above targets one of those failure modes.

More: Agent Tools Directory · buildlog pack