How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/robertodiasduarte/sdd-starter --skill sdd-checar-ambienteBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Checar ambiente
Responder uma pergunta: este ambiente está pronto para trabalhar com SDD aqui? Em segundos, sem mudar nada, dizendo o que consertar.
Como executar
Com bash disponível (macOS, Linux, ou Git Bash no Windows), rode o script que acompanha esta skill, de dentro da pasta do projeto:
bash <pasta desta skill>/scripts/checar.she responda com a saída dele, exatamente como veio — sem frase antes, sem frase depois, sem comentário sobre o que foi ou não verificado, sem tradução. O script já faz todas as verificações abaixo e já imprime o relatório no formato certo; o formato não depende de você. (A pasta desta skill é a que contém este SKILL.md: .claude/skills/sdd-checar-ambiente/ ou .agents/skills/sdd-checar-ambiente/, no projeto ou na pasta global do agente.)
Sem bash (PowerShell puro), faça as verificações abaixo à mão e responda no mesmo formato do script: blocos 🔴 Impede o trabalho e ⚠️ Vale arrumar só se tiverem itens, e por último a linha ✅ Pronto: repo … (ou ✅ Repo … quando houver problema). Checagem que passou ou não se aplica não é mencionada fora dessa linha.
Regras
- Somente leitura. Não instale, não configure, não conserte, não crie arquivo. Entregue o comando;
quem roda é o usuário, depois de ver o que está autorizando.
- Não invente problema. Sem
.env.exampleversionado, não reclame de.envausente. Sem
package.json, não fale de node_modules. Um alarme falso ensina a ignorar todos os outros.
- Ordene por consequência, não por categoria. O que trava vem antes do que incomoda.
- Descubra, não pergunte. Tudo abaixo se descobre rodando comandos.
- Funciona em qualquer shell. Os comandos de
gitsão iguais no bash, no zsh e no PowerShell. Para
saber se um programa existe, use command -v <nome> no bash/zsh ou Get-Command <nome> no PowerShell.
O que verificar, nesta ordem
1. Onde estou
git rev-parse --show-toplevel— é um repositório git? Se não for, esse é o achado mais
importante: diga na primeira linha (provavelmente o terminal foi aberto na pasta errada, ou o projeto ainda não tem git — git init).
- Pasta, branch atual (
git branch --show-current) e se há mudanças não commitadas (git status --short).
2. Agentes disponíveis
claude --versionecodex --version— registre a versão de cada um que existir.- Qual deles está executando esta skill agora.
3. Git utilizável
git --version.git config user.nameegit config user.email. Sem os dois, o primeiro commit falha com uma
mensagem que não diz claramente o que fazer. O comando que resolve: git config --global user.name "Seu Nome" e git config --global user.email "voce@exemplo.com".
git remote -v— há remoto? Qual é a branch principal dele (git remote show origin, linha
"HEAD branch")?
4. Frentes de trabalho (worktrees)
git worktree list— a 1ª linha é o checkout principal, não é frente. Frentes abertas = as linhas
seguintes. Só o checkout principal ⇒ "nenhuma frente aberta" (dizer "1 frente aberta" aqui descreve um estado que não existe).
- Worktree órfã: entrada da lista marcada
prunable, ou cuja pasta não existe mais (alguém
apagou a pasta à mão). Comando: git worktree prune.
- Frente já integrada ainda aberta: branch de uma worktree **que não é o checkout principal nem a
própria branch principal e que já está contida na principal (`git branch --merged origin/<principal>`) e que teve commit próprio (`git reflog show <branch>` tem alguma entrada `commit`). Branch contida na principal sem** commit próprio é uma frente recém- aberta, não integrada — não sugira removê-la. Comando para a integrada: git worktree remove <pasta> e depois git branch -d <branch>.
- Se existir
sdd/ambiente.mdno checkout principal (a primeira linha de
git worktree list --porcelain), leia-o: ele diz a branch principal e onde as frentes ficam. Um sdd/ não rastreado no checkout principal é esse arquivo — não é problema.
5. Ferramentas do projeto
package.jsonpresente enode_modulesausente ⇒ faltanpm install(sem isso o primeiro
comando do projeto falha com um erro que parece outra coisa); composer.json sem vendor/, idem — os dois são 🔴. requirements.txt sem ambiente virtual na pasta é ⚠️: as dependências podem estar instaladas fora dele.
.env.exampleversionado e nenhum.env⇒ falta a configuração local (copiar o exemplo e
preencher).
- Editor no PATH:
code,cursorousubl(nesta ordem). Sem editor não é problema — não entra
em 🔴 nem em ⚠️; se houver um, cite-o no resumo ✅.
Como reportar
Não entregue relatório longo: quem roda isto quer ser desbloqueado, não ler. Três blocos, nesta ordem, omitindo os vazios:
- 🔴 Impede o trabalho — não é repositório git, git sem identidade, dependências faltando.
Cada item com o comando exato que resolve, pronto para copiar.
- ⚠️ Vale arrumar — worktree órfã, frente integrada ainda aberta,
.envausente. - ✅ Resumo em uma linha — ex.:
✅ Pronto: repo meu-app, branch main, 2 frentes abertas, Claude Code 2.1.
Se estiver tudo certo, a resposta inteira é exatamente a linha ✅ — nenhuma frase antes nem depois: nada de "Tudo limpo", de lista do que foi verificado ou de oferta de ajuda. Ambiente saudável não merece parágrafo; quem quer detalhe pergunta.
Exemplos
Saudável:
✅ Pronto: repo meu-app, branch main, nenhuma frente aberta, Claude Code 2.1.Com dois problemas:
🔴 Impede o trabalho
- O git não tem e-mail configurado — o primeiro commit vai falhar.
git config --global user.email "voce@exemplo.com"
⚠️ Vale arrumar
- A frente ../meu-app-frentes/relatorio-mensal já foi integrada na main e continua aberta.
git worktree remove ../meu-app-frentes/relatorio-mensal
git branch -d relatorio-mensal
✅ Repo meu-app, branch main, 1 frente aberta, Claude Code 2.1.Parte do SDD Starter by RDD — https://github.com/robertodiasduarte/sdd-starter


