diff --git a/skills/ux-design/SKILL.md b/.agents/skills/ux-design/SKILL.md similarity index 93% rename from skills/ux-design/SKILL.md rename to .agents/skills/ux-design/SKILL.md index 9a72d17..1645605 100644 --- a/skills/ux-design/SKILL.md +++ b/.agents/skills/ux-design/SKILL.md @@ -10,6 +10,10 @@ before reporting it complete. Rendering correctly is only one part of completion ## Establish the flow +- Prefer the simplest interface that lets users complete their task confidently. + When options meet the same need, choose fewer concepts, choices, and controls. + Add complexity only for a concrete user need; preserve essential information, + accessibility, and recovery rather than hiding them to make a screen look minimal. - Identify the user's primary task, successful outcome, and shortest appropriate path to that outcome before choosing layouts or controls. - Inspect comparable product flows, components, navigation, terminology, and @@ -95,6 +99,8 @@ performed and any gaps; do not mark applicable unmet criteria as complete. - [ ] Are interactive elements recognizable, and can the user tell what is happening and what will happen next? - [ ] Are steps appropriate, with unnecessary interaction and cognitive load removed? +- [ ] Is this the simplest usable solution, with each added concept, choice, or + control serving a concrete user need? - [ ] Does the flow follow existing product patterns and consistent terminology, with a concrete reason for any departure? - [ ] Can users recover from errors, with input and context preserved where appropriate? diff --git a/skills/ux-observability/SKILL.md b/.agents/skills/ux-observability/SKILL.md similarity index 100% rename from skills/ux-observability/SKILL.md rename to .agents/skills/ux-observability/SKILL.md diff --git a/AGENTS.md b/AGENTS.md index c1ed5ea..ef29797 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,8 +11,8 @@ ## UX For any user-facing interface work, follow the -[UX Design](skills/ux-design/SKILL.md) and -[UX Observability](skills/ux-observability/SKILL.md) skills. +[UX Design](.agents/skills/ux-design/SKILL.md) and +[UX Observability](.agents/skills/ux-observability/SKILL.md) skills. UX is not considered complete unless the interface is both usable and measurable. Before considering UI work complete, apply the UX Review checklist from these skills. diff --git a/docs/implementation.md b/docs/implementation.md index 4743504..bc4c304 100644 --- a/docs/implementation.md +++ b/docs/implementation.md @@ -4,7 +4,7 @@ [Task #10](https://git.sendico.io/tech/sxchnge/issues/10), branch `skills-10`, delivered in [PR #11](https://git.sendico.io/tech/sxchnge/pulls/11) into `main`, -adds a concise root UX policy linking two independent skills in `skills/`: +adds a concise root UX policy linking two independent skills, now consolidated under `.agents/skills/`: UX Design covers usable interfaces and its design review; UX Observability covers purposeful journey measurement and its observability review. Both preserve product conventions and avoid prescribing frameworks, vendors, or visual styles. @@ -123,6 +123,16 @@ Implementation commit `f1cbf64`; 68 tests and affected-package analysis/formatti plus web build passed. Final browser verification confirms accessible recipient text and keyboard recovery. No merge or actual PostHog collection was performed. +## Consolidated skill location + +Task [#16](https://git.sendico.io/tech/sxchnge/issues/16) consolidates all four +repository skills under `.agents/skills/`. UX Design and UX Observability moved +without content changes; root policy links and this record now use that location. +The old root `skills/` directory is removed. Validation compares moved content +byte-for-byte, checks all four skill paths and updated UX links, and runs +`git diff --check`. No runtime tests are needed for this move. + +Delivery: [PR #17](https://git.sendico.io/tech/sxchnge/pulls/17), branch `skills-16`. ## Editor configuration cleanup Task [#14](https://git.sendico.io/tech/sxchnge/issues/14) removes the root VS Code @@ -168,3 +178,13 @@ Documentation only; no runtime tests were run. server-side review analytics remain integration work. Native mobile and VoiceOver/TalkBack checks remain release QA. Security scans were not requested. - Delivery: [PR #21](https://git.sendico.io/tech/sxchnge/pulls/21), pushed on `kyc-20`; not merged. Final browser review also preserved heading semantics when moving keyboard focus. +## UX simplicity preference + +Task [#26](https://git.sendico.io/tech/sxchnge/issues/26), delivered in +[PR #27](https://git.sendico.io/tech/sxchnge/pulls/27) on `skills-26`, makes +simplicity an explicit preference in the UX Design skill and its review checklist. +Prefer fewer concepts, choices, and controls when they serve the same need; retain +essential information, accessibility, and recovery. Documentation only. +Validation: skill-creator `quick_validate.py` passed in an isolated environment +with PyYAML (the system Python lacked it); `git diff --check` passed. No runtime +tests were needed. The PR is not merged.