@lovehlmmm/primekit 1.0.0

package/skills/design/data/poster/analysis/raw/f3e0358f167e6471f7dd6636529a9fc6.json

@@ -0,0 +1,46 @@
+{
+  "image": "f3e0358f167e6471f7dd6636529a9fc6.jpg",
+  "style_cues": [
+    "fantasy",
+    "traditional chinese art",
+    "illustrative",
+    "dramatic",
+    "ornate"
+  ],
+  "palette_hexes": [
+    "#C84F3D",
+    "#3C6E8F",
+    "#FDE8A0",
+    "#87A97A",
+    "#E68B4D",
+    "#FFC000"
+  ],
+  "layout": {
+    "grid": "dynamic diagonal",
+    "focal": "center",
+    "whitespace_ratio": "low"
+  },
+  "texture": {
+    "material": "textured canvas",
+    "finish": "brush strokes"
+  },
+  "mood": [
+    "mystical",
+    "epic",
+    "dramatic",
+    "traditional"
+  ],
+  "shape_primitives": [
+    "flowing curves",
+    "diagonal folds",
+    "pagoda shapes",
+    "geometric structures",
+    "organic clouds"
+  ],
+  "typography": [
+    "stylized calligraphic",
+    "geometric sans",
+    "size contrast",
+    "mixed styles"
+  ]
+}

package/skills/design/data/poster/analysis/raw/f99f4bfc2eb5f0b11f8069aab956231b.json

@@ -0,0 +1,47 @@
+{
+  "image": "f99f4bfc2eb5f0b11f8069aab956231b.jpg",
+  "style_cues": [
+    "high-contrast",
+    "deconstructed",
+    "urban streetwear",
+    "futuristic",
+    "editorial",
+    "grunge"
+  ],
+  "palette_hexes": [
+    "#000000",
+    "#FFFFFF",
+    "#B4B4B4",
+    "#E0E0E0",
+    "#FF0000"
+  ],
+  "layout": {
+    "grid": "broken grid",
+    "focal": "center",
+    "whitespace_ratio": "low"
+  },
+  "texture": {
+    "material": "digital flat",
+    "finish": "polished metal, vector graphics, photo collage"
+  },
+  "mood": [
+    "edgy",
+    "urban",
+    "futuristic",
+    "rebellious"
+  ],
+  "shape_primitives": [
+    "sharp geometric shapes",
+    "thick rules",
+    "rectangles",
+    "rotated text block",
+    "triangles",
+    "stars"
+  ],
+  "typography": [
+    "all caps",
+    "geometric sans",
+    "extreme size contrast",
+    "stacked text"
+  ]
+}

package/skills/design/data/poster/analysis/raw/fc92743155daf8ccafe80dad8f7b1907.json

@@ -0,0 +1,46 @@
+{
+  "image": "fc92743155daf8ccafe80dad8f7b1907.jpg",
+  "style_cues": [
+    "watercolor illustration",
+    "cultural fusion",
+    "dynamic narrative",
+    "dreamlike aesthetic",
+    "historical modern blend"
+  ],
+  "palette_hexes": [
+    "#FFFFFF",
+    "#D6E6F2",
+    "#FFD700",
+    "#E42D00",
+    "#296B50",
+    "#0D0C0B"
+  ],
+  "layout": {
+    "grid": "serpentine vertical flow",
+    "focal": "full-bleed",
+    "whitespace_ratio": "medium"
+  },
+  "texture": {
+    "material": "watercolor paper",
+    "finish": "watercolor wash"
+  },
+  "mood": [
+    "festive",
+    "vibrant",
+    "aspirational",
+    "cultural"
+  ],
+  "shape_primitives": [
+    "organic curves",
+    "rectilinear buildings",
+    "human figures",
+    "decorative patterns",
+    "steam clouds"
+  ],
+  "typography": [
+    "chinese calligraphy",
+    "serif chinese characters",
+    "geometric sans-serif",
+    "stacked vertical text"
+  ]
+}

package/skills/design/data/poster/poster-layouts.csv

@@ -0,0 +1,15 @@
+No,Layout Name,Grid System,Focal Anchor,Element Hierarchy,Whitespace Ratio,Best For Content
+1,layout-01,broken grid,center,headline > supporting graphic > meta,low,"high-contrast, editorial, layered, grunge"
+2,layout-02,broken grid,center,headline > supporting graphic > meta,medium,"high-contrast, editorial, futuristic, streetwear"
+3,layout-03,asymmetric modular,center,headline > supporting graphic > meta,medium,"editorial, abstract, futuristic, typographic"
+4,layout-04,centered stack,center,headline > supporting graphic > meta,medium,"high-contrast, editorial, conceptual, dimensional"
+5,layout-05,broken grid,full-bleed,headline > supporting graphic > meta,low,"editorial, photo collage, high-contrast, distressed"
+6,layout-06,centered organic flow,center,headline > supporting graphic > meta,low,"fantasy, editorial, fantasy art, traditional chinese"
+7,layout-07,asymmetric,center,headline > supporting graphic > meta,low,"editorial, surreal, ethereal, sci-fi"
+8,layout-08,dynamic asymmetric,center,headline > supporting graphic > meta,medium,"editorial, monochromatic, modern, digital art"
+9,layout-09,broken grid,center,headline > supporting graphic > meta,high,"high-contrast, editorial, futuristic, minimalist"
+10,layout-10,centered stack,center,headline > supporting graphic > meta,high,"dreamlike, whimsical, digital art, high-contrast"
+11,layout-11,dynamic composition,center,headline > supporting graphic > meta,low,"editorial, integrated typography, modern, adventure"
+12,layout-12,broken grid,full-bleed,headline > supporting graphic > meta,medium,"modern, high-contrast, glossy, abstract"
+13,layout-13,"vertical emphasis, centered focal",center,headline > supporting graphic > meta,low,"futuristic, abstract surreal, high-contrast, digital art"
+14,layout-14,sectional composition,center,headline > supporting graphic > meta,medium,"japanese inspired, vintage poster, travel aesthetic, minimalist elements"

package/skills/design/data/poster/poster-palettes.csv

