Imported from mpabegg/micro-tools (
AGENTS.md). Install upstream withnpx skills add mpabegg/micro-tools. Copyright stays with the author.
Instruções para agentes — micro-tools
Este repo é uma coleção de micro-ferramentas web pessoais, publicadas em GitHub Pages sob o subcaminho /<repo>/. As regras abaixo são duras; respeite-as.
Princípio: mínimo absoluto
- Sem npm, sem bundler, sem dependências, sem framework. Não introduza
package.json,node_modules, build steps ou ferramentas de transpilação. - Cada ferramenta é um único arquivo
.htmlautossuficiente, com HTML, CSS e JS inline. - Se algo pode ser um arquivo estático, deve ser.
- Única exceção tolerada: Google Fonts via
<link>, com fallback de sistema na CSS.
Caminhos relativos (sempre)
O site é servido em https://mpabegg.github.io/micro-tools/, ou seja, sob um subcaminho. Nada de paths absolutos começando com / — quebra em produção.
Aplica-se a tudo: <link>, <script>, <a href>, fetch(), registro do service worker, start_url/scope do manifest, lista de cache do SW. Sempre ./algo ou algo.
Convenções de código
- localStorage: uma chave única por ferramenta, padrão
<nome>_v1(ex.:sets_tracker_v1). Nunca compartilhar chaves. - Estética: dark + amber (
--bg:#0c0a09,--amber:#ff8a1f). Veja as variáveis CSS no topo de cada.html. - Fontes: Anton / Barlow Condensed / JetBrains Mono via Google Fonts, com fallback de sistema (
system-ui,monospace). - PWA: todo
.htmldeve linkar./manifest.json, definirtheme-color, e registrar./sw.jscomscope: "./".
Service worker
- Único
sw.jsna raiz. Versão emCACHE = "tools-vN"— bumpe N a cada mudança no app-shell ou em arquivos cacheados, pra invalidar caches antigos noactivate. - Ao adicionar uma ferramenta, inclua-a em
APP_SHELLnosw.jsE bumpe oCACHE. - Estratégia: cache-first para same-origin, stale-while-revalidate oportunista para fontes Google.
Arquivo intocável
manual-de-estrategias.md é pessoal e canônico. Não edite, não leia para gerar respostas, não referencie no código, não inclua em caches do SW, não parseie nem cite. Trate como se não existisse. O index.html contém um bloco estático de lembrete de estratégia ("O Método" / "Quando Travar") com texto inline — é cópia manual curada, não derivada do manual.
Ferramentas removidas
riff-trainer.html— removido. Não recrie sem pedido explícito; não inclua em precache do SW.
Fluxo ao adicionar uma ferramenta
- Criar
nova.htmlna raiz (base: copiar cabeçalho de uma ferramenta existente — metas PWA, manifest, ícone, snippet de registro do SW no final do<body>). - Adicionar card no
index.html(há template comentado dentro de.grid). - Adicionar
"./nova.html"emAPP_SHELLemsw.js. - Bumpar
CACHEemsw.js. - Commits pequenos e descritivos.
Restrições gerais
- Não adicione documentação além de
README.mde este arquivo, salvo pedido explícito. - Não crie features especulativas. Implemente exatamente o que foi pedido.
- Não introduza backwards-compatibility shims gratuitos: este repo é pessoal e tem um único usuário.