When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.
- Create your branch from
main. - Keep changes boring: plain Java, Gradle wrapper, no new dependency unless it earns rent.
- Add behavior-first tests through editor, run-configuration, cache, or client entrypoints.
- Run
./gradlew testbefore pushing. Run./gradlew check verifyPlugin buildPluginbefore release work. - Do not bump
pluginVersionby hand for release PRs; the tag workflow owns the date-basedYYYY.M.Dversion bump. - Keep user-facing text in
src/main/resources/messages/GitHubWorkflowBundle*.properties. - Update
README.md,doc/navigation.md, ADRs, ordoc/spec/*when behavior or workflow changes.