Claude Code Workspace
federicopinan/claude-code-workspace
Template monorepo para projetos com Claude Code e SDD
Ver no GitHubTemplate 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-workspace1 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
- 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
| Comando | Qué valida o ejecuta |
|---|---|
npm run setup | Instala dependencias y valida la estructura del template |
npm run check | Ejecuta validación estructural, lint/typecheck y tests |
npm run check:template | Verifica archivos críticos, carpetas esperadas y branding limpio |
npm run format:check | Verifica formato con Prettier |
npm run format | Formatea el ejemplo con Prettier |
npm run new:app -- mi-app | Crea una app nueva desde apps/mi-primer-app |
Stack Sugerido
| Capa | Tecnología |
|---|---|
| Frontend | Next.js 16 + React 19 + shadcn/ui + Tailwind |
| Estado | Zustand (client) + React Query (server) |
| Backend | Next.js API Routes / Hono |
| ORM | Drizzle / Prisma |
| Auth | Clerk / NextAuth |
| DB | PostgreSQL (Vercel Postgres / Neon) |
| Deploy | Vercel |
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 checkantes de publicarlo
Recursos
Última actualización: 2026-05-18