PAGE NAME · Techne

AGENT DIRECTIONS · the design system as instructions techne.coop/design-system/AGENT-DIRECTIONS.md · U-32 · September 2026 READ this file is the design system rewritten as directions an agent follows while writing or editing any page served from techne.coop. it adds no rule. every line below cites where the rule already stands. two sources govern, in this order: 1. commons/ui/commons.css the token layer and the shared patterns. canonical for every VALUE: a hex, a size, a spacing step, a face. scripts/token_audit.py refuses a page whose inline copy disagrees with it. 2. /design-system/ the reference a person reads. canonical for every USAGE rule: what blue is for, where the sunset range may appear, how a head block is built. where this file and either source disagree, the source wins and this file is the defect. report it. the estate is static html on GitHub Pages. no build step, no framework, no shared public stylesheet: every page inlines the token layer and its own rules (AGENTS.md REPO). you are writing one self-contained document that must look like the others without loading anything they load. STAND decide nothing this file does not decide. the following are open and are not yours: a palette other than the v4 sunset range (Vermilion Hour and Juniper Twilight are proposals, /design-system/#palettes); a type scale (v6 drafted one and was reverted, PR 276); a new token; a fourth container; a third typeface. if a page needs one, file a stop card (AGENTS.md STOP) and use what exists. 1. CHOOSE THE GRAMMAR FIRST every page is one of four shapes. name it in the page's head comment, then build only that shape. (/design-system/#layout; commons.css "the two grammars") document a reading column, prose-forward, scrolls. container .wrap, max-width 920px, padding 0 var(--s5). masthead .mast, sections .sec. most pages under /commons/, /legal/, /about/. instrument widescreen, no-scroll intent, mono-forward. container .wrap-hud, max-width 1600px. the HUD surfaces under /intranet/hud/. framed a signed-in members' surface inside the shell.

carries the frame measure (section 4c), never a class, never a pixel cap. every card list is a .frame-grid. scripts/measure_audit.py refuses drift. display the front page only. max-width 70rem, gutters clamp(var(--s5), 5vw, var(--s7)), interior prose measures in ch. do not make a second one without a stop card. a page loads exactly one frame (/design-system/#topbar; validate.py U-13): /assets/topbar.js for a public page, /assets/shell.css + /assets/shell.js for a signed-in page. a record page the members' map points at may load shell.js with data-public and keep topbar.js (U-15). no page carries an inline topbar of its own. 2. THE HEAD BLOCK, IN THIS ORDER copy this block. change only the marked values. (/design-system/#seo "Required block") PAGE NAME · Techne public page rules the block carries: - title pattern is "Page name · Techne"; the homepage alone is "Techne · technology as craft · Boulder"; a reference page is "Descriptor · Techne". - the description is distinct from every other page's, active voice, no "welcome to", leads with what the page holds. - the mode boot script is inline and sits BEFORE the first stylesheet or