Visual Asset Atlas
A found field notebook for Megan

Megan, The Visual Asset Atlas

A plain-English tour of how Visual Asset Integration turns AI-built shareables from generic pages into intentional, image-led artifacts with real source discipline.

Public-safe Visually QA'd Proof-aware
Start nontechnical

The shift is simple: every visual gets a job.

A generic shareable drops images into a page because a page feels empty. A designed shareable asks what each image is responsible for: orienting the reader, proving a claim, creating mood, explaining a workflow, or making an action feel cared for.

Place

Anchor mapping names where the visual belongs before the page is built, so images stop colliding with text, buttons, and mobile crops.

Trust

Generated visuals can carry personality. Real artifacts carry proof. The workflow keeps those roles separate.

Finish

The work is not done when the image looks good in chat. It is done when the recovered file renders cleanly on the public page.

The workflow

From first idea to publish-ready visual system.

The artifact you are reading is a live demo of the workflow. Its backgrounds, diagrams, icons, buttons, and atmosphere are generated assets. Its claims are source-labeled. Its layout is checked against visual anchors.

Ancient manuscript workflow diagram showing generated asset, anchor mapping, QA, and final page stages.
Illustrative generated diagram. The HTML carries the labels so the workflow stays readable and accessible.
1. IntentName the reader, promise, and emotional shape.
2. Source statusSeparate proof from illustration before images appear.
3. GenerateCreate one asset at a time, with placement in mind.
4. RecoverPersist the generated file from the rollout JSONL.
5. AnchorMap where it belongs on desktop and mobile.
6. QARender, inspect, repair, then publish.
Anchor mapping lab

Anchor mapping is how the image learns where it belongs.

Instead of saying "put the image somewhere near the text," the workflow gives each visual a named region, role, risk, and verification test. Select a pin to see what that means in practice.

Ancient notebook style diagram with anchor pins, grid regions, and placement boxes.
Generated asset lab

The recovered file matters more than the chat preview.

For icons and cutouts, the corrected workflow generates one object on chroma-key green, recovers the actual image bytes, then creates a transparent derivative. The green image below is a recovered file, not a screenshot of the chat.

Recovered generated anchor icon on chroma-key green before background removal.
Recovered source on chroma-key green.
Generated manuscript-style anchor pin icon with transparent background.
Transparent derivative used in the UI.
Show the persistence rule

When an image appears in chat but no durable PNG is saved, recover the base64 result from the Codex rollout JSONL, copy it to a stable project path, and verify it before editing or placing it.

python3 scripts/recover_codex_imagegen.py \
  --latest-only \
  --name-hint "<asset-slug>" \
  --copy-latest-to "<project-root>/.codex-outputs/images/<lane>/<asset-slug>_v01_<timestamp>.png"

test -s "<absolute-path-to-image.png>"
/usr/bin/sips -g pixelWidth -g pixelHeight "<absolute-path-to-image.png>"
Pro GM portfolio case pattern

The Pro GM portfolio workflow is the proof-aware version of the same idea.

For the Pro GM / Goldspire portfolio work, the useful pattern was not "make it prettier." It was: gather real evidence, catalog what it can prove, then use generated visuals to create atmosphere around the proof instead of replacing it.

Evidence

Real game artifacts, links, screenshots, videos, and documents belong near the claims they support.

Status

Every source gets a label: verified, source-backed derivative, illustrative generated, pending, or unknown.

Atmosphere

Generated visuals supply world feel, section rhythm, and reader emotion. They do not pretend to be proof.

Placement

Anchor mapping keeps proof readable and prevents decorative art from crowding the work evidence.

Why this matters for portfolio credibility

A portfolio page can look polished and still fail if the reader cannot tell which images are evidence. The skill forces that distinction early. The emotional layer makes the work memorable; the source layer keeps it trustworthy.

QA and craft pass

The final step is not taste. It is rendered evidence.

A visual shareable is only finished after the actual rendered page is inspected. The weak spots are predictable: mobile overflow, clipped labels, hidden buttons, broken images, low contrast, and generated visuals accidentally sitting where proof should sit.

Visual anchor review

This artifact tracks `Hero01`, `Map01`, `AssetLab01`, `CaseStudy01`, `Download01`, and `MobileNav01`. Those anchors define what must be checked before publishing.

no overflow no clipped text public-safe

Design taste review

The site avoids generic cards-on-gradient styling by giving the entire surface a specific visual system: manuscript textures, generated iconography, muted ink colors, and image-led section rhythm.

distinct voice stable layout plain first
Download and install

Take the field notes with you.

The kit includes a sanitized `SKILL.md`, install notes for Codex and Claude Desktop, an anchor-map template, an asset-manifest template, and prompt examples for hero backgrounds and chroma-key icons.

Download the kit

Use it as a portable starting point for future public artifacts, shareables, portfolio pages, or design-heavy docs.

Download zip

Starter prompt

Use this when you want the AI to plan images before generating them.

Create a visual asset plan before generation.
For each asset, define: purpose, source status, anchor, crop behavior, alt text, and QA method.
For icons/cutouts, generate one image at a time on chroma-key green #00ff00.
After generation, recover the durable file and verify it before placement.

Codex install shape

Place the skill in your local skills folder, then copy the templates into the project that needs visual asset discipline. If you use Codex image generation, keep the recovery script in that project and run it after each generated image.

Claude Desktop install shape

Add the skill text to project knowledge or instructions. Use the anchor and asset manifest templates as working docs before prompting for images.

What the templates enforce

They make the AI name the asset's job, source status, placement, crop risk, and verification method before it generates or places visuals.