Practitioner guide · checked Aug 2026Guía práctica · revisada ago 2026

From persistent agent to shipped change. Del agente persistente al cambio publicado.

A field guide to Hermes Agent, Orca ADE, and the operating habits that turn agent activity into reviewed, verifiable software. Una guía de campo sobre Hermes Agent, Orca ADE y los hábitos operativos que convierten la actividad de agentes en software revisado y verificable.

Morgan’s working stack: Hermes Agent for persistent, reusable agent work; Orca ADE as the daily control plane for agentic development. This is a practitioner perspective—not a universal ranking. El conjunto de herramientas (stack) de Morgan: Hermes Agent para trabajo persistente y reutilizable; Orca ADE como plano de control diario para desarrollo agéntico. Es una perspectiva práctica, no una clasificación universal.

Memory is not model trainingLa memoria no entrena el modelo

Hermes can reload saved facts and reusable procedures. It does not silently update the model’s weights or make every future session omniscient.Hermes puede recargar hechos guardados y procedimientos reutilizables. No actualiza silenciosamente los pesos del modelo ni vuelve omnisciente cada sesión futura.

A worktree is not a security sandboxUn espacio de trabajo Git no es un aislamiento de seguridad

Orca isolates branches and files for parallel work. The agent still inherits whatever operating-system, credential, and network access its process is given.Orca separa ramas y archivos para trabajo paralelo. El agente aún hereda el acceso al sistema operativo, las credenciales y la red que reciba su proceso.

01 · Operating model01 · Modelo operativo

Autonomy needs a contract.La autonomía necesita un contrato.

Good agentic development is not “let the bot cook.” It is a visible loop with an owner, a bounded workspace, evidence, and a human decision at the end.El buen desarrollo agéntico no es «dejar que el bot haga lo suyo». Es un ciclo visible con responsable, espacio de trabajo limitado, evidencia y una decisión humana al final.

01

DefineDefinir

State the outcome, owned files, constraints, and what “done” must prove.Declara el resultado, archivos propios, límites y qué debe demostrar «listo».

02

IsolateAislar

Choose a branch, worktree, backend, account, and credential boundary.Elige rama, worktree, backend, cuenta y límite de credenciales.

03

ExecuteEjecutar

Give the agent only the context and tools needed for this milestone.Dale al agente solo el contexto y herramientas necesarios para este hito.

04

CheckpointCheckpoint

Ask what changed, what failed, what is uncertain, and what happens next.Pregunta qué cambió, qué falló, qué es incierto y qué sigue.

05

VerifyVerificar

Inspect the diff and run the relevant tests, previews, and safety checks.Inspecciona el diff y ejecuta pruebas, vistas previas y controles de seguridad.

06

Ship & learnPublicar y aprender

Commit reviewed work; only then promote stable facts or procedures for reuse.Confirma el trabajo revisado; solo después promueve hechos o procedimientos estables.

The useful unit of progress is a checkpointLa unidad útil de progreso es un checkpoint

Agent typing is activity. A checkpoint is evidence: a scoped change, verification results, known uncertainty, and a review request. This is the bridge between a capable agent and trustworthy delivery.La escritura del agente es actividad. Un checkpoint es evidencia: un cambio acotado, resultados de verificación, incertidumbre conocida y una solicitud de revisión. Es el puente entre un agente capaz y una entrega confiable.

Deep dive · persistent agent runtimeA fondo · runtime de agente persistente

Hermes Agent

An open-source, provider-agnostic agent runtime that combines models, tools, persistent state, reusable procedures, multiple execution backends, and messaging surfaces.Un runtime de agente de código abierto e independiente del proveedor que combina modelos, herramientas, estado persistente, procedimientos reutilizables, varios backends y superficies de mensajería.

It is an agent runtime, not the underlying model.Es un runtime de agente, no el modelo subyacente.

Its value grows when memory, skills, tools, and access boundaries are deliberately designed.Su valor crece cuando memoria, skills, herramientas y límites de acceso se diseñan deliberadamente.

Model choiceElección de modelo

Provider-agnostic configurationConfiguración independiente del proveedor

Persistent layerCapa persistente

Profiles, memory, skills, sessions, schedulesPerfiles, memoria, skills, sesiones y horarios

ExecutionEjecución

Local, container, SSH, and other backendsBackends local, contenedor, SSH y otros

InterfacesInterfaces

Terminal, dashboard, browser, messaging gatewaysTerminal, panel, navegador y gateways de mensajería

How the pieces fitCómo encajan las piezas

Start with identity and access, then add persistence and more surfaces. Reversing that order is how a convenient assistant quietly becomes an over-permissioned system.Empieza por identidad y acceso, después añade persistencia y más superficies. Invertir ese orden convierte silenciosamente un asistente cómodo en un sistema con permisos excesivos.

01

ProfilePerfil

Own config, credentials, persona, sessions, memory, skills, jobs, and logs.Configuración, credenciales, persona, sesiones, memoria, skills, tareas y logs propios.

