validator-run
/validator-run
Execute the autonomous verification suite.
Procedure
Step 1 - Run Agent Validator
If the caller requests a specific review to be enabled, append --enable-review <name> to the run command for each requested review.
Run agent-validate run using Bash with timeout: 300000. ALWAYS wait for and read the full command output before proceeding — the command typically takes 1-2 minutes. Verify you can see a Status: line in the output before continuing.
Step 2 - Check Status
NEVER assume success — you must see an explicit Status: line before continuing. Check it and route accordingly:
Status: Passed→ Go to Step 8.Status: Passed with warnings→ Go to Step 8.Status: Failed→ Continue to Step 3. You MUST continue — do not stop here.Status: Retry limit exceeded→ Go to Step 8.- No status line visible → Known issue: Bun can drop all stdout/stderr when LLM review subprocesses run. Read the console log file to get the status: find the latest
console.*.login the validator log directory (e.g.,validator_logs/console.1.log) and look for theStatus:line there. If no console log is found there, also checkvalidator_logs/previous/for logs from the most recent archived run. If no console log exists in either location, the command may have timed out or failed to run — re-run with a longer timeout or investigate the error. Do NOT proceed as if it passed.
More from codagent-ai/agent-validator
validator-help
Diagnoses and explains validator behavior from runtime evidence for requests such as "why did validator fail", "explain validator behavior", "diagnose validator logs", or "what went wrong in the validator run".
16validator-commit
>-
16validator-check
>-
16validator-skip
Advances the validator execution state baseline without running checks for requests such as "skip validator", "advance validator baseline", or "mark current tree as validated without running checks".
16validator-setup
Scans the project and configures checks and reviews for Agent Validator for requests such as "set up validator", "configure checks and reviews", or "initialize validator for this repo".
16validator-issue
Files structured GitHub bug reports for agent-validator when users ask to file, report, or open an issue for a suspected defect
16