Coding Backend Orchestration
Overview / When to Use
Use this workflow only when the user explicitly wants Guardian to launch or inspect an external coding assistant.
This is distinct from normal repo-grounded coding work:
- if the user asks Guardian to inspect, edit, patch, search, or test code directly, stay on the built-in coding tools
- if the user explicitly says to use Codex, Claude Code, Gemini CLI, or Aider, launch that backend with
coding_backend_run - mentioning a backend as the subject of a question is not enough to relaunch it
Process
- Confirm the active coding session or list available sessions with
code_session_currentorcode_session_listif the target workspace is unclear. - If needed, inspect available backends with
coding_backend_list. - Launch the requested backend with
coding_backend_runfrom the active coding session workspace. - If the user is asking whether a delegated run finished or what happened, use
coding_backend_status. - After a backend run completes, verify the result with
code_git_diffand the strongest relevant checks such ascode_test,code_build, orcode_lint. - Report backend output as delegated work, not as if Guardian performed the edits directly.
Red Flags
- Treating "Why did Codex do that?" as permission to start a new Codex run.
- Launching an external backend when the user only asked for direct repo inspection.
- Reporting delegated backend work as successful without verification.
- Running a backend outside the active coding session workspace.
Verification
- The user explicitly requested an external coding backend.
- The delegated run stayed anchored to the active coding session workspace.
- You checked completion or recent runs with
coding_backend_statuswhen needed. - You verified the delegated result with
code_git_diff,code_test,code_build, orcode_lintbefore reporting success.
Source: Threat-Vector-Security/guardian-agent — distributed by TomeVault.