# README Visual Review Board

Date: `2026-04-10`

This board imports the current best source images from `~/Downloads` into repo-owned canonical paths so they can be reviewed, iterated, and promoted into final README assets.

Primary source folder:

- [.github/visual-sources](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources)

Related system document:

- [README_VISUAL_SYSTEM_2026-04-10.md](README_VISUAL_SYSTEM_2026-04-10.md)

---

## Status

Imported source images:

1. `m1nd-key-visual-v2-source.jpeg`
2. `m1nd-agent-first-map-v2-source.jpeg`
3. `m1nd-architecture-overview-v2-source.jpeg`
4. `m1nd-jobs-surface-v1-source.jpeg`
5. `m1nd-orientation-tax-v1-source.jpeg`

These are not yet the final publish-ready README assets.

They are the current best composition winners.

---

## 1. Hero Candidate

**Role**

- `R01` Hero key visual
- possible secondary use as social/OpenGraph seed

**File**

- [m1nd-key-visual-v2-source.jpeg](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources/m1nd-key-visual-v2-source.jpeg)

**Preview**

![m1nd hero candidate](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources/m1nd-key-visual-v2-source.jpeg)

**What works**

- strongest negative space
- premium dark substrate
- feels like a central intelligence core instead of a random sci-fi scene
- easy to place headline copy into

**What still needs work**

- the native `m1nd` text inside the image should not be trusted as final
- it needs a README-aware crop/composition pass
- may need stronger structural cues so it reads as product, not just atmosphere

**Verdict**

- best current source for the hero

---

## 2. Before / After Candidate

**Role**

- `R02` Before vs After `m1nd`

**File**

- [m1nd-agent-first-map-v2-source.jpeg](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources/m1nd-agent-first-map-v2-source.jpeg)

**Preview**

![m1nd before after candidate](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources/m1nd-agent-first-map-v2-source.jpeg)

**What works**

- strongest expression of the product thesis
- left vs right movement is readable
- the central convergence around `m1nd` is useful
- more elegant than the interim repo-generated map

**What still needs work**

- some wording should be corrected to canonical README copy
- small incidental micro-text should be cleaned
- final version should likely be hybrid:
  - image source from this file
  - final typography pass applied manually

**Verdict**

- best current source for the README comparison image

---

## 3. Jobs Surface Candidate

**Role**

- `R07` jobs surface
- can also support `What Ships Today`

**File**

- [m1nd-jobs-surface-v1-source.jpeg](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources/m1nd-jobs-surface-v1-source.jpeg)

**Preview**

![m1nd jobs surface candidate](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources/m1nd-jobs-surface-v1-source.jpeg)

**What works**

- the 3-stage structure is immediate
- “understand / predict / verify” is close to the right product framing
- useful for a more visual `What Ships Today` section

**What still needs work**

- bottom explanatory copy is too long and too AI-shaped
- the card language is good, but needs canonical wording
- may be better as a site/wiki image than a README image unless we shorten it further

**Verdict**

- strong supporting image, not the first README image to ship

---

## 4. Orientation Tax Candidate

**Role**

- `R05` orientation tax
- support image for `Why m1nd`

**File**

- [m1nd-orientation-tax-v1-source.jpeg](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources/m1nd-orientation-tax-v1-source.jpeg)

**Preview**

![m1nd orientation tax candidate](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources/m1nd-orientation-tax-v1-source.jpeg)

**What works**

- best visualization of recursive wandering
- visually rich without needing literal left/right comparison
- excellent support visual for the “agents rediscover the same system every turn” argument

**What still needs work**

- the generated text is not reliable enough to publish as-is
- needs cleanup if promoted into the README

**Verdict**

- excellent support asset for phase 2

---

## 5. Architecture Candidate

**Role**

- `R04` architecture at a glance

**File**

- [m1nd-architecture-overview-v2-source.jpeg](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources/m1nd-architecture-overview-v2-source.jpeg)

**Preview**

![m1nd architecture candidate](/Users/cosmophonix/.codex/worktrees/upstream/m1nd-upstream/.github/visual-sources/m1nd-architecture-overview-v2-source.jpeg)

**What works**

- immediately reads as architecture
- dark premium tone matches the rest of the batch
- labeled crate blocks are useful

**What still needs work**

- duplicate `m1nd-core` label needs correction
- final crate relationships need to be checked against truth
- should be rebuilt or patched into a technically exact final diagram

**Verdict**

- best current source for the architecture image

---

## Recommended promotion order

Promote these into final repo-facing assets in this order:

1. `m1nd-agent-first-map-v2-source.jpeg`
2. `m1nd-key-visual-v2-source.jpeg`
3. `m1nd-architecture-overview-v2-source.jpeg`
4. `m1nd-jobs-surface-v1-source.jpeg`

Reason:

- the before/after image explains the product fastest
- the hero image sets category and tone
- the architecture image grounds technical credibility
- the jobs image is high-value but less critical than those three

---

## Immediate next actions

### P0 finalization set

These are the four final assets now established for the README:

1. `.github/m1nd-agent-first-map-v2.jpeg`
2. `.github/m1nd-key-visual-v2.jpeg`
3. `.github/m1nd-architecture-overview-v2.jpeg`
4. `.github/m1nd-operability-surface-v2.jpeg`

### Notes

- `m1nd-operability-surface-v2` was regenerated from the jobs idea into a cleaner final image
- `m1nd-architecture-overview-v2` was regenerated from scratch because the imported source had wrong labels

---

## Final curation decision

This is the currently selected README set after review and one extra iteration pass.

### Keep

- `.github/m1nd-key-visual-v2.jpeg`
- `.github/m1nd-agent-first-map-v2.jpeg`
- `.github/m1nd-operability-surface-v2.jpeg`
- `.github/m1nd-architecture-overview-v2.jpeg`

### Notes

- the `before/after` image was tested with one additional regeneration pass and then reverted to the original imported source because the source composition remained stronger
- the `operability` image was regenerated into a much cleaner three-word version and is now better than the imported source
- the `architecture` image was regenerated because the imported source had incorrect duplicate crate labels
