Arquitectura del Marketplace¶

El Marketplace Inteliside es un ecosistema de 10 plugins para Claude Code que cubren el ciclo completo de desarrollo de software: desde la idea inicial hasta el codigo en produccion, pasando por diseno UI/UX, ingenieria inversa, automatizacion de procesos y ventas B2B. Los plugins se comunican entre si a traves de dos canales compartidos: Engram (memoria persistente) como bus de datos semantico y GitHub Projects (milestones, issues, labels) como backlog operativo. Cada plugin produce artefactos con schemas fijos que el siguiente plugin consume de forma determinista, lo que permite componer pipelines sin acoplamiento directo entre plugins.

Vision general¶

El marketplace funciona como una linea de ensamblaje donde cada plugin tiene una responsabilidad clara y produce artefactos estandarizados. El PM levanta requerimientos con SDD-Wizards y los entrega como Feature Specs en GitHub. El Designer toma esos specs y produce un Design Spec con UX Studio. El Dev implementa la feature completa con ATL Inteliside. A lo largo de todo el flujo, Engram actua como la memoria compartida del equipo: guarda decisiones de arquitectura, patrones de codigo, reglas de negocio y metricas que cada plugin puede consultar para enriquecer su trabajo. GitHub Projects actua como el tablero visible donde todos ven el estado de cada feature. Los plugins nunca se invocan entre si directamente; la comunicacion siempre es indirecta, a traves de artefactos en Engram y GitHub.

Mapa de plugins por rol¶

Cada rol del equipo tiene plugins especificos asignados. Un mismo plugin puede ser usado por varios roles, pero su funcion cambia segun quien lo invoca. El PM usa plugins de levantamiento de requerimientos y diseno; el Dev usa plugins de implementacion y analisis; Ops usa plugins de automatizacion y utilidades.

Rol	Plugins que usa	Que produce
PM	sdd-wizards, sdd-intake, ux-studio (discovery + PM review)	PRDs, Feature Specs, UX Briefs, aprobaciones de diseno
Designer	ux-studio	Design Research Report, Design Direction, Design Spec con tokens/motion/interactions/responsive
Dev	atl-inteliside, sdd-legacy, re-wizard	Codigo implementado con TDD, specs tecnicos, tests, Feature Specs desde legacy/RE
Ventas	sales-engine	Dossiers de leads, secuencias de outreach, propuestas comerciales, reportes de funnel
Ops	n8n-studio, cc-toolkit, doc-gen	Workflows n8n, auditorias de CLAUDE.md y plugins, documentacion automatizada

Flujo de datos entre plugins¶

El siguiente diagrama muestra como los artefactos fluyen entre plugins. Las flechas indican dependencia de datos: el plugin destino consume artefactos producidos por el plugin origen. GitHub Projects y Engram son los dos canales por donde viajan estos artefactos. Los plugins independientes (cc-toolkit, doc-gen, sales-engine, n8n-studio) no aparecen en el flujo principal porque operan de forma autonoma.

