๐กLet me start with the truth of things first, because the truth is the lesson.
================= Token Warning โ ๏ธ==========
Before anyone comes for me ๐
๐ Note: depending on what you are loading, you are accruing token cost. And token cost can ballon if you are not careful.
If any of the files in the initializing phase or handoff phase are large this can become a token intensive practice so when curating this process, BE INTENTIONAL only load what is absolutely needed for the project to start up and for you to get to the fun part, building!
I budget for my own needs, for me this initialization for me is between 5k and 10k, I have made the mistake of making 40k, don't do that!
If you want to understand an estimate of what your character to token ratio is use the site below:
Anthropic tokenizer has not been released yet, but Its a few % higher than OpenAI in some cases.
Plain English sentence (115 characters)
- OpenAI GPT-4: 23 tokens
- OpenAI GPT-4o: 23 tokens
- Claude (content only): 23 tokens
- Result: identical
Code and markdown snippet (86 characters)
- OpenAI GPT-4: 24 tokens
- OpenAI GPT-4o: 26 tokens
- Claude (content only): 27 tokens
- Result: Claude a few percent higher
Numbers and punctuation (55 characters)
- OpenAI GPT-4: 25 tokens
- OpenAI GPT-4o: 25 tokens
- Claude (content only): 27 tokens
- Result: Claude about 8 percent higher
One honest footnote: Claude's API adds roughly 7 fixed tokens per message for formatting. On a single short line that looks like a big gap. On a real document it amortizes down to almost nothing.
โ
The takeaway:
for the same English text, the tokenizers land within a few percent of each other. The scary "Claude costs way more tokens" headlines do not hold up when you actually measure it. Verified beats confident, every time.
You have been learned and you have been warned!
============ Back to it! ๐=================
I have lost work. An automated cleanup script once deleted dozens of session files we could not get back. The rebuild was awful, painstaking, and a lesson learned.
We came within one command of running a test suite against a live database full of real data.
A contact form sat quietly broken for a full week because a safety shortcut faked success instead of telling us it failed.
None of those were bad luck. Every one of them happened the same way: moving fast, skipping the boring step, trusting that this time it would be fine.
For me, the solution was building two rituals.
1๏ธโฃ My Initialization ritual
2๏ธโฃ My Handoff ritual.
These run every session, no exceptions. Here is exactly what they do, and why they work.
โญ Ritual 1: Initializing (the pre-flight)
Before any real work happens, we run a start sequence. Think of a pilot's pre-flight checklist. (Shameless reference ๐ I know)
Flight number one and flight number ten thousand get the same checklist, because the day you skip it is the day it's things go wrong.
Here is the shape of it:
=========๐ Initialization Starts================
SESSION START (initializing)
โโโ 1. Read the handoff first
โ-----โโโ where we left off
โ-----โโโ what is next
โ-----โโโ what is blocked
โโโ 2. Load only what this project needs
โ-----โโโ less noise, fewer mistakes
โโโ 3. Load the hard rules, every time
โ-----โโโ no irreversible change without a human check
โ-----โโโ verify before stating anything as fact
โ-----โโโ show the raw output, never a summary
โ-----โโโ protect the data
โโโ 4. Give a short briefing, then stop
โ-----โโโ where we are
โ-----โโโ what is next
โ-----โโโ blockers
โ-----โโโ open questions
โ-----โโโ proposed first move
By the time work starts, nobody is guessing.
=========๐ Initialization is complete at this point====
=============Session Start - You build =============
Where the magic happens! ๐ง๐งโโ๏ธ๐งโโ๏ธ๐งโโ๏ธ๐ง๐งโโ๏ธ๐ฉ๐ช๐ฎโจ
=============Session Ends - Building Stopped=======
=========๐ Session ends - Handoff Ritual Begins====
๐ Note: the same Token awareness is required at this point as well, giving sharp intentional instruction makes a huge difference and it will save you time and money (Tokens)
โญ Ritual 2: The handoff (the post-flight log)
When the session ends, we do not just walk away. We close out on purpose.
SESSION END (handoff)
โโโ 1. Update the handoff
โ-----โโโ what got done
โ-----โโโ what is next
โ-----โโโ what is still blocking
โโโ 2. Update the health log
โ-----โโโ issues found
โ-----โโโ issues resolved
โโโ 3. Confirm a clean baseline
โ-----โโโ run the tests
โ-----โโโ run the build
โโโ 4. Tag the known-good point
โ-----โโโ recommend where next session starts
The next session opens to a clean desk instead of a mystery.
=========๐ Session ends - Handoff Ritual Begins====
๐ก What this actually buys me ๐ก
Three things, and they make things a lot easier to maintain for me.
๐งผ Clean.
Every session starts from a known, current state. No drift, no stale notes, no "wait, what were we doing."
๐ฏ Accurate.
Nothing gets called done without proof. We show the real output, not a confident summary. No guessing dressed up as fact.
๐ Safe.
Data protection is baked in, and the human is always the gate. Nothing permanent happens without a check first.
๐กYou can use this today; you do not need my exact setup. You need two bookends, and a handful of plain files that hold the state between them.
1๏ธโฃ Initialization ritual
2๏ธโฃ Handoff ritual.
YOUR WORKSPACE
โโโ start-ritual---------|โ load context + rules BEFORE any work--- Be mindful of input size
โโโ end-ritual----------|โ write down state BEFORE you close --- Be mindful of output size
โโโ the files they read
โ-โโโ handoff.md---------| โ where we left off, what is next
โ-โโโ health-log.md------| โ open issues, what is fixed
โ-โโโ standards.md------| โ the rules you never break
โ-โโโ start-here.md------| โ the ritual itself, written down
Write it down. Make it repeatable. Run it every time, especially when you are tired, because tired is exactly when the boring step gets skipped, and when the work is in danger of re-work.
๐ The 7 Ps are real.
๐กProper Prior Planning Prevents Piss Poor Performance.
If this helps you, please let me know in the comments!
๐ค And I do have one question that I have put it in a Poll.
Do you run rituals?