docs(agents): document PR conventions

[DavidBabinec]

Summary

Adds explicit repository workflow and PR naming instructions to CLAUDE.md so future agent sessions follow the repo's existing branch and title conventions.

Changes

• Documents that main is protected and all changes must go through PRs.
• Captures branch naming as <type>/<short-kebab-description>.
• Captures PR titles as <type>(<scope>): <summary>.
• Explicitly bans agent-branded branch prefixes and PR title prefixes such as codex/... and [codex].
• Notes draft PR defaults, coherent PR scope, explicit staging, and expected PR body contents.

Validation

• git diff --check
• bun run lint

Summary by CodeRabbit

• Documentation
  • Updated repository contribution guidelines with branch naming conventions, PR formatting standards, and workflow rules to maintain repository integrity and consistency.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: cdcca82b-8c4d-4741-9676-cf1823bf3a78

📥 Commits

Reviewing files that changed from the base of the PR and between c5cbf33 and 9be8b4d.

📒 Files selected for processing (1)

• CLAUDE.md

---

Walkthrough

This PR adds a "Repository workflow and PR conventions" section to CLAUDE.md that documents branch naming conventions, Conventional Commits PR title formatting, draft-by-default guidance, and rules protecting the main branch from direct pushes or bypassed branch protection.

Changes

Repository Workflow Documentation

Layer / File(s)	Summary
Workflow and PR conventions documentation CLAUDE.md	New section documenting branch naming conventions, Conventional Commits PR title format, draft-by-default PR creation guidance, and protected main branch rules.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A document grows, a workflow takes shape,
Branch names and commits in conventional drape,
Main stays protected, drafts lead the way,
Conventions are clear for a cleaner today! ✨

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/agent-pr-conventions

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}