Instalacao¶

Esta pagina e a fonte unica de instrucoes de instalacao. O conteudo abaixo e includido literalmente do README.md da raiz do repositorio — qualquer atualizacao no README aparece aqui no proximo build CI (FR-005).

Pre-requisitos¶

bash ou sh POSIX (Linux, macOS, WSL).
curl no PATH para o one-liner de bootstrap.
tar e sha256sum (ou shasum -a 256 no macOS) para validar a release.
git se voce planeja contribuir. Nao ha dependencia de Node, Python ou Docker para o cstk em si.
jq e opcional — habilita merge de settings.json em escopo de projeto.

Conteudo canonico (do README)¶

Instalação¶

Via cstk CLI (recomendado)¶

A partir da versão 0.1.0, o toolkit é instalado via cstk — CLI POSIX shell que baixa, valida (SHA-256), instala e atualiza skills sem exigir clone do repositório.

One-liner de bootstrap (instala cstk em ~/.local/bin/):

curl -fsSL https://github.com/JotJunior/cstk/releases/latest/download/install.sh | sh

Depois disso, comandos típicos:

cstk --version                       # confirma instalação
cstk install                         # instala perfil 'sdd' em ~/.claude/skills/
cstk install --profile all           # instala TODAS as 29 skills (inclui language-go)
cstk install advisor bugfix          # cherry-pick por nome
cstk update                          # aplica novas releases preservando edits locais
cstk update --force                  # sobrescreve skills com edição local
cstk list                            # lista skills instaladas + status
cstk doctor                          # detecta drift entre manifest e disco
cstk self-update                     # atualiza o próprio binário cstk

Perfis disponíveis:

Perfil	Conteúdo	Uso típico
`sdd`	10 skills do pipeline Spec-Driven Development (briefing → review-task)	Instalação global default
`complementary`	9 skills independentes (advisor, bugfix, owasp-security, decision-tree, etc.)	Complementa o pipeline SDD
`all`	Todas as 29 skills (sdd + complementary + language-go)	Instalação completa
`language-go`	Skills + hooks específicos para Go	Apenas em projetos Go

Profile padrão quando nada é informado: sdd.

Escopo de projeto (./.claude/skills/ no CWD em vez de ~/.claude/skills/):

# Em um projeto Go: instala skills + hooks + merge de settings.json
cd ~/projetos/meu-app-go
cstk install --scope project --profile language-go

# Cherry-pick em escopo de projeto
cstk install --scope project advisor owasp-security

# Hooks de language-* SÃO instalados apenas em --scope project
# (em --scope global, hooks são omitidos com aviso no summary — FR-009c)

Modo interativo (seletor numerado em TTY):

cstk install --interactive   # lista perfis + skills numerados; seleção via toggle
cstk update --interactive    # mesmo, mas sobre skills do manifest

Dry-run (mostra plano sem escrever):

cstk install --dry-run --profile all
cstk update --dry-run

Instalação manual (deprecated, ainda suportada)¶

Se preferir não usar o cstk, copia direta dos diretórios continua funcionando:

# Skills globais — instalação global
cp -r global/skills/ ~/.claude/skills/

# Skills de Go — copiar para projeto Go
cp -r language-related/go/skills/ seu-projeto/.claude/skills/
cp -r language-related/go/hooks/ seu-projeto/.claude/hooks/
cp language-related/go/settings.json seu-projeto/.claude/settings.json

Esta abordagem não rastreia versões nem detecta drift — você acaba recorrentemente com uma cópia instalada divergente do source. Se for usar, mantenha disciplina manual de diff -r (ver CLAUDE.md §"Installed vs Source Drift"). O cstk resolve isso via manifest + hash_dir.

Estrutura de Destino¶

~/.claude/                  # Instalação global
├── skills/                 # (gerenciado por cstk: contém .cstk-manifest)
└── insights/               # (opcional, gerado pelo /insights nativo)

seu-projeto/
└── .claude/                # Instalação por projeto
    ├── skills/             # (gerenciado por cstk: --scope project)
    ├── hooks/              # (opcional, para hooks de linguagem)
    ├── settings.json       # (mesclado por cstk quando jq disponível)
    └── insights/           # (opcional)

Documentação completa do cstk¶

cli/README.md — visão técnica, convenções, processo de release
docs/specs/cstk-cli/ — spec, plan, contracts, quickstart

Conferindo a instalacao¶

cstk --version    # imprime tag semver da release instalada
cstk list         # lista skills instaladas + status (managed / drifted / unmanaged)
cstk doctor       # detalha drift entre manifest e disco

Se cstk nao aparece no PATH, garanta que ~/.local/bin esta em PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc   # ou ~/.bashrc
exec "$SHELL" -l

Atualizacao¶

cstk self-update   # atualiza o proprio binario cstk a partir do GitHub
cstk update        # atualiza skills preservando edicoes locais (--force sobrescreve)

A skill cstk update deteca drift (edicao local depois da instalacao) e pausa por seguranca antes de sobrescrever. Use --force para aceitar a sobrescrita ou cstk doctor para inspecionar diferencas.