Inicio Rapido¶
En 10 minutos tendras el marketplace de Inteliside corriendo: plugins instalados, prerequisitos configurados, y tu primer flujo ejecutado.
Si eres un humano: sigue los pasos en orden. Cada seccion indica que instalar y como verificar que funciona.
Si eres un agente de IA: los comandos estan listos para copiar-pegar. Las verificaciones te indican el output esperado. Si algo falla, las notas de troubleshooting explican como resolverlo.
Prerequisitos¶
| Herramienta | Version minima | Obligatorio para | Instalacion |
|---|---|---|---|
| Claude Code | Ultima | Todos los plugins | npm install -g @anthropic-ai/claude-code |
| Node.js | 18+ | Claude Code | nodejs.org |
GitHub CLI (gh) |
Ultima | SDD-Wizards, ATL, SDD-Legacy, RE-Wizard, SDD-Intake | Ver seccion siguiente |
| Engram | Ultima | ATL, UX Studio, SDD-Legacy, RE-Wizard, SDD-Intake | Ver seccion siguiente |
| Pencil MCP | Incluido en Claude | UX Studio | No requiere instalacion |
| Chrome DevTools MCP | Ultima | UX Studio (research, opcional) | Configuracion en settings |
| n8n MCP | Ultima | n8n Studio | Configuracion MCP remoto |
Instalacion del Marketplace¶
Paso 1: Instalar Claude Code¶
npm install -g @anthropic-ai/claude-code
Verificar:
claude --version
Paso 2: Instalar GitHub CLI¶
macOS:
brew install gh
gh auth login
Linux (Debian/Ubuntu):
sudo apt install gh
gh auth login
Windows:
winget install GitHub.cli
gh auth login
Verificar:
gh auth status
Debe mostrar el usuario autenticado y scope repo.
Paso 3: Instalar Engram¶
macOS/Linux (Homebrew):
brew install gentleman-programming/tap/engram
macOS/Linux (desde fuente, requiere Go 1.25+):
git clone https://github.com/Gentleman-Programming/engram.git
cd engram && go install ./cmd/engram
Windows (binario):
- Descargar desde github.com/Gentleman-Programming/engram/releases
- Extraer y agregar al PATH
Verificar:
engram version
Conectar Engram con Claude Code:
claude plugin marketplace add Gentleman-Programming/engram
claude plugin install engram
Paso 4: Agregar el marketplace de Inteliside¶
/plugin marketplace add Intelliaa/marketplace-plugins-inteliside
Paso 5: Instalar los plugins que necesites¶
# SDD-Wizards (PM — levantamiento de requerimientos)
/plugin install sdd-wizards@marketplace-plugins-inteliside
# UX Studio (Designer/PM — diseno UI/UX)
/plugin install ux-studio@marketplace-plugins-inteliside
# ATL Inteliside (Dev — implementacion de features)
/plugin install atl-inteliside@marketplace-plugins-inteliside
# SDD Legacy (onboarding de proyectos existentes)
/plugin install sdd-legacy@marketplace-plugins-inteliside
# RE-Wizard (ingenieria inversa de codebases)
/plugin install re-wizard@marketplace-plugins-inteliside
# SDD-Intake (requerimientos de clientes sobre proyectos existentes)
/plugin install sdd-intake@marketplace-plugins-inteliside
# n8n Studio (automatizacion de workflows n8n)
/plugin install n8n-studio@marketplace-plugins-inteliside
# Sales Engine (ventas B2B automatizadas)
/plugin install sales-engine@marketplace-plugins-inteliside
Configuracion del Proyecto¶
Copiar templates al proyecto¶
# Copiar CLAUDE.md para el dev (ATL) a la raiz del proyecto
cp templates/CLAUDE.md ./CLAUDE.md
# Copiar CLAUDE.md para PM y Designer
cp -r templates/docs/ ./docs/
# Copiar rules de ATL
cp -r plugins/atl-inteliside/examples/.claude/ ./.claude/
Completar CLAUDE.md¶
Abrir CLAUDE.md y completar los placeholders:
## ATL Inteliside
engram_project: "nombre-proyecto-dev" # Mismo valor para TODO el equipo
github_owner: "tu-org-o-usuario"
github_repo: "nombre-repo"
Crear labels en GitHub¶
Ejecutar una sola vez por repositorio:
# Labels de SDD-Wizards
gh label create "prd" --color "0075ca" --description "Product Requirements Document" 2>/dev/null || true
gh label create "feature-spec" --color "1d76db" --description "Feature Specification" 2>/dev/null || true
gh label create "milestone-spec" --color "d876e3" --description "Milestone tracking" 2>/dev/null || true
gh label create "atl-ready" --color "0e8a16" --description "Feature lista para ATL" 2>/dev/null || true
# Labels de ATL Inteliside
gh label create "atl-task" --color "0075ca" --description "Task generada por ATL Inteliside" 2>/dev/null || true
gh label create "area:backend" --color "e4e669" --description "Backend/services" 2>/dev/null || true
gh label create "area:frontend" --color "d93f0b" --description "Frontend/UI" 2>/dev/null || true
gh label create "area:db" --color "0e8a16" --description "Database/migrations" 2>/dev/null || true
gh label create "area:test" --color "5319e7" --description "Testing" 2>/dev/null || true
gh label create "atl:pending" --color "ededed" --description "Not yet implemented" 2>/dev/null || true
gh label create "atl:in-progress" --color "fbca04" --description "In active development" 2>/dev/null || true
gh label create "atl:done" --color "0e8a16" --description "Implemented & verified" 2>/dev/null || true
gh label create "atl-summary" --color "cfd3d7" --description "Resumen de la feature" 2>/dev/null || true
Nota: Los plugins SDD-Wizards, SDD-Legacy y RE-Wizard tambien crean estos labels automaticamente durante su ejecucion. El comando anterior es para asegurar que estan listos antes del primer uso.
Estructura resultante en el proyecto¶
proyecto/
├── CLAUDE.md ← Dev (ATL) — raiz del repo
├── .claude/rules/ ← Rules de ATL
├── docs/
│ ├── CLAUDE.md ← PM (SDD-Wizards / SDD-Legacy)
│ └── ux-ui/
│ └── CLAUDE.md ← Designer (UX Studio)
└── src/ ← codigo del proyecto
Donde ejecuta cada rol¶
| Rol | Directorio | CLAUDE.md que carga | Comando |
|---|---|---|---|
| PM | docs/ |
docs/CLAUDE.md + hereda ./CLAUDE.md |
cd docs && claude |
| Designer | docs/ux-ui/ |
docs/ux-ui/CLAUDE.md + hereda padres |
cd docs/ux-ui && claude |
| Dev | / (raiz) |
./CLAUDE.md |
claude |
Tu Primer Flujo¶
Este ejemplo cubre el flujo mas comun: crear un PRD y detallar una feature con SDD-Wizards. En 5 minutos tendras un milestone en GitHub listo para que ATL lo implemente.
Paso 1: Crear el PRD¶
Abrir una conversacion nueva con SDD-Wizards:
claude --plugin-dir ./plugins/sdd-wizards
Ejecutar el wizard:
/sdd-wizards:prd-wizard mi-producto
Claude guiara una conversacion de 10 fases: - Fases 1-6 (negocio): Claude pregunta sobre el problema, usuarios, user stories, alcance, metricas y riesgos. Tu respondes. - Fases 7-10 (auto-tecnicas): Claude genera data model, API, arquitectura y sube todo a GitHub. Tu confirmas.
Resultado: archivo PRD-Mi-Producto.md generado, repo creado en GitHub con Project y labels.
Paso 2: Detallar una Feature¶
Abrir una conversacion nueva (una por feature):
claude --plugin-dir ./plugins/sdd-wizards
Ejecutar el wizard:
/sdd-wizards:feature-spec-wizard user-auth
Claude guiara la definicion de User Stories, Acceptance Criteria, Business Rules, UI behavior, Data Model y API Spec.
Resultado: milestone feat-user-auth creado en GitHub con el Feature Spec completo.
Paso 3: Implementar con ATL (opcional)¶
El dev toma el milestone directamente:
claude --plugin-dir ./plugins/atl-inteliside
/atl-inteliside:orchestrador feat-user-auth
ATL ejecuta el pipeline completo: spec tecnica, tests, implementacion TDD, verificacion y cierre automatico.
Stacks Disponibles¶
| Stack | Para quien | Plugins que necesitas | Comando de instalacion (local) |
|---|---|---|---|
| PM | Product Manager | sdd-wizards | claude --plugin-dir ./plugins/sdd-wizards |
| PM + Designer | PM + UX Designer | sdd-wizards + ux-studio | claude --plugin-dir ./plugins/sdd-wizards --plugin-dir ./plugins/ux-studio |
| Full (PM + Designer + Dev) | Equipo completo | sdd-wizards + ux-studio + atl-inteliside | claude --plugin-dir ./plugins/sdd-wizards --plugin-dir ./plugins/ux-studio --plugin-dir ./plugins/atl-inteliside |
| Dev | Equipo de desarrollo | atl-inteliside | claude --plugin-dir ./plugins/atl-inteliside |
| Legacy | Onboarding de proyectos existentes | sdd-legacy + atl-inteliside | claude --plugin-dir ./plugins/sdd-legacy --plugin-dir ./plugins/atl-inteliside |
| Ingenieria inversa | Analisis de codebases | re-wizard + atl-inteliside | claude --plugin-dir ./plugins/re-wizard --plugin-dir ./plugins/atl-inteliside |
| Intake | Requerimientos de clientes | sdd-intake + atl-inteliside | claude --plugin-dir ./plugins/sdd-intake --plugin-dir ./plugins/atl-inteliside |
| Automatizacion | Workflows n8n | n8n-studio | claude --plugin-dir ./plugins/n8n-studio |
| Ventas | Ventas B2B | sales-engine | claude --plugin-dir ./plugins/sales-engine |
Prerequisitos por stack¶
| Stack | Claude Code | gh CLI | Engram | Pencil MCP | n8n MCP |
|---|---|---|---|---|---|
| PM | Si | Si | Recomendado | No | No |
| PM + Designer | Si | Si | Si | Si (incluido) | No |
| Full | Si | Si | Si | Si (incluido) | No |
| Dev | Si | Si | Si | No | No |
| Legacy | Si | Si | Si | No | No |
| Ingenieria inversa | Si | Si (Phase 4) | Si | No | No |
| Intake | Si | Si | Si (obligatorio) | No | No |
| Automatizacion | Si | No | Si | No | Si |
| Ventas | Si | No | No | No | No |
Siguientes Pasos¶
Documentacion de plugins¶
| Plugin | Documentacion | Skills principales |
|---|---|---|
| SDD-Wizards | Levantamiento de requerimientos | /sdd-wizards:prd-wizard, /sdd-wizards:feature-spec-wizard |
| ATL Inteliside | Implementacion de features | /atl-inteliside:orchestrador |
| UX Studio | Diseno UI/UX | /ux-studio:ux-discovery, /ux-studio:ux-orchestrator |
| SDD-Legacy | Onboarding de proyectos legacy | /sdd-legacy:legacy-audit-wizard |
| RE-Wizard | Ingenieria inversa | /reverse-engineer |
| SDD-Intake | Requerimientos de clientes | /sdd-intake:client-intake-wizard |
| n8n Studio | Automatizacion n8n | /n8n-studio:automation-wizard |
| Sales Engine | Ventas B2B | /sales-engine:sales-coach |
Flujos de trabajo completos¶
| Flujo | Descripcion | Documentacion |
|---|---|---|
| PM a Dev | Desde idea hasta feature implementada | flujos/pm-a-dev.md |
| Onboarding Legacy | Proyecto existente listo para SDD | flujos/onboarding-legacy.md |
| Ingenieria Inversa | Codebase externo a Feature Specs | flujos/ingenieria-inversa.md |
Contratos de datos¶
| Contrato | Que describe |
|---|---|
| Engram | Esquema de memoria persistente unificado |
| GitHub | Esquema de GitHub Projects unificado |
Compartir memoria Engram entre devs¶
Para equipos multiples devs, configurar sincronizacion:
Opcion A — Git Sync (sin servidor):
engram sync --project "nombre-proyecto-dev"
git add .engram/sync/
git commit -m "chore: sync engram memories"
git push
Opcion B — Cloud Sync (servidor Engram):
engram cloud register --server https://tu-servidor.com
engram cloud enroll "nombre-proyecto-dev"
engram cloud sync
Ver instrucciones completas en el repositorio del marketplace.
Inicio Rapido — Marketplace Inteliside v1.1.0