@event4u/agent-config 6.1.0 → 7.0.0

package/dist/agent-src/skills/brand/data/manifest.json

@@ -0,0 +1,226 @@
+{
+  "manifest_version": 1,
+  "domain": "brand",
+  "tier": "conditional-grounding",
+  "data_dir": ".",
+  "retriever": "bm25",
+  "default_domain": "archetype",
+  "domains": {
+    "archetype": {
+      "file": "archetypes.csv",
+      "search_cols": [
+        "Archetype",
+        "Core Desire",
+        "Voice Traits",
+        "Messaging Angle",
+        "Best For"
+      ],
+      "output_cols": [
+        "Archetype",
+        "Core Desire",
+        "Goal",
+        "Voice Traits",
+        "Messaging Angle",
+        "Visual Cues",
+        "Color Direction",
+        "Typography Filter",
+        "Best For",
+        "Avoid When"
+      ],
+      "max_results": 2
+    },
+    "voice": {
+      "file": "voice-tone.csv",
+      "search_cols": [
+        "Tone Context",
+        "Voice Trait",
+        "Archetype Fit"
+      ],
+      "output_cols": [
+        "Tone Context",
+        "Voice Trait",
+        "Do",
+        "Don't",
+        "Example Copy",
+        "Avoid Copy",
+        "Archetype Fit",
+        "Channel"
+      ],
+      "max_results": 3
+    },
+    "naming": {
+      "file": "naming-patterns.csv",
+      "search_cols": [
+        "Pattern",
+        "Description",
+        "Best For"
+      ],
+      "output_cols": [
+        "Pattern",
+        "Description",
+        "Construction",
+        "Examples",
+        "Strengths",
+        "Risks",
+        "Trademark Risk",
+        "Best For"
+      ],
+      "max_results": 3
+    },
+    "color": {
+      "file": "color-psychology.csv",
+      "search_cols": [
+        "Industry",
+        "Emotional Association",
+        "Archetype Fit"
+      ],
+      "output_cols": [
+        "Industry",
+        "Primary Hue Direction",
+        "Emotional Association",
+        "Secondary/Accent",
+        "Avoid Hue",
+        "Contrast Note",
+        "Cultural Caveat",
+        "Archetype Fit"
+      ],
+      "max_results": 2
+    },
+    "logo": {
+      "file": "logo-style-fit.csv",
+      "search_cols": [
+        "Logo Style",
+        "Industry Fit",
+        "Archetype Fit"
+      ],
+      "output_cols": [
+        "Logo Style",
+        "Description",
+        "Industry Fit",
+        "Construction",
+        "Scalability Note",
+        "Vector Requirement",
+        "Avoid When",
+        "Archetype Fit"
+      ],
+      "max_results": 3
+    },
+    "messaging": {
+      "file": "messaging-frameworks.csv",
+      "search_cols": [
+        "Framework",
+        "Purpose",
+        "When to Use"
+      ],
+      "output_cols": [
+        "Framework",
+        "Purpose",
+        "Structure",
+        "When to Use",
+        "Example Skeleton",
+        "Strengths",
+        "Risks",
+        "Archetype Fit"
+      ],
+      "max_results": 3
+    },
+    "typography": {
+      "file": "typography-principles.csv",
+      "search_cols": [
+        "Archetype",
+        "Industry Examples",
+        "Mood",
+        "Pairing Filter"
+      ],
+      "output_cols": [
+        "Archetype",
+        "Industry Examples",
+        "Pairing Filter",
+        "Heading Class",
+        "Body Class",
+        "Mood",
+        "Rationale",
+        "Confidence",
+        "Evidence Gap"
+      ],
+      "max_results": 2
+    }
+  },
+  "detect": {
+    "archetype": [
+      "archetype",
+      "brand personality",
+      "brand character",
+      "hero",
+      "sage",
+      "outlaw",
+      "rebel",
+      "jester",
+      "caregiver",
+      "ruler",
+      "creator",
+      "explorer",
+      "magician",
+      "lover",
+      "everyman",
+      "innocent"
+    ],
+    "voice": [
+      "voice",
+      "tone",
+      "tone of voice",
+      "copy",
+      "wording",
+      "brand voice",
+      "writing style"
+    ],
+    "naming": [
+      "name",
+      "naming",
+      "brand name",
+      "product name",
+      "wordmark",
+      "coined name"
+    ],
+    "color": [
+      "color",
+      "colour",
+      "palette",
+      "hue",
+      "color psychology",
+      "brand color"
+    ],
+    "logo": [
+      "logo",
+      "mark",
+      "logotype",
+      "emblem",
+      "monogram",
+      "symbol",
+      "brand mark"
+    ],
+    "messaging": [
+      "messaging",
+      "message",
+      "value proposition",
+      "positioning statement",
+      "tagline",
+      "slogan",
+      "pillars",
+      "manifesto"
+    ],
+    "typography": [
+      "typography",
+      "font",
+      "typeface",
+      "pairing",
+      "serif",
+      "sans",
+      "type system",
+      "brand type"
+    ]
+  },
+  "owner": "package-maintainer",
+  "refresh_cadence": "quarterly",
+  "upstream": null
+}

package/dist/agent-src/skills/brand/data/messaging-frameworks.csv

