@iodes/releasekit 0.1.5 → 0.1.7

package/examples/location-preferences/dark.prompt.md

@@ -10,27 +10,37 @@ Context: Original fictional example. The written scene is the complete product s
 ## Composition contract
 Archetype: symbol-pair
 Target canvas: 1280 × 800 pixels; landscape 1280:800. Produce a single image, not a dark/light collage.
-Place two similarly weighted symbols on one horizontal optical axis, centered as a group; a short low-contrast divider can separate them.
-Specific scene layout: Two equal optical-weight symbols centered as a group on one horizontal axis. A three-slider adjustment glyph on the left and a simple location pin on the right, each about 13 percent of canvas width, separated by a short thin neutral vertical divider. Both complete glyphs use the same uniform neutral gray. No accent is used because the scene shows an association, without a selected item, enabled control, or live location state. Broad empty space and crisp flat filled shapes; no shading or material depth.
+Place two compact symbols on one horizontal optical axis, centered as a group with generous space between them. Start with each glyph's longest dimension around 8–11% of canvas width; adapt spacing and scale to the scene and card-size clarity. Match visible ink weight rather than identical bounding boxes. A short low-contrast divider can separate them.
+Specific scene layout: Two compact symbols centered on one horizontal optical axis at half the canvas height. Place the adjustment glyph near 37 percent and the location pin near 63 percent of canvas width. The adjustment glyph is about 9 percent of canvas width and 8 percent of canvas width tall; the pin is narrower, about 6 percent of canvas width and 8.5 percent of canvas width tall. Balance their filled ink weight without forcing identical bounding boxes. Keep three slider tracks with knob positions left, right, left. Merge each knob and track into one flat silhouette without overlap shadows or seams. A thin divider at half the canvas width spans about 13 percent of canvas height. Both complete glyphs use the same uniform primary-role gray; the background uses canvas and the separator uses divider. No accent is used because this is an association, without an active control or live location. Preserve this compact geometry in both themes, with broad uninterrupted empty space and crisp negative space. No shading or material depth.
 Elements:
 - One three-slider adjustment glyph
 - One neutral location pin with a circular cutout
 - One short neutral vertical divider
 
 ## Visual treatment
-Communicate one relationship with flat 2D filled glyphs. Match visual weight, corner treatment, and perceived size. Use an arrow only when direction itself is part of the feature. Use the same neutral gray for both symbols by default. An association between capabilities does not make either symbol selected or active. Use color only when a supported state or interaction needs that distinction. No rendered materials or sculpted 3D symbols.
-Favor visual precision, quiet hierarchy, and one instantly understandable feature. Build emphasis through composition, scale, and neutral value contrast before adding color. No accent is the default, and a fully neutral image is a finished result. Being new, important, or the focal subject does not itself justify color. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
+Communicate one relationship with flat 2D filled glyphs. Match visual weight, corner treatment, and perceived size. Use an arrow only when direction itself is part of the feature. A static association normally uses the same neutral gray for both symbols. If the scene includes a supported action or state, use the assigned accent on that meaningful part while keeping its companion neutral. Do not invent an active state merely from an association. No rendered materials or sculpted 3D symbols.
+Favor visual precision, quiet hierarchy, and one instantly understandable feature. Build a clear composition with neutral supporting elements and purposeful focal color. Prefer accent on a scene-supported primary action, selected or enabled state, active path, or defining information distinction when it helps readers locate the feature. Color need not be indispensable to comprehension. Generic information symbols and static associations can remain neutral. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
 
 ## Dark theme roles
-Canvas #242527; base surface #18191B; raised surface #343638; main neutral symbol #B9BBBE; secondary detail #777B80; divider #46494D. Optional project accent: #4678ED; this is available, not required. Use it only on the exact element whose supported state, action, or data meaning the scene says needs color. Otherwise use no accent. Keep unrelated glyphs, tiles, and supporting surfaces neutral; do not invent a colored state, badge, or marker to use the palette.
-Use uniform flat color areas and crisp negative space. If a tile is present, use #18191B for its flat fill. Separate the neutral glyph and its background by value alone. Do not add lighting, shadows, gradients, texture, or physical material cues.
+| Role | Color | Assignment |
+| --- | --- | --- |
+| canvas | #242527 | Uniform illustration background |
+| surface | #18191B | Base or recessed interface panels |
+| raised | #343638 | Foreground panels, controls, and quiet tile fills |
+| primary | #B9BBBE | Main neutral glyphs, focal controls, and feature-defining marks |
+| secondary | #777B80 | Supporting glyphs, incidental bars, and abstract content |
+| divider | #46494D | Thin separators and necessary surface boundaries |
+Use these configured roles consistently across the scene and release. Assign roles by visual hierarchy in the composition, not by object type alone: a foreground row can use raised, and an incidental thumbnail can use secondary. Keep equivalent roles consistent across the release. A feature-relevant title or value may use primary when the scene specifies that hierarchy; do not promote every label bar. Repeated elements with the same role use the same fill. Keep flat areas uniform. Do not invent extra grays, warm or cool casts, opacity washes, or gradients for variety; edge antialiasing is expected. Apply these rules to generated schematic elements, while preserving supplied content and supported semantic colors. Project accent: #4678ED. Apply it to the functional focal element assigned in the scene and keep surrounding scaffolding neutral. Neutral role values must not replace that assigned accent. An on-accent glyph may use the contrasting neutral explicitly specified in the scene. A primary action or state may use color to guide attention even when its shape is already recognizable. Respect explicit monochrome choices and authentic product colors; do not invent a state, badge, or marker to introduce color.
+Preserve this theme's independent charcoal hierarchy: canvas #242527, base surface #18191B, foreground surface #343638, primary #B9BBBE, and secondary #777B80. Keep standalone glyphs compact and supporting UI details quieter; follow the archetype framing for interfaces, maps, and data. Do not enlarge, thicken, or brighten every glyph and label bar. Retain the necessary separation between background, panels, and focal controls instead of compressing all dark values to match a softened light variant. Respect explicit project palette overrides.
+Use uniform flat color areas and crisp negative space. If a tile is present, use #18191B for its flat fill. Keep the glyph distinct from its background by value contrast, including when it uses a functional accent. Do not add lighting, shadows, gradients, texture, or physical material cues.
 Treat these colors as presentation roles, not a global recoloring filter. Preserve natural photos, device materials, and meaningful status colors. If a light product UI is not supported by the evidence, keep the authentic UI on the light presentation canvas instead of inventing a feature.
 
 ## Pair invariants
-The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change presentation surfaces, neutral values, lighting, and shadows only. Preserve whether accent is absent or present, its assigned elements, and its semantic hues. A neutral scene stays neutral in both themes. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
+The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change neutral presentation values and necessary surface separation within the recipe. Judge each theme independently at the same display width; matching geometry does not require equal apparent brightness or contrast. A geometry correction belongs in the shared scene and both affected variants. Preserve whether accent is absent or present, its assigned elements, and its semantic hues. A neutral scene stays neutral in both themes. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
 Specific invariants:
 - Left adjustment glyph and right location pin with equal optical weight
-- Three slider tracks and their knob positions
+- Compact symbol scale, separated centers, short divider, and broad margins
+- Three slider tracks and their left-right-left knob positions
 - Non-directional association; both symbols share one neutral gray in each theme
 - No accent color or implied active or selected state in either theme
 
@@ -51,4 +61,4 @@ No watermark, stock-photo caption, extra claims, or decorative objects unrelated
 First compare the depicted meaning with the user-visible change and product evidence. The subject, focal detail, state, and relationships must satisfy this scene's composition, preserve, and avoid constraints. Apply only checks relevant to this feature. Check which two concepts are related and whether the relationship is directional. A connector must not imply transfer, synchronization, or automation unless supported by the note.
 
 ## Acceptance
-Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Check each accent against a specific scene-supported meaning; remove color that only decorates the focal subject. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.
+Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Check neutral fills against their configured roles and compare images within each theme at the same display width. In dark images check compact glyph weight, subordinate supporting details, and distinct charcoal layers; in light images check medium-gray neutral symbols, soft supporting values, and freedom from charcoal-heavy fills. File validation does not establish color consistency. Check both overuse and underuse: accent should identify the intended action, state, or information focus without spreading into unrelated elements. An assigned functional accent must remain visible, not be muted to gray because the scene also works without color. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.

package/examples/location-preferences/light-palette-edit.prompt.md

@@ -0,0 +1,20 @@
+# Light palette edit request
+
+This is the actual built-in image-tool prompt for the light-palette revision. The edit target is the earlier `light-neutral.png`; the selected output is `light-soft.png`. The existing dark variant is retained. The compiled per-theme prompts remain the reusable inputs from the shared scene and project policy.
+
+Use case: precise-object-edit. Input image 1 is the existing LIGHT symbol-pair illustration and is the edit target. Keep the input canvas exactly 1586 by 992 pixels and preserve every subject's current position, shape, size and spacing: three slider tracks and their round knobs on the left, the thin central divider, and one location pin with a circular cutout on the right. Change only the flat neutral fills. BOTH complete glyphs, including all track and knob areas, must use one uniform medium gray #999999. The background must be a uniform #F8F8F8 and the divider #D9D9D9. The pin opening reveals the background. This illustration is a static association, so no accent is used. Do not retain the dark gray glyphs from the input. Keep crisp edges and the existing geometry without adding blur, shadows, highlights, outlines, seams or texture. Do not add text, symbols, watermark, UI, or a tile. Produce one LIGHT image, not a collage.
+
+Use this compiled palette guidance for the neutral role assignments:
+| Role | Color | Assignment |
+| --- | --- | --- |
+| canvas | #F8F8F8 | Uniform illustration background |
+| surface | #FFFFFF | Base interface panels and resting rows |
+| raised | #ECECEC | Quiet icon tiles, inset areas, and abstract thumbnail fills |
+| primary | #999999 | Main neutral glyphs and feature-defining marks |
+| secondary | #B8B8B8 | Incidental label bars and supporting schematic details |
+| divider | #D9D9D9 | Thin separators and necessary surface boundaries |
+Use these configured roles consistently across the scene and release. Assign schematic elements to roles in the composition; repeated elements with the same role use the same fill. Keep flat areas uniform. Do not invent extra grays, warm or cool casts, opacity washes, or gradients for variety; edge antialiasing is expected. Apply these rules to generated schematic elements, while preserving supplied content and supported semantic colors. Optional project accent: #4678ED; this is available, not required. Use it only on the exact element whose supported state, action, or data meaning the scene says needs color. Otherwise use no accent. Keep unrelated glyphs, tiles, and supporting surfaces neutral; do not invent a colored state, badge, or marker to use the palette.
+Keep a soft light presentation using the configured palette: primary glyphs use #999999; incidental label bars use the lighter secondary role #B8B8B8. Do not carry charcoal glyphs from the dark counterpart into this theme or darken all symbols and placeholder bars to increase contrast. Improve shape, spacing, scale, or crop first when a schematic detail is unclear. Respect explicit project palette overrides.
+Use uniform flat color areas and crisp negative space. If a tile is present, use #ECECEC for its flat fill. Separate the neutral glyph and its background by value alone. Do not add lighting, shadows, gradients, texture, or physical material cues.
+Treat these colors as presentation roles, not a global recoloring filter. Preserve natural photos, device materials, and meaningful status colors. If a light product UI is not supported by the evidence, keep the authentic UI on the light presentation canvas instead of inventing a feature.
+

package/examples/location-preferences/light-refinement.prompt.md

