Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-design

hyper-design

Verified

[Hyper] Use this skill when the user wants interface design work that must not look AI-generated - designing a new screen, page, or component, restyling an existing UI, building faux product UI for a hero, feature card, or demo, or auditing, cleaning, or verifying generic template patterns in an interface - driven by a written design direction, a numeric craft floor, static detection, and evidence-separated review, with briefs and reports saved under `.hyper/design/[slug]/`. Do not use it for backend or data work with no visual surface, accessibility-only or performance-only QA, brand strategy with no interface, or a reusable skill folder.

FileKindSize
SKILL.ko.mdmarkdown24.9 KB
SKILL.mdskill md22.7 KB
assets/design-brief-template.ko.mdmarkdown2.4 KB
assets/design-brief-template.mdmarkdown2.2 KB
assets/detector-config.schema.jsonconfig1.9 KB
assets/evals/contract-cases.jsonlother3.5 KB
assets/evals/detector-cases.jsonlother10.2 KB
assets/evals/hyper-design-cases.jsonlother23.3 KB
assets/fixtures/context/brand-gradient/DESIGN.ko.mdmarkdown170 B
assets/fixtures/context/brand-gradient/DESIGN.mdmarkdown164 B
assets/fixtures/context/brand-gradient/hero.htmlother181 B
assets/fixtures/context/pricing-comparison/pricing.htmlother467 B
assets/fixtures/context/real-status/status.htmlother112 B
assets/fixtures/context/reduced-motion-project/accessibility.cssother75 B
assets/fixtures/context/reduced-motion-project/animation.cssother117 B
assets/fixtures/detector-negative.htmlother352 B
assets/fixtures/detector-positive.htmlother401 B
assets/fixtures/rendered-evidence/dimension-mismatch.jsonconfig557 B
assets/fixtures/rendered-evidence/fresh.jsonconfig582 B
assets/fixtures/rendered-evidence/invalid.jsonconfig253 B
assets/fixtures/rendered-evidence/measurements.jsonconfig1.3 KB
assets/fixtures/rendered-evidence/no-measurements.jsonconfig367 B
assets/fixtures/rendered-evidence/signature-mismatch.jsonconfig557 B
assets/fixtures/rendered-evidence/stale.jsonconfig556 B
assets/fixtures/rendered-evidence/valid.jsonconfig515 B
assets/fixtures/rendered-evidence/window-frame.jsonconfig558 B
assets/fixtures/reports/all-ids-one-row.ko.mdmarkdown644 B
assets/fixtures/reports/all-ids-one-row.mdmarkdown651 B
assets/fixtures/reports/authorship-claim.ko.mdmarkdown417 B
assets/fixtures/reports/authorship-claim.mdmarkdown403 B
assets/fixtures/reports/empty-reason-evidence.ko.mdmarkdown1.4 KB
assets/fixtures/reports/empty-reason-evidence.mdmarkdown1.3 KB
assets/fixtures/reports/empty-section.ko.mdmarkdown354 B
assets/fixtures/reports/empty-section.mdmarkdown350 B
assets/fixtures/reports/invalid-static-claim.ko.mdmarkdown345 B
assets/fixtures/reports/invalid-static-claim.mdmarkdown341 B
assets/fixtures/reports/missing-wcag-table.ko.mdmarkdown411 B
assets/fixtures/reports/missing-wcag-table.mdmarkdown419 B
assets/fixtures/reports/passing-no-wcag-table.ko.mdmarkdown364 B
assets/fixtures/reports/passing-no-wcag-table.mdmarkdown360 B
assets/fixtures/reports/valid-v2.ko.mdmarkdown379 B
assets/fixtures/reports/valid-v2.mdmarkdown377 B
assets/fixtures/reports/valid-wcag-table.ko.mdmarkdown1.4 KB
assets/fixtures/reports/valid-wcag-table.mdmarkdown1.4 KB
assets/fixtures/reports/wcag-list-no-table.ko.mdmarkdown484 B
assets/fixtures/reports/wcag-list-no-table.mdmarkdown483 B
assets/fixtures/reports/wrong-criterion-id.ko.mdmarkdown1.4 KB
assets/fixtures/reports/wrong-criterion-id.mdmarkdown1.4 KB
assets/fixtures/rules/border-shadow.cssother100 B
assets/fixtures/rules/brand-monospace.htmlother182 B
assets/fixtures/rules/clickable-div.htmlother102 B
assets/fixtures/rules/dead-anchor.htmlother66 B
assets/fixtures/rules/declaration-rules-negative.cssother113 B
assets/fixtures/rules/declaration-rules.cssother91 B
assets/fixtures/rules/decorative-monospace.htmlother125 B
assets/fixtures/rules/decorative-pulse.cssother120 B
assets/fixtures/rules/detector-config-allow.jsonconfig155 B
assets/fixtures/rules/detector-config-invalid.jsonconfig63 B
assets/fixtures/rules/detector-config-motion-off.jsonconfig74 B
assets/fixtures/rules/detector-config-nonstring-allowlist.jsonconfig40 B
assets/fixtures/rules/detector-config-nonstring-rule-value.jsonconfig52 B
assets/fixtures/rules/detector-config-rules.jsonconfig85 B
assets/fixtures/rules/detector-config-unknown-rule.jsonconfig59 B
assets/fixtures/rules/em-dash.htmlother106 B
assets/fixtures/rules/generic-cta.htmlother171 B
assets/fixtures/rules/gradient-border-image-negative.cssother96 B
assets/fixtures/rules/gradient-border-image.cssother131 B
assets/fixtures/rules/grid-background.cssother151 B
assets/fixtures/rules/hard-stop-band-negative.cssother78 B
assets/fixtures/rules/hard-stop-band.cssother86 B
assets/fixtures/rules/identical-icon-cards.htmlother458 B
assets/fixtures/rules/ignore-slop.htmlother286 B
assets/fixtures/rules/inset-stripe-negative.cssother93 B
assets/fixtures/rules/inset-stripe.cssother84 B
assets/fixtures/rules/media-unsized.htmlother132 B
assets/fixtures/rules/motion-without-reduced-motion.cssother121 B
assets/fixtures/rules/naming-rules-negative.htmlother273 B
assets/fixtures/rules/naming-rules.htmlother291 B
assets/fixtures/rules/numbered-section-labels.htmlother275 B
assets/fixtures/rules/pseudo-stripe-negative.cssother209 B
assets/fixtures/rules/pseudo-stripe.cssother181 B
assets/fixtures/rules/radial-glow.cssother100 B
assets/fixtures/rules/repeated-eyebrows.htmlother292 B
assets/fixtures/rules/skipped-heading.htmlother113 B
assets/fixtures/rules/thin-side-stripe-negative.cssother73 B
assets/fixtures/rules/thin-side-stripe.cssother81 B
assets/fixtures/rules/viewport-height.cssother65 B
assets/fixtures/rules/zoom-blocked.htmlother206 B
assets/fixtures/unsupported.txtmarkdown57 B
assets/fixtures/waivers/invalid-global.jsonconfig197 B
assets/report-template.ko.mdmarkdown3.0 KB
assets/report-template.mdmarkdown3.0 KB
assets/waiver.example.jsonconfig280 B
assets/waiver.schema.jsonconfig871 B
references/accessible-interaction.ko.mdmarkdown8.8 KB
references/accessible-interaction.mdmarkdown7.6 KB
references/anti-pattern-catalog.ko.mdmarkdown17.0 KB
references/anti-pattern-catalog.mdmarkdown16.4 KB
references/browser-evidence-schema.ko.mdmarkdown3.2 KB
references/browser-evidence-schema.mdmarkdown2.9 KB
references/chart-artifact.ko.mdmarkdown3.7 KB
references/chart-artifact.mdmarkdown3.2 KB
references/context-signals.ko.mdmarkdown3.0 KB
references/context-signals.mdmarkdown2.8 KB
references/contrast-check.ko.mdmarkdown4.5 KB
references/contrast-check.mdmarkdown4.3 KB
references/eval-rubric.ko.mdmarkdown1.9 KB
references/eval-rubric.mdmarkdown1.8 KB
references/fix-playbook.ko.mdmarkdown5.4 KB
references/fix-playbook.mdmarkdown5.3 KB
references/korean-break-quality.ko.mdmarkdown4.0 KB
references/korean-break-quality.mdmarkdown3.4 KB
references/mockup-craft.ko.mdmarkdown7.4 KB
references/mockup-craft.mdmarkdown6.1 KB
references/native-platforms.ko.mdmarkdown6.8 KB
references/native-platforms.mdmarkdown5.9 KB
references/performance-baseline.ko.mdmarkdown4.2 KB
references/performance-baseline.mdmarkdown3.6 KB
references/print-paged.ko.mdmarkdown4.8 KB
references/print-paged.mdmarkdown4.4 KB
references/rendered-measurements.ko.mdmarkdown4.4 KB
references/rendered-measurements.mdmarkdown3.9 KB
references/replacement-patterns.ko.mdmarkdown2.6 KB
references/replacement-patterns.mdmarkdown2.5 KB
references/responsive-reflow.ko.mdmarkdown7.1 KB
references/responsive-reflow.mdmarkdown6.1 KB
references/screen-patterns.ko.mdmarkdown9.5 KB
references/screen-patterns.mdmarkdown8.1 KB
references/ui-copy.ko.mdmarkdown5.1 KB
references/ui-copy.mdmarkdown4.7 KB
rules/craft-floor.ko.mdmarkdown18.6 KB
rules/craft-floor.mdmarkdown16.2 KB
rules/delivery-gate.ko.mdmarkdown10.5 KB
rules/delivery-gate.mdmarkdown9.4 KB
rules/design-direction.ko.mdmarkdown11.9 KB
rules/design-direction.mdmarkdown10.2 KB
rules/evidence-and-severity.ko.mdmarkdown3.2 KB
rules/evidence-and-severity.mdmarkdown3.2 KB
rules/independent-review.ko.mdmarkdown9.1 KB
rules/independent-review.mdmarkdown8.1 KB
rules/rendered-evidence.ko.mdmarkdown6.3 KB
rules/rendered-evidence.mdmarkdown5.7 KB
rules/safe-editing.ko.mdmarkdown2.9 KB
rules/safe-editing.mdmarkdown2.8 KB
rules/slop-taxonomy.ko.mdmarkdown6.4 KB
rules/slop-taxonomy.mdmarkdown5.9 KB
rules/validation-and-reporting.ko.mdmarkdown6.0 KB
rules/validation-and-reporting.mdmarkdown5.5 KB
rules/waivers-and-baselines.ko.mdmarkdown5.1 KB
rules/waivers-and-baselines.mdmarkdown4.6 KB
rules/workflow.ko.mdmarkdown8.4 KB
rules/workflow.mdmarkdown7.5 KB
scripts/analyze-structure.shexecutablescript3.6 KB
scripts/collect-rendered-evidence.shexecutablescript16.9 KB
scripts/detect-slop.shexecutablescript21.2 KB
scripts/engine-css.shexecutablescript517 B
scripts/engine-markup.shexecutablescript3.7 KB
scripts/engine-text.shexecutablescript563 B
scripts/resolve-context.shexecutablescript3.5 KB
scripts/rule-registry.shexecutablescript15.4 KB
scripts/rule-shared.shexecutablescript20.3 KB
scripts/run-contract-evals.shexecutablescript5.7 KB
scripts/run-detector-evals.shexecutablescript6.9 KB
scripts/validate-report.shexecutablescript12.2 KB
scripts/validate-waivers.shexecutablescript4.5 KB

