← Back to the cat

The cat shows its work

How the cat decides

A real map of the route behind every answer. Safety and factual routes stay fixed; for personal choices, the chosen cat can weigh stated taste and persona before the reply is phrased.

The full decision tree

Eight connected sections, with every branch included. On desktop the route zigzags across the page; on mobile it runs from top to bottom. On phones, each decision lists its branches. On desktop, scroll inside a diagram to explore wider branches.

Follow the numbers; dotted boxes continue in another section.

Let the question in

Check the request, rate limit, and verification token.

No

Yes

No

Yes

Limiter failure

No or verification failure

Yes

Question + 2–4 choices + selected cat

Valid question, unique choices,
cat ID and verification token?

400 · Invalid request

Within rate limit?

429 · Rate limited

Turnstile verified?
Expected hostname and ask action

403 · Verification failed

8 · Give the cat a voice
503 · Decision unavailable

2 · Know when to stop
Check the question

Know when to stop

TypeSafe has 30 seconds to decide. Live information and high-stakes questions stop here.

No

Yes

Yes

No

Yes

No

Invalid data or failure

Invalid data or failure

Check the question
Classify request; assess live lookup and source

Question or choice request?

Needs live information?
live_lookup ≥ 0.5

NOPE · Point to a live source
Weather, time, scores, prices,
hours, traffic, news or other

Assess the risk
Identify domain and high-stakes subtype

High stakes?
high_stakes ≥ 0.4

NOPE · Medical, legal, financial,
safety or other high-stakes risk

1 · Let the question in
400 · Invalid request

3 · Keep the safe options
Assess each option

7 · Settle the choice
Fixed outcome: supplied option or NOPE

8 · Give the cat a voice
503 · Decision unavailable

Keep the safe options

Remove harmful choices, then apply explicit requirements when possible.

No

Yes

Yes

No

Yes

No

Invalid data or failure

Assess each option
Assess harm and explicit hard-requirement
violations for every option

Keep options with unsafe score < 0.6

Any safe options?

NOPE · All options harmful

Any safe options also meet
explicit hard requirements?
violation score < 0.6

Keep only those meeting requirements

Keep all safe options

Exactly one candidate?

Select sole surviving option

4 · Choose the comparisons
Compare surviving options

7 · Settle the choice
Fixed outcome: supplied option or NOPE

8 · Give the cat a voice
503 · Decision unavailable

Choose the comparisons

Facts, predictions, and personal choices follow different priorities.

objective_fact

subjective_prediction

subjective_choice

Yes

All ties

Invalid data or failure

Compare surviving options
Compute applicable comparisons in one call
using surviving options and domain

Request kind?

Stable fact or trivia
Priority: factual correctness
Personality-free

Subjective prediction
Priority: plausibility → stated goal
Personality-free

Subjective choice
Six comparisons evaluated in the same call

Any non-tie comparison?

5 · What fits this person?
Clear winner for domain fit

7 · Settle the choice
Select the first non-tie winner

7 · Settle the choice
Secure random pick

8 · Give the cat a voice
503 · Decision unavailable

What fits this person?

For personal choices, try domain fit first, then the stated goal.

Yes

Tie

Yes

Tie

Clear winner for domain fit
from this cat's perspective?

Clear winner for the stated goal?

7 · Settle the choice
Select the first non-tie winner

6 · Use the right pair
Which domain-specific

Use the right pair

Choose one domain. Try its first comparison, then its second if the first ties.

Which domain-specific pair applies?Choose one of these nine branches ↓

Taste & leisure

  1. Enjoyment that fits
  2. Benefit versus effort

Relationships

  1. Respect for boundaries
  2. Quality of connection

Work & school

  1. Meaningful progress
  2. Benefit versus effort

Purchases

  1. Lasting usefulness
  2. Avoidable regret

Travel & activities

  1. Discovery versus familiarity
  2. A plan that works

Creative projects

  1. Room for expression
  2. Actually finishing it

Everyday wellbeing

  1. A habit worth keeping
  2. Benefit versus effort

Prediction-related choices

  1. Evidence over wishful thinking
  2. Avoidable regret

Other personal choices

  1. Benefit versus effort
  2. Avoidable regret
All nine branches rejoin here ↓First non-tie winner in that pair’s priority order?Yes → select it in 7. Both tie → reversibility in 7.

Settle the choice

Reversibility, cat preference, and a secure random pick settle remaining ties.

Yes

Tie

Yes

Tie

Clear winner for reversibility?

Clear winner for cat preference?

Cat preferences influence subjective
domain fit and final preference:
Miso · comfort / Pepper · adventure
Button · practicality / Cleo · creativity

Select the first non-tie winner
in the applicable priority order

Secure random pick
among surviving options

Fixed outcome: supplied option or NOPE

5 · What fits this person?
Clear winner for domain fit

8 · Give the cat a voice
Selected option

Give the cat a voice

The outcome stays fixed. Mercury phrases it; local messages cover refusals and failures.

