extract-business-requirements

Extracts sourced business requirements from capability and user experience docs into a living markdown document.

1|Updated Mar 7, 2023
One-click install
npx skills add https://github.com/Zaba505/infra --skill extract-business-requirements-zaba505
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extract-business-requirements
Source: https://github.com/Zaba505/infra/tree/main/.claude/skills/extract-business-requirements
Command: npx skills add https://github.com/Zaba505/infra --skill extract-business-requirements-zaba505

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Capability and user experience docs describe business intent but are not testable or auditable on their own. This Skill extracts a numbered, source-linked list of business requirements (BR-01, BR-02, ...) from those docs, creating the reviewable contract that technical requirements and ADRs must trace back to. ## Core Features & Use Cases - Sourced requirement extraction: Reads the capability doc and every UX doc under docs/content/capabilities/{name}/, then derives business requirements with Hugo ref shortcode links back to their exact source sections. - BR/TR/decision boundary enforcement: Refuses to accept technical requirements (cadences, thresholds) or decisions (technologies, protocols) as BRs, parking them in Open Questions for the TR or ADR stage instead. - Append-only living document: Preserves BR numbering across re-extractions, flags stale source links with a warning marker instead of deleting them, and gates downstream work on a human-set reviewed_at frontmatter field. - Use Case: After defining a self-hosted application platform capability and its user experiences, run this Skill to produce business-requirements.md with 5+ sourced BRs, review it, set reviewed_at, and only then proceed to technical requirements. ## Quick Start Extract the business requirements for the self-hosted-application-platform capability from its capability doc and user experiences under docs/content/capabilities/.

Frequently Asked Questions about extract-business-requirements

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

FAQPage Schema
How do I extract business requirements from a capability document?

Point the Skill at a capability under docs/content/capabilities/{name}/ that already has at least one UX doc in its user-experiences/ directory. It reads the capability and all UX docs, then produces business-requirements.md with numbered BRs linked to their sources.

What is the difference between a business requirement and a technical requirement?

A business requirement states a business or user-outcome demand forced by the capability or UX, such as uploads surviving intermittent connectivity. A technical requirement is the derived technical constraint, like checkpointing progress every N seconds, and belongs in the define-technical-requirements stage.

Can I extract business requirements before writing user experience docs?

No. The Skill hard-stops if the capability doc is missing or the user-experiences/ directory contains no UX markdown files. You must run define-capability and define-user-experience first, since BRs derived from missing inputs lack provenance.

What happens to BR numbering when requirements are re-extracted?

BR numbers are append-only forever. Existing BRs keep their identifiers, new ones get the next free number, and BRs whose source links no longer resolve are flagged with a warning marker rather than deleted or renumbered, preserving downstream TR provenance.

Why does define-technical-requirements refuse to run after extraction?

It is gated on the reviewed_at frontmatter field in business-requirements.md. A human must review the extracted BRs and set reviewed_at to a date newer than the file's last modification before technical requirements can be extracted.