rules/validation-and-reporting.ko.md

View on GitHub
# 검증과 보고

report를 쓰기 전에 읽는다. 이 파일은 검증 순서, report 구성, 각 주장이 인용해야 할 근거를 소유한다.

## 검증 순서

1. 같은 대상에 `scripts/detect-slop.sh`를 다시 실행하고 rule ID, severity count, engine과 evidence field, 사용한 baseline delta를 비교한다. 실행 전과 후의 JSON을 `.hyper/design/<slug>/` 아래에 저장한다.
2. 변경한 화면마다 정석 수치 체크리스트(`rules/craft-floor.md` §9)를 실행한다.
3. 변경 파일을 포함하는 가장 작은 project build, typecheck, lint, test 명령을 실행한다. 실패를 억제하지 말고 살펴본다.
4. 렌더링이 가능하면 확인 대상 폭과 화면이 드러내는 상태를 살펴본다. 그렇지 않으면 렌더링이 필요한 항목을 `static_only` 또는 `unavailable`로 표시한다.
5. 변경이 영향을 주는 keyboard focus, semantics, 측정 가능한 contrast, reduced motion, responsive overflow를 확인한다.
6. 직접 영향받은 동작을 실행하고 copy, route, form contract, state transition, analytics hook을 보존한다.
7. 독립 검토(`rules/independent-review.md`)를 실행하고 그 발견 사항에 답한다.
8. 저장한 리포트를 `scripts/validate-report.sh --report .hyper/design/<slug>/report.md`로 검증하고 residual risk를 기록한다.

