Skip to content

Repository files navigation

El DT — Technical Director: orchestrator core, 8-step workflow, and subagents

El DT — Director de proyecto con IA

License: MIT v1.7.11

Tu IA con equipo, criterio y herramientas — no un chat que dice “sí” a todo.

El DT es un Director de Proyecto para tu IA: no solo ejecuta — organiza el trabajo, te hace preguntas antes de avanzar, propone alternativas y te avisa de riesgos antes de cerrar.

Delega en 23 especialistas (producto, diseño, marketing, documentación, calidad, seguridad…) y trae herramientas listas para:

  • Páginas web y productos digitales — landings, dashboards, pantallas de login (Atelier)
  • Presentaciones y pitches — decks, slides, material para inversores (Atelier)
  • Videos — promos, explainers, motion graphics (Remotion)
  • Marketing — copy, SEO, campañas, lanzamientos (42 skills tácticas)

Todo desde el chat de tu editor (Cursor, Antigravity, Claude Code y más). Empezá en 2 minutos: /bienvenida/yo.

El DT no es un prompt: es un cerebro operativo con ~1.400 documentos canónicos, ~56.000 líneas de orquestación, 23 especialistas, 105 skills y un ecosistema de diseño/marketing/video que suma cientos de miles de líneas de plantillas listas para usar.


Índice


Empezá acá

Si querés… Hacé esto
Usar El DT por primera vez /bienvenida/yo
Trabajar en el día a día /actualizar/yo → trabajar → /guardar
Una tarea grande, paso a paso /orquestar
Algo puntual ya definido /fast-lane
Diseñar una web, dashboard o presentación /atelier
Crear un video /remotion
Consultar documentos en Google Drive /drive (opcional — ver abajo)
Volcar briefs, notas o dumps al cerebro del repo /ordenar
Auditar seguridad del proyecto (auth, API, secrets…) /hack
Ver el equipo completo de especialistas Catálogo de 23

Este repo es memoria compartida + reglas para que varias personas trabajen con la misma IA sin pisarse. Guía humana: cerebro del equipo. La IA lee AGENTS.md al entrar al proyecto.

