Contrato de Ativação
Use para projetar, revisar ou refinar uma interface de terminal (painéis, trilhos, barras de status, cartões, prompts), especialmente o Gentle Shell. A sensação alvo é um IDE dentro de um terminal: denso, calmo, focado no desenvolvedor, nunca um disfarce de cromado retrô de TUI. Não para páginas web (use gentle-design).
Regras Rígidas
- Nunca julgue uma interface de terminal a partir de código ou memória: capture-a (
references/visual-loop.md) e veja o PNG antes e depois de cada alteração. - Leia
references/terminal-craft.mdantes de qualquer edição de UI; é o piso, não uma sugestão. - Modo de operação: familiaridade vence expressão. Use vocabulário de IDE (painéis, árvore, abas, barra de status, paleta de comandos); a marca reside na paleta, densidade e um movimento característico.
- Cada linha custa. Hierarquia vem de função de cor, peso e alinhamento, nunca de linhas em branco ou caixas aninhadas.
- Diga cada fato uma vez por tela. Dados mostrados no cabeçalho nunca se repetem em um painel.
- Um comando, um alvo. Refinamento preserva o sistema; redesenho o substitui. Nunca polir um visual que será descartado.
- Renderização deve ser barata: sem E/S ou recomputação em caminhos de renderização, cache chaveado em tudo que altera a saída (estilo, largura, tema).
- Mockups (via
gentle-design) devem ser expressáveis em terminal: grade de células monoespaçadas em unidadesch, apenas cores fg/bg, negrito/dim/itálico/sublinhado/riscado, desenho de caixas e glifos.
Portões de Decisão
| Pergunta | Comando | Carregar |
|---|---|---|
| Nenhum contexto de produto/design ainda | document | references/design-doc.md |
| Nova superfície ou redesign | shape, depois mockups, depois implementar | references/commands.md |
| "Como está a aparência / o que está errado" | critique | references/critique.md |
| Muito cheio, espaço desperdiçado, redundante | distill / layout / quieter | references/commands.md |
| Plano, sem hierarquia, ilegível | typeset / colorize / bolder | references/commands.md |
| Casos extremos, terminais estreitos, texto longo | harden / adapt | references/commands.md |
| Passagem final antes do commit | polish | references/commands.md |
Etapas de Execução
- Carregue o contexto de
DESIGN.mdse o projeto tiver um; caso contrário, proponhadocumentprimeiro. - Capture o estado atual com o loop visual nos tamanhos fornecidos (180x50 largo, 140 ponto de quebra, 80x24 estreito).
- Execute o comando escolhido contra um alvo nomeado; escreva as descobertas antes de alterar o código.
- Altere, recapture, compare com o PNG anterior e o briefing; itere no máximo 3 rodadas, depois relate.
- Termine cada comando de refinamento com as verificações
polishe os testes focados do repositório (contagens de renderização, overflow).
Contrato de Saída
Retorne: alvo, comando executado, caminhos dos PNGs antes/depois, descobertas corrigidas com tags P0-P3, descobertas deixadas em aberto e verificações realizadas.
Referências
references/terminal-craft.md: regras básicas e anti-padrões de terminal.references/commands.md: playbooks de comandos adaptados para terminais.references/critique.md: rubrica de crítica e severidade com pontuação.references/design-doc.md: formato de DESIGN.md para um produto de terminal.references/visual-loop.md: harness de captura de tela e loop de comparação.NOTICE.md: atribuição.