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.
Framework open-source - v1.7.1 Open-source framework - v1.7.1
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.
orchestration.trace
cli setup
-
01
Task Card
Contexto, alcance, restricciones y criterios verificables. Context, scope, constraints, and verifiable criteria.
-
02
Risk Routing
La ruta se decide antes de que cualquier agente toque archivos. The route is decided before any agent touches files.
-
03
Conductor Agent
Arquitecto, implementador, tester, reviewer o docs según el riesgo. Architect, implementer, tester, reviewer, or docs by risk.
-
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, Cursor, Gemini, Codex, Agy, and Pi presets
npx cc-codeconductor setup,init,install,doctor,update,migrate- Scorecard CLI, CCEP, OpenSpec delivery loop & Product OS
- 15 Conductor Agents (including
reviewer,security-reviewer,complexity-auditor) - Versioned Agent Contracts & Routing Policy v1.7.1
- Spring Boot/Kotlin and Python/Django workflow guidance
No existe todavía Not implemented yet
- Runtime sandbox / OS-level isolation
- Policy compiler / uniform target enforcement
- Full stack-specific asset pruning
workflow
Un sistema para pasar de solicitud a entregable revisable. A system for moving from request to reviewable deliverable.
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.
install
Instala el preset correcto para tu herramienta. Install the right preset for your tool.
En v1.7.1 el flujo recomendado es npx cc-codeconductor setup --target <target> --yes.
También puedes seguir las guías manuales, revisar los archivos generados y versionar los contratos en el repositorio.
In v1.7.1 the recommended flow is npx cc-codeconductor setup --target <target> --yes.
You can also follow the manual guides, 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 guideclaude
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 guidecursor
Cursor Editor
Preset con reglas específicas y orquestación multi-target. Preset with specific rules and multi-target orchestration.
Guía Cursor Cursor guideopencode
OpenCode
Preset para agentes, comandos, skills y configuración de OpenCode. Preset for OpenCode agents, commands, skills, and configuration.
Guía OpenCode OpenCode guidesecurity 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 v1.7.1, la aplicación real depende de las capacidades del target tool. CodeConductor documents read, write, command, and human-review boundaries. In v1.7.1, 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 guidecomplementary 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 toolscontext
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.
| Versión Version | Enfoque Focus | Estado Status |
|---|---|---|
| v0.1.0 | Presets OpenCode/Claude, guía de stack, instalación manual OpenCode and Claude presets, stack guidance, manual install | historial historical |
| v0.2.0 | CLI init, detección determinista, doctor CLI init, deterministic detection, doctor | historial historical |
| v0.3.0 | Presets Next.js, FastAPI, genéricos y soporte monorepo Next.js, FastAPI, generic presets, monorepo support | historial historical |
| v0.4.0 | Matriz de providers y workflows de sync entre targets Provider compatibility matrix and target sync workflows | historial historical |
| v0.5.0 | Scorecard CLI, outcome tracking, regresión de prompts Scorecard CLI, task outcome tracking, prompt regression | historial historical |
| v1.0.0 | Contratos y routing estables, evaluación documentada Stable contracts, stable routing, documented evaluation | historial historical |
| v1.6.0 | Contratos versionados, routing por riesgo, Task Cards, scorecard y presets multi-herramienta Versioned contracts, risk-based routing, Task Cards, scorecard, and multi-tool presets | historial historical |
| v1.7.0 | CLI setup/init/doctor, CCEP, OpenSpec, Product OS, 15 agentes y presets multi-target CLI setup/init/doctor, CCEP, OpenSpec, Product OS, 15 agents, and multi-target presets | historial historical |
| v1.7.1 | Hooks globales de Claude con ruta absoluta y escapada; migrate --global para presets globales Global Claude hooks use absolute escaped paths; migrate --global for existing global presets | actual latest |
agent orchestration
El problema no es el modelo. Son los contratos de responsabilidad. The problem is not the model. It's accountability contracts.
Un prompt bien escrito falla en un workflow roto. CodeConductor define qué agente hace qué, con qué entradas, y qué criterios verifican la salida — antes de que cualquier agente toque archivos. A well-written prompt fails in a broken workflow. CodeConductor defines which agent does what, with which inputs, and which criteria verify the output — before any agent touches files.
Entender la orquestación Understand orchestration¿por qué existe? why does it exist?
Los agentes de IA improvisan sin estructura. CodeConductor convierte cada petición en un contrato verificable. AI agents improvise without structure. CodeConductor turns every request into a verifiable contract.
¿qué ganás? what do you gain?
Flujos reproducibles, revisión antes de merge, scope controlado y entregables medibles. Reproducible flows, review before merge, controlled scope, and measurable deliverables.
¿cómo se usa? how do you use it?
Task Card → routing por riesgo → secuencia de agentes especializados → Scorecard. Task Card → risk routing → specialized agent sequence → Scorecard.
start
Empieza con la CLI y contratos revisables. Start with the CLI and reviewable contracts.
En v1.7.1 ejecuta npx cc-codeconductor setup --target <target> --yes,
revisa el harness instalado y versiona los contratos junto al código.
In v1.7.1 run npx cc-codeconductor setup --target <target> --yes,
review the installed harness, and version the contracts alongside the code.