Mako Workflow

---
description: >-
  TRIGGER when: user wants an investigation packet, pre-ship artifact, recall
  of prior work or answers, or to log tool-run feedback / inspect telemetry.
  Covers `suggest`, `investigate`, `workflow_packet`, `tenant_leak_audit`,
  `health_trend`, `issues_next`, `session_handoff`, all four artifact tools,
  `recall_answers`, `recall_tool_runs`, `agent_feedback`,
  `agent_feedback_report`, `runtime_telemetry_report`, `finding_ack`,
  `finding_acks_report`.
when_to_use: >-
  Use for multi-step workflows, durable task artifacts, prior-session memory,
  feedback logging, telemetry inspection, and reviewed static-finding state.
allowed-tools: "mcp__mako-ai__*"
---

# Mako Workflow

Use this skill when the user needs a workflow output rather than a single trace:
investigation packets, pre-implementation or review artifacts, prior-session
recall, feedback, telemetry, or finding acknowledgements.

## Operator And Workflow Tools

### `suggest`

Use to propose useful Mako queries or investigation directions.

### `investigate`

Use to run a broader bounded investigation workflow around a target.

### `workflow_packet`

Use to produce a bundled workflow summary from gathered context.

### `tenant_leak_audit`

Use to inspect likely tenant-boundary and data-leak risks.

- Pair with `db_rls`, `route_context`, `rpc_neighborhood`, or review artifacts
  when the user is evaluating security-sensitive changes.

### `health_trend`

Use to summarize health trends from recorded project signals.

### `issues_next`

Use to identify likely next issues or triage targets.

### `session_handoff`

Use to produce a concise handoff for later continuation.

## Artifact Tools

### `task_preflight_artifact`

Use before implementation to create task context, risks, likely move surfaces,
and verification plan.

### `implementation_handoff_artifact`

Use when handing coding work to another agent or future session.

### `review_bundle_artifact`

Use for pre-ship review findings, evidence, and risks.

### `verification_bundle_artifact`

Use to summarize verification steps, outcomes, trust state, and remaining gaps.

## Recall Tools

### `recall_answers`

Use to retrieve prior answer artifacts relevant to the current task.

### `recall_tool_runs`

Use to retrieve recent Mako tool runs.

- Use this before `agent_feedback`.
- Copy the returned `requestId` into `agent_feedback.referencedRequestId`.
- Default limit is 50 and max is 500; use a smaller limit first when locating a
  recent run.

## Feedback And Telemetry

### `agent_feedback`

Use to log whether a specific prior Mako tool run was useful.

- Use sparingly for notable full, partial, or no-usefulness cases.
- Requires both `referencedToolName` and `referencedRequestId`.
- Do not call after every Mako tool.
- Use `recall_tool_runs` first; do not fabricate request IDs.

Starter reason codes:

- `full`: `answer_complete`, `evidence_sufficient`, `trust_matches`
- `partial`: `partial_coverage`, `noisy`, `stale_evidence`,
  `missing_known_caller`, `top_not_useful`
- `no`: `answer_wrong`, `wasted_turn`, `tool_did_nothing`, `schema_missing`

### `agent_feedback_report`

Use to inspect feedback events by referenced tool, grade, time window, and
aggregate counts.

### `runtime_telemetry_report`

Use to inspect runtime telemetry aggregates and event lists.

- Use for review/debugging, not automatic tool selection.

## Finding Acknowledgements

### `finding_ack`

Use to acknowledge a specific static finding as reviewed, accepted-risk,
false-positive, or otherwise handled.

- Use for findings from `ast_find_pattern` and `lint_files`.
- Do not use it to rate Mako search or trace quality.
- Defaults to preview. Re-call with `preview: false` only after the
  acknowledgement is intentionally being applied.

### `finding_ack_batch`

Use to acknowledge multiple reviewed findings at once.

- Defaults to preview and returns `wouldApply` plus rejected rows.
- Re-call with `preview: false` only when the batch suppression is intentional.

### `finding_acks_report`

Use to inspect acknowledged finding history and trends.

## See Also

- Use `/mako-ai:mako-guide` for the full feedback versus finding-ack policy.
- Use `/mako-ai:mako-trace`, `/mako-ai:mako-neighborhoods`, and
  `/mako-ai:mako-graph` to gather evidence before producing artifacts.