Vedank Vansia ee3ca5f4f0 refine typography-hierarchy craft docs — clarify edge cases and make lint measurable (#979) ... * add typography-hierarchy and typography-hierarchy-editorial craft rules Adds two layered craft files extending typography.md: - typography-hierarchy.md: core hierarchy contract, vectors, failure modes, controlled violations, and lint checklist - typography-hierarchy-editorial.md: editorial pacing, dramatic scale jumps, whitespace hierarchy, display tracking overrides, and editorial-specific lint Both files are registered in craft/README.md with guidance on when to require them. Includes a new editorial stack example showing the layered opt-in pattern. Validation: - pnpm guard: PASSED - Universal craft knowledge (not brand-specific) - Stable slugs: typography-hierarchy, typography-hierarchy-editorial - No new dependencies or breaking changes Passes craft additions lane per code-review-guidelines.md. * wire typography base into editorial skills craft stack All three editorial skills now require the complete layered stack: [typography, typography-hierarchy, typography-hierarchy-editorial, rtl-and-bidi] The new hierarchy files (typography-hierarchy.md, typography-hierarchy-editorial.md) explicitly extend typography.md and depend on its base contract (scale ranges, tracking values, line-height guidance, weight system). Without typography in requires[], the hierarchy rules arrive at runtime without their foundational contracts, making them incomplete. Skills updated: - skills/blog-post/SKILL.md - skills/docs-page/SKILL.md - skills/digital-eguide/SKILL.md This completes the craft injection for the editorial stack as documented in craft/README.md and ensures both base typography and hierarchy extensions load together at runtime. * refine craft docs for clarity and edge cases Address P2/P3 reviewer feedback: - typography-hierarchy-editorial.md §4: Add script-aware exception for Arabic/Hebrew/Persian tracking (cursive joining breaks with negative letter-spacing; use scale/space instead) - typography-hierarchy.md Controlled violations: Add concrete safeguards for 'information flow remains intact' (reading order, proximity grouping, single primary, quick scanability) - typography-hierarchy-editorial.md §2 Whitespace: Qualify 'no divider' rule to allow separators for publication identity, not just space alone - typography-hierarchy-editorial.md Anti-patterns: Add docs-page carve-out for 'UI chrome' (functional controls in code/API blocks are OK; decorative badges belong outside measure) - typography-hierarchy-editorial.md Lint: Make checks measurable — display/deck ratio >=1.5x, section spacing ratio rules (one gap >=1.5x baseline, another <=1.2x), separator identity check, and explicit guidance markers for auditability * address P1/P2/P3 reviewer feedback: RTL conflicts, script accuracy, tracking scope, measurability P1 — RTL physical-direction conflicts: - typography-hierarchy-editorial.md: Change 'ragged right' to 'text-align: start with ragged inline-end' for RTL compatibility - Separators in RTL: Add note on logical directions (inline-start/inline-end) - skills/digital-eguide/SKILL.md: Replace 'cover left, spread right' with 'inline-start/inline-end' and 'pinned right-side' with 'pinned to inline-end' P2 — Script-group accuracy: - Split script groups correctly: Arabic/Persian/Urdu cursive-joining (letter-spacing 0); Hebrew is RTL but not cursive-joining P2 — Tracking exception scope: - Extend script exception to pull-quote tracking row (was only on display) - Mark both as Latin-only with joining-script carve-out P2 — Primary-count inconsistency: - Clarify 'one at a time per visual region' with explicit long-form pacing resets note P3 — Measurable lint: - Replace vague 'meaningfully larger' with >=1.5x baseline rhythm OR one token scale step P3 — Orphaned reference: - Fix cross-ref to 'typography.md §letter-spacing' (was §display tracking) P3 — Markdown typo: - Fix backtick nesting in '1.6–1.7' line-height range * fix: RTL logical 'ragged' wording; make digital-eguide pull-quote script-aware; align section-separators lint with prose * fix(P2): include Persian/Urdu in pull-quote script exception; remove 'space' from section-separators lint * fix: align pull-quote bullet indentation in digital-eguide SKILL.md * fix: align digital-eguide pull-quote bullet nesting * fix: use logical pull-quote alignment wording in editorial craft		2026-05-09 08:13:35 +08:00
..
example.html	Refactor project name from "Open Claude Design" to "Open Design" (#1)	2026-04-28 16:03:35 +08:00
SKILL.md	refine typography-hierarchy craft docs — clarify edge cases and make lint measurable (#979)	2026-05-09 08:13:35 +08:00