AGENTS.md

1<!-- Guidance for AI agents working in Selenium Java Bindings and Grid. -->
2 
3## Code location
4- Java Bindings: `java/src/`, `java/test/`
5- Grid Server: `java/src/org/openqa/selenium/grid/`
6 
7## Common commands
8- Build: `bazel build //java/...`
9- Build Grid: `bazel build grid`
10 
11## Testing
12See `java/TESTING.md`
13 
14## Code conventions
15### Interfaces
16- New methods added to existing interfaces must provide a default implementation, if possible.
17- Interfaces must not expose the native classes of their implementations.
18 
19### Logging
20```java
21import java.util.logging.Logger;
22private static final Logger LOG = Logger.getLogger(MyClass.class.getName());
23 
24LOG.warning("actionable: something needs attention");
25LOG.info("useful: server started on port 4444");
26LOG.fine("diagnostic: request details for debugging");
27```
28 
29### Deprecation
30```java
31@Deprecated(forRemoval = true)
32public void legacyMethod() { }
33```
34 
35### Documentation
36Use Javadoc for public APIs:
37```java
38/**
39 * Brief description.
40 *
41 * @param name description
42 * @return description
43 * @throws ExceptionType when condition
44 */
45```
46