Development

Development

Builds on CONTRIBUTING.md / AGENTS.md with deeper contributor-facing detail. README/CONTRIBUTING stay the summary; the wiki is where the depth lives.

Outline

• Setting up a dev environment
  • git clone → bundle install → bundle exec exe/wip version
  • Why the test suite doesn't need WSLC (resolution/build/execution layers are swappable)
• Tests & lint
  • bundle exec rspec / bundle exec rubocop / bundle exec rake
  • CI matrix (Ruby 3.2 / 3.3 / 3.4 / 4.0)
• Commit conventions
  • Conventional Commits (feat/fix/docs/style/refactor/test/chore/ci)
  • How PR labels drive release-drafter's release notes
• Versioning
  • SemVer policy (patch/minor/major criteria)
  • lib/wip/version.rb is bumped by maintainers via the "Bump Version" workflow
• Making a pull request
  • Fork → branch → change → bundle exec rake → PR
  • Why small, focused PRs are preferred
• Architecture overview (contributor-facing depth not in the README)
  • Key modules under lib/wip/ (config parsing, command execution, doctor diagnostics, ...)
  • How the config/build/exec layers stay swappable for testing
• Release process
  • How release-drafter works, and why draft releases were excluded from the release-exists check (see the fix(ci) commit)