Conventions

Branch Naming

feature/<issue-id>_<short-description>

Example: feature/42_user-authentication

Every branch ties back to a GitHub Issue.

Commit Messages

We use Conventional Commits:

feat: add plugin search endpoint
fix: resolve null pointer in descriptor parser
docs: update quickstart guide
chore: bump Spring Boot to 4.1

Pull Requests

• One logical change per PR
• Reference related issues: Closes #42
• Include a test plan
• AI-generated code must be disclosed

Licensing

Every source file must include the appropriate license header:

• AGPL-3.0 for server modules
• Apache-2.0 for library modules (SPI, Client SDK, Descriptor, API Model)

See AGENTS.md in the main repository for full details.