Skip to content

Developer Guide

Workflows and operating guides for contributors and agents. Concepts live in the knowledge bundle.

  • Adapter-Author Surface — The public import surface external subjects implement: adapters, constraint ports, and what the surface deliberately excludes.
  • Agent Harnesses — How agent harnesses reach AGENTS.md, the portability rules, and which harness-specific files the repository ships.
  • Agent-First Development Workflow — The agent-first development loop, context budget, parallel worktrees, handover lifecycle, and review boundaries.
  • Canonical Schema Publication (termverify.dev) — How the canonical schema publication at termverify.dev works and how to troubleshoot it.
  • The ConPTY Binding, the Terminal Adapter, and Cooperation Ports — Wiring the terminal adapter with the ConPTY binding: geometry, delivered tiers, sandbox disclosures, cooperation, and key encoding.
  • Development Environment — Tooling and quality gates, repository layout, the coverage ratchet, and testing tiers.
  • Direct Adapter — The deterministic in-process execution path: wiring, execution rules, and zero-reach subjects.
  • JSONL Adapter — Driving a subject subprocess over termverify.control/v1: spawning, the watchdog, and the reference fixture subject.
  • Release Process — The release checklist: preconditions, version scheme, cutting the release, provenance, and follow-up.