02

Provider + modelProveedor + modelo

The reasoning engine and its cost, latency, and capability tradeoffs.El motor de razonamiento y sus compromisos de costo, latencia y capacidad.

03

Tools + backendHerramientas + backend

What can act, where it runs, and which files, network, or accounts it reaches.Qué puede actuar, dónde corre y a qué archivos, red o cuentas llega.

04

Memory + skillsMemoria + skills

Compact facts for continuity and procedures loaded when a task needs them.Hechos compactos para continuidad y procedimientos que se cargan cuando se necesitan.

05

Session + gatewaySesión + gateway

The active conversation, terminal, dashboard, bot roster, or messaging surface.La conversación activa, terminal, panel, lista de bots o superficie de mensajería.

Persistence: facts versus proceduresPersistencia: hechos frente a procedimientos

These two features are complementary. Treating either as automatic model learning creates brittle expectations—and can preserve the wrong thing.Estas dos funciones se complementan. Tratar cualquiera como aprendizaje automático del modelo crea expectativas frágiles y puede conservar lo equivocado.

MemoryMemoria

What is trueQué es cierto

Small, durable facts that help a later session resume with continuity: preferences, stable project conventions, decisions, or environment notes. Memory is loaded into context; it does not retrain model weights.Hechos pequeños y duraderos que ayudan a otra sesión a continuar: preferencias, convenciones estables, decisiones o notas del entorno. La memoria se carga en el contexto; no reentrena los pesos del modelo.

Good memory: “This repository uses bilingual English/Spanish copy and requires both themes to be tested.”Buena memoria: «Este repositorio usa contenido bilingüe inglés/español y exige probar ambos temas».

Skills

How to do itCómo hacerlo

Reusable instructions, resources, and scripts for a procedure. A skill is pulled in when relevant, so the main prompt stays smaller. Skills are executable supply-chain inputs: inspect, version, and test them.Instrucciones, recursos y scripts reutilizables para un procedimiento. Una skill se carga cuando es relevante para mantener pequeño el prompt principal. Son insumos ejecutables: inspecciónalos, versiónalos y pruébalos.

Good skill: a release checklist with required build commands, browser checks, rollback notes, and expected evidence.Buena skill: una lista de lanzamiento con comandos de build, pruebas de navegador, notas de rollback y evidencia esperada.

Build in this orderConstruye en este orden

Earn persistence one boundary at a time.Gana persistencia límite por límite.

The fastest setup is not the one with every gateway and schedule enabled. It is the smallest setup that can finish one real workflow safely and repeatably.La configuración más rápida no es la que activa cada gateway y horario. Es la más pequeña que termina un flujo real de forma segura y repetible.

Set up one profile for one responsibilityConfigura un perfil para una responsabilidad

Keep its provider, credentials, persona, sessions, memory, skills, jobs, and logs together. A profile separates Hermes state; it does not hide the rest of your filesystem.Mantén juntos proveedor, credenciales, persona, sesiones, memoria, skills, tareas y logs. Un perfil separa el estado de Hermes; no oculta el resto del sistema de archivos.

Choose the narrowest execution backendElige el backend más limitado

Local execution inherits your user account. Containers depend on mounts, network, and credentials. SSH is remote access—not automatic isolation. Match the boundary to the risk.La ejecución local hereda tu cuenta. Los contenedores dependen de mounts, red y credenciales. SSH es acceso remoto, no aislamiento automático. Ajusta el límite al riesgo.

Finish the workflow manually firstTermina el flujo manualmente primero

Watch the agent use tools, review outputs, and correct the operating contract before you preserve anything. A repeated mistake should not become institutional memory.Observa el uso de herramientas, revisa resultados y corrige el contrato antes de conservar algo. Un error repetido no debe convertirse en memoria institucional.

Promote stable facts and a verified skillPromueve hechos estables y una skill verificada

Save only durable context to memory. Turn the tested procedure into a skill with inputs, boundaries, verification, failure handling, and an owner.Guarda solo contexto duradero en memoria. Convierte el procedimiento probado en una skill con entradas, límites, verificación, manejo de fallos y responsable.

Add schedules and gateways lastAñade horarios y gateways al final

Begin scheduled work read-only; use allowlists and pairing on messaging surfaces. Automation multiplies both a good procedure and a bad permission decision.Empieza tareas programadas en modo lectura; usa allowlists y emparejamiento en mensajería. La automatización multiplica tanto un buen procedimiento como un mal permiso.

The advanced surfaceLa superficie avanzada

Hermes becomes a system, not just a chat loop. Each added surface is useful—and each creates another boundary to design.Hermes se vuelve un sistema, no solo un chat. Cada superficie añade utilidad y también otro límite que diseñar.

Profiles + Bot ModePerfiles + Bot Mode

