sd0x-dev-flow

Idioma: English | 繁體中文 | 简体中文 | 日本語 | 한국어 | Español

La capa harness para Claude Code.

Gates de calidad que la IA no puede saltarse. Una reference implementation de AI Agent Harness Engineering para Claude Code — dual review forzado por hooks, gates de state-machine que sobreviven a la compactación del contexto y seguridad fail-closed donde importa.

96 bundled · 96 public skills · 15 agents — ~4% de la ventana de context de Claude

Lo que hace este harness

Harness engineering es la disciplina de diseñar todo lo que rodea al LLM — tool loops, gestión de contexto, hooks, state machines, capas de seguridad — en lugar de entrenar el modelo en sí. Mitchell Hashimoto acuñó el término en febrero de 2026; Anthropic engineering y Martin Fowler han publicado al respecto; arXiv 2603.05344 lo formaliza.

sd0x-dev-flow es una reference implementation. Cada fila de la tabla mapea un subproblema canónico de harness a código concreto que puedes estudiar:

La mayoría de proyectos de harness cubren 2–4 de estos subproblemas. sd0x-dev-flow cubre los 10 — lo que hace el código útil como objeto de estudio, no solo como herramienta.

¿Por qué sd0x-dev-flow?

Inicio rápido

# Instalar plugin
/plugin marketplace add sd0xdev/sd0x-dev-flow
/plugin install sd0x-dev-flow@sd0xdev-marketplace

# Configurar tu proyecto
/project-setup

Un solo comando autodetecta framework, package manager, base de datos, entry points y scripts. Instala un subconjunto de rules y hooks; el plugin completo incluye 14 rules + 9 hooks.

Usa --lite para solo configurar CLAUDE.md (sin rules/hooks).

Cómo funciona

flowchart LR
    P["🎯 Plan"] --> B["🔨 Build"]
    B --> G["🛡️ Gate"]
    G --> S["🚀 Ship"]

    P -.- P1["/codex-brainstorm<br/>/feasibility-study<br/>/tech-spec"]
    B -.- B1["/feature-dev<br/>/bug-fix<br/>/codex-implement"]
    G -.- G1["/codex-review-fast<br/>/precommit<br/>/codex-test-review"]
    S -.- S1["/smart-commit<br/>/push-ci<br/>/create-pr<br/>/pr-review"]

El motor auto-loop aplica quality gates automáticamente — tras ediciones de código, el comando de review despacha dual review (Codex MCP + reviewer secundario en paralelo) en la misma respuesta. Los hallazgos se deduplican, normalizan por severidad y agregan en un único gate. En modo strict, los hooks aplican semántica fail-closed: si el gate agregado está incompleto, stop-guard bloquea. Ver docs/hooks.md para detalles.

sequenceDiagram
    participant D as Developer
    participant C as Claude
    participant X as Codex MCP
    participant T as Secondary Reviewer
    participant H as Hooks

    D->>C: Edit code
    H->>H: Track file change
    C->>H: emit-review-gate PENDING
    par Dual Review
        C->>X: Codex review (sandbox)
    and
        C->>T: Task(code-reviewer)
    end
    X-->>C: Findings (primary)
    T-->>C: Findings (secondary)
    C->>C: Aggregate + dedup + gate
    C->>H: emit-review-gate READY/BLOCKED

    alt Issues found
        C->>C: Fix all issues
        C->>X: --continue threadId
        X-->>C: Re-verify
    end

    C->>C: /precommit (auto)
    C-->>D: ✅ All gates passed

    Note over H: Strict mode: incomplete gate → blocked

Funcionalidad destacada: Arquitectura Dual-Reviewer

v2.0 despacha dos reviewers independientes en paralelo — Dual-review por defecto con modos de fallback degradado:

Los hallazgos se normalizan por severidad (P0-Nit), deduplican (archivo + clave de issue, tolerancia ±5 líneas) y se atribuyen por fuente (codex | toolkit | both).

