feat(release): package agent instructions as GitHub release artifacts - #111
Merged
Conversation
Add agents-java.zip and agents-kotlin.zip to GitHub releases. These zip files contain AI coding assistant instructions (guidelines, code samples, and FQN references) to help AI tools generate correct Fluxzero code. The workflow creates the zips during build, uploads them as artifacts, and attaches them to the GitHub release.
… syntax Converted all code examples in agent-instructions/kotlin/ from Java syntax to proper Kotlin syntax and idioms: - Replaced Java records with Kotlin data classes - Changed method declarations to Kotlin function syntax - Updated builder patterns to use .copy() instead of .toBuilder().build() - Converted Java interfaces to Kotlin interfaces with property syntax - Changed static members to use companion object or object declarations - Replaced List.of() with listOf() - Updated lambda syntax to Kotlin style - Fixed nullability handling with Kotlin's ? syntax - Changed file references from .java to .kt in guidelines - Updated project structure references from src/main/java to src/main/kotlin This ensures AI assistants receive accurate Kotlin examples when working with Fluxzero projects, improving code generation quality and reducing the need for manual syntax corrections. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
renedewaele
requested changes
Feb 2, 2026
Applied review feedback from PR #111: Guidelines fixes: - Use ::class instead of ::class.java for Fluxzero SDK methods (generateId, search, etc.) - Document that Instant or Message should be injected for time handling in @apply methods, not Clock - Require fully qualified names in JSON test files for Kotlin (not simple names) - Clarify that searchable aggregates are indexed when modified - Remove incorrect mvn clean suggestion Code samples fixes: - Replace all ::class.java with ::class for Fluxzero SDK method calls - Update JSON test file example to show FQN requirement for Kotlin - Keep ::class.java only for Java interop methods (getPayloadAs, TestFixture methods) These changes ensure Kotlin examples follow SDK best practices and avoid common pitfalls when working with Kotlin and the Fluxzero framework. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
agents-java.zipandagents-kotlin.zipas GitHub release artifactsChanges
Release Artifacts
agents-java.zipandagents-kotlin.zipKotlin Examples Update
agent-instructions/kotlin/from Java to Kotlin syntax:.copy()methodcompanion object/objectList.of()→listOf()?syntax.javato.ktsrc/main/javatosrc/main/kotlinTest plan
java/orkotlin/withagents/subdirectories)Dependencies
This PR is related to fluxzero-io/fluxzero-cli#28. This PR introduces a gradle/maven plugin which can help auto-update the agent instructions.