Skip to main content
SpecsADR 0010

title: ClawQL .cq* file extensions

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.

Spec Extension Role
cqm.md .cqm Manifest (governance, release, policy)
cqe.md .cqe Ontology entity
cqw.md .cqw Kinetic-aware workflow
cqk.md .cqk Provenanced 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.