A roster of specialized agents with separate Hermes state, models, memory, skills, credentials, routines, and histories. Use one responsibility per profile.Una lista de agentes especializados con estado, modelos, memoria, skills, credenciales, rutinas e historiales separados en Hermes. Usa una responsabilidad por perfil.

Messaging gatewaysGateways de mensajería

Reach an agent from supported chat platforms. Treat every gateway as an access-control surface: pair users, allowlist identities, and limit the network path.Accede al agente desde plataformas compatibles. Trata cada gateway como superficie de control: empareja usuarios, limita identidades y restringe la ruta de red.

Scheduled workTrabajo programado

Run agent jobs or narrower scripts on a schedule. Start read-only, keep credentials task-specific, and make success or failure observable.Ejecuta trabajos de agente o scripts más limitados por horario. Empieza en lectura, usa credenciales específicas y haz observable el éxito o fallo.

MCP + tool deferralMCP + carga diferida de herramientas

Connect external tools without loading every definition into every turn. Audit the server, credentials, and action scope—not just its description.Conecta herramientas externas sin cargar cada definición en cada turno. Audita servidor, credenciales y alcance de acciones, no solo su descripción.

Subagent delegationDelegación a subagentes

Fresh-context workers can investigate or execute in parallel. Give bounded outcomes and evidence; they may not be able to clarify or persist state like the parent.Workers con contexto fresco investigan o ejecutan en paralelo. Da resultados acotados y exige evidencia; quizá no puedan aclarar ni persistir estado como el padre.

Checkpoints + rollbackCheckpoints + rollback

An opt-in shadow history can help unwind agent edits. It is a recovery aid—not a substitute for real Git history, tests, or backups.Un historial paralelo opcional ayuda a revertir ediciones. Es una ayuda de recuperación, no sustituye historial Git, pruebas ni backups.

Keep approval prompts onMantén activas las aprobaciones

Approval and redaction heuristics are useful friction, not an adversarial sandbox. Never use broad bypass or “YOLO” modes on a trusted machine or with valuable credentials. Put untrusted work in a disposable, least-privilege boundary.Las aprobaciones y heurísticas de redacción son fricción útil, no un sandbox adversarial. Nunca uses modos de omisión amplia o «YOLO» en una máquina confiable o con credenciales valiosas. Coloca trabajo no confiable en un límite desechable y de mínimos privilegios.

Desktop or CLI—not one install pathEscritorio o CLI: rutas distintas

Hermes offers bundled desktop packages for Apple Silicon macOS and Windows, plus CLI installation on Linux, macOS, WSL2, and native Windows. Choose the official package for your platform; optional providers and integrations may still need network access.Hermes ofrece paquetes de escritorio para macOS Apple Silicon y Windows, además de instalación CLI en Linux, macOS, WSL2 y Windows nativo. Elige el paquete oficial de tu plataforma; proveedores e integraciones opcionales aún pueden necesitar red.

Move a profile; back up the systemMueve un perfil; respalda el sistema

A profile export excludes credentials and is not a complete backup. Use the documented backup/import path for a machine move, keep the backup private, and run hermes doctor before restoring scheduled work. Updates follow the installation’s package owner.La exportación de un perfil excluye credenciales y no es un respaldo completo. Usa la ruta documentada de backup/importación para cambiar de equipo, protege el respaldo y ejecuta hermes doctor antes de reactivar tareas programadas. Las actualizaciones dependen del método de instalación.

Try it: demonstrate a browser workflowPruébalo: demuestra un flujo de navegador

The workflow-record plugin records one Chromium tab, then /learn turns the demonstration into a reusable skill. It is an unsupported Hermes Labs / Community plugin, not a core feature. Install only after reviewing its source:El plugin workflow-record graba una pestaña de Chromium y /learn convierte la demostración en una skill reutilizable. Es un plugin Hermes Labs / Community sin soporte, no una función del núcleo. Revisa su código antes de instalarlo:

hermes plugins install workflow-record
hermes record --slug demo-read-only
  1. Use a test browser profile and demonstrate a read-only flow in one tab.Usa un perfil de prueba y demuestra un flujo de solo lectura en una pestaña.
  2. Inspect the saved JSON before using the printed /learn instruction. Plain text fields and URLs can contain secrets even though password-like fields are masked.Inspecciona el JSON guardado antes de usar la instrucción /learn que se muestra. Los campos de texto y URLs pueden contener secretos aunque se oculten contraseñas.
  3. Review the generated skill, then replay on test data. Add explicit approval for any write step.Revisa la skill generada y reproduce con datos de prueba. Añade aprobación explícita para cada escritura.
Workflow Record + limits ↗Workflow Record y límites ↗
Deep dive · agent development environmentA fondo · entorno de desarrollo de agentes

Orca ADE

A development control plane for agentic work: each task gets a Git worktree, agents and tools work around it, and the loop stays visible from investigation through review and shipping.Un plano de control para trabajo agéntico: cada tarea recibe un Git worktree, los agentes y herramientas trabajan a su alrededor y el ciclo permanece visible desde la investigación hasta la revisión y publicación.

