Architecture Specification

Architecture

Semantic source

content/ holds constrained Markdown. registries/ holds claims, pages, sources, visuals, and protected identity records. models/ holds canonical architecture or diagram data. agents.md, agents/, and skills/ hold product-owned craft methods, never governance authority.

Projection

tools/build_projection.py produces deterministic build/index.json from semantic source. Generated output is ignored by Git and cannot satisfy source validation by itself.

Release boundary

tools/release.py candidate creates an immutable release candidate under releases/. promote and rollback atomically replace only the local publication/current-release.json pointer after explicit operator approval. The product repository has no live-directory writer.

Product Definition

Purpose

Provide one public-safe semantic source for Governed Execution Engine documentation. Executive, engineer, and AI reading modes are projections over the same claims, pages, sources, and visual models.

First slice

The bootstrap slice describes the product documentation boundary itself. It does not claim a client outcome, expose private recovery material, or alter the platform. It proves source traceability, reader-journey validation, projection reproducibility, and release/rollback mechanics.

Non-goals

No direct write to a live public directory.
No platform or governance changes.
No private corpus or runtime evidence in a public projection.
No renderer or theme migration under the initial content profile.

Documentation Workspace README

Governed Execution Engine Documentation

Product workspace for the public-safe Governed Execution Engine documentation. The source repository is private until Lee decides its remote visibility; its content is designed for a public projection at the existing product route.

The first permanent slice is intentionally small: one component page, its claim and source registries, one reader journey, a deterministic projection, and a release candidate seam. Presentation work under site/ and assets/ is reserved for a later explicit presentation or mixed delivery profile.

Source and output boundary

Source: sources/, content/, registries/, models/, agents/, and skills/.
Reader journeys: journeys/.
Generated: build/ and immutable releases/ entries.
Release pointer: publication/current-release.json.
Human questions: questions-for-the-human.md.

Run the product validators before considering a release candidate. A candidate is not a publication and promotion always requires an explicit operator approval plus preserved reader and independent-review evidence.