Minecart · Concept Explainer

Accounts, Groups, and Task Lists — and how AI agents turn them into an Activity Intelligence Platform

A plain-language walk through four ideas that look similar but do very different jobs — and why putting them behind an AI agent is the whole point.
Grounded on a fresh pull of Tromml/dbt-poc · 2026-05-28 · foundation live on main, agent layer in PR #1901 + PR #1960

The big idea, in one breath

Minecart already knows where your business is — every account, where it sits on the map, what kind of customer it is. The opportunity is to stop being a place where reps look things up and become a place that tells them what's worth doing — and then lets their own AI agent build the actual plan around their real life.

That shift has a name: an activity intelligence platform. Minecart supplies the structured truth (who your accounts are, who's grouped together, who's overdue for a visit). The rep's agent — Claude Code, Codex, Copilot, whatever they use — brings the context only it has (their calendar, where they're driving this week, their judgment). The two meet, and out comes a prioritized, trackable plan for the day.

Accounts are the territory. Groups are the lens you look through. Task lists are the plan you actually commit to. The confusion we keep running into: people treat a group as if it were a plan. It isn't. Keep reading — this distinction is the heart of the whole thing.

The four building blocks

Each layer below sits on the one beneath it. The bottom is raw reality; the top is a decision you act on. They build up — and they are not interchangeable.

Layer 1 · the raw reality

Accounts

Every customer and prospect location — name, where it is on the map, what type of account it is. The map of where business happens.

▲ we label them with…
Layer 2 · the labels

Tags

Plain labels we stick on accounts — a region, a tier, an industry, a product line. "Wisconsin." "Tier 1." "Automotive." One account can wear many tags.

▲ tags let us define…
Layer 3 · the lens

Account Groups

A saved lens: "show me every account that matches these tags." It re-answers itself automatically — tag a new account "Wisconsin" and it's instantly in the Wisconsin group. A living filter, not a plan.

▲ from a lens we build…
Layer 4 · the plan

Account Task Lists

A specific, ordered set of accounts to actually visit — this day or this week — each one checked off as done or skipped. A commitment with a finish line. (In the data this is an "entity list.")

The funnel narrows on purpose: thousands of accounts → a few relevant lenses → one short list you can finish today.

Group vs. Task List — the crux

These two get conflated constantly, so here they are side by side. The cleanest test: you can't "finish" a group. You finish a task list.

Account Group

A living lens

"Who, out there, belongs together?"

  • Membership is automatic. Defined by tag rules — match any or all of a set of tags. Tag a new account and it joins on its own.
  • Always current, never finished. It's a question Minecart re-answers every time you look. There's no "done."
  • No order, no progress. Just the set of accounts that match right now.
  • Long-lived & shared. "West Coast," "Enterprise," "Automotive OEM" — territory-level cohorts the whole team reuses.
Account Task List

A committed plan

"What am I actually doing — in what order — and did I finish?"

  • Membership is hand-picked. Specific accounts are placed on the list, in a deliberate order.
  • Time-boxed. Built for a day or a week — it has a date and a purpose ("Thursday — Chicago").
  • Tracks progress. Every account is pending, done, or skipped, with a note on why and what "done" means.
  • Owned by one rep. A manager can hand a weekly master list to several reps, who split it into their own daily lists — and an agent can later check that every account got hit.
 Account GroupAccount Task List
Who's on itWhoever matches the tags (automatic)Whoever you deliberately put on it
OrderNone — it's a setYes — a planned sequence
Progress / "done"No such thingYes — done / skipped per account
Tied to a dateNoYes — a day or a week
LifespanLong-lived, reusedSingle-purpose, then archived
It answers…"Who's out there?""What's the plan, and is it finished?"
A concrete way to feel the difference

The "Wisconsin · Tier 1" group is a lens over tags:

tag: Wisconsin tag: Tier 1 → 47 matching accounts, always up to date

Thursday's "Chicago run" task list is a plan drawn from that lens — five accounts, in driving order, each one trackable:

1 · Brady's Auto — done 2 · Lakeshore Equip — done 3 · Northside Parts — pending 4 · Cheboygan Supply — pending 5 · Milwaukee Diesel — skipped (closed)