graph LR
    subgraph "Levantamiento de requerimientos"
        SDD_W[sdd-wizards]
        SDD_I[sdd-intake]
        SDD_L[sdd-legacy]
        RE_W[re-wizard]
    end

    subgraph "Diseno"
        UX[ux-studio]
    end

    subgraph "Implementacion"
        ATL[atl-inteliside]
    end

    subgraph "Canales compartidos"
        GH[(GitHub Projects<br/>milestones + issues)]
        ENG[(Engram<br/>memoria persistente)]
    end

    SDD_W -->|Feature Spec<br/>milestone + issue| GH
    SDD_W -->|project/prd<br/>project/features/*| ENG

    SDD_I -->|Feature Spec<br/>milestone + issue| GH
    SDD_I -->|sdd/*/feature-spec| ENG
    ENG -->|legacy/*, team/*<br/>project/*| SDD_I

    SDD_L -->|Feature Spec<br/>milestone + issue| GH
    SDD_L -->|legacy/*, project/*| ENG

    RE_W -->|Feature Spec<br/>milestone + issue| GH
    RE_W -->|project/features/*<br/>re-wizard/*| ENG

    UX -->|Design Spec<br/>label design-ready| GH
    UX -->|ux-studio/*| ENG
    ENG -->|project/prd| UX

    GH -->|milestone<br/>feat-*| ATL
    ENG -->|project/*, sdd/*<br/>team/*| ATL
    ATL -->|issues cerrados<br/>milestone cerrado| GH
    ATL -->|team/decisions/*<br/>team/patterns/*<br/>team/bugs/*| ENG

Lectura del diagrama: - SDD-Wizards produce Feature Specs como milestones en GitHub y guarda PRD/features en Engram. - SDD-Intake lee contexto acumulado de Engram (de SDD-Legacy y ATL) y produce Feature Specs identicos a SDD-Wizards. - SDD-Legacy escanea proyectos existentes y produce Feature Specs + contexto legacy en Engram. - RE-Wizard analiza codebases externos y produce Feature Specs + documentacion de ingenieria inversa. - UX-Studio toma el PRD de Engram, produce Design Spec y marca el issue como design-ready en GitHub. - ATL Inteliside consume milestones de GitHub, implementa con TDD, y devuelve conocimiento al equipo via Engram.

Engram como bus de datos¶

Engram es el sistema de memoria persistente que conecta a todos los plugins del ecosistema. Funciona como un bus de datos semantico donde cada plugin escribe artefactos con topic keys predefinidos y otros plugins los leen cuando los necesitan. No hay invocaciones directas entre plugins: la comunicacion es siempre a traves de Engram. Cada proyecto configura un engram_project compartido por todos los plugins, con sub-proyectos para pipelines efimeros (como {proyecto}/atl para el pipeline activo de ATL).

Plugin	Proyecto Engram	Escribe	Lee
sdd-wizards	`{proyecto}-dev`	`project/prd`, `project/stack`, `project/features/`, `project/features-index`, `project/github-context`, `project/handoff/`	(no lee de otros plugins)
atl-inteliside	`{proyecto}-dev` (equipo) + `{proyecto}-dev/atl` (pipeline)	`team/decisions/`, `team/patterns/`, `team/bugs/`, `team/completed/`, `sdd/{feature}/*`, `project/github-context`, `project/config`	`project/features/`, `project/stack`, `project/github-context`, `sdd/{feature}/`, `team/*`
ux-studio	`{proyecto}-dev`	`ux-studio/research-report`, `ux-studio/ux-brief`, `ux-studio/design-direction`, `ux-studio/design-prompts`, `ux-studio/pen-files`, `ux-studio/design-review`, `ux-studio/pm-selections`, `ux-studio/design-spec`	`project/prd` (de sdd-wizards)
sdd-intake	`{proyecto}-dev`	`intake/{feature}/enrichment`, `sdd/{feature}/feature-spec`, `project/github-context`	`legacy/`, `team/`, `project/*` (de sdd-legacy y ATL)
sdd-legacy	`{proyecto}-dev`	`legacy/audit`, `legacy/stack`, `legacy/health-score`, `legacy/features/`, `legacy/features-index`, `legacy/prd`, `legacy/rules/`, `legacy/conventions`, `legacy/baseline`, `legacy/onboard-status`, `project/github-context`, `project/config`	(lee su propio estado entre fases)
re-wizard	`{proyecto}-dev`	`re-wizard/{id}/`, `project/features/`, `project/features-index`, `project/github-context`, `project/stack`	(lee su propio estado entre fases)
n8n-studio	`{proyecto}-n8n`	`pipeline/`, `patterns/`	`pipeline/*` (su propio estado)
sales-engine	`{empresa}-sales`	Patrones de outreach, datos de prospectos	Patrones previos
cc-toolkit	(no usa Engram)	-	-
doc-gen	(oportunista)	-	Decisiones y convenciones si Engram esta configurado

GitHub Projects como backlog¶

GitHub Projects es el sistema de trabajo compartido visible para todo el equipo. Los plugins de levantamiento (SDD-Wizards, SDD-Intake, SDD-Legacy, RE-Wizard) crean milestones con Feature Specs como descripcion. ATL Inteliside consume esos milestones y crea issues de tasks debajo. UX-Studio agrega informacion de diseno a los issues existentes. Todos los plugins usan el mismo esquema de labels para garantizar interoperabilidad.

Plugin	Que crea en GitHub	Que consume de GitHub
sdd-wizards	Repositorio (si no existe), GitHub Project, PRD Issue, milestones `feat-*`, issues con labels `feature-spec` + `atl-ready`, 13 labels (4 SDD + 9 ATL anticipados)	-
atl-inteliside	Issues `task: [area] [nombre]` bajo milestone, labels `atl-task`, `area:`, `atl:`, cierre de issues y milestones	Milestones `feat-*` con Feature Spec en descripcion
ux-studio	Seccion `## Design References` en issue existente, label `design-ready`	Milestone `feat-*` e issue con label `feature-spec`
sdd-intake	Milestones `feat-*`, issues con labels `feature-spec` + `atl-ready`	`project/github-context` de Engram
sdd-legacy	Labels, milestones `feat-*`, issues Feature Spec, GitHub Project (detectado o creado)	Repositorio existente via `git config`
re-wizard	Labels `feature-spec` + `atl-ready` + `re-wizard`, milestones `feat-*`, issues con Feature Spec	-
n8n-studio	-	-
sales-engine	-	-
cc-toolkit	-	-
doc-gen	-	Git history para changelogs (via `gh` CLI)

Dependencias entre plugins¶

La siguiente tabla muestra las dependencias reales entre plugins. "Requiere" significa que el plugin no puede funcionar sin el otro. "Opcional" significa que funciona sin el, pero con funcionalidad reducida. "Produce para" indica que plugins consumen los artefactos que este genera.

Plugin	Requiere	Opcional	Produce para
sdd-wizards	-	Engram (continuation mode y handoff automatico)	atl-inteliside, ux-studio, sdd-intake
atl-inteliside	Engram, GitHub CLI	ux-studio (Design Spec)	sdd-intake (team knowledge), doc-gen
ux-studio	Pencil MCP	sdd-wizards (PRD), Chrome DevTools MCP, Engram	atl-inteliside (Design Spec)
sdd-intake	Engram (con contexto previo), GitHub CLI	-	atl-inteliside
sdd-legacy	GitHub CLI, Engram	-	atl-inteliside, sdd-intake
re-wizard	Acceso al codebase	Engram, GitHub CLI, atl-inteliside	atl-inteliside
n8n-studio	n8n MCP	Engram	sales-engine (workflows)
sales-engine	Twenty CRM, n8n (5 workflows), Instantly, Engram	Apollo, LinkedIn Sales Navigator	-
cc-toolkit	-	-	-
doc-gen	-	Engram, GitHub CLI	-

Plugins independientes¶

Los siguientes plugins funcionan de forma completamente autonoma, sin depender de otros plugins del marketplace ni producir artefactos que otros consuman en el flujo principal. Pueden usarse en cualquier proyecto sin necesidad de instalar el ecosistema completo.

cc-toolkit -- Utilidades de desarrollo para Claude Code: auditar CLAUDE.md, crear componentes (skills, subagentes, hooks, plugins, marketplaces) y auditar plugins contra best practices de Anthropic. No usa Engram, no usa GitHub, no tiene dependencias externas.
doc-gen -- Documentacion automatizada dual (humano + agente IA). Detecta el tipo de proyecto, audita docs existentes, y genera o actualiza documentacion. Usa Engram y GitHub de forma oportunista pero funciona sin ellos. Se complementa con cualquier plugin del ecosistema pero no depende de ninguno.
sales-engine -- Motor de ventas B2B con 6 skills especializados. Opera en un dominio completamente distinto (ventas, no desarrollo). Requiere infraestructura propia (Twenty CRM, n8n, Instantly) pero no depende de ningun otro plugin del marketplace. Usa n8n-studio solo para construir sus 5 workflows iniciales.
n8n-studio -- Automatizacion guiada de workflows n8n. Opera sobre una instancia n8n externa via MCP. Su unico punto de contacto con el ecosistema es que sales-engine requiere que se construyan workflows con el, pero no hay dependencia en el sentido inverso.

Arquitectura del Marketplace Inteliside v1.1.0 -- generado 2026-04-05