============================================================================== PLANSMITH BRAND REFERENCE ============================================================================== Version: 1.1.0 Last updated: 2026-07-14 URL: https://www.plansmith.co Category: The planning agent Parent: BrainGrid (https://braingrid.ai/brand.json) Tagline: Plansmith. The planning agent. Closing line: Where the plan gets good. Machine-readable: /brand.json Agent-readable: /brand.md Visual: /brand ============================================================================== COLORS: IDENTITY ============================================================================== Name Hex CSS Variable ------------------------------------------------------------------------------ Pine #02261a --color-pine Antique Brass #c79a46 --color-accent Brass Ink #1a1205 --color-accent-foreground Note: pine is the primary. Brass is the single secondary accent. ============================================================================== COLORS: LIGHT MODE ============================================================================== Name Hex CSS Variable ------------------------------------------------------------------------------ Cream #fbf6eb --color-background Warm white #fffdf7 --color-card Sand #f2ece0 --color-elevated Border (light) #e0dace --color-border Foreground (light) #1d1b1a --color-foreground Primary (light) #1d1b1a --color-primary Muted (light) #68625b --color-muted-foreground Success (light) #2f7d4f --color-success Destructive (light) #b3462f --color-destructive ============================================================================== COLORS: DARK MODE ============================================================================== Name Hex CSS Variable ------------------------------------------------------------------------------ Charcoal #1d1b1a --color-background Dark surface #262422 --color-card Dark elevated #312f2c --color-elevated Border (dark) #383633 --color-border Foreground (dark) #ebe9e7 --color-foreground Primary (dark) #ebe9e7 --color-primary Muted (dark) #a8a49f --color-muted-foreground Success (dark) #5fb37a --color-success Destructive (dark) #d96a5a --color-destructive Note: dark mode is a pine-tinted charcoal with a neutral primary. ============================================================================== TYPOGRAPHY ============================================================================== Geist (font-marketing, --font-geist) Weights: 400, 500, 600, 700 The brand face for set text: all headlines and body. One face for UI across the site and the parent. DM Sans (font-body, --font-dm-sans) Weights: 400, 500, 600, 700 App body face. Product UI text. Geist Mono (font-mono, --font-geist-mono) Weights: 400, 500 Code, data, and tabular figures. SPEC-n ids and effort/readiness chips. Besley (none, none) Weights: 600 The wordmark face, and only the wordmark: a Clarendon born of the type foundries, forged type for a smith. ============================================================================== LOGO ============================================================================== The mark is "Nodes": four node-and-connector elbow units in pinwheel rotation. Specs are nodes, dependencies are the connectors; the plan is a connected graph. It shares construction DNA with the BrainGrid parent mark. Wordmark colors (Plan / smith / mark): Part Light Dark Token ------------------------------------------------------------------------------ Plan #1d1b1a #ebe9e7 --color-foreground smith #68625b #a8a49f --color-muted-foreground mark #02261a #c79a46 pine on light, brass on dark Light mode: Pine mark, "Plan" in pine, "smith" in warm gray, on cream. Dark mode: Brass mark, "Plan" in off-white, "smith" in muted gray, on charcoal. ============================================================================== VOICE ============================================================================== The Translator: someone who has lived both sides of the handoff, empathetic to the operator, credible with engineers. Not a guru, not a futurist. Speaks from specifics: real tickets, real bounce-backs, real rewrites. Markers: - Craft verbs: shape, forge, ground, score, hand off. The plan is worked like material. - Quiet confidence. No hype, no exclamation marks. - Short sentences for emphasis. "Rough. Shaping. Ready." "Handed off, not handed back." - Second person, singular team: your dev team, your issue tracker, your context. - Plain words. If a cold visitor cannot parse a sentence, it loses. - User verbs only: describe, review, refine, hand off. The agent reads code; the user never does. Banned words: revolutionize, supercharge, 10x, unleash, seamless, streamline. No em dashes. ============================================================================== TERMINOLOGY ============================================================================== Ontology (locked): Team -> Project -> Plan -> Spec Readiness labels: Rough, Shaping, Ready Effort labels: Low, Med, High Preferred: - Team -> Project -> Plan -> Spec -- The ontology, locked. A Spec is the atomic unit; SPEC-n ids appear in visuals deliberately. - Spec -- The buildable unit: numbered acceptance criteria, effort, readiness, and "needs first" links. Capital S. - build-ready -- Always. It replaces dev-ready everywhere. - business requirements -- What the user brings; never "ideas". - issue tracker -- Always the full phrase, never bare "tracker". A respected destination and the plan of record. - Connector -- Always. Never adapter, never integration. - the planning agent -- The category. The business twin of the coding agent. Avoid: - epic, requirement, artifact -- Ontology lock: only Team, Project, Plan, Spec. - ticket (as our own noun) -- Tickets and issues live in the issue tracker; Specs live in Plansmith. - integration, adapter -- It is a Connector, always. - dev-ready -- Replaced by build-ready; sweep on contact. - ideas -- Reads vibe-coding-ish; this persona owns business requirements. - tracker (bare) -- Plain business words: issue tracker. - Spec tree -- Retired from customer copy; readers see Specs and Plans. - free, Get started free -- No free tier and no "free" language. ============================================================================== GUIDELINES ============================================================================== Do: - Use semantic tokens only (bg-background, text-primary); the mapping, not the component, changes per mode. - Take backgrounds and neutrals from radial: cream in light, charcoal in dark. - Pine is the primary; brass is the single secondary accent, used sparingly. - Use 1px borders for separation; keep shadows near-invisible. - Square corners across the system. - Render the mark in currentColor; brass for the identity pop. - Split the wordmark two-tone: "Plan" in foreground, "smith" in muted-foreground. - Render readiness as Rough, Shaping, Ready and effort as Low, Med, High, never raw numbers. - Pair any code-access claim with: read access only; it never changes a line. Don't: - Never write a dark: prefix or hardcode palette colors; the theme guard fails the build. Modes are handled by the tokens. - Never use the green as a background or a surface; it is a foreground color only. - Never let brass drift vivid; keep it muted so it reads gold, not orange. - Never promote brass to the primary; it stays the secondary accent. - Never add a second accent color or a gradient on a UI surface. - Never recolor, outline, distort, or add effects to the mark; single color always. - No em dashes anywhere in site copy. - Never use the hype words in the banned list; state the bet plainly instead. - No fabricated customers, logos, testimonials, case studies, or metrics; no compliance claims. - Never disparage issue trackers; the enemy is the handoff.