UX/UI Bug Intake
Use this skill for a lightweight docs-backed UX/UI bug register that complements project docs without becoming a heavyweight issue tracker.
First Checks
- Locate
DOCS/. - Look for
DOCS/ux-ui-bugs/. - Read
AGENTS.mdand the active project doc when present.
If DOCS/ is missing, offer $context-layer-scaffold.
Setup
Preferred folder:
DOCS/ux-ui-bugs/README.mdDOCS/ux-ui-bugs/INBOX.mdDOCS/ux-ui-bugs/TRIAGED.mdDOCS/ux-ui-bugs/ARCHIVE.md
Use lowercase folder naming to match Context Layer conventions. Keep the register lightweight and do not create one file per bug.
Operating Model
- Users, main agents, and subagents may detect bugs.
- The main agent is the canonical logger/router.
- Subagents report concise bug candidates; the main agent de-duplicates and records canonical entries.
Entry Fields
IDReportedDetected byActorSurfaceSummarySeverityStatusLikely ownerRelated projectEvidence pathSuperseded by migration?Notes
Statuses
newtriagedscheduledin active slicefixedwont-fixsuperseded
Severities
blockerhighmediumlow
Evidence
The bug register is an operating workflow, not the evidence store. Screenshots, recordings, audits, or reproduction packets should live under:
DOCS/evidence/active/<project-id>/ux-ui-bugs/<bug-id>/
Link evidence paths from the bug entry and the owning project doc when the bug affects project state or sign-off.