schema_version = 8
id = "visual-engineering"
version = "8.0.0"
display_name = "Visual Engineering"
description = "A multimodal Sol root implements directly from references, optionally uses a fast native analyst, and verifies real browser renders in a fresh isolated context."
tags = ["multimodal", "browser", "accessibility", "featured"]
maturity = "featured"
root = "visual_lead"
smoke = "smoke.toml"

[agents.visual_lead]
kind = "root"
description = "Direct reference-to-code implementer, sole writer, and final visual authority"
model = "codex_chatgpt_builtin__gpt_5_6_sol"
reasoning = "high"
allowed_reasoning_efforts = ["medium", "high", "xhigh", "max"]
execution_mode = "goal"
goal_token_budget = 400000
max_goal_token_budget = 700000
stall_warning_seconds = 3600
finalization_grace_seconds = 1800
plan_reasoning = "high"
permissions = "workspace-write"
can_spawn = ["visual_analyst", "visual_verifier"]
max_active = 1
trust = "high"
verification = "always"
attachments_allowed = true
requires_modalities = ["text", "image"]
requires_tool_images = true
instructions = "agents/visual-lead.md"

[agents.visual_analyst]
description = "Optional native analyst for complex multi-screen references"
model = "codex_chatgpt_builtin__gpt_5_6_terra"
reasoning = "high"
allowed_reasoning_efforts = ["medium", "high", "xhigh", "max"]
permissions = "read-only"
backends = ["native"]
can_spawn = []
max_active = 1
allowed_task_kinds = ["visual_analysis", "ui_analysis"]
trust = "high"
verification = "material_changes"
attachments_allowed = true
requires_modalities = ["text", "image"]
contract_enforcement = "warn"
output_contract = "contracts/vision.json"
instructions = "agents/visual-analyst.md"

[agents.visual_verifier]
description = "Fresh-context verifier comparing the original reference with real Playwright screenshots"
model = "codex_chatgpt_builtin__gpt_5_6_sol"
reasoning = "high"
allowed_reasoning_efforts = ["medium", "high", "xhigh", "max"]
execution_mode = "goal"
goal_token_budget = 200000
max_goal_token_budget = 300000
stall_warning_seconds = 1800
finalization_grace_seconds = 900
permissions = "read-only"
backends = ["mcp"]
can_spawn = []
max_active = 1
allowed_task_kinds = ["visual_verification", "accessibility_review"]
trust = "adversarial_reviewer"
verification = "root_adjudication"
attachments_allowed = true
requires_modalities = ["text", "image"]
requires_tool_images = true
contract_enforcement = "strict"
output_contract = "contracts/visual-review.json"
instructions = "agents/visual-verifier.md"

[agents.visual_lead.controls.visual_analyst]
actions = ["inspect", "trace", "steer", "interrupt", "pause", "continue", "detach", "stop", "finalize", "compact", "respond", "set_effort", "fork"]

[agents.visual_lead.controls.visual_verifier]
actions = ["inspect", "trace", "steer", "interrupt", "pause", "continue", "detach", "stop", "finalize", "compact", "respond", "set_effort", "fork"]

[coordination]
mode = "reference_render_verify"
orchestration = "hybrid"
max_active_agents = 3
max_depth = 1
max_children_per_agent = 2
max_active_writers = 0
native_max_concurrent_threads = 1
native_nested_delegation = false
reject_ancestor_role = true
wait_policy = "dependency_only"
write_conflict_policy = "reject"
contradiction_policy = "primary_evidence"
result_visibility = "ancestors"