# WDS Glossary

Locked terminology for all WDS agents. One definition per term — no synonyms, no aliases.
Agents load this file once at activation. Do not redefine these terms locally.

---

## Phases

| Phase | Name | Owner |
|-------|------|-------|
| 0 | Alignment & Signoff | Saga |
| 1 | Product Brief | Saga |
| 2 | Trigger Mapping | Saga |
| 3 | UX Scenarios | Freya |
| 4 | UX Design | Freya |
| 5 | Agentic Development | Mimir |
| 6 | Asset Generation | Freya |
| 7 | Design System | Freya |
| 8 | Product Evolution | Mimir |

---

## Output Folder Structure

```
{output_folder}/
├── A-Product-Brief/       Phase 1 — strategic foundation
├── B-Trigger-Map/         Phase 2 — user research & personas
├── C-UX-Scenarios/        Phase 3 — journey flows
├── D-UX-Design/           Phase 4 — page specifications & design assets
└── E-Development/         Phase 5 — technical requirements, work orders, code
```

Progress files (machine-local, not committed):
```
progress/
├── [agent].md             Session state per agent
└── project-index.md       Living artifact index, updated on wrap
```

---

## Artifacts

### Strategy (Phase 1)
- **Product Brief** — `A-Product-Brief/product-brief.md`. Strategic foundation: vision, goals, constraints, target users. Required before any design work.
- **Content Language** — `A-Product-Brief/content-language.md`. Tone, vocabulary, brand voice.
- **Visual Direction** — `A-Product-Brief/visual-direction.md`. Aesthetic references, colour, typography intent.

### Research (Phase 2)
- **Trigger Map** — `B-Trigger-Map/00-trigger-map.md`. User psychology mapped to business goals. Required before UX Scenarios.
- **Business Goals** — `B-Trigger-Map/01-business-goals.md`. Measurable outcomes, KPIs.
- **Persona** — `B-Trigger-Map/NN-persona-[firstname]-the-[archetype].md`. Alliterative names required (e.g. Harriet the Hairdresser).
- **Feature Impact** — `B-Trigger-Map/feature-impact.md`. Feature × persona × trigger mapping.

### Design (Phases 3–4)
- **UX Scenarios** — `C-UX-Scenarios/00-ux-scenarios.md`. User journey flows derived from Trigger Map.
- **Page Spec** — `D-UX-Design/[page-name].md`. Per-page specification: layout, content, interactions, acceptance criteria.
- **Design Tokens** — Extracted progressively during Phase 4, not upfront.

### Development (Phase 5)
- **Tech Audit** — `E-Development/000-tech-audit.md`. Living architecture document. Required before any PRD on an existing codebase.
- **Master PRD** — `E-Development/000-PRD.md`. Platform requirements, written once, updated as project evolves.
- **Feature PRD** — `E-Development/NNN-[feature].xml`. One per Work Order.
- **Change Order** — `E-Development/NNN-NN-[slug].xml`. Feedback/change against a parent PRD.
- **Work Order** — `E-Development/WO-NNN-[slug].md`. Task written by Freya for Mimir. Contains: objective, scope, files, acceptance criteria.
- **Mimir Brief** — Narrative handoff document from Freya to Mimir when handing off design work.

### Progress (machine-local)
- **Design Log** — `_progress/00-design-log.md`. Project-wide progress, updated each session.
- **Project Outline** — `_progress/wds-project-outline.yaml`. Phase status, project metadata.
- **Session State** — `progress/[agent].md`. Agent-specific session state. Loaded by `/start`, written by `/wrap`.
- **Project Index** — `progress/project-index.md`. Living index of all artifacts, updated by `/wrap`.

---

## Patterns

- **Design Loop** — Freya's per-page cycle: discuss → spec → wireframe → approve → iterate → update spec → implement → browser review → extract tokens.
- **Dream Up Mode** — Three modes for artifact generation: Dialog (collaborative), Suggest (agent proposes), Dream (agent generates fully). Selected at session start.
- **Brownfield** — Project with an existing codebase. Triggers gap-map assessment before new work begins.
- **Greenfield** — Project with no existing codebase. Follows standard phase progression.
- **Gap Map** — Freya's cross-reference of what is designed vs what is built vs what has a Work Order.

---

## Model Selection

| Task type | Model |
|-----------|-------|
| Any code, build, deploy, implement | Opus |
| High-stakes / production / compliance | Opus |
| Long or complex multi-step tasks | Opus |
| Strategy, spec, dialog, UX, analysis | Sonnet |
| Simple, low-stakes, short | Haiku |

Default: lightest model that fits. Prefix Next actions with `MODEL:[Haiku|Sonnet|Opus]`.