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.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/robertodiasduarte/sdd-starter --skill sdd-checar-ambiente

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills
robertodiasduarte
커뮤니티

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

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 4일
robertodiasduarte
커뮤니티

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

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 4일
robertodiasduarte
커뮤니티

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

1시간 설치 수
2
GitHub Stars
0
업데이트
10월 1일
robertodiasduarte
커뮤니티

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

1시간 설치 수
2
GitHub Stars
0
업데이트
10월 1일