The prior logo.svg used currentColor, which resolves to black when the
SVG is loaded via <img> on GitHub — making the logo invisible in dark
mode (the GitHub default for many users).
Fix uses GitHub's supported <picture> + prefers-color-scheme media-
source pattern in README:
- assets/logo-light.svg — explicit GitHub light-theme text color #24292f
- assets/logo-dark.svg — explicit GitHub dark-theme text color #f0f6fc
- assets/logo.svg — kept with embedded @media + currentColor for
standalone use (markmorph notes, anywhere
else the SVG is loaded outside <picture>)
README updates the <img> tag to a <picture> with media-conditioned
source so GitHub's renderer picks the right variant per theme.
Replaces the geometric-A-with-observation-dot with a softer, more
on-theme design: a swaddled-baby silhouette (rounded A-shape bundle),
face nestled inside, and the wrap-band extended past the bundle on
both sides as little hands. Maintains currentColor + zero external
assets; reads cleanly down to favicon size.
Ties the visual identity to the 'Story behind Adam' section: the
project is named after the author's son, and now the logo is too.
- New 'Story behind Adam' section at the top: the project is named after
the author's newborn son, whose observe-act-adjust-observe-again
learning loop is the methodology ADAM applies to LLM sessions.
- New SVG logo at assets/logo.svg: stylized 'A' with a captured
observation point inside the apex and a feedback crossbar. Uses
currentColor + gradient so it adapts to light/dark GitHub themes.
- Centered header block with project tagline + 5 badges (License,
Version, Tests, Node, Platform).
- New 'Highlights' section: 8 emoji-tagged one-liners covering the
v0.3.3 design pillars (zero LLM cost observation, A/B measurement,
sliding windows, observability, etc.).
- New 'How it works' ASCII pipeline diagram: observation -> analysis
pre-processors -> analyst -> review + apply.
- Signals table now includes per-signal sliding window column.
- Rubric section restructured: gates, modifiers (dampener), and
skill_edit-specific requirements clearly separated.
- New 'Inspecting the analyst's reasoning' section documenting
adam-explain.mjs + /reflect --explain.
- Layout updated for v0.3.3 state files (active-nudges.json,
ab-tracking.jsonl, reinforcements.jsonl, last-trace.txt) and all
9 new helper scripts under adam/scripts/.
- Test count: 27 -> 87.
- Closing line crediting Adam.
lukaszraczylo