---
name: Bug report
about: Report a reproducible bug in AgentFlow4J
title: "[Bug]: "
labels: bug
assignees: ""
---

## Description

Describe the bug clearly and concisely.

## Version

- AgentFlow4J version: <!-- e.g. v0.7.0 -->
- Java version: <!-- Java 17+ -->
- Maven version:
- Spring Boot version: <!-- Spring Boot 3.x -->
- Spring AI version: <!-- Spring AI 1.0+ -->
- Module affected: <!-- core / graph / squad / checkpoint / resilience4j / starter / samples / cli-agents / test -->

## Minimal reproducer

Please provide a minimal example that reproduces the issue.

```java
// A short main() or test case is ideal.
```

## Steps to reproduce

1.
2.
3.

## Expected behavior

What did you expect to happen?

## Actual behavior

What actually happened?

## Environment

- OS:
- Runtime:
- Database/checkpoint backend, if relevant: <!-- H2 / PostgreSQL / Redis / none -->
- Docker used: <!-- yes / no -->

## Logs or screenshots

Paste logs, stack traces, screenshots, or error output here.
