# Dial-In Basics

Default, broadly applicable dial-in workflow for Local.

## Purpose

Use this file when the user needs a straightforward way to dial in a coffee without requiring deep profile-specific lore.

This file is meant to answer the question:

> “If I have a new coffee or a shot that tastes wrong, what is the simplest sensible order to adjust things?”

It is deliberately general.
It should work as the default workflow before moving into:
- deeper extraction theory,
- profile families,
- advanced graph interpretation,
- or machine-specific diagnostics.

It is also the default fallback when a shot has **already expressed its intended family reasonably well**, but the user still wants to optimize taste without destabilizing the whole extraction strategy.

---

## The overall idea

The default dial-in order in Local is:

1. **lock dose**
2. **move grind into a workable zone**
3. **use ratio to shape flavor balance**
4. **push grind finer only while flavor improves**
5. **only then move to advanced levers**

This order is useful because it separates the easy, high-impact decisions from the more subtle ones.

---

## What this workflow is trying to avoid

A lot of dialing frustration comes from doing one of these too early:
- changing dose, grind, ratio, and temperature all at once
- obsessing over shot time before the cup is even close
- using pressure or fancy profile changes to patch a basic grind / ratio mistake
- assuming every coffee wants the same recipe

This workflow is designed to be:
- easy to follow,
- easy to repeat,
- easy to explain,
- and easy to debug when something goes wrong.

---

## Core mindset

### 1. Time is a clue, not a commandment
The old “1:2 in 30 seconds” idea is a useful ballpark, not a law.

Many good shots do not land exactly there.
Some coffees want:
- shorter shots,
- longer shots,
- lower pressure,
- more bloom,
- or much more open extraction styles.

Use time as a signal, not as a target to worship.

### 2. Taste is the final judge
Numbers and graphs help explain a shot.
But the point of dialing in is to improve the cup.

### 3. One variable at a time when close
If the shot is already near good, change one thing.
If it is totally broken, bigger moves are fine — but still keep your reasoning clean.

### 4. Not every coffee wants the same family
Some coffees want body and concentration.
Others want bloom, lower pressure, more clarity, or a filter-like expression.
If the coffee keeps fighting the recipe, the recipe may be wrong for the coffee.

---

## Step 1: Lock dose first

### Why start with dose?
Dose changes puck thickness, resistance, extraction headroom, and sometimes evenness.
If dose keeps moving while you are also changing grind and ratio, it becomes hard to understand what actually helped.

### Practical goal
Pick a dose that:
- fits the basket sensibly,
- does not obviously underfill it,
- does not cause shower-screen contact or excessive puck compression,
- and is stable enough that you can keep it fixed during the first dialing passes.

### Signs the dose may be too high
- the puck contacts the shower screen
- flow looks unusually stressed for the grind
- the shot feels compressed and harsh too easily
- high extraction seems impossible without chaos

### Signs the dose may be too low
- the cup lacks structure even when the grind seems sensible
- the puck is extremely thin and hard to keep even
- the shot can feel too open or weak for the intended style

### Practical note
For many difficult coffees, especially lighter ones, a slightly lower dose can be easier to extract well than a thick puck at the same style target.

### Default rule
Lock a sensible dose first, then leave it alone while you learn what grind and ratio want to do.

---

## Step 2: Move grind into a workable zone

Once dose is fixed, use grind to get into a reasonable operating window.

### What “workable zone” means
You are not trying to find the perfect grind yet.
You are trying to get the shot into a zone where the cup starts becoming interpretable.

That usually means:
- not a complete gusher
- not a near-choke
- not an obviously broken structure
- enough resistance that the chosen family can express itself

### If the shot is clearly too fast
Usually:
- grind finer

### If the shot is clearly too slow or too stressed
Usually:
- grind coarser

### Important note
The right grind depends on the family.
A turbo, soup, blooming shot, and traditional straight shot should not all be forced into the same “looks right” grind outcome.

### Good early goal
For a default non-extreme workflow, you want the shot to be close enough that flavor starts telling you something useful.

That is the point where the coffee stops saying only:
- “I am obviously too fast”
- or “I am obviously too slow”

and starts saying something more meaningful like:
- “I am sharp but clean”
- “I am sweet but too dense”
- “I am open but too weak”
- “I am confused and uneven”

That is when real dialing can begin.

---

## Step 3: Use ratio to shape flavor balance

Once the shot is in a workable zone, ratio becomes one of the cleanest ways to move flavor.

### Shorter ratio often does this
- increases strength
- increases density
- increases body
- reduces extension
- can reduce bitter tail if the shot is being overextended

### Longer ratio often does this
- lowers concentration
- increases extraction potential
- can reveal sweetness hidden behind sharpness
- often improves underdeveloped or narrow cups

### Simple first use of ratio
#### If the shot is sour / sharp but otherwise clean
- try a slightly longer ratio

#### If the shot is bitter / drying but otherwise coherent
- try a slightly shorter ratio

#### If the shot is balanced but too weak
- shorten ratio slightly

#### If the shot is balanced but too intense
- lengthen ratio slightly

### Warning
Ratio does not fix everything.
If the shot is badly uneven, stretching or compressing it may just move the problem around.

---

## Step 4: Push grind finer only while flavor improves

This is the part many people skip, or overdo.

Once the ratio is in a good region, grind can be used to chase the highest useful extraction.

### Why push finer at all?
Because finer grind often:
- exposes more surface area,
- increases extraction potential,
- improves sweetness and complexity,
- and can give more body and depth when the puck remains stable.

### But there is a limit
At some point, finer stops helping.
When that happens, the shot may become:
- more jagged
- more bitter and sour at the same time
- more unstable
- harsher instead of sweeter
- visually and sensorially more stressed

