hook-violation-recovery

Automates response to local hook violations by choosing override or contract revision.

2|Updated May 3, 2026
One-click install
npx skills add https://github.com/lukeivers/loam --skill hook-violation-recovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hook-violation-recovery
Source: https://github.com/lukeivers/loam/tree/main/plugins/dev-sdlc/skills/hook-violation-recovery
Command: npx skills add https://github.com/lukeivers/loam --skill hook-violation-recovery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers handle failures caused by local pre-commit, pre-push, or CI hooks that violate contracts, preventing silent bypasses and ensuring traceable, deliberate responses.

Core Features & Use Cases

  • Failure Mode Management: Guides the operator through ratification or AC revision when a hook fires a violation.
  • Audit Trail Enforcement: Ensures violations are logged with rationale and decision documentation.
  • Use Case: When a developer encounters a hook violation during commit, use this Skill to decide whether to override with a documented ratification or revise the contract to address the violation.

Quick Start

Use the hook violation recovery skill to analyze the hook output, then choose the appropriate route to handle the violation responsibly.

Frequently Asked Questions about hook-violation-recovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle git pre-commit hook violations without bypassing security?

To handle git pre-commit hook violations safely, use hook violation recovery to analyze the failed contract and choose a deliberate path: either override with documented ratification or revise the acceptance criteria to resolve the failure traceably.

What is the best way to document a hook override during a git commit?

The best way to document a hook override is to enforce an audit trail that logs the violation rationale and decision documentation, ensuring the override is deliberate and traceable rather than a silent bypass of the CI pipeline.

When do I need to revise a contract instead of overriding a pre-push hook?

You need to revise a contract instead of overriding a pre-push hook when the violation indicates an outdated or incorrect acceptance criteria, requiring you to update the contract to address the violation rather than ratifying the failure.

Can I use this hook violation recovery process for CI pipeline failures?

Yes, you can use this process for CI pipeline failures because it is applicable in development workflows with pre-commit, pre-push hooks, and CI pipelines to manage contract violations and ensure accountability.

What is the difference between ratification and AC revision for hook failures?

Ratification overrides a hook violation with a documented decision, while AC revision updates the contract itself to address the violation, providing two distinct decision paths for managing local hook failure modes.

Why should I avoid silent bypasses when git hooks fail?

You should avoid silent bypasses when git hooks fail to ensure traceable, deliberate responses that maintain security and accountability best practices, preventing untracked contract violations from entering the development workflow.