agentleFS
edilsonvilarinhoedilsonvilarinho/usage-monitor/.claude/skills/usage-monitor-design/SKILL.md

usage-monitor-design

Skill19 starsChanged 50 days agoMITView on GitHub

Apply the Usage Monitor design system (tokens, primitive contracts, precedence over the prototype, UI kit) when drawing, changing, or auditing any visible surface — Compose screens, dialogs, tray, PDF report — or building a visual prototype for this project.

The file

Files
SKILL.md

Usage Monitor — design system

A fonte de verdade visual deste repositório é docs/design-system/. Ela é normativa: divergência entre o Compose e o design system é defeito do Compose. A tabela completa de precedência está em CLAUDE.md, seção Sistema visual → Design system — precedência.

Antes de desenhar qualquer coisa

  1. Ler docs/design-system/readme.md inteiro. Ele carrega os fundamentos de conteúdo (voz, casing, "todo estado carrega uma palavra", "controle desabilitado sempre diz por quê") e as fundações visuais.
  2. Ler os tokens em docs/design-system/tokens/. Eles já têm equivalente exato em Kotlin — AppSpacing, AppShapes, AppElevation, AppMotion, AppThemePreset.OBSIDIANA_DARK/PORCELANA_LIGHT e AppAccents em src/commonMain/kotlin/com/usagemonitor/presentation/ui/theme/. Não introduza um valor novo: se falta um degrau, a decisão vai para o design system antes de ir para o código.
  3. Ler o contrato da primitiva que você vai usar em docs/design-system/components/. Cada *.prompt.md diz o que a primitiva resolve e o que é proibido dentro dela.
  4. Abrir o mockup da tela no protótipo aprovado, docs/planos/prototipo-visual-opencode.html, e o kit correspondente em docs/design-system/ui_kits/desktop-app/.

Regras que não se negociam

  • Nenhuma tela reimplementa uma primitiva. Antes de escrever Surface, Card, Modifier.border, .background com cor de superfície ou RoundedCornerShape, procure em presentation/ui/components/AppStructure.kt, AppControls.kt, AppStates.kt e nos vizinhos AppTabs.kt, AppSettingsNav.kt, AppSurfaceDepth.kt, AppChips.kt, AppMenu.kt, AppTooltip.kt e AppStatusPill.kt.
  • Primitiva construída e não adotada não conserta nada. O commit que cria e o que consome são o mesmo.
  • Cor de acento vem de AppAccents.current e AppTone, nunca de darkAppAccents / lightAppAccents diretamente — val de topo de arquivo não lê o tema em vigor.
  • Cor nunca informa sozinha. Todo estado carrega ponto e palavra (AppStatusIndicator).
  • Animação infinita só atrás de AppMotionPolicy.continuous. Fora dela, trava o waitForIdle dos testes de componente. Carregamento é esqueleto estático, sem shimmer e sem spinner.
  • Sem emoji. Os ícones são marcas Unicode em IBM Plex Mono, e a lista está no readme.md.
  • Escala tipográfica fechada em 10/12/14/16/20/28; raio com teto de 10dp; elevação 8 só para janela, diálogo, menu e overlay.

Ao terminar

Registrar a mudança no mesmo commit, nos dois documentos:

  • No protótipo: tela nova ou estado que ainda não existe ganha seção <h2 id="…">N · …</h2> própria mais o link em nav.index; controle, coluna ou texto novo dentro de tela já desenhada vira linha no mockup dela; risco conhecido e decisão pendente vão para §15 #checklist.
  • No design system: primitiva nova ou contrato alterado vira components/<grupo>/<Nome>.prompt.md mais a entrada no índice do readme.md; tela que tem kit em ui_kits/desktop-app/ tem o .jsx correspondente atualizado.

Verificar com gradlew.bat desktopTest --tests "com.usagemonitor.ui.*" e, para comparação visual, gradlew.bat generateScreenshots.

Para mocks e protótipos descartáveis

Copie docs/design-system/styles.css, tokens/ e assets/ para junto do HTML e monte a página com as primitivas de components/. _ds_local.js monta os componentes sem o bundle compilado.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.