Skill Consistency Audit · 2026-07-01 14:27 PDT

ForgeFX Brand vs Design System

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.

Verdict
Partial Pass

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.

Canonical System Checked Against

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.

Gold
Copper
Ember
Hot Black
Slate
Stone
Linen

Key Findings

Safe

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.

Contradiction

Primary Fonts

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.

Drift

Palette Names

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.

Drift

Warm White Rule

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.

Confusing

Old Source-of-Truth Claims

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.

Aligned

Logo Variant Rule

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.

Contradiction Matrix

Areaforgefx-brand legacy material saysforgefx-design-system saysImpact
AuthorityCurrent 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.
TypographyLato 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 namingIron, 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 matchingforblack on dark, forwhite on light.Same rule, with stronger clear-space and size guidance.Aligned.

Recommended Cleanup

Best Fix

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.

Fast Fix

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.

Files Inspected

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.