Documentation
How Foil works
Foil turns the calls, notes and deals already in your Attio workspace into a maintained battlecard on every competitor you come up against — each claim grounded in a verbatim quote and cited to the deal it came from. This page explains what feeds in, how a card is produced, and how to set it up.
What feeds a battlecard
Foil reads what your team already produces by selling. Nothing to import, no new habits — it works from the record you keep in Attio.
Call recordings & transcripts
The primary source. Foil reads what was said and spots when a competitor comes up — and what was claimed about them.
Notes
Competitor mentions in written context — procurement comparisons, deal notes, meeting write-ups.
Deals & their outcomes
Closed-won and closed-lost stages, so win rate and momentum are computed from your real results — not guesses.
Company context
Read once, on install: what your company sells, so Foil can tell “us” from “them” in a transcript.
From a call to a battlecard
Every card is built the same way, in five stages. New calls run through it as they land; your whole history runs through it once when you first connect.
- 1
Extract
Foil reads each call and note and pulls out typed signals — objection, feature gap, win play, watch-out or mention — every one carrying the verbatim quote it came from and a confidence score.
- 2
Resolve
Each mention is matched to a canonical competitor, so “Northwind”, “Northwind Inc” and “northwind” all land on the same record instead of three.
- 3
Aggregate
Win rate, deals seen and momentum are rolled up per competitor from the deals they appeared in — recomputed as outcomes change.
- 4
Generate
The battlecard document is synthesised — positioning, top objections, feature gaps, winning plays and watch-outs — with every claim citing a real signal. Nothing that can't be cited ships.
- 5
Project
The finished card is written back into Attio: each rival's Company is labelled a competitor and added to the Battlecards list with its stats, the battlecard note lands on the record, and the Competitors widget shows on your deals.
Anything the model isn’t confident about doesn’t land on a card silently — it goes to a review queue for a human to keep or dismiss in one click.
How it all fits together
Deals and conversations produce signals; signals roll up into competitors; each competitor gets one battlecard. Because every signal keeps its source, you can always trace a claim on a card back to the exact call it came from.
tied to a deal
deals seen
synthesised
A signal always carries its source. A competitor is the sum of its signals and the deals it appeared in. A battlecard is the synthesis of one competitor’s evidence.
Dreaming
Once a night, while your workspace is quiet, Foil dreams — a consolidation pass that tidies up everything it learned during the day, so your battlecards stay sharp instead of sprawling.
It merges duplicate signals. The same objection raised on the same call in slightly different words shouldn’t count twice. Foil folds duplicates into a single canonical claim — first exact matches, then a near-duplicate pass — so a card’s “mentioned 9 times” reflects nine real deals, not nine rephrasings of one.
It merges competitors that are really the same company. If two competitor records turn out to be the same real-world vendor, Foil collapses them into one and remembers the alias, so future mentions resolve straight to the survivor.
It never deletes evidence. Consolidated signals are set aside, not destroyed — a card that cited one keeps its provenance. Dreaming doesn’t rewrite battlecards itself; it cleans up the evidence, and any card whose evidence changed is regenerated automatically afterwards.
You never trigger this — it just happens overnight, and you wake up to cards that are a little more accurate than when you left them.
Setting up Foil in Attio
After you connect Attio, four one-off steps put battlecards where your team already works. Attio doesn’t let apps configure views or page layouts, so these need a human — each takes under a minute.
1 · Find your competitors in Companies
Foil tags each rival's Company record with a “Competitor” label. Filter Companies by that label — and save it as a view — to see your rivals alongside the rest of your CRM.
2 · Set up the Battlecards list
Foil creates a “Battlecards” list in your sidebar and keeps it filled with every competitor that has intelligence behind it — win rate, deals seen and momentum at a glance. Click it, pick a Table view and add those columns, sorted by Deals seen.
3 · Add the Battlecard widget to Company records
The full battlecard — positioning, objections with verbatim quotes, winning plays, watch-outs — on the record itself. Configure page → Add widget → Battlecard.
4 · Add the Competitors widget to Deal records
See which competitors are in play on a deal and jump straight to their battlecards mid-call. Configure page → Add widget → Competitors.