convez.ai
AgenteDesenvolvimento WebIntermediário
federicopinan

Claude Code Workspace

federicopinan/claude-code-workspace

Template monorepo para projetos com Claude Code e SDD

Ver no GitHub
InicialPluginScore · de 0 a 100

Template reutilizável para desenvolver aplicações com Claude Code, contexto persistente e Spec-Driven Development (SDD). Fornece estrutura monorepo, stack moderno (Next.js, React, TypeScript) e automação de workflows para acelerar projetos iniciais com IA.

Instalação

$npx convez-ai federicopinan/claude-code-workspace

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 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Iniciar novos projetos full-stack com estrutura pronta
  • Implementar Spec-Driven Development com agentes de IA
  • Manter contexto persistente entre sessões do Claude
  • Padronizar arquitetura e convenções em equipes

Veredito

Solução bem estruturada para quem quer acelerar projetos full-stack com Claude Code, mas requer familiaridade com TypeScript/Next.js e SDD. Funciona melhor em equipes que adotam fluxo spec-driven.

README

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

Workspace Template — Development Environment

Template reutilizable para desarrollar aplicaciones con Claude Code, contexto persistente y Spec-Driven Development (SDD).

Empezar

# Clonar el template
git clone https://github.com/federicopinan/claude-code-workspace.git mi-proyecto
cd mi-proyecto

# Instalar dependencias y validar estructura
npm run setup

# Iniciar Claude con contexto
claude --dangerously-skip-permissions /iniciar

Estructura

apps/              # Aplicaciones individuales
packages/          # Paquetes compartidos (UI, utils, types)
referencia/        # Patrones de referencia
  diseno/          # UI/UX patterns
  codigo/          # Arquitectura y código
  seguridad/       # OWASP, headers, vulnerabilidades
contexto/          # Contexto del proyecto actual
skills/            # Skills disponibles para este workspace
infraestructura/   # Terraform, Docker, CI/CD
planes/            # Planes de implementación
salidas/           # Entregables y reportes
scripts/           # Automatización

Comandos del Template

ComandoQué valida o ejecuta
npm run setupInstala dependencias y valida la estructura del template
npm run checkEjecuta validación estructural, lint/typecheck y tests
npm run check:templateVerifica archivos críticos, carpetas esperadas y branding limpio
npm run format:checkVerifica formato con Prettier
npm run formatFormatea el ejemplo con Prettier
npm run new:app -- mi-appCrea una app nueva desde apps/mi-primer-app

Stack Sugerido

CapaTecnología
FrontendNext.js 16 + React 19 + shadcn/ui + Tailwind
EstadoZustand (client) + React Query (server)
BackendNext.js API Routes / Hono
ORMDrizzle / Prisma
AuthClerk / NextAuth
DBPostgreSQL (Vercel Postgres / Neon)
DeployVercel

Workflow SDD

proposal → specs → design → tasks → apply → verify → archive

Para iniciar un nuevo cambio:

/sdd-new mi-nuevo-feature

Ver un ejemplo completo en docs/sdd-example/.

Convenciones

  • TypeScript strict mode
  • Conventional commits (feat:, fix:, docs:, etc.)
  • Tests cerca del código: Component.test.tsx
  • Coverage mínimo: 80%
  • Validar el template con npm run check antes de publicarlo

Recursos


Última actualización: 2026-05-18

Ver o original no GitHub

Bom para

Relacionados