define-technical-requirements

Extracts technical requirements from reviewed business requirements into a living tech-requirements.md document.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Teams often jump from business requirements straight to technology choices without writing down the technical constraints those requirements force, leaving architectural decisions unjustified. This Skill translates each reviewed business requirement into implementation-neutral technical requirements with full traceability, before any technology decisions are made. ## Core Features & Use Cases - BR-to-TR translation: Walks the reviewed business-requirements.md and derives numbered TR-NN entries, each citing its source BR-NN plus optional capability, UX, or prior ADR context via Hugo ref links. - Append-only living document: Preserves existing TR numbering on re-extraction, flags stale source links with warning markers instead of deleting them, and resets the reviewed_at gate when contents change. - Decision separation: Refuses to record technology choices as requirements, parking volunteered solutions in Open Questions for the downstream plan-adrs and define-adr stages. - Use Case: After reviewing business-requirements.md for a self-hosted application platform capability, run this Skill to produce tech-requirements.md with TRs like tenant data export and isolation constraints, each traceable to its BR, ready for human review before ADR planning begins. ## Quick Start Extract the technical requirements for the self-hosted-application-platform capability from its reviewed business-requirements.md.

Frequently Asked Questions about define-technical-requirements

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

FAQPage Schema
How do I extract technical requirements from business requirements?

Provide a reviewed business-requirements.md for your capability and the Skill walks each BR, translating it into implementation-neutral TR-NN entries that cite their source BR. The output is saved as tech-requirements.md with reviewed_at set to null pending human review.

What is the difference between a technical requirement and an architecture decision?

A technical requirement states what the solution is forced to do to satisfy a business requirement, without naming technologies. A decision picks one option among several that satisfy the TR, and belongs in an ADR produced by the later plan-adrs or define-adr skills.

Why does the skill refuse to extract requirements from my docs?

Extraction is refused when business-requirements.md is missing or its reviewed_at frontmatter is null or older than the file's last modification. Review the BR doc, set reviewed_at to today's ISO date, and rerun the extraction.

Can I add a technology choice like Postgres as a technical requirement?

No. Technology choices are decisions, not requirements, and are rejected as TRs. The Skill asks for the underlying constraint and parks the suggested technology in Open Questions for the ADR stage.

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

Numbering is append-only: existing TR-NN identifiers are preserved forever, new requirements get the next free number, and TRs whose source links no longer resolve are flagged with a warning marker rather than deleted or renumbered.