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.
In this repository13 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- orchestrateSkill
- usage-monitor-commit-pushSkill
- usage-monitor-nsis-installerSkill
- usage-monitor-release-betaSkill
- usage-monitor-releaseSkill
- usage-monitor-release-videoSkill
- usage-monitor-social-videoSkill
- usage-monitor-test-reportSkill
- usage-monitor-token-cleanupSkill
- usage-monitor-visual-optionsSkill
- usage-monitor-workflowSkill
The file
Files
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
- Ler
docs/design-system/readme.mdinteiro. 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. - Ler os tokens em
docs/design-system/tokens/. Eles já têm equivalente exato em Kotlin —AppSpacing,AppShapes,AppElevation,AppMotion,AppThemePreset.OBSIDIANA_DARK/PORCELANA_LIGHTeAppAccentsemsrc/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. - Ler o contrato da primitiva que você vai usar em
docs/design-system/components/. Cada*.prompt.mddiz o que a primitiva resolve e o que é proibido dentro dela. - Abrir o mockup da tela no protótipo aprovado,
docs/planos/prototipo-visual-opencode.html, e o kit correspondente emdocs/design-system/ui_kits/desktop-app/.
Regras que não se negociam
- Nenhuma tela reimplementa uma primitiva. Antes de escrever
Surface,Card,Modifier.border,.backgroundcom cor de superfície ouRoundedCornerShape, procure empresentation/ui/components/AppStructure.kt,AppControls.kt,AppStates.kte nos vizinhosAppTabs.kt,AppSettingsNav.kt,AppSurfaceDepth.kt,AppChips.kt,AppMenu.kt,AppTooltip.kteAppStatusPill.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.currenteAppTone, nunca dedarkAppAccents/lightAppAccentsdiretamente —valde 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 owaitForIdledos 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 emnav.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.mdmais a entrada no índice doreadme.md; tela que tem kit emui_kits/desktop-app/tem o.jsxcorrespondente 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.
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
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.