@@ -0,0 +1,17 @@
+No,Palette Name,Hex Colors,Color Mood,Contrast Level,Pairs With Styles,When To Use
+1,palette-01,#FFFFFF #000000 #AAAAAA #444444 #3F3F3F,"modern, mysterious, serious",high,"modern-geometric-typographic, conceptual-layered-editorial, urban-editorial-dynamism, conceptual-narrative","When the modern, mysterious, serious mood suits the message."
+2,palette-02,#000000 #FFFFFF #EDEDED #A8784D #333130,"modern, energetic, artistic",high,"conceptual-narrative, modern-geometric-typographic, deconstructed-editorial, digital-typo-futurism","When the modern, energetic, artistic mood suits the message."
+3,palette-03,#FFFFFF #000000 #48D1CC #FF4500 #8A2BE2,"modern, mysterious, editorial",high,"oriental-fantasy-epic, urban-editorial-dynamism, dynamic-typographic-abstraction, modern-editorial-typographic","When the modern, mysterious, editorial mood suits the message."
+4,palette-04,#FFFFFF #000000 #C9D0D4 #818D95 #DCE2E6,"sophisticated, energetic, modern",high,"dynamic-typographic-abstraction, modern-editorial-typographic, digital-typo-futurism, dynamic-layered-promo","When the sophisticated, energetic, modern mood suits the message."
+5,palette-05,#000000 #4A00E0 #FF8C00 #FFFFFF #8E2DE2,"energetic, mysterious, futuristic",high,digital-typo-futurism,"When the energetic, mysterious, futuristic mood suits the message."
+6,palette-06,#FFFFFF #000000 #747A8B #D9725C #DBD6C8,"futuristic, nostalgic, contemplative",high,"digital-typo-futurism, cultural-narrative-collage, deconstructed-editorial, anime-type-fusion","When the futuristic, nostalgic, contemplative mood suits the message."
+7,palette-07,#FFFFFF #000000 #CCCCCC #666666 #C0BFBC,"energetic, modern, youthful",high,"digital-typo-futurism, urban-editorial-dynamism, surreal-ethereal-dreamscapes, conceptual-narrative","When the energetic, modern, youthful mood suits the message."
+8,palette-08,#008D8E #81C0DA #2F7D32 #1F3E5E #FFFFFF,"adventurous, inviting, energetic",medium,"dynamic-layered-promo, conceptual-layered-editorial","When the adventurous, inviting, energetic mood suits the message."
+9,palette-09,#FFFFFF #000000 #151515 #6277F7 #C2C2C2,"modern, conceptual, mysterious",high,"conceptual-layered-editorial, modern-editorial-typographic","When the modern, conceptual, mysterious mood suits the message."
+10,palette-10,#FFD700 #FFFFFF #1A0D30 #D7CFFF #FFF7E6,"energetic, modern, electronic",high,"cultural-narrative-collage, digital-typo-futurism, dynamic-typographic-abstraction, urban-dissent-collage","When the energetic, modern, electronic mood suits the message."
+11,palette-11,#FFFFFF #1A1A1A #FF6600 #F0F0F0 #808080,"modern, energetic, urban",high,"urban-editorial-dynamism, cultural-narrative-collage, abstract-editorial-sans, surreal-ethereal-dreamscapes","When the modern, energetic, urban mood suits the message."
+12,palette-12,#FFFFFF #000000 #FF00FF #A0D0E0 #8000FF,"futuristic, elegant, serene",high,"digital-typo-futurism, modern-editorial-typographic","When the futuristic, elegant, serene mood suits the message."
+13,palette-13,#FFFFFF #E0E0E0 #A0A0A0 #333333 #FDFDFD,"dreamy, serene, modern",low,"dreamy-editorial-exploration, modern-geometric-typographic, anime-type-fusion, modern-editorial-texture","When the dreamy, serene, modern mood suits the message."
+14,palette-14,#FFFFFF #000000 #F5F0E1 #0A0A0A #D32D43,"energetic, intense, bold",high,"conceptual-layered-editorial, deconstructed-editorial, urban-editorial-dynamism, urban-dissent-collage","When the energetic, intense, bold mood suits the message."
+15,palette-15,#000000 #D7C8B0 #432314 #886A4D #F7A247,"serious, introspective, complex",high,"conceptual-narrative, conceptual-layered-editorial, deconstructed-editorial","When the serious, introspective, complex mood suits the message."
+16,palette-16,#FFFFFF #F5F1E7 #2C2E3C #A6446B #CD7B98,"futuristic, nostalgic, calm",low,"digital-typo-futurism, deconstructed-editorial, surreal-ethereal-dreamscapes","When the futuristic, nostalgic, calm mood suits the message."

package/skills/design/data/poster/poster-styles.csv

