/impeccable teach
Teach
Ensine ao Impeccable para quem é seu produto, uma vez por projeto.
Um PRODUCT.md finalizado. Apenas estratégia: quem, o quê, por quê. Sem cores, sem fontes, sem valores em pixels, esses ficam no DESIGN.md.
Quando usar
Execute /impeccable teach uma vez no início de um projeto. É a rampa de entrada. Sem ele, todos os outros comandos produzirão design tecnicamente competente, mas genericamente tonalizado: voz SaaS padrão, fontes de safe-default, a paleta de cores da IA. Com ele, cada comando lê suas respostas antes de gerar.
Use quando:
- Você acabou de instalar o Impeccable em um novo projeto. Primeira coisa a executar. Outros comandos vão sugerir se você pular.
- A direção de marca do projeto mudou. Novo posicionamento, novo público, nova voz. Re-execute
teache o contexto atualizado flui por todos os comandos. - Outro comando disse “nenhum contexto de design encontrado” e parou. Esse é o sinal: execute teach, depois continue.
Como funciona
Teach escreve dois arquivos complementares na raiz do projeto:
PRODUCT.mdé o arquivo estratégico. Registro (brand ou product), usuários-alvo, propósito do produto, personalidade da marca, anti-referências, princípios de design, necessidades de acessibilidade. Responde “quem, o quê, por quê”.DESIGN.mdé o arquivo visual. Cores, tipografia, elevação, componentes, práticas recomendadas e o que evitar. Responde “como fica”. Escrito pelo comando/impeccable documentdelegado, que teach invoca no final.
O fluxo escaneia o codebase primeiro (README, package.json, componentes, tokens, assets de marca) e forma uma hipótese de registro: brand (landing, marketing, portfólio, onde o design É o produto) ou product (UI de app, dashboards, ferramentas, onde o design SERVE ao produto). Registro é a primeira pergunta, porque molda todas as respostas subsequentes: padrões de tipografia, energia de movimento, estratégia de cor, o conjunto de referências que comandos como /impeccable typeset carregam. Após o registro, teach pergunta apenas o que não pôde inferir: usuários, personalidade em três palavras reais, referências e anti-referências, requisitos de acessibilidade.
PRODUCT.md é apenas estratégico. Sem cores, sem fontes, sem valores em pixels. Esses ficam no DESIGN.md. Manter os dois arquivos separados é deliberado: a estratégia pode permanecer estável enquanto o sistema visual evolui.
Experimente
/impeccable teachEspere uma entrevista de 5 a 8 minutos. A primeira pergunta geralmente é sobre registro; o resto é curto. Teach vai citar de volta o que inferiu do seu código (“pelas rotas, isso parece uma superfície de produto, correto?”) para que você esteja confirmando, não começando do zero.
No final, teach oferece executar /impeccable document para você. Diga sim a menos que tenha um motivo específico para esperar. Um DESIGN.md real é o que mantém variantes, polimentos e audits alinhados à marca.
Armadilhas
- Pular para “apenas testar um comando rapidamente”. Todos os outros comandos farão a entrevista durante a execução. Executar teach primeiro é mais rápido, não mais lento.
- Dar respostas genéricas. “Moderno e limpo” não é útil. “Quente, mecânico, opinionado” é. Seja específico. Esteja disposto a discordar dos padrões seguros.
- Tratar PRODUCT.md como imutável. O arquivo é seu. Se teach colocou algo que não está totalmente certo, edite. Cada comando lê o arquivo atual.
- Listar apenas adjetivos para referências. Marcas, produtos, objetos impressos: nomeados, não descritos. “Páginas de espécime do Klim Type Foundry”, não “técnico e limpo”. Anti-referências devem ser igualmente específicas.