soureeui 1.0.0

package/templates/image-prompt.md

@@ -0,0 +1,71 @@
+# Image Prompt Template
+
+Every image placeholder ships with a prompt a person can paste into an image generator and get a usable asset.
+
+---
+
+## Placeholder
+
+```
+[IMAGE PLACEHOLDER]
+Purpose:         <what this image does for the user or the story>
+Placement:       <section and position>
+Aspect ratio:    <e.g. 16:9, 4:5, 1:1>
+Negative space:  <where text or UI overlays, e.g. left third>
+Priority:        <hero / above fold / lazy>
+Alt text:        <real alt text, written now>
+```
+
+## Prompt
+
+```
+Image Generation Prompt
+
+<Subject — who or what, doing what, specifically.>
+<Environment — where, with what in the frame, what season/time.>
+<Composition — subject placement, crop, eye line, foreground/background,
+ and the negative space the layout requires.>
+<Lighting — source, direction, quality, contrast.>
+<Camera or visual style — focal length, depth of field, film or render
+ character; or illustration medium and line quality.>
+<Mood — the feeling, in plain words.>
+<Color direction — palette, tied to the design system.>
+<Aspect ratio.>
+
+Must not appear: <logos, readable text, watermarks, extra limbs,
+ stock-posed smiling, lens flare, HDR over-processing, clutter in the
+ negative space, anything off-brand>
+```
+
+## Worked example
+
+```
+Image Generation Prompt
+
+Wide cinematic photograph of two warehouse technicians in safety vests
+reviewing a handheld scanner beside an automated sorting line. Clean,
+active distribution centre, mid-morning. Subjects on the right third,
+three-quarter view, looking at the device rather than the camera;
+sorting line receding into soft focus behind them. Natural light from
+high clerestory windows, soft directional falloff, gentle contrast.
+35mm, shallow depth of field, subjects sharp. Realistic commercial
+documentary photography, not staged stock. Muted steel and concrete
+palette with a single warm safety-orange accent matching the brand.
+Clear, uncluttered negative space across the left third for headline
+and CTA. 16:9.
+
+Must not appear: logos, readable text or signage, direct eye contact,
+smiling stock poses, lens flare, HDR over-processing, clutter on the
+left third.
+```
+
+---
+
+## Rules
+
+- prompt the image the design needs, not a generic pretty picture
+- state negative space whenever text or UI sits over the image
+- name the color direction so the asset matches the palette
+- always list what must not appear — it is where generators fail
+- write the alt text at the same time as the prompt
+- if a real asset already exists in the project, use it and skip the prompt

package/templates/ui-audit.md

@@ -0,0 +1,77 @@
+# UI Audit Template
+
+Present before changing an existing interface. Short, specific, located. Every problem names where it is and what it costs the user.
+
+---
+
+```
+UI AUDIT — <screen or product>
+
+Current direction
+  <what the interface is visually doing today>
+
+Strengths — keep these
+  - <specific thing that works, and why>
+
+Problems — ranked by user impact
+  1. <location> — <problem> — <consequence for the user>
+  2.
+  3.
+
+AI-lookalike risk: Low / Medium / High
+  <which generic patterns are present, if any>
+
+Information architecture
+  <what is here, how it is grouped, what does not belong>
+
+Hierarchy
+  <what wins attention vs what should>
+
+Layout
+  <structure, alignment, density, rhythm>
+
+Typography
+  <scale, contrast, measure, legibility>
+
+Color and surfaces
+  <roles, contrast, meaning, consistency>
+
+Spacing
+  <consistency, grouping, section rhythm>
+
+Components
+  <consistency, variant sprawl, missing states>
+
+Imagery and icons
+  <purpose, quality, library consistency>
+
+Interaction and motion
+  <feedback, transitions, loading, empty, error>
+  <motion without a job; animation on scroll; missing reduced-motion path>
+
+Responsive
+  <mobile, tablet, overflow, touch targets, navigation>
+  <tables and modals on small screens; hover-only affordances; 200% zoom>
+
+Accessibility
+  <keyboard, focus, contrast, semantics, labels, reduced motion>
+
+RECOMMENDED CHANGES — in order
+  1. <change> — <expected improvement>
+  2.
+  3.
+
+Reuse
+  Keep:   <components and packages already doing their job>
+  Extend: <components worth growing instead of replacing>
+
+Packages
+  Existing to lean on: <...>
+  New, only if justified: <name — why — why not custom>
+
+Custom work
+  <only components genuinely specific to this product>
+
+Out of scope
+  <what this pass deliberately leaves alone>
+```