Resolve KYC documentation against current main

This commit is contained in:
Stephan D committed 2026-09-12 12:11:50 +02:00
commit 6ea2d22e8e
4 files changed
+29 -3

No files matched your search

@@ -10,6 +10,10 @@ before reporting it complete. Rendering correctly is only one part of completion
## Establish the flow ## 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 - Identify the user's primary task, successful outcome, and shortest appropriate
path to that outcome before choosing layouts or controls. path to that outcome before choosing layouts or controls.
- Inspect comparable product flows, components, navigation, terminology, and - 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 - [ ] Are interactive elements recognizable, and can the user tell what is
happening and what will happen next? happening and what will happen next?
- [ ] Are steps appropriate, with unnecessary interaction and cognitive load removed? - [ ] 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, - [ ] Does the flow follow existing product patterns and consistent terminology,
with a concrete reason for any departure? with a concrete reason for any departure?
- [ ] Can users recover from errors, with input and context preserved where appropriate? - [ ] Can users recover from errors, with input and context preserved where appropriate?
File renamed without changes.
+2 -2
View File
@@ -11,8 +11,8 @@
## UX ## UX
For any user-facing interface work, follow the For any user-facing interface work, follow the
[UX Design](skills/ux-design/SKILL.md) and [UX Design](.agents/skills/ux-design/SKILL.md) and
[UX Observability](skills/ux-observability/SKILL.md) skills. [UX Observability](.agents/skills/ux-observability/SKILL.md) skills.
UX is not considered complete unless the interface is both usable and measurable. 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. Before considering UI work complete, apply the UX Review checklist from these skills.
+21 -1
View File
@@ -4,7 +4,7 @@
[Task #10](https://git.sendico.io/tech/sxchnge/issues/10), branch `skills-10`, [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`, 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 UX Design covers usable interfaces and its design review; UX Observability covers
purposeful journey measurement and its observability review. Both preserve product purposeful journey measurement and its observability review. Both preserve product
conventions and avoid prescribing frameworks, vendors, or visual styles. 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 plus web build passed. Final browser verification confirms accessible recipient
text and keyboard recovery. No merge or actual PostHog collection was performed. 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 ## Editor configuration cleanup
Task [#14](https://git.sendico.io/tech/sxchnge/issues/14) removes the root VS Code 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 server-side review analytics remain integration work. Native mobile and
VoiceOver/TalkBack checks remain release QA. Security scans were not requested. 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. - 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.