Querywright · Read-only prototype

SEO strategy your codebase can actually enforce.

Querywright connects measured demand, human-approved strategy, and machine-readable page contracts, then checks the live site against that plan.

machine proposes · human approves · contract requires · site implements · verifier compares
01 · The gap

Recommendations are easy. Implementation is the hard part.

SEO software is good at producing recommendations. The implementation still has to survive handoff, development, redesigns, content changes, and time. Today the pieces live apart:

Keyword research: lives in a research toolStrategy: lives in a documentImplementation: lives in codeVerification: happens later, manually

nobody can easily prove why a page exists, or what it is supposed to do.

02 · How it works

One chain, from measured demand to traced findings.

Each stage has a clear actor. What a machine proposes, a human approves. What a contract requires, a verifier compares against the observed site.

01

Measure demand

Persisted research becomes measured demand. A measured zero and missing provider evidence stay different things.

Machine
02

Build a deterministic proposal

The same inputs produce the same proposal. Each suggestion is BUILD, SUPPORT, or CONCEDE, with a stated reason.

Machine
03

A human reviews the strategy

A person decides what stands. A machine proposal is a suggestion until it is adjudicated.

Human
04

Materialize page contracts

Approved strategy becomes RoleContracts and PageContracts with stable digests.

Contract
05

Observe the real site

The live site is crawled and inventoried. Observation never rewrites approved strategy.

Site
06

Verify the implementation

Deterministic rules compare the observed site against current contract authority.

Verifier
07

Trace findings to authority

Every finding points at the contract, the strategy, and the evidence behind it.

Verifier
03 · Product

The interior, running live below.

This is the actual product prototype, not a screenshot. The site’s full chain of truth sits in one view: research at the bottom, verification on top, and every finding carries its authority source.

querywright · site overview · acmeridian.com · live prototype

The interior is a desktop layout, so it is not embedded at this width. It runs on the same fixture data, one tap away.

Open the interior
04 · Provenance

Every conclusion has a trail.

A failing check is more useful when the system can show what authority made it a failure. Querywright keeps each link of the chain inspectable, so a finding is never just a number to argue about.

Current and historical authority remain separate.
Observed site state cannot silently rewrite approved strategy.
Corrupt current contract authority fails closed.
Provenance trace · F-1042
Finding F-1042canonical mismatch on /services/hvac-tuning
PageContract pc-0087expected canonical → /services/hvac-tuning (no locale suffix)
Approved StrategyMODIFIED_AND_APPROVED · role: service_detail · geo: US-CA
Machine ProposalBUILD · reason: measured_positive · digest pr_3d1e9c…
Demand observation"hvac tuning bay area" · MEASURED_POSITIVE · vol 2,400/mo
05 · Verification

No mystery SEO score.

Verification results are three words, and each one means exactly what it says.

PASS

A deterministic expectation matched. The check is repeatable with the same inputs.

FAIL

It did not. The finding records the expected value, the observed value, and the authority source.

ERROR

Querywright could not establish the state. It does not guess, and it does not average it away.

Human strategy remains human authority.
Model judgment is labeled as model judgment, wherever it appears.
06 · Capabilities

What is in the system today.

Only accepted capabilities are listed. Nothing here is a roadmap item wearing a shipped costume.

Research & demand

  • Persisted keyword research with observation IDs
  • MEASURED_POSITIVE, MEASURED_ZERO, and no-provider evidence kept distinct
  • Geography-aware demand
  • Provider provenance on every observation

Strategy

  • Deterministic proposal generation
  • BUILD / SUPPORT / CONCEDE with stated reasons
  • Human adjudication, persisted separately
  • Modified-and-approved state with immutable history

Contracts

  • RoleContracts and PageContracts
  • Approved hierarchy and relationships
  • Current and historical materializations
  • Provenance-bound digests

Verification

  • Deterministic rules
  • Crawl observations
  • Current-authority verification
  • Fail-closed corruption handling
  • Findings and reconciliation

Evidence

  • FIELD, RECORDS, LAB, DERIVED classes
  • Active and retracted states
  • Derivation lineage
07 · A real run

We’re targeting “hvac tuning” in the Bay Area.

AC Meridian is Querywright’s own working site, used as a dogfood. This is what one thread of it looks like, end to end.

Measure"hvac tuning bay area" · MEASURED_POSITIVE · 2,400/mo · d-2201
ProposeBUILD · reason: measured_positive · digest pr_3d1e9c…
Approvehuman adjudication · MODIFIED_AND_APPROVED · 41 effective routes
Contractpc-0087 · canonical → /services/hvac-tuning (no locale suffix)
Crawl187 routes observed · run #12 · network safety LITERAL_ONLY
VerifyF-1042 FAIL · expected /services/hvac-tuning · observed /us-ca/services/hvac-tuning
TraceF-1042 → pc-0087 → strategy st_77ab30… → pr_3d1e9c… → d-2201

AC Meridian is dogfood, not customer proof. Every value above is fixture data from this prototype.

08 · Authority

The machine proposes. You approve.

A proposal and an approved strategy are different objects. The first is a suggestion with a digest. The second is a human decision, persisted separately and inspectable at any time.

Machine Proposal, historical. A suggestion. It can be regenerated, and it is never authority on its own. Digest pr_3d1e9c, generated 2026-07-14.Approved Strategy, current. A human decision. Persisted separately, with immutable history. Digest st_77ab30, adjudicated 2026-07-22.

pr_3d1e9c… ≠ st_77ab30… · observed site state can never silently rewrite either one.

09 · For technical teams

Built to be inspected, not just viewed.

The same strategy, contracts, evidence, and findings are reachable from the app, the CLI, or a read-only MCP interface.

  • PageContracts are machine-readable. Current and historical authority have stable digests.
  • CLI can inspect V2 authority and run verify. Output is deterministic and CI-compatible.
  • MCP exposes V2 authority read-only. Mutation policy: READ_ONLY.
  • Historical contract state stays queryable. Current and historical remain separate.
Illustrative output
$ qw verify --site acmeridian
312 checks · 14 FAIL ·2 ERROR · exit 1
$ qw mcp --stdio
MCP server · authority: V2 · mutation policy: READ_ONLY
10 · Fit

Who this is for. And what it is not.

For

  • SEO practitioners who need implementation accountability
  • Developers who need explicit SEO requirements
  • Agencies managing complex site architecture
  • Teams tired of strategy living in disconnected spreadsheets and docs

Not

  • Not a generic AI writer
  • Not a keyword dashboard
  • Not an SEO score
  • Not just a crawler
  • Not just a recommendation feed

It connects inputs and outputs around one thing: approved strategy and enforceable implementation authority.

11 · Boundary

What is accepted. What is not yet.

This page is a prototype of a real system. The split below is the honest one.

In the system today

  • Persisted research + measured demandshipped
  • Deterministic proposals + human adjudicationshipped
  • Contracts with digests, current + historicalshipped
  • Crawl observations, LITERAL_ONLY hostnamesshipped
  • Deterministic verification + provenanceshipped
  • CLI inspect + verify · MCP read-onlyshipped

Still in the shop

  • DNS pinningnot yet accepted
  • Hardened egressnot yet accepted
  • G2 product shell (this page is a prototype of it)not final
  • Copy Studiofuture
  • Multi-user authnot complete
  • External production deploymentnot verified

See the chain, not just the score.

Querywright connects measured demand, approved strategy, and page contracts, so every finding has a trail.