remarkbox/CLAUDE.md
Russell Ballestrini a6c04d565a Add google_site_verification support for namespaces
- Add google_site_verification column to rb_namespace table
- Add settings form field in Stand-alone Mode Settings
- Render meta tag on root path when set
- Update CLAUDE.md with Alembic migration workflow
- Fix development.ini alembic paths
2026-01-11 09:11:07 -05:00

1.4 KiB

Claude Code Configuration

Project Setup

IMPORTANT: Before starting any work on a repository:

  1. Check for a CLAUDE.md file in the repository root
  2. Check for a CLAUDE.md file in parent directories (we often work across repos on localhost)
  3. Read and follow all instructions in those files
  4. These project-specific instructions override default Claude Code behavior
  5. Look for conventions around commits, testing, code style, and workflows
  6. If working across multiple repositories, respect the conventions from each repo's CLAUDE.md

Commit Attribution

When creating git commits, use clean, simple commit messages:

Commit message here.

Do NOT include:

  • 🤖 Generated with [Claude Code](https://claude.com/claude-code)
  • Co-Authored-By: Claude <noreply@anthropic.com>
  • Any fake corporate entities as co-authors

Only attribute real humans as co-authors when collaborating.

Database Migrations (Alembic)

When adding new columns or modifying the database schema:

  1. Backup SQLite first: cp data/remarkbox.sqlite data/remarkbox.sqlite.bak
  2. Add the column to the model in remarkbox/models/
  3. Generate migration: alembic -c development.ini revision --autogenerate -m "description"
  4. Clean up migration: Remove extra autogenerated changes, keep only the new field
  5. Run migration: alembic -c development.ini upgrade head