Git & PR Workflow Standards

Core Principles

• * Small PRs: ≤300 LOC changed ideally
• Commit often: Early, meaningful commits with clear messages
• Linear history: Prefer rebase over merge commits
• Professional: No AI attribution, no tool branding, clean descriptions

🚨 ABSOLUTE ZERO-TOLERANCE RULE: NO AI ATTRIBUTION 🚨

NEVER, UNDER ANY CIRCUMSTANCES, include ANY of the following in:

• * Git commit messages
• Pull request descriptions
• Issue comments
• GitHub discussions
• Code comments
• Documentation
• ANY public-facing repository content

❌ STRICTLY FORBIDDEN TEXT - NEVER USE

• * "Claude"
• "Anthropic"
• "claude.com"
• "Claude Code"
• "Claude Desktop"
• "Generated with Claude"
• "Co-Authored-By: Claude"
• "🤖 Generated with Claude Code"
• "Co-Authored-By: Claude "
• Any emoji followed by "Generated with" or "Powered by"
• Any reference to AI assistants, AI code generation, or automated tools
• Any branding, attribution, or links to third-party AI services

✅ CORRECT FORMAT - ALWAYS USE

• * Clean, professional commit messages
• Clear description of what changed
• Explanation of why the change was made
• No attribution, no branding, no tool references

Examples

❌ FORBIDDEN COMMIT

CODEBLOCK0

✅ CORRECT COMMIT

CODEBLOCK1

❌ FORBIDDEN PR DESCRIPTION

CODEBLOCK2

✅ CORRECT PR DESCRIPTION

CODEBLOCK3

Enforcement

• * ZERO TOLERANCE rule with NO EXCEPTIONS
• Every commit must be verified before pushing
• Every PR must be reviewed for attribution before creating
• If attribution is found, it must be removed immediately via force push or amendment
• This rule applies to ALL repositories, ALL projects, ALL commits
• Violations compromise the professional appearance of our work

Why This Matters

• * Maintains professional repository appearance
• Avoids unwanted third-party attribution
• Ensures our work is presented as our own
• Prevents confusion about authorship and ownership
• Compliance with company branding guidelines

PR Requirements

Every PR must include:

• * Problem/Context: What issue are we solving and why?
• Solution summary: How does this change address the problem?
• Test plan: Commands + results proving functionality
• Risk/rollback: Potential issues and how to revert if needed
• Story link + Type + Estimate: Link to issue/story with type (feature/bug/chore) and points

Reference Files

See references/ai-attribution-enforcement.md for comprehensive forbidden text list and enforcement details.

See references/pr-templates.md for complete PR templates for feature, bug, and chore PRs.

See references/branch-conventions.md for branch naming patterns and examples.