It orchestrates development work; it is not the model doing the reasoning.Orquesta el trabajo de desarrollo; no es el modelo que razona.

It makes parallel agent work inspectable, reviewable, and easier to route.Hace que el trabajo paralelo sea inspeccionable, revisable y más fácil de dirigir.

Task unitUnidad de tarea

Issue + branch + Git worktreeTarea + rama + Git worktree

Agent layerCapa de agentes

Multiple supported CLI agents, including HermesVarios agentes CLI compatibles, incluido Hermes

Work surfacesSuperficies de trabajo

Terminals, editor, browser, previews, Design ModeTerminales, editor, navegador, vistas previas y Design Mode

Delivery loopCiclo de entrega

Checkpoints, annotated diffs, tests, commit, push, PRCheckpoints, diffs anotados, pruebas, commit, push y PR

The mental model: one task, one visible laneEl modelo mental: una tarea, un carril visible

The worktree is the organizing boundary. The checkpoint is the progress signal. The reviewed diff—not a persuasive chat transcript—is the artifact that moves toward production.El worktree es el límite organizador. El checkpoint es la señal de progreso. El diff revisado, no una conversación persuasiva, es el artefacto que avanza hacia producción.

01

IssueTarea

Outcome and acceptanceResultado y aceptación

02

Worktree

Branch and filesRama y archivos

03

AgentAgente

Reasoning and actionsRazonamiento y acciones

04

Checkpoint

Evidence and uncertaintyEvidencia e incertidumbre

05

ReviewRevisión

Diff and annotationsDiff y anotaciones

06

TestsPruebas

Behavior and regressionsComportamiento y regresiones

07

CommitCommit

Accepted stateEstado aceptado

08

PR

Shared delivery gatePuerta de entrega compartida

Daily workflowFlujo diario

Keep the task, agent, and evidence in one place.Mantén tarea, agente y evidencia en un solo lugar.

Orca is most useful when it becomes the control surface around the entire loop—not merely a launcher for another terminal.Orca es más útil cuando se vuelve la superficie de control de todo el ciclo, no solo un lanzador para otra terminal.

Create the lane from a concrete issueCrea el carril desde una tarea concreta

Give the worktree a single acceptance decision. Pull in repository instructions and integration context before an agent starts editing.Da al worktree una sola decisión de aceptación. Carga instrucciones del repositorio y contexto de integración antes de editar.

Launch the right agent in that boundaryLanza el agente adecuado en ese límite

Choose Hermes, Codex, Claude Code, Grok, Cursor, or another supported agent based on the task. Keep credentials and bypass settings narrower than the worktree.Elige Hermes, Codex, Claude Code, Grok, Cursor u otro agente compatible según la tarea. Mantén credenciales y omisiones más limitadas que el worktree.

Work through visible checkpointsTrabaja mediante checkpoints visibles

Read terminal progress, inspect files or previews, and require a compact evidence packet before routing the next instruction or another worker.Lee el progreso, inspecciona archivos o vistas previas y exige evidencia compacta antes de enviar la siguiente instrucción u otro worker.

Review the diff where it livesRevisa el diff donde vive

Annotate specific lines, batch feedback, and let the agent remediate in the same lane. A clean conversation cannot compensate for a risky diff.Anota líneas específicas, agrupa feedback y deja que el agente repare en el mismo carril. Una conversación limpia no compensa un diff riesgoso.

Run hooks and tests, then shipEjecuta hooks y pruebas; después publica

Verify behavior and regressions, resolve review comments, then commit, push, and open the PR from the accepted worktree state.Verifica comportamiento y regresiones, resuelve comentarios y luego haz commit, push y abre el PR desde el estado aceptado.

More than terminalsMás que terminales

A strong control plane reduces context switching while preserving the evidence a reviewer needs.Un plano de control sólido reduce cambios de contexto y conserva la evidencia que necesita quien revisa.

Worktree isolationAislamiento por worktree

Parallel tasks get separate branches and working files, reducing collisions between agents and making each diff attributable.Las tareas paralelas reciben ramas y archivos separados, reducen colisiones y hacen atribuible cada diff.

Editor, browser, previewsEditor, navegador y previews

Inspect source, running pages, files, and visual changes in the task context. Design Mode can turn a visual target into grounded feedback.Inspecciona código, páginas, archivos y cambios visuales en el contexto de la tarea. Design Mode convierte un objetivo visual en feedback concreto.

Agent routingEnrutamiento de agentes

Launch supported agents per task, send follow-up instructions, inspect terminals, and coordinate bounded waves instead of one giant shared context.Lanza agentes por tarea, envía instrucciones, inspecciona terminales y coordina oleadas acotadas en vez de un contexto gigante.

Annotated reviewRevisión anotada

Attach feedback to the changed lines, batch it into a remediation pass, and keep the critique connected to the artifact.Adjunta feedback a líneas cambiadas, agrúpalo para reparación y mantén la crítica conectada al artefacto.

