---
name: sdd-checar-ambiente
license: MIT
description: "Diagnostica, sem alterar nada, se este computador e este repositório estão prontos para trabalhar com SDD: repositório git, agente de código, identidade do git, worktrees órfãs, dependências, editor e dado exposto (senha, certificado A1 ou chave privada já salvos no git; .env fora do .gitignore; npm sem ignore-scripts; repositório público). Responde em uma linha quando está tudo certo e, quando não está, lista o que impede primeiro, cada item com o comando exato que resolve. Use quando o usuário pedir para checar o ambiente, antes de abrir a primeira frente de trabalho num projeto, ou quando algo estranho acontecer (commit que falha, comando não encontrado, worktree que sumiu)."
metadata:
  author: Roberto Dias Duarte
  version: "1.0.0"
  updated: "2026-10"
---

# 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
bash <pasta desta skill>/scripts/checar.sh
```

e **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 `🔴 Dado exposto`, `🔴 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. Termine a linha ✅ com a identificação desta skill:
`sdd-checar-ambiente v1.0.0 · out/2026 · versão atual: https://github.com/robertodiasduarte/sdd-starter/releases/latest`
(o script faz isso sozinho, lendo a versão deste arquivo).

## 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. A única saída de rede é uma consulta
  anônima ao GitHub, de até 3 segundos, para saber se o repositório é público; se falhar, não diga nada
  sobre isso.
- **Não invente problema.** Sem `.env.example` versionado, não reclame de `.env` ausente. Sem
  `package.json`, não fale de `node_modules` nem de npm. Sem `.env` na pasta, não fale de `.gitignore`.
  Repositório público, sozinho, não é problema. Um `.pem` com certificado público não é segredo. 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 `git` sã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 --version` e `codex --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.name` e `git 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.md` no 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.json` presente e `node_modules` ausente ⇒ falta `npm 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.example` versionado e nenhum `.env` ⇒ falta a configuração local (copiar o exemplo e
  preencher).
- Editor no PATH: `code`, `cursor` ou `subl` (nesta ordem). **Sem editor não é problema** — não entra
  em 🔴 nem em ⚠️; se houver um, cite-o no resumo ✅.

**6. Dado de cliente e segredos** (o computador do escritório tem dado de cliente e certificado A1)
- **Já salvo no git** (`git ls-files`): `.env` ou `.env.*` (exceto `.env.example` e `.env.sample`),
  `.pfx`, `.p12`, e `.pem` que contém `PRIVATE KEY` (`git grep --cached -l "PRIVATE KEY" -- '*.pem'`).
  Cada um é 🔴 Dado exposto, com o comando `git rm --cached "<arquivo>" && echo "<arquivo>" >> .gitignore`
  **e** a medida que protege de fato: trocar as senhas (`.env`), revogar o certificado com a autoridade
  certificadora e emitir outro (`.pfx`/`.p12`), gerar chave nova (`.pem`). Tirar do git não apaga do
  histórico — diga isso.
- **Repositório público:** se o `origin` é do GitHub, consulte
  `https://api.github.com/repos/<dono>/<repo>` sem login (200 = público; privado responde 404), ou
  `gh repo view --json visibility`. Público aparece só no resumo ✅ ("repo x (público no GitHub)"); com
  dado exposto, o item diz que o arquivo já está na internet.
- **`.env` fora do `.gitignore`:** existe `.env` na pasta, não está rastreado, e `git check-ignore -q .env`
  falha ⇒ ⚠️, `echo ".env" >> .gitignore`.
- **npm sem `ignore-scripts`:** há `package.json`, o npm existe e `npm config get ignore-scripts` não é
  `true` ⇒ ⚠️, `npm config set ignore-scripts true`, avisando que um pacote que dependa de script de
  instalação volta com `npm rebuild <pacote> --ignore-scripts=false`.

Para um alarme que barra o próximo commit com dado de cliente, a skill é a `sdd-higiene-dado` (instala
com OK); esta aqui só diagnostica.

## Como reportar

Não entregue relatório longo: quem roda isto quer ser desbloqueado, não ler. Quatro blocos, nesta
ordem, **omitindo os vazios**:

1. **🔴 Dado exposto** — senha, certificado ou chave privada já salvos no git. Cada item com o comando
   e a medida que protege (trocar senha, revogar certificado).
2. **🔴 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.
3. **⚠️ Vale arrumar** — `.env` fora do `.gitignore`, npm sem `ignore-scripts` (estes primeiro),
   worktree órfã, frente integrada ainda aberta, `.env` ausente.
4. **✅ Resumo em uma linha**, terminando com a identificação desta skill — ex.:
   `✅ Pronto: repo meu-app, branch main, 2 frentes abertas, Claude Code 2.1 · sdd-checar-ambiente v1.0.0 · out/2026 · versão atual: https://github.com/robertodiasduarte/sdd-starter/releases/latest`

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:

```text
✅ Pronto: repo meu-app, branch main, nenhuma frente aberta, Claude Code 2.1 · sdd-checar-ambiente v1.0.0 · out/2026 · versão atual: https://github.com/robertodiasduarte/sdd-starter/releases/latest
```

Com o certificado A1 salvo no git de um repositório público:

```text
🔴 Dado exposto
- O certificado digital certificados/empresa.pfx está salvo no git. Este repositório é público: o arquivo já está na internet.
  git rm --cached "certificados/empresa.pfx" && echo "certificados/empresa.pfx" >> .gitignore
  Depois, revogue o certificado com a autoridade certificadora e emita outro.

✅ Repo meu-app (público no GitHub), branch main, nenhuma frente aberta, Claude Code 2.1 · sdd-checar-ambiente v1.0.0 · out/2026 · versão atual: https://github.com/robertodiasduarte/sdd-starter/releases/latest
```

Com dois problemas:

```text
🔴 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 · sdd-checar-ambiente v1.0.0 · out/2026 · versão atual: https://github.com/robertodiasduarte/sdd-starter/releases/latest
```

---

Parte do SDD Starter by RDD — https://github.com/robertodiasduarte/sdd-starter