Starter Harness Designer — Workspace v1

¿Qué hace Starter Harness Designer — Workspace v1?

"Una buena plantilla vale más que 100 páginas de guía."

¿Para quién es este skill?

• Personas que crean un harness por primera vez
• No desarrolladores (planificadores, marketeros, escritores, abogados, profesores, operadores, etc.)
• Personas que quieren empezar rápido con una estructura validada

Mantiene la misma filosofía de 3 fases (Planner → Generator → Evaluator) que el skill profesional harness-designer-workspace, pero con menor complejidad de entrada y precisión de salida adaptada a principiantes.

Fase	Profesional	Starter (este skill)
Planner	4 etapas de descubrimiento, preguntas abiertas	3 preguntas de opción múltiple → emparejamiento con número de exemplar
Generator	Propuesta de diseño → generación de archivos/estructura	Clonación + sustitución de exemplar
Evaluator	Verificación independiente de 8 pilares	Lista de verificación ligera — solo omisiones de sustitución y referencias rotas

---

Relación con otros skills de harness

              │ Profesional (diseño libre)      │ Principiante (clonación de exemplar)
──────────────┼─────────────────────────────────┼────────────────────────────────────
 Espacio de   │ harness-designer-workspace      │ harness-starter-workspace ★ (este skill)
 trabajo      │                                 │
──────────────┼─────────────────────────────────┼────────────────────────────────────
 Codificación │ harness-designer-coding         │ harness-starter-coding

Cuándo NO usar este skill

• Desarrollo de apps, servicios web o API → harness-starter-coding
• Usuarios avanzados que necesitan libertad de diseño → harness-designer-workspace
• Preguntas simples o tareas únicas → no es necesario usar un skill

---

Flujo de ejecución (5 minutos en total)

1. [Planner] 3 preguntas de opción múltiple
2. [Planner] Emparejamiento con número de exemplar + recomendación de preset
3. [Generator] Clonación del exemplar de harness-100
4. [Generator] Sustitución del nombre del proyecto y términos del dominio
5. [Evaluator] Lista de verificación ligera (5 segundos)
6. Mensaje de finalización ("Ahora úsalo así")

---

Fase 0: Coincidencia de Patrones (Planner)

Pregunta 1 — ¿Qué trabajo quieres que hagan? (1 frase en lenguaje natural)

Pídele al usuario que lo describa en una frase. Ejemplo:

• "Me gustaría un equipo que planifique, escriba el guión y haga el thumbnail para un video de YouTube"
• "Un equipo que extraiga cláusulas de riesgo de un contrato"
• "Automatizar el envío de un boletín mensual"

Pregunta 2 — ¿Cuál es la categoría más cercana? (opción múltiple, 8 opciones)

Consultar references/exemplar-index.md. Elegir entre estas 8 opciones:

Núm.	Categoría	Ejemplos
1	🎬 Producción de contenido	YouTube, pódcast, boletín, cómic, traducción
4	📊 Negocios y estrategia	Startup, investigación de mercado, fijación de precios, modelo financiero
5	🎓 Educación y aprendizaje	Tutor de idiomas, preparación de exámenes, diseño curricular
6	⚖️ Legal y cumplimiento	Contratos, patentes, GDPR/privacidad
7	🏃 Estilo de vida	Dieta, fitness, impuestos, viajes
8	📝 Comunicación y documentos	Redacción técnica, SOP, propuestas
9	🏢 Operaciones y procesos	Reclutamiento, onboarding, auditoría, compras
10	🌐 Dominios especializados	Bienes raíces, ESG, cartera de propiedad intelectual

Con las palabras clave de la Pregunta 1, recomienda automáticamente 1 a 3 opciones y pide al usuario que confirme.

Manejo de fallo de coincidencia (similitud < 0.5):

• Presenta los 3 candidatos más cercanos y pregunta "¿Cuál de estos se acerca más?"
• Si ninguno, sugiere cambiar al skill profesional harness-designer-workspace

Pregunta 3 — ¿Nombre del proyecto?

Corto, para usar como nombre de carpeta/archivo (ejemplo: youtube-production, contract-review, monthly-newsletter).

