robertodiasduarte/sdd-starter

sdd-checar-ambiente

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 e editor.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. 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-ambiente

Before 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.
Original skill document

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
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 🔴 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.example versionado, não reclame de .env ausente. 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 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 ✅.

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:

  1. 🔴 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.

  1. ⚠️ Vale arrumar — worktree órfã, frente integrada ainda aberta, .env ausente.
  2. ✅ 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:

text
✅ Pronto: repo meu-app, branch main, nenhuma frente aberta, Claude Code 2.1.

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.

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

Related by task

from this repository

More skills

All skills
robertodiasduarte
Community

sdd-auditoria-harness

Audita read-only o harness SDD de um repositório para FAXINA E DERIVA: inventaria comandos, agentes, skills, hooks, settings e scripts de QUALQUER motor (Claude Code, Codex, Kimi CLI: le CLAUDE.md e AGENTS.md, .claude/, .agents/ e .codex/), mede referências, recência, duplicação e deriva entre docs e código, e gera um único relatório AUDITORIASDD .md sem alterar nada. Invocar quando alguém disser \"o harness cresceu demais\", \"o que aqui ninguém usa\", \"os docs ainda batem com o código?\", ou

1h installs
1
GitHub stars
0
Updated
Oct 4
robertodiasduarte
Community

sdd-new-session

Abre uma frente de trabalho isolada neste repositório: cria uma git worktree fora da pasta do projeto, com uma branch nova nascida da branch de produção ATUALIZADA do remoto, prepara a pasta (dependências, arquivos locais) e abre no editor. Na primeira vez, investiga o repositório e grava o que descobriu em sdd/ambiente.md. Use quando o usuário disser 'abrir uma frente', 'nova sessão', 'nova tarefa isolada', 'criar worktree para X' ou quiser começar uma feature/correção sem misturar com outra em

1h installs
1
GitHub stars
0
Updated
Oct 4
robertodiasduarte
Community

sdd-brainstorm

Conduz o brainstorm da Fase 0 de um fluxo SDD/AgentSpec por interação com o usuário: explora contexto, faz perguntas de descoberta uma por vez, coleta amostras, compara 2–3 abordagens, aplica YAGNI, valida incrementalmente e gera um BRAINSTORM pronto para a fase /define. Use para ideias vagas de software, automações, agentes, produtos ou features que ainda precisam de exploração antes de formalizar requisitos; também quando o usuário pedir para transformar uma conversa, problema ou notas iniciai

1h installs
2
GitHub stars
0
Updated
Oct 1
robertodiasduarte
Community

sdd-build

Executar a fase Build de um fluxo SDD/AgentSpec a partir dos arquivos Markdown de Brainstorm, Define e Design e de interações com o usuário. Usar quando o usuário quiser implementar uma feature já especificada: ler os três artefatos, extrair e ordenar o File Manifest, recomendar e confirmar o modo de execução, alterar somente o código previsto, verificar incrementalmente, tratar drift e prompts LLM, executar o Verify Gate bloqueante do Define e gerar BUILDREPORT{FEATURE}.md com evidências. Reque

1h installs
2
GitHub stars
0
Updated
Oct 1