convez.ai
AgenteProdutividadeAvançado
jasoncychueh

Spec-Driven Development Plugin

jasoncychueh/claude-spec-driven-dev-plugin

Desenvolvimento spec-first com agentes, verificação e auditoria de decisões

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin para Claude Code que impõe disciplina de desenvolvimento orientado por especificações (spec-first). Estrutura documentos de direcionamento, especificações de features, verificação automatizada e implementação paralela via agentes com rastreamento de decisões em review logs.

Instalação

$npx convez-ai jasoncychueh/claude-spec-driven-dev-plugin

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 dias
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Garantir alinhamento entre requisitos, design e implementação antes de codificar
  • Coordenar desenvolvimento paralelo com múltiplos agentes via especificações
  • Rastrear decisões, waivers e feedback em audit trails estruturados
  • Validar completude de specs e coerência entre design e tarefas

Veredito

Plugin robusto para equipes que valorizam disciplina e rastreabilidade. A abordagem spec-first reduz retrabalho e alinha agentes, mas exige investimento inicial em documentação estruturada e é mais adequado para projetos complexos do que para prototipagem rápida.

README

A tradução para o português deste README ainda está na fila.

Spec-Driven Development Plugin

Claude Code plugin for spec-driven development workflow. Enforces "no spec, no code" discipline with structured steering documents, feature specs, verification, and agent-based implementation.

Features

  • Steering Documents: Project-level guidance (product vision, tech stack, code structure)
  • Feature Specs: Requirements, design, tasks, and review-log per feature
  • Automated Verification: Spec completeness and tasks-design alignment checks
  • Agent-Based Implementation: Parallel implementation with cross-agent review
  • Review Log Discipline: Waivers / Decisions / round-by-round audit trail live in review-log.md; formal docs (requirements / design / tasks / code) stay clean
  • Living Steering: review loops surface unrecorded project principles as steering candidates; user-confirmed updates flow back into steering docs as development progresses
  • Brief Before Build: before implementation starts, a conversational summary of key points, resolved decisions, and waivers gets the user oriented without reading the full spec — cheapest moment to catch misunderstandings

Commands

CommandDescription
/create-steeringCreate project steering documents
/create-spec <feature>Create feature spec (requirements, design, tasks)
/load-spec <feature>Load spec and show progress
/update-steering <type>Update steering document (product/tech/structure)
/update-spec <feature>Update feature spec
/verify-spec <feature>Verify spec completeness + tasks-design alignment
/implement <feature>Start implementation via agents

Agents

AgentRole
spec-researcherResearch existing solutions before design
spec-verifierVerify spec file completeness
tasks-design-verifierVerify tasks-design alignment
design-reviewerMulti-round design review until 0 issues (review only)
spec-implementerImplement code per spec
implementation-reviewerMulti-round implementation review until 0 issues (review only)

Hooks

HookPurpose
PreToolUse on ExitPlanModeInjects a reminder that the Plan Briefing checkpoint (briefing text + AskUserQuestion stop) is mandatory in Quick Fix Mode — never blocks the call

Hooks load at session start — after installing or updating the plugin, restart the Claude Code session for hooks to take effect.

Installation

From GitHub (recommended)

Run these inside Claude Code. The first command registers this repo as a plugin marketplace (defined by .claude-plugin/marketplace.json); the second installs the plugin from it:

/plugin marketplace add jasoncychueh/claude-spec-driven-dev-plugin
/plugin install spec-driven-development@claude-spec-driven-dev-plugin

spec-driven-development is the plugin name; claude-spec-driven-dev-plugin is the marketplace name. They differ — keep both in the plugin@marketplace argument.

You can also install interactively by running /plugin, then choosing claude-spec-driven-dev-plugin → spec-driven-development.

/plugin marketplace add also accepts a full git URL if you prefer:

/plugin marketplace add https://github.com/jasoncychueh/claude-spec-driven-dev-plugin.git

From a local clone (development)

git clone https://github.com/jasoncychueh/claude-spec-driven-dev-plugin.git

Then point the marketplace at the local path and install:

/plugin marketplace add path/to/claude-spec-driven-dev-plugin
/plugin install spec-driven-development@claude-spec-driven-dev-plugin

Core Principles

  1. No Steering, No Development
  2. No Spec, No Code
  3. Research Before Design
  4. Design is Truth (design.md is the single source of truth)
  5. Steering Stays Current
  6. Self-Verify
  7. Verify Before Deliver
Ver o original no GitHub

Bom para

Relacionados