Module 0: ZQK Foundational Tenets & Architecture

Welcome to Module 0 of the Zen Quantum Kernel (ZQK) Masterclass. This tutorial establishes the architectural tenets and core mental models that power verifiable autonomous engineering teams.


1. The Core Dilemma: Autonomous Drift

When autonomous AI coding agents execute across sessions without a formal knowledge kernel, they suffer from three universal failure modes:

  1. Context Loss & Prompt Drift: Agents guess intent from transient chat buffers, losing the architectural boundary of previous sessions.
  2. Ghost Edits & Destructive Overwrites: Uncoordinated file touches overwrite sibling agent contributions and break test suites without atomic audit trails.
  3. Mocked / Illusory Completion: Agents report success prematurely based on superficial text outputs rather than cryptographic compiler contracts and physical proofs.

ZQK transforms your Git repository into a persistent, content-addressable knowledge kernel that unifies human engineers and AI swarms under a shared graph truth.

flowchart TD
    subgraph Dilemma["Traditional Agent Harnesses (Fragile)"]
        A[Prompt Context] -->|Session Loss| B[Hallucinated Intent]
        B -->|Ghost Edits| C[Silent Regression]
    end

    subgraph Solution["ZQK Knowledge Kernel (Verifiable)"]
        D[Knowledge Kernel Graph] -->|Curated Cascade| E[Self-Discovering Runway]
        E -->|Atomic Loops| F[AST-Verified Done Gates]
        F -->|Proof Telemetry| G[Zero-Drift Merges]
    end

2. The Three Foundational Tenets

Tenet 1: Curated Roadmap Discovery

Roadmaps are not loose prose or transient issue backlogs. They are curated top-down through a 5-layer cascade:

  • Layer 1: Strategic Vision & Mission: Architectural direction and north-star boundaries.
  • Layer 2: Timeless Goals (GOAL-*): Measurable long-term capabilities.
  • Layer 3: Tactical Priority Plans (PRI-*): Scoped milestones with dedicated integration branches.
  • Layer 4: Requirements & Criteria (REQ-*, CRIT-*): Timeless, falsifiable contracts.
  • Layer 5: Operational Backlog Items (BLI-*): Atomic units of verifiable execution.

The workflow engine reads the active plan runway directly from the kernel graph. Agents self-discover their exact mission in milliseconds without asking "what should I work on next?"

# Query the active runway and self-discover immediate mission
zqk workflow whats-next --format table

Tenet 2: Autonomous Task Execution & Done-Gates

Tasks are claimed directly from the groomed priority plan runway. ZQK is not limited to software source codeβ€”in research, ops, and systems engineering, the engine generates verifiable specifications and validates declarative contracts.

The autonomous process loop locks the merge gate fail-closed until physical evidence satisfies the Verifiable Decomposition Spine (VDS):

  • Zero race conditions (go test -race).
  • Zero unswallowed errors and 0 high/medium AST violations.
  • Cryptographically sealed commit hashes bound to the backlog item.
# Execute the atomic loop fail-closed
zqk do

Tenet 3: Multi-Agent Swarm Safety & Sandboxing

Swarm execution isolates each agent seat into its own private Git worktree with automated token circuit breakers:

  • Private Worktrees: Agents build on dedicated seats without colliding on git index locks or dirty working trees.
  • Token Circuit Breakers: Bounded spend ceilings cut execution immediately if an agent loops or drifts.
  • Promotional Done-Gates: The Technical Program Manager (TPM) merges the single verified pull request only when all seats satisfy AST criteria and test matrix DoD.
# Dispatch an AST-verified multi-agent swarm across a priority plan
zqk agent orchestrate PRI-STARTER-COMMUNITY-001

3. Video Showcase & Interactive Presentation

  • High-Definition Video: assets/productions/module0_toplevel_architecture.mp4 (1080p60 Manim Animation)
  • Captions & Transcript: assets/productions/module0_toplevel_architecture.srt
  • Rubric Audit Verification: Passed 100.0% across all 5 pillars of POL-MEDIA-INSPECTION-RUBRIC-001.

4. Next Steps

Continue to Module 1: Daily Orientation & The Workflow Suite to learn how human engineers and AI swarms begin their workday with sub-second orientation commands.