Development

Development

CONTRIBUTING.md / AGENTS.md をベースに、コントリビューター向けの詳細情報をまとめる。README/CONTRIBUTINGは要約、Wikiは深掘りという役割分担。

Outline

• 開発環境セットアップ
  • git clone → bundle install → bundle exec exe/wip version
  • WSLC無しでテストが回る理由（resolution/build/execution層がswappable）
• テスト・Lint
  • bundle exec rspec / bundle exec rubocop / bundle exec rake
  • CIマトリクス（Ruby 3.2 / 3.3 / 3.4 / 4.0）
• コミット規約
  • Conventional Commits（feat/fix/docs/style/refactor/test/chore/ci）
  • PRラベルとリリースノート自動生成（release-drafter）の関係
• バージョニング
  • SemVer運用（patch/minor/major の基準）
  • lib/wip/version.rb はメンテナが "Bump Version" workflow で更新
• プルリクエストの進め方
  • フォーク→ブランチ→変更→bundle exec rake→PR、の流れ
  • 小さく焦点を絞ったPRを推奨する理由
• アーキテクチャ概要（コントリビューター向け深掘り、READMEには無い情報）
  • lib/wip/ の主要モジュール構成（設定パーサ、コマンド実行、doctor診断など）
  • config/build/exec層がテストのためにswappableである設計の詳細
• リリースプロセス
  • release-drafterの動き、draftがrelease-existsチェックを満たさないようにした経緯（fix(ci)コミット参照）