@@ -0,0 +1,13 @@
+Framework,Purpose,Structure,When to Use,Example Skeleton,Strengths,Risks,Archetype Fit
+Positioning Statement (Moore),Define a brand's market position in one sentence,For [audience] / who [need] / our [product] is [category] / that [key benefit] / unlike [competitor],Launching a product or entering a new market,"For [busy professionals] who [need to stay focused], [AppX] is a [productivity tool] that [blocks distractions] unlike [generic timers]",Forces clarity on differentiation; aligns teams,Can sound corporate if overused externally,Ruler
+Value Proposition Canvas,Map product value to customer jobs and pains,Customer Profile (jobs/pains/gains) + Value Map (products/pain-relievers/gain-creators),Early product-market fit work or repositioning,"We help [segment] do [job] by [feature], relieving [pain] and creating [gain]",Rooted in customer evidence; exposes gaps,Requires real research; risk of feature-focus over story,Caregiver
+Message House,Organize all brand claims into a coherent hierarchy,Roof (headline claim) + 3-4 Pillars (supporting proofs) + Foundation (brand purpose/values),Multi-audience comms planning; keeping teams on-message,"[Headline]: [Brand] makes [promise]. Pillar 1: [proof A]. Pillar 2: [proof B]. Foundation: [mission]",Scalable; easy to QA comms against; good for large orgs,Can become bureaucratic; pillars may feel disconnected,Ruler
+Brand Pyramid / Brand Key,Articulate a brand from functional to emotional to essence,Root strengths + Benefits (functional/emotional) + Discriminator + Values + Personality + Essence,Brand identity work or refreshes,"Root: [quality ingredient]. Functional: [lasts longer]. Emotional: [confidence]. Essence: [be unstoppable]",Holistic view from product to soul; widely understood,Essence can be vague; pyramid hides tensions,Hero
+Golden Circle (Sinek),Lead with purpose to inspire loyalty,Why (belief/purpose) / How (differentiating process) / What (product/service),Purpose-driven brand strategy or culture alignment,"Why: [We believe X]. How: [We do Y differently]. What: [Our product is Z]",Memorable; emotionally resonant; great for culture decks,Hard to operationalize; WHY can feel generic,Explorer
+StoryBrand (Miller),Cast customer as hero to clarify brand narrative,Hero / Problem (external-internal-philosophical) / Guide / Plan / Call to action / Success / Failure,Website copy; campaign messaging; sales narratives,"[Customer] wants [goal] but faces [problem]. [Brand] as guide offers [plan]. Result: [success] vs [failure]",Customer-centric; drives conversion; clear CTA structure,Overused; can oversimplify complex B2B sales,Caregiver
+Jobs-to-be-Done Message,Frame value around the functional or social job a customer hires the product for,Job statement + Struggling moment + Desired outcome + Competing solution,Innovation briefs; ad copy rooted in usage context,"When [situation], I want to [motivation], so I can [expected outcome], instead of [alternative]",Avoids feature-speak; grounded in real behavior,Requires deep customer interviews to get right,Everyman
+Feature-Benefit-Value Ladder,Connect product specs to emotional value step by step,Feature -> Functional Benefit -> Emotional Benefit -> Value/Identity,Sales enablement; product marketing copywriting,"Feature: [256GB storage]. Benefit: [store everything]. Emotional: [never delete a memory]. Value: [you are organized]",Bridges engineering and marketing language,Risk of shallow laddering; emotional end may ring false,any
+Tagline / Slogan,Capture brand essence in a single memorable phrase,Core concept (distilled) + Verbal hook + Rhythm or sound,Brand identity; campaign anchor; awareness advertising,"[Brand] - [short punchy phrase that captures the essence], e.g. 'Do more. Worry less.'",Iconic if done well; highly portable across channels,Hard to create; risks being generic or dated quickly,Jester
+Elevator Pitch,Explain a brand or product in under 60 seconds to any audience,Hook + What it is + Who it's for + Key benefit + Call to action,"Speed networking; investor meetings; sales openers; onboarding new hires","We built [product] for [audience] who [need]. It [key benefit] so you can [outcome]. Want to [CTA]?",Versatile; forces brevity; tests clarity of core message,Can feel rushed; hard to adapt for different audiences,Everyman
+Brand Manifesto,State a brand's beliefs and rallying cry in long-form prose,Belief statements + Enemy (what we fight against) + Community invitation + Future vision,Brand launch; culture alignment; PR and content marketing,"[Brand] believes [belief]. The world needs [change]. We fight [enemy]. Join us [CTA].",Inspiring internally and externally; earns media attention,Easy to make grandiose; must be authentic to survive scrutiny,Outlaw
+Pillar-and-Proof,Anchor claims on verifiable evidence to build credibility,3-5 Messaging Pillars (claims) + Supporting Proof Points (data/stories/testimonials) per pillar,Analyst relations; enterprise sales; thought leadership,"Pillar: [We are the most reliable]. Proof 1: [99.99% uptime SLA]. Proof 2: [G2 leader 2024]. Proof 3: [case study].",Credible and audit-able; reduces buyer risk,Proof can become stale; over-reliance on data dulls emotion,Sage

package/dist/agent-src/skills/brand/data/naming-patterns.csv

