SPECL Vocabulary

RDF-native, SHACL-validated spec language for spec-driven AI development.

Namespaces

Prefix	URI	Description
`specl:`	https://w3id.org/specl/ns#	Classes and properties (OWL ontology)
`spec:`	https://w3id.org/specl/spec#	Spec instances (requirements, stories, decisions)

Resources

Resource	Format	Link
Core ontology	Turtle	ns.ttl
SHACL shapes	Turtle	shapes.ttl
Spec explorer	HTML	explorer.html

Classes

Class	Description
`specl:Specification`	A versioned spec document with intent, purpose, and status
`specl:Requirement`	A tracked requirement with priority, acceptance criteria, and verification
`specl:UserStory`	A user story with persona, goal, and acceptance criteria
`specl:OpenIssue`	An unresolved question with owner and recommendation
`specl:DecisionRecord`	An architectural decision with rationale and affected requirements
`specl:DesignNote`	A design consideration
`specl:Comment`	A general comment
`specl:Component`	A system component that requirements constrain
`specl:Test`	A verification artifact linked from requirements

Key Properties

Property	Domain	Description
`specl:partOf`	Requirement	Links an item to its parent Specification
`specl:priority`	Requirement	MoSCoW priority (MUST, SHOULD, COULD, WONT)
`specl:acceptanceCriterion`	Requirement, UserStory	Given/When/Then acceptance test
`specl:verifiedBy`	Requirement	Path to a test or verification artifact
`specl:constrains`	Requirement	Component this requirement governs
`specl:status`	Specification	Maturity gate (draft, prototype, review, production)

Links

GitHub repository · PyPI package · Authoring syntax