docs(design): add user story knowledge bundle

2026-08-08 12:31:15 -04:00
parent baed3b4901
commit c76ea5b434
9 changed files with 198 additions and 0 deletions
@@ -0,0 +1,25 @@
+---
+type: User Story
+title: "US-006: Build and release the plugin"
+description: Give maintainers repeatable Java builds, automated verification, and versioned Gitea releases.
+status: done
+---
+
+# US-006: Build and release the plugin
+
+As a **plugin maintainer**, I want automated builds and releases so that tested, correctly versioned plugin artifacts can be distributed consistently.
+
+## Acceptance criteria
+
+- [x] The Gradle project compiles against Java 17 and the supported Spigot API.
+- [x] Automated tests run as part of the Gradle check lifecycle.
+- [x] Pushes and pull requests build and test the plugin in Gitea Actions.
+- [x] Pull requests validate conventional commit messages.
+- [x] CI stores a development JAR as a workflow artifact.
+- [x] Main-branch conventional commits drive semantic versioning.
+- [x] A successful release builds a versioned JAR and attaches it to the corresponding Gitea release.
+
+## Related
+
+- [Build and release documentation](../../README.md#releases)
+- [User-story catalog](index.md)