Padrões de software com opinião, em Markdown puro.

O que é

O agnostic-core é um conjunto de instruções em Markdown. Cada arquivo descreve um padrão de trabalho: como revisar código, como organizar um commit, como fazer uma migração de banco sem quebrar o que já foi aplicado, como auditar uma tela.

Quando você instala o acervo num projeto, o Claude Code passa a conhecer esses padrões e a usá-los nas partes do projeto que combinam com eles.

Não é um framework, não tem runtime e não altera o seu código sozinho. Nada roda por conta própria: ele fornece referências, e você decide quais aceitar.

Para quem é:

• Quem usa o Claude Code e quer os mesmos padrões em vários projetos.
• Equipes que querem um vocabulário comum para revisão, commits e deploy.
• Quem prefere ler a regra e discordar por escrito, em vez de seguir um default escondido.

Opinião escrita

As skills defendem posições, e cada uma diz o motivo. Três exemplos:

Nada de cara de IA

Proíbe defaults visuais típicos de interfaces geradas por IA, com a lista e o porquê.

skills/design/sem-cara-de-ia.md

Modo caveman

Corta a resposta da IA em cerca de 75%, mantendo a precisão técnica.

skills/behavioral/caveman.md

Precedência entre skills

Diz qual skill perde para qual quando duas tratam do mesmo processo.

docs/precedencia-de-skills.md

Discordar é esperado e barato: não instale a skill, ou instale e edite.

O que tem

125 skills organizadas por área. Os números vêm do catálogo gerado pelo próprio repositório.

Além das skills: 18 agents (padrões de agentes especializados, como revisão de segurança e arquitetura) e 8 commands e workflows (processos prontos, como brainstorm, debug e deploy).

Exemplos

Algumas skills, com a descrição que está no próprio arquivo:

Migration aplicada nunca se edita

Editar uma migration já aplicada trava a esteira inteira por checksum. A resposta é criar outra migration.

skills/database/migration-aplicada-nunca-se-edita.md

Orçamento de leituras de banco

Estimar quantas leituras um app faz por dia, para não estourar a cota de um plano com limite diário.

skills/database/orcamento-de-leituras-banco.md

Convenções de commit

Conventional Commits: tipos, breaking changes e commitlint.

skills/git/commit-conventions.md

Revisão de código

Checklist de revisão de código, organizado por categoria.

skills/audit/code-review.md

Como funciona

1. 1

   Instala

   Rode o instalador na raiz do repositório. Ele adiciona .agnostic-core/ como submódulo.

2. 2

   Detecta a stack

   Reconhece React, Vue, Next, Express, FastAPI, Django, Docker, Prisma e outras. Escreve .agnostic-skills com a seleção e nunca sobrescreve uma seleção existente.

3. 3

   Usa a seleção

   No Claude Code, o CLAUDE.md passa a apontar para as skills da sua stack, e a camada .claude/skills/ liga a autodescoberta. Em outras ferramentas, como Cursor ou Copilot, o acervo é Markdown: você referencia os arquivos que quer usar.

Sem .agnostic-skills, o acervo inteiro é espelhado no system prompt de toda sessão. Por isso a seleção importa.

Instalação

Execute na raiz de qualquer repositório git.

curl -sL https://raw.githubusercontent.com/paulinett1508-dev/agnostic-core/master/scripts/install.sh | bash

iwr -useb https://raw.githubusercontent.com/paulinett1508-dev/agnostic-core/master/scripts/install.ps1 | iex

npx agnostic-core@latest init

git submodule add https://github.com/paulinett1508-dev/agnostic-core.git .agnostic-core
git submodule update --init