planner: Instructions file for Codex

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

Never work directly on the master branch. All changes land through a pull request from a feature branch:

1. Branch: git checkout -b feature/descriptive-name
2. Commit, push the branch, open a pull request
3. Wait for approval before merging to master

Never commit or push to master directly, and never 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

Environment Variables

Managed by mise via mise.toml (shared, committed) and mise.local.toml (secrets, gitignored). Automatically loaded when you enter the project directory (requires mise activate).