You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(.impeccable): add placestoread reference, no-green rule, type size guidance, consistency checks, and narrow-screen behavior
- Primary visual model: placestoread.xyz (table, expand row, sorting, footer)
- Color aversion: no green; warm brown-red/ivory/earthy palette only
- Type sizing: default one step larger than impeccable scale; never reduce unprompted
- Row numbers: left-align, no leading zeros
- Visual consistency checklist: hover/focus, tag variants, typography tiers, gutters, color tokens
- Narrow-screen: < 960px and < 680px must stay functional; run playwright-cli after layout changes
Co-Authored-By: Claude <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: .impeccable.md
+24Lines changed: 24 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -41,10 +41,15 @@ Stay close to the current direction. It works.
41
41
42
42
References (what to stay close to):
43
43
44
+
-**https://www.placestoread.xyz** is the primary visual model for the table, expand row, sorting, and footer. "Like placestoread" means dense single-page list, inline click-to-expand rows that indent under the Name column, sortable headers, minimum decoration. When in doubt about a table or row treatment, check placestoread first.
44
45
- Magazine reference pages (The Economist, FT Weekend, Monocle).
- Library card catalogs. Dense tabular information, excellent typography, no decoration for decoration's sake.
47
48
49
+
Color aversions:
50
+
51
+
- No green. The user rejected it when picking the palette. Warm brown-red, ivory, and dark earthy tones are the established system. Do not introduce green even for success states or ancillary accents.
52
+
48
53
Anti-references (avoid strictly):
49
54
50
55
- Generic dark developer-tool look. No cyan on near-black, neon gradients, VSCode-palette dashboards, terminal-green monospace branding.
@@ -70,6 +75,8 @@ Layout and sizing:
70
75
- The impeccable skill reference rule "cap line length at ~65-75ch" does NOT apply here. Ignore it. Readability at wide widths is carried by vertical rhythm, leading, and the modular type scale instead.
71
76
- If you believe a width cap is actually necessary for some specific element, ask first with a concrete reason before adding it.
72
77
- Body type floor is 16px (`--text-base: 1rem`). Content-heavy passages may go to 1.125rem.
78
+
- When in doubt about any type size, pick one step larger than what the impeccable skill's scale references suggest. The user has repeatedly corrected sizes upward (11+ separate requests across 8 sessions). Never reduce an existing size unprompted. Footer, meta rows, expand content, labels, headings all trend too small by default.
79
+
- Row numbers in the table: left-align, no leading zeros. The user tried zero-padding and rejected it.
73
80
- Adjacent heading levels differ by at least 0.25rem of rendered size.
74
81
75
82
Color:
@@ -88,6 +95,23 @@ CSS hygiene:
88
95
- Never `text-transform`. Write the casing in the markup.
Before shipping any visual change, check peer elements. The user catches inconsistencies repeatedly.
101
+
102
+
- Hover and focus states: if one link type gets a hover treatment, peer links (hero topbar, footer, project names, sponsor names, expand-meta) share it.
103
+
- Tag variants (group, subcat, source, built-in) inherit the base `.tag` style and differ only where a real difference is needed.
104
+
- Typography tiers: labels that play the same role share size, weight, and letter-spacing.
105
+
- Symmetric gutters: logo left-gap equals logo right-gap, column paddings match across header and body.
106
+
- Role-based color tokens: same role uses the same token everywhere. No one-off inline `color: oklch(...)` buried in a rule.
107
+
108
+
Narrow-screen behavior:
109
+
110
+
The user actively tests `< 960px` and `< 680px`. Narrow screens must stay functional.
111
+
112
+
- Do not drop features that the user might want (sort affordance, filter chips, sticky header where reasonable). Hiding is a last resort and requires justification.
113
+
- Always run the `playwright-cli` skill at a narrow viewport after any layout change.
114
+
91
115
Absolute bans (from the impeccable skill):
92
116
93
117
- No `border-left` or `border-right` greater than 1px as a colored accent stripe on cards, list items, callouts, or alerts. Use a different structure.
0 commit comments