convention-enforcement

What problem does it solve?

Enforces repository-specific git conventions to prevent defective commits, inconsistent branch names, and improperly formatted pull requests that impede collaboration, traceability, and automated workflows.

Core Features & Use Cases

• Commit message validation: Checks type, optional scope, subject length, and matches configured commit types and subject length limits.
• Branch naming validation: Verifies current branch patterns against configured branchPatterns and warns on direct commits to the default branch.
• PR format and issue linkage checks: Ensures PR titles follow conventional commit style, PR bodies include summary and linked issues, labels are present, and draft status is appropriate.
• Project-specific detection and adaptation: Infers conventions from CLAUDE.md, settings.flow.json, recent commits, and existing branches to adapt validation rules.
• Use Case: Run before PR creation or during code review to catch non-conforming commits, missing issue links, and PR formatting errors and provide actionable fixes.

Quick Start

Run a repository convention check that validates commit messages, branch naming, PR format, and issue linkage and then list all violations with severity and suggested fixes.