planner AGENTS.md

AGENTS.md

This file provides guidance to AI agents when working with code in this repository.

Project Overview

codebar planner is a Rails 8.1 application for managing codebar.io members and events. It handles workshop/event scheduling, member registration, invitations, RSVPs, and feedback collection for coding workshops organized by codebar chapters.

Development Workflow

CRITICAL: Never work directly on the master branch. All changes must be made via pull requests from feature branches.

Branching Strategy

1. Create a feature branch from master: git checkout -b feature/descriptive-name
2. Make your changes and commit them to the feature branch
3. Push the branch to the remote repository
4. Create a pull request for review
5. Wait for approval before merging to master

Never:

• Commit directly to master
• Push directly to master
• Merge without review

Development Setup

IMPORTANT: Always use native installation with bundle exec commands. Never use Docker or bin/d* commands.

Prerequisites

• mise — install via brew install mise, then enable mise activate in your shell profile (see mise docs). Alternatively, use mise exec to run commands with project env vars without shell activation.
• PostgreSQL running locally (default port 5432, or configure via DB_PORT)

Native Installation

cp mise.local.toml.example mise.local.toml
# Edit mise.local.toml with your GitHub OAuth credentials
# Optionally delete .env if it exists from a prior setup:
rm .env
bundle && rake db:create db:prepare db:seed

• Server: bundle exec rails server
• Tests: make test or bundle exec parallel_rspec spec/ -n 3 - runs RSpec tests in parallel (3 processes is optimal)
• Single test: bundle exec rspec spec/path/to/file_spec.rb:42
• Rails console: bundle exec rails console
• Run rake tasks: bundle exec rake [task]
• Linting: bundle exec rubocop