husky-maintainer_skill

Overview

This skill documents specific workflows and standards for maintaining the husky-rs project, a husky-like Git hook tool written in Rust. It captures the required development environment, project layout, pre-commit and change procedures, and the release checklist to keep releases predictable and CI green. Follow these rules to ensure compatibility with the project's MSRV and to streamline contributions and releases.

How this skill works

The guide enforces use of Rust MSRV 1.78 and provides Makefile targets to run checks, fixes, tests, and documentation validation locally. It maps where source files and tests live (CLI binary, library, integration tests) and prescribes steps to run before committing, how to update docs and changelogs, and the exact release steps including tagging. Use the provided make targets to automate style, lint, test, coverage, and doc validation tasks.

When to use it

• Before committing any change to ensure formatting, lints, and tests pass.
• When adding or modifying CLI behavior to update tests and documentation.
• Before publishing a release to update version, changelog, and create the tag.
• When validating compatibility with the project MSRV (1.78).
• When running CI-like checks locally to reproduce pipeline failures.

Best practices

• Run make fix, make test (or make nextest), and make msrv-check before pushing.
• Keep Cargo.toml metadata accurate and bump only the library/CLI version during releases.
• Update docs/ whenever CLI flags or usage change; run make doc-check to verify.
• Add or adjust integration tests in tests/ for CLI regressions and features.
• Maintain CHANGELOG.md by moving Unreleased to the new version and adding a fresh Unreleased section.

Example use cases

• A contributor implements a new flag in src/bin/husky.rs and updates tests/test_cli.rs and docs/ accordingly.
• A maintainer prepares a release: bump Cargo.toml, rename Unreleased to v0.x.y with date, update links, and tag v0.x.y.
• A developer verifies MSRV compliance with make msrv-check after adopting new Rust code patterns.
• A CI failure is reproduced locally with make ci to iterate quickly on fixes.
• Generating coverage reports with make coverage to evaluate test completeness.