Documentation

The kernel, the two access surfaces (files and MCP), and how meshes connect harnesses together. Pick where you want to start.

Theory

Kernel

The universal principles behind harness.os. Four base types, five cross-cutting concerns, the inner/outer boundary, subtype inheritance.

Harness types and subtypes Cross-cutting concerns Three architectural zones Surfaces and sync patterns
Surface: Files

Scale 1 — File Harness

Knowledge organized as folders and markdown files. Natural for build:software and content. Any agent that can read files can use it.

Folder structure and conventions harness.yaml configuration File handlers per layer Sync with Scale 2
Surface: MCP

Scale 2 — MCP Server

Knowledge stored in PostgreSQL, accessed through MCP tools. Natural for product lifecycle, domain data, and governance queries.

Tool reference (47 tools) Session lifecycle Database schema Governance and audit
Connectivity

Mesh

How harness instances connect at runtime. Per-user meshes, cross-domain queries, the review layer for inter-mesh communication.

Mesh topology patterns Cross-domain queries Review layer Events and transactions
Distribution

marco.os

A detailed specification of one person's harness.os distribution. For each of thirteen subtypes: what the outer harness contains and which inner harness surface accesses it. A concrete example of the kernel applied.

13 subtypes across Build, Product, Operations, Domain Outer harness substance per subtype Inner harness surface choices Mesh topology summary