robertodiasduarte/sdd-starter

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.

소스 보기

사용 방법

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

시작 전 확인

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

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

Nova frente de trabalho (new-session)

Na primeira resposta desta skill, comece com esta linha, uma vez só: sdd-new-session v1.0.0 · out/2026 · versão atual: https://github.com/robertodiasduarte/sdd-starter/releases/latest

Um comando, uma tarefa, um diretório: git worktree + branch nova nascida do estado remoto atual da branch de produção, pronta para abrir no editor.

Passo 0 — Confirme que você consegue fazer isto

Rode git remote -v.

  • Se o comando não executa (você está num aplicativo de chat, sem acesso ao computador do usuário),

pare e diga exatamente: "Não tenho acesso ao seu repositório — estou rodando no aplicativo, não na sua máquina. Para esta tarefa você precisa do Claude Code ou do Codex instalado no terminal, aberto na pasta do projeto." Em seguida diga o comando de instalação atual do agente que você é e onde fica a documentação oficial.

  • Se executa, mas a pasta não é um repositório git (git rev-parse --show-toplevel falha), diga

isso e pare sem criar nada — provavelmente o terminal foi aberto na pasta errada, ou o projeto ainda não tem git.

⛔ Não invente uma frente assumindo como o projeto é. Uma frente criada a partir de suposição falha na primeira vez que for usada, e o usuário não vai saber por quê. Parar aqui é melhor que entregar algo plausível e errado.

Regra número um: não pergunte o que dá para descobrir

Investigue e decida. Só pergunte o que for genuinamente ambíguo — e aí com a sua recomendação e o motivo, para o usuário só confirmar. Tudo o que você assumir sozinho vai para a seção ## Suposições de sdd/ambiente.md, onde ele corrige em uma linha.

Passo 1 — Descubra o ambiente (uma vez por repositório)

O checkout principal é o primeiro caminho de git worktree list --porcelain (linha worktree …). Se existir <checkout principal>/sdd/ambiente.md, leia e use — não redescubra o que já está escrito. Se não existir, investigue sem perguntar — mas, se o nome da tarefa já veio no pedido, faça antes a checagem de colisão do Passo 2 (item 2): nome repetido aborta sem gravar nada, nem o sdd/ambiente.md.

bash
git remote show origin
git branch -r
git log --oneline -20
git tag --list
git worktree list

E leia, se existirem: README.md, package.json, composer.json, requirements.txt, Makefile, .gitignore, .env.example, .github/workflows/, CLAUDE.md, AGENTS.md.

Extraia:

  • Branch principal — a "HEAD branch" do git remote show origin. Não é "a branch em que estou agora".
  • Preparação — package.json versionado com node_modules no .gitignore ⇒ npm install na pasta

nova (senão ela nasce quebrada). Mesma lógica para requirements.txt, composer.json.

  • Arquivos locais fora do git — .env no .gitignore e .env.example versionado ⇒ a pasta nova

precisa de uma cópia do .env do checkout principal.

  • Skills do agente fora do git — cada pasta em .claude/skills/ ou .agents/skills/ sem nenhum

arquivo versionado (git ls-files <pasta> vazio, pasta por pasta) ⇒ precisa ser copiada para a frente; sem isso, a sdd-release não existe dentro dela.

  • Editor — o primeiro que existir de code, cursor, subl (command -v <nome> no bash/zsh,

Get-Command <nome> no PowerShell).

  • Cenário de branching, pela evidência do repositório (critério do material "Git na Prática"):
