8000 Restore the owner's Aladdin design system on the README and site; real quick start by adeelahmad · Pull Request #126 · adeelahmad/aloop · GitHub
[go: up one dir, main page]

Skip to content

Restore the owner's Aladdin design system on the README and site; real quick start - #126

Merged
adeelahmad merged 18 commits into
masterfrom
claude/project-thread-l4nox2
Nov 20, 2026
Merged

adeelahmad merged 18 commits into
masterfrom
claude/project-thread-l4nox2

Conversation

@adeelahmad
@adeelahmad adeelahmad commented Nov 20, 2026 •
Copy link
Copy Markdown
Owner

Requested by Adeel · project thread

Cause

#94 (adopting the owner's Aladdin design system) was opened 2026-10-20 and never merged, so master kept #88's invented gold "a-loop" kit and lamp SVG. The site's only command was a shell aladdin "add CSV export to the report", which just records an intent file.

Fix

  • Merges Brand: adopt the Aladdin design system (README, site, banners, social preview) #94 onto master: wordmark option D, banners, social preview, tokens.
  • The owner's Aladdin's loop infographic (docs/diagrams/aladdins-loop.webp) heads the README and the site, as given.
  • Site rebuilt from the design system (the owner's zip, identical to the Oct 20 upload): wordmark top bar with the loop bar, four-dot signature, tinted phase panels 0–5 with agent chips and artifacts, the loop stepper, gate verdicts, the terminal, pill buttons, badges, Caveat asides, light canvas only. DM Sans, JetBrains Mono and Caveat are vendored in docs/brand/fonts/ (OFL), so the page stays self-contained.
  • A real quick start with the infographic's example, /aladdin Add rate limiting to the API; the roadmap through M12 on the README and the site.
  • README loop step 2 matches M11 (the typed intent is the grant). ROADMAP §4.11 and docs/brand/README.md record the owner's call.

Evidence

  • Commands run on Claude Code 2.1.329 in a clean HOME: claude plugin marketplace add adeelahmad/aloop ✓, claude plugin install aloop@aloop-marketplace ✓, /aladdin hi and /aloop:aladdin hi both reach the skill; plugin/bin/aladdin "Add rate limiting to the API" records the intent (rc 0).
  • Rendered with Playwright: fonts loaded DM Sans, JetBrains Mono, Caveat; phone width 390 has no horizontal scroll.
  • site.test.py 6/6 (brand, quick-start commands, vendored fonts, sourced costs; red on the old page), readme.test.py 8/8, check-tracking.py ok.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX

… preview)

The owner's Aladdin design system replaces the earlier gold "a-loop" kit:
- docs/brand/design-system/ vendors its tokens, guideline cards and the two
  social cards; gen_brand.py reads the colour tokens from it.
- Wordmark option D (DM Sans 800 over the blue-red-green-gold loop bar), its
  on-blue variant, the four-dot signature, an "A over the loop bar" icon with a
  whole-pixel 16 px cut, light and on-blue README banners, favicons, app icons.
- social-preview.png is the owner's card rendered at 2x, with the RED agent
  named red-worker, a measured-cost box from the evidence ledger, the mission
  layer in the feature list and a footer that no longer breaks words.
- og-card.png is a new large-type card that reads in a phone feed.
- README: no emoji (the design system's glyphs instead), blue release badge,
  design-system footer. Site: design-system palette (terminal palette in dark
  mode), the wordmark in the header, the lamp drawn flat without a gradient.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019o44PEkQ4qiLGMEes1QTKx
…width, pinned symbol fonts

From an adversarial review of the rebrand:
- README: the last emoji (an hourglass on "next") becomes →. readme.test.py
  now fails on any Emoji_Presentation code point, so the rule holds.
- Social preview: white numbers no longer sit on core red, green or gold
  (3.92, 3.06, 1.93:1): the red and green discs take the dark variants
  (5.80, 5.10) and the gold disc takes ink (8.32). check_palette checks
  these pairs.
- Site: the light card panel is white, the design system's plain card, so
  the gold-dark SCAFFOLD title is 4.65:1 instead of 4.41:1.
- Wordmark: the loop bar now includes the trailing letter-spacing, as the
  CSS it mirrors does (0.03 em narrower).
- render.mjs: file URLs come from pathToFileURL / Path.as_uri, and the
  render fails if any text falls back to a system font. Arrows, ● ◆ ✓ and
  ≠ ≤ come from pinned Noto faces, so the PNGs are byte-identical on rerun.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019o44PEkQ4qiLGMEes1QTKx
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
…s the real commands

#94 (the owner's Aladdin design system) sat unmerged since 2026-10-20, so
master kept the earlier invented gold kit. It is merged in the previous
commit. Here the owner's Aladdin's loop infographic heads the README and
the site, the site's hero shell command (which only records an intent) is
replaced by the real quick start with the infographic's example, and the
roadmap through M12 is on both. site.test.py and readme.test.py pin it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
@adeelahmad adeelahmad self-assigned this Nov 20, 2026
Rebuilt docs/index.html from the owner's design system: the option-D
wordmark top bar, the four-dot signature, tinted phase panels numbered
0-5 with agent chips and artifacts, the loop stepper, gate verdicts,
the terminal, pill buttons, badges, the infographic, DM Sans, JetBrains
Mono and Caveat (vendored, OFL), light canvas only. site.test.py checks
the wordmark markup, the vendored fonts and that every cost on the page
is one ROADMAP records.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
@adeelahmad adeelahmad changed the title Restore the owner's branding on the README and site; real quick start Restore the owner's Aladdin design system on the README and site; real quick start Nov 20, 2026
…mmands verified on the M12 branch

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
…les plug in)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
… and distros

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
… branch

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
…ral GA accounts

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
…the GA4 id list

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
…randing branch; the site links the merged how-to

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
…nical URL is aloop.adeelahmad.net

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
…resource

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeZyj8wdhHQDM35jZMC9kX
@adeelahmad
adeelahmad merged commit ea8ee63 into master Nov 20, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

0