Agent Execution Protocol¶

Thomas is not the shell operator, permission clicker, or router.

SSH + Remote Commands¶

Batch all related remote operations into ONE session:

ssh bluefly-platform 'bash -s' <<'REMOTE'
set -e
command_1
command_2
gc status
bd list
git status
docker ps
REMOTE

Target: REMOTE_SESSION_COUNT=1 | COMMANDS_PER_SESSION=MANY | HUMAN_APPROVAL_LOOPS=0

Never SSH once per command for logically related operations. Gather the full investigation list first, then execute in one batch.

Approval Budget¶

APPROVAL_BUDGET_PER_LOGICAL_TASK <= 1

Design work so one approval covers all related remote operations. Consolidate further if needed — never return "I need you to approve this" for routine engineering operations.

Plan Before Execute¶

Determine what information is actually needed before making any remote call. Batch the full investigation. Think first. Execute second.

Local Work Does Not Wait on Oracle¶

TASK_BLOCKED != AGENT_BLOCKED

Proceed locally without waiting on remote dependencies: - Reading any corpus (Engineering-Standard, etc.) - Classifying, comparing, merging documents - Repository searches and git history inspection - Preparing changes, writing source, running local tests - Worktree preparation and static analysis

Route the remote dependency through BLU. Continue local execution.

No Narration¶

Do not narrate commands. Execute. Return material state:

DONE=
SHIPPED=
MERGED=
BLOCKED=
ROUTED=
NEXT=

No Polling¶

Record pipeline/task state. Continue another ready Bead. Return when an actionable state transition exists — the system delivers notifications.

Execution Priority (per turn)¶

1.  READ CURRENT BEAD
2.  CHECK BLU ASSIGNMENT
3.  DETERMINE NEXT MATERIAL OUTCOME
4.  BATCH INVESTIGATION
5.  EXECUTE WITHOUT HUMAN INTERRUPTION
6.  IMPLEMENT
7.  TEST
8.  PUSH
9.  MR → release/v0.1.x
10. VERIFY
11. REPORT TO BLU
12. CLAIM NEXT READY WORK

Human-Only Actions¶

Required: legal/business decisions, spend/contract, final release to main, unavailable human credential, irreversible reserved actions, third-party admin with no service identity.

NOT required: grep, git, gc, bd, SSH investigation, MR/CI inspection, file reads, source changes, tests, documentation, routine infrastructure investigation.

Docs Curation: Read Locally¶

Corpus is local. Read → classify → compare → curate → merge → rename → move → update links → validate, all locally. Oracle is for work authority and coordination only. Batch Beads coordination separately.

Success Condition¶

BEADS_UPDATED=YES
WORK_EXECUTED=YES
MRS_CREATED_OR_MERGED=YES
BLOCKERS_ROUTED=YES
NO_REPEATED_PERMISSION_PROMPTS=YES
NO_ROUTINE_HUMAN_ROUTING=YES

If a task requires 25 human clicks per minute, the execution plan is wrong. Fix the execution plan.