The group never "completes." The task list is 2 of 5 done with a clear finish line. That's the whole distinction.

Which accounts actually matter this week

A group can hold hundreds of accounts. Nobody visits hundreds in a week. So the platform needs an opinion about which ones are due — and that's the job of visit cadence & availability (the work in PR #1960).

This is what turns "all my Wisconsin accounts" into "the six that are overdue and sit near where you'll be Thursday." Managers also get a weekly breach report — accounts slipping past their cadence — so coverage gaps surface before they cost a deal.

The doorway for agents — the MCP

Here's the move that makes this an intelligence platform rather than another dashboard. PR #1901 adds an MCP server — think of it as a clean, secure doorway that lets an outside AI agent read from and write to Minecart on the rep's behalf.

Why that matters: the most useful context for planning a day doesn't live in Minecart. It lives with the rep — their calendar, the trip they're planning, the customer who just called. An MCP lets the rep's own agent combine the two worlds:

The agent can read accounts, groups, and what's due, and it can write a finished plan back — creating and ordering an Account Task List, and later reconciling whether the work actually got done. The platform provides the raw material; the agent assembles it into something specific to one rep, one week, one route.

The payoff: a trip to Chicago

This is the example to remember — it shows all four building blocks and the agent working together.

1
The rep

Tells their agent the plan

Mid-week, the rep talks to their AI agent the way they'd talk to an assistant.

"I'll be in Milwaukee Wednesday, then driving down to Chicago Thursday. I've got about five or six hours free Thursday afternoon — I want to see accounts while I'm there."
2
The agent

Checks the calendar it already has

The agent reads the rep's Google Calendar, confirms the Thursday gap in Chicago, and works out roughly how much driving time that leaves.

3
Minecart (via MCP)

Answers "who's worth seeing near Chicago?"

The agent asks Minecart through the MCP. Minecart combines the group (accounts near Chicago), the cadence (which are overdue), and priority — and hands back the high-value, due-for-a-visit accounts in that area.

4
The agent

Proposes a realistic afternoon

It fits the best candidates into the five-hour window in a sensible driving order and checks back.

"You've got time for five. Here's a route — Brady's Auto, then Lakeshore, Northside, Cheboygan Supply, Milwaukee Diesel on the way out. Want me to lock it in?"
5
The rep

Decides

The rep tweaks it — drops one, adds one they care about — and says go. The human makes the call; the platform and agent did the legwork.

6
Minecart (via MCP)

Stores the decision as a Task List

The agent writes the choice back as a "Thursday — Chicago" Account Task List: five accounts, in order, each ready to be marked done or skipped. Thursday evening, the agent can even reconcile what actually got visited.

Who decides what

The reason this works — and stays trustworthy — is a clear division of labor. The platform never pretends to be the human.

Minecart — the platform

Provides the what

  • The accounts and where they are
  • The groups (tag-based lenses)
  • Who's overdue for a visit
  • Stores the final plan + tracks it
The AI agent

Assembles the how

  • Brings the rep's calendar & travel
  • Combines it with Minecart's data
  • Proposes a realistic, ordered plan
  • Personalized to that one rep
The rep — the human

Makes the call

  • Says where they're going and why
  • Approves, tweaks, or overrides
  • Does the actual visits
  • The decision stays theirs

Minecart provides the menu of what's worth doing. The agent drafts the plan. The rep chooses. The choice lands back in an Account Task List — and the loop closes.

Where this stands today

So the picture is honest: the foundation already exists in the product; the agent layer is the work in flight.

Live on main
Accounts, Tags, Account Groups, Account Task Lists. The four building blocks are real models in the codebase today — including tag-based auto-membership for groups and ordered, status-tracked members for task lists.
PR #1901
The MCP server — the doorway for agents. Lets an agent read Minecart's data and write reviewed work back. This is the first surface; the plan is to keep expanding the MCP to cover most of Minecart over time. View PR #1901 ↗
PR #1960
Visit cadence & availability — the "who's due" engine. Per-account cadence, Google Calendar availability, and manager breach reports — the prioritization that decides which accounts to surface. View PR #1960 ↗