Delivery integrationsIntegraciones de entrega

Connect issue and review workflows across supported Git and project systems without making the issue tracker the execution environment.Conecta tareas y revisiones en sistemas Git y de proyectos compatibles sin volver el tracker el entorno de ejecución.

Mobile steeringControl móvil

Monitor, steer, and perform light review away from the desk. Think companion surface—not a full mobile IDE.Monitorea, dirige y haz revisiones ligeras fuera del escritorio. Es una superficie complementaria, no un IDE móvil completo.

Where the work can runDónde puede ejecutarse el trabajo

Local desktopEscritorio local

Fastest feedback loopCiclo de feedback más rápido

Best when the repository, tools, and previews belong on your workstation. The agent process can reach whatever your local permissions allow.Ideal cuando repositorio, herramientas y previews viven en tu equipo. El proceso del agente alcanza lo que permitan tus permisos locales.

SSH

Worktree on another machineWorktree en otra máquina

Your local Orca owns the runtime; selected worktrees and terminals execute on the remote host. Secure credentials, forwarding, and cleanup; SSH alone is not a sandbox.Tu Orca local controla el entorno; los worktrees y terminales elegidos se ejecutan en el host remoto. Protege credenciales, forwarding y limpieza; SSH no es un sandbox.

Remote / headlessRemoto / headless

Persistent shared control planePlano de control persistente y compartido

A Remote Orca Server owns the full runtime and shared sessions. Use desktop sharing or headless orca serve, not both for the same setup. Pair clients securely and keep the host available.Un Remote Orca Server controla todo el entorno y las sesiones compartidas. Usa el escritorio compartido o orca serve sin interfaz, no ambos para la misma configuración. Empareja clientes de forma segura y mantén disponible el host.

A worktree prevents collisions—not compromiseUn worktree evita colisiones, no compromisos

Separate branches and files are an excellent development boundary, but they do not isolate processes, secrets, browser sessions, or the network. Keep agent permissions narrow, use disposable environments for untrusted code, and require human review before external side effects or deployment.Ramas y archivos separados son un excelente límite de desarrollo, pero no aíslan procesos, secretos, sesiones del navegador ni la red. Limita permisos, usa entornos desechables para código no confiable y exige revisión humana antes de efectos externos o despliegues.

Privacy claim: read it as a vendor statementPrivacidad: léela como afirmación del proveedor

Orca says its anonymous telemetry excludes prompts, agent output, terminal contents, repository names, paths, URLs, and file contents, and that telemetry can be disabled. That is useful policy context, not an independent audit; review current settings and the privacy page for your environment.Orca afirma que su telemetría anónima excluye prompts, salidas, terminales, nombres de repositorios, rutas, URLs y contenido de archivos, y que puede desactivarse. Es contexto de política, no una auditoría independiente; revisa configuración y privacidad vigentes.

Make the next handoff readableHaz legible el próximo traspaso

Orca’s worktree checkpoint pattern records a status comment and optional card status: what changed, what was checked, and what happens next. Read the existing comment before updating it. This is a coordination record, not a Git snapshot or proof that tests passed.El patrón de checkpoints de Orca registra un comentario y un estado opcional: qué cambió, qué se comprobó y qué sigue. Lee el comentario existente antes de actualizarlo. Es un registro de coordinación, no una instantánea Git ni prueba de que los tests pasaron.

Keep sessions, skills and browser context under controlControla sesiones, skills y contexto del navegador

Orca’s October 27 release adds shared-skill updates, chat/terminal choice, conversation forks, clearer Ask-mode edit approval, and remote session recovery. Choose shared, per-repository or per-workspace browser sessions deliberately: that choice controls how logins and browsing context carry forward.La versión del 27 de octubre añade actualización de skills compartidas, elección de chat o terminal, bifurcaciones de conversaciones, aprobación de ediciones más clara en modo Ask y recuperación remota. Elige sesiones de navegador compartidas, por repositorio o por espacio: controla cómo se conservan logins y contexto.

Keep installed skills matched to the running CLI with orca skills get. Experimental hibernation is off by default and applies only to eligible finished, idle resumable agents; Hermes and Cursor CLI are currently excluded. Reopen the worktree and verify session, permissions and folder before continuing.Mantén las skills alineadas con la CLI mediante orca skills get. La hibernación experimental está desactivada por defecto y solo admite agentes reanudables terminados e inactivos; actualmente excluye Hermes y Cursor CLI. Reabre el worktree y verifica sesión, permisos y carpeta antes de continuar.

October release ↗Versión de octubre ↗ · Skills registry ↗Registro de skills ↗ · Hibernation limits ↗Límites de hibernación ↗
04 · The pairing04 · La combinación

Hermes inside Orca: persistence meets control.Hermes dentro de Orca: persistencia con control.

