sdlc-srs

Generates software requirements specifications with executable Gherkin acceptance criteria from PRD documents.

Updated Jun 1, 2026
One-click install
npx skills add https://github.com/juartaurus98/codebase --skill sdlc-srs-juartaurus98
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdlc-srs
Source: https://github.com/juartaurus98/codebase/tree/main/.claude/skills/sdlc-srs
Command: npx skills add https://github.com/juartaurus98/codebase --skill sdlc-srs-juartaurus98

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a software requirements specification that stays synchronized with executable acceptance criteria is error-prone: requirements drift from test scenarios, non-functional requirements lack measurable targets, and traceability between requirements and tests breaks down. This Skill produces the SRS and its Gherkin feature files together, gated as one unit, so the prose specification and the executable half never diverge. ## Core Features & Use Cases - Dual-artifact generation: Produces SRS.md (functional FR, non-functional NFR, and AI AIR requirements with data and interface contracts) plus one .feature file per use case, linked through a §8 index. - Input gating: Validates the source PRD before writing — blocking on missing use cases, acceptance bullets, or unanswered blocking questions, and routing gaps back to the PO/BA owner. - Traceability enforcement: Every scenario carries @feat/@uc/@req/@oracle tags, and every requirement must be referenced by at least one scenario, checked by gate G2. - Use Case: A Tech Lead runs /srs FEAT-042 against an approved PRD and receives a complete SRS with measurable NFRs, AI quality metrics, and per-use-case Gherkin feature files ready for test generation. ## Quick Start Run /srs with a feature ID, for example: generate the SRS and acceptance criteria for FEAT-042 from its PRD.

Frequently Asked Questions about sdlc-srs

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

FAQPage Schema
How do I generate an SRS from a PRD?▼

Run /srs with a feature ID against an existing PRD. The skill checks the PRD for use cases, acceptance bullets, and blocking questions, then writes SRS.md plus one Gherkin feature file per use case, gated together under G2.

How do I write Gherkin acceptance criteria that stay in sync with requirements?▼

Generate the feature files in the same step as the SRS rather than separately. Each scenario carries @req tags referencing FR/AIR IDs, and gate G2 rejects any requirement not covered by at least one scenario.

What makes a non-functional requirement testable?▼

Every NFR must carry a number: p95 latency, throughput, availability, retention, or cost per request. Terms like fast, reliable, or scalable are rejected by gate G2 because a requirement without a number cannot fail and therefore cannot pass.

Can I run /srs on a PRD that was not created by the /prd command?▼

Yes. The input check re-derives what it needs from the PRD document as it stands, so a hand-written or externally edited PRD works. It stops only if the PRD lacks use cases, acceptance bullets, or answers to blocking questions.

When should I not use this skill?▼

Do not use it for technical design — layers, classes, libraries, and database choices belong to the tech design phase. It also does not write test code or test cases; scenarios are specifications consumed later by test generation.