Optimization Assistant Manual

This manual explains how to use the Optimization Assistant safely with diagnosis, recommendation packets, and preview interaction.

Current CLARIXO behavior is preview-first: recommendations can be read and selected locally, but no real mutation should occur unless a future apply stage is explicitly enabled.

Open Playground Back: Troubleshooting Manual Open Docs Hub

Stage 1

Diagnosis

Start by reading findings and recommendations as structured analysis, not as immediate execution commands.

Stage 2

Candidate selection

Selecting a candidate should update local preview state and explain surfaces only.

Stage 3

Preview summary

Use the preview summary to confirm target scope, action key, safety state, and confirmation requirements.

Stage 4

Safety boundary

Preview interaction means no executor is attached and no mutation is performed.

Current safe contract: preview selection is allowed.

Not allowed: hidden mutation, implicit apply, or fake execution claims.

Operator job: read the recommendation packet, compare candidates, and decide whether future confirmed execution would be justified.

Optimization Assistant reading order:
1. Read diagnosis
2. Inspect recommendation packet
3. Select candidate locally
4. Confirm preview summary changed coherently
5. Confirm preview_only=true and mutation_blocked=true
6. Stop unless a future explicit apply stage exists

Previous Manual

Troubleshooting Manual

Use troubleshooting first when the system behavior is still unclear or layer ownership has not been isolated.

Companion

Observation Manual

Use observation to confirm whether a concentration or unstable segment actually justifies optimization work.

Boundary

Contract Reference

Use it to confirm the structured packet fields and the safety boundaries between preview interaction and any future apply stage.