They solve different layers. Orca gives the development task a visible lane; Hermes brings a capable, persistent runtime into that lane. The Git diff and tests remain the source of truth.Resuelven capas diferentes. Orca da a la tarea un carril visible; Hermes aporta un runtime capaz y persistente. El diff de Git y las pruebas siguen siendo la fuente de verdad.

Orca ADE logo

Orca ADE

Owns task isolation, agent launch, terminals, browser and preview context, checkpoints, diff review, tests, and the route to commit or PR.Gestiona aislamiento de tarea, lanzamiento, terminales, navegador y previews, checkpoints, revisión del diff, pruebas y ruta a commit o PR.

Hermes Agent logo

Hermes Agent

Owns agent execution, tool use, provider choice, profile identity, bounded memory, reusable skills, and delegated investigation inside the task boundary.Gestiona ejecución, herramientas, proveedor, identidad del perfil, memoria acotada, skills reutilizables e investigación delegada dentro del límite.

01 · ORCA

Define the issueDefinir la tarea

One outcome, ownership boundary, constraints, and acceptance checks.Un resultado, límite de propiedad, restricciones y criterios.

02 · ORCA

Create the worktreeCrear el worktree

Separate branch and files; load repository instructions and setup hooks.Separa rama y archivos; carga instrucciones y hooks.

03 · HERMES

Select profile + backendElegir perfil + backend

Use a task-appropriate identity, tools, model, credentials, and execution boundary.Usa identidad, herramientas, modelo, credenciales y límite adecuados.

04 · HERMES

Investigate, then editInvestigar y editar

Ground the plan in the repository and delegate bounded research when useful.Basa el plan en el repositorio y delega investigación acotada si ayuda.

05 · BOTH

Post a checkpointPublicar checkpoint

Files changed, checks run, failures, assumptions, risks, and recommendation.Archivos, pruebas, fallos, supuestos, riesgos y recomendación.

06 · ORCA

Review and annotateRevisar y anotar

Inspect the diff and running result; attach feedback to the artifact.Inspecciona diff y resultado; adjunta feedback al artefacto.

07 · BOTH

Remediate and verifyReparar y verificar

Fix findings in the same lane; rerun targeted tests plus regression checks.Corrige en el mismo carril; repite pruebas objetivo y regresiones.

08 · HUMAN

Accept, ship, then teachAceptar, publicar y enseñar

Commit or PR the accepted state. Promote only verified learning to memory or a skill.Haz commit o PR del estado aceptado. Promueve solo aprendizaje verificado.

A reusable handoff contractUn contrato de traspaso reutilizable

Paste this into an issue, an Orca worktree brief, or a Hermes session. Replace the brackets; keep the proof fields.Pégalo en una tarea, un brief de worktree en Orca o una sesión de Hermes. Reemplaza los corchetes y conserva los campos de evidencia.

Agentic milestone contractContrato de hito agéntico
OUTCOME
[One independently acceptable result]

BOUNDARY
- Worktree / branch: [name]
- Owned files or surfaces: [exact scope]
- Do not touch: [protected scope]
- Credentials / network: [least access needed]

CONSTRAINTS
- [product, security, compatibility, or style rules]
- No external side effects without approval.

ACCEPTANCE
- [observable check 1]
- [observable check 2]
- [regression check]

CHECKPOINT EVIDENCE
- scope
- files_or_surfaces
- commands_or_checks
- assumptions
- failures
- risks
- confidence
- recommendation

STOP CONDITIONS
- Ask before: [deployment, migration, deletion, credential use]
- Escalate if: [unclear ownership, failed safety check, scope drift]RESULTADO
[Un resultado aceptable de forma independiente]

LÍMITE
- Worktree / rama: [nombre]
- Archivos o superficies propias: [alcance exacto]
- No tocar: [alcance protegido]
- Credenciales / red: [acceso mínimo necesario]

RESTRICCIONES
- [reglas de producto, seguridad, compatibilidad o estilo]
- Sin efectos externos sin aprobación.

ACEPTACIÓN
- [prueba observable 1]
- [prueba observable 2]
- [prueba de regresión]

EVIDENCIA DEL CHECKPOINT
- alcance
- archivos_o_superficies
- comandos_o_pruebas
- supuestos
- fallos
- riesgos
- confianza
- recomendación

CONDICIONES DE PARADA
- Preguntar antes de: [despliegue, migración, borrado, credenciales]
- Escalar si: [propiedad incierta, prueba fallida, deriva de alcance]

05 · Adjacent tools05 · Herramientas cercanas

Choose the layer, not the label.Elige la capa, no la etiqueta.

“Agent,” “bot,” “memory,” and “skill” are used for different mechanisms. The practical question is: what persists, what can act, where does it run, and how will you review it?«Agente», «bot», «memoria» y «skill» nombran mecanismos distintos. La pregunta práctica es: ¿qué persiste, qué puede actuar, dónde corre y cómo lo revisarás?

