First inspection, then a reviewed change
A reproducible reference model, explicit expected values and a checklist that separates an answer from engineering evidence.
This is an onboarding tutorial, not an AI benchmark or a claim that an agent has completed the task. The reference script is deterministic. Expected values below become verified results only after you run the checks in your installed engineering runtime.
Prepare a disposable reference
A prebuilt reference model and verification receipt are provided. The packaged reference was created and reopened with the FreeCAD 1.1.4 Linux ARM64 kernel: one valid solid, 14,400 mm³. This verifies the reference artifact, not an AI turn, your installed Client or the Preview/Apply workflow. Recheck the model in your own runtime.
Download and read create_reference.FCMacro and the reference README. The source creates a new 60 × 40 × 6 mm rectangular solid, recomputes it, checks validity and saves it under a new SynthCrew-Tutorial folder in your home directory. It refuses to overwrite an existing reference file.
Review executable examples before running them. Do not execute an arbitrary attachment because an assistant asks you to. Run this reference through the installed application's macro mechanism only when you deliberately choose to create the disposable model. Preserve unrelated projects and documents.
Expected reference values:
| Property | Expected value |
|---|---|
| Length | 60 mm |
| Width | 40 mm |
| Height | 6 mm |
| Solid count | 1 |
| Rectangular-solid volume | 14,400 mm³ |
The volume is an expected geometric calculation, not a substitute for a kernel check. Inspect the macro's actual check output and reopen the saved document. If you cannot run a check, record it as unverified.
Inspect before changing
Open the saved model, create or select its project and start a conversation bound to that project. Confirm the displayed project context. Use Plan for a first inspection:
Inspect this reference model without changing CAD files. Report its length,
width and height. Distinguish serialized metadata from actual kernel checks.
Tell me which checks you performed and which remain unverified.Read the recorded actions, not just the final text. A property inspector can read dimensions without validating a solid. If geometry inspection is unavailable, the answer should say so. Do not turn a tool failure or absent runtime into a successful result.
Define a bounded candidate change
When Client Agent access and its tools are available, request:
In the isolated candidate workspace, change only the reference box Width
from 40 mm to 48 mm. Keep Length 60 mm and Height 6 mm. Recompute and check
that there is one valid solid. Leave original project files unchanged.
Report actual checks, output files and any failures. Do not apply the change.Expected candidate volume is 17,280 mm³. That is an acceptance criterion, not evidence that the agent produced it. If the tools cannot complete the task, preserve the candidate and inspect the failure rather than silently rewriting the original manually and calling it AI success.
Review the current candidate
- Open Review current candidate or the available candidate-review control.
- Inspect the changed-file list and originating conversation/run. A later Plan reply must not be credited with an earlier Agent candidate.
- Use Open FreeCAD copy where that compatibility command is exposed. Inspect the candidate's dimensions and recompute the model.
- Check that the original is still 60 × 40 × 6 mm and that the candidate is 60 × 48 × 6 mm.
- If the candidate changed after Preview, review it again. If the original is dirty or changed, resolve the conflict; do not bypass the check.
Apply explicitly and verify again
Confirm Apply only after review. Reopen or reload the promoted result and check Width 48 mm, one valid solid and volume 17,280 mm³. Keep the original backup and inspect the actual promotion result. Stop or editing a prompt does not automatically roll back applied work.
Record the model, candidate, review decision, actual validation results and remaining limitations. For a real part, also verify feature relationships, tolerances, materials, load assumptions and downstream outputs; this rectangular reference does not test them.
If any stage fails, use Apply conflict recovery or tool and permission guidance. Do not repeat an uncertain paid request merely to obtain a green state.