Conformance Reference

Purpose #

The per-level check tables and a complete list of check ids. Authoritative source: .docs/docs/specs/conformance-levels.md (Appendix B is the canonical id reference).

Tier ↔ ConformanceLevel mapping #

User-facing tier names (introduced in A1) map 1:1 to the internal ConformanceLevel. The schema, adapter manifests, and the project state file all use ConformanceLevel; only the CLI surface, prompts, and user-facing docs use tier names.

tierToConformance() / conformanceToTier() in @aidokit/core are the canonical mappers. See the tier landing pages for the user-facing surface.

Per-level totals #

Exact counts depend on spec evolution; the harness is authoritative.

Adapter check ids (~36 at Strict) #

From .docs/docs/specs/conformance-levels.md Appendix B.1:

Manifest #

• adapter.manifest.declared-level
• adapter.manifest.spec-version
• adapter.manifest.capabilities-declared
• adapter.manifest.cli-target

Agent rules file #

• adapter.emit-rules.exactly-one-file
• adapter.emit-rules.owner-is-adapter
• adapter.emit-rules.references-source-of-truth-chain
• adapter.emit-rules.includes-validation-commands

Engine config #

• adapter.emit-engine.paths-under-engine-dir
• adapter.emit-engine.all-paths-relative

Verbs #

• adapter.emit-verbs.intake-present
• adapter.emit-verbs.implement-task-present
• adapter.emit-verbs.orchestrator-next-present
• adapter.emit-verbs.intake-stops-before-code

Roles #

• adapter.emit-roles.six-required-roles-present
• adapter.emit-roles.builder-scope-limited
• adapter.emit-roles.read-only-roles-correct
• adapter.emit-roles.seventh-role (MAY at Minimum, SHOULD at Standard)
• adapter.emit-roles.seventh-role-strict (MUST at Strict)

Skills #

• adapter.emit-skills.required-skills-emitted
• adapter.emit-skills.preserves-triggers
• adapter.emit-skills.stack-pack-skills-marked (SHOULD)

Watchdog #

• adapter.watchdog.test-loop-detection
• adapter.watchdog.command-loop-detection
• adapter.watchdog.file-edit-counter
• adapter.watchdog.repair-cap
• adapter.watchdog.out-of-scope-block
• adapter.watchdog.version-bump-gate
• adapter.watchdog.tracked-deletion-gate
• adapter.watchdog.blocker-emitter
• adapter.watchdog.monitoring-stream (SHOULD at Standard, MUST at Strict)
• adapter.watchdog.monitoring-stream-strict (MUST at Strict)

Post-install #

• adapter.post-install.executable-scripts-marked
• adapter.post-install.beads-init-when-enabled (SHOULD)

Determinism #

• adapter.determinism.repeated-invocation-stable

MCP #

• adapter.mcp.install-implemented (SHOULD at Minimum, MUST at Standard)
• adapter.mcp.remove-implemented (SHOULD/MUST)
• adapter.mcp.list-implemented (SHOULD/MUST)

Sync #

• adapter.sync.pre-sync-implemented (SHOULD/MUST)
• adapter.sync.classifies-all-files (MUST at Standard)

Doctor #

• adapter.doctor.implemented (SHOULD/MUST)
• adapter.doctor.verifies-cli-installation (MUST at Standard)
• adapter.doctor.verifies-required-files (MUST at Standard)
• adapter.doctor.runs-conformance-subset (SHOULD at Strict)

Output styles #

• adapter.output-styles.emitted (SHOULD at Standard, MUST at Strict)

v1.0 capability cross-check #

• AD-STD-CAP-01 — declared capabilities match actual source-level imports (child_process) and call sites (fetch(, http(s).request(). See CHANGELOG [Unreleased].

Stack-pack check ids (~21 at Strict) #

From .docs/docs/specs/conformance-levels.md Appendix B.2:

stack-pack.manifest.declared-level
stack-pack.manifest.languages-non-empty
stack-pack.manifest.spec-version

stack-pack.detect.returns-result
stack-pack.detect.confidence-categorical
stack-pack.detect.no-shell-calls
stack-pack.detect.handles-missing-files

stack-pack.skills.at-least-one-skill
stack-pack.skills.source-marked
stack-pack.skills.has-review-markers
stack-pack.skills.no-secrets
stack-pack.skills.no-hard-coded-paths        # SHOULD

stack-pack.determinism.repeated-invocation-stable

stack-pack.mcp.references-catalog-ids        # MUST at Standard
stack-pack.mcp.no-sensitive-suggestions

stack-pack.validation.commands-well-formed   # MUST at Standard
stack-pack.validation.ci-safety-marked
stack-pack.validation.respects-project-scripts   # SHOULD

stack-pack.architecture.pattern-implemented      # SHOULD at Strict
stack-pack.architecture.suggested-layout-non-empty   # MUST when method exists
stack-pack.composability.composes-with-declared  # SHOULD at Strict

Running the harness #

import { runAdapterConformance, runStackPackConformance } from '@aidokit/core';
import { adapter } from '../src/index.js';

const report = await runAdapterConformance(adapter, adapter.manifest.conformance);
// report.overall === 'pass' | 'fail'
// report.results: ConformanceResult[]

ConformanceOptions: { fixture?, onlyChecks?, skipChecks?, strictSoft? }. Pass packagePath to enable AD-STD-CAP-01 source-level capability cross-check.

Snapshots and drift #

At install time, the CLI writes <projectRoot>/.aido/conformance-snapshot.json. aidokit doctor re-runs a subset and reports drift. Full harness lives in the package CI; doctor is the user-time sanity check.

Recovery from common failures #

From .docs/docs/specs/conformance-levels.md §13.3:

Related Pages #

• ../concepts/conformance-levels.md
• adapter-contract.md
• stack-pack-contract.md
• .docs/docs/specs/conformance-levels.md