mirror of
https://github.com/EveryInc/compound-engineering-plugin.git
synced 2026-06-19 15:41:46 +02:00
Trevin Chow
2d8d60ec65
Two readability defects in generated HTML artifacts. Full-bleed text: the HTML rendering reference carried rich typography, color, and diagram guidance but said nothing about page layout, so docs rendered edge-to-edge on wide monitors with prose lines far past a readable measure. Add a fallback-default layout principle — centered content container (~820-960px band), prose held to a ~70ch measure with a named return-sweep test, and explicit permission for tables/diagrams to break out wider. Expressed in ch/rem and placed in precedence tier 4 so DESIGN.md and in-session direction still override. Buried execution notes: a unit's `Execution note` is a procedural directive the implementer must act on, but the reference described the unit metadata strip as a <dl> of Goal/Files/Dependencies without flagging that a directive is different in kind. Following it, the agent rendered Execution note as a passive <dt>/<dd> pair styled like a date, where it got skimmed past. State that descriptive fields stay in the <dl> while a directive renders as an advisory callout, and add execution notes to the callout-card examples. Named test: descriptive value -> metadata pair; something the reader must act on -> callout.