@@ -0,0 +1,13 @@
+Pattern,Description,Construction,Examples,Strengths,Risks,Trademark Risk,Best For
+Descriptive,States directly what the product or service does.,Combine category noun with modifier or action verb.,"A name meaning 'fast delivery service'; 'online book store'; 'home cleaning app'",Immediately clear; easy SEO; no explanation needed,Generic; hard to protect; limited expansion room,High - describes goods/services directly,Utility brands; Everyman archetype; price-competitive categories
+Suggestive/Evocative,Hints at a benefit or quality without stating it literally.,Choose a word that implies a key attribute through connotation.,"A word evoking speed for a courier; a word evoking clarity for an analytics tool; a word evoking warmth for a care service",Distinctive yet meaningful; easier trademark; memorable,Requires inference; meaning can drift across cultures,Medium - implies but does not describe,Hero and Sage archetypes; premium positioning; brands needing aspiration
+Coined/Invented,A made-up word with no prior dictionary meaning.,Combine phoneme clusters for desired sound symbolism.,"A two-syllable coined word ending in a vowel; a short sharp invented term; a soft-sounding neologism for a wellness brand",Highly protectable; globally portable; no baggage,Requires heavy investment to build meaning; hard to spell first time,Low - no prior use in any category,Magician and Creator archetypes; global tech brands; categories crossing language borders
+Compound,Two existing words fused or joined to create a new whole.,Concatenate or hyphenate two meaningful words.,"A word combining 'open' and 'road' for a travel brand; 'bright' and 'path' for an education platform; 'stone' and 'mark' for a heritage brand",Inherits meaning from both parts; recognisable; moderately protectable,Can feel literal; one half may dominate meaning; long character count,Medium - depends on component words,Explorer and Ruler archetypes; platforms; brands wanting dual positioning
+Acronym/Initialism,Letters from a longer name or phrase form a short memorable string.,Take initials of a descriptive phrase or mission statement.,"Three-letter initialism of a professional association name; four-letter acronym of a corporate mission phrase; initialised product suite name",Short and type-friendly; easy recall once established,Meaningless without context; hard to emote; many combinations taken,Medium - short strings often already registered,B2B and institutional brands; Ruler archetype; technical standards bodies
+Founder/Eponymous,Named after a person - typically a founder or key figure.,Use surname alone or combined with a category word.,"A brand bearing its founder's surname; a consultancy named 'Hartmann and Partners'; a fashion house named after its designer",Immediate credibility and accountability; strong heritage story,Tied to one person's reputation; hard to sell or rebrand,Medium - personal names generally registrable if not already famous,Caregiver and Sage archetypes; luxury goods; professional services; craft brands
+Geographic,References a real or evocative place name to anchor identity.,Use a place name - literal or metaphorical - as brand anchor.,"A brand named after a mountain range evoking ruggedness; a coastal city name for a seafood brand; a regional valley name for a wine",Instant sense of origin and character; tourism synergy,Geographically limiting; locals may not find it exotic; registration can conflict,High - place names often unregistrable alone,Explorer and Innocent archetypes; food and beverage; artisan and heritage brands
+Metaphor,Borrows a concept from an unrelated domain to transfer its qualities.,Identify a quality you want then find an unrelated noun that embodies it.,"An animal name chosen for agility; a natural phenomenon chosen for energy; a mythological figure chosen for wisdom",Rich meaning transfer; emotionally resonant; distinctive,Metaphor may not translate culturally; overused domains (animals) feel tired,Low to Medium - depends on prior use in category,Magician and Hero archetypes; challenger brands; brands with a single dominant value
+Real-word/Borrowed,Adopts an existing common word reframed in a new context.,Take a dictionary word and apply it to an unrelated product category.,"An everyday word meaning 'apple' used for a technology brand; a word for a natural element used for a software tool; a colour word used for a financial service",Familiar phonetics; easy to say and spell; memorable,Descriptive objection risk in some categories; word may carry unwanted associations,High - common words are hard to protect without distinctiveness,Outlaw and Jester archetypes; consumer tech; lifestyle brands wanting approachability
+Portmanteau,Blends parts of two words into one new word.,Merge the start of one word with the end (or middle) of another.,"A blend of 'motor' and 'hotel' for roadside lodging; a blend of 'breakfast' and 'lunch' for a meal occasion; a blend of 'web' and 'seminar' for online events",Compact; clever; instantly suggests both source concepts,Feels gimmicky if forced; may read as misspelling; limited language export,Low to Medium - blended words are often distinctive,Creator and Jester archetypes; new category creators; consumer apps
+Spelling-variant,Alters the conventional spelling of a word to gain trademark distinctiveness.,Substitute a letter or phoneme - often k for c - or remove a vowel.,"A word spelled with 'k' instead of 'c' for a cool brand; a vowel-dropped version of a common adjective; a deliberate double-letter variant",Distinctive enough to register; keeps phonetic recognition; social-handle availability,Confusing in print; perceived as cheap or gimmicky; SEO split,Low - altered spelling is usually registrable,Outlaw and Jester archetypes; youth and lifestyle brands; tech startups needing available domains
+Abstract,Uses a word or number with no semantic link to the product category.,Choose a word or symbol purely for sound or aesthetic qualities.,"A short word meaning something in one language but chosen for its sound in another; a single digit or numeral as a brand name; a colour name used with no colour product",Highly flexible; no limiting associations; protectable,No built-in meaning cues; expensive to build associations; audience must be told what it is,Low - no descriptive link so strong registrability,Ruler and Magician archetypes; holding companies; brands that will extend across many categories

package/dist/agent-src/skills/brand/data/typography-principles.csv

