The customer brief is the most commonly rebuilt artifact in any account-facing team. The call happened, the notes are in three places, and someone rewrites the context from scratch before every renewal, escalation, or handover.
It is also close to an ideal first workflow: frequent, judgment-heavy but reviewable, and painful in a way everyone recognises. This is how to package it properly — including the rules that keep it from inventing commitments nobody made.
Part 01 · The job
The job and its inputs
Briefs fail before they are written, in the gathering.
Why customer briefs die in scattered notes
The context for an account is genuinely distributed: a transcript in the call tool, a thread in email, fields in the CRM, a Slack conversation where the real concern was raised. No one location is authoritative.
One useful email a week
Get one workflow teardown a week.
A practical look at how a real repeated job becomes a reliable AI workflow — inputs, review points, and the failure modes to avoid.
By subscribing, you agree to receive Grokkit’s weekly workflow teardown. Unsubscribe anytime.
So the brief gets rebuilt by whoever needs it, from whichever sources they happen to check, which is why two briefs about the same account can disagree without either author being careless. Marketing planning suffers the identical failure against a different pile of sources, as one client engagement showed — see rebuilding a content plan every cycle.
Inputs that matter
Four inputs carry most of the value: the call transcript, the account context (plan, renewal date, health, history), the recent email or ticket thread, and the brief template itself. The pre-sale equivalents — discovery notes, handoffs, and proposal briefs — take the same four shapes, as described in discovery notes, handoffs, and proposal briefs.
Mark each as required or optional and note reliability. CRM fields are frequently stale, so the workflow needs an explicit rule about precedence when the transcript and the record disagree. Where calls are recapped by their own workflow, the brief can consume that structured output instead of the raw transcript — the upstream shape is in meeting notes to accountable next steps.
- Call transcript — the primary evidence
- Account context — plan, renewal, history, owner
- Recent thread — email or tickets since the last touch
- Template — the required output shape
The output spec: context, risks, questions, next step
Four sections, always present, always in that order. Context is what is true about this account right now. Risks are what could go wrong. Questions are what we do not know and need to ask. Next step is the single recommended action with an owner.
Fixing the order matters more than it sounds. A reviewer who knows risks are always third can scan; one who has to find them reads everything.
Evidence-backed context versus summary fluff
A summary compresses the call. A brief states what is true and where each statement came from — “renewal is at risk on price (call, 9 Sept)” rather than “the customer raised some concerns.”
The attribution requirement is what forces specificity. It is hard to write a vague sentence that also names its source.
Part 02 · Gaps and risks
Handling what is missing
The difference between a useful brief and a dangerous one is how it treats absence.
Flag gaps instead of filling them with guesses
If budget never came up, the brief says budget was not discussed. It does not infer a range from company size, and it does not quietly omit the topic so the gap goes unnoticed.
This rule is worth more to a reviewer than any improvement in writing quality, because it makes the brief’s silence meaningful. The general principle is covered in choosing the right unit for the job.
Open risks and questions as first-class sections
Risks and questions belong in the structure, not scattered through prose. A risk should name what could go wrong, what evidence suggests it, and who owns it.
Questions should be phrased so an account manager could ask them verbatim on the next call. “Confirm who signs off on the renewal” is usable; “clarify stakeholders” is not.
A recommended next step a human can accept or reject
One recommendation, stated plainly, with the reasoning attached. The reviewer’s job is a yes or no, not an interpretation of three options.
Multiple recommendations are a sign the workflow is avoiding judgment. If the case is genuinely ambiguous, say so and recommend the step that resolves the ambiguity.
Claims must trace to a named input
Every material statement carries its origin: which call, which thread, which record. This turns review into verification and localises errors correctly when something is wrong.
It also exposes an important class of problem — a claim sourced from a CRM field that has not been updated in eight months is now visibly weak rather than invisibly authoritative.
Handling messy transcripts and missing CRM fields
Transcripts truncate, misattribute speakers, and garble product names. The workflow needs explicit behaviour: attribute uncertainly rather than confidently, and flag a garbled section rather than interpreting it. Stating that behaviour up front, as a named contract for what the operator must supply, is covered in input contracts for messy notes, CRM fields, and transcripts.
When a required CRM field is absent, the brief should say so in the context section rather than routing around it silently. Bad audio, unlabelled speakers, and late joiners are better handled once at the recap stage than repeatedly here, which is the argument for chaining the two workflows.
Part 03 · Guardrails
Guardrails and review
This workflow sits one step from a customer, so the boundaries matter.
No invented commitments, no silent omissions
The two rules that matter most. The workflow may never state a date, price, discount, or deliverable that does not appear in an input — even when context makes one obvious — and it may never drop a required section because it had nothing to put there.
Both are testable, which means both belong in the test suite. See the test suite method.
Tone for internal versus client-facing briefs
An internal brief can say the champion has gone quiet and the sponsor is sceptical. A client-facing summary cannot. If both are needed, they are two outputs with different rules, not one output with a softening pass.
Trying to serve both audiences from one artifact is the most common reason brief workflows produce hedged, useless text. For teams running this across many accounts, the client-safe variant needs a written exclusion list rather than a tone instruction — the pattern is in client-safe variants for agency work.
Reviewer checklist for CS and account leads
Three minutes, four checks: are all four sections present, does each material claim name a source, are the unknowns actually unknown, and is the next step one you would take?
Publish the checklist alongside the workflow. Reviewers who know what to check are the control that makes the whole thing safe.
Connecting CRM and call tools without leaking extra data
Scope access to the specific records the job needs rather than granting broad read access because it is easier. A brief workflow needs this account, not the whole customer base.
Decide deliberately what may leave your systems and what stays. Our approach to this is described on the security page.
Part 04 · Variants
Variants, testing, and measurement
One brief shape does not fit every moment in the relationship.
Renewal, kickoff, and escalation briefs
These are three variants of one skill, not three skills. The structure and evidence rules stay identical; what changes is emphasis — renewal weights risk and commercial signals, kickoff weights scope and stakeholders, escalation weights timeline and impact.
Keep them as one versioned skill with a variant parameter. Splitting into three copies restarts the drift problem immediately. The support-side equivalents — triage, escalation, and QBR prep — follow the same variant logic, as described in triage, escalation, and QBR prep.
Test cases: happy path, angry customer, incomplete notes
The happy path proves the shape. The angry customer tests tone rules and the temptation to soften a real risk. The incomplete transcript tests whether gaps stay visible.
Add a fourth: an input where the correct next step is to escalate rather than produce a recommendation at all.
Weekly volume: when this job is worth a skill
Roughly, when the team writes more than a handful of briefs a week, or when more than two people write them. Below that, the inconsistency cost is real but rarely worth the packaging effort.
The stronger signal is the repair: if reviewers consistently fix the same omissions, the job is ready regardless of volume. That repair time is also the number worth measuring, since it sits on the scarcest resource in the team — the filters for ranking candidates are in the four readiness filters.
Measuring “starts review-ready instead of blank”
Compare review time against the baseline, count how many briefs needed a structural fix rather than a wording tweak, and track how often a reviewer had to go back to the source themselves.
That third number is the real measure of whether the evidence rules are working. Turning those three numbers into a case an economic buyer will approve — and knowing which claims to leave out — is covered in building an ROI case that survives scrutiny.
How the workflow layers show up in this job
The procedure extracts and reconciles facts, the checks enforce structure and attribution, and the human gate sits at approval. Each layer catches a different failure, which is why removing one degrades the whole thing.
You can see the same layering across other jobs in the worked examples and in more depth in the case studies.
When to customise versus use a library skill
If your brief looks like most teams’ briefs, start with a ready-made skill from the skill library and adjust the rules. If your escalation logic, source systems, or compliance language are genuinely specific, a custom build will be faster than repairing a generic one.
Either way the definition of done is yours to write. If you would like a second opinion on which route fits, describe the job and we will tell you plainly.
