Skills Para Engenheiros de Verdade (Fork)

Este repositorio e um fork de mattpocock/skills. Todo credito pela concepcao e arquitetura original vai para Matt Pocock e para os contribuidores do projeto original.

Este fork adiciona governanca orientada a GitHub, documentacao persistente, planejamento por Issues, verificacao automatica do framework, re-deploy das skills e um portao obrigatorio de QA. A ideia e tornar o desenvolvimento com agents rapido sem perder rastreabilidade, feedback e controle humano.

As skills sao pequenas, compostas e adaptaveis. Funcionam com diferentes modelos e CLIs de agents. Hackeie, adapte e faca delas as suas.

Nao e necessario clonar este repositorio. A instalacao pode ser executada diretamente:

curl -fsSL https://raw.githubusercontent.com/alltomatos/skills/main/scripts/setup-alltomatos-skills.sh | bash

O script pergunta em qual ambiente instalar e aceita mais de um destino:

Para instalar em Codex e Claude, informe 1 2. O script baixa o framework temporariamente, instala as skills nos ambientes escolhidos e nao cria um clone permanente.

Tambem e possivel usar um clone local:

git clone https://github.com/alltomatos/skills.git
cd skills
chmod +x scripts/setup-alltomatos-skills.sh
./scripts/setup-alltomatos-skills.sh

Quando o /orchestrator detectar uma nova revisao, ele executara o re-deploy automaticamente. Para executar manualmente:

curl -fsSL https://raw.githubusercontent.com/alltomatos/skills/main/scripts/setup-alltomatos-skills.sh | bash -s -- --redeploy

Ou, a partir de um clone:

./scripts/setup-alltomatos-skills.sh --redeploy ~/.codex/skills ~/.claude/skills

As instalacoes existentes sao preservadas em backups quando necessario.

Depois da instalacao, abra um projeto no agent e execute:

/orchestrator

O projeto consumidor precisa estar versionado no Git e possuir um repositorio remoto no GitHub. Em um projeto novo:

git init
git add .
git commit -m "chore: initialize repository"
gh repo create <nome> --source . --remote origin --push

Se o ambiente estiver vazio, sem Git ou sem remote GitHub, o orchestrator deve parar e orientar esse processo antes de implementar qualquer coisa.

1. Atualizacao do framework: o orchestrator localiza o clone de origem associado as skills instaladas, consulta o remote GitHub, informa commits novos e faz o re-deploy nos ambientes em uso.
2. Governanca: valida Git, remote GitHub, autenticacao e estado do projeto.
3. Documentacao: cria ou atualiza AGENTS.md/CLAUDE.md, CONTEXT.md, docs/agents/, ADRs e ORCHESTRATOR-ROADMAP.md.
4. Estrategia: usa /roadmap e /grill-with-docs para definir Epics, linguagem de dominio e decisoes.
5. Fragmentacao: usa /to-issues para publicar slices verticais no GitHub com criterios de aceite e dependencias.
6. Execucao: delega tarefas pequenas, usando worktrees para paralelismo seguro.
7. Feedback: usa /tdd, /query-docs, /diagnose e /secure-e2e conforme o risco.
8. QA: invoca /qa-analyst obrigatoriamente antes de qualquer PR, sem excecao de tier.
9. Entrega: somente apos QA aprovado, executa o fluxo de PR disponivel no ambiente com confirmacao humana.

O GitHub e a fonte persistente de Issues, escopo, criterios de aceite, dependencias, revisao e historico. ESTADO_ORQUESTRATOR.md e somente a visao operacional da DAG.

O /orchestrator e a Skill Mestra deste fork, um conceito que nao existe no repositorio original. Ele avalia, documenta, delega, fiscaliza e expande o fluxo de engenharia.

O orchestrator nao executa trabalho pesado diretamente. Ele identifica o problema e delega para a skill correta. Se nao existe skill para o gargalo, invoca /write-a-skill para cria-la.

O modo de falha mais comum e o desalinhamento. grill-me, grill-with-docs e grill-feature-with-docs conduzem uma sessao de perguntas para transformar intencao em requisitos, linguagem de dominio e decisoes registradas.

Uma linguagem compartilhada reduz ambiguidades, melhora nomes de arquivos e funcoes e torna a base de codigo mais navegavel. O /grill-with-docs registra essa linguagem em CONTEXT.md e ADRs. Consulte tambem o exemplo de CONTEXT.md do repositorio course-video-manager original.

O agent precisa de loops de feedback: tipos, browser, testes automatizados e reproducoes minimas. /tdd aplica red-green-refactor e /diagnose conduz o ciclo reproduzir, minimizar, hipotetizar, instrumentar, corrigir e testar regressao.

Agents aceleram a codificacao e tambem podem acelerar a entropia. /improve-codebase-architecture promove design continuo, limites claros e uma base mais testavel e navegavel.

Roadmap, GitHub Issues, documentacao, worktrees e QA formam um ciclo de governanca que limita deriva de escopo e torna as decisoes auditaveis.

Skills para trabalho diario com codigo: diagnose, grill-with-docs, grill-feature-with-docs, triage, improve-codebase-architecture, setup-skills, tdd, to-issues, to-prd, zoom-out, scaffold-mvp, prototype, roadmap, secure-e2e, qa-analyst, query-docs e orchestrator.

Skills de workflow geral: caveman, grill-me, handoff e write-a-skill.

Skills mantidas para casos especificos: git-guardrails-claude-code, migrate-to-shoehorn, scaffold-exercises e setup-pre-commit.

Skills em personal/, in-progress/ e deprecated/ nao sao instaladas pelo script.

O projeto consumidor deve manter AGENTS.md ou CLAUDE.md, CONTEXT.md ou CONTEXT-MAP.md, ORCHESTRATOR-ROADMAP.md, docs/agents/issue-tracker.md, docs/agents/triage-labels.md, docs/agents/domain.md e docs/adr/ quando houver decisoes relevantes.

Este projeto e um fork de mattpocock/skills. A arquitetura original, a inspiracao e grande parte das skills vieram de Matt Pocock. Consulte tambem a newsletter de skills para acompanhar o trabalho original.