@@ -0,0 +1,13 @@
+Archetype,Industry Examples,Pairing Filter,Heading Class,Body Class,Mood,Rationale,Confidence,Evidence Gap
+Ruler,"law firm, legal, finance, private bank, luxury, institution","serif heading + serif or neutral-sans body (old-style or transitional serif; Didone for luxury)",old-style or transitional serif,transitional serif or neutral grotesque,"authoritative, established, premium","Serifs signal tradition, trust and institutional permanence — the dominant convention in legal and financial identity.",high,"Serif convention is Western-print-rooted; verify legibility and tone for non-Latin scripts."
+Sage,"research, education, journalism, consultancy, think tank","serif heading + humanist-sans body, or an all-serif editorial pairing",transitional serif,humanist sans or a readable serif,"credible, considered, long-form","Editorial serif pairings read as authoritative and support sustained reading.",high,"Screen-first products may prefer a high-legibility sans body over a serif."
+Magician,"SaaS, AI, beauty-tech, immersive experiences","geometric-sans heading + neutral-sans body",geometric or elegant sans,neutral grotesque,"modern, transformative","Geometric sans reads as forward-looking and clean, matching a transformation promise.",medium,"Geometric sans is over-used in tech; differentiate via weight, tracking and a distinctive display cut."
+Hero,"sports, fitness, automotive, defense","condensed grotesque heading + neutral-sans body, italic display accent",condensed grotesque,neutral sans,"bold, dynamic, performant","Condensed weights compress energy and read as athletic and decisive.",high,"Condensed faces lose legibility at small sizes and tight measures."
+Everyman,"retail, FMCG, community, marketplaces","humanist-sans heading + humanist-sans body",humanist sans,humanist sans,"approachable, fair, everyday","Humanist sans feels friendly and unpretentious — the right register for mass appeal.",high,"Risk of generic default-sans sameness; add a small distinctive detail."
+Caregiver,"healthcare, childcare, nonprofit, wellness","soft humanist-sans heading + humanist-sans body, rounded optional",soft humanist sans,humanist sans,"reassuring, gentle, human","Soft humanist forms read as warm and safe without losing professionalism.",medium,"Rounded faces can read juvenile in clinical or regulated contexts."
+Outlaw,"challenger brands, streetwear, counterculture","heavy grotesque or brutalist display heading + neutral-sans body",heavy grotesque or brutalist display,neutral sans,"disruptive, raw, high-impact","High-impact display signals rule-breaking and stands out against polished incumbents.",medium,"Display-heavy systems fail accessibility at body sizes; constrain to headlines."
+Lover,"beauty, fashion, hospitality, fragrance","high-contrast serif (Didone) heading + humanist-sans body, optional script accent",high-contrast Didone serif,humanist sans,"sensual, elegant, indulgent","High-contrast serifs read as refined and desirable, central to beauty and fashion identity.",high,"Didone hairlines vanish below ~24px and on low-DPI screens — set a minimum heading size."
+Jester,"snacks, kids, entertainment, gaming","rounded or quirky display heading + rounded-sans body",rounded or quirky display,rounded sans,"playful, energetic, fun","Rounded and quirky faces carry warmth and play, matching a fun-first promise.",medium,"Novelty display faces date quickly and can undercut trust."
+Creator,"design tools, studios, makers, agencies","distinctive display heading + clean grotesque body",distinctive display,clean grotesque workhorse,"expressive, crafted, original","A distinctive display face signals craft and originality; a neutral workhorse keeps it usable.",medium,"Distinctive display risks legibility — always pair with a neutral body workhorse."
+Explorer,"outdoor, travel, adventure, automotive","condensed or slab heading + humanist-sans body",condensed or slab,humanist sans,"rugged, candid, in-motion","Slab and condensed weights read as sturdy and outdoorsy.",medium,"Slab at body size feels heavy; reserve it for headings."
+Innocent,"organics, family, baby, wellness","rounded humanist-sans heading + humanist-sans body",rounded humanist sans,humanist sans,"warm, simple, honest","Soft, simple sans pairings read as wholesome and unintimidating.",medium,"Over-soft faces can undercut credibility for higher-consideration purchases."

package/dist/agent-src/skills/brand/data/voice-tone.csv

