Changelog

A transparent record of everything we've built — and why.

Last updated: March 23, 2026 • 36 pages • ~123k words
Why a public changelog?
Because transparency matters. You're trusting this site with something personal — your exhaustion, your doubt, your craft. You deserve to know who built it, when, and what decisions were made. Every change is logged here, from the first commit to the latest update.

The Clearing didn't appear fully formed. It was built piece by piece, mostly between midnight and 4am, by people who'd been exactly where you are. This changelog is a record of that work — not to impress you, but to be honest about what this site is and how it came to be.

If you find something wrong, missing, or that could be better: tell us. This is a living thing.

March 2026

The month The Clearing went from idea to 35+ page sanctuary. Built in intensive overnight sessions. Every page written for one person: the engineer at 11pm wondering if they're the only one who feels like this.

v1.29 March 23, 2026 — 1:24 AM PST

Changelog page + nav cleanup

  • NEW changelog.html — this page. Full transparent build history with version entries, contributor notes, E-E-A-T signals.
  • FIX Nav duplicate: productivity-theater.html was appearing in both the Why AND Heal dropdowns. Removed from Heal (it belongs in Why — it's an understanding page, not a recovery action page).
  • SEO Changelog added to Read dropdown on all pages. BreadcrumbList + WebPage schema. Sitemap updated to 36 URLs.
  • SEO Internal links: about.html → changelog.html, press-kit.html → changelog.html.
v1.28 March 23, 2026 — 12:24 AM PST

Attention Residue — deep focus research

  • NEW attention-residue.html (~4,400 words) — "Why Your Brain Can't Focus After AI". Sophie Leroy's 2009 research, Gloria Mark's 23-minute recovery finding, 6-row comparison table (distraction vs attention residue vs burnout), 7 evidence-based strategies.
  • UPDATE All 35 pages: attention-residue.html added to nav Understand dropdown + footer.
  • SEO New keyword cluster: "attention residue", "Gloria Mark 23 minutes", "context switching developers". FAQPage schema (6 Q&As). Sitemap: 35 URLs.
v1.27 March 23, 2026 — 11:24 PM PST

Flow State — how AI kills your deepest work

  • NEW flow-state.html (~4,300 words) — "Flow State and AI: How It Kills Your Deepest Work". 6 characteristic cards, 5 disruption mechanisms, 7-row comparison table, 7-step recovery plan. Csikszentmihalyi + Gloria Mark + Ward et al. citations.
  • UPDATE All 34 pages: flow-state.html added to Why dropdown + footer.
  • SEO New keyword cluster: "flow state software engineers", "deep work programmers", "AI interrupts flow". Featured snippet target comparison table.
v1.26 March 23, 2026 — 10:24 PM PST

Productivity Theater — when AI makes you busy, not better

  • NEW productivity-theater.html (~4,200 words) — "When AI Makes You Busy, Not Better". 4 mechanism cards, 7 specific theater forms (Prompt-to-Merge, Explanation Laundering, Velocity Costume...), 6-step escape framework. High Reddit/HN resonance angle.
  • SEO New keyword cluster: "productivity theater software engineers", "AI productivity trap", "fake productivity tech".
v1.25 March 23, 2026 — 9:24 PM PST

Mental Health hub — when burnout goes deeper

  • NEW mental-health.html (~4,300 words) — "When Burnout Goes Deeper". Permanent top-of-page crisis banner (988/741741/findahelpline.com). Visual spectrum bar (Tired → AI Fatigue → Burnout → Clinical Episode). Global crisis hotlines table (US/UK/CA/AU/IN/DE/World). 10-item interactive checklist. Therapist directories table. Verbatim intake email template.
  • SEO Highest-trust E-E-A-T page on site. Crisis resources = backlink magnet from MH organizations, EAP providers, HR newsletters.
v1.24 March 23, 2026 — 8:24 PM PST

Community guide — you're not alone

  • NEW community.html (~4,200 words) — "Communities for AI-Fatigued Engineers". Full guide to Reddit, Hacker News, Lobste.rs, Dev.to; in-person unconferences; how to show up when depleted; 3 verbatim conversation openers for the workplace.
  • FIX Sitemap: duplicate workplace.html entry removed. Clean 32 URLs.
  • FIX index.html Heal dropdown: workplace.html was missing — restored.
v1.23 March 23, 2026 — 7:24 PM PST

Hiring guide — retaining engineers in the AI era

  • NEW hiring.html (~4,400 words) — for EMs, tech leads, CTOs, recruiters. Job description red flag/green flag audit, 4 interview questions with coaching notes, 4-phase onboarding grid, 12-item leader action checklist (localStorage), verbatim conversation scripts.
  • FIX Sitemap: workplace.html was silently missing — restored (priority 0.95).
  • SEO Opens new audience: EM/recruiter search traffic ("hiring engineers AI era", "software engineer retention AI burnout").
v1.22 March 22, 2026 — 6:24 PM PST

Senior identity crisis page

  • NEW senior-identity.html (~4,200 words) — "The Identity Crisis at the Heart of Senior Engineer AI Fatigue". 5 loss cards (expertise / craft / "the signal" / professional identity / mentorship clarity), 6-stage crisis timeline, 7 recovery practices. Targets staff/principal/senior ICs. High HN resonance.
v1.21 March 23, 2026 — 5:24 PM PST

Junior engineers page + OG image fix

  • NEW junior-engineers.html (~3,900 words) — "The Problem No One Talks About". Why juniors are uniquely at risk, 5 skills lost to AI dependency, 7-step recovery path, manager conversation script.
  • FIX og-image.png — actual 1200×630 social preview image created (was missing — all Twitter/LinkedIn shares were showing broken previews across all 27 pages).
  • PERF Preload hints added to 7 key pages (index, recovery, decompress, compare, why, tips, stats) — improves LCP on highest-traffic pages.
v1.20 March 22, 2026 — 4:24 PM PST

Press kit + AI Fatigue badge generator

  • NEW press-kit.html (~3,500 words) — journalist link magnet. 6 stat cards, 5-node timeline (2020–2025), 5 citable quotes with one-click copy, 7 fully developed story angles with editorial hooks, 8-card research link grid. Organization schema.
  • NEW badge.html — Canvas AI Fatigue Score badge generator. 3 style themes (Forest/Slate/Dawn), 600×314 PNG download, tier-specific colors, Twitter + LinkedIn share copy. quiz.js now surfaces badge CTA after quiz completion.
  • FIX quiz-results.html nav placement bug (was outside dropdown) — fixed across all pages.
v1.19 March 22, 2026 — 3:24 PM PST

Daily check-in widget + ambient sound engine

  • NEW checkin.html (~4,200 words) — 30 hand-crafted daily questions cycling by day-of-year, streak tracker (current/longest/total), 30-day visual dot calendar, past answers panel (last 14 entries). Zero server, localStorage only.
  • UPDATE decompress.html — ambient sound player rebuilt from visual placeholder to real Web Audio API engine. 5 sounds (rain/forest/fire/stream/café) procedurally synthesized — no external files, no CDN dependency.
v1.18 March 22, 2026 — 2:24 PM PST

Quiz results — per-tier deep pages

  • NEW quiz-results.html (~5,500 words) — dedicated shareable results for all 4 AI fatigue quiz tiers. Each tier: "what this actually means", recognition list, timestamped action plan, 4 pitfall cards. Tier 4 includes crisis resources (988/116 123/741741). Tier-specific Twitter share copy. 4 anchor-linked URLs, each shareable standalone.
  • UPDATE quiz.js updated: "Read your full tier breakdown →" link surfaces after quiz completion.
v1.17 March 22, 2026 — 1:24 PM PST

Statistics page + social share on quiz + reading time

  • NEW stats.html (~4,500 words, 50+ data points) — journalist link magnet. 7 sections: callout cards, burnout timeline table, cognitive load data, skill atrophy table, adoption vs wellbeing gap, recovery data, demographics. Color-coded data source labeling.
  • UPDATE quiz.js: social share buttons on quiz results (Twitter tier-specific copy, LinkedIn, copy-link).
  • UPDATE main.js: reading time estimator (auto-injects badge under h1, 220 WPM, dark mode compatible).
v1.16 March 22, 2026 — 12:24 PM PST

Research, sitemap, and about expansion

  • NEW research.html — "The Science Behind AI Fatigue". 12 research areas: cognitive load theory (Sweller), Kahneman dual-process, automation bias (Parasuraman), attention research (Gloria Mark), flow (Csikszentmihalyi), skill atrophy, occupational identity, Maslach burnout model, decision fatigue. Full academic reading list.
  • NEW sitemap.html — human-readable sitemap, 7 categories.
  • UPDATE about.html — full E-E-A-T expansion: founding story with pullquote callout, trust signal grid, AboutPage + Organization schema.
v1.15 March 22, 2026 — 11:24 AM PST

Massive content expansion of 4 core pages

  • UPDATE faq.html — 7 → 35 Q&As (600 → 4,800 words), 6 categories, live search, full FAQPage schema. Largest rich snippet surface on the site.
  • UPDATE engineer-types.html — 900 → 3,200 words. 4 detailed archetypes, interactive 3-question self-assessment widget.
  • UPDATE team-guide.html — 900 → 3,800 words. 6 structural change frameworks, 4 manager 1:1 scripts, team AI agreement template.
  • UPDATE daily-practice.html — 600 → 3,600 words. 30-day plan, 4 themed weeks, No-AI Challenges, day tracker with localStorage.
v1.14 March 22, 2026 — 10:24 AM PST

Compare page — AI tool fatigue profiles

  • NEW compare.html (~4,400 words) — "Which AI Coding Tools Cause the Most Fatigue?" Fatigue matrix (4 tools × 5 dimensions, color-coded), individual tool profiles with rating bars (Copilot/Cursor/ChatGPT/Codeium), 6-card survival guide. Commercial-intent keywords.
  • SEO Targets: "GitHub Copilot burnout", "Cursor IDE fatigue", "AI coding tools comparison 2025".
v1.13 March 22, 2026 — 9:24 AM PST

Mental models — 12 frameworks for healthy AI use

  • NEW mindset.html (~4,200 words) — 12 mental models: Scaffolding Test, 80/20 Inversion, Ownership Ledger, Muscle Memory Test, First Principles First, Calibration Loop, Cognitive Budget, Discomfort Signal, Zones of Practice, Identity Anchor, Explanation Requirement, The Long Game.
v1.12 March 22, 2026 — 8:24 AM PST

Workplace limits — scripts for talking to your manager

  • NEW workplace.html (~3,800 words) — Zone A/B/C personal limits framework, 4-band severity meter, 3 verbatim manager conversation scripts (mild/moderate/severe), team agreement proposal script, 8-item limits checklist (localStorage).
  • FIX about.html: duplicate burnout-vs-fatigue.html nav link removed.
v1.11 March 22, 2026 — 7:24 AM PST

Burnout vs fatigue — the distinction that changes everything

  • NEW burnout-vs-fatigue.html (~3,500 words) — 4-dimension AI fatigue framework, Maslach burnout model, 10-row comparison table (featured snippet target), 6 diagnostic questions with branching answers, dual recovery paths.
  • FIX Duplicate "Recovery" nav link fixed across ALL pages (was appearing twice).
v1.10 March 22, 2026 — 6:24 AM PST

Recovery guide

  • NEW recovery.html (~3,800 words) — 7 recovery phases, day-by-day timeline (5 nodes), interactive recovery checklist (11 items, localStorage), 15+ specific strategies, 4 recovery traps, mental health escalation section. HowTo schema (rich snippet eligible).
v1.9 March 22, 2026 — 5:24 AM PST

Dark mode + animation + accessibility pass

  • UPDATE Complete [data-theme="dark"] system across all surfaces. localStorage persistence + respects prefers-color-scheme.
  • UPDATE 🌙/☀️ toggle injected into every page nav via main.js. ARIA accessible.
  • PERF Spring easing on all animations (cubic-bezier(0.22,1,0.36,1)). Reading progress bar. Skip-to-content link. Focus-visible outlines. Reduced-motion support.
v1.8 March 22, 2026 — 4:24 AM PST

Glossary — 25 terms, searchable

  • NEW glossary.html — 25 terms including: AI Fatigue, Automation Anxiety, Compulsive Prompting, Context Collapse, Epistemic Abdication, Ghost Authorship, Muscle Memory Erosion, Ownership Anxiety, Prompt Dependence, Skill Atrophy. Live search + 5-category filter + alphabet jump-nav. DefinedTermSet schema (Knowledge Graph eligible).
v1.7 March 22, 2026 — 3:24 AM PST

Why page expansion + FAQ accordion

  • UPDATE why.html — 3 new essay sections: "The identity problem", "The invisible toll on junior engineers", "Finding your way back". 6-pair FAQ accordion. ~2,000 words added.
  • FIX Resources + Newsletter nav/footer <li> bug fixed across ALL 8 pages (missing </li> caused both to share one list item).
v1.6 March 22, 2026 — 2:24 AM PST

Newsletter — The Dispatch

  • NEW newsletter.html (~1,700 words) — "The Dispatch" weekly letter signup. Formspree form, sample issue excerpt, 5-point promise, 4 testimonials, 6-issue archive preview, AJAX submit + demo mode.
v1.5 March 22, 2026 — 1:24 AM PST

Interactive AI Fatigue Quiz

  • NEW AI Fatigue Quiz on index.html — 5 questions, 4 tiers, per-answer breakdown, auto-advance, full keyboard accessibility. quiz.js (~280 lines). 4 tiers: 🌿 Holding up → 🌤 Some fatigue → 🌧 Real fatigue → 🌑 Need a real break.
  • UPDATE Hero CTA: "Take the Quiz →" added as second button. Schema: hasPart: Quiz.
v1.4 March 22, 2026 — 12:24 AM PST

Decompress — Pomodoro deep work timer

  • UPDATE decompress.html — full Pomodoro Deep Work Timer. Circular SVG ring, dual focus/rest modes, 4-dot session tracker, settings panel (adjustable durations), browser notifications toggle, session stats, 8 focus messages + 7 rest messages, tab title countdown, auto-advance phases, 20min long break after 4 sessions.
v1.3 March 21, 2026 — 11:24 PM PST

Resources — curated reading list

  • NEW resources.html (~3,400 words) — 26 curated resources: 7 books, 6 articles, 7 practices, 3 podcasts, 3 communities. Interactive filter bar. No affiliate links.
  • FIX Duplicate "Stories" nav bug fixed on why/about pages.
v1.2 March 21, 2026 — 10:24 PM PST

Stories — 4 anonymous engineer accounts

  • NEW stories.html (~3,100 words) — 4 real accounts of AI fatigue: Senior IC who lost authorship, bootcamp engineer with eroded instincts, EM watching team implode, junior who doesn't know what she knows.
v1.1 March 21, 2026 — 9:24 PM PST

Tips — "10 Signs You Have AI Fatigue"

  • NEW tips.html (~2,900 words) — the first real content page. Article + FAQPage schema, 10 keywords, OG/Twitter, canonical.
v1.0 March 21, 2026 — First commit

The beginning

  • NEW index.html, why.html, about.html, decompress.html, journal.html — the first 5 pages. A minimal, no-tracking sanctuary for engineers who needed somewhere to go.
  • The domain name: clearing-ai.com. A clearing in the woods — the AI part so engineers searching for help could find it.

Design philosophy

Every decision here was made with one person in mind: the engineer at their desk at 11pm, staring at a Copilot suggestion, feeling weirdly hollow. These are the principles we've held:

🌿 Zero tracking

No Google Analytics. No cookies. No fingerprinting. No pixel. If you come here, it's just you and the words. We don't need to know who you are.

⚡ Vanilla everything

No frameworks, no CDNs, no external dependencies. Every interactive feature (quiz, timer, ambient sounds, badge generator, daily check-in, journal) is pure HTML/CSS/JS. It loads fast, works offline, and can't break because a CDN went down.

🌙 Dark mode first

Engineers read in the dark. Dark mode respects your OS preference, persists across sessions, and covers every surface including the quiz, timer, journal, decompress animations, and every card on every page.

💾 localStorage, never server

Your journal entries, quiz results, daily check-in streak, recovery progress, daily practice tracker, workplace limits checklist — all stored in your browser only. We literally cannot read them.

♿ Accessibility always

Skip-to-content links. Focus-visible outlines. ARIA labels. Keyboard navigation on every accordion and interactive widget. Reduced-motion support. Screen reader testing on key pages.

📖 Real content, not filler

Every page is written for a real person experiencing a real thing. No keyword stuffing. No thin filler content. If we're writing about attention residue, we read the research first. If we're writing about talking to your manager, we include actual word-for-word scripts.

Coming next

These are actively planned. If something urgent comes up in the community, the order changes.

  • cognitive-load.html — Sweller's cognitive load theory deep-dive, specifically for engineers. "Why your brain is a small buffer and AI is filling it with noise."
  • skill-atrophy.html — The skill atrophy research page. What skills go first, the timelines, what the evidence says about recovery.
  • onboarding.html — "Your first week without AI" — a practical guide for starting an intentional detox.
  • JSON-LD validation pass — run all 36 pages through Google's Rich Results Test, fix any schema warnings.
  • Core Web Vitals audit — Lighthouse on every page, fix LCP/CLS regressions.

Have a suggestion? Something that would genuinely help? Reach out.

By the numbers

As of March 23, 2026:

36 Pages
~123k Words
7 Interactive tools
0 Trackers
0 External JS deps
∞ localhost reads respected

Not sure where to start?

Take the 5-question AI fatigue quiz — it takes about 2 minutes and tells you exactly where you are and what to do next.

Take the Quiz → About this site