Pregunta 4 — ¿Quieres registrar el historial de cambios? (opcional, sí/no)

"¿Quieres crear un espacio para registrar qué cambió y por qué cuando mejores este equipo en el futuro?"

• sí → Crea automáticamente la wiki 05-flow-history/ + flow-change-protocol.md (el build inicial se registra como cambio 0001)
• no → No se crea (se puede agregar manualmente más tarde)

Propósito: retrospectiva de mejora del equipo, verificar motivos en caso de rollback, referencia al crear equipos similares. No afecta el uso diario.

Principio de gestión: Este historial solo registra cambios en el sistema de flujo de trabajo (reglas, procedimientos, herramientas, CLAUDE.md). No registra los productos generados por el sistema (resultados de investigación, informes, análisis, registros de agenda). Criterio de distinción: "Si este cambio no hubiera ocurrido, ¿el resultado de la siguiente ejecución sería diferente?" → Si es diferente = cambio del sistema = registrar / Si no es diferente = producto generado = no registrar Detalles: 00-system/protocols/flow-change-protocol.md

Pregunta 3.5 (condicional — solo para categorías de investigación)

Se muestra solo al seleccionar las categorías 📊 Negocios y estrategia, 🎓 Educación y aprendizaje, 🌐 Dominios especializados. Se omite en categorías no relacionadas con investigación (como producción de contenido).

"¿Necesitarás consultar investigaciones previas mientras trabajas en varias agendas?"

• Sí → Incluir wiki:
  • Verificar instalación del skill /graphify (automático: ~/.claude/skills/graphify/ o .claude/skills/graphify/)
  • Si no está instalado: explicar + opción de instalación (global/proyecto/no instalar)
  • ⚠️ Si elige no instalar: "La función wiki estará desactivada. Puedes activarla más tarde instalando /graphify y ejecutando /wiki-update"
• No → No incluir wiki

---

Fase 1: Selección de Preset (ponderación de evaluación)

Después del emparejamiento, recomendar + confirmar entre estos 3 presets:

Preset	Descripción	Criterio de recomendación automática
[Equilibrado] (predeterminado)	Todos los criterios de calidad iguales	Valor predeterminado
[Calidad primero]	Ponderación doble para Reviewer, escenarios de prueba, NOT-trigger	Categorías legal, salud, finanzas, propiedad intelectual
[Velocidad primero]	Scale Mode=Single, solo lista de verificación ligera	Prototipo único, trabajo individual

El preset seleccionado se registra en _workspace/00_input.md.

---

Fase 2: Generador — Clonación y sustitución de exemplar

Pasos de clonación (fallback automático)

Detecta automáticamente la presencia de gh para usar el método óptimo de descarga. Funciona igual si solo tienes git.

EXEMPLAR="{NN}-{nombre-exemplar}"   # Resultado del emparejamiento del Planner (ej: 01-youtube-production)
BASE="es/$EXEMPLAR/.claude"

if command -v gh &>/dev/null && gh auth status &>/dev/null 2>&1; then
  # ── Método A: GitHub CLI (gh) ──────────────────────────────
  echo "📡 Descargando con API gh..."
  FILES=$(gh api "repos/revfactory/harness-100/git/trees/main?recursive=1" \
    --jq ".tree[] | select(.path | startswith(\"$BASE/\")) | select(.type==\"blob\") | .path")
  mkdir -p .claude/agents .claude/skills
  while IFS= read -r filepath; do
    rel="${filepath#$BASE/}"
    dest=".claude/$rel"
    mkdir -p "$(dirname "$dest")"
    gh api "repos/revfactory/harness-100/contents/$filepath" \
      --jq '.content' | base64 -d > "$dest"
    echo "  ✅ $dest"
  done <<< "$FILES"
else
  # ── Método B: git sparse checkout (sin gh) ─────────────────
  echo "📡 Descargando con git sparse checkout..."
  TMP=$(mktemp -d)
  git clone --depth 1 --filter=blob:none --sparse \
    https://github.com/revfactory/harness-100.git "$TMP"
  git -C "$TMP" sparse-checkout set "$BASE"
  mkdir -p .claude
  cp -r "$TMP/$BASE/." .claude/
  rm -rf "$TMP"
  echo "  ✅ Sparse checkout completado"
