Entrypoint Routing
forgefx-brand/SKILL.md is now a thin wrapper and repeatedly tells the agent to invoke forgefx-design-system. It explicitly says the design system wins if anything in the legacy package disagrees.
The active forgefx-brand entry point does the right thing: it routes to forgefx-design-system and declares the design system authoritative. The package still contains legacy supporting files that contradict the current design system if someone opens or imports them directly.
No contradiction in the skill entry point. There are real contradictions in legacy assets and reference files under forgefx-brand.
Practical risk: low for agents that obey the entry point; medium for humans or tools that import the old CSS, JSON, templates, or archived reference directly.
Design system authority: nine named swatches, two-tier token naming, Oswald display, Open Sans body, JetBrains Mono mono, official logo lockups, and the delivery judge.
forgefx-brand/SKILL.md is now a thin wrapper and repeatedly tells the agent to invoke forgefx-design-system. It explicitly says the design system wins if anything in the legacy package disagrees.
Multiple legacy brand files still promote Lato and Carlito as the primary heading/body fonts. The design system now defines Oswald for display and Open Sans for body; Lato/Carlito are secondary only.
Legacy files use Iron / Cream / Steel token names. The design system uses Slate / Linen / Stone for those same hexes. Values mostly align; names and roles drift.
Legacy CSS and JSON promote pure white on dark surfaces. The design system says warm white is the default dark-surface text, with pure white valid only in constrained cases.
Several legacy files still call themselves source of truth. That conflicts with the new wrapper model and can mislead a human or script that bypasses SKILL.md.
The key logo rule is consistent: forwhite is for light/white surfaces, forblack is for dark surfaces. The design system has clearer official lockup guidance.
| Area | forgefx-brand legacy material says | forgefx-design-system says | Impact |
|---|---|---|---|
| Authority | Current entry point says “pointer only.” Older support files say “source of truth.” | Design system is the maintained authority. | Entrypoint is safe; legacy files need labels or removal. |
| Typography | Lato headings, Carlito body in assets/typography.json, assets/brand-tokens.css, colors_and_type.css, templates/pptx-brand-config.json, and SKILL_LITE.md. | Oswald display, Open Sans body, JetBrains Mono mono; Lato/Carlito secondaries only. | Real contradiction. Highest-priority cleanup. |
| Palette naming | Iron, Cream, Steel. | Slate, Linen, Stone. | Mostly same hexes, but inconsistent names break docs, feedback, and token literacy. |
| Dark text | #FFFFFF as dark-surface primary text in legacy CSS/config. | #F2EBE0 warm white as default on dark; never pure white as the normal text feel. | Moderate visual drift if old CSS is imported. |
| Gold / Copper values | #F79321 and #AA6027. | #F79321 and #AA6027. | Aligned. |
| Logo surface matching | forblack on dark, forwhite on light. | Same rule, with stronger clear-space and size guidance. | Aligned. |
Turn forgefx-brand into a true wrapper package: keep SKILL.md, compatibility assets, and a migration note; mark stale CSS/JSON/templates as deprecated or redirect them to design-system tokens.
Patch the legacy files that still name Lato/Carlito as primary, Iron/Cream/Steel as canonical, and old source-of-truth claims. This reduces immediate confusion without pruning the package.
forgefx-brand/SKILL.md, forgefx-design-system/SKILL.md, forgefx-design-system/README.md, forgefx-design-system/CLAUDE.md, forgefx-design-system/colors_and_type.css, forgefx-brand/references/FORGEFX_DESIGN_SYSTEM.md, forgefx-brand/assets/color-palette.json, forgefx-brand/assets/typography.json, forgefx-brand/assets/brand-tokens.css, forgefx-brand/templates/css-variables.css, forgefx-brand/templates/pptx-brand-config.json, and targeted searches across both skill folders.