@@ -0,0 +1,13 @@
+Tone Context,Voice Trait,Do,Don't,Example Copy,Avoid Copy,Archetype Fit,Channel
+Error/failure messages,Honest and calm,Name the problem plainly and give a next step,Blame the user or use vague technical jargon,"Something went wrong saving your file. Try again or contact support.","Error 503: upstream dependency failure. Please retry.",Everyman,product UI
+Onboarding/welcome,Warm and encouraging,Celebrate the first step and point forward,Overwhelm with feature lists,"Welcome aboard - your first project is ready. Let's build something great.","Congratulations on registering. Please complete steps 1 through 7 below.",Innocent,email
+Marketing hero copy,Bold and aspirational,Lead with the transformation the user gains,List features before benefits,"Ship faster. Break nothing. Sleep well.","Our platform offers CI/CD pipelines with 99.9% uptime SLAs.",Hero,web
+Legal/compliance notices,Precise and neutral,Use plain language and state obligations clearly,Add marketing spin or minimize importance,"By continuing you agree to our Terms of Service and Privacy Policy.","Just a quick heads-up about some legal stuff you probably know already!",Ruler,product UI
+Support replies,Empathetic and direct,Acknowledge the frustration then solve it,Start with a scripted sorry-for-the-inconvenience opener,"That sounds frustrating. Here is exactly what to do to fix it.","We apologize for any inconvenience this may have caused you today.",Caregiver,support
+Success/celebration,Genuine and brief,Mark the win without overstating it,Use hollow superlatives or excessive punctuation,"Done. Your report is ready to download.","AMAZING!!! You just completed the workflow - you are a total rockstar!!!",Jester,product UI
+Empty states,Inviting and actionable,Show possibility and offer a clear first action,Leave the user stranded with a generic no-data message,"No events yet. Create your first one and it will show up here.","There is nothing to display at this time.",Explorer,product UI
+Pricing/upgrade prompts,Confident and value-led,Anchor on the outcome the upgrade unlocks,Use fear-of-missing-out or countdown pressure,"Unlock team collaboration and ship reviews twice as fast.","Hurry - upgrade now before your trial expires in 24 hours!",Ruler,web
+Release notes,Clear and specific,Describe what changed and why it matters to the user,Pad with buzzwords or bury breaking changes,"Exports now run in the background so you can keep working while they finish.","We are excited to announce a paradigm-shifting update to our export subsystem.",Sage,email
+Social posts,Playful and human,Share a genuine insight or moment with a light touch,Broadcast marketing copy as if it were conversation,"Turns out the hardest part of a great demo is the 3 AM prep. Worth it.","Discover how our industry-leading solution drives ROI for teams like yours.",Jester,social
+Apology/incident,Accountable and specific,Own the failure with facts and state the fix and timeline,Use passive voice or hedge with corporate non-apologies,"We had an outage from 14:02 to 15:47 UTC. Here is what happened and what we changed.","Some users may have experienced service degradation due to unforeseen circumstances.",Everyman,email
+CTA buttons,Action-focused and specific,Use a verb that names the exact outcome of the click,Use vague filler words like Submit or Click Here,Start free trial,Submit,Creator,web

package/dist/agent-src/skills/brand/evals/triggers.json

@@ -0,0 +1,17 @@
+{
+  "skill": "brand",
+  "last_eval": "2026-06-16",
+  "description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers grounding a brand decision against the corpus (archetype, voice, colour, naming, archetype->type). Should-not-trigger covers near-miss neighbors: UI style grounding (design-intelligence), token authoring (design-tokens), generating a logo asset (logo-generation), validation of emitted artifacts (brand-consistency), and font-pairing lookup without a brand frame (typography-system style path).",
+  "queries": [
+    {"q": "which brand archetype fits a rugged outdoor gear company?", "trigger": true},
+    {"q": "ground the voice and tone for a challenger fintech brand", "trigger": true},
+    {"q": "what colour direction does the corpus suggest for a children's education brand?", "trigger": true},
+    {"q": "which naming pattern suits a coined-word tech startup brand?", "trigger": true},
+    {"q": "what type pairing-filter does a luxury law firm archetype imply?", "trigger": true},
+    {"q": "which UI style and palette fit a fintech dashboard?", "trigger": false, "note": "frontend style grounding → design-intelligence, not brand strategy"},
+    {"q": "emit the brand colours as DTCG CSS variables", "trigger": false, "note": "token authoring/emission → design-tokens / brand-to-tokens"},
+    {"q": "generate a logo image for this bakery", "trigger": false, "note": "asset generation → logo-generation, not brand grounding"},
+    {"q": "check whether this landing page copy is on-brand", "trigger": false, "note": "post-action validation → brand-consistency rule"},
+    {"q": "what's a good serif font pairing for a magazine?", "trigger": false, "note": "font-pairing lookup with no brand frame → typography-system style path"}
+  ]
+}

package/dist/agent-src/skills/brand-asset-generation/SKILL.md