fi

Condición	Método usado	Herramienta necesaria
gh instalado + autenticado	Método A (gh api)	gh
Solo git disponible	Método B (sparse checkout)	git
Ninguno disponible o falla	Método C (Claude genera directamente tras confirmación del usuario)	Ninguna

Si fallan tanto el método A como el B, Claude informa directamente al usuario:

⚠️ No se pudo descargar la plantilla desde GitHub.

Causa: gh y git no están disponibles o no hay conexión a internet.

En este caso, Claude puede escribir los archivos del harness directamente, basándose en la descripción del índice de exemplars. Ten en cuenta que no será la plantilla validada real, sino una reproducción de la estructura por Claude, por lo que la calidad puede variar.

¿Quieres continuar?

• Sí → Claude genera los archivos .claude/ directamente (basado en exemplar-index.md)
• No → Detener aquí. Vuelve a intentarlo después de conectar a internet o instalar git.

Si el usuario elige Sí: Claude lee la descripción del exemplar correspondiente en references/exemplar-index.md y escribe directamente la estructura de CLAUDE.md, agents/ y skills/. Si el usuario elige No: se detiene inmediatamente, se indica cómo reintentar y se finaliza.

Estructura resultante:

.claude/
├── CLAUDE.md
├── agents/
│   ├── {especialista-1}.md
│   ├── {especialista-2}.md
│   ├── {especialista-3}.md
│   ├── {especialista-4}.md
│   └── {revisor}.md
└── skills/
    ├── {orquestador}/skill.md
    └── {extensión-de-agente}/skill.md

3. Crear carpeta _workspace/ (para productos generados, con convención de numeración 00_input.md, 01_*.md, ...)

Reglas de sustitución

Elemento original	Sustituir por	Ejemplo
Nombre del harness	Nombre del proyecto del usuario	01-youtube-production → my-youtube-show
Términos del dominio (global)	Términos del dominio del usuario	"Video de YouTube" → "Episodio de pódcast"
Palabras clave de trigger	Palabras clave del dominio del usuario	Relacionado con YouTube → Relacionado con pódcast
Nombres de roles de agente	Solo si es necesario	scriptwriter → se recomienda mantener
Marcos de dominio	NUNCA cambiar	Porter's·IRAC·Bloom's son la experiencia central
_workspace/NN_*.md	Mantener (convención de numeración)	No cambiar los números

Estructura de carpetas adicional (v2):

• 50-reports/[nombre-de-agenda]/v[N]/report.md — Informes aislados por agenda
• 60-exports/[nombre-de-agenda]/ — Productos derivados (diapositivas, uso externo, etc.)
• Incluir frontmatter YAML de CARL: agenda:, type:, tags: en las plantillas de 70-playbook/
• (si se selecciona wiki) 45-wiki/ — Repositorio de grafo de conocimiento
• (si se selecciona wiki) Skill research-wiki — Referencia a wiki protegida por independencia
• (si se selecciona wiki) Comando /wiki-update — Crear y actualizar wiki
• (si Pregunta 4 = sí) 05-flow-history/ + 00-system/protocols/flow-change-protocol.md — Wiki de historial de cambios del flujo. Crear 5+1 archivos siguiendo la plantilla en ~/.claude/skills/harness-designer-workspace/references/flow-history-template.md

Lista de elementos prohibidos de sustitución:

