mandarıne

07Templates

Twelve templates, for the gestures that keep coming back.

"What can I ask my agent for?" A template answers: a post-mortem, a story to validate, a client request to review before sending. Each is a polished HTML skeleton the agent fills in, with the kit's buttons already in place. And nothing is imposed: a blank HTML page is still a card.

In Mandarine, a template is an HTML skeleton with named slots and the kit's components already in place. The agent fills it and publishes the card; Mandarine warns it if a slot was left empty. Styles come from a single stylesheet, versioned with the kit. The team's theme (colours, font, logo) applies to every card and stays frozen at its publication.

The agent fills the “decision” template skeleton, then publishes the card.

What a template is

A skeleton, not a form

Named slots, in brackets, each with its instruction. The agent replaces, removes an empty section, adds a useful one. Whatever stays in brackets is flagged at publication.

Styles in the kit

Masthead, callout, timeline, stats, tabs, phone frame, before / after: one stylesheet, versioned. The agent's page stays short, and quality is tuned in one place.

The team's theme, frozen at publication

Your colours, font and logo, written in the workspace's documentation. Every card inherits them on the day it is published, and keeps that look: a mockup validated in March stays March's.

And the blank page

If no template fits, the agent writes free HTML with the kit's stylesheet. The template is a starting point, not an obligation. The cards in the home page gallery show it: each has its own style.

The twelve

One template per team gesture.

Each template says what the agent does and what you do in the page. Your agent knows the list, when to use each one and when not to: tell it the gesture, it chooses.

Make decisions

Decision

A closed question, two to eight options, with the agent's recommendation. "Should search move to three nodes?"

CThe agent
fills in the context, the options and its recommendation.
CAYou
click, add a word if you like, then "I'm done".
Backlog

Requirement

A vague request becomes a story. The agent writes what it understood and asks three to five questions before writing.

CThe agent
writes what it understood, asks its questions, then publishes the story, linked.
CAYou
answer, in a minute, on your phone if need be.
Backlog

Story

A user story ready to develop: role, need, reason, acceptance criteria, out of scope.

CThe agent
proposes the criteria, then develops and republishes with the link to the delivery.
CAYou
correct a criterion and declare the story ready.
Prototypes and mockups

Mockup review

Two to four variants of a screen, desktop and mobile, what changes between them, and a vote.

CThe agent
draws the variants and says what changes.
CAYou
comment on the exact element with the crosshair, and vote.
Prototypes and mockups

Prototype

A clickable flow of several screens, to be reviewed by the team or by an invited client.

CThe agent
links the screens and says what to look at.
CAYou
click, annotate, then approve. A guest answers under their name.
Deal tracking

Deal

A deal tracked CRM-style: stage, amount, contacts, history of exchanges, next action.

CThe agent
republishes the card after each call or e-mail, and proposes what comes next.
CAYou
validate the next action, or change it.
Client requests

Client request

An incoming request, what the agent understood, the prepared reply and quote, the points of attention.

CThe agent
writes the reply and the quote; sends once authorised, and attaches the proof.
CAYou
correct the text, then authorise the sending, or not.
Agent reports

Post-mortem

The analysis after an incident: impact, timeline, root cause, what went well and badly, proposed actions.

CThe agent
writes, then creates one card per accepted action and republishes with their links.
CAYou
sort the actions and validate the analysis.
Test plan

Test finding

A gap found while running the test plan, with its screenshot: scenario, expected, observed, environment, proposed severity.

CThe agent
documents the gap; fixes the bugs and republishes "fixed in v3".
CAYou
qualify: bug, to discuss, or fine.
Weekly watch

Watch

Monday's digest: three things to remember, then one block per theme, each item with its source and why it matters.

CThe agent
publishes in a recurring card, and opens a card per retained item.
CAYou
sort in two minutes: worth a card, skip, comment.
Documentation

Project documentation

A project's starting documentation, in several pages: what it is about, vision, decision log, conventions, glossary.

CThe agent
fills it from the repository or the conversation, and keeps it current when a card changes.
CAYou
read, and comment on a paragraph: "this has been wrong since September".
Documentation

Design system

Your team's identity, readable by all, and the source of the theme: colours with their contrast, typography, logo, tone.

CThe agent
writes it, and publishes the theme file every card inherits.
CAYou
validate; a contrast that is too low is flagged, never refused.

Shown for real

A mockup review with its vote, and a story with its criteria.

Two templates filled by the agent, with fictional names. The kit's components are already in place: the vote, the checkboxes, "I'm done".

Story · NOR-214

As a logistics manager, I want to retry failed shipments in one click, so that I no longer wait for the dispatcher's run.

Acceptance criteria
  • The button only shows when shipments failed
  • The retry is deferred, never synchronous
  • A shipment retried three times becomes “handle manually”
CClaude proposes 2 of 3 criteria · Camille validates the 3rd

Your team's theme, on the same card

The agent writes the team's design system in the workspace's documentation: colours, font, logo. Mandarine checks the contrasts and makes it the theme of every card. Try it with a fictional brand.

Frozen at publication: the card keeps the theme it had on the day the agent published it. A rebranding does not rewrite history.

Decision · Claude — nordis-dev — Nordis
Move the search engine to three nodes?

The single node restarted twice in October: 40 minutes without search in total. Three nodes cost a third more per month.

Yes, three nodes this monthNo, watch for one more monthTwo nodes, a compromise
Agent's recommendation: three nodes. The cost is small against two outages in one month.
One click, a word if you like, then:I'm done

The kit

Seven components, already in place in the templates.

They are what makes the agent's page readable by Mandarine: "14 answers out of 20", "an agent is waiting", "I'm done". Every answer is signed, saved as you go, and read back by the agent.

Questionquestion

A free answer, short or long.

Choicechoice

One option among several, with a word of explanation if wanted.

Multiple choicemultichoice

Several options at once.

Quick replyquick-reply

Accept, edit or skip, finding by finding.

Approvalapproval

Yes or no, and why.

Checklistchecklist

Shared between people and agents: every tick is signed and dated. The agent ticks what it has done.

Votevote

The whole team decides, one vote each. The agent counts at closing.

And “I'm done”

The button on every card. It tells the agent your answers are complete: it reads them, starts its work, and summarises it for you. On a card with no question, it becomes “Close the card”.

How your agent uses them

You name the gesture

In its chat: "Write me a story for the accounting export", "Write yesterday's post-mortem". No need to name the template.

It chooses the template

As soon as it is connected, it knows the list, when to use each one and when not to. If the request falls outside, it starts from a blank page.

It publishes, you answer in the page

The card lands in "To decide". You answer, "I'm done", and the agent reads your answers. "All the post-mortems" are one filter away.

A polished template, or a blank page: either way, it is a card.

Connect an agent