convez.ai
AgenteProdutividadeIntermediário
guigeo

Claude Project Template — AgentSpec 4.2

guigeo/claude-project-template-sdd-agent-spec

Framework SDD com agentes reutilizáveis para brainstorm até ship

Ver no GitHub
InicialPluginScore · de 0 a 100

Template completo para projetos com Spec-Driven Development (SDD) e Claude Code, incluindo 30+ agentes pré-configurados para workflow, qualidade de código, comunicação e domínios específicos (AWS, Data Engineering). Suporta cópia seletiva via catalog.yaml, sincronização de conhecimento e ciclo de vida completo do projeto.

Instalação

$npx convez-ai guigeo/claude-project-template-sdd-agent-spec

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á 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar novos projetos com stack selecionado automaticamente
  • Padronizar workflow de desenvolvimento com fases SDD (brainstorm → ship)
  • Reutilizar Knowledge Bases centralizadas entre projetos
  • Gerar especificações, designs e código com agentes especializados
  • Manter qualidade com agentes de review, testing e limpeza

Veredito

Template robusto e bem estruturado para times que adotam SDD com Claude. A modularidade via catalog.yaml e o suporte a domínios específicos (AWS, Spark) o tornam escalável, mas exige disciplina para manter KBs atualizadas e agentes sincronizados entre projetos.

README

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

Claude Project Template — AgentSpec 4.2

Template de projeto com o framework AgentSpec 4.2 (Spec-Driven Development) pré-configurado para Claude Code. Abra no Claude Code, rode /new-project e comece a codar com KBs e agentes selecionados pelo seu stack.


O que está incluído

.claude/
├── agents/
│   ├── workflow/           # 6 agentes SDD (brainstorm → ship)
│   ├── code-quality/       # 6 agentes de qualidade (reviewer, cleaner, test-generator...)
│   ├── communication/      # 3 agentes (explainer, meeting-analyst, planner)
│   ├── exploration/        # 2 agentes (codebase-explorer, kb-architect)
│   ├── ai-ml/              # 4 agentes de LLM e AI
│   ├── dev/                # 2 agentes do Dev Loop
│   ├── aws/                # 4 agentes AWS (opcional)
│   ├── data-engineering/   # 8 agentes Spark/Databricks (opcional)
│   └── domain/             # Vazio — agentes do projeto criados por /new-project ou /project-init
├── commands/               # Slash commands na raiz (invocação por nome pelado: /brainstorm, /distill…)
│   ├── brainstorm.md, define.md, design.md, build.md, ship.md, iterate.md   # workflow SDD
│   ├── new-project.md, adopt.md, project-init.md, contribute.md, distill.md  # ciclo template↔filho
│   ├── create-kb.md, review.md, create-pr.md, dev.md                        # KB, review, dev loop
│   └── sync-context.md, memory.md, readme-maker.md, telemetry.md            # utilitários
├── sdd/                    # Framework SDD: templates, exemplos, contratos
├── dev/                    # Dev Loop: templates de PROMPT
└── kb/                     # Knowledge Base: acervo central reaproveitável + templates
catalog.yaml                # Catálogo de componentes (metadados para cópia seletiva)
setup.sh                    # Fallback de criação de projeto (copia tudo)

Criar um novo projeto

Opção A — /new-project (recomendado: cópia seletiva)

Abra este repositório no Claude Code e rode:

/new-project meu-projeto /Users/joao/Projetos

O comando faz a entrevista de 6 perguntas antes de copiar e então:

  • Seleciona via catalog.yaml só os agentes que casam com seu stack (um projeto Next.js não recebe os agentes Spark/AWS)
  • Copia as KBs do acervo central que se aplicam; se faltar alguma, propõe criar — a KB nova fica no template e é reaproveitada nos próximos projetos
  • Cria os agentes de domínio do projeto, preenche o CLAUDE.md e grava o vínculo de versão em .claude/template-link.yaml

Opção B — setup.sh (fallback: copia tudo)

