Pragma · Documentation

Docs.

Pragma is documentation engineering for regulated software. We rebuild SSPs as OSCAL — versioned, diff-able, continuously evaluated against your codebase on every PR. This index covers the public methodology, getting-started guides, and the Specshift OSS evaluator.

01

Specshift methodology

The public methodology describes the four scoring suites — retrieval, agent, structure, and drift — and the rules that make every score reproducible. Methodology version is pinned in every Specshift report. The limitations.md companion documents what v1.0 does not measure.

Read the methodology →

02

Specshift OSS — first 15 minutes

Run the evaluator against any public docs URL. No login required. Install, point at a URL, read the scored report.

  1. 1
    Clone and install
    git clone the wentzel-ai/wentzel repo, then pnpm i && pnpm -F @wentzel/specshift build.
  2. 2
    Run the scorer
    npx @wentzel/specshift run https://docs.example.com --methodology=v1.0. Output is JSON + a Markdown report at ./reports/[reportId].{json,md}.
  3. 3
    Read the methodology
    Understand what each sub-score means and what to fix first.
  4. 4
    Submit to the leaderboard
    Add --submit-leaderboard to opt your score into the public ranking.
Try the hosted eval →

03

Platform overview

Four scoring suites measure what matters for regulated documentation. Each suite has a public spec and a public limitations document.

01retrieval

Can a vector index answer realistic developer questions from these docs?

02agent

Can a tool-use agent complete a representative task using only these docs?

03structure

Are the docs organised so a model can navigate without context overflow?

04drift

Do the docs describe the platform's actual current behaviour?

Full Specshift overview →

04

Knowledge base

The Pragma knowledge base covers OSCAL authoring, FedRAMP control mapping, SSP Sprint methodology, and Specshift CLI reference. Knowledge base articles are published alongside engagements and updated each quarter.

Knowledge base content is in active development as part of the 2026 launch. Anchor-customer-facing articles are published before each SOW signs.

Request early access to the KB →

Dispute a methodology score or file an RFC? Contact us. Disputes are tracked publicly under PRAG/06.