requirements-framework-status

Reports live version, component counts, and gating state of the Requirements Framework from repository commands.

1|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/HarmAalbers/claude-requirements-framework --skill requirements-framework-status-harmaalbers
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: requirements-framework-status
Source: https://github.com/HarmAalbers/claude-requirements-framework/tree/main/plugins/requirements-framework/skills/requirements-framework-status
Command: npx skills add https://github.com/HarmAalbers/claude-requirements-framework --skill requirements-framework-status-harmaalbers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Status reports about a framework go stale the moment they are written. This Skill derives every volatile number — version, hook/agent/command/skill counts, ADR range, and live gating state — directly from the repository at runtime, so the reported figures can never drift from reality. ## Core Features & Use Cases - Runtime-derived metrics: Runs repo-relative commands (grep on plugin.json, ls counts on agents/commands/skills, req status) instead of quoting pre-baked numbers. - Compact status table: Reports version, component counts, ADR range, and a one-line summary of the live gating state, flagging anything unexpected. - Durable reference: Documents the configuration cascade (global → project → local), requirement strategies and scopes, and the session hook lifecycle. - Use Case: A developer returning to the project asks for the current state of the requirements framework and receives an accurate snapshot of the installed plugin version, component counts, and which workflow gates are currently satisfied on their branch. ## Quick Start Ask the assistant to show the current requirements framework status and project context for this repository.

Frequently Asked Questions about requirements-framework-status

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

FAQPage Schema
How do I check the status of the requirements framework?▼

Ask for a requirements framework status report and the Skill runs repo-relative commands: grep on plugin.json for the version, ls counts for agents, commands, and skills, and req status for live gating state. Results are reported in a compact table.

What does req status show in Claude Code?▼

req status prints the live gating state for the current branch and session, showing which workflow requirements are satisfied. Outside a live Claude Code session it prints a harmless no-session warning while still exiting with code 0.

Why does the status skill refuse to quote pre-baked metrics?▼

The Skill derives every volatile number from the repository at runtime so figures can never drift from reality. If commands cannot resolve, such as in a plugin-cache context, it says so and skips rather than inventing values.

Can I run the requirements framework test suite from the status report?▼

Yes, but only on request since the full suite runs about 1500 tests in roughly 30 seconds. The opt-in health check runs uv run python hooks/test_requirements.py and greps the results line.

What requirement scopes does the framework support?▼

Four scopes are supported: session (cleared when the session ends), branch (persists across sessions on the same branch), permanent (never auto-cleared), and single_use (cleared after the trigger command completes).