./setup.sh <nome-do-projeto> [diretorio-destino]

# Exemplos:
./setup.sh minha-api
./setup.sh meu-saas /Users/joao/Projetos

Depois, dentro do projeto criado, rode /project-init — entrevista de 6 perguntas que instala KBs (localmente), cria agentes de domínio e preenche o CLAUDE.md.

Em ambos os casos, na sequência

/sync-context      # gera a seção de Arquitetura após adicionar código-fonte
/brainstorm "..."  # explore a ideia da primeira feature
/define "..."      # ou vá direto para requisitos

Workflow SDD — AgentSpec 4.2

/brainstorm → /define → /design → /build → /ship
  (Opus)      (Opus)    (Opus)   (Sonnet)  (Haiku)
FaseComandoGera
0 (opcional)/brainstormBRAINSTORM_*.md
1/defineDEFINE_*.md
2/designDESIGN_*.md
3/buildCódigo + BUILD_REPORT_*.md
4/shipSHIPPED_*.md em archive/

Artefatos em .claude/sdd/features/ e .claude/sdd/archive/.


Dev Loop (Desenvolvimento Agentico Nível 2)

Para features isoladas, utilitários e KBs — sem o overhead do SDD completo:

/dev "Quero construir X"              # O crafter te guia
/dev tasks/PROMPT_FEATURE.md          # Executa um PROMPT existente
/dev tasks/PROMPT_FEATURE.md --resume # Retoma sessão interrompida

MCPs recomendados (instalar uma vez, vale para todos os projetos)

# Context7 — documentação de bibliotecas em tempo real
claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp

# Ref Tools — busca em documentação técnica (requer login OAuth na primeira vez)
claude mcp add --scope user --transport http ref-tools-ref-tools-mcp https://api.ref.tools/mcp

Verificar MCPs instalados:

claude mcp list

Agentes disponíveis

CategoriaAgentesQuando usar
Workflowbrainstorm, define, design, build, ship, iterateConstruir features com SDD
Qualidadecode-reviewer, code-cleaner, test-generator, dual-reviewerRevisar e melhorar código
AI/MLllm-specialist, genai-architect, ai-prompt-specialistPrompts, sistemas de IA
Comunicaçãoadaptive-explainer, meeting-analyst, the-plannerExplicações, planejamento
Exploraçãocodebase-explorer, kb-architectExplorar repositório, criar KBs
AWSaws-lambda-architect, lambda-builder, aws-deployer, ci-cd-specialistProjetos serverless
Dadosmedallion-architect, lakeflow-architect, spark-specialist, ...Pipelines Databricks/Spark
Domíniocriados por /new-project ou /project-initEspecíficos do seu projeto

Quais agentes vão para cada projeto é decidido por catalog.yaml (campos scope/stacks/domains/clouds). O /new-project copia só os que casam com o stack declarado na entrevista.


Comandos disponíveis

ComandoPropósito
/new-projectNo template — entrevista + cópia seletiva via catalog.yaml (greenfield)
/adoptNo template — adota projeto existente (brownfield): detecta stack, entende, copia aditivo, vira filho
/distillNo projeto filho — destila aprendizado de feature shipada em KB generalizada
/contributeNo projeto filho — devolve KB/agente reaproveitável ao acervo do template
/project-initNo projeto filho (se criado via setup.sh) — KBs + agentes de domínio + CLAUDE.md
/brainstormExplorar ideias em diálogo
/defineCapturar e validar requisitos
/designCriar arquitetura técnica
/buildExecutar implementação
/shipArquivar feature concluída
/iterateAtualizar documentos mid-stream
/devDev Loop para iteração estruturada
/create-kbCriar domínio de knowledge base
/reviewRevisão de código
/create-prCriar pull request
/memorySalvar insights da sessão
/sync-contextAtualizar CLAUDE.md com contexto do projeto
/readme-makerGerar README completo
Ver o original no GitHub

Bom para

Relacionados