Primera vez {#primera-vez}

git clone <este-repo>
cd El-DT-Lightweight-Army

En el chat: /bienvenida/yo (ej. "Soy Ana García, analista"). Guía detallada: primer-setup-dt.md.

No hace falta /actualizar en un clone recién hecho — usalo cuando el remoto del producto o del template tenga novedades.


Ritual del día {#ritual-del-día}

/actualizar  →  /yo  →  trabajar  →  /guardar
Paso Qué hace
/actualizar Sincronizar tu proyecto (origin) y avisar si hay release nuevo del framework DT
/yo Decir quién sos en esta computadora
Trabajar Pedir lo que necesites (/orquestar, diseño, video, docs…)
/guardar Subir tu trabajo — bump de versión, sync y tag (sin secretos ni datos privados)
/drive Conectar Google Drive y elegir carpetas como contexto del cerebro (opcional)

Si la IA no sabe quién sos, te pedirá /yo antes de escribir en el repo. Tu identidad en esta PC no se sube a GitHub — es privada.

Tarjeta pegable al monitor

  bienvenida → yo → trabajar → guardar
  actualizar = proyecto + aviso si hay DT nuevo
  actualizar-dt = cuando quieras incorporar el framework
  drive = Google Drive (carpetas que elijas, solo en tu PC)
  tu identidad en esta PC = solo local

Qué puede hacer El DT

Bloque En pocas palabras
Orquestación Clarifica qué querés, planifica, ejecuta y cierra señalando riesgos. Comando principal: /orquestar.
23 especialistas Producto, diseño, marketing, documentación, calidad, seguridad… El DT elige quién ayuda según tu pedido.
Atelier (diseño) Landings, dashboards, login, presentaciones — con criterio estético y guardrails anti-“diseño genérico de IA”.
Captura de conocimiento Volcar archivos, carpetas y dumps del chat — clasificar, documentar en la capa correcta y dejar manifest recuperable (/ordenar).
Seguridad Auditoría ofensiva-defensiva del propio repo — auth, API, secrets, agentes/IA (/hack → subagente hack-audit).
Videos y contenido Videos promocionales; marketing con copy, SEO, lanzamientos y campañas.
flowchart TB
  vos[Vos en el chat]
  dt[El DT — orquestador]
  esp[23 especialistas]
  atelier[Atelier — webs y presentaciones]
  video[Videos — Remotion]
  mkt[Marketing — 42 skills]
  vos --> dt
  dt --> esp
  esp --> atelier
  esp --> video
  esp --> mkt
Loading

Los cinco protocolos

El DT no es un ejecutor pasivo. Siempre aplica:

  1. Validar antes de actuar — te pregunta antes de cambios importantes.
  2. Alternativas — propone caminos con pros y contras.
  3. Puntos ciegos — riesgos y mejoras visibles al cerrar.
  4. Conversacional — diálogo, no informe unidireccional.
  5. Orden — objetivo → plan → ejecución → validación.

Detalle: protocolos DT.


Comandos principales

Comando Para qué sirve
/bienvenida Primera vez — verificar que El DT está listo
/actualizar Sincronizar tu proyecto y avisar si hay DT nuevo
/actualizar-dt Incorporar release del framework DT (cuando /actualizar avise)
/yo Decir quién sos en esta máquina
/guardar Subir tu trabajo — bump patch, sync README/paquetes, tag vX.Y.Z
/drive Conectar Google Drive y registrar carpetas para que la IA las consulte
/orquestar Tarea grande — pipeline completo en 8 pasos
/fast-lane Algo puntual ya definido — menos preguntas rutinarias
/cuestionar Solo análisis — sin ejecutar
/contexto Mapa del repo cuando entrás o después de un pull grande
/ordenar Volcar archivos y data — documentar en la capa correcta + manifest (skill dt-ordenar)
/hack Auditoría de seguridad — mentalidad de atacante, entrega defensiva (skill hack-audit → subagente hack-audit)
/verificar Verificar números de planillas y reportes con script (skill data-auditor → subagente data-auditor)
/prepr Preparar cambios como pull request
/atelier Diseñar webs, dashboards o presentaciones
/remotion Crear videos (promos, explainers, motion)
/setup Reparar configuración del editor tras un pull grande

Grupos completos y taglines: commands-meta.yaml.


Google Drive — /drive {#google-drive--drive}

Integración opcional: conectá solo las carpetas que elijas de Google Drive para que el DT las use como contexto al responder (briefs, reportes, docs de cliente). No movés archivos al repo y nada de Drive se sube a GitHub — credenciales, tokens y la lista de carpetas viven solo en tu máquina.

Para qué sirve

Situación Qué hace /drive
Primera vez OAuth con tu cuenta Google, registra el MCP en Cursor/Antigravity, elegís carpetas
Ya conectado Cambiar qué carpetas compartís al cerebro o revisar la config local
En el chat La IA lee Docs/Sheets/Slides/PDF de esas carpetas vía MCP cuando el pedido lo amerita

Cómo usarlo

  1. /yo — identidad local (requisito del DT).
  2. /drive — el DT te guía paso a paso:
    • Pedí el archivo dt-drive-credentials.json al canal interno de tu empresa (nunca va al repo).
    • Corre ./scripts/setup-drive.sh (o dejá que la IA lo ejecute) y reiniciá el IDE si hace falta.
    • Elegí Shared Drives o carpetas de “Mi unidad” y describí en una frase qué contiene cada una.
  3. Trabajá normal — pedí en lenguaje natural: “según el brief en Drive…”, “resume el doc de la carpeta X”.

La selección queda en vitals/config/drive-context.yaml (local, no Git). Alcance de lectura: solo lectura (drive.readonly).

Guía completa: drive-cerebro-setup.md · Admin GCP: drive-google-cloud-admin.md


Ordenar — captura de conocimiento {#ordenar--captura-de-conocimiento}

/ordenar ingesta archivos, carpetas y dumps del chat, los clasifica por capa (docs/, vitals/work/knowledge/, inbox personal…) y deja un manifest recuperable para que la IA no pierda contexto.

Comando Ejemplo
/ordenar Pipeline completo — inventario, plan de archivo, documentación, indexación
/ordenar quick Plan + máx. 3 docs canónicos; el resto en sources/
/ordenar inbox Solo cuaderno personal (vitals/work/inbox/{id}/)
/ordenar docs Forzar promoción a docs/ con frontmatter

Flujo típico: skill dt-ordenar orquesta la ingesta; redacción pesada → delegar en doc.


Hack — auditoría de seguridad {#hack--auditoría-de-seguridad}

/hack audita el propio proyecto con mentalidad de atacante y entrega defensiva: hallazgos con severidad (SEV), prioridad y remediación anclada al repo — sin exploits ni PoCs.

Comando Ejemplo
/hack Full repo — los 9 dominios (auth, API, secrets, frontend, infra, agents…)
/hack auth · /hack api · /hack agents Un dominio
/hack diff Cambios vs base (git diff) con contexto de superficie

Flujo típico: skill hack-audit → subagente hack-audit (evidencia con tools/security/scan-repo.sh antes del juicio manual).


Atelier — diseño web y presentaciones

Atelier es la capacidad de diseño de El DT: landings, dashboards, flujos de login, pitches y decks — con selección de design system, tokens y revisión anti-slop.

Comando Ejemplo
/atelier init Crear contexto de diseño del proyecto
/atelier select [brief] Elegir estilo y sistema según tu pedido
/atelier detect [path] Detectar patrones genéricos de IA en el código
/atelier polish [target] Pasada final antes de entregar

Incluye 6 design systems (Material, Apple HIG, Fluent, Carbon, Polaris, Atlassian), 5 lenguajes visuales (Swiss, Bauhaus, minimalismo, neumorphism, glass) y biblioteca de plantillas.

Orquestador: ui-designer · Implementación en código: frontend.


Remotion — videos

Remotion convierte videos en composiciones React: promos, explainers, motion graphics, renders MP4.

Comando Ejemplo
/remotion init Arrancar un proyecto de video
/remotion promo 30s 9:16 Video promocional vertical

Flujo típico: marketing-strategist (guion) → remotion-producer (composición y render).


Marketing — 42 skills tácticas

marketing-strategist coordina 42 skills especializadas: copy, SEO, ads, lanzamientos, email, pricing, CRO y más.

Ver listado completo de skills ↓


Quick setup (English)

  1. Clone this repo (or Use this template on GitHub).
  2. In chat: /bienvenida then /yo — see primer-setup-dt.md.
  3. Daily ritual: /actualizar/yo → work → /guardar
  4. Design: /atelier · Video: /remotion · Knowledge: /ordenar · Security: /hack · Deep work: /orquestar or /fast-lane
  5. Repair IDE drift: /setup — see ide-setup.md

Adopting El DT in an existing repo: adopt-dt-in-existing-repo.md.

Works in Cursor, Antigravity, Claude Code, Codex and GitHub Copilot.


Para el equipo técnico

El DT mantiene el proyecto ordenado

Tras cambios importantes en documentación, reglas o estructura, El DT verifica que todo siga coherente (frontmatter, catálogo, enlaces, paridad entre editores). Motor: scripts/dt-doctor.sh. Detalle: regla 07-orden-continuo · precedence.

Orquestación — macro vs micro

Macro: Clarificar → Planificar → Ejecutar → Entregar.

Micro: /orquestar = 8 pasos (clarificar … cierre documental).

flowchart LR
  req[Request]
  clarify[Clarify]
  gate{FastLane_or_validate}
  planExec[Plan_and_execute]
  deliver[Deliver]
  req --> clarify --> gate --> planExec --> deliver
Loading

Seguridad y secretos siempre aplican, incluso bajo /fast-lane.

Vitals

Layer Path
Index vitals/INDEX.md
Session (local) vitals/ops/session.yaml
Team roster vitals/config/roster.yaml
Commands meta vitals/config/commands-meta.yaml
Concept doc docs/01_concepts/dt-vitals.md
Script Uso
dt-doctor.sh Verificador read-only del orden
sync-ide.sh Emisor único multi-IDE (rules, skills, commands)
sync-catalog.rb Catálogo de docs derivado del frontmatter
sync-commands-from-meta.sh Commands desde commands-meta.yaml
sync-skills-parity.sh Skills .cursor/skills.agents/skills

Detalle: scripts/README.md.

Subagentes (23) — resumen por grupo

Grupo Especialistas Ejemplos de uso
Engineering arquitecto, frontend, devops, ui-designer, remotion-producer APIs, UI, deploy, Atelier, video
Planning prd-creator, srd-creator, development-planner PRD, specs técnicas, roadmap
Testing qa, data-auditor, hack-audit Tests, números, auditoría de seguridad
Design & UX ux-researcher Personas, journey mapping
Product product-strategist, feedback-synthesizer, researcher Priorización, research
Documentation doc README, ADRs, docs por niveles
Marketing & Content content-creator, marketing-strategist, brand-guardian, growth-hacker, pitch-specialist, storytelling-specialist Copy, campañas, pitch, narrativa
Operations operations-maintainer Monitoreo, incidentes

Fuente canónica de skills: .cursor/skills/ (espejo Antigravity/Claude vía sync-ide). Reglas de delegación: .cursor/rules/03-catalogo-subagentes.mdc.

Skills de rutina DT (no son subagentes): dt-setup, dt-session, dt-ordenar, git-actualizar, git-guardar, dt-drive, dt-actualizar, github-save-release.

Skills con subagente dedicado (command → skill → agente): /hackhack-audit · /verificardata-auditor.

Catálogo de los 23 especialistas

# Subagente Grupo Rol Invocar cuando (keywords) Agente (Cursor) Skill de rol
1 arquitecto Engineering Backend, APIs, arquitectura, patrones backend, api, database, server, arquitectura, SRD agente .cursor/skills/arquitecto/
2 frontend Engineering UI, componentes, accesibilidad frontend, ui, ux, interface, client, componentes agente .cursor/skills/frontend/
3 devops Engineering CI/CD, infra, deploy deploy, infrastructure, ci/cd, devops, pipelines agente .cursor/skills/devops/
4 ui-designer Engineering Orquestador Atelier + specs UI UI design, mockups, Atelier, landing, dashboard, design system agente .cursor/skills/ui-designer/
5 remotion-producer Engineering Video programático Remotion Remotion, video programático, motion graphics, render MP4 agente .cursor/skills/remotion-producer/
6 prd-creator Planning PRD, visión de producto, user stories product idea, requirements, PRD agente .agents/skills/prd-creator/
7 srd-creator Planning SRD y specs técnicas desde PRD technical spec, SRD, PRD to technical agente .agents/skills/srd-creator/
8 development-planner Planning Fases, MVP, roadmap, timelines development plan, phases, MVP, roadmap agente .agents/skills/development-planner/
9 qa Testing Tests, edge cases, validación test, qa, quality, pruebas agente .cursor/skills/qa/
10 ux-researcher Design & UX Personas, journey, research UX user research, personas, UX, journey mapping agente .agents/skills/ux-researcher/
11 product-strategist Product Priorización, roadmap de producto prioritization, roadmap, product strategy agente .agents/skills/product-strategist/
12 feedback-synthesizer Product Síntesis de feedback en insights feedback, synthesis, insights agente .agents/skills/feedback-synthesizer/
13 researcher Product Investigación y análisis de información research, analyze, investigate agente .agents/skills/researcher/
14 doc Documentation Docs por niveles, README, ADRs document, docs, readme, documentación agente .agents/skills/doc/
15 content-creator Marketing & Content Contenido multi-canal, SEO, brand content, copy (contenido editorial) agente .agents/skills/content-creator/
16 marketing-strategist Marketing & Content Estrategia + 42 skills tácticas marketing, CRO, SEO, ads, campaigns, growth agente .cursor/skills/marketing-strategist/
17 brand-guardian Marketing & Content Marca y brand guidelines brand, brand compliance agente .agents/skills/brand-guardian/
18 growth-hacker Marketing & Content Experimentos y conversión growth, experiments, conversion agente .agents/skills/growth-hacker/
19 pitch-specialist Marketing & Content Pitch inversores y stakeholders pitch, presentation, investors agente .agents/skills/pitch-specialist/
20 storytelling-specialist Marketing & Content Narrativa y story arcs storytelling, narrative, story agente .agents/skills/storytelling-specialist/
21 operations-maintainer Operations Monitoreo, incidentes, mantenimiento operations, monitoring, incidentes agente .agents/skills/operations-maintainer/
22 data-auditor Testing Verificación de números y planillas con script (regla 16-numeric-grounding) planilla, csv, excel, reporte, totales, reconciliar, verificar cifras agente .cursor/skills/data-auditor/
23 hack-audit Testing Auditoría de seguridad ofensiva-defensiva (/hack) hack, seguridad, vulnerabilidades, pentest, auth, permisos, IDOR, secrets, API security agente .cursor/skills/hack-audit/

Marketing strategist — 42 skills tácticas

Origen: marketingskills v2. Contexto compartido: .agents/product-marketing.md (local).

IDE Orquestadora Pack táctico
Cursor .cursor/skills/marketing-strategist/ .cursor/skills/marketing/{skill}/
Antigravity .agents/skills/marketing-strategist/ .agents/skills/marketing/{skill}/
Skill Área
product-marketing Contexto de producto (base para todas)
ab-testing Experimentación y A/B tests
ad-creative Creatividades de ads
ads Campañas pagadas (Google, Meta, LinkedIn, etc.)
ai-seo SEO para motores / respuestas IA
analytics Medición, GA4, tracking
aso App Store / Google Play
churn-prevention Retención, dunning, cancel flows
co-marketing Partnerships y campañas conjuntas
cold-email Outbound B2B
community-marketing Comunidades y advocacy
competitor-profiling Research de competidores (URLs)
competitors Páginas comparison / alternatives
content-strategy Estrategia de contenido
copy-editing Editar copy existente
copywriting Copy nuevo (landings, web)
cro Conversión en páginas y forms
customer-research Research de clientes
directory-submissions Directorios startup/SaaS
emails Secuencias y lifecycle email
free-tools Herramientas gratis como lead gen
image Imágenes de marketing (IA)
launch Lanzamientos
lead-magnets Lead magnets
marketing-ideas Ideas e inspiración
marketing-psychology Psicología y persuasión
onboarding Activación post-signup
paywalls Paywalls in-app
popups Modales y overlays
pricing Pricing y packaging
programmatic-seo SEO programático
prospecting Listas y calificación B2B
referrals Referidos y afiliados
revops RevOps y handoff marketing→ventas
sales-enablement Collateral de ventas
schema Schema markup
seo-audit Auditoría SEO
signup Flujos de registro
site-architecture Arquitectura del sitio
sms SMS/MMS marketing
social Redes sociales
video Video marketing (IA)

Atelier — detalle técnico

Atelier 2.0: Impeccable vendoreado + pack design/ nativo. Contexto: .agents/design-context.md (local).

IDE Router Pack táctico Vendor
Cursor .cursor/skills/atelier/ .cursor/skills/design/ tools/atelier/

Motores: ruby scripts/dt-design-select.rb · ./scripts/atelier-detect.sh (Impeccable CLI, 44+ reglas)

Actualizar Impeccable: ./tools/atelier/scripts/sync-from-impeccable.sh --latest./scripts/sync-ide.sh (ver DOC-GUIDE-008)

Remotion — detalle técnico

Toolkit en tools/remotion/ (starter + primitivas). Best practices vendor: remotion-best-practices.

Actualizar vendor skill: ./tools/remotion/scripts/update-vendor-skills.sh./scripts/sync-ide.sh

Git: qué va y qué no va al remoto

Path ¿En Git? Por qué
vitals/ops/session.yaml No Quién está en esta PC ahora
vitals/config/roster.yaml Equipo registrado
vitals/workspace.yaml No Multi-repo local (plantilla: .example)
.env, *.credentials No Secretos
.agents/product-marketing.md No Contexto de producto local
.agents/design-context.md No Contexto de diseño local
.cursor/, .agents/, docs/, skills Comportamiento de la IA

Project layout

README.md / AGENTS.md / VERSION
tools/                              # Arsenal reutilizable — tools/REGISTRY.md
.agents/                            # Contexto local (product-marketing, design-context)
docs/                               # Portal de documentación
vitals/
  config/                           # commands-meta.yaml, roster.yaml, rules-manifest.yaml
  specs/rule-bodies/                # Cuerpos de reglas (fuente única)
  data/                             # Registries (design, engineering)
  ops/                              # session.yaml = local (/yo)
  pulse/ memory/ specs/
  work/inbox/{operator_id}/

.cursor/                            # rules, commands, agents, skills (canónico)
.agents/                            # Antigravity + Codex: rules, workflows, skills
.antigravity/                       # Entrada Antigravity (rules.md)
.claude/ .codex/                    # Espejos generados — no editar a mano
output/                             # Generaciones locales (gitignored)

Multi-IDE: ide-targets.yaml · Guía: ide-setup.md.

Personalización

  1. Reglas: editar vitals/specs/rule-bodies/<stem>.body.md + vitals/config/rules-manifest.yaml./scripts/sync-ide.sh
  2. Commands: editar vitals/config/commands-meta.yaml./scripts/sync-commands-from-meta.sh
  3. Skills: canónico en .cursor/skills/./scripts/sync-ide.sh
  4. Multi-proyecto: vitals/workspace.yaml desde workspace.yaml.example
  5. Verificar: ./scripts/dt-doctor.sh

Documentation portal


License

MIT — see LICENSE. Attribution: @LucasMazalan · GitHub: Mazalucas.

About

El DT is the framework that turns your AI into a Technical Director: it structures the conversation, challenges you before production changes, offers alternatives with trade-offs, and closes with visible risks. Less “yes, boss”; more judgment, traceability, and scaled help when you need it.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages