Código abierto · Licencia MIT
Los agentes mejoraron. Conducirlos también necesita un método.
Una fábrica de software de agentes de IA que demuestra su trabajo: threads en paralelo, resultados verificados y decisiones breves solo cuando importan.
Un ciclo con responsabilidades claras
Defina objetivo y plan, implemente en la worktree, compruebe las pruebas y entregue mediante el núcleo. Cada fase tiene un contrato; el resultado no depende de creer el informe del agente.
Leer la guía →Su atención, donde importa
Elija #Classic, #Maestro o #Auto para el ciclo completo. #Fast atiende ajustes pequeños dentro de sus límites. Los modos controlan pausas; los permisos y las pruebas siguen siendo explícitos.
Leer la guía →Pruebas antes que confianza
Las claims llevan comandos reproducibles. La baseline distingue fallos previos de regresiones. CHECK independiente y push demostrado separan implementación de entrega.
Leer la guía →Contexto con procedencia
OrkMind conecta memoria gobernada y Company Brain. El contexto ayuda a decidir; no sustituye el estado de la thread ni concede autorización.
Leer la guía →Conceptos
Cómo se conectan las piezas
El host presenta, el núcleo verifica y el runtime implementa. Conozca los límites antes de conducir el primer ciclo.
Leer la guía →Empiece por el entorno
Instale el CLI y compruebe los requisitos del proyecto. La documentación cubre configuración, fases y verificación. @orkastery/cli 0.5.0.
Documentación →npm install -g @orkastery/cli
ork doctorApunte tres agentes al mismo repositorioy acabará con tres agentes estorbándose,y un informe que dice que todo salió bien.
El reto es conducir el trabajo: mantener el roadmap, aislar las threads, pedir la decisión adecuada, serializar el merge y volver a ejecutar cada claim.
Orkastery asume ese papel. El método y el código son públicos; las pruebas acompañan el trabajo y pueden volver a ejecutarse.
Pruebas antes que confianza
Atención humana donde importa
Los datos ausentes siguen visibles
Contexto con procedencia
Seis fases que ningún agente se salta
En el ciclo completo, cada fase tiene un contrato. Seleccione una fase para ver qué entrega. #Fast tiene un ámbito propio, limitado a GO.
F1 · GOAL
qué merece la pena y cómo demostrarlo
Objetivo verificable, mapa de impacto, criterios de éxito y claims con comandos de verificación. Sin implementación.
ork exige Una claim sin comando se rechaza como claims.unverifiable.
F2 · PLAN
el camino, con un único lugar para cada decisión
Tareas, touch_paths, decisiones D1..Dn en un único lugar y verificación ejecutable por tarea. Sin implementación.
ork exige Un plan sin verificación ejecutable no pasa a GO.
F3 · GO
implementación, paso a paso
Implementación por partes, con un commit atómico por tarea dentro de la worktree de la thread.
ork exige Los leases limitan la escritura a la worktree de la thread.
F4 · CHECK
revisión crítica, con un comando para ejecutar
Verificación contra la baseline, revisión de código, pruebas, seguridad y rendimiento.
ork exige Las pruebas fallidas generan motivos tipados, como verify.regression o claims.failed, con la salida real.
F5 · SHIP
merges, de uno en uno
Merge serializado, push comprobado por comando, roadmap actualizado y plan de reversión.
ork exige El push cuenta solo cuando git ls-remote coincide con el SHA local.
F6 · MASTER
la valoración de una persona
Registro MASTER con postmortem tipado, lecciones y valoración humana de 0 a 5.
ork exige Toda valoración requiere una justificación, en cualquier modo.
El ciclo completo termina con un registro MASTER. #Fast tiene un contrato propio, limitado a GO. Implementar y entregar son resultados distintos.
Threads paralelas, merges serializados
ork-pagamentos
GO
worktree propia · ledger propio · valoración propia
ork-relatorio
CHECK
worktree propia · ledger propio · valoración propia
ork-publicacao
SHIP
worktree propia · ledger propio · valoración propia
lease main-tree
una thread hace merge a la vez
las demás esperan en una cola FIFO
SHIP con push verificado por git ls-remote
Ilustración de entregas paralelas. Consulte su proyecto con ork board --all.
-
main-treeel gate de merge serializado -
worktree-write:<thread>escritura en su propia worktree -
path:<glob>ámbito de archivos reservado -
board:<card>un responsable por tarjeta a la vez -
service:<porta>un puerto local exclusivo
Los leases tipados tienen TTL. Las threads que solicitan el mismo ámbito esperan en orden FIFO. ork board --all muestra el trabajo actual.
¿Cuánta pausa quiere? Escriba una #TAG.
Elija dónde espera el ciclo. Las claims, la verificación y las políticas se mantienen en todos los modos.
-
- pausa para decidir
- objetivo, plan y pruebas, con autorización previa del push
- úselo cuando
- El modo predeterminado de ork init: premisas delicadas y entrega verificada.
- slugs de sesión
- goal, plan, f34, f56
-
- pausa para decidir
- premisas
- úselo cuando
- Una solución clara: una pausa para acordar las premisas.
- slugs de sesión
- f12, f345, master
-
- pausa para decidir
- sin pausas programadas
- úselo cuando
- Documentación, investigación, configuración, auditorías y migraciones.
- slugs de sesión
- full
-
- pausa para decidir
- sin pausas programadas; el push a la base sigue requiriendo autorización
- úselo cuando
- Un pedido pequeño y claro dentro de los límites de Fast. Solo GO.
- slugs de sesión
- go
bloque que espera una decisión humana
bloque que continúa con decisiones registradas en el ledger
Los modos cambian las pausas. Nunca reducen la verificación. Configure runtime, modelo y esfuerzo de cada bloque con ork setup.
Su atención donde se necesita
- trabajando
- esperando a una persona
- terminada, con estado registrado
Una sesión viva puede estar esperando a una persona. El radar distingue actividad, espera humana y finalización con pruebas.
Consulte las sesiones antes de concluir que una thread está trabajando. El resultado depende del estado observado ahora.
ork sessions hitlNo le pedimos que lo crea. Ejecútelo.
Los comandos reproducibles comprueban el trabajo en el árbol real. La baseline distingue regresiones de deuda previa.
ork verify <thread>
npm --prefix core run test:ci
ork modos-
el agente afirma
Una afirmación necesita pruebas ejecutables.
-
claims.jsonl
Una claim registra la afirmación, el archivo y el comando que la demuestra.
-
ork verify
Vuelve a ejecutar el comando en el HEAD real, dentro de la worktree real.
-
baseline registrada antes de GO
pasaba antes Produce
verify.regression: la thread introdujo un fallo.ya fallaba Se registra como deuda previa, separada de las regresiones.
sin baseline Produce
verify.failed, sin adivinar responsabilidades. -
gate bloqueado
Motivo tipado, pruebas reales y corrección sugerida.
ork fix openderiva la especificación de la corrección del resultado de verify.
Motivos tipados de gate
Ejemplos de motivos del núcleo. Consulte la política actual con ork retry policy.
-
artifact.missingcorrigir-dirigido -
claims.failedcorrigir-dirigido -
claims.unverifiablecorrigir-dirigido -
verify.regressioncorrigir-dirigido -
verify.failedcorrigir-dirigido -
tree.blockedsincronizar-worktree -
lease.busyreexecutar -
runtime.model-unavailablereexecutar -
runtime.unavailablereexecutar -
runtime.rate-limitedesperar-janela -
policy.violationescalar-humano -
human.pendingescalar-humano -
cost.violationsem-retry
cost.violation prohíbe el reintento automático: reintentar volvería a gastar.
Contexto para la siguiente sesión
ork gate next
Al terminar la fase, el gate evalúa la ocupación de la ventana de contexto.
- runtime_reported
- estimated, por transcript
- informada por el host
- unavailable
Sin una fuente capaz de medir, el resultado es same-session con decididoPor: ausencia-de-medida. Un dato ausente nunca se convierte en cero.
no
Misma sesión. El trabajo continúa donde está.
sí
Nueva sesión con handoff clasificado y el contexto necesario para el siguiente paso.
Tres niveles de contexto
-
Crítico
Siempre incluido: estado, decisiones locked, criterios y claims.
-
Importante
Un puntero
path#anclacon condición de recuperación (retrieve_when). Fuera de esa condición no devuelve contenido. -
Resumible
Un resumen breve con procedencia obligatoria:
source,locationy SHA-256 del archivo fuente.
Con OrkMind disponible, los punteros pueden resolverse mediante la memoria. El respaldo por archivos usa path#ancla, con motivo tipado de degradación.
Aprender de la entrega
De 0 a 5, ¿con cuánto criterio se entregó?
entrega limpia por el camino previsto
Demostración de la valoración, sin enviar una nota. La nota real exige autoría humana y justificación. Use ork master pedir para pedirla por un canal autenticado; ork master --batch muestra la cola.
Clases tipadas de postmortem
Los identificadores fijos permiten agrupar los fallos de forma consistente:
- sem-falha
- erro-de-spec
- base-avancou
- conflito
- rate-limit
- modelo
- processo
- scope-creep
- outra