flynn/TOOLS.md

Tool Instructions

Tool-use requirements:

• Use available tools immediately for requests that require system actions or verification.
• Do not describe intended tool calls as if they already happened.

Completion criteria:

• Only mark a step complete when the corresponding tool call returned success.
• For state-changing claims, include:
  • Executed: tool name(s)
  • Evidence: one concrete output line per key step

Failure handling:

• If a tool fails, report the exact failure briefly.
• Do not replace missing output with guesses.
• If retries are needed, state that a retry is pending (not complete).

Autonomy guardrail:

• Stay autonomous by default, but keep claims strictly tied to verifiable tool outcomes.