roster-spec

Generate validated specification contracts with traceable requirements and GWT acceptance scenarios.

2|2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/mathiasbourgoin/roster --skill roster-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roster-spec
Source: https://github.com/mathiasbourgoin/roster/tree/main/.opencode/skills/roster-spec
Command: npx skills add https://github.com/mathiasbourgoin/roster --skill roster-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the risk of incomplete, ambiguous feature specifications that lead to costly rework, missed edge cases, and misalignment between stakeholders and development teams during the early stages of software projects.

Core Features & Use Cases

  • Adversarial Requirement Challenging: Systematically surfaces gaps, contradictions, and unaddressed edge cases in feature requirements before implementation begins, preventing avoidable rework.
  • Testable User Story Generation: Derives independent, falsifiable user stories with concrete Given/When/Then acceptance scenarios mapped to each requirement.
  • Traceable Formal Requirements: Produces normative FR-NNN functional requirements tied directly to user stories and resolved challenges, with cross-spec consistency checks against existing project documentation.
  • Use Case: For a new API rate-limiting feature, this Skill will identify unstated constraints like burst traffic handling, formalize requirements for each user story, and validate the full spec with the product team before any code is written.

Quick Start

Use the roster-spec skill to generate a validated, adversarial specification contract for the new user profile editing feature outlined in the latest intake brief.

Frequently Asked Questions about roster-spec

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

FAQPage Schema
How do I generate testable user stories from functional requirements?

Generate testable user stories by deriving independent, falsifiable narratives with concrete Given/When/Then acceptance scenarios mapped directly to each functional requirement. This ensures every user story is verifiable and traceable to the original specification.

What is adversarial requirement challenging in software specification?

Adversarial requirement challenging systematically surfaces gaps, contradictions, and unaddressed edge cases in feature specifications before implementation begins. This process prevents avoidable rework by validating requirements against real-world constraints during the spec phase.

How do I write GWT acceptance scenarios for API feature specs?

Write GWT acceptance scenarios by mapping concrete Given/When/Then steps to normative FR-NNN functional requirements tied to user stories. This creates runnable checks that validate implementation readiness and cross-spec consistency against existing project documentation.

Can I validate feature specs for cross-spec consistency before implementation?

Validate feature specs for cross-spec consistency by producing structured specification contracts with traceable functional requirements and resolved challenges. Cross-spec consistency checks ensure alignment with existing project documentation before development begins.

What's the best way to prevent ambiguous feature specifications in pipeline orchestration?

Prevent ambiguous feature specifications by applying an adversarial spec phase within coordinated agent development pipelines. This requires a validated intake brief as input and produces structured specification contracts with traceable requirements and GWT acceptance scenarios.

Do I need a validated intake brief to generate formal functional requirements?

A validated intake brief is required as input to generate formal functional requirements. The specification phase processes this brief to produce normative FR-NNN requirements tied to user stories and resolved adversarial challenges for implementation readiness.