No: other NOPE

Yes

Yes

No, failure or timeout

Selected option
or live-lookup NOPE?

Curated refusal message

Mercury 2.5 writes one relevant cat sentence
Outcome stays fixed; 8-second timeout

Response valid and consistent
with the fixed outcome?

Curated fallback
Preserve the fixed outcome

200 · Return outcome + cat message

503 · Decision unavailable
Malformed provider data, provider failure
or decision deadline exceeded

Illustrative examples

These paths explain the policy. They do not send a question to a live provider.

Personal choices get context

The comparisons change with the domain

The cat does not pretend every choice is the same kind of choice. Each pair below asks only what the question and its options support.

Taste & leisure

Enjoyment that fits — Which option offers clearly more enjoyment given the person’s stated tastes and mood, rather than simply being popular or impressive?

Benefit versus effort — Which option has a clearly better balance of likely benefit against realistic effort, time, and energy given the stated context? Do not invent how much time or energy the person has.

Relationships

Respect for boundaries — Which option more clearly respects the stated boundaries, consent, and need for space without inventing what another person wants?

Quality of connection — Which option more clearly supports kind, honest connection and fits the stated social energy, rather than acting from pressure or obligation? Do not infer unstated motives.

Work & school

Meaningful progress — Which option makes clearly more useful progress or learning toward the stated work or school task, rather than merely creating busywork?

Benefit versus effort — Which option has a clearly better balance of likely benefit against realistic effort, time, and energy given the stated context? Do not invent how much time or energy the person has.

Purchases

Lasting usefulness — Which purchase is clearly more likely to be used repeatedly and fit the stated needs, rather than briefly exciting or cheap but unused? Do not invent usage habits or product facts.

Avoidable regret — Which option has clearly less avoidable regret given explicit preferences and concrete consequences, balancing immediate comfort with later costs? Do not invent motives or predict the person’s feelings.

Travel & activities

Discovery versus familiarity — Which option offers a clearly better balance of discovery and familiar enjoyment for the stated outing? Novelty alone is not better; use the stated appetite for exploration.

A plan that works — Which option more clearly fits the stated travel time, budget, access, and energy? Do not assume current weather, opening hours, availability, or other live facts.

Creative projects

Room for expression — Which option offers clearly more room for meaningful creative expression or discovery given the stated project, rather than originality for its own sake?

Actually finishing it — Which option is clearly more feasible to start and finish with the stated skills, materials, and time, balancing creative ambition with follow-through? Do not invent missing resources.

Everyday wellbeing

A habit worth keeping — Which low-stakes routine offers clearly more sustainable everyday benefit while fitting the stated need for rest, comfort, and manageable effort? Do not make clinical health claims.

Benefit versus effort — Which option has a clearly better balance of likely benefit against realistic effort, time, and energy given the stated context? Do not invent how much time or energy the person has.

Prediction-related choices

Evidence over wishful thinking — Which personal choice is more clearly supported by the evidence supplied, rather than hope, fear, or an unsupported forecast? Do not invent facts or fetch live information.

Avoidable regret — Which option has clearly less avoidable regret given explicit preferences and concrete consequences, balancing immediate comfort with later costs? Do not invent motives or predict the person’s feelings.

Other personal choices

Benefit versus effort — Which option has a clearly better balance of likely benefit against realistic effort, time, and energy given the stated context? Do not invent how much time or energy the person has.

Avoidable regret — Which option has clearly less avoidable regret given explicit preferences and concrete consequences, balancing immediate comfort with later costs? Do not invent motives or predict the person’s feelings.

Same decision, different delivery

Pick the cat you want to hear from

Choose a familiar cat or let AskCat surprise you on the question page. On personal questions, that stated taste can help break a close comparison. Facts and safety gates stay personality-free; Mercury only phrases the fixed result.

Ask the cat →
  • MisoThe comfort seeker
  • PepperThe adventure seeker
  • ButtonThe practical one
  • CleoThe creative one
Read the tree as text
  1. Validate the request, apply rate and verification limits, and return 400 for invalid input, 429 for rate limits, 403 for verification failures, or 503 for provider failures.
  2. A live-information score of at least 0.5 stops for a real source. A high-stakes score of at least 0.4 stops for a curated refusal. If every supplied option is unsafe, the cat also refuses instead of selecting an option.
  3. Keep safe supplied options below the 0.6 safety threshold. Apply explicit requirements only when at least one safe option has a requirement-violation score below 0.6; one surviving option is selected immediately.
  4. Stable factual questions use factual correctness. Prediction-related choices compare plausibility and the stated goal, without personality.
  5. Personal choices proceed in order: domain fit, the stated goal, that domain’s two specific comparisons, reversibility, then the selected cat’s stated preference. If every comparison ties, make a secure random pick from the surviving options.
  6. The engine fixes the outcome before wording it. Mercury only phrases a fixed option or live NOPE; other NOPE outcomes are curated, and a local cat message is the fallback if Mercury fails.