@@ -0,0 +1,23 @@
+No,Style Name,Category,Keywords,Mood,Description,Specs,Shape Pool,When To Use,Avoid For,Hints,Recommendations,Era
+1,modern-geometric-typographic,editorial,"modern, typographic, high-contrast, geometric, minimalist, dynamic, sophisticated, all caps, grid, layered typography","modern, sophisticated, dynamic, sharp, intellectual","This style is defined by sleek, high-contrast compositions featuring bold, geometric sans-serif typography arranged dynamically within structured or layered layouts, often with a minimalist aesthetic.","Employs all-caps geometric sans-serifs with extreme size contrast, frequently incorporating grid systems, overlapping text, or subtle 3D depth effects to create visual tension and hierarchy.","thick rule, 3d letterforms, wavy form, stacked rectangles, thick letterforms, curved line, circle, geometric icon","Perfect for contemporary branding, event posters, editorial spreads, and digital interfaces that demand a clean, impactful, and intellectually stimulating visual statement.","Inappropriate for themes requiring warmth, historical context, softness, or organic shapes, or for projects where legibility of long text passages is paramount.","Emphasize stark black and white or monochromatic palettes, play with scale and negative space, and utilize precise geometric forms to build compelling visual architecture.","Prompt with 'geometric sans-serif, all caps, extreme size contrast, high-contrast poster, grid layout, modern editorial, minimalist typography, 3D text effect.'",2010s-Present
+2,conceptual-narrative,editorial,"conceptual, narrative, intellectual, high-contrast, dimensional, textured, impactful, cinematic, typographic hierarchy, editorial","serious, intellectual, complex, dramatic, introspective","Combines conceptual, often high-contrast imagery with strong narrative elements, featuring dimensional textures and sophisticated compositions to convey complex, serious themes.","Dominant use of all caps, display sans-serifs with extreme size contrast and hierarchical stacking, often incorporating 3D or layered effects on text.","thick rules, organic curves, puzzle pieces, organic forms, rectangles, splatter, rectangular text blocks, implied squares","Ideal for posters, covers, or editorial spreads for intellectual, dramatic, or suspenseful content like film festivals, philosophical conferences, or art exhibitions.","This style is unsuitable for light-hearted, whimsical, or overtly commercial applications that require a bright or playful tone.","Focus on conceptual metaphors, dramatic lighting, textured backgrounds, and bold, highly contrasted typography with clear visual hierarchy.","Use models proficient in photorealistic rendering, 3D text effects, and dramatic lighting, emphasizing texture and depth.",2010s-Present
+3,dynamic-typographic-abstraction,expressive,"abstract, high-contrast, modern, dynamic, typographic display, distorted type, generative, graphic, fluid forms, all caps","modern, abstract, dynamic, intriguing, sophisticated","A cutting-edge style defined by stark high-contrast compositions, abstract forms, and dynamically manipulated typography that often acts as the primary visual element, evoking a sense of modern intrigue.","Features prominently oversized and often distorted display typography, typically in all caps, with stark scale contrast and sometimes fluid or vertical orientations, creating dynamic layouts.","thick rule, organic curves, thin rules, circle, organic curve, abstract form, organic swirl, vertical text block","Ideal for impactful event posters, avant-garde editorial layouts, contemporary branding, and digital campaigns requiring a sophisticated, energetic edge.","Not suitable for conveying traditional or conservative messages, designs requiring high legibility at small scales, or projects aiming for a subdued aesthetic.","Experiment with extreme typographic scale, fluid distortions, high-contrast monochromatic palettes, and interplay between abstract graphic elements and strong negative space.","Utilize models proficient in abstract art generation and precise typographic control, often benefiting from post-processing for fine-tuning distortions and high-contrast effects.",2010s-Present
+4,modern-editorial-typographic,editorial,"editorial, high-contrast, minimalist, modern, typographic, digital, sophisticated, display typography, clean, graphic","sophisticated, elegant, modern, serene, editorial","A sophisticated and modern editorial style characterized by stark high-contrast visuals and minimalist compositions, creating an elegant and striking aesthetic.","Features extreme size contrast in display typography, often utilizing all caps and a mix of modern serif and sans-serif fonts in clean layouts.","rotated text block, rectangle, circle, cuboid, organic curves, circular forms, triangle, thick rule","Ideal for fashion editorials, brand identity, art exhibition posters, or any project requiring a refined and impactful visual statement.","Avoid for projects needing warmth, organic textures, historical authenticity, or a playful, casual tone.","Experiment with stark black and white palettes with minimal accent colors, large-scale typography as a primary graphic element, and ample negative space to emphasize contrast.","Best rendered with precise, clean AI models like Midjourney (stylize higher), Stable Diffusion (with specific LoRAs for clean typography), or Dall-E for crisp lines and text.",2010s-Present
+5,digital-typo-futurism,experimental,"digital art, high-contrast, futuristic, geometric, experimental typography, 3D text, abstract, bold, modern, dynamic","energetic, futuristic, intense, modern, dynamic","This style blends high-contrast digital art with futuristic, often abstract or geometric visuals, emphasizing experimental and dynamic typography to create an intense and modern aesthetic.","Typography predominantly features geometric sans-serifs in all caps with extreme size contrast, frequently employing 3D effects like extrusion or inflation, or dynamic layouts with rotated and vertical text.","thick rule, circle, rectangle, diagonal line, barcode, rounded rectangle, triangle, geometric shapes","Ideal for event posters, music artwork, tech branding, or anything requiring a cutting-edge, high-energy digital presence.","Not suitable for traditional, vintage, soft, or human-centric themes that require warmth or subtlety.","Focus on digital art techniques, geometric shapes, high-contrast lighting, and explicitly request 3D or dynamically arranged sans-serif typography.","Midjourney (V5.2+), Stable Diffusion (SDXL) for strong typographic control and rendering digital aesthetics.",2010s-Present
+6,cultural-narrative-collage,editorial,"cultural fusion, editorial collage, dynamic narrative, aspirational, mixed scripts, illustrative, fantasy elements, vintage-modern blend","aspirational, vibrant, cultural, dreamlike, dynamic","This style blends rich East Asian cultural narratives with modern editorial layouts, often featuring intricate illustrations, dynamic photo collages, and a harmonious mix of traditional and contemporary design elements.","Typography features a dynamic interplay of East Asian and Latin scripts, frequently utilizing extreme size contrast, vertical stacking, and a diverse blend of serif, sans-serif, and calligraphic fonts.","circle, rectangle, thick rule, wave pattern, bar code, flowing curvilinear forms, lotus flower shape, rectangular text blocks","Ideal for projects requiring a sophisticated fusion of cultural heritage and contemporary design, such as high-end fashion campaigns, art exhibitions, travel promotions, or compelling fantasy narratives.","Avoid for projects demanding stark minimalism, purely data-driven presentations, or when a simple, straightforward message needs to be conveyed without visual complexity.","Focus prompts on specific East Asian cultural motifs, combined with terms like 'editorial collage,' 'dynamic layered layout,' and 'mixed traditional-modern typography with diverse scripts'.","Works best with models adept at generating detailed illustrations, integrating photographic elements seamlessly, and rendering complex multi-script typography with high fidelity.",2010s-Present
+7,urban-editorial-dynamism,expressive,"editorial, high-contrast, urban, modern, energetic, edgy, graphic design, geometric sans, extreme typography, streetwear","energetic, modern, edgy, cool, aspirational","This style merges sophisticated editorial design principles with raw urban energy, characterized by high-contrast visuals, dynamic layouts, and a distinctly modern, edgy aesthetic.","Typographically, it relies on bold geometric sans-serifs, almost exclusively in all caps with extreme size contrast, frequently layered, integrated into imagery, or accented by custom scripts and graffiti elements.","thick rule, rectangle, text block, circle, human figure, rectangular text blocks, curved lines, implied grids","Ideal for event posters, music festivals, fashion campaigns, or digital art projects targeting a youthful, urban audience with a strong sense of style.","Not suitable for formal, corporate, or minimalist branding requiring a subdued, traditional, or highly conservative visual identity.","Focus on dynamic compositions, the interplay of crisp typography with distressed or textured urban elements, and a limited, high-impact color palette to enhance visual tension.","Use models like `Midjourney v5.2+`, `DALL-E 3`, or `Stable Diffusion XL` with terms like 'graphic design poster', 'editorial typography', 'streetwear aesthetic', 'high contrast', and 'bold geometric sans-serif'.",2010s-Present
+8,deconstructed-editorial,expressive,"high-contrast, distressed, editorial, experimental, deconstructed, fragmented, expressive typography, punk aesthetic, grungy textures, dynamic layouts","intense, edgy, rebellious, dramatic, powerful","This style blends aggressive typography with high-contrast, distressed textures and deconstructed layouts for a raw, impactful, and editorially experimental aesthetic.","Features extreme size contrast, all-caps geometric sans-serifs (often distressed or fragmented), within dynamic and sometimes broken grid compositions.","circle, rectangle, rotated text block, text blocks, organic curves, thick rule, arrow, cut paper edges","Ideal for counter-culture branding, music events, fashion campaigns, or any project demanding a bold, rebellious, and visually striking statement.","Avoid for corporate communications, delicate aesthetics, minimalist design, or contexts requiring subtlety and traditional elegance.","Utilize stark black and white with pops of color, layer distressed textures, play with deconstructed or fragmented typography, and experiment with photo collage elements.","Employ aggressive contrast settings, explore grunge/punk/cyberpunk-influenced prompts, and leverage image collage techniques for varied results.",Late 20th Century Revival to Present
+9,surreal-ethereal-dreamscapes,expressive,"surreal, ethereal, cosmic, futuristic, dreamlike, fantasy, illustrative, modern, immersive, inspirational","mysterious, ethereal, contemplative, dreamlike, inspirational","A style characterized by imaginative, other-worldly visuals, blending surrealism with cosmic or futuristic elements, often evoking a sense of mystery, contemplation, or inspiration.","Typography features significant size contrast, often mixing serif display with clean geometric sans-serifs, and sometimes includes decorative or brush script elements, with vertical layouts or subtle hierarchies.","circle, organic shapes, rectangle, thin rule, curved path, organic blob, angular forms, lines","Ideal for projects requiring imaginative storytelling, introspective themes, or a sense of wonder and other-worldliness, such as album art, conceptual campaigns, or event posters.","Not suitable for practical information delivery, corporate communication, or contexts requiring straightforward, objective clarity due to its artistic and evocative nature.","Leverage AI tools for generating complex dreamlike scenes, experiment with atmospheric lighting, and layer abstract or surreal elements with legible typography.","Midjourney excels in producing ethereal and surreal imagery, while DALL-E and Stable Diffusion can provide diverse interpretations of cosmic and futuristic concepts.",2010s-Present
+10,dynamic-layered-promo,expressive,"vibrant, photo-collage, layered, promotional, event-poster, bold-typography, geometric-sans, all-caps, high-contrast","energetic, vibrant, optimistic, inviting, playful","A vibrant and energetic style characterized by layered photographic elements and bold, high-contrast typography, often incorporating photo collages and torn paper effects for a dynamic, promotional feel.","Typographic elements primarily use bold, all-caps geometric sans-serifs with extreme size contrast, frequently integrated directly into layered imagery and compositions.","irregular blob, pin icon, crown, circle, rounded rectangle, irregular organic shapes, architectural forms, curved lines","Perfect for event posters, music festival promotions, lively advertising, or any project requiring an adventurous and inviting visual impact.","Unsuitable for minimalist branding, corporate reports, luxury advertisements, or designs that require a subdued or formal aesthetic.","Prompt for dynamic compositions, overlapping photographic elements, integrated text and imagery, and high-saturation color palettes to achieve maximum vibrancy.","Utilize prompts emphasizing 'event poster', 'promotional art', 'photo collage', and 'layered design' with models capable of detailed graphic composition.",2010s-Present
+11,conceptual-layered-editorial,editorial,"editorial, high-contrast, layered, conceptual, mysterious, digital collage, geometric sans, dramatic, gritty, futuristic","mysterious, conceptual, dramatic, serious, contemplative","A sophisticated and thought-provoking editorial style defined by high-contrast, layered compositions and often intricate digital or photographic collages, conveying a mysterious and conceptual depth.","Characterized by bold, all-caps geometric sans-serif typography with extreme size contrast, set within dynamic, high-contrast, and often overlapping visual arrangements.","thick rule, rectangle, text blocks, circle, chain links, rotated text block, diagonal lines, squares","Perfect for editorial layouts, conceptual art projects, music events, fashion campaigns, or any design needing a profound and visually striking narrative.","Steer clear for lighthearted branding, children's content, or projects requiring a soft, minimalist, or overtly cheerful aesthetic.","Focus on stark contrast, deliberate layering of diverse visual assets, and a strong typographic hierarchy; employ a limited, often monochromatic, color palette for impact.","Leverage advanced digital art or photo-realism models with detailed prompts like 'high-contrast editorial design', 'layered conceptual artwork', and 'bold geometric typography'.",2010s-Present
+12,oriental-fantasy-epic,expressive,"fantasy art, traditional asian, mythical creatures, ink wash, illustrative, epic, storytelling, dark fantasy, ethereal, dynamic composition","mysterious, epic, intense, enchanting, serene","An evocative style blending traditional Asian art forms like ink wash and calligraphic brushwork with epic fantasy and mythological themes, often featuring dynamic compositions and a mysterious, ethereal atmosphere.","Features strong use of calligraphic brush script, often in vertical alignments or traditional Chinese character blocks, complemented by hierarchical sizing and high contrast for impactful display.","organic curves, calligraphic strokes, rectangles, triangles, flowing lines, sharp points, straight lines, rectangular frame","Ideal for fantasy narratives, cultural events, myth-inspired media, or designs requiring a sense of ancient power and mystery.","Unsuitable for modern corporate branding, minimalist layouts, playful children's themes, or designs requiring quick, straightforward information delivery.","Emphasize dynamic poses, traditional Chinese or Japanese art elements, misty landscapes, and expressive brushwork in prompts.","Midjourney, Stable Diffusion with specific LoRAs for Asian art or ink wash, or models trained on traditional fantasy illustrations.",2010s-Present
+13,Dreamy-Whimsical Illustration,Expressive,"dreamy, whimsical, surreal, fantasy, luminescent, vibrant, digital illustration, narrative, enchanting, serene","dreamy, whimsical, enchanting, serene, mysterious","This style immerses viewers in fantastical, dreamlike narratives rendered with vibrant, luminescent digital illustration, evoking a sense of enchanting wonder and calm mystery.","Typography features clean, all-caps geometric sans-serifs, often employed with wide letter spacing or presented at a small scale to complement the dominant imagery.","organic curve, circle, silhouette, hexagon, oval, crescent, rectangle, small organic shapes","Ideal for art exhibitions, literary covers, spiritual content, event posters, or any project requiring an imaginative and evocative visual identity.","Not suitable for corporate branding, urgent messaging, factual data presentation, or designs requiring a stark, minimalist aesthetic.","Emphasize soft, ethereal lighting, fantastical elements, and a balanced composition to enhance the dreamlike quality and narrative depth.","Recommend AI models adept at generating detailed illustrations and atmospheric lighting, such as Midjourney v5/v6 or Stable Diffusion with fantasy art checkpoints.",2010s-Present
+14,urban-dissent-collage,expressive,"urban, distressed, high-contrast, collage, graffiti, zine, punk, bold typography, layered, geometric","rebellious, gritty, energetic, bold, edgy","A raw and dynamic style blending high-contrast visuals, layered collages, and urban textures with powerful, often distressed typography to convey a sense of rebellion and underground energy.","Typography features all-caps, bold sans-serifs, blackletter, or graffiti styles, frequently distressed or contrasting, within layered compositions that incorporate zine elements, grunge textures, and geometric overlays.","layered rectangles, torn edges, bold text blocks, angled elements, diagonal rectangles, organic floral shapes, geometric cross, splatter","Ideal for promoting underground music, activist campaigns, independent events, or streetwear brands that demand a raw, unfiltered aesthetic.","Avoid for corporate branding, elegant invites, or any context requiring a polished, conservative, or minimalist approach.","Emphasize extreme contrast, incorporate found imagery and unconventional layouts, and treat typography as a primary graphic element.","Consider using 'film grain', 'halftone', 'paper texture', 'photorealistic collage', 'raw photo' prompts for enhanced grit and authenticity.",1980s-Present
+15,abstract-editorial-sans,editorial,"abstract, typographic, layered, textural, geometric sans-serif, all caps, modern editorial, dynamic compositions, high-contrast","modern, artistic, editorial, dynamic, sophisticated","A sophisticated modern editorial aesthetic characterized by abstract and sometimes photographic elements, layered textures, and compelling typographic compositions.","Features prominent geometric sans-serif typography in all caps, often letter-spaced, with extreme size contrast and hierarchical layouts, occasionally accented by a subtle script or overlapping elements.","bold sans-serif letters, swirling lines, intertwined tubes, abstract organic forms, vertical stripes, rectangle, curved lines, small icons","Ideal for high-end editorial content, art gallery promotions, contemporary event posters, and brand identities seeking a modern, artistic edge.","Avoid for projects requiring a playful, traditional, or highly pragmatic and information-dense approach due to its abstract and stylized nature.","Emphasize layered abstract shapes, subtle textures, and bold geometric sans-serif typography with high contrast, strategic spacing, and occasional photographic integration.","Utilize models proficient in digital art, clean typography rendering, and subtle textural effects for optimal results and a polished finish.",2010s-Present
+16,dreamy-editorial-exploration,editorial,"editorial, surreal, dreamy, whimsical, landscape, exploration, historical, inspirational, mixed-media, grand","inspiring, dreamy, whimsical, contemplative, grand","A sophisticated yet fantastical style blending editorial clarity with surreal, dreamy landscapes and historical or adventurous narratives, creating an evocative and imaginative visual experience.","Typography features extreme size contrast, often all caps, combining prominent serif displays with cleaner sans-serif secondary or body text, occasionally integrating distressed textures.","rectangular buttons, small icons, organic landscape forms, serif letterforms, segmented form, rectangular text blocks, thin rules, asterisks","Ideal for posters, book covers, or campaigns seeking to evoke wonder, tell a rich story, or commemorate significant events with an artistic, introspective flair.","Avoid for designs requiring stark minimalism, urgent calls to action, or a purely corporate, no-frills aesthetic, as its complexity can be distracting.","Layer fantastical elements over realistic backdrops, utilize atmospheric lighting and rich textures, and ensure strong type hierarchy despite extreme contrast for maximum impact.","Utilize models skilled in illustrative, photorealistic, or painterly aesthetics with a strong emphasis on imaginative composition, depth, and emotive rendering.",2010s-Present
+17,modern-art-editorial,editorial,"modern, abstract, editorial, geometric, sophisticated, artistic, constructivist, elegant, expressive, cubist, display-typography","sophisticated, expressive, modern, energetic, artistic",A sophisticated editorial style blending abstract art influences like Cubism and Constructivism with modern geometric layouts and elegant typography.,"Features prominent geometric sans-serif or bold display typefaces, often in all caps with significant size contrast, integrated into dynamic, abstract or cubist-inspired compositions.","organic curves, geometric letterforms, rectangles, abstract blobs, circle, triangle, rectangle, diagonal stripe","Ideal for high-end editorial layouts, art gallery promotions, cultural event posters, and modern brand identities seeking an intellectual and artistic edge.","Not suitable for highly casual, overtly playful, or traditionally conservative themes that require a more straightforward or ornate aesthetic.","Emphasize bold, architectural typography within dynamic, abstract compositions featuring geometric shapes and a sophisticated, often muted, color palette.","Use models proficient in clean graphic design, high-contrast aesthetics, and precise typographic rendering for best results.",2010s-Present
+18,modern-editorial-texture,editorial,"editorial, typographic, modern, textured, reflective, botanical, minimalist, serene, thoughtful, spiritual","reflective, editorial, nature-inspired, serene, thought-provoking","A refined and contemplative style blending modern editorial layouts with organic textures and thoughtful, nature-inspired elements, often conveying a sense of serenity.","Features a dynamic interplay of geometric sans and striking serif display fonts, often in all caps with extreme size contrast, set against subtle organic or distressed textures.","thick rule, circle, rotated text block, organic shapes, rectangular text blocks, dove silhouette, pixel grid, blurred streak","Ideal for artistic events, magazine spreads, spiritual retreats, or brands seeking a contemporary, reflective and sophisticated identity.","Not suitable for high-energy promotions, purely functional signage, or designs requiring maximal clarity without aesthetic depth.","Focus on clean layouts, high-quality typography, subtle textures (distressed, organic, pixelated details), and a limited, sophisticated color palette.",Utilize models adept at fine typographic detail and subtle texture rendering; consider photorealistic or artistic rendering styles for depth.,2010s-Present
+19,anime-type-fusion,expressive,"anime-inspired, graphic, layered text, extreme contrast, expressive typography, Japanese aesthetic, cyberpunk, ethereal, grunge textures, editorial illustration","expressive, dynamic, ethereal, intense, romantic","A visually rich style blending evocative anime-inspired illustrations with a dynamic interplay of layered and deconstructed typography, ranging from soft romanticism to intense cyberpunk aesthetics.","Features extreme size contrast in typography, mixing large serif displays, stylized Japanese characters, and deconstructed text with script accents, often layered or set against graphic illustrations.","large serif characters, star, ribbons, curvy lines, rectangles, rectangle, sharp point, ink splatter","Ideal for projects requiring strong emotional depth and a narrative focus, such as music posters, event promotions, art exhibitions, or conceptual branding that appeals to a youth demographic.","Not suitable for corporate communications, highly formal documents, or designs requiring extreme readability and minimalist simplicity.","Experiment with blending illustrative elements with bold, often overlapping or fragmented text; consider muted palettes for softer moods or stark high-contrast for edgier tones.","Utilize models strong in illustrative styles and detailed typography, such as Midjourney, Stable Diffusion with specific anime/textual LoRAs, or DALL-E 3 for integrated text.",2010s-Present
+20,gritty-editorial-collage,expressive,"distressed, collage, editorial, graphic novel, comic-book, high-contrast, gritty, dramatic, typographic contrast, all caps","serious, gritty, dramatic, dark","A raw and dramatic style combining distressed textures, bold collage elements, and a gritty, editorial aesthetic reminiscent of graphic novels and zines.","Features distressed sans-serif typography in all caps with extreme size contrast and varied orientations, often integrated into high-contrast, layered collage compositions.","rotated text block, rectangle, circle, scribbled line, thick rule, torn edge, cityscape, bat symbol","Ideal for edgy event posters, rebellious brand identities, dramatic film promotions, or editorial layouts that demand a strong, visceral impact.","Avoid for projects requiring a clean, corporate, minimalist, or lighthearted aesthetic, as its intensity can be overwhelming.","Use keywords like 'distressed collage poster', 'gritty editorial layout', 'comic book typography', 'high contrast', and 'fragmented elements' for best results.","Use models that excel in texture, contrast, and mixed media compositions.",2000s-Present
+21,dreamy-futuristic-editorial,editorial,"digital art, futuristic, editorial, abstract, holographic, soft focus, serene, elegant, modern, luxurious","dreamy, futuristic, elegant, serene, luxurious","A sophisticated digital art style blending futuristic visions with editorial elegance, characterized by soft focus, abstract forms, and subtle holographic effects for a dreamy, luxurious aesthetic.","Features prominent serif display and clean geometric or minimal sans-serif typography, often in all caps with significant size contrast, complemented by sparse, editorial layouts.","oval, rectangle, thick rule, organic curve, interlocking forms, organic curves, rectangles, thin rules","Ideal for high-end fashion campaigns, art exhibitions, conceptual branding, and any project demanding a modern, luxurious, and visually soft yet impactful presence.","Not suitable for loud, overtly minimalist, or traditional print designs, or projects requiring a strong human element or rugged aesthetic.","Focus on ethereal lighting, gradients, depth-of-field, and abstract shapes; experiment with subtle holographic textures and refined, sparse compositions; emphasize legibility for display type.","Use models strong in digital art, abstract compositions, and soft rendering; consider prompts like 'iridescent gradients', 'ethereal lighting', 'editorial composition', 'holographic shimmer'.",2010s-Present
+22,digital-whimsy-pop,expressive,"playful, whimsical, digital illustration, dreamlike, narrative, optimistic, vibrant, geometric sans, modern, imaginative","playful, imaginative, optimistic, energetic, youthful","This style blends playful, whimsical digital illustrations with a dreamlike, narrative quality, creating imaginative and energetic visual experiences.","Typography features clean geometric sans-serifs, often in all caps with size contrast, sometimes incorporating handwritten accents for a touch of whimsy.","circle, rounded rectangle, star, organic splatter, cloud, snowflake, organic forms, arch","Ideal for projects aiming to evoke a sense of joy, imagination, and youthful optimism, such as children's media, events, or lighthearted branding.","Not suitable for serious, formal, or somber contexts, or when a traditional or minimalist aesthetic is required.","Utilize bright, vibrant color palettes, 3D rendering or vector illustration techniques, and dynamic compositions to enhance the playful and narrative elements.","Experiment with illustration-focused AI models like Midjourney, DALL-E 3, or Stable Diffusion for digital art and 3D rendering with playful prompts.",2010s-Present

