Senior · 5 chapters
AI-specific technical leadership
Standards for reviewing prompts, evals, skills and config; who owns which; annotation as a funded workstream
AI teams fail when prompts, evaluation data, and operational configuration change without clear review gates or funded ownership.
Read these first
What you will know
Set a review standard for prompts, evals, skills, and config
Versioned criteria and required evidence prevent a harmless-looking change from silently altering behaviour or invalidating results.
Assign ownership of each to a person
Named decision-makers make escalations, maintenance, and incident follow-up possible when several disciplines are affected.
Fund annotation as real work in a real plan
Sample size, reviewer calibration, and turnaround time determine whether evaluation data is trustworthy rather than merely abundant.
Onboard an engineer onto the team's AI practices
A new contributor should be able to apply the gates and produce acceptable evaluation or configuration changes without relying on tribal knowledge.
Explain what is different from leading any other engineering work
Probabilistic behaviour, shifting model dependencies, and subjective quality signals make evidence and operating boundaries more important than code ownership alone.
Chapters
- 1
Behaviour lives outside the code and changes without a commit
The thing that genuinely differs about leading AI work is that your dependency ships changes you did not review, and quality is a distribution rather than a pass or fail. When complaints spike on Thursday after Monday's prompt change, the question is whether it was the prompt, a silent model update or a shift in input mix, and you can only answer it if every request recorded the prompt version, model version and config in force.
- 2
A prompt change needs evidence, and so does retrieval_k
Rewriting one sentence in a system prompt is a behaviour change, so the gate is evaluation results on the affected suite before and after, attached to the pull request. The harder point is that moving retrieval_k from 5 to 8, nudging temperature, or accepting a new model version are the same kind of change wearing config clothing, and they are the ones that habitually ship with no behaviour review at all.
- 3
The eval set is your definition of correct, so it needs an owner
Prompts, evaluation suites, skills and operational config each need a named person with authority to reject a change, not a team label. The evaluation set matters most: it is the operative definition of correct, and an unowned one drifts as people quietly delete the cases that keep failing. Ownership is also what makes escalation and incident follow-up land on someone rather than circulating.
- 4
Annotation is funded work or your metrics are decoration
Trustworthiness in evaluation data comes from reviewer calibration and measured agreement between annotators, not from volume. Ten thousand labels produced by engineers between tickets, with no guidelines and no agreement measurement, describe the labellers rather than the system. That is the argument for spending a headcount on someone who owns evaluation data instead of a seventh engineer whose output nobody can verify.
- 5
Tribal knowledge fails the new-engineer test
The honest test of whether your AI practices are written down is whether someone who joined last week can land a prompt change with the required evidence, unaided, in their first few days. If they need to ask which suite to run, where the eval set lives, or who signs off on a config change, the gates exist in people's heads. Onboarding is where you find that out cheaply.
External resources
- Who Validates the Validators? Aligning LLM-Assisted Evaluation with Humanspeople.eecs.berkeley.edu
The research case that human annotation must anchor any eval you review or trust
- How many people should annotate my LLM outputs?hamel.dev
Staffing and ownership model for annotation as a funded, recurring workstream
- Evals for PMs: A practical guide to AI product qualitybraintrust.dev
Splits who owns prompts, criteria and eval code between engineering and product
- How Engineers and PMs should collaborate on EvalsHamel Husain
Review standards and handoffs for prompts and eval criteria across roles
- Homework 1 and 2 for AI Evals Course: System Prompt Engineering and Error AnalysisArize AI
Worked error-analysis session showing what good prompt and eval review looks like