docs(design): impeccable PRODUCT.md + DESIGN.md project context#350
Merged
Conversation
Set up the impeccable skill's project context via `$impeccable init` then `$impeccable document`, so future design / critique / polish runs stay on-brand. - PRODUCT.md (strategic): register=product, users + purpose, the Precise/Honest/Editorial personality, anti-references (gamified retail-trading / generic SaaS-cream / hype AI-marketing / Bloomberg overload), 5 design principles, WCAG 2.1 AA target. - DESIGN.md (visual, Google Stitch 6-section format): North Star "Numbers you can read like a ledger" + the LedgerCraft tokens extracted from globals.css / tailwind.config.ts / visual.ts / docs/design.md (palette, typography, 4-tier elevation, components, do's & don'ts). - .impeccable/design.json: the Stitch sidecar (colorMeta + tonal ramps, shadow/motion tokens, narrative, 5 canonical components) for the impeccable live panel. Captures the EXISTING design system into the impeccable format -- no visual or code change. docs/design.md remains the canonical enforcement reference (frontend-design-system skill); these files are the impeccable-tool view of the same system. No compute / schema / scoring / valuation / frontend code. https://claude.ai/code/session_012xxKfyR939bZDmbxxqMFZi
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
dackclup
added a commit
that referenced
this pull request
Jun 1, 2026
…#352) $impeccable polish pass on the redesigned rankings surface (impeccable PRODUCT.md/DESIGN.md context from #350). - RankingTable mobile card: the daily price-change % pill was a solid green/red dopamine pill — the gamified-retail anti-reference named in PRODUCT.md, the only solid-fill semantic chip on the surface, and it hid a latent asymmetry (globals.css softens .bg-emerald-600 but has no .bg-rose-600 remap, so the down-pill rendered raw alarm-red while the up-pill was soft sage). Moved it to the shared outlined-light chip family (bg-{tone}-50 / text-{tone}-700 / ring-1 ring-inset ring-{tone}-200 + dark pairs), symmetric up/down; the up/down arrow stays as a non-color affordance (state never color-only). - visual.ts scoreAccentColor + MoSBadge accentColor doc-comments: corrected the false claim that the inline gauge accent is soft / remapped by globals.css (class overrides cannot reach an inline stroke/style value). Comment-only; accent values unchanged. - CLAUDE.md gotchas + AGENTS.md mirror: record the globals.css soft-override allowlist invariant (un-listed shades like bg-rose-600 render raw, not muted). - PHASE_STATUS_INFLIGHT.md: in-flight entry. Display-only (mobile/tablet card; the desktop table has no price-change column). No schema / compute / scoring / valuation change. https://claude.ai/code/session_012xxKfyR939bZDmbxxqMFZi Co-authored-by: Claude <noreply@anthropic.com>
dackclup
added a commit
that referenced
this pull request
Jun 1, 2026
…ccable document) (#354) Full regenerate of the impeccable design-context (created in #350) against the current code. The creative decisions locked in #350 (North Star, palette, typography, Named Rules, the 4 anti-references) are preserved verbatim; only the spec's accuracy had drifted, fixed here: - Elevation: DESIGN.md/sidecar claimed cards rest on shadow-medium and the hero on shadow-large. Reality (post-A3 reskin): only shadow-overlay is used anywhere (FilterDrawer) -- every card/table/hero is border-only `rounded`. Rewrote the Elevation section + sidecar shadow purposes so Subtle/Medium/Large read as defined-but-unused; an agent will no longer reach for a resting shadow. - Components: added ListingChips (#351 country/exchange chips) + HeroAttributeTiles (#344 4-box tile grid) to DESIGN.md and the sidecar, plus an Icons subsection (lucide named-import / country-flag-icons per-country tree-shake discipline) and the signature Score Gauge as the 8th sidecar entry. - Motion: corrected two sidecar easings -- gauge-sweep cubic-bezier(.22,1,.36,1) -> ease-in-out, hover-lift ease-out -> ease-in-out (the app-wide single curve, #330). - Sidecar Card css dropped its stale box-shadow (border-only); Recommendation Chip now uses the soft-OKLCH values that actually render after the globals.css override (expert-user-explorer-measured) instead of raw emerald hex. Added a Colors + Do's note on the soft-override allowlist (the bg-rose-600 gap from #352) + the gauge-stroke inline-rgb carve-out to the Tailwind-Class Rule. Doc-only (root DESIGN.md + .impeccable/design.json + PHASE_STATUS_INFLIGHT.md) -- no compute / schema / scoring / valuation / frontend-code change. JSON validated (schemaVersion 2, 8 components); the 6 Stitch headers present in order; YAML frontmatter parses. https://claude.ai/code/session_012xxKfyR939bZDmbxxqMFZi Co-authored-by: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Sets up the impeccable skill's project context, via
$impeccable init→$impeccable document, so future design / critique / polish / audit runs stay on-brand. Captures the existing QuantRank design system into the impeccable format — no visual or code change.Files
PRODUCT.md(strategic) — register =product; users + purpose; the Precise · Honest · Editorial personality; anti-references (gamified retail-trading / generic SaaS-cream / hype AI-marketing / Bloomberg overload); 5 design principles; WCAG 2.1 AA target. All confirmed via a structured interview round.DESIGN.md(visual, Google Stitch 6-section format) — North Star "Numbers you can read like a ledger" + the LedgerCraft tokens extracted fromglobals.css/tailwind.config.ts/lib/visual.ts/docs/design.md: palette (forest/steel/amber + OKLCH sage/rose), typography (Roboto Slab / IBM Plex Sans / JetBrains Mono), 4-tier elevation, components, do's & don'ts (anti-refs carried through verbatim)..impeccable/design.json— the Stitch sidecar (colorMeta + tonal ramps, shadow/motion tokens, narrative, 5 canonical components) the impeccable live panel renders from.Relationship to existing docs
docs/design.md+ thefrontend-design-systemskill remain the canonical enforcement reference. These new files are the impeccable-tool view of the same system — they describe, not redefine. Built on top of the now-merged impeccable vendoring (PR #348) and currentmain(incl. PR #349).No compute / schema / scoring / valuation / frontend code change — project-context docs only.
ruff check .passed; JSON validated.https://claude.ai/code/session_012xxKfyR939bZDmbxxqMFZi
Generated by Claude Code