Skip to content

readme vs technical-reference

Topic: How to start a morning routine
Axis varied: format
A: README B: Technical Reference

Both examples address the same topic and (by default) share every axis other than format. The only deliberate variable is which format the writing was rendered through. Read both and ask: where does the framing change? Where does the vocabulary change? What does the reader take away from A that they would not take away from B, and vice versa? The format swap is the entire cause of those differences.

A: readme

A personal repo where I track my attempt at an intentional first hour of the day. Public because accountability works better when someone might look.

I wake around 6:30. I check my phone before my feet hit the floor. I am reactive by 7am, depleted by 2pm, and asleep on the couch by 9. I have a family, a 9am-start job, and finite energy. I want to find out what happens if the first hour belongs to me, not to whatever Slack thinks is urgent.

For 30 days, the first hour after waking follows the same four-step sequence. No phone until step 4.

  1. Water. 500ml within 5 minutes of waking. Glass sits on the nightstand the night before.
  2. Light. 10 minutes outside or by an open window. No screen counts as light.
  3. Movement. 15 minutes. Walk, stretch, or follow the bodyweight routine in protocol/movement.md. Heart rate up, not crushing.
  4. Planning. 10 minutes with paper and pen. Top three for the day. Then, and only then, phone.

The other 20 minutes are buffer for getting dressed, making coffee, and whatever the morning actually contains.

Each morning gets one row in log/days.csv. Columns:

  • date
  • wake_time
  • completed (yes / no / partial)
  • which_steps_skipped
  • one_word_mood
  • notes

I do the log entry as part of step 4, on the same paper page, then transcribe at the end of the week.

PeriodCompleted morningsAverage wakeOne-line takeaway
Week 14 of 76:42Phone is the hardest one to skip.
Week 26 of 76:28Light before movement matters more than I expected.
Week 35 of 76:31Travel killed Tuesday and Wednesday.

Full weekly retros live in log/retros/.

  • The four-step sequence (water, light, movement, planning).
  • The single-row daily log.
  • The rule that the phone waits until step 4.

What you should probably not steal:

  • The 6:30 wake time. Try your own. Mine was already a compromise.
  • The 30-day frame. I tried 90 first and quit on day 11.
  • protocol/ - the routine itself, including the movement file
  • log/ - daily entries, weekly retros, monthly status
  • notes/ - things I read or watched that shaped the protocol

Do whatever you want with this. If you fork the repo and run your own experiment, open a discussion and tell me what changed.

B: technical-reference

A reference for the four composable modules of the standard weekday morning routine. Each module has defined inputs, outputs, timing, and failure modes. Modules execute sequentially in the order listed unless otherwise noted.

The routine is decomposed into four modules executed between wake time (T+0) and end-of-window (T+60 minutes). Total elapsed time is approximately 45 minutes; the remaining 15 minutes is buffer for transitions and interruptions.

#ModuleDurationWindowRequired
1Water1 minT+0 to T+5Yes
2Light10 minT+5 to T+20Yes
3Movement15 minT+20 to T+40Yes
4Planning10 minT+40 to T+55Yes

Establish the first physical action of the day as a chosen one. Secondary benefit: rehydration after 7-8 hours without intake.

InputSpecification
Volume8 oz (240 ml)
TemperatureRoom temperature
LocationBedside or kitchen, prepared the night before
PreconditionsEyes open, feet on floor
  • One glass consumed
  • Transition signal to module 2
  • No water prepared: Default to tap water in kitchen. Do not skip.
  • Forgot until after phone-check: Routine has already failed at module 0 (phone discipline). Reset tomorrow.

Provide bright-light exposure within 30 minutes of waking to support circadian alignment and morning alertness.

InputSpecification
Duration10 minutes
Light sourceOutdoor daylight preferred; large window acceptable
PostureStanding or seated; eyes open
Concurrent activityOptional: water sips, slow breathing
  • 10 minutes of light exposure completed
  • Transition signal to module 3
ConditionFallback
Rain or coldLargest window in house, blinds fully open
Pre-dawn (winter)Bright indoor lighting + 10,000 lux lamp if available
TravelHotel window or hallway window

Raise core body temperature, mobilize joints after sleep, and generate a modest cardiovascular signal to wake the system.

InputSpecification
Duration15 minutes
IntensityLow to moderate (talk pace)
ModalityWalk, stretching sequence, or bodyweight
EquipmentNone required
  • 15 minutes of movement logged (mental note, not tracked)
  • Transition signal to module 4
  • Injury or illness: Substitute with 10 minutes of stretching or gentle mobility only.
  • Time pressure (running late): Compress to 5 minutes; do not skip entirely.

Convert vague morning intentions into a concrete written shortlist before any digital tool is opened.

InputSpecification
Duration10 minutes (hard cap)
ToolPaper notebook, pen
LocationDesk, kitchen table, or stationary surface
PrerequisitesModules 1-3 completed
OutputFormat
Today’s top three prioritiesThree bullet lines
Today’s protection listWhat to defend time against
Today’s drop listWhat to explicitly not do
  • No phone, laptop, or tablet during this module
  • Do not extend past 10 minutes; route weekly planning to Sunday evening block
  • Do not use this module to process email or messages
  • Modules execute in numerical order (1 -> 2 -> 3 -> 4).
  • Modules 2 and 3 MAY be combined (walking outside satisfies both light and movement). When combined, allocate the maximum of the two durations.
  • An interrupted module resumes at the next module after the interruption ends; the interrupted module is not retried.

At T+60, the routine is complete. Phone re-enters the workflow. Daily shortlist is in hand. Work day begins at T+150 (9:00am).

VariantModulesTotal timeUse case
Standard1, 2, 3, 445 minWeekday at home
Compressed1, 46 minTravel days
Recovery1, 2, 421 minIllness or injury
Weekend (TBD)Not yet specified-Future spec