Playbooks & Checklists

AI Tool Intake Test

Five questions and a removal trigger that decide whether a new skill, MCP server, or harness gets near client work.

I keep this as a checklist file next to my project notes and fill one out per tool. It takes about four minutes, and the point of writing it down rather than deciding in my head is question 5: a removal trigger you never wrote down is a removal trigger you’ll never enforce.

The four gaps in question 1 are the only jobs a tool can hold on a Power BI or Fabric project. Knowledge is a skill, hands is an MCP server, memory is the harness, eyes is verification.

# Tool intake: <name of tool / skill / MCP server>

Date evaluated: <YYYY-MM-DD>
Source: <repo URL, vendor doc, or announcement>

## 1. Which gap does it fill?

- [ ] Knowledge (a skill: packaged expertise so the model stops improvising)
- [ ] Hands (an MCP server: defined tools instead of invented TMDL/code)
- [ ] Memory (the harness: context that survives the chat window)
- [ ] Eyes (verification: a check that produces an artifact)

If none of the four fit, or the honest answer is "it looks interesting,"
stop here. It goes in the weekend lane.

## 2. What does it displace?

Replaces: <existing tool, script, or manual step>

If nothing, you are accumulating rather than choosing. A second tool with
hands on the same model is duplication plus a cost on every prompt.

## 3. What is the check?

The artifact that proves it did the job:

- [ ] Row count compared against a known value
- [ ] Screenshot of the rendered result
- [ ] A validate command that exits clean
- [ ] Other: <name it>

No check available = weekend lane, permanently. A demo is not a check.

## 4. Which lane?

- [ ] Weekend (side projects, experiments, vibe coding; failure is free)
- [ ] Client (someone's name is on the invoice)

Client requires: gap named in 1, displacement named in 2, check named in 3.

## 5. Removal trigger

This gets uninstalled when: <pick at least one>

- [ ] Unused for 30 days
- [ ] Failed its check twice
- [ ] The thing it displaced comes back into use
- [ ] Other: <name it>

## First session (before any write operation)

Ask the tool what it is, not what to do:

    What do you see, and what can you do?

A tool that cannot describe its own surface honestly does not touch a model.

## Two-shot rule

If the task is not right within one or two shots, kill the session and open
a new one. The instructions were the problem, not the tool. Ask the agent to
write the prompt for the fresh window before closing the old one.

## Quarterly cut

Walk every entry in the MCP config and the skills folder. Write one sentence
per entry naming its job and its check. Anything without a sentence comes out.

Adapting it