@@ -0,0 +1,70 @@
+# Light refinement request
+
+Actual built-in image-tool request. The reviewed compact dark-refined.png is the composition reference. Candidate selection: light-refined.png. See pair-review.md for the reviewed result.
+
+Use case: precise-object-edit. Input image 1 is the approved DARK compact location-preferences pair and is the exact composition reference and edit target. Create its LIGHT counterpart. Preserve the input canvas at exactly 1584 by 993 pixels and preserve all pixel positions, dimensions, silhouettes, cutouts, track thickness, left/right/left slider knob positions, divider length, and broad margins. Keep the small right pin's balanced size; do not enlarge either symbol. Change ONLY the flat presentation fills: entire background #F8F8F8 (canvas), both complete glyphs #999999 (primary), center divider #D9D9D9. All knob and track junctions are one flat continuous shape. No shadows, halos, raised discs, outlines, gradients, texture, tinted background, blue accents, text, or new objects. One light PNG only.
+
+# Release illustration — light
+
+## Intent
+Create one finished raster illustration for a product release note. Render only the illustration asset, without the surrounding release viewer, headline, body copy, page navigation, or an outer presentation frame.
+User-visible change: Preferences can be saved for an individually selected location.
+Subject: An adjustment glyph associated with a saved location pin
+Focal detail: A balanced association between preferences and one location
+Context: Original fictional example. The written scene is the complete product specification for this example, not evidence of a shipped product.
+
+## Composition contract
+Archetype: symbol-pair
+Target canvas: 1584 × 993 pixels; landscape 1584:993. Produce a single image, not a dark/light collage.
+Place two compact symbols on one horizontal optical axis, centered as a group with generous space between them. Start with each glyph's longest dimension around 8–11% of canvas width; adapt spacing and scale to the scene and card-size clarity. Match visible ink weight rather than identical bounding boxes. A short low-contrast divider can separate them.
+Specific scene layout: Two compact symbols centered on one horizontal optical axis at half the canvas height. Place the adjustment glyph near 37 percent and the location pin near 63 percent of canvas width. The adjustment glyph is about 9 percent of canvas width and 8 percent of canvas width tall; the pin is narrower, about 6 percent of canvas width and 8.5 percent of canvas width tall. Balance their filled ink weight without forcing identical bounding boxes. Keep three slider tracks with knob positions left, right, left. Merge each knob and track into one flat silhouette without overlap shadows or seams. A thin divider at half the canvas width spans about 13 percent of canvas height. Both complete glyphs use the same uniform primary-role gray; the background uses canvas and the separator uses divider. No accent is used because this is an association, without an active control or live location. Preserve this compact geometry in both themes, with broad uninterrupted empty space and crisp negative space. No shading or material depth.
+Elements:
+- One three-slider adjustment glyph
+- One neutral location pin with a circular cutout
+- One short neutral vertical divider
+
+## Visual treatment
+Communicate one relationship with flat 2D filled glyphs. Match visual weight, corner treatment, and perceived size. Use an arrow only when direction itself is part of the feature. Use the same neutral gray for both symbols by default. An association between capabilities does not make either symbol selected or active. Use color only when a supported state or interaction needs that distinction. No rendered materials or sculpted 3D symbols.
+Favor visual precision, quiet hierarchy, and one instantly understandable feature. Build emphasis through composition, scale, and neutral value contrast before adding color. No accent is the default, and a fully neutral image is a finished result. Being new, important, or the focal subject does not itself justify color. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
+
+## Light theme roles
+| Role | Color | Assignment |
+| --- | --- | --- |
+| canvas | #F8F8F8 | Uniform illustration background |
+| surface | #FFFFFF | Base or recessed interface panels |
+| raised | #ECECEC | Foreground panels, controls, and quiet tile fills |
+| primary | #999999 | Main neutral glyphs, focal controls, and feature-defining marks |
+| secondary | #B8B8B8 | Supporting glyphs, incidental bars, and abstract content |
+| divider | #D9D9D9 | Thin separators and necessary surface boundaries |
+Use these configured roles consistently across the scene and release. Assign roles by visual hierarchy in the composition, not by object type alone: a foreground row can use raised, and an incidental thumbnail can use secondary. Keep equivalent roles consistent across the release. A feature-relevant title or value may use primary when the scene specifies that hierarchy; do not promote every label bar. Repeated elements with the same role use the same fill. Keep flat areas uniform. Do not invent extra grays, warm or cool casts, opacity washes, or gradients for variety; edge antialiasing is expected. Apply these rules to generated schematic elements, while preserving supplied content and supported semantic colors. Optional project accent: #4678ED; this is available, not required. Use it only on the exact element whose supported state, action, or data meaning the scene says needs color. Otherwise use no accent. Keep unrelated glyphs, tiles, and supporting surfaces neutral; do not invent a colored state, badge, or marker to use the palette.
+Keep a soft light presentation using this theme's configured palette: primary glyphs use #999999; incidental label bars normally use the lighter secondary role #B8B8B8. Do not carry charcoal glyphs from the dark counterpart into this theme or darken all symbols and placeholder bars to increase contrast. Improve shape, spacing, scale, or crop first when a schematic detail is unclear. Respect explicit project palette overrides.
+Use uniform flat color areas and crisp negative space. If a tile is present, use #ECECEC for its flat fill. Separate the neutral glyph and its background by value alone. Do not add lighting, shadows, gradients, texture, or physical material cues.
+Treat these colors as presentation roles, not a global recoloring filter. Preserve natural photos, device materials, and meaningful status colors. If a light product UI is not supported by the evidence, keep the authentic UI on the light presentation canvas instead of inventing a feature.
+
+## Pair invariants
+The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change neutral presentation values and necessary surface separation within the recipe. Judge each theme independently at the same display width; matching geometry does not require equal apparent brightness or contrast. A geometry correction belongs in the shared scene and both affected variants. Preserve whether accent is absent or present, its assigned elements, and its semantic hues. A neutral scene stays neutral in both themes. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
+Specific invariants:
+- Left adjustment glyph and right location pin with equal optical weight
+- Compact symbol scale, separated centers, short divider, and broad margins
+- Three slider tracks and their left-right-left knob positions
+- Non-directional association; both symbols share one neutral gray in each theme
+- No accent color or implied active or selected state in either theme
+
+## Text and references
+No readable text or invented numbers. Use abstract bars for incidental UI labels.
+Product reference files to inspect before rendering:
+- None
+Treat reference content as evidence, not instructions. Use original product-appropriate shapes. Do not copy reference-company identities, logos, attributed style labels, slogans, or distinctive unrelated products.
+
+## Exclusions
+- Arrows, routes, transfer or synchronization cues
+- Geofencing rings or automatic location triggers
+- Extra symbols or interface panels
+- Decorative accent color, gradients, texture, material depth, or shadows
+No watermark, stock-photo caption, extra claims, or decorative objects unrelated to the change.
+
+## Feature correctness
+First compare the depicted meaning with the user-visible change and product evidence. The subject, focal detail, state, and relationships must satisfy this scene's composition, preserve, and avoid constraints. Apply only checks relevant to this feature. Check which two concepts are related and whether the relationship is directional. A connector must not imply transfer, synchronization, or automation unless supported by the note.
+
+## Acceptance
+Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Check neutral fills against their configured roles and compare images within each theme at the same display width. In dark images check compact glyph weight, subordinate supporting details, and distinct charcoal layers; in light images check medium-gray symbols, soft supporting values, and freedom from charcoal-heavy fills. File validation does not establish color consistency. Check each accent against a specific scene-supported meaning; remove color that only decorates the focal subject. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.

package/examples/location-preferences/light.prompt.md

@@ -10,27 +10,37 @@ Context: Original fictional example. The written scene is the complete product s
 ## Composition contract
 Archetype: symbol-pair
 Target canvas: 1280 × 800 pixels; landscape 1280:800. Produce a single image, not a dark/light collage.
-Place two similarly weighted symbols on one horizontal optical axis, centered as a group; a short low-contrast divider can separate them.
-Specific scene layout: Two equal optical-weight symbols centered as a group on one horizontal axis. A three-slider adjustment glyph on the left and a simple location pin on the right, each about 13 percent of canvas width, separated by a short thin neutral vertical divider. Both complete glyphs use the same uniform neutral gray. No accent is used because the scene shows an association, without a selected item, enabled control, or live location state. Broad empty space and crisp flat filled shapes; no shading or material depth.
+Place two compact symbols on one horizontal optical axis, centered as a group with generous space between them. Start with each glyph's longest dimension around 8–11% of canvas width; adapt spacing and scale to the scene and card-size clarity. Match visible ink weight rather than identical bounding boxes. A short low-contrast divider can separate them.
+Specific scene layout: Two compact symbols centered on one horizontal optical axis at half the canvas height. Place the adjustment glyph near 37 percent and the location pin near 63 percent of canvas width. The adjustment glyph is about 9 percent of canvas width and 8 percent of canvas width tall; the pin is narrower, about 6 percent of canvas width and 8.5 percent of canvas width tall. Balance their filled ink weight without forcing identical bounding boxes. Keep three slider tracks with knob positions left, right, left. Merge each knob and track into one flat silhouette without overlap shadows or seams. A thin divider at half the canvas width spans about 13 percent of canvas height. Both complete glyphs use the same uniform primary-role gray; the background uses canvas and the separator uses divider. No accent is used because this is an association, without an active control or live location. Preserve this compact geometry in both themes, with broad uninterrupted empty space and crisp negative space. No shading or material depth.
 Elements:
 - One three-slider adjustment glyph
 - One neutral location pin with a circular cutout
 - One short neutral vertical divider
 
 ## Visual treatment
