Skip to content

reqvire-org/reqvire

Repository files navigation

Reqvire

Reqvire Logo

Semantic engineering graph for building verifiable and traceable systems.

Latest Release License Rust

📖 Documentation🔍 Browse Model🚀 Quick Start👥 Contributing


What is Reqvire?

Semantic engineering graph for building verifiable and traceable systems.

Model ontologies, capabilities, requirements, refinements, and verification directly inside Git — with AI-native traceability and engineering context built in.

It unifies:

  • system modeling
  • requirements engineering
  • verification & validation
  • semantic traceability
  • context engineering
  • AI-assisted development

into a single workflow that stays aligned with your codebase.

Unlike traditional requirements systems, Reqvire treats engineering knowledge as a living semantic graph rather than disconnected documents, tickets, or spreadsheets.


Quick Start

Install Reqvire CLI

curl -fsSL https://raw.githubusercontent.com/reqvire-org/reqvire/main/scripts/install.sh | bash

Validate a Reqvire workspace:

reqvire validate

Use with AI Coding Assistants

Reqvire ships with:

  • Claude Code integrations
  • Codex skills
  • MCP server support

Run the MCP server directly with npx:

npx -y @reqvire-org/reqvire@latest --workspace /absolute/path/to/workspace mcp

This exposes Reqvire engineering context to AI assistants through the Model Context Protocol (MCP).

Example MCP client configuration:

{
  "mcpServers": {
    "reqvire-myrepository": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@reqvire-org/reqvire@latest",
        "--workspace",
        "/absolute/path/to/my/repository",
        "mcp"
      ]
    }
  }
}

Enable mutation tools:

npx -y @reqvire-org/reqvire@latest --workspace /absolute/path/to/workspace mcp --enable-mutations

Reqvire Conceptual Model

Reqvire organizes engineering knowledge into a semantic graph:

Ontology
    ↓
Capabilities
    ↓
Requirements
    ↓
Refinements
    ↓
Verification

Ontologies

Ontologies define:

  • concepts
  • relationships
  • domain vocabulary
  • semantic meaning

Reqvire supports ontology modeling directly inside the engineering workflow.

This enables:

  • semantic consistency
  • AI-readable engineering context
  • shared system understanding
  • traceable domain semantics

Capabilities

Capabilities represent coherent operational or system abilities that the system provides or supports.

Capabilities:

  • act as stable semantic anchors
  • bridge ontology and requirements
  • remain implementation-independent whenever possible
  • support hierarchical decomposition
  • provide durable traceability nodes

Examples:

  • Real-Time Collaboration
  • Autonomous Navigation
  • Workflow Orchestration
  • Semantic Search
  • Distributed Coordination

Capabilities can contain optional semantic context sections such as:

  • stakeholder needs
  • product features
  • operational context
  • mission objectives
  • regulatory drivers

without turning those concepts into separate graph node types.


Requirements

Requirements define:

  • implementable obligations
  • system constraints
  • measurable guarantees
  • operational expectations
  • behavioral contracts

In Reqvire, requirements are not treated as isolated specification statements or static documentation.

Requirements are first-class semantic graph elements that:

  • derive from capabilities
  • connect to ontology concepts
  • refine into structured engineering contracts
  • trace to implementation artifacts
  • link directly to verification evidence
  • propagate change impact throughout the engineering graph

Reqvire requirements act as durable engineering context for:

  • humans
  • AI systems
  • coding assistants
  • architecture workflows
  • verification pipelines

This enables:

  • intelligent traceability
  • automated impact analysis
  • architecture-aware development
  • specification-driven engineering
  • semantic consistency across the lifecycle

Requirements can evolve from lightweight statements into progressively refined engineering semantics through:

  • behavioral refinements
  • state models
  • semantic contracts
  • I/O contracts
  • constraints
  • detailed specifications

Examples:

  • latency limits
  • interoperability guarantees
  • safety constraints
  • synchronization behavior
  • auditability obligations
  • semantic consistency requirements

Unlike traditional requirements systems, Reqvire requirements remain:

  • version-controlled
  • AI-readable
  • semantically connected
  • continuously traceable
  • tightly integrated with implementation and verification workflows

This transforms requirements from static documentation into living engineering intelligence embedded directly inside Git workflows.


Refinements

Requirements can be refined into structured engineering contracts such as:

  • behavioral contracts
  • state models
  • semantic contracts
  • input/output contracts
  • constraints
  • detailed specifications

This allows requirements to evolve into precise, machine-readable engineering semantics while remaining Git-native and human-readable.


Verification

Reqvire supports verification and validation directly in the engineering graph.

Verifications provide evidence that:

  • requirements are satisfied
  • behaviors are correct
  • implementations meet intended capability expectations

This enables:

  • coverage tracking
  • impact analysis
  • intelligent traceability
  • automated validation workflows

Why Reqvire?

Traditional engineering knowledge is fragmented across:

  • documents
  • tickets
  • architecture diagrams
  • code
  • spreadsheets
  • wikis
  • test systems