@@ -0,0 +1,89 @@
+---
+model_tier: inherit
+name: brand-asset-generation
+description: "Generate brand assets — banners, social cards, CIP elements — with brand-token injection + provider routing. Use when generating a banner / social image / branded asset."
+domain: product
+personas:
+  - design-director
+workspaces:
+  - small-business
+packs:
+  - ai-image
+trust:
+  level: experimental
+install:
+  removable: true
+execution:
+  type: manual
+---
+
+# brand-asset-generation
+
+Generate brand assets (banner, social card, CIP element) via structured prompting,
+brand-token injection, and provider routing. Rides on the existing pack-ai-image
+adapters — not a second image-gen stack.
+
+## When to use
+
+- User asks to generate a banner, social card, header image, or CIP (corporate identity) element.
+- Branded asset production where palette, typography, or voice must stay consistent.
+- When brand tokens are available and should drive the visual output.
+- When a brief alone (no tokens) still needs a governance-aware image output.
+
+## Procedure
+
+1. **Identify asset type and spec** — determine format (banner, social card, CIP element),
+   output dimensions (e.g. 1200×630 for Open Graph, 1080×1080 for square social),
+   and target channel (web, print, social platform).
+2. **Inject brand tokens when present** — if `pack-brand` is installed, load `.tokens.json`
+   (colors, typography, voice). Feed hex values, font names, and tone keywords directly
+   into the prompt. Without tokens, derive palette and type from the brief itself;
+   raw generation works — output is brief-driven, not token-driven.
+3. **Route and prompt** — delegate provider selection to
+   [`image-provider-routing`](../image-provider-routing/SKILL.md) (text-in-image →
+   Ideogram, photoreal product shot → Flux, etc.). Author the provider-specific prompt
+   with the asset spec, injected tokens, and any negative constraints.
+4. **Dry-run and validate** — invoke the adapter (scaffold-tier; see Gotcha). Confirm
+   the returned dry-run plan matches the spec: dimensions, style intent, brand token usage.
+5. **Rights and AI-disclosure governance** — run [`image-likeness-and-rights`](../../rules/image-likeness-and-rights.md)
+   if the asset depicts a real person or brand mark. Attach the AI-generation disclosure
+   footer per `media-governance-routing` before delivering output.
+
+## Output format
+
+1. **Asset spec** — type, dimensions, channel, and routing rationale (which provider and why).
+2. **Prompt** — final provider-specific prompt string with injected brand tokens (or brief-derived
+   palette/type if no tokens). Include key params: aspect ratio, style keywords, negative prompts.
+3. **Adapter invocation / dry-run note** — the dry-run plan returned by the adapter, or an
+   explicit note: "adapter is experimental (scaffold-tier) — dry-run plan only; no rendered
+   asset until promotion per `provider-lifecycle-discipline`."
+4. **Governance confirmation** — rights check result and AI-disclosure footer.
+
+## Gotcha
+
+- **Without a brand token layer the output is generic** — feed the brief's exact palette
+  (hex codes) and typography (font names or style descriptors) into the prompt. Vague
+  color terms ("blue", "modern") produce inconsistent results. Brand tokens from `pack-brand`
+  (Phase B of the brand pipeline) eliminate this gap; until that pack ships, rely on
+  brief-supplied values.
+- **Brand tokens come from `pack-brand` (Phase B)** — this skill consumes tokens; it does
+  not author them. If `.tokens.json` is absent, proceed brief-driven and note the gap.
+- **Adapters are scaffold-tier (dry-run only)** — all pack-ai-image adapters are `experimental`.
+  This skill produces a blueprint and dry-run confirmation; actual renders require a
+  maintainer to capture a smoke trace and promote the adapter to `stable`.
+
+## Do NOT
+
+- Do NOT invent brand colors or voice — use tokens from `.tokens.json` or explicit values
+  from the brief. Guessing palette values produces off-brand output.
+- Do NOT omit the AI-generation disclosure — every delivered asset requires the disclosure
+  footer per `media-governance-routing`, regardless of how generic the output appears.
+- Do NOT claim a rendered asset is produced while adapters are scaffold-tier — surface
+  the dry-run caveat explicitly every time.
+
+## See also
+
+- [`logo-generation`](../logo-generation/SKILL.md) — logo-specific generation with vector and mark constraints.
+- [`image-generation`](../image-generation/SKILL.md) — general-purpose image generation end-to-end.
+- [`image-provider-routing`](../image-provider-routing/SKILL.md) — select the right provider before writing the prompt.
+- [`image-likeness-and-rights`](../../rules/image-likeness-and-rights.md) — rights check before generating real-person likenesses or brand marks.

package/dist/agent-src/skills/brand-asset-generation/evals/triggers.json

@@ -0,0 +1,17 @@
+{
+  "last_eval": "2026-06-16",
+  "should_trigger": [
+    "Generate a banner for our product launch — use the brand colors from .tokens.json",
+    "Create a social card for the Open Graph meta tag, 1200×630, matching our brand palette",
+    "Make a LinkedIn cover image using our brand typography and voice",
+    "Generate a CIP header element for the website hero section with brand-token injection",
+    "Produce a branded social media image for the campaign — we have pack-brand installed"
+  ],
+  "should_not_trigger": [
+    "Design a logo for our new startup",
+    "Generate a product photo of a coffee mug on a white background",
+    "Which image provider should I use for text-heavy images?",
+    "Write a prompt for Midjourney to create a realistic landscape",
+    "Create a brand strategy document outlining our positioning and target audience"
+  ]
+}

package/dist/agent-src/skills/brand-audit/SKILL.md

