Call this BEFORE an action that matters, and use the answer to decide.
An action matters when at least one of these holds: someone else will
receive or see it (an email, a message, a post, sharing a document); it
commits the person (paying, quoting a price, accepting a meeting, signing);
it cannot be undone (deleting, cancelling, filing, submitting); it touches
something shared or official (a client record, the accounts, a government
portal, the production system); it carries sensitive data; or it acts in
the person's name. Reading, searching and drafting never need this call.
Before calling, ask yourself: can this be undone? who does it reach? is
there an agreed way to do this here? could there be a rule or a preference
of the person about it? If any answer is "yes" or "I don't know", call
with `consultar=True`. If you judge there is nothing to look up, still
call with `consultar=False` to record your assessment: NEXUS will tell you
anyway if it knows of a serious past mistake for this action.
NEXUS returns the person's rules (with the mistake that created each one),
their procedures, what to watch for, and a verdict:
- "proceder": go ahead;
- "proceder_con_lista": go ahead, applying the list;
- "preguntar_a_la_persona": explain to the person what you will do and
why, and wait for their confirmation;
- "no_hacerlo": do not do it, and do not try another way to reach the same
effect; tell the person what you wanted to do, only they can approve it.
If you follow a returned procedure, report it with record_procedure_usage.
Args:
accion: What you are about to do, in your own words.
intencion: Why: what you were asked and which part of the work this is.
objetivo: Who or what it is done to (a client, a case, a patient, a
channel, a project, a repository).
riesgo_percibido: Your own answer to the four questions above.
consultar: True to have NEXUS look up rules and procedures; False to
only record that you judged it unnecessary.
clave: The key given by a stop point (hook), if one stopped you.
herramienta: The tool you are about to call, if any.
detalle: Optional exact text (the email, the command). Stored
truncated and with secrets masked, never whole.
session_id: Your NEXUS session id, if you have one.