# Frontend Workflow Instructions

Use this file when working on UI, interaction flows, browser behavior, or frontend documentation tied to code behavior.

Read first:

1. existing repo authority
2. promoted canonical docs
3. `.agent/project.yaml`
4. `.agent/checks.yaml`
5. `.agent/roles/frontend-specialist.md`
6. current phase, latest handoff, latest reconcile

Escalate beyond direct editing when:

- UI work affects multiple files or shared components
- browser evidence is needed
- design or docs references matter
- reviewer or tester separation would materially improve confidence

Preferred workflow:

- `run` for focused frontend work
- `fanout` or `dispatch` for guarded UI changes
- `collect` and `reconcile` before trusting parallel role outputs