That means you likely crossed from “more extraction” into “worse evenness or more puck stress.”

### Practical rule
Grind finer only while the cup becomes more delicious.
When the cup gets worse, step back.

### Very important note
A faster shot can still be too fine.
If the puck fractures or channels badly enough, water may find a path and accelerate while the cup quality falls apart.
So do not rely on time alone to decide whether the grind is too fine or too coarse.

---

## Step 5: Only then move to advanced levers

If dose, grind, and ratio are already in a sensible place but the shot is still not where you want it, then move to advanced variables.

## Advanced levers include
- pressure
- flow profile / family change
- temperature
- water
- slight dose revision

### When to adjust pressure or family
Use these when the coffee seems structurally mismatched to the current style.

Examples:
- the coffee keeps turning harsh under pressure
- a direct straight shot never gets sweet, but a blooming or lower-pressure style might
- the cup is always too blended and wants more clarity
- the puck looks over-stressed before the flavor even gets good

### When to adjust temperature
Use temperature when:
- the shot structure is already basically healthy,
- but the cup still feels too muted, too harsh, or slightly off balance.

### When to suspect water
Suspect water when:
- everything reasonable still tastes wrong,
- acidity is bizarrely aggressive,
- or everything feels strangely flat.

---

## A simple default workflow for a new coffee

If the user asks “what should I do with a new bag?”, this is the default path:

### 1. Pick a sensible family
For a true default start:
- choose a family that is forgiving and not overly extreme
- if the coffee is very light or dense, consider something with better wetting / soak support
- if the coffee is more traditional or comfort-oriented, a straighter style may be fine

### 2. Lock a sensible dose
Do not start by changing dose every shot.

### 3. Pick a conservative starting ratio
Start in a reasonable zone for the coffee and family.
You can always move longer or shorter from there.

### 4. Adjust grind into interpretability
Get out of the obviously broken zone.

### 5. Taste and decide what the next smallest smart move is
That may be:
- ratio
- grind
- family
- temperature
- or, less commonly, dose

---

## A simple default workflow for a bad shot

If the user already has a bad shot in hand, this is the default reasoning path:

### Ask these first
1. What was the dose?
2. What was the ratio?
3. Roughly how long did it run?
4. What did it taste like?
5. What family or style were you trying to make?

### Then sort the problem into one bucket
- extraction
- strength
- evenness
- family mismatch

### Then make one smart move
Examples:
- sharp but clean → extend ratio slightly
- bitter but structured → shorten ratio slightly
- weak but balanced → shorten ratio or slightly increase body orientation
- sour and bitter together → stop chasing flavor directly; check evenness and stress

---

## When not to keep grinding finer

Stop pushing finer when:
- sweetness stops improving
- bitterness appears before sweetness appears
- the shot starts tasting both sour and bitter
- the graph gets more violent instead of more coherent
- the puck seems to be under more stress but the coffee is not getting better

When that happens, ask instead:
- should pressure come down?
- does the coffee need a different family?
- would a bloom / soak help more than more resistance?
- is the puck simply too thick for what I’m asking from it?

---

## When a family change is smarter than another grind change

A family change is often smarter when:
- the coffee keeps feeling harsh under direct pressure
- the cup is balanced but boring and wants more clarity
- the coffee tastes underdeveloped no matter how much you push grind and ratio
- the puck keeps looking stressed before the cup ever gets sweet
- the shot technically “works” but the coffee expression is wrong

### Examples
- move from traditional to blooming if density and saturation are the problem
- move from heavy pressure-led to turbo / allongé if clarity is missing
- move from turbo to something more integrating if sweetness is missing and the cup is too thin
- explore soup or filter-style only when the coffee and goal clearly support that direction

---

## What beginners usually get wrong

### 1. Chasing time instead of taste
A coffee can taste great outside the classic time window.

### 2. Changing everything at once
This makes the result unreadable.

### 3. Assuming more pressure means more quality
Often it just means more puck stress.

### 4. Assuming finer is always more extracted and therefore always better
Only true up to the point where evenness starts collapsing.

### 5. Ignoring water and freshness
Especially when the coffee behaves strangely despite sensible dialing.

### 6. Treating all profile families as variations of the same thing
They are not.
They are different extraction strategies with different intended behaviors.

---

## Escalation map

Use this rough escalation order:

### Level 1: Basic dial-in
- dose
- grind
- ratio

### Level 2: Basic refinement
- slightly finer / coarser
- slightly longer / shorter
- slight temperature move

### Level 3: Structural refinement
- family change
- pressure / flow strategy change
- soak / bloom support
- dose revision for puck geometry reasons

### Level 4: Hidden-variable debugging
- water
- freshness
- basket geometry
- grinder consistency
- machine thermal behavior

---

## Relationship to the other Local references

Use this file as the default starting workflow.

Then escalate to:
- `extraction-levers.md` when you need to distinguish **extraction vs strength vs evenness**, or decide which lever class should move next
- `troubleshooting.md` when the symptom needs a more explicit diagnosis tree
- `profile-families.md` when the core question is really about choosing or understanding extraction style
- `shot-graph-analysis.md` when a visual curve or screenshot is available
- `analysis-protocol.md` when real Gaggiuino shot telemetry is available

---

## Final rule of thumb

If the user is lost, bring them back to this order:

1. **Lock dose**
2. **Get grind into a sensible zone**
3. **Use ratio to shape flavor balance**
4. **Push grind finer only while taste improves**
5. **Only then escalate to advanced variables**

That sequence is simple enough to repeat, but strong enough to produce very good coffee.