@@ -0,0 +1,67 @@
+---
+model_tier: inherit
+name: brand-audit
+description: "Audit how a brand is currently expressed across touchpoints and flag drift from its defined tokens, voice, and strategy. Use to inventory and critique an existing brand before changing it."
+domain: engineering
+personas:
+  - brand-strategist
+workspaces:
+  - engineering
+packs:
+  - brand
+trust:
+  level: professional
+install:
+  removable: true
+execution:
+  type: manual
+---
+
+# brand-audit
+
+Method skill. Inventories current brand expression across touchpoints and flags drift against defined brand tokens, voice, and strategy. For the UI surface it leans on `existing-ui-audit` rather than re-implementing component inventory. Output is a drift findings list — not a redesign.
+
+## When to use
+
+- Before a rebrand or brand refresh — establish the baseline first.
+- When auditing brand consistency across touchpoints (web, decks, docs, ads, copy).
+- To create an evidence base before running `brand-strategy`.
+- When "is this on-brand?" needs a systematic answer across many assets, not a gut call.
+
+## Procedure
+
+1. **Gather the source of truth.** Collect the consumer brand's defined tokens (palette, type scale, logo rules), voice profile, and strategy doc if they exist. Consumer brand definition is authoritative; corpus defaults are gap-fill only.
+2. **Inventory current expression per touchpoint.** Cover logo usage, colour palette, typography, voice/copy tone, imagery style, and iconography across the relevant surfaces (site, app, decks, marketing, docs).
+3. **UI surface.** Invoke `existing-ui-audit` for UI component inventory. Do not re-implement it here — take its output as an input to this audit.
+4. **Compare observed vs. defined.** For each touchpoint value, check it against the matching token or voice rule.
+5. **Classify each finding.** Three buckets: `on-brand` (matches the defined token), `drift` (observed value diverges from the token), `undefined` (no token exists to audit against — this is a governance gap, not automatically wrong).
+6. **Rank drift findings** by visibility (how prominent the touchpoint is) multiplied by frequency (how often it appears). Surface the top items first.
+7. **Verify completeness.** Confirm every inventoried touchpoint is classified (`on-brand` / `drift` / `undefined`) — the audit is complete only when the classified count equals the inventoried count, and `existing-ui-audit` has run for every in-scope UI surface. Ensure each drift finding cites BOTH the defined value and the observed value; a finding missing either side is not yet verified.
+8. **Output the findings list** (see Output format). Do not redesign or author replacements — hand drift findings to `brand-identity` or `brand-strategy`.
+
+## Output format
+
+1. **Source-of-truth summary** — what brand tokens, voice rules, and strategy exist and where they were found (or "none defined" if absent).
+2. **Drift findings** — table-style list: `touchpoint | defined value | observed value | severity (high/medium/low)`.
+3. **Undefined gaps** — values with no token to check against; listed separately so they can feed a token-creation pass.
+4. **Ranked top drift** — ordered list of the highest-severity drift items to fix first, with a one-line rationale per item.
+
+## Do NOT
+
+- Redesign or author replacement assets — that is `brand-identity` work, not audit work.
+- Re-implement UI component inventory — call `existing-ui-audit` and consume its output.
+- Invent a "correct" value where none is defined — mark the finding `undefined` and surface it as a governance gap.
+- Treat corpus defaults as the consumer's source of truth — consumer brand definition always wins.
+
+## Gotcha
+
+- `undefined` is a real finding. A value with no token to check against is a governance gap that deserves its own section, not a pass.
+- Drift severity is visibility times frequency, not personal taste. A rarely-seen off-palette icon ranks lower than a wrong primary colour used on every page header.
+- Consumer brand tokens outrank any corpus default. If the consumer has defined a token, audit against that; ignore what the corpus suggests.
+
+## See also
+
+- [`existing-ui-audit`](../existing-ui-audit/SKILL.md) — the UI-surface inventory this skill reuses.
+- [`brand-strategy`](../brand-strategy/SKILL.md) — where drift findings feed a refreshed strategy.
+- [`brand-identity`](../brand-identity/SKILL.md) — defines the tokens audited against.
+- [`brand`](../brand/SKILL.md) — the corpus of brand defaults (gap-fill only).

package/dist/agent-src/skills/brand-audit/evals/triggers.json

@@ -0,0 +1,17 @@
+{
+  "skill": "brand-audit",
+  "last_eval": "2026-06-16",
+  "description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers auditing/inventorying current brand expression and flagging drift. Should-not covers near-miss neighbors.",
+  "queries": [
+    {"q": "audit our brand consistency across the site and decks", "trigger": true},
+    {"q": "is our brand applied consistently — find where we drift", "trigger": true},
+    {"q": "inventory how the logo and colours are used today across all touchpoints", "trigger": true},
+    {"q": "baseline our current brand expression before the refresh", "trigger": true},
+    {"q": "where does our copy drift from the brand voice", "trigger": true},
+    {"q": "define a new brand strategy from scratch", "trigger": false, "note": "strategy definition -> brand-strategy"},
+    {"q": "generate a new logo for us", "trigger": false, "note": "generation -> logo-generation"},
+    {"q": "audit just the UI components to find reuse opportunities", "trigger": false, "note": "UI component inventory -> existing-ui-audit"},
+    {"q": "emit our brand tokens as CSS custom properties", "trigger": false, "note": "emission -> brand-to-tokens"},
+    {"q": "validate this single banner asset against the token spec in CI", "trigger": false, "note": "automated validation gate -> brand-consistency rule"}
+  ]
+}

package/dist/agent-src/skills/brand-identity/SKILL.md

