Skip to Content
DocumentationFeaturesPlatformThe writer & quality gate

The writer & quality gate

What it is

The single step in the pipeline where a language model runs. The repo-local article-writer skill fills a scaffolded page’s body from its _brief, then hands the draft to two more skills: the humanizer and the independent, blocking review-gate. The gtmesh CLI never calls a model; the writer never touches the registry.

Why it matters

This is the firewall that keeps GoToMesh deterministic. Every networked, non-deterministic, judgment-heavy task lives in a skill — never in the engine. The CLI scaffolds the page and records its status; the writer reads that assignment and writes prose. Because the two communicate only through the page file (_brief plus content) and the registry status, you can swap the model without touching the engine, and a re-run produces the same registry.

How it works

The article-writer works one page at a time — though because its writes stay inside that page’s own bundle, you can have several running on different slugs at once. Per page it:

  1. reads only that page’s _brief and schema stubs, plus templates/<type>.md and foundation/* (where brand.md carries the strategic “why”) — and, when the page is about an entity, that entity’s grounding facts folded into _brief.facts (fetching its source_url if present, as a primary source);
  2. fills the content fields and the editorial meta;
  3. runs the humanizer, then self-checks with gtmesh page validate <slug>;
  4. invokes the review-gate;
  5. on a pass, hands the slug back — it does not seal.

The review-gate scores the draft against the aeo: dimensions and thresholds in gtmesh.config.yaml (answer-block quality, self-containment, structure, specificity, first-party sourcing) and enforces the house voice. A page passes only when every dimension clears its bar, the weighted overall clears overall_threshold, and there are no blockers. On failure the page stays in writing with notes; on pass control returns to the writer.

Neither the gate nor the writer seals. A gate-passed page is handed back and stays in writing until you seal it — gtmesh page seal <slug…>, or the operator skill closing out a reviewed batch. Sealing writes the committed graph, so it belongs with the human’s approval step, and it keeps the write path single-threaded while several writers work in parallel.

Key files & flags

WhereWhat it tunes
gtmesh.config.yaml aeo:Dimensions, weights, thresholds, answer-block length
foundation/voice.mdThe target house voice the gate enforces
reference/editorial-rules.yamlBanned words and editorial lints (blockers)
templates/<type>.mdProse theory the writer follows per page type
Last updated on