<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/development/reporting/debrief-styleguide/">
  <id>https://docs.spec-kitty.ai/development/reporting/debrief-styleguide/</id>
  <title>Executive Debrief House Style</title>
  <updated>2026-10-08T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/development/reporting/debrief-styleguide/"/>
  <summary>House style for Spec Kitty executive debriefs (what-happened reports): the long-form and one-pager layouts, readers and voice, brand palette, and print treatment.</summary>
  <content type="html">&lt;h2 id=&quot;debrief-house-style--executive-debriefs-what-happened&quot;&gt;Debrief house style — executive debriefs (“what happened”)&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Status:&lt;/strong&gt; the design system’s house style, now shipped as the internal
doctrine styleguide
&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty-open-packs/blob/main/packs/internal/styleguides/executive-debrief.styleguide.yaml&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;packs/internal/styleguides/executive-debrief.styleguide.yaml&lt;/code&gt;&lt;/a&gt;.
This page is that artifact’s detailed layout, palette and print-treatment reference.
&lt;strong&gt;Applies to:&lt;/strong&gt; the reports produced by the &lt;code dir=&quot;auto&quot;&gt;kitty-report-debrief&lt;/code&gt; pack skill — the
time-window “what landed since &lt;t&gt;” debrief and the milestone/label open-issue
snapshot. One-pager examples: &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/tree/main/docs/development/reporting/examples&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;examples/&lt;/code&gt;&lt;/a&gt;.&lt;/t&gt;&lt;/p&gt;
&lt;h2 id=&quot;two-layouts&quot;&gt;Two layouts&lt;/h2&gt;








































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;One-pager&lt;/th&gt;&lt;th&gt;Long-form debrief&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Use when&lt;/td&gt;&lt;td&gt;counts and a few labelled clusters answer the question&lt;/td&gt;&lt;td&gt;readers need a mechanism explained, a trend shown, or a decision prepared&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Length&lt;/td&gt;&lt;td&gt;1 to 2 pages&lt;/td&gt;&lt;td&gt;about 5 to 12 pages&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Source&lt;/td&gt;&lt;td&gt;a slot object (JSON)&lt;/td&gt;&lt;td&gt;one Markdown file&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Renderer&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/internal/assets/debrief/render-debrief.py&lt;/code&gt; + &lt;code dir=&quot;auto&quot;&gt;debrief-template.html&lt;/code&gt;, printed with a headless browser&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/internal/assets/spec-kitty-branded-pdf.py&lt;/code&gt; (pandoc + WeasyPrint)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Status shown by&lt;/td&gt;&lt;td&gt;pills and tiles&lt;/td&gt;&lt;td&gt;words and tables&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Reference check&lt;/td&gt;&lt;td&gt;the renderer fails closed on a &lt;code dir=&quot;auto&quot;&gt;#ref&lt;/code&gt; outside &lt;code dir=&quot;auto&quot;&gt;valid_refs&lt;/code&gt;&lt;/td&gt;&lt;td&gt;the writer checks every &lt;code dir=&quot;auto&quot;&gt;#ref&lt;/code&gt; against the collector output and the saved supplemental files&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Both follow the same rules for facts, readers and voice (see “Voice &amp;#x26; content
conventions” below). The Palette, Typography, One-pager layout grammar and Pill
vocabulary sections describe the one-pager template. The long form takes its
colours and type from the branded generator and needs no styling of its own.&lt;/p&gt;
&lt;h2 id=&quot;long-form-debrief&quot;&gt;Long-form debrief&lt;/h2&gt;
&lt;p&gt;A long-form debrief is one Markdown file rendered by the branded PDF generator.
Do not build a cover, a footer or a stylesheet by hand: the generator draws
them from the design tokens. Its look is documented in
&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty-open-packs/blob/main/packs/internal/toolguides/BRANDED_DOCUMENT_GENERATION.md&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;BRANDED_DOCUMENT_GENERATION.md&lt;/code&gt;&lt;/a&gt;.&lt;/p&gt;
&lt;h3 id=&quot;order-fixed&quot;&gt;Order (fixed)&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Cover&lt;/strong&gt;, set through generator arguments, not Markdown:
&lt;ul&gt;
&lt;li&gt;eyebrow: &lt;code dir=&quot;auto&quot;&gt;Spec Kitty · Executive Debrief&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;title: &lt;code dir=&quot;auto&quot;&gt;WTF happened with &amp;#x3C;X&gt;&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;WTF happened since &amp;#x3C;T&gt;&lt;/code&gt;, two lines at most&lt;/li&gt;
&lt;li&gt;subtitle: the subject and the period, one line&lt;/li&gt;
&lt;li&gt;lede: two or three sentences a reader can stop after&lt;/li&gt;
&lt;li&gt;three meta chips: &lt;code dir=&quot;auto&quot;&gt;AS OF&lt;/code&gt; (date), &lt;code dir=&quot;auto&quot;&gt;SCOPE&lt;/code&gt; (repository), &lt;code dir=&quot;auto&quot;&gt;FOR&lt;/code&gt; (the readers,
as the requester named them, separated by &lt;code dir=&quot;auto&quot;&gt;·&lt;/code&gt;)&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Executive summary&lt;/strong&gt;, one page, readable alone:
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Bottom line.&lt;/strong&gt; Three to six sentences.&lt;/li&gt;
&lt;li&gt;One small table of headline counts or a before/after comparison.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;What happened.&lt;/strong&gt; A numbered list of three to five items. Each starts with
a bold one-sentence claim, then gives the evidence.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Still open.&lt;/strong&gt; Optional, one sentence pointing at Open risks.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;What we need from leadership.&lt;/strong&gt; Two to four decisions, each with the
fact that forces it.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Parts&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;Part A. …&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;Part B. …&lt;/code&gt;) with subsections. Four to six themes in
total across the parts. Tables for before/after and for lists of four or
more comparable items; prose for mechanisms.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Open risks.&lt;/strong&gt; One table: Risk, Why it matters, Issue, Owner. Write the risk
as the consequence for a user or a release. Issue is the ref with its
priority, or “none filed”. Owner is the GitHub assignee at collection time,
“unassigned”, or the role that must decide.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Appendix: method, sources and caveats.&lt;/strong&gt; The Method line, scope and as-of,
a definition for any measure that could be read two ways, the data files,
and the caveats as a list.&lt;/li&gt;
&lt;/ol&gt;
&lt;h3 id=&quot;headings&quot;&gt;Headings&lt;/h3&gt;
&lt;p&gt;The generator draws a first-level heading (&lt;code dir=&quot;auto&quot;&gt;#&lt;/code&gt;) as a part title with a yellow
underline and a second-level heading (&lt;code dir=&quot;auto&quot;&gt;##&lt;/code&gt;) as a left-ruled subsection. The body
passed to the generator therefore starts at &lt;code dir=&quot;auto&quot;&gt;# Executive summary&lt;/code&gt;, with
&lt;code dir=&quot;auto&quot;&gt;# Part A. …&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;# Open risks&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;# Appendix: …&lt;/code&gt; at the same level. The document
title lives on the cover and is not repeated as a heading.&lt;/p&gt;
&lt;h3 id=&quot;charts&quot;&gt;Charts&lt;/h3&gt;
&lt;p&gt;Add a chart only for a trend or a comparison the reader would otherwise rebuild
from a table. One measure and one axis per chart. Title it with the measure and
the unit, label values directly when there are few marks, and draw it from a
collected file. Save it as SVG beside the Markdown and include it as an image.
A white chart card on the cream page is fine.&lt;/p&gt;
&lt;h3 id=&quot;render&quot;&gt;Render&lt;/h3&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;python&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;packs/internal/assets/spec-kitty-branded-pdf.py&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--input&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;body.md&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--output&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;debrief.pdf&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--eyebrow&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Spec Kitty · Executive Debrief&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--title&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;WTF happened&amp;#x3C;br&gt;since 4.0.0rc5&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--subtitle&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Four days on main after the fifth release candidate&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--lede&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Two or three sentences.&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--footer-center&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;SINCE 4.0.0RC5 · 2026-10-06&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--meta&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;AS OF=2026-10-06&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--meta&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;SCOPE=spec-kitty/spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--meta&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;FOR=CTO · CEO · CPO · Head of QA · maintainers&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Then open the PDF and look at every page: a table header alone at a page
bottom, a chart label that collides with its title, or a cover chip that wraps
badly is fixed in the Markdown or the arguments, not left in.&lt;/p&gt;
&lt;h3 id=&quot;supplemental-facts&quot;&gt;Supplemental facts&lt;/h3&gt;
&lt;p&gt;The collector returns merged PRs, closed issues and headline counts. A long-form
debrief often needs more: open P0s, milestone counts, nightly runs, git
statistics, file sizes. Read each with &lt;code dir=&quot;auto&quot;&gt;gh&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;git&lt;/code&gt; into a file under &lt;code dir=&quot;auto&quot;&gt;raw/&lt;/code&gt;
beside the collector output, and list those files in the appendix. Every number
and every &lt;code dir=&quot;auto&quot;&gt;#ref&lt;/code&gt; in the report must be in the collector output or one of those
files. A fact that was not saved does not go in.&lt;/p&gt;
&lt;h2 id=&quot;provenance--this-is-the-design-systems-style-not-ad-hoc&quot;&gt;Provenance — this is the design system’s style, not ad-hoc&lt;/h2&gt;
&lt;p&gt;The look is taken from &lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;@spec-kitty/tokens&lt;/code&gt;&lt;/strong&gt; in the sibling
&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty-design&lt;/code&gt;&lt;/strong&gt; repo (the &lt;code dir=&quot;auto&quot;&gt;packages/tokens&lt;/code&gt; package, ADR-003
&lt;code dir=&quot;auto&quot;&gt;--sk-&amp;#x3C;category&gt;-&amp;#x3C;name&gt;&lt;/code&gt; naming). The debrief template
(&lt;code dir=&quot;auto&quot;&gt;packs/internal/assets/debrief/debrief-template.html&lt;/code&gt;) inlines a &lt;strong&gt;curated light-theme
subset&lt;/strong&gt; of those tokens; when a value here and a token there ever disagree,
the token package wins — re-sync the subset, don’t fork it.&lt;/p&gt;
&lt;h2 id=&quot;palette-light-theme--these-are-printed-documents&quot;&gt;Palette (light theme — these are printed documents)&lt;/h2&gt;




























































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Role&lt;/th&gt;&lt;th&gt;Token&lt;/th&gt;&lt;th&gt;Value&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Signature primary&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--sk-color-yellow&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;#F5C518&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Link / accent (light)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--sk-color-sage&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;#4F8F4F&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Success · &lt;strong&gt;SHIPPED&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--sk-color-green&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;#8FCB8F&lt;/code&gt; on &lt;code dir=&quot;auto&quot;&gt;--sk-surface-tint-mint&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;#E8F4E8&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Alert · &lt;strong&gt;WATCH / P0&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--sk-color-red&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;#E97373&lt;/code&gt; on &lt;code dir=&quot;auto&quot;&gt;--sk-surface-tint-sky&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;#E4EDF8&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Page&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--sk-surface-page&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;#FCFAF4&lt;/code&gt; (light warm cream — the design system’s “hero” tone; lighter than the &lt;code dir=&quot;auto&quot;&gt;#F8F5EC&lt;/code&gt; page surface so print reads easier)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Warm-gold accent&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--sk-color-haygold&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;#D9B36A&lt;/code&gt; (card left-edge accent)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Card&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--sk-surface-card&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;#FFFFFF&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Chip rail&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--sk-surface-pill&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;#ECE7D8&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Ink / body / muted / label&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--sk-fg-default/body/muted/subtle&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;#1A1A14&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;#2A2A22&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;#5C5C52&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;#8A8A7E&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Hairline / card border&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--sk-border-default/strong&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;#EAE4D2&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;#D6CFB9&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Yellow is the brand signature — use it sparingly, as an &lt;strong&gt;accent&lt;/strong&gt;, never for
status: the title carries a short yellow “bow” underline (echoing the logo), and
the metric-tile card has a yellow top-accent bar. Section cards take a warm-gold
(&lt;code dir=&quot;auto&quot;&gt;--sk-color-haygold&lt;/code&gt;) left edge. Status colour stays green (good) / red
(attention) only.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Full-bleed print, with an in-flow continuation-page top inset.&lt;/strong&gt; The
warm-cream page colour reaches every edge — no white printer margin anywhere —
via &lt;code dir=&quot;auto&quot;&gt;@page { margin: 0 }&lt;/code&gt;, the cream on both &lt;code dir=&quot;auto&quot;&gt;html&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;body&lt;/code&gt;, and
&lt;code dir=&quot;auto&quot;&gt;print-color-adjust: exact&lt;/code&gt;. Content on pages 2+ is shifted down &lt;strong&gt;in flow&lt;/strong&gt;, not
with a page margin. Two rules make that work and survive a page break:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Never split a top-level block across a page&lt;/strong&gt; — &lt;code dir=&quot;auto&quot;&gt;break-inside: avoid&lt;/code&gt; on
&lt;code dir=&quot;auto&quot;&gt;.tiles&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.highlights&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.section&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;table&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;break-after: avoid&lt;/code&gt; on
&lt;code dir=&quot;auto&quot;&gt;h2&lt;/code&gt; — so every continuation page begins with a whole block, not a torn one.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Reserve the top space with a transparent top &lt;em&gt;border&lt;/em&gt;, not a margin.&lt;/strong&gt;
Chromium &lt;em&gt;drops&lt;/em&gt; a block’s top margin when it starts a continuation page but
&lt;em&gt;keeps&lt;/em&gt; its border, so &lt;code dir=&quot;auto&quot;&gt;h2&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;.section&lt;/code&gt; carry a &lt;code dir=&quot;auto&quot;&gt;~1.6–1.9rem&lt;/code&gt; transparent
top border. With &lt;code dir=&quot;auto&quot;&gt;background-clip: padding-box&lt;/code&gt; on the cards, that border
shows the cream page through it — the content sits lower, the background does
not turn white. (This is why the earlier &lt;code dir=&quot;auto&quot;&gt;@page { margin-top }&lt;/code&gt; attempt failed:
Chromium paints the page-margin box white and does &lt;strong&gt;not&lt;/strong&gt; propagate the root
background into it.) The card’s warm-gold left accent is drawn by a &lt;code dir=&quot;auto&quot;&gt;::before&lt;/code&gt;
bar from the content top, so it never stubs into the cream gap.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Trade-off: &lt;code dir=&quot;auto&quot;&gt;break-inside: avoid&lt;/code&gt; can push a whole card to the next page, leaving
cream whitespace at a page bottom. That is intended — cream is easy on the eyes,
and a clean top edge matters more than dense packing.&lt;/p&gt;
&lt;p&gt;These are &lt;strong&gt;light-chromed on purpose&lt;/strong&gt;: print/PDF is far easier to read light,
so the dark-theme tokens are never used here.&lt;/p&gt;
&lt;h2 id=&quot;typography&quot;&gt;Typography&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Display&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;h1&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;h2&lt;/code&gt;, tile numbers): &lt;strong&gt;Falling Sky&lt;/strong&gt;, weight 800
(&lt;code dir=&quot;auto&quot;&gt;--sk-font-display&lt;/code&gt;). The OTFs live in
&lt;code dir=&quot;auto&quot;&gt;spec-kitty-design/packages/tokens/fonts&lt;/code&gt;; embed them via &lt;code dir=&quot;auto&quot;&gt;@font-face&lt;/code&gt; for a
fully-branded PDF. Without them the stack degrades to system sans.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Mono&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;--sk-font-mono&lt;/code&gt;): &lt;strong&gt;JetBrains Mono&lt;/strong&gt; — the eyebrow, the meta line,
section titles, table headers, &lt;code dir=&quot;auto&quot;&gt;code&lt;/code&gt;, and status pills’ cousins. Loaded from
the same Google Fonts CDN the token package uses.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Body&lt;/strong&gt;: system sans (&lt;code dir=&quot;auto&quot;&gt;--sk-font-sans&lt;/code&gt;). &lt;strong&gt;Swansea&lt;/strong&gt; is the design system’s
secondary reference face — reserve it for long-form, not these one-pagers.&lt;/li&gt;
&lt;li&gt;Scale: title 40px, section heading 24px, tile number 34px, body 15px, lede
17px, eyebrow/label 12px.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;one-pager-slot-contract&quot;&gt;One-pager slot contract&lt;/h2&gt;
&lt;p&gt;The one-pager’s synthesis step produces exactly one JSON object, the slots the
renderer fills into the template, and nothing else. Every &lt;code dir=&quot;auto&quot;&gt;#NNNN&lt;/code&gt; in any slot
must appear in the collector’s &lt;code dir=&quot;auto&quot;&gt;valid_refs&lt;/code&gt;; the renderer fails closed on any
other. Meta-line values come from the collector’s &lt;code dir=&quot;auto&quot;&gt;meta&lt;/code&gt;, tile numbers from its
&lt;code dir=&quot;auto&quot;&gt;metrics&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;method&lt;/code&gt; is copied from &lt;code dir=&quot;auto&quot;&gt;meta.method&lt;/code&gt; (extend it only with true
caveats).&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;jsonc&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;{&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;eyebrow&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;SPEC KITTY · EXECUTIVE OVERVIEW&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;title&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;What landed since Friday morning&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;meta_line&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;Window: … · main at &amp;#x3C;sha&gt; · Repos: …&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,   &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5D6376&quot;&gt;// built from meta&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;lede&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;1–3 sentence synthesis of the window or scope.&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;tiles&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [{&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;n&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;47&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;label&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;pull requests merged&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;class&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;},&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;            &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;n&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;18&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;label&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;P0 issues still open&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;class&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;alert&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}],&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;highlights_heading&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;The bottom line&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,                &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5D6376&quot;&gt;// or &quot;Key takeaways&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;highlights&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [{&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;pill&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;SHIPPED&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;pill_class&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;shipped&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;text&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;…&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;},&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;                 &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;pill&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;WATCH&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,   &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;pill_class&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;watch&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,   &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;text&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;…&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}],&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;body_heading&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;What shipped, by theme&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,               &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5D6376&quot;&gt;// or &quot;By cluster&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;sections&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [{&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;title&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;1. Protecting user work&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;count&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;8 PRs · 9 P0s&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;                &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;intro&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;…&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;items&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [{&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;pill&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;P0&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;text&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;…&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;refs&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;#5050&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}]}],&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;decisions_heading&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;What&apos;s next and needs a decision&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5D6376&quot;&gt;// window mode only&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;decisions&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [{&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;item&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;…&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;status&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;PR OPEN&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;owner&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;the maintainer&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}],&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;authors_line&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;One maintainer authored 40 of 46 engine PRs; …&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;&amp;#x3C;copy meta.method verbatim&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;The collector’s JSON carries &lt;code dir=&quot;auto&quot;&gt;meta&lt;/code&gt; (mode, filters, &lt;code dir=&quot;auto&quot;&gt;main_shas&lt;/code&gt;, the generated
&lt;code dir=&quot;auto&quot;&gt;method&lt;/code&gt; line), &lt;code dir=&quot;auto&quot;&gt;metrics&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;authors&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;pull_requests&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;closed_issues&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;open_issues&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;valid_refs&lt;/code&gt;. The template dialect is &lt;code dir=&quot;auto&quot;&gt;{{ SLOT }}&lt;/code&gt; for a
scalar, &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;!-- @each NAME --&gt;&lt;/code&gt; to repeat a block and &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;!-- @if NAME --&gt;&lt;/code&gt; to keep
one when the value is non-empty.&lt;/p&gt;
&lt;h2 id=&quot;one-pager-layout-grammar-fixed-order&quot;&gt;One-pager layout grammar (fixed order)&lt;/h2&gt;
&lt;ol start=&quot;0&quot;&gt;
&lt;li&gt;&lt;strong&gt;Brand mark&lt;/strong&gt; — the Spec Kitty logo (&lt;code dir=&quot;auto&quot;&gt;packs/internal/assets/debrief/logo.png&lt;/code&gt;, mirrored from
&lt;code dir=&quot;auto&quot;&gt;@spec-kitty/tokens&lt;/code&gt;) top-left, ~52px. The PNG carries a light baked
background; &lt;code dir=&quot;auto&quot;&gt;mix-blend-mode: multiply&lt;/code&gt; dissolves it into the cream so only
the line-art shows.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Eyebrow&lt;/strong&gt; — mono, uppercase, tracked: &lt;code dir=&quot;auto&quot;&gt;SPEC KITTY · EXECUTIVE OVERVIEW&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Title&lt;/strong&gt; — the question answered: &lt;em&gt;What landed since Friday morning&lt;/em&gt; /
&lt;em&gt;Milestone 11 — “4.0.0 release scope”: open issues&lt;/em&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Meta line&lt;/strong&gt; — mono, generated from &lt;code dir=&quot;auto&quot;&gt;meta&lt;/code&gt;: window (both timezones), &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;
SHA, repos / snapshot date. Never hand-typed.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Lede&lt;/strong&gt; — 1–3 sentences of synthesis.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Tiles&lt;/strong&gt; — one bordered card row of the headline metrics; the
attention number (open P0s) uses &lt;code dir=&quot;auto&quot;&gt;.n.alert&lt;/code&gt; (red).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Highlights&lt;/strong&gt; — “The bottom line” (window) / “Key takeaways” (scope), each
line led by a pill.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Body sections&lt;/strong&gt; — “What shipped, by theme” (window) / “By cluster” (scope),
each a card with a mono title, a right-aligned count, an intro, and a
ref-bearing bullet list. 4–6 sections; never more.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Decision table&lt;/strong&gt; (window only) — Item / Status / Owner.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Footer&lt;/strong&gt; — “Who shipped it” (author attribution) + the generated &lt;strong&gt;Method&lt;/strong&gt;
line.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;pill-vocabulary-the-design-systems-sk-tag&quot;&gt;Pill vocabulary (the design system’s &lt;code dir=&quot;auto&quot;&gt;.sk-tag&lt;/code&gt;)&lt;/h2&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Pill&lt;/th&gt;&lt;th&gt;Class&lt;/th&gt;&lt;th&gt;Meaning&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;SHIPPED&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.sk-tag--shipped&lt;/code&gt; (green tint)&lt;/td&gt;&lt;td&gt;landed in this window&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;WATCH&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.sk-tag--watch&lt;/code&gt; (red on sky)&lt;/td&gt;&lt;td&gt;open risk / still catching up&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;P0&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.sk-tag--p0&lt;/code&gt; (red on sky)&lt;/td&gt;&lt;td&gt;release-blocking item&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Status uses &lt;code dir=&quot;auto&quot;&gt;STATUS&lt;/code&gt;-style words in the decision table
(&lt;code dir=&quot;auto&quot;&gt;ON MAIN, UNTAGGED&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;PR OPEN&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;AWAITING CALL&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;FILED&lt;/code&gt;), mono, muted.&lt;/p&gt;
&lt;h2 id=&quot;voice--content-conventions&quot;&gt;Voice &amp;#x26; content conventions&lt;/h2&gt;
&lt;p&gt;These apply to both layouts. General report voice (plain words, few em-dashes,
no puffery, every number attributed) comes from the &lt;code dir=&quot;auto&quot;&gt;report-writing&lt;/code&gt; styleguide
and is not repeated here.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Name the readers.&lt;/strong&gt; A debrief goes to leadership (for example CTO, CEO,
CPO, Head of QA) and to the maintainers in one document. Ask who it is for if
the request does not say, and put them on the cover (&lt;code dir=&quot;auto&quot;&gt;FOR&lt;/code&gt;) or in the meta
line.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Write the top for the least technical named reader.&lt;/strong&gt; The executive summary
(or the lede and highlights) must work for someone who knows the product but
not the code. Module names, gate names, error codes and lane mechanics belong
in the parts and the appendix. Explain an internal term in one clause the
first time it appears: “&lt;code dir=&quot;auto&quot;&gt;consolidate&lt;/code&gt;, the command that lands finished work”.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;BLUF, consumer-first.&lt;/strong&gt; Lead each bullet with the impact a user/operator
saw, then the mechanism. Plain language, active voice, concrete before→after.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;End the summary with the ask.&lt;/strong&gt; Close with what the readers must decide,
each decision next to the fact that forces it. If nothing needs deciding, say
so in one line.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Name the failure class when it fits.&lt;/strong&gt; The recurring “silent and exit 0”
framing (a command that destroys/hides/mis-lands work while reporting success)
is the house way to describe the most damaging defects. Use it where the
collected defects are of that kind. Do not force it onto a debrief about
something else, such as CI runtime.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Say what the data does not show.&lt;/strong&gt; “A correlation, not a proven cause.”
“Three days and 119 runs: an early signal, not a settled trend.” When a claim
rests on an earlier debrief rather than on this collection, say so in the
sentence.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;State uncomfortable facts plainly and once.&lt;/strong&gt; A release shipped under a
waiver, one author on most PRs, more issues opened than closed: give the
count, put it in Open risks, and do not soften or repeat it.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Consumer-impact lens for release scopes.&lt;/strong&gt; Foreground consumer-facing,
silent-false-success defects; hold internal/loud/unreachable ones off the top.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Method-footer honesty (non-negotiable):&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;Every number is queried, stated as such — never estimated.&lt;/li&gt;
&lt;li&gt;“closed as fixed” (GitHub’s reason) ≠ “verified fixed” (a linked PR); say
&lt;em&gt;closed&lt;/em&gt; for anything not verified (the #4891 caveat).&lt;/li&gt;
&lt;li&gt;Impact tags in scope mode are a preliminary read until code-verified — say so.&lt;/li&gt;
&lt;li&gt;Author attribution comes from the PR author field.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;promotion-done&quot;&gt;Promotion (done)&lt;/h2&gt;
&lt;p&gt;This house style is now shipped as an activatable styleguide artifact in the
internal Charter Pack: &lt;code dir=&quot;auto&quot;&gt;packs/internal/styleguides/executive-debrief.styleguide.yaml&lt;/code&gt;
(it &lt;em&gt;refines&lt;/em&gt; &lt;code dir=&quot;auto&quot;&gt;report-writing&lt;/code&gt; and is &lt;em&gt;suggested&lt;/em&gt; by the
&lt;code dir=&quot;auto&quot;&gt;executive-debrief-generation&lt;/code&gt; procedure, which is in &lt;code dir=&quot;auto&quot;&gt;org-charter.yaml&lt;/code&gt;’s
&lt;code dir=&quot;auto&quot;&gt;required_procedures&lt;/code&gt;). Internal doctrine never ships to consumers, it governs how
&lt;em&gt;we&lt;/em&gt; report. That YAML is the durable, activatable doctrine; this page is the
detailed layout, palette and print-treatment reference it links to. Converging the
one-pager renderer’s brand assets (fonts/logo/palette) with the canonical
&lt;code dir=&quot;auto&quot;&gt;spec-kitty-branded-pdf&lt;/code&gt; generator is tracked as follow-up #5273.&lt;/p&gt;</content>
</entry>