@@ -0,0 +1,101 @@
+---
+model_tier: inherit
+name: brand-identity
+description: "Define a brand identity constraint set from a confirmed strategy — colour story, type story, logo direction, imagery direction. Defines the tokens that token emission and asset generation consume."
+domain: engineering
+personas:
+  - design-director
+workspaces:
+  - engineering
+packs:
+  - brand
+trust:
+  level: professional
+install:
+  removable: true
+execution:
+  type: manual
+---
+
+# brand-identity
+
+Grounding + Method skill. Turns a confirmed brand strategy into an identity constraint set: colour story, type story, logo direction, imagery direction. It DEFINES tokens and constraints — it does not render marks. Dependency direction: pack-brand (B) exports constraints; pack-ai-image (A) consumes them. `brand-to-tokens` emits the DTCG token file from these constraints. `logo-generation` and `brand-asset-generation` generate the actual marks from these constraints. Never invert that direction.
+
+## When to use
+
+- After `brand-strategy` is confirmed (archetype, voice, positioning settled).
+- When deriving the colour story, type story, logo direction, or imagery direction for a project.
+- Before running `brand-to-tokens` to emit the DTCG token file.
+- Before handing constraints to `logo-generation` or `brand-asset-generation` in pack-ai-image.
+
+## Procedure
+
+1. **Receive the confirmed strategy** — archetype, voice, positioning, and target sector from `brand-strategy`. Refuse to proceed if strategy is still a draft.
+
+2. **Ground the colour story** via the brand corpus:
+
+```bash
+python3 <skills-root>/corpus-grounding/scripts/ground.py search \
+  --manifest <skills-root>/brand/data/manifest.json \
+  "<archetype + sector>" --domain color --json
+```
+
+   Read `confidence` and `evidence_gap` from the response. Record both verbatim in the output. Derive colour roles (primary, secondary, neutral, accent) and direction (temperature, contrast ratio floor, emotional register).
+
+3. **Ground the type story** via:
+
+```bash
+python3 <skills-root>/corpus-grounding/scripts/ground.py search \
+  --manifest <skills-root>/brand/data/manifest.json \
+  "<archetype + sector>" --domain typography --json
+```
+
+   Output is a pairing-filter + heading/body class labels, not concrete tokens. Hand this filter to `typography-system` for the actual type tokens.
+
+4. **Ground the logo direction** via:
+
+```bash
+python3 <skills-root>/corpus-grounding/scripts/ground.py search \
+  --manifest <skills-root>/brand/data/manifest.json \
+  "<archetype + sector>" --domain logo --json
+```
+
+   Capture mark style, form language, and vector requirement. Note: any mark that the consumer may need in editable form MUST be specified as editable vector (SVG/AI), not raster.
+
+5. **Derive imagery direction** from archetype and sector context: subject matter, mood, composition style, colour treatment, and what to avoid.
+
+6. **Assemble the identity constraint set** — the structured seed for downstream skills. Record confidence and evidence_gap verbatim from all three corpus calls.
+
+7. **Human confirms** the constraint set before any downstream step runs.
+
+8. **Export** — hand off: `brand-to-tokens` receives the colour + type constraints and emits `.tokens.json` (DTCG); `logo-generation` and `brand-asset-generation` receive the logo direction and imagery direction. Direction of flow: B (pack-brand) -> A (pack-ai-image).
+
+## Output format
+
+1. **Colour story** — roles (primary, secondary, neutral, accent) with direction (temperature, contrast floor, register), cited from corpus with confidence score.
+2. **Type story** — heading class and body class derived from the archetype pairing-filter; note that concrete tokens come from `typography-system`, not from this skill.
+3. **Logo direction** — mark style, form language, vector requirement (editable SVG/AI where needed), and any explicit exclusions.
+4. **Imagery direction** — subject matter, mood, composition style, colour treatment, and anti-patterns to avoid.
+5. **Confidence + evidence_gap** — verbatim from all corpus calls; flag any domain where evidence_gap is high before the human confirmation step.
+6. **Handoff note** — which constraints go to `brand-to-tokens` (colour + type) and which go to the generation skills in pack-ai-image (logo direction + imagery direction).
+
+## Do NOT
+
+- Generate the actual marks here — that is `logo-generation` and `brand-asset-generation`.
+- Invert the dependency direction — generation lives in pack-ai-image (A), not in pack-brand (B).
+- Ship a raster as a final logo where the consumer needs an editable vector mark.
+- Override an existing set of brand tokens on a live project without explicit user confirmation.
+
+## Gotcha
+
+- Identity DEFINES constraints; generation CONSUMES them. Keep the B->A direction in every handoff note.
+- A type story is a pairing-filter plus heading/body class labels — the concrete type tokens (scale, weight, line-height) come from `typography-system`, not from this skill.
+- Vector-vs-raster is a real decision for any mark: confirm with the user before recording the logo direction, because raster is irreversible for downstream editing needs.
+
+## See also
+
+- [`brand-strategy`](../brand-strategy/SKILL.md) — supplies the confirmed strategy.
+- [`brand-to-tokens`](../brand-to-tokens/SKILL.md) — emits the DTCG token source of truth.
+- [`typography-system`](../typography-system/SKILL.md) — turns the type story into type tokens.
+- [`logo-generation`](../logo-generation/SKILL.md) — generates marks from this identity (pack-ai-image).
+- [`brand`](../brand/SKILL.md) — the corpus grounded against.

package/dist/agent-src/skills/brand-identity/evals/triggers.json

@@ -0,0 +1,17 @@
+{
+  "skill": "brand-identity",
+  "last_eval": "2026-06-16",
+  "description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers defining the identity constraint set (colour story, type story, logo direction) from a strategy. Should-not covers near-miss neighbors.",
+  "queries": [
+    {"q": "define the colour story for our brand based on this archetype", "trigger": true},
+    {"q": "what type story fits a challenger archetype in the fintech sector", "trigger": true},
+    {"q": "give me a logo direction for our identity — what mark style and form language fits", "trigger": true},
+    {"q": "assemble the brand identity constraint set from our confirmed strategy", "trigger": true},
+    {"q": "what imagery direction should we use for our brand — subject matter, mood, composition", "trigger": true},
+    {"q": "who is our brand for and how should we position it in the market", "trigger": false, "note": "strategy -> brand-strategy"},
+    {"q": "generate the actual logo image for our brand", "trigger": false, "note": "generation -> logo-generation"},
+    {"q": "emit the colour tokens as CSS variables and a DTCG JSON file", "trigger": false, "note": "emission -> brand-to-tokens"},
+    {"q": "pick a font pairing for a modern SaaS product with no brand frame yet", "trigger": false, "note": "style path -> typography-system"},
+    {"q": "check whether this asset is on-brand and consistent with our guidelines", "trigger": false, "note": "validation -> brand-consistency rule"}
+  ]
+}