package/skills/design/data/poster/poster-textures.csv

@@ -0,0 +1,9 @@
+No,Texture Name,Material,Grain/Finish,Effect Description,Pairs With Styles,Rendering Hints
+1,texture-01-digital-flat,digital flat,flat vector,digital flat surface with flat vector finish,"modern-editorial-typographic, urban-editorial-dynamism, oriental-fantasy-epic, surreal-ethereal-dreamscapes",Render with visible flat vector texture; preserve digital flat qualities.
+2,texture-02-digital-flat,digital flat,photo collage,digital flat surface with photo collage finish,"conceptual-layered-editorial, dynamic-layered-promo, cultural-narrative-collage, dreamy-editorial-exploration",Render with visible photo collage texture; preserve digital flat qualities.
+3,texture-03-digital-flat,digital flat,gradient mesh,digital flat surface with gradient mesh finish,"digital-typo-futurism, Dreamy-Whimsical Illustration, surreal-ethereal-dreamscapes, dynamic-typographic-abstraction",Render with visible gradient mesh texture; preserve digital flat qualities.
+4,texture-04-matte-paper,matte paper,paper grain,matte paper surface with paper grain finish,"deconstructed-editorial, urban-editorial-dynamism, modern-editorial-texture, modern-geometric-typographic",Render with visible paper grain texture; preserve matte paper qualities.
+5,texture-05-glossy,glossy,gradient mesh,glossy surface with gradient mesh finish,"modern-geometric-typographic, digital-typo-futurism",Render with visible gradient mesh texture; preserve glossy qualities.
+6,texture-06-digital-flat,digital flat,halftone dots,digital flat surface with halftone dots finish,"digital-typo-futurism, deconstructed-editorial",Render with visible halftone dots texture; preserve digital flat qualities.
+7,texture-07-newsprint,newsprint,halftone dots,newsprint surface with halftone dots finish,"deconstructed-editorial, conceptual-layered-editorial",Render with visible halftone dots texture; preserve newsprint qualities.
+8,texture-08-digital-flat,digital flat,chromatic aberration,digital flat surface with chromatic aberration finish,"digital-typo-futurism, modern-geometric-typographic",Render with visible chromatic aberration texture; preserve digital flat qualities.

