tia-review

tia-review — audit an existing project vs the baseline (class R, read-only)

Audit a connected TIA project against the non-negotiable baseline (TIA best-practices §0) and the naming/architecture rules (§4/§5/§8). It is a read-only review: it enumerates the project model through the tia MCP read tools and reports deviations — it never changes anything.

Besides the baseline findings it reports, as information only, the objects of each CLP that nothing references (unused-object candidates, from the cross-references): a separate Unused objects section, never a baseline rule.

Errors and reporting

• First call tia_ping: continue only if it reports reachable:true and activated:true. activated:null with a busy detail means a job is still running: poll tia_job_status with the jobId you hold, or wait and ping again. Otherwise stop, quote its detail and hint verbatim and say that nothing was changed (prerequisites: tia_guide {"topic":"gotchas"}).
• If no tia_* tool is available, the tia MCP is not connected: say so and stop. Never continue from memory and never work around it with hand-made HTTP calls (they bypass the MCP's gate checks).
• On a tool error (isError:true), quote its error and kind verbatim, relay its hint, and state what was done and what was not. Apply only the remedy the hint or this skill names, at most once; otherwise stop and ask.
• Never report success after an error, never retry a refused call with changed arguments, and never cross a human gate: relay a requires_human_action answer verbatim and wait for the human.
• status:"running" or kind:"busy" is not a failure: poll tia_job_status {jobId}. After a timeout, check the state before repeating anything.
• This skill names these remedies for tia_crossrefs (step 5): a 409 crossrefs_unavailable answer (quote its error, kind and hint, report the Unused objects section as not done, and finish the rest of the review); a 409 cursor_stale answer, or coverage counts that differ between pages (restart the page walk from the first page, once for each); and a page that arrives with an omission marker (repeat that page with a smaller limit, at most three times). Every other tool error stops the review as above.
• For the status:"running" and kind:"busy" answers of tia_crossrefs, step 5 says which job to poll and what to do next; the bullet above applies to every other call.