Skip to content

docs: add impeccable design context (PRODUCT.md, DESIGN.md)#874

Open
ibrahimozkn wants to merge 1 commit into
devfrom
docs/impeccable-design-context
Open

docs: add impeccable design context (PRODUCT.md, DESIGN.md)#874
ibrahimozkn wants to merge 1 commit into
devfrom
docs/impeccable-design-context

Conversation

@ibrahimozkn

@ibrahimozkn ibrahimozkn commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Description

Adds AI-agent design context for the StudyU platform using the impeccable skill. This enables future /impeccable commands (critique, audit, polish, colorize, etc.) to stay on-brand without re-deriving the visual system from scratch each session.

Files added:

  • PRODUCT.md — strategic context: register (product), dual-audience (researcher Designer + participant App), brand personality (precise, credible, empowering), anti-references (fitness/wellness apps, tech-startup SaaS, health advocacy campaigns), five design principles, WCAG 2.1 AA accessibility target
  • DESIGN.md — visual system spec: Creative North Star "The Clinical Protocol", Material 3 / Research Teal-Blue primary, Protocol Orange CTA accent (≤10% coverage rule), flat-card elevation strategy, 14px type floor, named rules and do's/don'ts aligned to PRODUCT.md anti-references
  • .impeccable/design.json — sidecar with 8-step tonal ramps per color, shadow/motion/breakpoint tokens, 8 self-contained component HTML+CSS snippets for the impeccable live panel
  • .impeccable/live/config.json — live mode configured for app/web/index.html and designer_v2/web/index.html; notes Flutter canvas constraint

Visuals

No visual changes — documentation and tooling config only.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jul 9, 2026
- PRODUCT.md: captures register (product), dual-audience (researcher Designer
  + participant App), brand personality (precise, credible, empowering),
  anti-references, five design principles, and WCAG 2.1 AA accessibility target
- DESIGN.md: documents visual system — Creative North Star 'The Clinical
  Protocol', Material 3 / Research Teal-Blue primary, Protocol Orange CTA
  accent, flat-card elevation strategy, 14px type floor, named rules and
  do's/don'ts aligned to PRODUCT.md anti-references
- .impeccable/design.json: sidecar with tonal ramps, shadow/motion tokens,
  8 self-contained component HTML+CSS snippets for the live panel
- .impeccable/live/config.json: live mode configured for app/web and
  designer_v2/web entry points; notes Flutter canvas constraint
- AGENTS.md: disallow Co-Authored-By trailers in commit messages
@ibrahimozkn ibrahimozkn force-pushed the docs/impeccable-design-context branch from 38d7e66 to b58057e Compare July 9, 2026 13:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant