claude-code-harness

name	claude-code-harness
description	Framework de desarrollo disciplinado para Claude Code — ciclo Plan→Work→Review con specs, contratos y verificación. Compatible con Codex y OpenCode.
url	https://github.com/Chachamaru127/claude-code-harness
category	software-development
fecha	2026-06-03T00:00:00.000Z

Claude Code Harness — Desarrollo disciplinado para agentes de código

Plan. Work. Review. Ship. — Un bucle operativo repetible para Claude Code, con caminos acotados para Codex y OpenCode.

¿Qué hace?

Claude Code es potente, pero el trabajo crudo del agente se desvía: los planes viven en el chat, los tests se vuelven opcionales, la revisión llega tarde y la evidencia de release se reconstruye con la memoria. Harness convierte eso en un camino operativo repetible.

Ciclo operativo

1. Spec — escribir especificación y plan
2. Work — implementar solo la slice aprobada
3. Review — verificar el resultado
4. Release — empaquetar evidencia para PR o release

Características

• 5 skills de verbos — Plan, Work, Review, Release, Setup
• Core en Go — rápido y ligero
• Compatible con: Claude Code v2.1+, Codex, OpenCode
• Spec-driven — contratos generados automáticamente
• Evidence packaging — documentación automática para PRs
• Migration report — checklist para usuarios existentes

Casos de uso

1. Desarrollo con agentes — usar Claude Code de forma disciplinada y reproducible
2. Code review automatizado — verificar resultados antes de merge
3. Documentación de PRs — generar evidencia y contexto automáticamente
4. Equipos de desarrollo — estandarizar el flujo de trabajo con agentes
5. Migración de workflows — convertir workflows manuales a agent-driven

Snippets útiles

Instalación en 30 segundos

claude
/plugin marketplace add Chachamaru127/claude-code-harness
/plugin install claude-code-harness@claude-code-harness-marketplace
/harness-setup

Primer flujo de trabajo

# 1. Planificar
/harness-plan Improve the README onboarding flow

# 2. Aprobar o corregir el spec generado

# 3. Implementar la tarea más pequeña
/harness-work 1.1.1

# 4. Verificar
/harness-review

Comandos principales

/harness-setup      # Configuración inicial
/harness-plan <request>  # Generar spec y plan
/harness-work <task-id>  # Implementar tarea específica
/harness-review          # Verificación independiente
/harness-release         # Empaquetar evidencia

Cómo integrarlo en Mastermind

Como skill de Hermes Agent

# Instalar como skill en Hermes
# El harness se integra como un conjunto de skills que guían
# al agente en el ciclo Plan→Work→Review

Uso con subagents

# Delegar tareas de desarrollo con harness
# 1. Generar spec con /harness-plan
# 2. Delegar work con /harness-work
# 3. Verificar con /harness-review

Pitfalls

• Requiere Claude Code v2.1+ para las mejores experiencias
• El primer uso puede parecer verboso (escribir spec, aprobar, etc.)
• No es un reemplazo de git — complementa git con disciplina de agente
• Los commands /harness-* solo funcionan dentro de Claude Code
• Para Codex/OpenCode, los caminos son diferentes (ver docs/onboarding/)

Referencias

• Documentación completa
• Compatibility guide
• Onboarding