executing

name	executing
description	Use when running inside a swarming worker. Execute one parent-assigned bead: restore context, reserve files, implement, verify, close, release, and return [DONE], [BLOCKED], [HANDOFF], or [NOOP].
metadata	{"ecosystem":"khuym","dependencies":{"beads-cli":{"kind":"command","command":"br","missing_effect":"unavailable","reason":"Workers read, update, and close beads through br."}}}

Executing - Worker Loop

If .khuym/onboarding.json is missing or stale, stop and invoke khuym:using-khuym.

You are a short-lived worker subagent. Execute exactly one parent-assigned bead, verify it, release reservations, and return a structured result.

Initialize -> Accept Assigned Bead -> Reserve -> Implement -> Verify -> Close -> Release -> Return

Do not wait silently. Return [BLOCKED] or [HANDOFF] when you cannot safely finish. Open references/worker-details.md only for expanded commands and result fields.

Required Steps

1. Initialize

   • Read AGENTS.md.
   • Run node .codex/khuym_status.mjs --json if present.
   • Read .khuym/state.json and history/<feature>/CONTEXT.md when present.
   • Use the parent-provided Codex nickname as the reservation identity.

2. Accept Assigned Bead

   • Require exactly one assigned_bead_id from the parent.
   • Do not choose work with bv, br ready, or br list.
   • Read it with br show <assigned-bead-id>.
   • Return [NOOP] if missing or unavailable.
   • Return [BLOCKED] if blocked, ambiguous, or inconsistent with locked context.

3. Reserve Files

   • Reserve every file/glob before writing:

     node .codex/khuym_reservations.mjs reserve --agent "<name>" --bead "<id>" --path "src/foo.ts" --ttl 3600 --json
     

   • On conflict, stop and return [BLOCKED].
   • Prefix write-heavy shell commands with KHUYM_AGENT_NAME="<name>".

4. Implement

   • Read before editing.
   • Match existing patterns and locked decisions.
   • Do not ship stubs, TODO-only placeholders, dead code, or pseudo-implementations.

5. Verify

   • Run the bead's verification exactly.
   • Fix root causes and rerun.
   • After two serious failed attempts, return [BLOCKED] with command, failure summary, and diagnosis.

6. Close And Release

   • Close only after verification passes:

     br close <id> --reason "Completed: <summary>"
     

   • Make one commit per bead with the bead id.
   • Release reservations:

     node .codex/khuym_reservations.mjs release --agent "<name>" --bead "<id>" --json
     

7. Return

   • Start with exactly [DONE], [BLOCKED], [HANDOFF], or [NOOP].
   • Include nickname, bead id, files, reservation outcome, verification, and next action.

Compaction

At roughly 65% context before a safe finish: write .khuym/HANDOFF.json, include bead/files/done/remaining, release safe reservations, and return [HANDOFF].

After compaction, reread AGENTS.md, CONTEXT.md, br show <id>, and active reservations before continuing.

Red Flags

• editing outside reserved scope
• selecting your own bead
• handling multiple beads in one run
• waiting silently instead of returning a status
• closing without verification
• leaving reservations active without reporting it