package/skills/design/references/banner-sizes-and-styles.md

@@ -0,0 +1,118 @@
+# Banner Sizes & Art Direction Styles Reference
+
+## Complete Banner Sizes
+
+### Social Media
+| Platform | Type | Size (px) | Aspect Ratio |
+|----------|------|-----------|--------------|
+| Facebook | Cover (desktop) | 820 × 312 | ~2.6:1 |
+| Facebook | Cover (mobile) | 640 × 360 | ~16:9 |
+| Facebook | Event cover | 1920 × 1080 | 16:9 |
+| Twitter/X | Header | 1500 × 500 | 3:1 |
+| Twitter/X | Ad banner | 800 × 418 | ~2:1 |
+| LinkedIn | Company cover | 1128 × 191 | ~6:1 |
+| LinkedIn | Personal banner | 1584 × 396 | 4:1 |
+| YouTube | Channel art | 2560 × 1440 | 16:9 |
+| YouTube | Safe area | 1546 × 423 | ~3.7:1 |
+| Instagram | Stories | 1080 × 1920 | 9:16 |
+| Instagram | Post | 1080 × 1080 | 1:1 |
+| Pinterest | Pin | 1000 × 1500 | 2:3 |
+
+### Web / Display Ads (Google Display Network)
+| Name | Size (px) | Notes |
+|------|-----------|-------|
+| Medium Rectangle | 300 × 250 | Highest CTR |
+| Leaderboard | 728 × 90 | Top of page |
+| Wide Skyscraper | 160 × 600 | Sidebar |
+| Half Page | 300 × 600 | Premium |
+| Large Rectangle | 336 × 280 | High performer |
+| Mobile Banner | 320 × 50 | Mobile default |
+| Large Mobile | 320 × 100 | Mobile hero |
+| Billboard | 970 × 250 | Desktop hero |
+
+### Website
+| Type | Size (px) |
+|------|-----------|
+| Full-width hero | 1920 × 600–1080 |
+| Section banner | 1200 × 400 |
+| Blog header | 1200 × 628 |
+| Email header | 600 × 200 |
+
+### Print
+| Type | Size |
+|------|------|
+| Roll-up | 850mm × 2000mm |
+| Step-and-repeat | 8ft × 8ft |
+| Vinyl outdoor | 6ft × 3ft |
+| Trade show | 33in × 78in |
+
+## 22 Art Direction Styles
+
+1. **Minimalist** — White space dominant, single focal element, 1-2 colors, clean sans-serif
+2. **Bold Typography** — Type IS the design; oversized, expressive letterforms fill canvas
+3. **Gradient / Color Wash** — Smooth transitions, mesh gradients, chromatic blends
+4. **Photo-Based** — Full-bleed photography with text overlay; hero lifestyle imagery
+5. **Illustrated / Hand-Drawn** — Custom illustrations, bespoke icons, artisan feel
+6. **Geometric / Abstract** — Shapes, lines, grids as primary visual elements
+7. **Retro / Vintage** — Distressed textures, muted palettes, serif type, halftone dots
+8. **Glassmorphism** — Frosted glass panels, blur backdrop, subtle border glow
+9. **3D / Sculptural** — Rendered objects, depth, shadows; product-centric
+10. **Neon / Cyberpunk** — Dark backgrounds, glowing neon accents, high contrast
+11. **Duotone** — Two-color photo treatment; bold brand color overlay on image
+12. **Editorial / Magazine** — Grid-heavy layouts, pull quotes, journalistic composition
+13. **Collage / Mixed Media** — Cut-paper textures, photo cutouts, layered elements
+14. **Retro Futurism** — Space-age nostalgia, chrome, gradients, optimism
+15. **Expressive / Anti-Design** — Chaotic layouts, mixed fonts, deliberate "wrong" composition
+16. **Digi-Cute / Kawaii** — Rounded shapes, pastel gradients, pixel art, playful characters
+17. **Tactile / Sensory** — Puffy/squishy textures, hyper-real materials, embossed feel
+18. **Data / Infographic** — Stats front-and-center, charts, numbers as heroes
+19. **Dark Mode / Moody** — Near-black backgrounds, rich jewel tones, high contrast
+20. **Flat / Solid Color** — Single background color, clean icons, no gradients
+21. **Nature / Organic** — Earthy tones, botanical motifs, sustainable brand feel
+22. **Motion-Ready / Kinetic** — Designed for animation; layered elements, loopable
+
+## Design Principles
+
+### Visual Hierarchy (3-Zone Rule)
+- **Top**: Logo or main value prop
+- **Middle**: Supporting message + visuals
+- **Bottom**: CTA (button/QR/URL)
+
+### Safe Zones
+- Critical content in central 70-80% of canvas
+- Avoid text/CTA within 50-100px of edges
+- YouTube: 1546 × 423px safe area inside 2560 × 1440
+- Meta/Instagram: central 80% to avoid UI chrome
+
+### CTA Rules
+- One CTA per banner
+- High contrast vs background
+- Bottom-right placement (terminal area)
+- Min 44px height for mobile tap targets
+- Action verbs: "Get", "Start", "Download", "Claim"
+
+### Typography
+- Max 2 typefaces per banner
+- Min 16px body, ≥32px headline (digital)
+- Min 4.5:1 contrast ratio
+- Max 7 words/line, 3 lines for ads
+
+### Text-to-Image Ratio
+- Ads: under 20% text (Meta penalizes)
+- Social covers: 60/40 image-to-text
+- Print: 70pt+ headlines for 3-5m viewing distance
+
+### Print Specs
+- 300 DPI minimum (150 DPI for large format)
+- 3-5mm bleed all sides
+- CMYK color mode
+- 1pt per foot viewing distance rule
+
+## Pinterest Research Queries
+
+Use these search queries on Pinterest for art direction references:
+- `[purpose] banner design [style]` (e.g., "social media banner minimalist")
+- `[platform] cover design inspiration` (e.g., "youtube channel art design")
+- `creative banner layout [industry]` (e.g., "creative banner layout tech startup")
+- `[style] graphic design 2026` (e.g., "gradient graphic design 2026")
+- `banner ad design [product type]` (e.g., "banner ad design saas")

