roster-spec-formal

Generate formal Rocq or Quint specifications from validated markdown product specs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After running the initial roster-spec to produce a validated markdown product spec, teams need a formal, verifiable specification (Rocq .v or Quint .qnt) for critical components to enable automated formal verification. Manually translating markdown specs to formal languages is error-prone, risks misinterpreting requirements, and lacks traceability to original user stories.

Core Features & Use Cases

  • Formal Spec Generation: Extends validated roster-spec markdown outputs into formal Rocq or Quint specification artifacts for critical software components.
  • Traceability Enforcement: Maps every formal property to its parent user story from the original markdown spec, ensuring no requirement is lost in translation.
  • Mandatory Human Validation: Runs a custom quiz for each formal spec to confirm stakeholders understand the committed formal requirements, preventing misinterpretation of high-risk properties.
  • Use Case: A team building a cryptographic number-theoretic transform (NTT) function can use this skill to generate a formal Rocq spec with traceable properties after validating the markdown spec with roster-spec, then pass the validation quiz before proceeding to formal verification.

Quick Start

Use the roster-spec-formal skill to generate a formal Rocq specification for your NTT function component from your existing validated markdown spec and formal triage brief.

Frequently Asked Questions about roster-spec-formal

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

FAQPage Schema
How do I generate formal Rocq specifications from validated markdown product specs?

You can generate formal Rocq (.v) specifications from validated markdown product specs by using a pipeline skill that maps each formal property to its parent user story. This requires pre-existing validated markdown spec files and a formal triage brief to ensure accurate translation.

What is formal specification generation for critical software components?

Formal specification generation for critical software components is the process of translating validated markdown requirements into verifiable Rocq or Quint artifacts. This ensures that high-risk properties are mathematically defined and traceable to original user stories for automated formal verification.

Can I generate Quint .qnt specifications from existing markdown product specs?

Yes, you can generate Quint .qnt specifications from existing validated markdown product specs. The generation process reads your markdown spec and formal triage brief to output a .qnt file, enforcing user story traceability and requiring a human validation quiz to confirm stakeholder intent.

Does formal specification generation support user story traceability?

Yes, formal specification generation supports user story traceability by mapping every formal property back to its parent user story from the original markdown spec. This ensures no requirement is lost in translation and provides full traceability for high-risk components during formal verification.

What are the prerequisites for generating formal Rocq or Quint specs?

The prerequisites for generating formal Rocq or Quint specs are pre-existing validated markdown product spec files and formal triage brief files. You must have these specific markdown documents available in your repository before initiating the formal specification generation process.

Why do I need a validation quiz for formal specifications?

You need a validation quiz for formal specifications to confirm that stakeholders understand the committed formal requirements and to prevent misinterpretation of high-risk properties. This mandatory human validation step ensures the generated Rocq or Quint specs align with stakeholder intent before formal verification.