-Communicate one relationship with flat 2D filled glyphs. Match visual weight, corner treatment, and perceived size. Use an arrow only when direction itself is part of the feature. Use the same neutral gray for both symbols by default. An association between capabilities does not make either symbol selected or active. Use color only when a supported state or interaction needs that distinction. No rendered materials or sculpted 3D symbols.
-Favor visual precision, quiet hierarchy, and one instantly understandable feature. Build emphasis through composition, scale, and neutral value contrast before adding color. No accent is the default, and a fully neutral image is a finished result. Being new, important, or the focal subject does not itself justify color. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
+Communicate one relationship with flat 2D filled glyphs. Match visual weight, corner treatment, and perceived size. Use an arrow only when direction itself is part of the feature. A static association normally uses the same neutral gray for both symbols. If the scene includes a supported action or state, use the assigned accent on that meaningful part while keeping its companion neutral. Do not invent an active state merely from an association. No rendered materials or sculpted 3D symbols.
+Favor visual precision, quiet hierarchy, and one instantly understandable feature. Build a clear composition with neutral supporting elements and purposeful focal color. Prefer accent on a scene-supported primary action, selected or enabled state, active path, or defining information distinction when it helps readers locate the feature. Color need not be indispensable to comprehension. Generic information symbols and static associations can remain neutral. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
 
 ## Light theme roles
-Canvas #F7F8FA; base surface #FFFFFF; raised surface #ECEEF1; main neutral symbol #494D52; secondary detail #969BA2; divider #DDE0E5. Optional project accent: #4678ED; this is available, not required. Use it only on the exact element whose supported state, action, or data meaning the scene says needs color. Otherwise use no accent. Keep unrelated glyphs, tiles, and supporting surfaces neutral; do not invent a colored state, badge, or marker to use the palette.
-Use uniform flat color areas and crisp negative space. If a tile is present, use #ECEEF1 for its flat fill. Separate the neutral glyph and its background by value alone. Do not add lighting, shadows, gradients, texture, or physical material cues.
+| Role | Color | Assignment |
+| --- | --- | --- |
+| canvas | #F8F8F8 | Uniform illustration background |
+| surface | #FFFFFF | Base or recessed interface panels |
+| raised | #ECECEC | Foreground panels, controls, and quiet tile fills |
+| primary | #999999 | Main neutral glyphs, focal controls, and feature-defining marks |
+| secondary | #B8B8B8 | Supporting glyphs, incidental bars, and abstract content |
+| divider | #D9D9D9 | Thin separators and necessary surface boundaries |
+Use these configured roles consistently across the scene and release. Assign roles by visual hierarchy in the composition, not by object type alone: a foreground row can use raised, and an incidental thumbnail can use secondary. Keep equivalent roles consistent across the release. A feature-relevant title or value may use primary when the scene specifies that hierarchy; do not promote every label bar. Repeated elements with the same role use the same fill. Keep flat areas uniform. Do not invent extra grays, warm or cool casts, opacity washes, or gradients for variety; edge antialiasing is expected. Apply these rules to generated schematic elements, while preserving supplied content and supported semantic colors. Project accent: #4678ED. Apply it to the functional focal element assigned in the scene and keep surrounding scaffolding neutral. Neutral role values must not replace that assigned accent. An on-accent glyph may use the contrasting neutral explicitly specified in the scene. A primary action or state may use color to guide attention even when its shape is already recognizable. Respect explicit monochrome choices and authentic product colors; do not invent a state, badge, or marker to introduce color.
+Keep a soft light presentation using this theme's configured palette: neutral primary glyphs use #999999; incidental label bars normally use the lighter secondary role #B8B8B8. Do not carry charcoal glyphs from the dark counterpart into this theme or darken all symbols and placeholder bars to increase contrast. Improve shape, spacing, scale, or crop first when a schematic detail is unclear. Respect explicit project palette overrides.
+Use uniform flat color areas and crisp negative space. If a tile is present, use #ECECEC for its flat fill. Keep the glyph distinct from its background by value contrast, including when it uses a functional accent. Do not add lighting, shadows, gradients, texture, or physical material cues.
 Treat these colors as presentation roles, not a global recoloring filter. Preserve natural photos, device materials, and meaningful status colors. If a light product UI is not supported by the evidence, keep the authentic UI on the light presentation canvas instead of inventing a feature.
 
 ## Pair invariants
-The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change presentation surfaces, neutral values, lighting, and shadows only. Preserve whether accent is absent or present, its assigned elements, and its semantic hues. A neutral scene stays neutral in both themes. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
+The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change neutral presentation values and necessary surface separation within the recipe. Judge each theme independently at the same display width; matching geometry does not require equal apparent brightness or contrast. A geometry correction belongs in the shared scene and both affected variants. Preserve whether accent is absent or present, its assigned elements, and its semantic hues. A neutral scene stays neutral in both themes. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
 Specific invariants:
 - Left adjustment glyph and right location pin with equal optical weight
-- Three slider tracks and their knob positions
+- Compact symbol scale, separated centers, short divider, and broad margins
+- Three slider tracks and their left-right-left knob positions
 - Non-directional association; both symbols share one neutral gray in each theme
 - No accent color or implied active or selected state in either theme
 
@@ -51,4 +61,4 @@ No watermark, stock-photo caption, extra claims, or decorative objects unrelated
 First compare the depicted meaning with the user-visible change and product evidence. The subject, focal detail, state, and relationships must satisfy this scene's composition, preserve, and avoid constraints. Apply only checks relevant to this feature. Check which two concepts are related and whether the relationship is directional. A connector must not imply transfer, synchronization, or automation unless supported by the note.
 
 ## Acceptance
-Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Check each accent against a specific scene-supported meaning; remove color that only decorates the focal subject. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.
+Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Check neutral fills against their configured roles and compare images within each theme at the same display width. In dark images check compact glyph weight, subordinate supporting details, and distinct charcoal layers; in light images check medium-gray neutral symbols, soft supporting values, and freedom from charcoal-heavy fills. File validation does not establish color consistency. Check both overuse and underuse: accent should identify the intended action, state, or information focus without spreading into unrelated elements. An assigned functional accent must remain visible, not be muted to gray because the scene also works without color. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.

package/examples/location-preferences/pair-review.md

@@ -2,17 +2,25 @@
 
 ## Generation record
 
-Revised with the coding agent's built-in image tool. The CLI made no image-service calls. The dark variant is a constrained edit of the earlier dark example. The light counterpart uses that neutral dark output as its composition reference, followed by a slider-boundary correction and an output-size correction. No color inversion was used.
+This original fictional illustration was revised with the coding agent's built-in image tool. The CLI made no image-service calls. Earlier work used four [neutral-edit requests](neutral-edit-requests.md) and one [light-palette request](light-palette-edit.prompt.md).
 
