Skip to main content

Conformance Suite

Validates any implementation of the Personal AI Architecture against its architectural invariants.

Each test has an ID, description, pass/fail criteria, and maps to a specific architectural guarantee. An implementation that passes all tests is architecturally conformant.

How to Use

  1. Implement the architecture (or use the component stubs in ../stubs/)
  2. Run each test category below against your implementation
  3. All tests must pass for conformance — partial conformance is not conformance

Test Categories

CategoryTestsWhat it validates
Swap TestsSWAP-1 to SWAP-3Config-only swappability (D147)
Architectural Invariant TestsARCH-1 to ARCH-4Component boundaries and independence
Deployment Invariant TestsDEPLOY-1 to DEPLOY-4Local-first deployment contract
Foundation User Story TestsFS-1 to FS-8End-to-end architecture promises

Test Status

Tests are currently defined as specifications (pass criteria, setup, verification steps). Executable test scripts will be added when a reference implementation exists.

  • ../implementers-reference.md — what each component must do
  • ../../../specs/openapi/ and ../../../specs/schemas/ — canonical schemas that payloads must validate against
  • ../../foundation-spec.md — architectural principles these tests enforce