codebar / planner / 27414929856

93%

master: 95%

Pull #2643

github

docs: simplify local development setup for junior contributors

Make native installation the officially recommended path for local
development. Docker is moved to a secondary, not-recommended section.

Changes:
- Rewrite README.md with native installation as the quick-start path
- Add docs/development-setup.md: comprehensive, junior-friendly guide
  covering macOS and Linux, with troubleshooting for common issues
- Add lib/tasks/setup.rake: rake setup:check command that inspects the
  environment and reports exactly what is missing or misconfigured
- Add docs/coding-agent-setup-skill.md: skill file for AI coding agents
  (Codex, Claude, Pi, etc.) to help contributors diagnose setup issues
- Add make check target that delegates to rake setup:check
- Update db/seeds.rb to reference the new docs path
- Remove native-installation-instructions.md (content merged into the new
guide)

The setup:check task verifies:
- Ruby version, Bundler, mise, PostgreSQL, ImageMagick
- GitHub OAuth credentials in mise.local.toml
- Bundle dependencies, database connection, migrations, test database

24 of 122 new or added lines in 1 file covered. (19.67%)

3576 of 3848 relevant lines covered (92.93%)

41.06 hits per line