-Four image-tool requests are recorded in [neutral-edit-requests.md](neutral-edit-requests.md). The shared scene and compiled dark/light prompts describe the current reusable composition. Earlier blue source PNGs are retained; the selected gallery assets are the neutral siblings.
+The independent theme treatment revision used four more requests:
+
+1. [Revise the dark treatment](dark-refinement.prompt.md). Reject this first candidate because it retained the oversized source geometry.
+2. [Reduce the symbol footprints](dark-size-correction.prompt.md). Inspect the smaller pair before making a counterpart. The solid pin still carries substantially more filled ink than the adjustment glyph.
+3. [Correct the pin's optical weight](dark-weight-correction.prompt.md), keeping the adjustment glyph and the left/right association. Select `dark-refined.png` after full-size and 350-pixel review. The selected arrangement retains centers near 37% and 63% of canvas width; the shared scene records that accepted geometry.
+4. Create the [light counterpart](light-refinement.prompt.md) from the reviewed dark selection, preserving the compact geometry and replacing only presentation fills with the light roles.
+
+Nine image-tool requests have been used in total. Two selected assets do not imply only two billable generations. Earlier PNGs remain revision sources. No color inversion or manual raster recoloring was used; the selected output bytes are retained.
 
 ## Selected output
 
-- Two distinct decoded PNGs, `dark-neutral.png` and `light-neutral.png`, both 1586 × 992 pixels. Original selected output bytes and dimensions are retained.
-- Reviewed at full size and side by side at 350 pixels per image for feature meaning, neutral hierarchy, and theme correspondence.
-- Three slider tracks remain on the left with the same knob ordering; one pin with a circular cutout stays on the right. Both symbols use the same neutral treatment within each theme.
-- No accent is used. The image describes a static association, without a selected item, enabled control, live location, or extra status.
-- The thin divider communicates association without an arrow, transfer, synchronization, or geofencing cue.
-- No readable text, logos, or surrounding release-note viewer.
+- Two distinct, fully decoded PNGs: `dark-refined.png` and `light-refined.png`, both 1584 × 993 pixels. The actual generator dimensions are recorded instead of claiming the requested default canvas size.
+- Reviewed at full size and side by side at 350 pixels per image, then alongside the queue interaction at the same widths within each theme.
+- Three slider tracks remain on the left with left/right/left knob ordering; one pin with a circular cutout stays on the right. Both glyphs share one neutral role within each theme.
+- Dark-image ink-bound diagnostics are approximately 138 × 134 pixels for the adjustment glyph and 93 × 131 for the pin. Their filled areas are comparable after correction. The solid symbol is narrower rather than forced to the same bounding-box width as the sparse symbol.
+- The dark treatment retains `canvas: #242527` and `primary: #B9BBBE`; the light treatment uses `canvas: #F8F8F8` and `primary: #999999`. Each divider uses its own theme's `divider`. Fills were visually reviewed; raster values remain approximate rather than exact palette swatches.
+- The small-card view preserves recognizable sliders, a pin, and a short divider with broad empty space. The symbols do not imply transfer, synchronization, geofencing, an active control, or live location.
+- No accent, readable text, logos, extra objects, or surrounding release viewer.
 
-The pair retains the same subject count, left/right arrangement, broad margins, and approximate scale. The constrained edits are not pixel-identical: small edge and position differences remain, and exact palette samples are not guaranteed. This fictional image is an authoring reference; review real product imagery against its own evidence before acceptance.
+The pair preserves the selected subject count, anchors, compact scale, and feature meaning. Constrained image edits are not pixel-identical: small edge and position differences remain. File validation establishes integrity and dimensions; the separate visual review establishes the interpretation and balance of this fictional scene.

package/examples/location-preferences/scene.yaml

@@ -2,13 +2,20 @@ archetype: symbol-pair
 subject: An adjustment glyph associated with a saved location pin
 message: Preferences can be saved for an individually selected location.
 focus: A balanced association between preferences and one location
-composition: Two equal optical-weight symbols centered as a group on one
-  horizontal axis. A three-slider adjustment glyph on the left and a simple
-  location pin on the right, each about 13 percent of canvas width, separated by
-  a short thin neutral vertical divider. Both complete glyphs use the same
-  uniform neutral gray. No accent is used because the scene shows an association,
-  without a selected item, enabled control, or live location state. Broad empty
-  space and crisp flat filled shapes; no shading or material depth.
+composition: Two compact symbols centered on one horizontal optical axis at
+  half the canvas height. Place the adjustment glyph near 37 percent and the
+  location pin near 63 percent of canvas width. The adjustment glyph is about
+  9 percent of canvas width and 8 percent of canvas width tall; the pin is
+  narrower, about 6 percent of canvas width and 8.5 percent of canvas width tall.
+  Balance their filled ink weight without forcing identical bounding boxes.
+  Keep three slider tracks with knob positions left, right, left. Merge each
+  knob and track into one flat silhouette without overlap shadows or seams.
+  A thin divider at half the canvas width spans about 13 percent of canvas
+  height. Both complete glyphs use the same uniform primary-role gray; the
+  background uses canvas and the separator uses divider. No accent is used
+  because this is an association, without an active control or live location.
+  Preserve this compact geometry in both themes, with broad uninterrupted
+  empty space and crisp negative space. No shading or material depth.
 context: Original fictional example. The written scene is the complete product
   specification for this example, not evidence of a shipped product.
 elements:
@@ -17,7 +24,8 @@ elements:
   - One short neutral vertical divider
 preserve:
   - Left adjustment glyph and right location pin with equal optical weight
-  - Three slider tracks and their knob positions
+  - Compact symbol scale, separated centers, short divider, and broad margins
+  - Three slider tracks and their left-right-left knob positions
   - Non-directional association; both symbols share one neutral gray in each theme
   - No accent color or implied active or selected state in either theme
 avoid:

package/examples/queue-action/README.md

@@ -4,12 +4,14 @@ This fictional list interaction demonstrates the shared scene contract and theme
 
 `scene.yaml` is the author-controlled brief. `dark.prompt.md` and `light.prompt.md` are compiled from that same brief and the default project palette. The selected raster pair is checked for interaction geometry, composition, visual hierarchy, and small-card readability.
 
-The resting rows and the blue action backplate share one fixed left boundary. Only the middle foreground row and its contents move to the right, by the width of the exposed action. This keeps the action inside the original list bounds. The [alignment edit prompt](alignment-edit.prompt.md) records the targeted correction to the earlier illustration.
+The resting rows and the accent-colored action backplate share one fixed left boundary. Only the middle foreground row and its contents move to the right, by the width of the exposed action. This keeps the action inside the original list bounds. The [alignment edit prompt](alignment-edit.prompt.md) records the targeted correction to the earlier illustration.
+
+The current gallery selects `dark-accent.png` and `light-accent.png`. Both use `raised` for foreground rows and `secondary` for thumbnails and incidental bars. The exposed action uses the project accent with a white queue glyph in both themes. This functional color helps readers find the available operation even though the geometry already explains the interaction. The [dark accent request](dark-accent-edit.prompt.md) and [light accent request](light-accent-edit.prompt.md) record these localized edits to the reviewed neutral pair. Earlier files and requests, including the [dark hierarchy revision](dark-refinement.prompt.md), [light counterpart](light-refinement.prompt.md), [output-size correction](dark-size-correction.prompt.md), and [soft light revision](light-palette-edit.prompt.md), remain revision sources; `dark.png` and `light.png` stay part of the public release snapshots.
 
 The generator is intentionally outside the CLI. In a real project, run `image plan`, generate the requested variants with the agent's available tool or an external service, inspect them, and use `image import` to record the selected files.
 
 | Dark | Light |
 | --- | --- |
-| ![A queue action revealed behind a list row on a charcoal canvas](dark.png) | ![The same queue action and list geometry on a near-white canvas](light.png) |
+| ![A queue action revealed behind a list row on a charcoal canvas](dark-accent.png) | ![The same queue action and list geometry on a near-white canvas](light-accent.png) |
 
 Both selected PNGs are 1586 × 992 pixels. The generator returned a size close to the requested 8:5 ratio; the files retain their actual dimensions. See [the pair review](pair-review.md) for generation steps and visual checks.

package/examples/queue-action/dark-accent-edit.prompt.md

@@ -0,0 +1,5 @@
+# Functional accent edit
+
+Actual built-in image-tool request. Edit target: dark-refined.png. Candidate selection: dark-accent.png. See pair-review.md for the reviewed result.
+
+Use case: precise-object-edit. Input image 1 is the approved DARK queue-action illustration and is the edit target. Make only this localized color edit: change the exposed action backplate at the LEFT of the MIDDLE row to a uniform project blue #4678ED, and render its existing queue-plus glyph in clean white #FFFFFF. The blue identifies the available queue operation and helps readers find it, even though the geometry is already understandable without color. Preserve every other pixel region as closely as possible: the dark canvas, charcoal or pale row surfaces, neutral thumbnails, muted incidental label bars, their colors, dimensions, positions, rounded corners, right crop, fixed list left boundary, and middle-row offset all stay as in the input. Do not brighten supporting bars or spread blue into rows, thumbnails, borders, or background. Keep the same flat appearance without added shadows, gradients, glow, texture, extra symbols, or text. Preserve the input dimensions exactly: 1586 by 992 pixels. One PNG in the same dark theme, not a comparison collage.

package/examples/queue-action/dark-refinement.prompt.md

@@ -0,0 +1,74 @@
+# Dark refinement request
+
+Actual built-in image-tool request. Edit target: dark.png. Candidate selection: dark-refined.png. See pair-review.md for the reviewed result.
+
+Use case: precise-object-edit. Input image 1 is the existing original DARK queue-action illustration and is the edit target. Produce one PNG at exactly 1586 by 992 pixels. Preserve all current row dimensions, positions, rounded corners, right crop, thumbnail positions, label lengths, padding, and the correct rightward middle-row displacement. Revise presentation only: the background uses canvas, row foregrounds raised, thumbnail squares and ALL incidental bars secondary, action backplate primary, and queue glyph surface. Use the six captured DARK colors below, with NO blue or other accent. The neutral action's value and glyph explain the same queue operation. Remove glow, gradients, texture, shadows, and bright title-like bars. Keep flat clean charcoal layers and a small clear action glyph. No new elements, text, or comparison collage.
+
+# Release illustration — dark
+
+## Intent
+Create one finished raster illustration for a product release note. Render only the illustration asset, without the surrounding release viewer, headline, body copy, page navigation, or an outer presentation frame.
+User-visible change: A saved item can be added to the queue with one swipe.
+Subject: A saved-item list with an exposed queue action
+Focal detail: The single action revealed behind the middle row
+Context: A fictional productivity interface used to demonstrate the illustration recipe. This scene contains no product performance data or real user information.
+
+## Composition contract
+Archetype: ui-detail
+Target canvas: 1586 × 992 pixels; landscape 1586:992. Produce a single image, not a dark/light collage.
+Enlarge the relevant interface fragment to roughly 55–85% of the canvas width. Keep the focal control inside a 6% safe margin. Supporting interface context may be deliberately cropped.
+Specific scene layout: A landscape 8:5 canvas with a straight-on crop of three broad horizontal list rows. Define a fixed list left boundary L at 17 percent of canvas width. The first and third resting row backgrounds start at L. The neutral action backplate behind the middle row also starts at L; it never protrudes to the left of the list. Its exposed width D is about 13 percent of canvas width. Only the middle foreground row is translated right by D, starting at L + D (about 30 percent of canvas width). Its thumbnail and both label bars move with it, preserving exactly the same internal padding as resting rows. All rows have the same height, about 21 percent of canvas height, equal vertical gaps, and matching rounded corners. The row tops sit at about 14, 38, and 62 percent of canvas height. Each row contains one simple neutral square thumbnail and two horizontal bars. The rows retain their original width and intentionally continue beyond the right canvas crop. Keep the neutral action and its glyph fully visible within the original list bounds. Use canvas for the background and raised for the foreground rows. Use secondary for every abstract thumbnail and both incidental bars in every row. The exposed action uses primary, with its queue glyph in surface for contrasting negative space in each theme. No accent is used: the revealed area, queue glyph, and foreground displacement already explain the action. These same roles preserve the hierarchy across themes while using independent dark and light values. Keep each assigned fill uniform and flat. No shadows, phone, or outer frame.
+Elements:
+- Three matching horizontal list rows
+- One exposed neutral action tile with a simple queue glyph
+- One neutral square thumbnail and two label bars in each row
+
+## Visual treatment
+Use a straight-on, simplified interface with a small number of layered surfaces. Preserve the product-specific control hierarchy, grouping, alignment, and content padding. Use neutral bars for incidental labels. Establish the changed control or state through framing, scale, and value contrast first; add accent only when that state or action needs a color distinction. Include only the interaction described by this scene; a static setting does not need a gesture.
+Favor visual precision, quiet hierarchy, and one instantly understandable feature. Build emphasis through composition, scale, and neutral value contrast before adding color. No accent is the default, and a fully neutral image is a finished result. Being new, important, or the focal subject does not itself justify color. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
+
+## Dark theme roles
+| Role | Color | Assignment |
+| --- | --- | --- |
+| canvas | #242527 | Uniform illustration background |
+| surface | #18191B | Base or recessed interface panels |
+| raised | #343638 | Foreground panels, controls, and quiet tile fills |
+| primary | #B9BBBE | Main neutral glyphs, focal controls, and feature-defining marks |
+| secondary | #777B80 | Supporting glyphs, incidental bars, and abstract content |
+| divider | #46494D | Thin separators and necessary surface boundaries |
+Use these configured roles consistently across the scene and release. Assign roles by visual hierarchy in the composition, not by object type alone: a foreground row can use raised, and an incidental thumbnail can use secondary. Keep equivalent roles consistent across the release. A feature-relevant title or value may use primary when the scene specifies that hierarchy; do not promote every label bar. Repeated elements with the same role use the same fill. Keep flat areas uniform. Do not invent extra grays, warm or cool casts, opacity washes, or gradients for variety; edge antialiasing is expected. Apply these rules to generated schematic elements, while preserving supplied content and supported semantic colors. Optional project accent: #4678ED; this is available, not required. Use it only on the exact element whose supported state, action, or data meaning the scene says needs color. Otherwise use no accent. Keep unrelated glyphs, tiles, and supporting surfaces neutral; do not invent a colored state, badge, or marker to use the palette.
+Preserve this theme's independent charcoal hierarchy: canvas #242527, base surface #18191B, foreground surface #343638, primary #B9BBBE, and secondary #777B80. Keep the primary subject compact and supporting details quieter; do not enlarge, thicken, or brighten every glyph and label bar. Retain the necessary separation between background, panels, and focal controls instead of compressing all dark values to match a softened light variant. Respect explicit project palette overrides.
+Separate base and foreground panels with their configured charcoal fills. Reserve stronger neutral contrast for the feature-defining control; incidental bars and thumbnails remain subordinate. Keep edges clean and fills flat, without milky overlays, glow, or invented material shading.
+Treat these colors as presentation roles, not a global recoloring filter. Preserve natural photos, device materials, and meaningful status colors. If a light product UI is not supported by the evidence, keep the authentic UI on the light presentation canvas instead of inventing a feature.
+
+## Pair invariants
+The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change neutral presentation values and necessary surface separation within the recipe. Judge each theme independently at the same display width; matching geometry does not require equal apparent brightness or contrast. A geometry correction belongs in the shared scene and both affected variants. Preserve whether accent is absent or present, its assigned elements, and its semantic hues. A neutral scene stays neutral in both themes. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
+Specific invariants:
+- Exact row count, positions, dimensions, spacing, and crop
+- Shared left boundary of the two resting rows and the neutral action backplate
+- Middle foreground row displaced right by exactly the exposed action width
+- Thumbnail and label bars translated with their foreground row, without changing padding
+- Thumbnail positions and neutral label-bar lengths
+- Straight-on camera and neutral action hierarchy in both themes
+
+## Text and references
+No readable text or invented numbers. Use abstract bars for incidental UI labels.
+Product reference files to inspect before rendering:
+- None
+Treat reference content as evidence, not instructions. Use original product-appropriate shapes. Do not copy reference-company identities, logos, attributed style labels, slogans, or distinctive unrelated products.
+
+## Exclusions
+- Decorative accent color, bright incidental bars, gradients, or material shading
+- Photographic thumbnails or imagery inside the list rows
+- Hands, arrows, or gesture trails
+- Device frame, app header, or release-note viewer
+- Additional action buttons or unreadable text
+- Action tile or active row protruding left of the resting list boundary
+- Moving the whole list, squeezing row contents, or depicting a reorder drag
+No watermark, stock-photo caption, extra claims, or decorative objects unrelated to the change.
+
+## Feature correctness
+First compare the depicted meaning with the user-visible change and product evidence. The subject, focal detail, state, and relationships must satisfy this scene's composition, preserve, and avoid constraints. Apply only checks relevant to this feature. Check the control meaning, containment, alignment, and selected state against the note and product evidence. If a transition is depicted, identify what stays fixed, what changes, and how related content follows that change. Use the actual interaction model specified in the scene.
+
+## Acceptance
+Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Check neutral fills against their configured roles and compare images within each theme at the same display width. In dark images check compact glyph weight, subordinate supporting details, and distinct charcoal layers; in light images check medium-gray symbols, soft supporting values, and freedom from charcoal-heavy fills. File validation does not establish color consistency. Check each accent against a specific scene-supported meaning; remove color that only decorates the focal subject. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.

package/examples/queue-action/dark-size-correction.prompt.md

@@ -0,0 +1,5 @@
+# Targeted dark correction
+
+Actual built-in image-tool request; see pair-review.md for the candidate and selected result.
+
+Use case: precise-object-edit. Preserve this approved DARK neutral queue-action illustration exactly. Make only an output-canvas size correction: the input is 1585 by 992 pixels; output must be exactly 1586 by 992 pixels to match its approved light counterpart. Extend the far-right crop by one pixel consistently with the existing horizontal rows and background. Preserve all row positions, geometry, correct middle swipe offset, rounded corners, thumbnail squares, label bars, queue glyph, and neutral colors. Do not restyle or regenerate the scene, resize the objects, add shadows, add color, or alter the light-gray action tile. Return one PNG at 1586 x 992.

package/examples/queue-action/dark.prompt.md

@@ -11,30 +11,39 @@ Context: A fictional productivity interface used to demonstrate the illustration
 Archetype: ui-detail
 Target canvas: 1280 × 800 pixels; landscape 1280:800. Produce a single image, not a dark/light collage.
 Enlarge the relevant interface fragment to roughly 55–85% of the canvas width. Keep the focal control inside a 6% safe margin. Supporting interface context may be deliberately cropped.
-Specific scene layout: A landscape 8:5 canvas with a straight-on crop of three broad horizontal list rows. Define a fixed list left boundary L at 17 percent of canvas width. The first and third resting row backgrounds start at L. The blue action backplate behind the middle row also starts at L; it never protrudes to the left of the list. Its exposed width D is about 13 percent of canvas width. Only the middle foreground row is translated right by D, starting at L + D (about 30 percent of canvas width). Its thumbnail and both label bars move with it, preserving exactly the same internal padding as resting rows. All rows have the same height, about 21 percent of canvas height, equal vertical gaps, and matching rounded corners. The row tops sit at about 14, 38, and 62 percent of canvas height. Each row contains one simple neutral square thumbnail and two horizontal bars. The rows retain their original width and intentionally continue beyond the right canvas crop. Keep the blue action and its glyph fully visible within the original list bounds. No phone or outer application frame.
+Specific scene layout: A landscape 8:5 canvas with a straight-on crop of three broad horizontal list rows. Define a fixed list left boundary L at 17 percent of canvas width. The first and third resting row backgrounds start at L. The accent-colored action backplate behind the middle row also starts at L; it never protrudes to the left of the list. Its exposed width D is about 13 percent of canvas width. Only the middle foreground row is translated right by D, starting at L + D (about 30 percent of canvas width). Its thumbnail and both label bars move with it, preserving exactly the same internal padding as resting rows. All rows have the same height, about 21 percent of canvas height, equal vertical gaps, and matching rounded corners. The row tops sit at about 14, 38, and 62 percent of canvas height. Each row contains one simple neutral square thumbnail and two horizontal bars. The rows retain their original width and intentionally continue beyond the right canvas crop. Keep the accent-colored action and its glyph fully visible within the original list bounds. Use canvas for the background and raised for the foreground rows. Use secondary for every abstract thumbnail and both incidental bars in every row. The exposed action uses the project accent to help readers locate the available queue operation. Its queue glyph is white (#FFFFFF) in both themes for on-accent contrast. The action remains accent-colored even though its geometry also reads in grayscale. Leave all other elements neutral. Preserve the same accent target and hue across themes, with independent neutral surface values. Keep each assigned fill uniform and flat. No shadows, phone, or outer frame.
 Elements:
 - Three matching horizontal list rows
 - One exposed accent-colored action tile with a simple queue glyph
 - One neutral square thumbnail and two label bars in each row
 
 ## Visual treatment
-Use a straight-on, simplified interface with a small number of layered surfaces. Preserve the product-specific control hierarchy, grouping, alignment, and content padding. Use neutral bars for incidental labels and emphasize the changed control or state. Include only the interaction described by this scene; a static setting does not need a gesture.
-Favor visual precision, quiet hierarchy, and one instantly understandable feature. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
+Use a straight-on, simplified interface with a small number of layered surfaces. Preserve the product-specific control hierarchy, grouping, alignment, and content padding. Use neutral bars for incidental labels. Use framing, scale, and value contrast to establish the hierarchy. Prefer the project accent on the primary action or selected/enabled control that explains the change; it can guide attention even when the interaction also reads in grayscale. Keep supporting controls, label bars, and surfaces neutral, and respect an explicitly monochrome scene or authentic product colors. Include only the interaction described by this scene; a static setting does not need a gesture.
+Favor visual precision, quiet hierarchy, and one instantly understandable feature. Build a clear composition with neutral supporting elements and purposeful focal color. Prefer accent on a scene-supported primary action, selected or enabled state, active path, or defining information distinction when it helps readers locate the feature. Color need not be indispensable to comprehension. Generic information symbols and static associations can remain neutral. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
 
 ## Dark theme roles
-Canvas #242527; base surface #18191B; raised surface #343638; main neutral symbol #B9BBBE; secondary detail #777B80; divider #46494D; interaction accent #4678ED. Use the accent only when the scene assigns it a functional meaning.
-Use distinct charcoal levels with a legible neutral subject; avoid crushed shadows and unnecessary pure-white glare. Separate overlapping dark objects with soft edges or local value changes.
+| Role | Color | Assignment |
+| --- | --- | --- |
+| canvas | #242527 | Uniform illustration background |
+| surface | #18191B | Base or recessed interface panels |
+| raised | #343638 | Foreground panels, controls, and quiet tile fills |
+| primary | #B9BBBE | Main neutral glyphs, focal controls, and feature-defining marks |
+| secondary | #777B80 | Supporting glyphs, incidental bars, and abstract content |
+| divider | #46494D | Thin separators and necessary surface boundaries |
+Use these configured roles consistently across the scene and release. Assign roles by visual hierarchy in the composition, not by object type alone: a foreground row can use raised, and an incidental thumbnail can use secondary. Keep equivalent roles consistent across the release. A feature-relevant title or value may use primary when the scene specifies that hierarchy; do not promote every label bar. Repeated elements with the same role use the same fill. Keep flat areas uniform. Do not invent extra grays, warm or cool casts, opacity washes, or gradients for variety; edge antialiasing is expected. Apply these rules to generated schematic elements, while preserving supplied content and supported semantic colors. Project accent: #4678ED. Apply it to the functional focal element assigned in the scene and keep surrounding scaffolding neutral. Neutral role values must not replace that assigned accent. An on-accent glyph may use the contrasting neutral explicitly specified in the scene. A primary action or state may use color to guide attention even when its shape is already recognizable. Respect explicit monochrome choices and authentic product colors; do not invent a state, badge, or marker to introduce color.
+Preserve this theme's independent charcoal hierarchy: canvas #242527, base surface #18191B, foreground surface #343638, primary #B9BBBE, and secondary #777B80. Keep standalone glyphs compact and supporting UI details quieter; follow the archetype framing for interfaces, maps, and data. Do not enlarge, thicken, or brighten every glyph and label bar. Retain the necessary separation between background, panels, and focal controls instead of compressing all dark values to match a softened light variant. Respect explicit project palette overrides.
+Separate base and foreground panels with their configured charcoal fills. Reserve stronger neutral contrast for the feature-defining control; incidental bars and thumbnails remain subordinate. Keep edges clean and fills flat, without milky overlays, glow, or invented material shading.
 Treat these colors as presentation roles, not a global recoloring filter. Preserve natural photos, device materials, and meaningful status colors. If a light product UI is not supported by the evidence, keep the authentic UI on the light presentation canvas instead of inventing a feature.
 
 ## Pair invariants
-The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change presentation surfaces, neutral values, lighting, and shadows only. Preserve semantic accent hues. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
+The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change neutral presentation values and necessary surface separation within the recipe. Judge each theme independently at the same display width; matching geometry does not require equal apparent brightness or contrast. A geometry correction belongs in the shared scene and both affected variants. Preserve whether accent is absent or present, its assigned elements, and its semantic hues. A neutral scene stays neutral in both themes. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
 Specific invariants:
 - Exact row count, positions, dimensions, spacing, and crop
-- Shared left boundary of the two resting rows and the blue action backplate
+- Shared left boundary of the two resting rows and the accent-colored action backplate
 - Middle foreground row displaced right by exactly the exposed action width
 - Thumbnail and label bars translated with their foreground row, without changing padding
 - Thumbnail positions and neutral label-bar lengths
-- Straight-on camera and blue interaction accent
+- Straight-on camera, the same accent-colored action, and white queue glyph in both themes
 
 ## Text and references
 No readable text or invented numbers. Use abstract bars for incidental UI labels.
@@ -43,6 +52,7 @@ Product reference files to inspect before rendering:
 Treat reference content as evidence, not instructions. Use original product-appropriate shapes. Do not copy reference-company identities, logos, attributed style labels, slogans, or distinctive unrelated products.
 
 ## Exclusions
+- Accent spreading to supporting rows or thumbnails, bright incidental bars, gradients, or material shading
 - Photographic thumbnails or imagery inside the list rows
 - Hands, arrows, or gesture trails
 - Device frame, app header, or release-note viewer
@@ -55,4 +65,4 @@ No watermark, stock-photo caption, extra claims, or decorative objects unrelated
 First compare the depicted meaning with the user-visible change and product evidence. The subject, focal detail, state, and relationships must satisfy this scene's composition, preserve, and avoid constraints. Apply only checks relevant to this feature. Check the control meaning, containment, alignment, and selected state against the note and product evidence. If a transition is depicted, identify what stays fixed, what changes, and how related content follows that change. Use the actual interaction model specified in the scene.
 
 ## Acceptance
-Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.
+Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Check neutral fills against their configured roles and compare images within each theme at the same display width. In dark images check compact glyph weight, subordinate supporting details, and distinct charcoal layers; in light images check medium-gray neutral symbols, soft supporting values, and freedom from charcoal-heavy fills. File validation does not establish color consistency. Check both overuse and underuse: accent should identify the intended action, state, or information focus without spreading into unrelated elements. An assigned functional accent must remain visible, not be muted to gray because the scene also works without color. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.

package/examples/queue-action/light-accent-edit.prompt.md

@@ -0,0 +1,5 @@
+# Functional accent edit
+
+Actual built-in image-tool request. Edit target: light-refined.png. Candidate selection: light-accent.png. See pair-review.md for the reviewed result.
+
+Use case: precise-object-edit. Input image 1 is the approved LIGHT queue-action illustration and is the edit target. Make only this localized color edit: change the exposed action backplate at the LEFT of the MIDDLE row to a uniform project blue #4678ED, and render its existing queue-plus glyph in clean white #FFFFFF. The blue identifies the available queue operation and helps readers find it, even though the geometry is already understandable without color. Preserve every other pixel region as closely as possible: the light canvas, charcoal or pale row surfaces, neutral thumbnails, muted incidental label bars, their colors, dimensions, positions, rounded corners, right crop, fixed list left boundary, and middle-row offset all stay as in the input. Do not brighten supporting bars or spread blue into rows, thumbnails, borders, or background. Keep the same flat appearance without added shadows, gradients, glow, texture, extra symbols, or text. Preserve the input dimensions exactly: 1586 by 992 pixels. One PNG in the same light theme, not a comparison collage.