## Claim 규칙

- detector 또는 동등한 정적 검사를 실제로 실행하지 않았다면 “문제 없음”으로 보고하지 않는다.
- 렌더링 검사 없이 visual pass를 보고하지 않는다.
- screenshot 또는 CSS source만으로 accessibility pass를 보고하지 않는다.
- context-dependent·review-only heuristic을 확정 결함으로 바꾸지 않는다.
- `generic-output risk`를 AI 저작 결과라고 부르지 않는다.
- candidate exception 또는 baseline을 suppression이나 remediation pass로 취급하지 않는다.
- product metric, brand claim, testimonial, user, source provenance를 발명하지 않는다.
- 실행하지 않은 검사는 모두 불가능하거나 범위 밖인 이유와 함께 기록한다.

## 필수 리포트 section

`brief-only`를 뺀 모든 모드에서 `assets/report-template.ko.md`를 기본으로 쓴다. 리포트 제목은 validator가 고정하며 모든 모드에서 같게 읽힌다. validator가 결과를 확인할 수 있도록 다음 heading을 유지한다.

- `# AI Design Slop 정리 결과`
- `## 처리 요약`
- `## Brief inference`
- `## 발견 사항`
- `## 적용한 변경`
- `## 검증`
- `## 남은 위험`

요약에는 mode, `brief.md` 경로 또는 `해당 없음`, detector version과 engine, generic-output risk, baseline delta, 이유가 있는 candidate 또는 persisted waiver, `complete | static_only | unavailable` rendered-evidence 상태, 정석 수치 결과, 검토 모드(`subagent | self (degraded) | user | 미실행`)도 기록한다.

