# Visual Interviews (VIs)

Ivy's mandatory communication format. Each VI is a self-contained HTML file
she can open on phone or desktop. Results save to `results/NNN-slug.json`.

> **2026-04-18 — foundation rebuild in progress.** Ivy provided a new
> starting point (pure black + iridescent cyan/magenta/purple chrome +
> rose-gold filigree + starseed: stars AND vines, always). Re-running the
> whole 7-iteration interview to re-lock the foundation. VI #001 is
> archived; active work is at `foundation/` and VI #002 onward.

| #    | Slug                | Purpose                                              | Status       |
|------|---------------------|------------------------------------------------------|--------------|
| 001  | baseline            | Original baseline (old foundation)                   | archived     |
| 002  | layout-typography   | Header/body density, display + body font, a11y       | **active**   |
| 003  | —                   | Motif hierarchy (starseed vocabulary ranking)        | planned      |
| 004  | —                   | Report anatomy / structure                           | planned      |
| 005  | —                   | Mood dial + motion                                   | planned      |
| 006  | —                   | Client-facing quiz format                            | planned      |
| 007  | —                   | Final review + foundation lock                       | planned      |

Process notes and compiled answers live in
[`foundation/`](foundation/).

## How Ivy uses a VI

1. Open the HTML file (landing page CTA carries her in).
2. Tap through the tiles. **Every question has a free-text "opinion" box** so
   she can add her own words — never boxed into options that aren't there.
3. At the end, tap **Copy my answers**. Paste back to Claude / Leiph.
4. Claude compiles answers into `foundation/NN-*.md`, drafts the next VI,
   and updates the brain.

## Format rules (short version)

- 3–5 questions per iteration (foundation-rebuild pacing).
- Every question: multi-choice tiles AND a free-text opinion field.
- Never force a binary either/or (stars AND vines, always both).
- Follows Ivy's current foundation (updated after each VI; locked at #007).
- Autosaves to localStorage so partial answers don't get lost.
- Honors `prefers-reduced-motion`.

Full rules live in
[`../.claude/skills/ivysgarden-context/SKILL.md`](../.claude/skills/ivysgarden-context/SKILL.md).