How do I troubleshoot hooks not triggering?

Use the 'req doctor' command to verify installation, check that you aren't on a protected branch like main/master, and ensure the requirement is enabled in your configuration.

How do I temporarily bypass requirements?

You can bypass requirements by setting the environment variable 'export CLAUDE_SKIP_REQUIREMENTS=1' or by disabling them in your '.claude/requirements.local.yaml' file.

What is the 'single_use' scope?

The 'single_use' scope means a requirement must be satisfied immediately before every single instance of a triggered action, such as requiring a review before every git commit.

Where should I store team-wide requirements?

Team-wide requirements should be stored in '.claude/requirements.yaml' at the project root and committed to your version control system.

Claude Requirements Framework

Name: Claude Requirements Framework
Author: HarmAalbers

byHarmAalbers

•

Productivity & Workflow

Enforces standardized development workflows and best practices within Claude Code through a hook-based requirement system.

The Claude Requirements Framework skill enables developers to formalize and automate their development lifecycle by ensuring critical steps are followed before code is modified. By integrating directly into Claude's tool execution layer, it allows for the enforcement of practices like Architectural Decision Reviews (ADR), Test-Driven Development (TDD), and structured commit planning. It features a powerful CLI for managing requirement states, multi-level YAML configuration for team-wide or personal settings, and flexible scoping to handle everything from one-time pre-commit checks to session-long development goals.

Key Features

011 GitHub stars

02Interactive CLI (req command) for status tracking and requirement satisfaction

03Automated triggers based on specific Bash command patterns or tool usage

04Granular requirement scoping including Session, Branch, and Single-use types

05Hook-based workflow enforcement for Claude Code tools (Bash, Edit, Write)

06Hierarchical configuration supporting Global, Project, and Local overrides

Use Cases

01Creating mandatory pre-commit checklists for team-standardized workflows

02Ensuring architectural reviews (ADR) are completed before major refactors

03Enforcing TDD patterns by requiring test plans before code generation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add harmaalbers/claude-requirements-framework requirements-framework-usage

For use in Claude.ai and ChatGPT

Download Skill

Key Features

011 GitHub stars

02Interactive CLI (req command) for status tracking and requirement satisfaction

03Automated triggers based on specific Bash command patterns or tool usage

04Granular requirement scoping including Session, Branch, and Single-use types

05Hook-based workflow enforcement for Claude Code tools (Bash, Edit, Write)

06Hierarchical configuration supporting Global, Project, and Local overrides

Use Cases

01Creating mandatory pre-commit checklists for team-standardized workflows

02Ensuring architectural reviews (ADR) are completed before major refactors

03Enforcing TDD patterns by requiring test plans before code generation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add harmaalbers/claude-requirements-framework requirements-framework-usage

For use in Claude.ai and ChatGPT

Download Skill