Kernel Object Stewardship (CLI-only CAS)

Objective

Keep the knowledge kernel coherent. Process data under .zqk/process/ is content-addressed. Hand-edits break filenames, caches, and object get.

Protocol

  1. Mint: zqk new object <kind> --title "..." (draft plane). Requirements/goals/milestones auto-run zqk workflow gen-trace-pipeline unless --skip-trace-pipeline. Do not hand-mint a 1:1 REQ→CRIT.
  2. Enrich: Use zqk object ref add <id> <target_id> to link graph relationships (goal_refs, workstream_refs, priority_plan_ref, persona_refs). Use zqk object update <id> --field key=value or --file strictly for scalar content (e.g. titles, descriptions, metrics).
  3. Promote: zqk object promote <id> one hop when preconditions pass. Do not claim complete without VDS (zqk workflow vds evaluate).
  4. Forbidden: editor save, sed, or rewrite of .zqk/process/**/*.yaml. Untracked hash YAML is kernel state β€” never git clean it.
  5. Roadmap Gantt: Roadmaps frame products; workstreams are lanes; priority_plans are columns. A PRI stays originated until it has a workstream lane, written identity, and persona/team refs; grooming then active requires a shovel-ready BLI.
  6. Binary: examples use the default executable token. Live name is brand.executable_name. Do not export ZQK_PROJECT_ROOT in the shell profile.