Research correction: demonstrated workflow replay is Grok BotCorrección de investigación: la repetición de flujos demostrados es de Grok Bot

The exact feature “follow along while I do the workflow, save it as a routine, then run it later” is documented for Grok Bot. Claude’s nearest features are Skills—authored procedural packages—and memory or Claude Code auto-memory for context, preferences, corrections, and patterns. Those are useful, but they are not the same mechanism.La función exacta «observa mientras hago el flujo, guárdalo como rutina y ejecútalo después» está documentada para Grok Bot. Las funciones cercanas de Claude son Skills —paquetes de procedimientos escritos— y memoria o auto-memory de Claude Code para contexto, preferencias, correcciones y patrones. Son útiles, pero no son el mismo mecanismo.

If you need…Si necesitas…Look at…Considera…What it actually providesLo que realmente aportaBoundary to rememberLímite a recordar
A persistent, tool-using agent runtimeUn runtime persistente con herramientasHermes AgentProfiles, provider choice, tools, memory, skills, sessions, gateways, schedules, delegation, and multiple backends.Perfiles, proveedor, herramientas, memoria, skills, sesiones, gateways, horarios, delegación y varios backends.A profile separates Hermes state—not filesystem or process access.Un perfil separa estado de Hermes, no acceso a archivos o procesos.
Parallel agentic coding with reviewCódigo agéntico paralelo con revisiónOrca ADEPer-task worktrees, supported agents, terminals, editor/browser context, checkpoints, annotated diffs, tests, and delivery routing.Worktrees por tarea, agentes compatibles, terminales, editor/navegador, checkpoints, diffs anotados, pruebas y entrega.A worktree isolates branches and files—not credentials, network, or processes.Un worktree separa ramas y archivos, no credenciales, red o procesos.
A packaged repeatable Claude procedureUn procedimiento repetible para ClaudeClaude SkillsSkills de ClaudeAuthored folders of instructions, scripts, and resources that Claude activates for relevant work. Claude Code can turn repeated workflows into a skill file.Carpetas escritas con instrucciones, scripts y recursos que Claude activa según la tarea. Claude Code puede convertir flujos repetidos en una skill.A skill is packaged procedure, not model training or automatic replay of a live demonstration.Una skill es un procedimiento empaquetado, no entrenamiento ni repetición automática de una demostración.
Continuity in Claude across workContinuidad en Claude entre trabajosClaude memory / auto-memoryMemoria / auto-memory de ClaudeRetains useful context, preferences, corrections, and patterns so later work starts better informed.Conserva contexto, preferencias, correcciones y patrones para que el trabajo futuro empiece mejor informado.Memory is contextual continuity—not a deterministic automation routine.La memoria da continuidad contextual, no una rutina de automatización determinista.
Teach a browser workflow by showing itEnseñar un flujo de navegador mostrándoloGrok Bot routinesroutinesA persistent bot in beta with a cloud computer can watch steps, save the workflow as a routine, and rerun it on demand or schedule.Un bot persistente en beta con computadora en la nube puede observar pasos, guardar el flujo como rutina y repetirlo bajo demanda o por horario.Bots share one cloud computer; bot identity is not isolation for sign-ins, browser state, or files.Los bots comparten una computadora en la nube; su identidad no aísla sesiones, navegador ni archivos.
A coding engine inside the laneUn motor de código dentro del carrilCodex, Claude Code, Grok, Cursor, Hermes, and other CLI agentsCodex, Claude Code, Grok, Cursor, Hermes y otros agentes CLIReasoning, code changes, tools, and agent-specific capabilities. Orca can provide the surrounding lane and review loop.Razonamiento, cambios de código, herramientas y capacidades propias. Orca puede aportar el carril y ciclo de revisión.Model quality does not replace repository grounding, access control, tests, or review.La calidad del modelo no sustituye contexto del repo, control de acceso, pruebas ni revisión.
06 · Safe operation06 · Operación segura

Design the blast radius before the prompt.Diseña el radio de impacto antes del prompt.

A better prompt cannot repair an unsafe process boundary. Decide what the agent can reach, what requires approval, and what evidence closes the task before execution begins.Un mejor prompt no repara un límite inseguro. Decide qué puede alcanzar el agente, qué exige aprobación y qué evidencia cierra la tarea antes de ejecutar.

01

Match isolation to trustAjusta el aislamiento a la confianza

Trusted code may run locally with narrow permissions. Unknown repositories, attachments, scraped instructions, or generated scripts belong in disposable containers, sandboxes, or remote hosts.Código confiable puede correr localmente con permisos limitados. Repositorios, adjuntos, instrucciones web o scripts desconocidos van en contenedores, sandboxes o hosts desechables.

02

Issue task-specific credentialsUsa credenciales específicas

Use the least scope, shortest useful lifetime, and environment-specific account. Keep production, personal browser sessions, SSH keys, and broad cloud tokens out of routine agent reach.Usa el menor alcance, vida útil corta y cuenta específica del entorno. Mantén producción, sesiones personales, llaves SSH y tokens amplios fuera del alcance rutinario.

