Spring AI

Use this operational skill to inspect a real Maven or Gradle Spring AI project before changing it. The included diagnostic CLI is offline and provider-neutral: it reads build files, application configuration, and source to report compatibility clues, unsafe defaults, missing conversation IDs, streaming prerequisites, tool/MCP boundaries, retrieval configuration, and observability risks. It never sends prompts or exposes API-key values.

Entry check

Confirm the project root and whether the task is read-only or will modify configuration/code. Read-only diagnosis can proceed. Before the first state-changing action, confirm the target project, scope, and rollback path (usually a reviewed commit or revert); the CLI itself is read-only.

Run:

python3 spring-ai/scripts/spring_ai_check.py --root /path/to/project --json

The result is stable JSON with status, project, facts, findings, and errors. Exit 0 means no error-severity finding; exit 1 means an error-severity finding or warnings promoted by --strict; exit 2 means an invalid invocation or unreadable project.

Workflow