skills.rest
HarmAalbers
HarmAalbersCOMMUNITY
Explore all skills by this author →
GitHub

requirements-framework-development

Guides development, testing, and maintenance of the Claude Code Requirements Framework plugin.

1|Updated Dec 11, 2025
Search Tags:#uv#claude code#hooks#test-driven development#plugin development#build automation#stacked git
One-click install
npx skills add https://github.com/HarmAalbers/claude-requirements-framework --skill requirements-framework-development-harmaalbers
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: requirements-framework-development
Source: https://github.com/HarmAalbers/claude-requirements-framework/tree/main/plugins/requirements-framework/skills/requirements-framework-development
Command: npx skills add https://github.com/HarmAalbers/claude-requirements-framework --skill requirements-framework-development-harmaalbers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Developing the Requirements Framework involves a non-obvious build-copy architecture: hook source lives in hooks/ but the runtime plugin loads a generated bundle, so edits silently fail to take effect without a rebuild. This Skill codifies the correct edit-rebuild-test-commit workflow so framework changes actually reach the running plugin. ## Core Features & Use Cases - Bundle Build Workflow: Rebuild the plugin bundle with build_plugin_hooks.py after editing hooks/, and detect drift with --check before committing. - Prompt Template Rendering: Edit .md.j2 templates and re-render them to .md with render_prompts.py instead of editing generated files. - TDD and Live-Reload Testing: Run the test suite via uv run python hooks/test_requirements.py and load changes with claude --plugin-dir for live-reload sessions. - Use Case: You fix a bug in hooks/lib/requirements.py, rebuild the bundle, run the test suite to confirm green, and commit the change as an atomic Stacked Git patch with the plugin version bumped. ## Quick Start Ask the assistant to fix a bug in the requirements framework and walk through rebuilding the plugin bundle, running the test suite, and committing with Stacked Git.

Frequently Asked Questions about requirements-framework-development

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

FAQPage Schema
How do I test changes to the requirements framework hooks?▼

Edit source in hooks/, rebuild the plugin bundle with uv run python scripts/build_plugin_hooks.py, then run uv run python hooks/test_requirements.py. Launch claude --plugin-dir pointing at the plugin directory to live-reload changes in a fresh session.

Why are my hook changes not taking effect in Claude Code?▼

The plugin bundle is a build-copy of hooks/, so edits to source do not reach the runtime until you rebuild. Run build_plugin_hooks.py --check to detect drift, rebuild with build_plugin_hooks.py, and start a fresh --plugin-dir session.

How do I edit a command or agent prompt in the plugin?▼

Edit the .md.j2 Jinja2 template, never the rendered .md file, then run uv run python scripts/render_prompts.py to regenerate the output. Reload the plugin in a fresh session to see the change.

Can I use git commit directly in this repository?▼

No, the project authors every local commit through Stacked Git. Use stg new to create a patch and stg refresh to fold changes into it, keeping each patch atomic and bumping plugin.json in the same patch when plugin files change.

Why must all Python commands run through uv?▼

ADR-021 mandates uv so every entrypoint uses the synced environment with PyYAML and the dev dependency group. Run uv sync once, then prefix all commands with uv run; the only exception is statusline.sh.

Related Skills

Explore More Software Engineering Skills→
google-deepmindgoogle-deepmind
2.7k

uv

Install the uv Python package manager and verify its PATH availability.

Official
Basic
christophevgchristophevg

release

Bump C3 plugin versions, update changelogs, and push annotated git tags.

Community
Intermediate
ArthTech-AIArthTech-AI

qa

Run full-stack QA checks with pytest, Jest, ruff, TypeScript, and Playwright.

Official
Intermediate
dwmkerrdwmkerr
23

claude-code-plugin-development

Package Claude Code plugin components into distributable plugins with a plugin.json manifest.

Community
Advanced