Set up your client project: positioning docs, customer proof, and voice
A Juma Project is a shared space where the team stores everything Juma needs to know about a client. Create one project per client, add context as you go, and Juma uses what is relevant every time the team runs a flow. For messaging work, the project is what separates a framework built from public signals from one built on everything the team knows.
What to add
Current Positioning & Strategy Docs
The existing messaging doc, brand strategy deck, or founder narrative. Juma treats these as the starting hypothesis: the framework sharpens what holds up against the competitive audit and flags what does not.
Customer Proof
Win-loss notes, reviews, testimonials, and case studies. These give the pillars voice-of-customer proof points, the difference between "we believe" and "our customers say."
Brand Voice Guide
Tone, vocabulary, and phrases to avoid. The framework defines what to say; the voice guide defines how it sounds. With both in the project, the boilerplate arrives ready to publish.
ICP & Persona Docs
Audience definitions, segment priorities, and buying-committee notes. These set the rows of the messaging matrix, so value propositions map to the audiences the client actually sells to.
Guide Juma with project info
Add a short description to each knowledge item in the project's info field so Juma knows what each file contains and when to use it. For example:
- Positioning Doc: "Current messaging, last revised January. Treat as the baseline to improve, not the final answer."
- Win-Loss Notes: "Q2 interview notes. Source of truth for why customers choose us and where we lose."
- Voice Guide: "Tone and vocabulary rules. Apply to all boilerplate and customer-facing language."
Give every team the same story to tell
Frequently Asked Questions
How much time does this Flow save compared to a traditional messaging project?
An agency messaging engagement typically runs three to six weeks of workshops, interviews, and revision rounds. This Flow delivers the competitive audit, the framework, and the editable matrix in one working session, so the team's time goes into pressure-testing the strategy instead of assembling the document.
The manual version is slow because the inputs are scattered: competitor claims live on twelve websites, customer proof lives in call notes, and the current positioning lives in three slightly different decks. Juma collects and structures all of it in one pass. The strategic debate still happens, it just happens over a complete, evidence-backed draft.
What does the messaging framework include?
A positioning statement, a competitor messaging audit with the whitespace it revealed, three to five message pillars with sourced proof points, value propositions per audience, 25/50/100-word boilerplate, and do-and-do-not language rules. It arrives as a branded PDF plus an editable messaging-matrix file.
The two files split the work the way teams actually use it. The PDF is the alignment document that goes to leadership and agencies. The matrix is the working file: one row per audience, one column per pillar, the thing a content writer opens on Monday morning.
How does Juma find the messaging whitespace?
Juma reads the live sites of the client's closest competitors and maps what each one claims: category language, headline promises, target audiences, and the proof they offer. The whitespace is what remains: credible territory no competitor owns, matched against what the client can actually prove.
That last clause is the discipline. Whitespace a brand cannot substantiate is not positioning, it is fiction. The framework only recommends territory the client's product evidence and customer proof can hold, which is why adding win-loss notes and reviews to the project makes the output sharper.
Can it work from our existing positioning instead of starting over?
Yes. Add the current positioning doc to the Juma project and the Flow treats it as the baseline: the audit tests it against competitor claims, keeps what is differentiated, and rebuilds only the parts the evidence contradicts. Strategy, taste, and judgment stay human; the team decides what ships.
This is usually the better mode for established brands. A framework that ignores two years of accumulated positioning creates an internal adoption fight. One that visibly improves it gets adopted, because the team can see what changed and why.
What is the difference between a messaging framework and a brand voice guide?
The messaging framework defines what the brand says: positioning, pillars, value propositions, and proof. A brand voice guide defines how it sounds: tone, vocabulary, and style rules. They are companion documents, and strong brands maintain both.
In practice the framework comes first, because voice without message is style with nothing to say. Juma has a separate Flow for the voice guide, and the two share project knowledge, so building one makes the other faster.