jonnifyagile agents
jonnify / Agile Agent Workflow / A2 · Decomposition / A2.02 / A2.02.2 · Card, Conversation, Confirmation

A2.02 · Connextra · dive 2

The three Cs

A story has three parts: a Card that holds a place, a Conversation that holds the detail, and a Confirmation that says when it is done.

The Card is a written placeholder, short on purpose. The Conversation is where the detail lives, deferred deliberately to the moment of building. The Confirmation is the acceptance check. Together they make a story a promise plus a conversation, not a contract frozen up front. Switch the view on the right to read each C of one Portal card.

The three Cs of one card · switch the view

CARD · written placeholder As a learner, I want to enrol, so that I can study it. CONVERSATION · detail, deferred what on a second enrol? a confirm step? — settled when built CONFIRMATION · acceptance check enrolled exactly once — a second enrol does not change the count a promise plus a conversation · not a contract frozen up front
Card: the written placeholder — the Connextra sentence, short on purpose. It holds a place in the backlog and triggers a conversation; it does not specify everything.

Card, Conversation, Confirmation

Ron Jeffries named the three parts a story has. The Card is the written placeholder: the Connextra sentence plus enough to remember the intent. It is deliberately too short to build from alone — its job is to hold a place in the backlog and trigger a conversation, not to specify everything. The Conversation is the talk between Operator, Author, and stakeholders that fills in the detail the card omits. It is deferred on purpose: detail decided too early is detail decided with the least information, so the conversation happens when the rung is about to be built.

The Confirmation is the acceptance check — how both sides agree the story is done. It pins the conversation's conclusions to something observable, so “done” is a fact rather than an opinion. The Confirmation is the seed of the Given/When/Then acceptance criteria of A2.04. Together, the three Cs are why a card can be one sentence and still carry a whole unit of work: the sentence is the promise, the conversation is where the detail goes, the confirmation is the proof.

Card
The written placeholder: the Connextra sentence plus a note or two. Short on purpose — it holds a place and triggers a conversation, not a full specification.
Conversation
The talk that fills in the detail, deferred to the moment of building, where the information is greatest.
Confirmation
The acceptance check that says when the story is done — observable, and the seed of the Given/When/Then of A2.04.

A card alone is not a specification; it is a promise of a future conversation about a unit of value, pinned by an acceptance check.

A promise, not a contract

A contract tries to fix every detail before any work begins. A story fixes only the promise of value (the card) and the test of done (the confirmation), and leaves the rest to the conversation. This is deliberate: deferring detail to the latest responsible moment means it is decided with the most information. A frozen contract written first is the big-bang spec failure of A1.01.2 — detail decided when the least is known, then reworked when reality arrives.

Move the slider to vary how much detail is fixed up front. As more is fixed early, less information is available when each decision is made, and the rework risk rises. At the left end, all detail is deferred to the conversation — a promise. At the right end, everything is fixed first — a frozen contract. The readout reports the trade computed from the model.

Detail fixed up front · move the slider

30%
the card's detail fixed 30% deferred 70% info at decision rework risk
30% of detail fixed up front · 70% deferred to the conversation. Information at decision time: high. Rework risk: low. A promise with a conversation attached.

Defer detail to the latest responsible moment: fix the promise and the test of done, and leave the rest to the conversation — the more fixed early, the more reworked late.

The three Cs on the Portal

Take the Portal rung “enrol in a course”. The Card is one line plus a note: “As a learner, I want to enrol in a course, so that I can study it”, enrolment once per learner per course. The Conversation settles what the card omits — what happens on a second enrol, whether there is a confirmation step — when the rung is built, not guessed up front. The Confirmation pins it: enrolled exactly once, a second enrol does not change the count. That check is already the skeleton of an A2.04 scenario.

# Card — the written placeholder (short on purpose)
"As a learner, I want to enrol in a course, so that I can study it."
# note: enrolment is once per learner per course

# Conversation — detail deferred to the moment of building
#   what happens on a second enrol? is there a confirmation step?

# Confirmation — the acceptance check (a Given/When/Then skeleton)
#   given a learner not enrolled, when they enrol,
#   then they are enrolled exactly once — a second enrol does not change the count

The principle

Carry a requirement as a promise plus a conversation: a short card, detail deferred to the latest responsible moment, and a confirmation that makes “done” observable.

On the Portal

Each Portal card is a one-line promise; the detail of enrol, browse, or track is settled in conversation when the rung is built, and a confirmation pins “done” to an observable check.

A story is a promise of value with a conversation attached and a confirmation to prove it done — not a contract frozen up front.

Recap — one sentence, three parts

The three Cs are why a card can be one sentence and still carry a unit of work. The Card holds a place and triggers a conversation; the Conversation holds the detail, deferred to where the information is greatest; the Confirmation pins “done” to an observable check. A story is a promise plus a conversation, not a contract frozen up front — fixing detail early only moves the cost to rework. With the form and the Cs in hand, the closing dive writes real Portal cards.

Next in A2.02: A2.02.3 · Portal cards — write real Portal stories in the form, from a one-line vision to a card, and how the Confirmation foreshadows the Given/When/Then of A2.04.

References

Primary sources for the three Cs and the story as a promise, and where it connects in the course.

Sources

Related in this course