This creates:

  • stale specifications
  • broken traceability
  • inconsistent semantics
  • disconnected verification
  • poor AI context
  • difficult change propagation

Reqvire turns engineering knowledge into a living semantic graph directly inside Git.


AI-Native Engineering

Reqvire models are designed for both humans and AI systems.

The semi-structured modeling language enables:

  • LLM reasoning
  • intelligent traceability
  • semantic search
  • automated impact analysis
  • context-aware code generation
  • AI-assisted verification
  • intelligent change propagation
  • architecture-aware engineering workflows

Reqvire acts as a structured, canonical context layer that AI systems can reliably reason over.


Key Features

Semantic Engineering in Git

Reqvire keeps engineering knowledge:

  • versioned
  • traceable
  • reviewable
  • AI-readable
  • semantically connected

directly alongside implementation artifacts.

No more:

  • lost specifications
  • outdated documents
  • disconnected architecture
  • isolated requirements
  • untraceable changes

Capability-Driven Engineering

Develop systems around coherent operational capabilities instead of disconnected feature lists or isolated requirements.

Capabilities:

  • decompose hierarchically
  • generate requirements
  • support verification
  • connect naturally to ontology concepts
  • remain stable across implementation changes

Ontology-Driven Modeling

Bring semantic engineering directly into your Git workflow.

Reqvire supports:

  • ontology modeling
  • semantic relationships
  • engineering vocabularies
  • domain concepts
  • AI-readable system meaning

This enables:

  • consistent terminology
  • shared system understanding
  • semantic traceability
  • better AI reasoning

Intelligent Engineering

Bring modern Model-Based Systems Engineering (MBSE) directly into Git-native workflows.

Specification-Driven Development

Develop from capabilities and requirements.

Keep:

  • implementation
  • architecture
  • tests
  • verification artifacts

aligned with engineering intent.


Automated Traceability

Maintain bidirectional links between:

  • ontologies
  • capabilities
  • requirements
  • refinements
  • code
  • tests
  • verification artifacts

Verification & Validation

Track:

  • verification coverage
  • behavioral correctness
  • implementation alignment
  • validation evidence

throughout the engineering lifecycle.


Smart Change Propagation

Identify impacted:

  • requirements
  • capabilities
  • verifications
  • implementation artifacts
  • semantic dependencies

and propagate changes consistently across the engineering graph.


AI-Assisted Engineering

Provide coding assistants and AI systems with structured engineering context that stays aligned with:

  • architecture
  • requirements
  • capabilities
  • verification
  • semantic meaning

Seamless Integration

Works naturally with:

  • Git
  • branches
  • pull requests
  • reviews
  • CI/CD
  • coding assistants

No workflow disruption — just structured engineering intelligence.


Assistant Integrations

Claude Code Plugin

Before installing the plugin, ensure you have:

  1. Claude Code installed (available at claude.com/claude-code)

The Reqvire plugin is available through the reqvire-org marketplace for Claude Code.

Add the marketplace

/plugin marketplace add https://github.com/reqvire-org/reqvire

Install the plugin

/plugin install reqvire@reqvire-org

Restart Claude Code after installation.

Read more in: https://www.reqvire.org/coding_assistants.html


Codex Skill (Reqvire SysEng)

This repository includes an installable Codex skill package at:

codex-skills/reqvire-syseng

The skill uses the npm package directly:

npx -y @reqvire-org/reqvire@latest --workspace /absolute/path/to/workspace validate

To pin workflows to a specific Reqvire version:

export REQVIRE_NPX_PACKAGE=@reqvire-org/reqvire@0.13.2

Install globally:

git clone https://github.com/reqvire-org/reqvire.git
cd reqvire
./scripts/install-codex-skill.sh

The installer uses CODEX_HOME if set, otherwise defaults to:

~/.codex

Installed location:

$CODEX_HOME/skills/reqvire-syseng

Restart Codex after installing or updating the skill.

See: doc/CODEX_SKILLS.md


Next Steps


Contributing

External pull request contributions are by invitation only.


How to Contribute

  1. Read the Contributing Guide
  2. Open or upvote an issue
  3. Contribute analysis and design discussion
  4. Submit a PR only if invited

Engineering Workflow

Reqvire follows a semantic MBSE workflow.

Invited code changes should include:

  • capability updates
  • requirements
  • refinements
  • verifications
  • tests

when applicable.

See: Contributor Documentation


Quick Links


Contributor License Agreement

All contributors must accept the Contributor License Agreement.

The CLA process is automated through GitHub PR comments.


Credits

Reqvire is an open-source project created and maintained by Ilija Ljubicic.


Special Thanks

For valuable contributions to testing and in shaping Reqvire's direction, especially during the early phases of development.


For partial sponsorship and for being the first user of Reqvire.

Their support helped shape the project's early direction.


What's Next?

Join the Community

  • ⭐ Star the repository
  • 💬 Join discussions
  • 📝 Contribute ideas and analysis
  • 🚀 Explore semantic engineering workflows
  • 🤖 Build AI-native engineering systems

License

Licensed under the Apache 2.0 License.