CodeConductor

Framework open-source - v0.1.x Open-source framework - v0.1.x

Deja de improvisar prompts. Orquesta agentes con contratos versionados. Stop improvising prompts. Orchestrate agents with versioned contracts.

CodeConductor instala disciplina de ingeniería sobre flujos asistidos por IA: Task Cards, routing por riesgo, agentes especializados, entregables medibles y revisión antes de merge. CodeConductor adds engineering discipline to AI-assisted workflows: Task Cards, risk-based routing, specialized agents, measurable deliverables, and review before merge.

Ver alcance actual View current scope Explorar workflow Explore workflow Ver repositorio Open repository
orchestration.trace manual preset
  1. 01

    Task Card

    Contexto, alcance, restricciones y criterios verificables. Context, scope, constraints, and verifiable criteria.

  2. 02

    Risk Routing

    La ruta se decide antes de que cualquier agente toque archivos. The route is decided before any agent touches files.

  3. 03

    Conductor Agent

    Arquitecto, implementador, tester, reviewer o docs según el riesgo. Architect, implementer, tester, reviewer, or docs by risk.

  4. 04

    Scorecard

    El entregable se acepta por criterios ponderados, no por intuición. The deliverable is accepted by weighted criteria, not intuition.

Estado real Current status

Disponible hoy Available today

  • OpenCode, Claude-compatible and Codex presets
  • Versioned Agent Contracts
  • Routing Policy v0.1.0
  • Task Card and Scorecard templates
  • Spring Boot/Kotlin and Python/Django workflow guidance

No existe todavía Not implemented yet

  • npx codeconductor init
  • Automated project detection and Safe Merger
  • codeconductor doctor
  • Runtime sandbox enforcement and policy compiler
  • Automated agent evaluation

workflow

Un sistema para pasar de solicitud a entregable revisable. A system for moving from request to reviewable deliverable.

01 / card

Task Card

Convierte una petición vaga en alcance, riesgo, criterios y límites. Turns a vague request into scope, risk, criteria, and boundaries.

02 / route

Routing Policy

Clasifica riesgo y define la secuencia de agentes antes de ejecutar. Classifies risk and defines the agent sequence before execution.

03 / agent

Agent Contracts

Define responsabilidades, entradas y salidas por rol especializado. Defines responsibilities, inputs, and outputs for each specialized role.

04 / score

Scorecard

Mide aceptación, pruebas, regresiones, scope creep y documentación. Measures acceptance, tests, regressions, scope creep, and docs.

manual install

Instala el preset correcto para tu herramienta. Install the right preset for your tool.

La CLI todavía está planeada. Hoy el flujo recomendado es seguir la guía manual, revisar los archivos generados y versionar los contratos en el repositorio. The CLI is still planned. Today, the recommended flow is to follow the manual guide, review the generated files, and version the contracts in the repository.

codex

Codex CLI

Preset para contratos compatibles con flujos de Codex y AGENTS.md. Preset for contracts compatible with Codex flows and AGENTS.md.

Guía Codex Codex guide

claude

Claude Code

Preset manual para CLAUDE.md, comandos y convenciones de Claude Code. Manual preset for CLAUDE.md, commands, and Claude Code conventions.

Guía Claude Claude guide

opencode

OpenCode

Preset para agentes, comandos, skills y configuración de OpenCode. Preset for OpenCode agents, commands, skills, and configuration.

Guía OpenCode OpenCode guide

security posture

Guardrails declarativos, sin vender sandboxing inexistente. Declarative guardrails without claiming sandboxing that does not exist.

CodeConductor documenta límites de lectura, escritura, comandos y revisión humana. En v0.1.x, la aplicación real depende de las capacidades del target tool. CodeConductor documents read, write, command, and human-review boundaries. In v0.1.x, actual enforcement depends on the target tool capability.

current guarantees

Políticas declarativas, presets por target, contratos de agente y gates de revisión. Declarative policies, target presets, agent contracts, and review gates.

non-guarantees

Sin aislamiento de OS, contención de filesystem, sandbox shell ni compilador de políticas. No OS isolation, filesystem containment, shell sandbox, or policy compiler.

recommended isolation

Ejecuta agentes con un usuario dedicado, permisos mínimos, worktrees aislados y sin acceso directo a secretos. Run agents with a dedicated user, minimal permissions, isolated worktrees, and no direct access to secrets.

Ver aislamiento recomendado View isolation guide

complementary tools

Reduce consumo de tokens y mejora el flujo de desarrollo. Reduce token usage and improve the development flow.

CodeConductor funciona mejor cuando el agente recibe contexto preciso: búsqueda semántica, mapas de código, documentación local y herramientas de exploración reducen lecturas repetidas y conversaciones largas. CodeConductor works best when agents receive precise context: semantic search, code maps, local docs, and exploration tools reduce repeated reads and long conversations.

Ver herramientas complementarias View complementary tools

context

Dar contexto curado antes de pedir implementación evita exploración redundante. Curated context before implementation avoids redundant exploration.

retrieval

Usa herramientas de búsqueda y graph/code intelligence para ubicar archivos relevantes. Use search and graph/code intelligence tools to locate relevant files.

workflow

Task Cards, límites de scope y Scorecards mantienen el ciclo corto y auditable. Task Cards, scope boundaries, and Scorecards keep the cycle short and auditable.

roadmap

Progreso por valor demostrado, no por automatización prematura. Progress by demonstrated value, not premature automation.

Version Focus Status
v0.1.x Manual presets, stack guidance, contracts, templates available
v0.2.0 CLI init, deterministic detection, doctor, Safe Merger planned
v0.3.0+ Next.js, FastAPI, generic presets, monorepo support planned

start

Empieza con presets manuales y contratos revisables. Start with manual presets and reviewable contracts.

La CLI está planeada. La forma correcta hoy es instalar el preset compatible con tu target y versionar los contratos junto al código. The CLI is planned. The correct path today is installing the compatible target preset and versioning the contracts alongside the code.

Abrir repositorio en GitHub Open GitHub repository