Skip to main content

Autonomy Command — Suit Default Operating Model

v4.0 · Codex terms 67–68 · Skill: orchestrator · temperament-aware ceremony


What it is​

The autonomy command is the default operating model when the 0xRay suit is worn. Users describe goals in plain language ("fix this", "continue P0.1", "ship it") — not framework keywords. The lead agent takes the helm, creates phased plans with todos, delegates to the best subagents, and loops until tests are green.

Problem it solves: keyword-gated skills, unused todo lists, buck-passing, skipped researcher/architect/code-reviewer on major work, and "not my job" syndrome.

Lead cadence: a peer wearing the suit continues from Station + Repertoire without a command stream. Dummy tests SKILLS.md. Same-sess bodies keep a Station card. Branch + worktree + PR. Ship when mill-gate D + foundry gate PASS — green CI is not ship. OTP then poll the published version. Loop until Station is done. Live ticks, not idle pacers. Disk SSOT: grok-bot/ops/LEAD-CADENCE.md. Playbook stays the orchestrator skill (Codex 69 — no new skill).


On guided/strict hosts, intake (analyze-complexity) is required before spawn. On frontier, the engine is available but spawn warns instead of denying. Governance (Codex 11/29/69) is always on.

Kernel-level activation (v4.0 — temperament)​

Lead-dev mode is wired through multi_agent_orchestration in features.json and host hooks (no separate autonomy_kernel block):

LayerMechanismWhat it does
SessionStart hookdist/integrations/grok/hooks/session-start.jsBoots lead-dev mode; writes session-boot.json
PreToolUse hookpre-tool-use.jsCodex deny + synthesis/pending/spawn gates + per-suite triage hint
Orchestrator MCPanalyze-complexityPersists phased plan + todos to lead-dev-plan.json
features.jsonmulti_agent_orchestration.lead_dev_modeKernel config SSOT (threshold, triage, consults)
Skillautonomy-commandHuman-readable playbook (synced on grok install)
"multi_agent_orchestration": {
"lead_dev_mode": true,
"per_suite_test_triage": true,
"phased_plan_threshold": 25,
"auto_consult_major_work": true,
"auto_chain_delegations": true
}

First substantive task in every session: xray-orchestrator → analyze-complexity({ tasks: [...] })

When it activates​

ConditionResult
npm install 0xray + npx 0xray grok installHooks + MCP + skills synced
Grok SessionStartAutonomy kernel boot JSON on stdout
Substantive user taskAgent calls analyze-complexity → phased todos
Full test suite commandPreToolUse emits per_suite_triage_required hint

Tier 1 consumers (repertoire, groover, chrono-warp-drive) may add npm run confirm:suit for layered boot checks.


The seven rules​

  1. Phased plan + todos — Every multi-step effort gets phases with detailed todos. Assign the best subagent per item. Monitor output. Iterate until done.
  2. Take the helm — Loop: implement → test → fix → repeat. Do not stop for permission or status theater.
  3. Per-suite test triage — After major changes, run individual test suites, triage, fix, rerun. Full suite only when all affected suites pass.
  4. Delegate, don't abdicate — Lead stays on the main thread, reactive to the user. Subagents execute. Lead monitors and updates todos.
  5. Read all output — Console, stderr, test logs. Triage every failure. Rerun until clean.
  6. No buck-passing — Never defer errors as "pre-existing." Add a todo and resolve.
  7. Resolve all errors — Zero open failures at phase completion.

Lead-dev loop​

INTAKE → CLASSIFY (analyze-complexity + trap check)
→ PLAN (complexity >25: strategist + architect-tools)
→ DISPATCH (orchestrate-task / Task subagent)
→ MONITOR (lead reads all output; TodoWrite)
→ TEST (per-suite triage → full suite gate)
→ DONE or loop

Hard stops (human only): secrets/OAuth, production deploy/cron, explicit user redirect.


Subagent routing​

TaskSubagentMCP
Strategic phasingstrategistorchestrate-task
Major refactor / architecturearchitect-toolscontext-analysis, architecture-assessment
Research / prior artresearchersearch_codebase, get_documentation
Implementationbackend-engineer / frontend-engineerorchestrate-task
Test failuresbug-triagetriage → fix → rerun
Pre-merge reviewcode-reviewcheck_best_practices
Trap-classified workarchitect + repertoirerepertoire__get_task_confidence (stdio)
Codex gateenforcercodex-enforcement

Before major planning or refactors: invoke researcher + architect-tools + code-review — automatically, not only when the user names them.


Agent panel consensus (2026-06-18)​

AgentRecommendation
StrategistDefault ON after suit boot; complexity >25 requires phased plan before edits
Architect-toolsDocument sync via AGENTS-consumer.md postinstall; architectural review on major refactors
ResearcherUse search_codebase / get_documentation when governance LLM unavailable
Code-reviewerPer-suite triage; lead owns every error; skill doc passes 100/100 best practices

Operationalization in core repos​

RepoBoot checkAGENTS.md
xraynpx 0xray healthFramework + AGENTS-consumer.md (ships on postinstall)
repertoirenpm run confirm:suit§ Default operating mode
groovernpx 0xray health§ Default operating mode
chrono-warp-drivenpx 0xray health§ Default operating mode

Skill source: src/skills/autonomy-command/SKILL.md · synced to ~/.grok/skills/ on npx 0xray grok install.