commitlint

@savvy-web/commitlint

Dynamic, intelligent commitlint configuration that auto-detects DCO requirements, workspace scopes, and versioning strategies. Stop manually configuring commit rules for every project.

Features

• Auto-detection - Detects DCO files, workspace packages, and versioning strategies automatically
• Zero config - Works out of the box with sensible defaults
• Type-safe - Full TypeScript support with Zod schema validation
• Extended types - Includes ai and release commit types beyond conventional commits
• Interactive prompts - Built-in commitizen adapter with emoji support
• CLI tooling - Bootstrap and validate configurations with savvy-commit

Repository Structure

This is a monorepo containing two packages:

Directory	Description
package/	The @savvy-web/commitlint npm package. Dynamic commitlint configuration with auto-detection, interactive prompts, and the savvy-commit CLI.
plugin/	A Claude Code sidecar plugin that registers a SessionStart hook to inform AI agents about Silk commit conventions enforced by this project.

Quick Start

npm install -D @savvy-web/commitlint @commitlint/cli @commitlint/config-conventional husky

// commitlint.config.ts
import { CommitlintConfig } from "@savvy-web/commitlint";

export default CommitlintConfig.silk();

Or bootstrap everything automatically:

npx savvy-commit init

For configuration options, API reference, and advanced usage, see the package README and docs.

Documentation

• Configuration Guide - All configuration options
• Auto-Detection - How automatic detection works
• CLI Reference - Command-line interface usage
• Commit Types - Available types and their usage

License

MIT