• Nombres de marcos integrados (AIDA, IRAC, Bloom's, ADDIE, Porter's, DCF, Van Westendorp, SMART, etc.)
• Nombres de directorios y números de producto en _workspace/
• Términos de protocolo como SendMessage, TaskCreate
• Definiciones de Scale Modes
• Nombre del directorio 45-wiki/
• Nombre del skill research-wiki
• Texto de las reglas de referencia a wiki en el protocolo de independencia
• Corrección automática de bkit: los marcos de dominio (AIDA·IRAC·Bloom's, etc.), independence-protocol, protocolo SendMessage, sistema de numeración _workspace/ no deben modificarse bajo sugerencia de agentes bkit (code-analyzer, pm-lead, etc.)
• Elementos de bucle: criterios de finalización (condición de término), orden de revisión del Reviewer (Reviewer es el último), formato de fallo en review_report — prohibido sustituir o eliminar (un bucle requiere Goal+Check+condición de término para ser válido)

Simplificación de términos (para explicar al usuario; la estructura interna se mantiene)

Los archivos internos mantienen el lenguaje original. Solo se simplifica al explicar al usuario:

Término original	Término simplificado
Orchestrator	Líder del equipo
Agent-Extending Skill	Manual de conocimiento especializado
Dependency DAG	Orden de tareas
Scale Modes	Modo de tamaño del equipo
Trigger Boundaries	Condiciones de invocación
Cross-validation	Revisión cruzada

---

Fase 3: Evaluador — Lista de verificación ligera

En lugar de la verificación de los 8 pilares del skill profesional, solo se comprueba la integridad de la sustitución.

Verificación automática (5 segundos)

• Existe .claude/CLAUDE.md
• Existen 4 a 5 archivos .md en agents/ (incluyendo Reviewer)
• Existe skills/<orquestador>/skill.md
• Existe al menos 1 skill de extensión de agente en skills/
• Se ha creado la carpeta _workspace/
• El nombre original del harness (ej: 01-youtube-production) no permanece en ningún archivo (0 coincidencias con grep)
• Los nombres de marcos integrados se conservan (IRAC/Bloom's, etc., idénticos al original)
• Existe la sección should-NOT en Trigger Boundaries
• Existe la tabla de Scale Modes (Full / Reduced / Single)
• Existe la sección de 3 escenarios de prueba (Normal / Existing / Error)
• Existe estructura de carpetas por agenda en 50-reports/
• Existe la carpeta 60-exports/ (para separar productos derivados)
• Las plantillas CARL en 70-playbook/ incluyen frontmatter
• El comando /synthesize incluye una compuerta obligatoria de tareas pendientes
• orchestrator skill.md contiene criterios de finalización verificables (condiciones de término)
• El producto del Reviewer (review_report) incluye un formato de fallo (aprobado/revisión necesaria)
• (si se seleccionó wiki) Existe la carpeta 45-wiki/
• (si se seleccionó wiki) Existe el skill research-wiki
• (si se seleccionó wiki) Existen reglas de referencia a wiki en el protocolo de independencia

En caso de fallo

• Omisión de sustitución detectada → Preguntar de nuevo al Planner ("¿Por qué término quieres cambiarlo?")
• Defecto estructural → Reclonar el exemplar correspondiente y volver a sustituir
• 3 fallos → Sugerir cambiar a harness-designer-workspace

---

Fase 4: Mensaje de finalización (informe en lenguaje sencillo para no desarrolladores)

✅ ¡El harness está listo!

📁 Ubicación: /tu-proyecto/.claude/
👥 Composición del equipo (5 personas):
   - Estratega: descubrimiento de temas, análisis de competencia
   - Guionista: redacción del guión real
   - Diseñador de thumbnails: planificación de imágenes
   - Responsable de SEO: optimización para buscadores
   - Revisor: verificación de calidad general

🚀 Cómo usarlo:
   1. En Claude Code, escribe "/mi-show-de-youtube planea el próximo video"
   2. El equipo trabaja en orden y guarda los resultados en la carpeta _workspace/
   3. Los productos siguen el orden 00_input.md → 05_review_report.md

🔄 Cómo trabaja el equipo (bucle):
   El equipo opera en un bucle de "Objetivo (Goal) → Trabajo → Revisión (Check) → Finalización al aprobar".
   El último informe del revisor (0X_review_report.md) es el resultado de la verificación.
   Si no te gusta el resultado, pide algo más específico;
   esa decisión final es tu papel (bucle exterior).

📘 Próximos pasos:
   - Si hay algo que no te gusta, modifica .claude/agents/{rol}.md
   - Si quieres hacerlo más complejo, usa el skill harness-designer-workspace

---

Referencias

• exemplar-index.md — Índice de 73 exemplars de espacio de trabajo
• Original: https://github.com/revfactory/harness-100 (Apache-2.0)
• Variante profesional: harness-designer-workspace
• Variante para codificación: harness-starter-coding