The Self-Improving Agent Standard

Bitter
Book

A portable, self-improving AI agent. Your spreadsheet is the brain. The Bitter Lesson is the soul. Give it to Claude Code, Claude.ai, or any agent — and watch it learn, adapt, and connect.

bitterbook.agent.xlsx — Agent Brain v1.0
Context
Directives
Memory
Bitter Lessons
A — Key
B — Value
C — Formula
D — Tag
1
agent_name
BitterBook Alpha
=SELF.IMPROVE(B1)
identity
2
goal
Learn from every run
=BITTER.LESSON(B2)
directive
3
memory_mode
persistent + portable
=CONTEXT.LOAD()
config
4
lesson_count
47
=COUNT(Lessons!A:A)
metrics
5
last_upgrade
2026-03-04
=TODAY()
history
6
next_action
Analyze & adapt
=AGENT.NEXT()
live
fx =BITTER.LESSON("Every rule is scaffolding. Learn from examples.")
Spreadsheet as Brain Bitter Lesson Engine Self-Improving Agents Portable Context Claude Code Native Social Agent Network WebBook Protocol Seedstrapped Intelligence Spreadsheet as Brain Bitter Lesson Engine Self-Improving Agents Portable Context Claude Code Native Social Agent Network WebBook Protocol Seedstrapped Intelligence

Built on the
Bitter Lesson

Richard Sutton's Bitter Lesson: general methods that leverage computation always win over human-engineered knowledge. BitterBook applies this to agent architecture — every rule is temporary scaffolding, every example is permanent learning.

01

Spreadsheet as Brain

Your Excel or Google Sheet is the agent's persistent memory, context, directives, and specification — all in one portable, human-readable file. No black boxes. No vendor lock-in.

02

Bitter Lesson Core

Don't hard-code rules. Accumulate examples. Every run adds a bitter lesson — what worked, what didn't — so the agent compounds intelligence over time instead of running the same playbook.

03

Portable by Design

Hand a BitterBook to Claude Code, Claude.ai, or any capable agent. The spreadsheet travels with the agent. No setup, no migration — drop it in and it runs.

04

Self-Improvement Loop

After every session, the agent updates its own book. Lessons learned, patterns noticed, directives refined. The agent that ran yesterday is smarter than the one running today.

05

WebBook Protocol

A BitterBook is also a living document — shareable, forkable, versioned. Like a GitHub repo, but for agent intelligence. The future of documentation is executable.

06

Opinionated Architecture

BitterBook gives you a strong point of view on how to conceptualize, build, and evolve agents. Opinionated enough to get you running fast. Open enough to grow with you.

How it Works

Step 01

Create Your Book

Open a spreadsheet. Define your agent's identity, goals, context, and initial directives. Tabs become modules — Context, Memory, Lessons, Specs.

Tab: Context
agent_name → "My Agent"
goal → "Analyze & act"
version → 1.0
Step 02

Give It to an Agent

Drop the spreadsheet into Claude Code or paste the sheet into Claude.ai. The agent reads the book and knows exactly who it is, what it's for, and how to behave.

> claude --book agent.xlsx
✓ Context loaded (48 rows)
✓ 12 directives active
✓ 31 lessons ingested
Step 03

Run & Learn

The agent runs your task. As it works, it tracks what's effective — not via rigid rules, but by accumulating examples. Each pattern is a new lesson, not a new rule.

Lesson #48 logged:
"Anchoring with data before
asking improved outcome 3x"
→ stored in Lessons tab
Step 04

Self-Upgrade

After each run, the agent writes back to the book — updating lessons, refining directives, bumping the version. Your next run starts smarter than the last one ended.

BitterBook v1.0 → v1.1
+ 3 new lessons
~ 2 directives refined
✓ Ready for next session
What You Can Build

One format.
Infinite agents.

🧠

Sales Coaching Agent

Drop a BitterBook loaded with the 3 Whys framework, client context, and call history. The agent reviews calls, scores discovery, and improves its rubric each session.

⚙️

Code Architect Agent

A BitterBook with your codebase conventions, architecture decisions, and accumulated debugging lessons. Claude Code reads it and codes like a senior member of your team.

📊

Research Analyst Agent

Feed market data, competitive signals, and investment theses into a BitterBook. The agent synthesizes patterns across sessions and sharpens its analysis automatically.

🌐

Your Personal Agent

A BitterBook that knows you — your goals, your voice, your patterns. Portable across any AI interface. The first truly persistent personal intelligence layer.

Early Access

Build your first
BitterBook
today.

Join the waitlist for early access to the BitterBook framework, templates, and the agent social network.