DevLoop — Toolchain SDLC TDD para Claude Code
flavordrake/devloop
Automação TDD-first do ciclo SDLC completo com agents coordenados
Ver no GitHubSkillset completo para automação de desenvolvimento orientado por testes (TDD) no Claude Code. Inclui skills para ciclos SDLC, escrita de testes, implementação, integração com GitHub, versionamento e rastreamento de decisões via protocolo TRACE. Fornece hooks de higiene de comando, regras de arquitetura e workflow automation.
Instalação
npx convez-ai flavordrake/devloop1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar ciclos de desenvolvimento com test-first workflow (red-green-refactor)
- Orquestração de agents para escrever testes, implementar features e revisar PRs
- Rastreamento de decisões arquiteturais e caminhos de desenvolvimento via TRACE
- Decomposição automática de issues grandes em subtarefas bot-ready
- Integração contínua e versionamento automático com merge de PRs
Veredito

DevLoop é uma solução robusta e opinativa para quem quer TDD real em produção com Claude Code. Exige compreensão profunda de arquitetura SDLC e workflows; altamente recomendado para equipes que priorizam qualidade de teste sobre velocidade superficial. Maduro, bem documentado e com marketplace próprio para extensões.
README
A tradução para o português deste README ainda está na fila.
devloop
TDD-driven SDLC toolchain for Claude Code. Skills, agents, hooks, and rules for development automation.
Install
Add the marketplace, then install:
/plugin marketplace add flavordrake/devloop
/plugin install devloop@flavordrake
Or load locally for development:
git clone https://github.com/flavordrake/devloop.git
claude --plugin-dir ./devloop
When installed via marketplace, skills are namespaced: /devloop:cycle, /devloop:develop, etc.
When loaded via --plugin-dir, skills register without prefix: /cycle, /develop, etc.
Marketplace
This repo is both a plugin and a marketplace. The marketplace catalog at .claude-plugin/marketplace.json lists all available plugins. Third-party authors can submit plugins by PR — add an entry to the plugins array with a source pointing to your GitHub repo.
Skills
| Skill | Purpose |
|---|---|
/devloop:cycle | One pump of the SDLC loop — discover, classify, develop, gate |
/devloop:develop | Implement an issue (Phase 2 of TDD) |
/devloop:write-tests | Write tests from spec (Phase 1 of TDD) |
/devloop:integrate | Review, gate, merge bot PRs |
/devloop:delegate | Classify and dispatch issues to bot agents |
/devloop:decompose | Break large issues into bot-sized sub-issues |
/devloop:issue | File a GitHub issue from conversation |
/devloop:release | Version bump, changelog, tag, publish |
/devloop:agent-trace | TRACE protocol for capturing development arcs |
Hooks
Installed automatically with the plugin:
- enforce-hygiene (PreToolUse:Bash) — detects compound chains, redirects, heredocs, raw CLI calls
- trace-signal (PostToolUse:Write/Edit) — reminds to update TRACE when decision-signal paths change
- trace-checkpoint (PostToolUse:Bash) — fires on commits, deploys, gh-ops
- trace-gh-ops (PostToolUse:Bash) — logs GitHub operations to active TRACE
- trace-session-start (SessionStart) — checks TRACE status on session begin
- trace-pre-compact (PreCompact) — checkpoints before context compression
- trace-agent-spawn (SubagentStart) — logs agent spawns
Rules
Core rules (stack-agnostic):
| Rule | Key insight |
|---|---|
| command-hygiene | One script per Bash call — chains cause false positive failures |
| tdd | Two agents: test writer (red) then developer (green) |
| decomposition | Sequential A→B→C for coupled refactors |
| state-management | Explicit lifecycle enums, not boolean combinations |
| hooks-and-cwd | Absolute paths for hooks, CWD drift resilience |
| agents | Permissions flow via settings.json allow-list |
| workflow | Fix the process not the symptom |
| security | No plaintext secrets, block don't fallback |
| know-when-to-quit | Recognize divergent fix cycles and stop early |
Platform-specific (in rules/platform/, opt-in):
- mobile-touch — textarea swipe constraints, touch-action patterns
Project Permissions
The plugin provides hooks and skills but cannot distribute permissions. Run the merge script to add recommended permissions to your project:
./devloop/scripts/merge-settings.sh /path/to/project/.claude/settings.json
This uses jq to merge devloop's recommended permissions into your existing settings — non-destructive, only adds, never removes.
Structure
.claude-plugin/
plugin.json Plugin manifest
marketplace.json Marketplace catalog
hooks.json Hook wiring (uses ${CLAUDE_PLUGIN_ROOT})
skills/ SDLC skills (SKILL.md per directory)
agents/ Agent prompt templates
hooks/ Shell hook scripts
scripts/ Helper scripts (merge-settings, trace utils)
rules/ Core rules (stack-agnostic)
platform/ Platform-specific rules (opt-in)
Design Principles
- Stack-agnostic core: Rules and skills work for any language/framework
- Platform specializations:
rules/platform/for mobile, embedded, etc. - Convention-based: Skills expect
scripts/test-gate.shetc. by convention - Proper plugin: Uses Claude Code plugin system, not symlinks