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
- Mint:
zqk new object <kind> --title "..."(draft plane). Requirements/goals/milestones auto-runzqk workflow gen-trace-pipelineunless--skip-trace-pipeline. Do not hand-mint a 1:1 REQβCRIT. - Enrich: Use
zqk object ref add <id> <target_id>to link graph relationships (goal_refs,workstream_refs,priority_plan_ref,persona_refs). Usezqk object update <id> --field key=valueor--filestrictly for scalar content (e.g. titles, descriptions, metrics). - Promote:
zqk object promote <id>one hop when preconditions pass. Do not claim complete without VDS (zqk workflow vds evaluate). - Forbidden: editor save,
sed, or rewrite of.zqk/process/**/*.yaml. Untracked hash YAML is kernel state β nevergit cleanit. - Roadmap Gantt: Roadmaps frame products; workstreams are lanes; priority_plans are columns. A PRI stays
originateduntil it has a workstream lane, written identity, and persona/team refs; grooming then active requires a shovel-ready BLI. - Binary: examples use the default executable token. Live name is
brand.executable_name. Do not exportZQK_PROJECT_ROOTin the shell profile.