package/skills/design/references/brand-asset-protocol.md

@@ -0,0 +1,226 @@
+# Brand Asset Protocol
+
+> Adapted from [huashu-design](https://github.com/alchaincyf/huashu-design) by alchaincyf (花叔), MIT — commit `1572d43` (2026-07-26).
+
+Load this reference **before generating anything** when the task names a real brand or product (Stripe, Linear, Notion, DJI, Apple, an employer/client, etc.). Without real assets, image-generation subskills produce "generic tech" output that does not identify the brand.
+
+## Why identity > spec
+
+Ranked by identifiability, not by design-spec convention:
+
+| Asset | Identifiability | When required |
+| --- | --- | --- |
+| Logo | Highest — one glance identifies the brand | ALL brands |
+| Product image / render | Very high — for hardware/packaged goods, the product IS the subject | Physical products |
+| UI screenshot | Very high — for digital products, the interface IS the subject | Apps, sites, SaaS |
+| Color values | Medium — helps but often collides between brands | Supporting |
+| Fonts | Low — needs the above to establish identity | Supporting |
+| Vibe keywords | Low — self-check only | Supporting |
+
+Rule: extracting only colors + fonts and skipping the logo / product / UI is a protocol violation. Substituting a CSS silhouette or hand-drawn SVG for a real product photo is a protocol violation ("generic tech animation, brand-agnostic"). If assets cannot be located, **stop and ask the user** — do not fabricate.
+
+## The hard invariant
+
+**Logo for a real brand cannot be found → STOP and ask the user. Never fabricate one, never substitute a CSS silhouette, never proceed silently.**
+
+This is the single hard rule of the protocol. Every other guideline below is strong recommendation.
+
+## Step 1 — Ask (batch the full asset list)
+
+Do not open with "do you have brand guidelines?" — too vague, users don't know what to answer. Ask one batched checklist:
+
+```
+For <brand/product>, which of the following do you have? (Listed by priority.)
+1. Logo — SVG or high-res PNG (REQUIRED for any brand)
+2. Product image / official render — REQUIRED for physical products
+3. UI screenshots — REQUIRED for digital products (main pages)
+4. Color palette — hex / RGB / brand-color chart
+5. Font list — display + body
+6. Brand guidelines PDF / Figma design system / brand site link
+
+Send what you have; I will search / fetch / (as last resort) generate the rest.
+```
+
+## Step 2 — Search official channels
+
+| Asset | Search path |
+| --- | --- |
+| Logo | `<brand>.com/brand` · `<brand>.com/press` · `<brand>.com/press-kit` · `brand.<brand>.com` · inline SVG in the site header |
+| Product image | `<brand>.com/<product>` hero + gallery · official launch video frame · official press release attachments |
+| UI screenshot | App Store / Google Play product page · official screenshots section · official demo video frames |
+| Colors | Site inline CSS / Tailwind config / brand guidelines PDF |
+| Fonts | Site `<link rel="stylesheet">` refs · Google Fonts trace · brand guidelines |
+
+Web-search fallback keywords when direct paths fail:
+
+- Logo missing → `<brand> logo download SVG`, `<brand> press kit`
+- Product missing → `<brand> <product> official renders`, `<brand> <product> product photography`
+- UI missing → `<brand> app screenshots`, `<brand> dashboard UI`
+
+## Step 3 — Download assets (per-type fallback chain)
+
+### 3.1 Logo (required for every brand)
+
+Modern brand sites are usually SPAs — direct `curl <brand>.com/logo.svg` typically returns an empty HTML shell. For known digital products / SaaS / AI tools, **icon aggregators hit first** — best success rate, clean SVGs.
+
+Ordered by success rate:
+
+0. **Icon aggregators** (first choice for known digital products / SaaS / AI tools):
+   ```bash
+   # svgl — widest AI/developer-brand coverage (Claude, Cursor, Anthropic, Vercel, ...), includes light/dark + wordmark
+   curl -s "https://api.svgl.app?search=<brand>"   # returns JSON; take route(.light/.dark) SVG URL, then download
+   # simpleicons — single-color glyphs, tint to the brand color at fetch
+   curl -o logo.svg "https://cdn.simpleicons.org/<slug>/<hexcolor>"
+   ```
+1. Standalone SVG/PNG on official brand page (`<brand>.com/brand`, `/press`):
+   ```bash
+   curl -A "Mozilla/5.0" -L -o assets/<brand>-brand/logo.svg "<official-logo-url>"
+   ```
+2. Full HTML of the site, then grep out the inline `<svg>...</svg>` logo node.
+3. **Google favicon service** (site-authoritative mark, almost never fails):
+   ```bash
+   curl -o logo.png "https://www.google.com/s2/favicons?domain=<brand-domain>&sz=256"
+   ```
+4. Official social-media avatar (last resort): GitHub / X / LinkedIn company avatar, typically 400×400 or 800×800 transparent PNG.
+
+Verify every download: `file <logo>` (must be real SVG/PNG, not a 106-byte placeholder or HTML shell) and `head -c 90 <logo.svg>` (must begin `<svg`).
+
+### 3.2 Product image (required for physical products)
+
+Priority order:
+
+1. **Official product-page hero** — right-click image → address, or `curl` it. Usually 2000px+.
+2. **Official press kit** — `<brand>.com/press` often lists high-res product photos.
+3. **Official launch video frames** — `yt-dlp` the YouTube video, `ffmpeg` a few frames.
+4. **Wikimedia Commons** — public-domain sources often exist.
+5. **AI-generated fallback** (e.g. nano-banana-pro) — feed the real product photo as reference so the generation stays on-brand. **Never** substitute a CSS/SVG silhouette.
+
+### 3.3 UI screenshot (required for digital products)
+
+- App Store / Google Play product screenshots (note: may be mockups, not real UI — compare against a live screen).
+- Site "Screenshots" section.
+- Product demo video frames.
+- Product's official X/Twitter release posts (often the freshest UI).
+- If the user has an account, ask them to screenshot the real product interface.
+
+### 3.4 Quality bar — the 5-10-2-8 rule
+
+Logo is exempt (see below). Every other asset goes through this bar:
+
+| Dimension | Standard | Anti-pattern |
+| --- | --- | --- |
+| **5 rounds of search** | Cross-source (site / press kit / social / video frame / Wikimedia / user screenshot), not "grab the first two on page 1" | First result wins |
+| **10 candidates** | Assemble at least 10 before shortlisting | Grab 2, nothing to choose from |
+| **Pick the top 2** | From the 10, select 2 as final. All of them = visual overload, taste dilution | Ship everything found |
+| **Every asset ≥ 8/10** | If it does not clear 8/10, **prefer to leave it out**. Use an honest placeholder (grey block + label) or AI-generate on top of an official reference. | 7/10 filler shipped |
+
+Scoring dimensions (record in `brand-spec.md`):
+
+1. Resolution — ≥2000px (≥3000px for print/large screen).
+2. Copyright clarity — official > public domain > free stock > suspected reuse (suspected reuse = 0).
+3. Fit with brand vibe — matches the keywords in the spec.
+4. Light / composition / style consistency — the two chosen assets do not clash when placed side by side.
+5. Independent narrative ability — carries its own role (not decoration).
+
+**Logo exception**: any logo is better than none. Even a 6/10 logo is 10× better than no logo — identifiability is a root, not a shortlist.
+
+## Step 4 — Verify and extract (not just grep for colors)
+
+| Asset | Verification |
+| --- | --- |
+| Logo | File exists, opens as SVG/PNG, at least two variants (light-on-dark, dark-on-light), transparent background |
+| Product image | ≥ 2000px, cut-out or clean background, multiple angles (hero, detail, in-scene) |
+| UI screenshot | Real resolution (1× / 2×), current version, no personal / demo data leaked |
+| Colors | `grep -hoE '#[0-9A-Fa-f]{6}' assets/<brand>-brand/*.{svg,html,css} \| sort \| uniq -c \| sort -rn \| head -20`, then discard grayscale |
+
+Watch for **demo-brand contamination**: product screenshots often contain another brand's colors as demo content. When two strong colors appear, distinguish which belongs to the brand under study.
+
+**Brand facets**: a single brand can carry different palettes across surfaces (marketing site vs product UI). Both are real — pick the facet that fits the delivery surface.
+
+## Step 5 — Codify in `brand-spec.md`
+
+Once assets are collected, freeze them into a spec file. All subsequent HTML/CSS references paths and CSS variables from this file — never hard-code hex codes inline.
+
+```markdown
+# <Brand> · Brand Spec
+> Collected: YYYY-MM-DD
+> Sources: <list download origins>
+> Asset completeness: <complete / partial / inferred>
+
+## 🎯 Core assets (first-class)
+
+### Logo
+- Primary: `assets/<brand>-brand/logo.svg`
+- Reversed (on light bg): `assets/<brand>-brand/logo-white.svg`
+- Usage contexts: <intro / outro / corner watermark / anywhere>
+- Do-not-modify rules: <no stretching / no recoloring / no stroke>
+
+### Product image (physical products)
+- Hero: `assets/<brand>-brand/product-hero.png` (2000×1500)
+- Details: `assets/<brand>-brand/product-detail-1.png` / `product-detail-2.png`
+- In-scene: `assets/<brand>-brand/product-scene.png`
+
+### UI screenshot (digital products)
+- Home: `assets/<brand>-brand/ui-home.png`
+- Core feature: `assets/<brand>-brand/ui-feature-<name>.png`
+
+## 🎨 Supporting assets
+
+### Palette
+- Primary: #XXXXXX  <source>
+- Background: #XXXXXX
+- Ink: #XXXXXX
+- Accent: #XXXXXX
+- Never-use: <colors the brand explicitly avoids>
+
+### Type
+- Display: <font stack>
+- Body: <font stack>
+- Mono (data HUD): <font stack>
+
+### Signature details
+- <the details this brand invests 120% in>
+
+### No-go zone
+- <hard bans (e.g. "Lovart avoids blue", "Stripe avoids low-saturation warm tones")>
+
+### Vibe keywords
+- <3-5 adjectives>
+```
+
+Execution discipline once the spec exists:
+
+- Every HTML must **reference** paths from `brand-spec.md`; never CSS-silhouette or hand-draw a substitute.
+- Logo appears as `<img>` pointing at the real file — never redrawn.
+- Product image appears as `<img>` — never a CSS silhouette.
+- Load CSS variables from the spec: `:root { --brand-primary: ...; }` — templates only use `var(--brand-*)`.
+- This turns brand consistency from "on-your-own recall" into "structural" — adding a color requires editing the spec.
+
+## Full-flow fallback (per asset type)
+
+| Missing | Response |
+| --- | --- |
+| Logo | **Stop and ask user.** The hard invariant. |
+| Product image (physical product) | AI-generate on top of an official reference (nano-banana-pro or equivalent) → ask user for material → honest placeholder (grey block + "product photo TBD" label). |
+| UI screenshot (digital product) | Ask user for a screenshot from their own account → official demo video frame. Do NOT fill with a mockup generator. |
+| Colors | Switch to `design-workflow.md`'s "no-context fallback" — propose 3 directions with labeled assumptions. |
+
+Forbidden: silently fill the gap with a generic gradient / CSS silhouette. **Prefer to pause and ask over filler.**
+
+## Case studies (from huashu-design project history)
+
+These are attributed failures documented by the upstream project. Do not restate the brand's actual color as a remembered hex; the whole point of the protocol is that agents guess wrong.
+
+- **DJI Pocket 4 launch animation** — the agent ran an old "extract colors only" version of the protocol: no DJI logo pulled, no Pocket 4 product photo, product replaced with a CSS silhouette. Result: "generic black background + orange accent tech animation" with no DJI identity. Author: *"otherwise, what are we expressing?"* — triggered the protocol upgrade to include product images and UI as first-class assets.
+- **Kimi animation** — the agent guessed Kimi's brand color from memory (assumed warm/orange). The actual color at the time was in the blue family. Full rework required.
+- **Lovart design** — a product screenshot contained a demo brand's red (Heytea). The agent adopted that red as Lovart's color, nearly ruining the whole design.
+- **Five-way coding-agent comparison deck** (Claude Code / Cursor / Codex / Copilot / Trae) — the agent classified the task as "PPT without style reference", jumped to the fallback direction advisor, and spawned three design paths — WITHOUT fetching any of the five product logos. Author: *"why did we not fetch these product logos?"* → protocol updated so trigger includes "design that names or lists real products in parallel" AND the fallback path never exempts logo collection.
+
+## Cost of running the protocol vs. cost of skipping
+
+| Scenario | Time |
+| --- | --- |
+| Run the protocol | Logo 5 min + 3–5 product/UI images 10 min + grep colors 5 min + spec 10 min = **~30 min** |
+| Skip and ship generic output | 1–2 hr rework, sometimes full rebuild |
+
+Cheapest reliability investment available — especially for commissioned / launch / client-critical work.