Skip to content

Repository files navigation

MISSING

MISSING is the standard at the center of DS4AI, the Design Suite for AI, from Polymathie-Studio: the umbrella for the invisible-correctness layer of a shipped web surface, what a page must carry that a look-at-it review cannot see. AI-assisted builds optimize for "does it render, does the demo work," and skip everything not visible in the artifact under review. Every gap is an instance of that one thing. MISSING names the axes of that invisibility, routes each to the instrument that closes it, and ships the machine-readable pieces that let an agent or a build pipeline compose the suite and check a surface against it.

MISSING itself provides no UI component. It is the map, the family manifest, and the conformance auditor.

flowchart TB
  DS["DS4AI, the Design Suite for AI"]
  DS --> M["MISSING, the standard and conformance auditor"]
  M --> T["Perceivable · TEMPER"]
  M --> G["Operable · GRASP"]
  M --> LG["Off the happy path · LUCID + GRACE"]
  M --> H["Key-private · HASP"]
  M --> B["Findable · BEACON"]
  M --> F["Fast and stable · FLEET"]
Loading

The axes and their instruments

Axis (kind of invisibility) Posture Instrument
Invisible because color-coded Perceivable by any reader TEMPER
Invisible to a keyboard or assistive tech Operable by any input or assistive technology GRASP
Invisible until you interact or something fails Behaves honestly off the happy path LUCID (principle) + GRACE (components)
Invisible until inspected: keys in the client bundle The user's key stays in the user's browser HASP
Invisible until shared or crawled Represents itself correctly to machines and shares BEACON
Invisible until measured Loads fast and stable FLEET

The machine-readable core

MISSING ships its instructions machine-readable, not only as prose, so a tool or agent consumes them directly.

  • manifest.json is the canonical descriptor of the family: every primitive's axis, package, exports, API, the conformance checks it exposes, and the packaging that lets it land on the common distribution surfaces (npm, JSR, CDN, and more).
  • manifest.schema.json is a portable JSON Schema (draft 2020-12); validate any manifest against it with your own tool.
  • validate.ts validates the manifest against the schema with zero dependencies, so MISSING stays as dependency-free as the family it describes. Run: deno run --allow-read validate.ts.
  • conformance.js audits a shipped surface's HTML across all six axes and returns a structured per-axis report. It is a breadth pass; for depth on findability and delivery it points to the primitive's own auditor.
import { audit } from './conformance.js'

const report = audit(serverHtmlString)
if (!report.ok) console.error(report.axes)

Following the family's honesty principle, the auditor declares the axes it cannot judge from a static snapshot rather than reporting them clean: the off-happy-path states are not visible in a single happy-path render, and full contrast needs rendered colors, so those come back marked not checked and partial with the reason.

What MISSING does not close

MISSING names these as real gaps and routes them to "yours to handle" rather than claiming family coverage: observability (error tracking, uptime); backend security and scale; responsive layout (a discipline, not a component); legal content; and the delivery levers a drop-in primitive cannot pull (image compression, JavaScript bundling, and setting cache headers, which are build-tool and server work).

Status

The machine-readable core (manifest, schema, validator, conformance auditor), the standard document (MISSING - the standard.md, dual-licensed CC-BY-4.0), and the cross-tool agent-instruction file (AGENTS.md) are all here. A cumulative MCP server for the whole suite is a later step, once every primitive is complete.

License

Apache-2.0. Copyright 2026 Regis Lloyd Chapman. See LICENSE and NOTICE. The standard document (MISSING - the standard.md) is dual-licensed CC-BY-4.0; see LICENSE-SPEC.

About

The umbrella for the invisible-correctness layer: names the axes, routes each to a Polymathie primitive, and ships a machine-readable family manifest and a conformance auditor. Part of the Polymathie family.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages