Skip to main content
SpecsADR 0010

ClawQL .cq* file extensions

Status: Draft specs · ADR 0010
License: Apache 2.0 (format specs are open; implementations may be any license)

Open, one-page specifications for ClawQL-owned file types. Base content remains human-readable YAML or OKF Markdown. The extension is a tooling signal, not a binary container.

SpecExtensionRole
cqm.md.cqmManifest (governance, release, policy)
cqe.md.cqeOntology entity
cqw.md.cqwKinetic-aware workflow
cqk.md.cqkProvenanced knowledge entry

Sequencing

  1. OKF on vault .mdmemory/okf.md (shipped)
  2. These draft specs (now)
  3. Dual-accept in CLI (e.g. ontology lint accepts .cqe + .yaml)
  4. Promote files + editor/CI hooks when stable

Design rule

A new extension is justified only when ClawQL-specific tooling must treat the file differently from generic YAML/Markdown. Configuration and plain OKF notes stay in existing formats.