03

Preserve approval gatesConserva puertas de aprobación

Require human confirmation for deployment, deletion, migration, credential changes, purchases, external messages, or other hard-to-reverse actions. Convenience bypasses belong only in disposable trusted experiments.Exige confirmación para despliegues, borrado, migraciones, credenciales, compras, mensajes externos u otras acciones difíciles de revertir. Las omisiones solo van en experimentos desechables.

04

Treat instructions as untrusted inputTrata instrucciones como entrada no confiable

Repository files, skills, MCP servers, websites, tickets, and tool output can all carry dangerous or misleading instructions. Inspect provenance and keep tool scope narrower than the text the model reads.Archivos, skills, servidores MCP, sitios, tickets y salidas pueden traer instrucciones peligrosas. Inspecciona procedencia y limita herramientas más que el texto leído por el modelo.

05

Make unattended work observableHaz observable el trabajo desatendido

Schedules, gateways, and remote agents need allowlists, bounded workspaces, explicit success/failure signals, logs without secrets, rate limits, and a tested way to stop them.Horarios, gateways y agentes remotos necesitan allowlists, espacios acotados, señales claras, logs sin secretos, límites de uso y una forma probada de detenerlos.

06

Keep independent proofConserva evidencia independiente

Use real Git history, targeted tests, regression checks, previews, backups, and independent review. Agent summaries and built-in checkpoints help navigation; they are not proof on their own.Usa historial Git real, pruebas objetivo, regresiones, previews, backups y revisión independiente. Resúmenes y checkpoints ayudan a navegar; no demuestran por sí solos.

The final gate is a human acceptance decisionLa puerta final es una decisión humana de aceptación

Before shipping: the intended diff is understood, required checks pass, unresolved risk is named, rollback is possible, and the person accepting the milestone has authority over the affected system.Antes de publicar: se entiende el diff, pasan las pruebas, se nombran riesgos sin resolver, existe rollback y quien acepta el hito tiene autoridad sobre el sistema afectado.

07 · Choose your path07 · Elige tu camino

Depth when you need it.Profundidad cuando la necesitas.

This page is the practitioner layer. Use the other guides for first principles, model choice, company ecosystems, CLI setup, MCP, and instruction files.Esta página es la capa práctica. Usa las otras guías para fundamentos, modelos, ecosistemas, configuración CLI, MCP y archivos de instrucciones.

Land hereLlega aquí

A reviewed change is a complete outcome.Un cambio revisado es un resultado completo.

Stop when the intended diff is understood, targeted checks pass, failures and risks are named, and an authorized person accepts the merge-ready change. Your proof is the milestone contract plus independent evidence.Para cuando se entienda el diff, pasen las pruebas objetivo, se nombren fallos y riesgos y una persona autorizada acepte el cambio listo para integrar. Tu prueba es el contrato de hito más evidencia independiente.

Continue whenContinúa cuando

The change must become a service.El cambio debe convertirse en servicio.

Move into Ship & Operate when users, deployment, data, access, telemetry, cost, incidents, or rollback enter the boundary. That next stage produces an operability contract.Pasa a Publicar y operar cuando entren usuarios, despliegue, datos, acceso, telemetría, costo, incidentes o rollback. Esa etapa produce un contrato de operación.

Continue to Ship & Operate →Continuar a Publicar y operar →
Starting AIIntroducción a IA

Build the core mental modelConstruye el modelo mental básico

Tasks, models, context, judgment, prompts, workspaces, and a guided path for getting useful results.Tareas, modelos, contexto, criterio, prompts, espacios de trabajo y una ruta guiada para lograr resultados útiles.

Advanced AI OnboardingOnboarding avanzado de IA

Map the broader agent ecosystemMapea el ecosistema de agentes

Context routing, company offerings, local and remote agents, CLI prerequisites, MCP, instructions, and coordination.Ruteo de contexto, ofertas, agentes locales y remotos, requisitos CLI, MCP, instrucciones y coordinación.

Tool AtlasAtlas de herramientas

Open one focused tool lessonAbre una lección enfocada

Compare the room, workflow, features, and review boundary for the AI tool you want to learn next.Compara la superficie, el flujo, las funciones y el límite de revisión de la herramienta de IA que quieras aprender.

Ship & OperatePublicar y operar

Make the shipped change operableHaz operable el cambio publicado

Apply software-engineering, cloud, CI/CD, reliability, observability, and rollback foundations.Aplica fundamentos de ingeniería, cloud, CI/CD, confiabilidad, observabilidad y rollback.

Govern & ProtectGobernar y proteger

Bound agent, MCP, data, and action riskLimita riesgos de agentes, MCP, datos y acciones

Use NIST governance, privacy review, OWASP threat paths, controls, evidence, and incident readiness.Usa gobernanza NIST, privacidad, amenazas OWASP, controles, evidencia e incidentes.