Hk Shift Changelog

Shift-handover changelog (project-agnostic)

One living HTML page, rewritten (never appended) at every meaningful transition, redeployed to the SAME artifact URL every time. The reader is a teammate back from sleep or a weekend: they want the state of the world, not a log.

Where it lives

• File: one stable path in the repo (e.g. docs//changelog.html),

committed, so any future session can find and redeploy it.

• URL: record the artifact URL in the project's durable operator notes

(state/RESUME file) the first time you publish. Every later publish passes that url — never mint a second artifact for the same duty.

• Favicon: pick one emoji the first time; never change it (users find the

tab by icon).

Structure (top-down by how fast the reader wants out)

1. Header — project + "shift handover", a stamp saying what period it

covers (relative, not raw timestamps).

1. TL;DR box — 3-5 sentences: what changed, what's running, whether

anything is blocked on the reader. If they read nothing else, this suffices.

1. What happened, in order — timeline entries: a short label (wave

close / incident / directive / decision), a bold headline, 1-3 sentences, and a status pill (DONE / RUNNING / VERIFIED / WAITING). Every user directive gets its own entry so they can verify they were understood.

1. Scoreboard / metrics — whatever the project tracks (bucket scores,

suites, costs), as a table with movement + evidence, never bare deltas.

1. Waiting on you — a numbered list of decisions only the human can

make. This section earns the page its keep; keep it brutally current.

1. Footer — "living document, rewritten each transition" + where the

ground truth lives.

Design rules

Load the artifact-design skill before first authoring. Beyond it:

• Utilitarian treatment: real hierarchy, quiet type, one accent; both

themes via CSS tokens (prefers-color-scheme + data-theme overrides).

• Bind background AND text color to the SAME token set on html, body

with !important. The artifact shell may force its own body background; if your ink tokens go dark while its ground stays light, the page is unreadable (seen live). Background and ink must move together or not at all.

• Self-contained (CSP): no external fonts/scripts; system font stacks.
• Tables wrapped in overflow-x:auto; digits get tabular-nums.
• Plain language throughout; no ids or jargon the reader must decode; name

things by what they mean, cite ids only as secondary mono detail.

Cadence

Rewrite + redeploy at: phase/wave boundaries, incidents and their fixes, user directives received while away, score/metric movements, and anything that adds to "Waiting on you". Batch small transitions; never let the page drift more than ~30 min behind a meaningful one. Keep the file and the deployed artifact in lockstep — commit the file in the same breath.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: deepklarity
• Source: deepklarity/harness-kit
• License: MIT

Install and usage instructions live in the source repository linked above.