CenárioComo reconhecerEstratégiaA frente termina em
A — entrega contínua, sem revisorSem develop/staging no remoto; histórico de commits diretos na principalTrunk-Based simplificadomerge direto na principal
B — entrega via Pull RequestHistórico com "Merge pull request #…"; .github/workflows/; mais de um autorGitHub Flowpush da branch + PR
C — várias versões em suporteTags de versão e branches release/* ou hotfix/* no remotoGitFlowPR para develop (a branch nasce de develop)

Escolha sempre o mais simples que serve. Empate entre A e B ⇒ A (acrescentar PR depois é trivial; tirar cerimônia que virou hábito, não). C exige as duas evidências; repositório de uma pessoa quase nunca é C — se você concluiu C, reveja.

Grave em <checkout principal>/sdd/ambiente.md (crie a pasta sdd/ se preciso), neste formato — uma chave por linha, para o usuário corrigir à mão:

markdown
# Ambiente deste repositório

> Gerado pelas skills sdd-new-session/sdd-release. Está errado? Corrija a linha — as skills leem daqui.

- branch_principal: main
- cenario: A (Trunk-Based) — evidência: <o que você viu, ex.: "20 últimos commits diretos na main, sem develop no remoto">
- pasta_das_frentes: ../<nome-do-repo>-frentes
- editor: code
- preparacao: npm install
- arquivos_locais: .env
- deploy: <preencha só se descobriu; senão "a descobrir pelo sdd-release">
- testes: <comando, se descobriu>
- sintaxe: <comando, se descobriu>
- versionamento: nenhum

## Suposições

- assumi <X> porque <Y>

Não commite esse arquivo: ele é do usuário, que decide se versiona.

Passo 2 — Crie a frente

Receba o nome da tarefa em linguagem natural e, na ordem:

  1. Slug: minúsculas, hífens, sem acento (ex.: "Relatório mensal" → relatorio-mensal).
  2. Aborte se a branch ou a pasta já existirem (git show-ref --verify refs/heads/<slug>,

git ls-remote --heads origin <slug>, e a pasta <pasta_das_frentes>/<slug>). Não invente outro nome: peça outro ao usuário. Nada pode ter sido criado antes desta checagem.

  1. git fetch origin <branch-base> e

git worktree add <pasta_das_frentes>/<slug> -b <slug> origin/<branch-base> — a partir do estado remoto, não do local, que pode estar atrasado. <branch-base> é a principal (A, B) ou develop (C). Cenário C sem origin/develop (git ls-remote --heads origin develop vazio)? Pare antes de criar qualquer coisa e diga: o critério aponta GitFlow, mas não há develop de onde a frente possa nascer.

  1. Na pasta nova: rode a preparação, se houver.
  2. Copie para a frente o que o git não leva: os arquivos locais (.env) e **cada pasta de skill não

versionada, sempre a partir do checkout principal (caminhos absolutos, entre aspas): `mkdir -p "<frente>/.claude/skills" && cp -R "<checkout principal>/.claude/skills/<skill>" "<frente>/.claude/skills/"`, idem `.agents/skills/`. Confira que `<frente>/.claude/skills/sdd-release` (ou `.agents/skills/sdd-release`) existe quando existe no checkout principal — sem ela, a frente não consegue ser fechada. O Claude Code pede aprovação para escrever em `.claude/`: se a cópia for negada, não pare** — termine a frente e, na resposta, entregue o comando de cópia pronto e a alternativa de instalar as skills uma vez para todos os projetos (npx skills add robertodiasduarte/sdd-starter -a <motor> -g -y).

  1. Abra no editor (code <pasta>). Sem editor, não aborte: a frente já está pronta; mostre o caminho

para abrir à mão.

A pasta fica fora do repositório (../<repo>-frentes/<slug>): dentro dele, a worktree apareceria como arquivo não rastreado e sujaria o git status de todas as outras frentes.

O que esta skill NÃO faz: não commita, não faz push, não apaga, não integra. Só cria. Tudo o que destrói ou publica é entregue como comando — ou fica para a skill sdd-release.

Passo 3 — Responda

Nesta ordem:

  1. Cenário (A, B ou C) com a evidência — o que você viu, não "parece ser".
  2. Caminho da pasta e nome da branch.
  3. Como encerrar esta frente, pronto para copiar: no fim, use a skill sdd-release de dentro da

pasta nova; ou, à mão, o comando de integração do cenário seguido de git worktree remove <pasta> e git branch -d <slug>.

  1. Suposições que você fez (se houver) e onde corrigi-las (sdd/ambiente.md).
  2. No cenário A, trabalhando sozinho com IA: lembre de pedir uma revisão do código à IA antes de

integrar — não há segundo humano olhando.

  1. Última linha, destacada:

⚠️ Continue na janela nova. Esta sessão do agente continua presa à pasta onde foi aberta — nenhum cd muda isso. Build, commit e push rodam lá dentro.

Por que cada regra existe (não apague sem ler)

  • A branch nasce de `origin/<branch-base>` atualizada (a principal; develop no cenário C) — nascer da branch atual herda trabalho pela

metade de outra tarefa, e a frente nova "já vem com código estranho".

  • A mesma branch não abre em duas worktrees — o Git recusa. Por isso não se volta para a principal

dentro da pasta da frente: integra-se pelo caminho do cenário e atualiza-se no checkout principal.

  • Se outra frente for integrada antes desta, esta nasceu de um ponto que já não existe. Antes de

integrar: git fetch origin + git merge origin/<branch-base> + rodar os testes de novo — é aí que o conflito entre as duas aparece. (A sdd-release faz isso.)

  • Worktree e branch órfãs se acumulam — depois de integrar, git worktree remove e

git branch -d. O -d minúsculo é proteção: só apaga o que já foi integrado.

  • A sessão do agente não migra — abrir a pasta nova abre outra janela, mas a sessão onde a skill

rodou fica ancorada no diretório de origem. Sem o aviso final, a frente inteira acaba sendo feita no lugar errado e isso só aparece na hora do commit.


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-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일
robertodiasduarte
커뮤니티

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. 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,

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