@etus/seven-skill

Build/runtime interno das skills de UI do Seven, agentes auxiliares, detector determinístico e Seven UI Guardian. Projetos consumidores devem instalar @etus/seven, cujo único binário seven instala estes artefatos junto com policy, contexto, hooks e enforcement local.

@etus/seven-skill não expõe um segundo binário seven.

O que é publicado

• Skills nativas para Claude Code e Codex/Agent Skills — os dois harnesses suportados pela distribuição Seven.
• Três agentes auxiliares onde o host possui um contrato nativo: asset producer, finish reviewer e manual edit applier.
• .claude-plugin/ para compatibilidade com o plugin/marketplace do Claude.
• cli/engine/, com as engines regex, HTML/cascade e navegador usadas por seven check.
• extension/, a extensão Manifest V3 Seven UI Guardian, com popup, painel DevTools, marcações de findings e cliente Seven Live.
• docs/upstream-parity.json, matriz executável e versionada contra o Impeccable auditado.

GitHub Copilot é a única distribuição upstream deliberadamente recusada: nenhum projeto consumidor recebe ou tem alterado um arquivo .github/**.

Alguns hosts exigem ativação fora do alcance do npm. seven init e seven doctor lembram o usuário de aprovar os hooks do projeto no Codex. Esses consentimentos não podem ser automatizados com segurança; o pre-commit local continua protegendo arquivos de UI independentemente da ativação do host.

Skill canônica

source/SKILL.md é a fonte de verdade. Ela roteia 22 workflows de UI aplicáveis — setup, shape, document, extract, critique, audit, polish, bolder, quieter, distill, harden, onboard, animate, colorize, typeset, layout, delight, clarify, adapt, optimize, overdrive e live — mais doctor, hooks e exceptions. init permanece como alias retrocompatível de setup.

No Claude Code, a invocação explícita é /seven setup [target]; o build publica intent e target como argumentos nomeados e consome $ARGUMENTS. No Codex, a sintaxe nativa equivalente é $seven setup [target]. Nos demais hosts, o primeiro token seleciona o workflow e o restante do prompt define o alvo.

Comandos determinísticos da skill passam pelo scripts/run-seven.mjs instalado em cada host. O runner resolve diretamente o binário do @etus/seven local, por isso não depende de um seven global nem do gerenciador de pacotes usado pelo projeto.

Todo workflow de UI deve:

1. resolver o arquivo, app e superfície exatos;
2. carregar PRODUCT.md, .seven/project.yml, surface brief e o resumo íntegro do release lock;
3. validar a instalação com run-seven.mjs doctor --quick;
4. procurar e reutilizar componentes/variantes do registry instalado;
5. usar somente tokens Seven e voz de produto em português brasileiro;
6. executar run-seven.mjs check em cada arquivo alterado;
7. reportar evidência e gaps sem inventar contratos.

Contexto de produto pode especializar usuários, jobs, estados, voz e acessibilidade. Não pode substituir cores, tipografia, spacing, radii, motion, variantes ou APIs do Seven. Não existe DESIGN.md consumidor com autoridade visual.

Detector e enforcement

O catálogo possui 68 regras. Ele inclui as 59 regras determinísticas identificadas no Impeccable atual, classificadas como portadas, adaptadas à autoridade do Seven ou rejeitadas por conflito, além de regras exclusivas de tokens, Tailwind v4, React 19, pt-BR, shell Sidebar + Topbar, comportamento da Rail e boundary consumidor.

O pacote consumidor combina o detector com:

• hooks semânticos nativos em Claude Code e Codex;
• pre-commit Git local para mudanças humanas ou feitas fora das ferramentas do agente;
• checks --all, --changed, --staged, --file e URL renderizada;
• exceções explícitas, baseline que só pode encolher, doctor, pin/unpin e update/uninstall ownership-safe.

O LLM nunca é hard gate. Código determinístico decide routing técnico, integridade e findings; o modelo é usado para julgamento de produto/design.

Seven Live e extensão

seven live usa um bridge em 127.0.0.1 com token aleatório, journal local e payload limitado. Seven UI Guardian seleciona o elemento e exibe direções HTML/CSS inertes. Um aceite autoriza uma edição pequena no código React usando contratos instalados; DOM/CSS de preview nunca vira produção automaticamente.

Por segurança do navegador, npm não pode ativar a extensão sem consentimento. seven extension path informa o diretório publicado que deve ser carregado uma única vez como extensão sem compactação.

Build e verificação

pnpm --filter @etus/seven-skill build
pnpm --filter @etus/seven-skill test
pnpm --filter @etus/seven-skill typecheck

O build regenera os provider trees de Claude Code e Codex, agentes, metadados de plugin, snapshot de tokens, browser detector e extensão. Artefatos gerados devem permanecer byte-for-byte derivados de source/ e extension-src/.

packages/seven-skill/
├── source/                   # skill, referências, scripts e agentes canônicos
├── build/                    # transformers e geradores
├── cli/engine/               # detector determinístico
├── extension-src/           # fonte da extensão
├── extension/               # build publicável da extensão
├── .claude/, .agents/       # outputs dos 2 hosts suportados
├── docs/                     # regras e matriz de paridade
└── tests/                    # contratos, fixtures, build e paridade

Licença

Apache-2.0. A arquitetura adaptada do Impeccable é atribuída em NOTICE.md e nos headers relevantes.