xp-stack
Stack metodológico XP/Akita para agentes de IA — TDD absoluto, pair programming, pesquisa formal triangulada, task decomposition rigorosa, conventional commits e orquestração multi-agent nativa via Agent View (Claude Code) com fallbacks opt-in.
Versão atual: v2.0.0 (2026-05-13). Status: estável, pronto pra adoção em qualquer stack (TypeScript, Python, Go, bash, etc.). Veja CHANGELOG.md pro migration guide v1.x → v2.0.
O que mudou na v2.0.0
Breaking release. Parallelization pattern shifts from manual TERMINAL-PROMPTS.md (N terminals + copy-paste) to Claude Code Agent View native. Mais detalhes em CHANGELOG.md.
- ✅ Novo template canônico
TEMPLATE-orchestrator-prompt.md (substitui TEMPLATE-terminal-prompts.md removido)
- ✅ Padrão Sonnet+caveman+worktree pra workers dispatched pelo orchestrator
- ✅ Nova skill opt-in
debugging-discipline — instala PR template + PreToolUse hook + settings deep-merge pra forçar disciplina em commits fix:
- ✅
akita-xp-rules, task-decomposition atualizadas pra refletir Agent View
- ✅
local-waves marcada como [LEGACY] (segue funcional como fallback)
Instalação
Forma primária — npm CLI
npx xp-stack init
Detecta engines disponíveis (Claude Code, Antigravity, Cursor, Codex, etc.), instala dual mirror em .claude/skills/ + .agents/skills/, cria manifest SHA-256, scaffolda CLAUDE.md, AGENTS.md (symlink), docs/tasks/_template/, docs/pesquisas/_template/, .claude/settings.json e .gitignore atualizado. Nunca sobrescreve nada que já exista.
Forma alternativa — plugin marketplace (backward compat)
/plugin marketplace add RNobre1/xp-stack
/plugin install xp-stack@xp-stack
/xp-stack:bootstrap
Recomendação: prefira a forma npm. O plugin marketplace está sujeito ao issue #35989 do claude-code — skills somem do cache de plugins em algumas versões do CLI.
Quick start
cd meu-projeto
npx xp-stack init # scaffold + dual mirror
npx xp-stack status # estado atual (engines, features ativas, drift)
npx xp-stack add-skill db-archaeologist # agent opt-in pra análise de DB
npx xp-stack add-skill debugging-discipline # gates de fix-workflow (PR template + hook)
Subcomandos disponíveis (10 + version flag)
| Comando | O que faz |
|---|
xp-stack init | Scaffold inicial: manifest, dual mirror, templates, AGENTS.md symlink |
xp-stack update | Diff manifest SHA-256, prompt por arquivo (keep/take/merge/abort) |
xp-stack status | Estado atual: engines, features, drift |
xp-stack add-engine <name> | Instala dual mirror em path adicional |
xp-stack add-skill <name> | Habilita skill opt-in (debugging-discipline, paperclip, local-waves, db-archaeologist, etc.) |
xp-stack config get [key] | Lê config (doc_level, etc.) |
xp-stack config doc-level <essencial|completo> | Define nível de documentação por feature |
xp-stack uninstall | Remove arquivos do manifest, preserva user-modified, prompt antes de cada delete |
xp-stack resume [feature] | Lê index + state.json, resume sessão de uma feature |
xp-stack hook-stop | Executado pelo hook Stop — atualiza index.json + regenera RESUME.md |
xp-stack regenerate-resume [feature] | Regenera RESUME.md manualmente |
xp-stack reconcile [feature] | Reconcilia JSON↔markdown quando divergem (JSON wins, dry-run default) |
xp-stack --version | Mostra versão instalada |
Atualizando
npx xp-stack update
# ou plugin marketplace:
/plugin marketplace update RNobre1/xp-stack
/plugin install xp-stack@xp-stack
O que está incluído
Skills regulares (auto-disponíveis após install)