Gate: ✅ Ready o ⛔ Blocked — en modo strict, gate incompleto = bloqueado.

Comparación

Cuándo usar

Instalación

Codex CLI / Otros Agentes de IA

# Instalar skills individuales vía Agent Skills standard
npx skills add sd0xdev/sd0x-dev-flow

# Generar AGENTS.md + instalar hooks (en Claude Code)
/codex-setup init

Requisitos: Claude Code 2.1+ | Codex MCP (opcional — los skills /codex-* lo requieren; sin él, se usa modo single-reviewer)

Tracks de workflow

flowchart TD
    subgraph feat ["🔨 Feature Development"]
        F1["/feature-dev"] --> F2["Code + Tests"]
        F2 --> F3["/verify"]
        F3 --> F4["/codex-review-fast"]
        F4 --> F5["/precommit"]
        F5 --> F6["/update-docs"]
    end

    subgraph fix ["🐛 Bug Fix"]
        B1["/issue-analyze"] --> B2["/bug-fix"]
        B2 --> B3["Fix + Regression test"]
        B3 --> B4["/verify"]
        B4 --> B5["/codex-review-fast"]
        B5 --> B6["/precommit"]
    end

    subgraph docs ["📝 Docs Only"]
        D1["Edit .md"] --> D2["/codex-review-doc"]
        D2 --> D3["Done"]
    end

    subgraph plan ["🎯 Planning"]
        P1["/codex-brainstorm"] --> P2["/feasibility-study"]
        P2 --> P3["/tech-spec"]
        P3 --> P4["/codex-architect"]
        P4 --> P5["Implementation ready"]
    end

    subgraph ops ["⚙️ Operations"]
        O1["/project-setup"] --> O2["/repo-intake"]
        O2 --> O3["Develop"]
        O3 --> O4["/project-audit"]
        O3 --> O7["/best-practices"]
        O3 --> O5["/risk-assess"]
        O4 --> O6["/next-step --go"]
        O5 --> O6
        O7 --> O6
    end

Guía Práctica (Cookbook)

Escenarios reales que muestran qué habilidades combinar y en qué orden.

Los 10 escenarios →

Contenido

Mínimo consumo de context

~4% de la ventana de 200k tokens de Claude — el 96% queda disponible para tu código.

Los skills se cargan bajo demanda. Los skills inactivos no consumen tokens.

Referencia de Skills

Reglas & Hooks

14 reglas (convenciones siempre cargadas) + 9 hooks (guardrails automatizados).

Personalización: Edita auto-loop-project.md para sobrescribir el comportamiento de auto-loop por proyecto. Las actualizaciones del plugin no conflictuarán — ver Rule Override Pattern.

Para la referencia completa de reglas, hooks y variables de entorno, consulta docs/rules.md y docs/hooks.md.

Personalización

Ejecuta /project-setup para autodetectar y configurar todos los placeholders, o edita .claude/CLAUDE.md manualmente:

Demostración: Investigación Multi-Agente

Ejecuta /deep-research para orquestar 2-3 agentes de investigación en paralelo a través de fuentes web, codebase y conocimiento de la comunidad — con síntesis de claim registry y debate adversarial condicional.

Documentación completa

Arquitectura

Command (entrada) → Skill (capacidad) → Agent (entorno)

• Commands: El usuario los ejecuta con /...
• Skills: Knowledge bases cargadas bajo demanda
• Agents: Subagentes aislados con herramientas específicas
• Hooks: Guardrails automatizados (formateo, estado de review, stop guard)
• Rules: Convenciones siempre activas (carga automática)

Para detalles avanzados de arquitectura (agentic control stack, teoría de bucle de control, reglas de sandbox), consulta docs/architecture.md.

Contribuir

PRs bienvenidos. Por favor:

1. Seguir las convenciones de naming existentes (kebab-case)
2. Incluir When to Use / When NOT to Use en skills
3. Agregar disable-model-invocation: true para operaciones peligrosas
4. Testear con Claude Code antes de enviar

Licencia

MIT

Star History