Activation Contract
Use this skill before creating a commit, opening a PR, or preparing changes for review in Logmancer.
Hard Rules
- Run
cargo fmtbefore any commit or PR preparation. - Run
cargo clippy --workspace -- -D warningsafter formatting. - Do not create the commit or PR while either command fails.
- If
cargo fmtchanges files, include those formatting changes in the same reviewable work unit. - Do not run
cargo build; this project explicitly avoids builds during agent changes unless the user asks. - Update
CHANGELOG.mdbefore committing any relevant user-facing, release, packaging, workflow, or behavior change. - Keep Conventional Commit style and never add AI attribution trailers.
Decision Gates
| Situation | Action |
|---|---|
cargo fmt succeeds with changes |
Continue, then include changed files in commit/PR scope |
cargo fmt fails |
Stop, report the formatter error, and do not commit or open a PR |
cargo clippy --workspace -- -D warnings fails |
Fix warnings if in scope; otherwise stop and report blockers |
| Change affects users, releases, packaging, CI behavior, or documented behavior | Update CHANGELOG.md in the same work unit before committing |
| Change is purely internal and not notable for release notes | Leave CHANGELOG.md unchanged and mention why in the commit/PR summary |
| User asks to skip gates | Push back and require explicit confirmation before bypassing |
Execution Steps
- Decide whether the change is changelog-worthy before staging the commit.
- If it is notable, update
CHANGELOG.mdunder[Unreleased]or the active release section. - Run
cargo fmtfrom the repository root. - Run
cargo clippy --workspace -- -D warningsfrom the repository root. - Inspect the resulting working tree before committing or preparing a PR.
- Proceed only when the changelog decision is explicit and both commands pass.
Output Contract
Report:
cargo fmt: pass/fail and whether files changed.cargo clippy --workspace -- -D warnings: pass/fail.CHANGELOG.md: updated or intentionally unchanged, with a short reason.- Any blockers that prevent commit or PR creation.
References
@AGENTS.md— Logmancer workspace commands, style, and agent rules.
Source: ignsabbag/logmancer — distributed by TomeVault.