From ef83ae30b05bf34b854b6a38252b4e08da527c82 Mon Sep 17 00:00:00 2001 From: Stephan D Date: Sat, 12 Sep 2026 08:44:00 +0200 Subject: [PATCH 1/4] Consolidate repository skills under .agents/skills --- {skills => .agents/skills}/ux-design/SKILL.md | 0 {skills => .agents/skills}/ux-observability/SKILL.md | 0 AGENTS.md | 4 ++-- docs/implementation.md | 11 ++++++++++- 4 files changed, 12 insertions(+), 3 deletions(-) rename {skills => .agents/skills}/ux-design/SKILL.md (100%) rename {skills => .agents/skills}/ux-observability/SKILL.md (100%) diff --git a/skills/ux-design/SKILL.md b/.agents/skills/ux-design/SKILL.md similarity index 100% rename from skills/ux-design/SKILL.md rename to .agents/skills/ux-design/SKILL.md 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 cc7ca83..29f8b62 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. @@ -122,3 +122,12 @@ Delivery: [PR #13](https://git.sendico.io/tech/sxchnge/pulls/13), `onboarding-12 Implementation commit `f1cbf64`; 68 tests and affected-package analysis/formatting 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. From 44f1236e52ef2415eaed8816b3fcd248daa982c1 Mon Sep 17 00:00:00 2001 From: Stephan D Date: Sat, 12 Sep 2026 08:44:30 +0200 Subject: [PATCH 2/4] Record skill consolidation PR --- docs/implementation.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/implementation.md b/docs/implementation.md index 29f8b62..9be8a31 100644 --- a/docs/implementation.md +++ b/docs/implementation.md @@ -131,3 +131,5 @@ 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`. From 82cb8bfaf910551dfcf5906a9e315973466b3a4c Mon Sep 17 00:00:00 2001 From: Stephan D Date: Sat, 12 Sep 2026 11:28:26 +0200 Subject: [PATCH 3/4] Prefer simplicity in UX design guidance --- skills/ux-design/SKILL.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/skills/ux-design/SKILL.md b/skills/ux-design/SKILL.md index 9a72d17..1645605 100644 --- a/skills/ux-design/SKILL.md +++ b/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? From d35f8ced799122bde6e825dd4dddf211d982349c Mon Sep 17 00:00:00 2001 From: Stephan D Date: Sat, 12 Sep 2026 11:29:05 +0200 Subject: [PATCH 4/4] Record UX simplicity guidance delivery --- docs/implementation.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/implementation.md b/docs/implementation.md index ed6b82f..5b5f561 100644 --- a/docs/implementation.md +++ b/docs/implementation.md @@ -141,3 +141,14 @@ current packages, app/website commands, verification previews, analytics limits, skill location and contribution workflow. Local links and diff checks pass; commands and prerequisites were checked against repository configuration. Documentation only; no runtime tests were run. + +## 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.