<ui_patterns>

Visual patterns for user-facing GMD output. Orchestrators @-reference this file.

## Color Scheme

GMD uses a deep bright purple palette for all terminal output.

```
Primary:    \x1b[38;5;135m   (medium purple #af5fff) -- banners, headers
Bold:       \x1b[1;38;5;135m (bold medium purple) -- emphasis
Light:      \x1b[38;5;183m   (light purple #d7afff) -- secondary text
Dark:       \x1b[38;5;93m    (dark purple #8700ff) -- borders, separators
Background: \x1b[48;5;53m    (purple background) -- highlights (use sparingly)
Reset:      \x1b[0m
```

---

## Stage Banners

Use for major workflow transitions.

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 GMD > {STAGE NAME}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

**Stage names (uppercase):**
- `QUESTIONING`
- `RESEARCHING`
- `DEFINING REQUIREMENTS`
- `CREATING ROADMAP`
- `PLANNING PHASE {N}`
- `EXECUTING WAVE {N}`
- `VERIFYING`
- `PHASE {N} COMPLETE`
- `MILESTONE COMPLETE`

---

## Checkpoint Boxes

User action required. 62-character width.

```
+==============================================================+
|  CHECKPOINT: {Type}                                          |
+==============================================================+

{Content}

--------------------------------------------------------------
-> {ACTION PROMPT}
--------------------------------------------------------------
```

**Types:**
- `CHECKPOINT: Verification Required` -> `-> Type "approved" or describe issues`
- `CHECKPOINT: Decision Required` -> `-> Select: option-a / option-b`
- `CHECKPOINT: Action Required` -> `-> Type "done" when complete`

---

## Status Symbols

```
[done]    Complete / Passed / Verified
[fail]    Failed / Missing / Blocked
[work]    In Progress
[wait]    Pending
[auto]    Auto-approved
[warn]    Warning
[party]   Milestone complete (only in banner)
```

---

## Progress Display

**Phase/milestone level:**
```
Progress: ========-- 80%
```

**Task level:**
```
Tasks: 2/4 complete
```

**Plan level:**
```
Plans: 3/5 complete
```

---

## Spawning Indicators

```
[work] Spawning researcher...

[work] Spawning 4 researchers in parallel...
  -> Stack research
  -> Features research
  -> Architecture research
  -> Pitfalls research

[done] Researcher complete: STACK.md written
```

---

## Next Up Block

Always at end of major completions.

```
---------------------------------------------------------------

## >> Next Up

**{Identifier}: {Name}** -- {one-line description}

`{copy-paste command}`

`/clear` first -> fresh context window

---------------------------------------------------------------

**Also available:**
- `/gmd:alternative-1` -- description
- `/gmd:alternative-2` -- description

---------------------------------------------------------------
```

---

## Error Box

```
+==============================================================+
|  ERROR                                                       |
+==============================================================+

{Error description}

**To fix:** {Resolution steps}
```

---

## Tables

```
| Phase | Status | Plans | Progress |
|-------|--------|-------|----------|
| 1     | [done] | 3/3   | 100%     |
| 2     | [work] | 1/4   | 25%      |
| 3     | [wait] | 0/2   | 0%       |
```

---

## Anti-Patterns

- Varying box/banner widths
- Mixing banner styles (`===`, `---`, `***`)
- Skipping `GMD >` prefix in banners
- Random emoji
- Missing Next Up block after completions

</ui_patterns>