`audit`은 변경을 적용하지 않았다고 쓸 수 있다. `verify`는 확인한 변경 또는 finding set을 식별해야 한다. `design`, `restyle`, `mockup`은 만들거나 바꾼 token과 파일을 나열한다. 빈 section은 허용하지 않으며 이유와 함께 `없음` 또는 `미검증`을 쓴다.

### WCAG 표

렌더링 검증이 `complete`이고 최종 상태가 `pass`인 보고서와, WCAG 제목을 단 보고서는 모두 `assets/report-template.md`(`## Processing summary` 사본)의 WCAG 2.2 표를 함께 넣는다. 표에는 나열된 성공 기준마다 한 행이 있고(1.4.3, 1.4.11, 2.4.7, 2.4.11, 2.5.8, 2.1.1, 2.1.2, 1.4.10, 1.4.12, 2.5.7, 3.3.8, 3.2.6, 3.3.7), 각 행은 이유와 사용한 브라우저 증거를 갖춘 `PASS`, `FAIL`, `N/A` 중 하나다. 브라우저 증거 없는 `PASS`는 통과가 아니다. 보고서 validator는 구조적으로 강제한다. 최종 상태가 `pass`이고 렌더링 검증이 `complete`인 보고서는 전체 13행 표를 필수로 달아야 하며, WCAG 제목을 단 보고서도 마찬가지다. 각 기준은 판정(`PASS`, `FAIL`, `N/A`), 이유, 증거를 갖춘 파이프 표 행으로 나타나야 한다. 행은 셀로 나누어 검사한다: 기준 셀은 SC id를 정확히 하나만 담고(토큰 대조이므로 `1.4.30`은 `1.4.3`이 아니다), 판정 셀은 정확히 `PASS`, `FAIL`, `N/A` 중 하나이며(백틱 허용, 대소문자 무시), 이유와 증거 셀은 모두 빠져 있지 않아야 한다. 한 행에 SC id를 둘 이상 담으면 그 행은 두 기준 모두에 대해 완성 행이 아니다. 셀 구조가 틀어진 행은 `WCAG_ROW_INCOMPLETE`로, 행이 없으면 `WCAG_TABLE_MISSING`으로 거부한다. 기준 번호만 목록으로 나열하고 표 행이 없으면 `WCAG_TABLE_MISSING`으로 거부한다. 둘 다 하지 않는 보고서(표제 없음과 `pass` + `static_only`)는 표 없이도 통과하므로 기존 유효 픽스처는 그대로 유효하다.

## 완료 결정

- `pass`: 모든 해당 critical guard가 통과하고 사용자 결정이 남지 않음.
- `review_required`: 안전한 작업은 끝났지만 context-dependent·review-only 결정이 남음.
- `blocked`: 필수 evidence, authority, capability 또는 critical guard가 없음.

한계가 명시되고 숨은 critical 실패를 pass처럼 제시하지 않을 때만 caveat가 있는 결과가 유효하다.

## Sources

> 확인 2026-11-09.

검증 순서, claim 규칙, report section은 이 패키지 자체 것이다. 필수 한국어 heading은 이 패키지의 report template과 report validator에 맞춘다.

| 주장 | 출처 |
|---|---|
| 기준별 WCAG 2.2 표의 형태와 브라우저 증거 필요성 | `dbc-hbin/omp-ulw @ 74df40f` (2026-11-09)에서 이 패키지의 자체 말로 재작성했다. 원본 저장소에는 라이선스가 없으며 텍스트나 코드를 복사하지 않았다 |
| 13개 성공 기준과 통과 조건 | <https://www.w3.org/TR/2024/REC-WCAG22-20241212/> |

### Evidence grade

기준별 표는 이 패키지의 계약이다. 각 기준의 통과 규칙은 위 WCAG 2.2를 따른다. `PASS`는 해당 행에 기록한 브라우저 증거만큼만 강하다.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall