git:20261021.0580af1 to git:20261021.e9a298c

2 added, 0 removed. Audit A to A.

# AILmanac
> The always-current, community-built almanac for getting the most out of Claude — and every AI. From your first prompt to production agents, level-tagged and kept honest about freshness. Independent project, not affiliated with Anthropic; when AILmanac and the official docs disagree, the official docs win.
Site: https://derob98.github.io/ailmanac/ · Source: https://github.com/derob98/ailmanac
Every page is also available as Markdown: append `.md` to its URL.
## Start Here
- [Welcome & Why This Exists](https://derob98.github.io/ailmanac/docs/start-here/welcome): What AILmanac is, who it's for, and what it deliberately does not try to replace.
- [Which Claude Should I Use?](https://derob98.github.io/ailmanac/docs/start-here/which-claude): Chat vs Claude Code vs the API — plus mobile and voice. A quick decision guide.
- [Your First 5 Minutes](https://derob98.github.io/ailmanac/docs/start-here/your-first-5-minutes): From zero to a genuinely useful answer with Claude — the fastest possible first win.
- [Learning Paths (Choose Your Track)](https://derob98.github.io/ailmanac/docs/start-here/learning-paths): Sequenced reading orders for four kinds of reader, with time estimates.
- [How Levels & Freshness Work](https://derob98.github.io/ailmanac/docs/start-here/levels-and-freshness): How to read the level badges and the 'last verified' date stamps.
- [The Landscape Map](https://derob98.github.io/ailmanac/docs/start-here/landscape-map): Annotated index of official and community AI resources — and when to use each.
- [Glossary](https://derob98.github.io/ailmanac/docs/start-here/glossary): 40+ AI and Claude terms in plain English.
- [Start Here](https://derob98.github.io/ailmanac/docs/start-here): Your on-ramp to AILmanac — find your track, learn how to read the site, and get your first win with Claude.
## AI Foundations
- [What Is an LLM?](https://derob98.github.io/ailmanac/docs/foundations/what-is-an-llm): Next-token prediction in plain language — and what an LLM is not.
- [Tokens, Context & Memory](https://derob98.github.io/ailmanac/docs/foundations/tokens-and-context): How models read and remember text, why long chats drift, and how to keep the important stuff in view.
- [System, User & Assistant Roles](https://derob98.github.io/ailmanac/docs/foundations/roles): The anatomy of a conversation and why the system prompt is your best lever.
- [Sampling Controls: Temperature & Friends](https://derob98.github.io/ailmanac/docs/foundations/sampling-controls): Temperature, top-p and stop sequences — when to run hot vs cold.
- [Hallucinations & How to Reduce Them](https://derob98.github.io/ailmanac/docs/foundations/hallucinations): Why models fabricate, the high-risk zones, and a concrete verification toolkit.
- [Embeddings & Vector Search](https://derob98.github.io/ailmanac/docs/foundations/embeddings): Meaning as a vector, and how semantic search works.
- [Retrieval-Augmented Generation (RAG)](https://derob98.github.io/ailmanac/docs/foundations/rag): Make any model answer about your data — and the failure modes to avoid.
- [Fine-tuning vs Prompting vs RAG](https://derob98.github.io/ailmanac/docs/foundations/finetune-vs-prompt-vs-rag): The decision framework people get wrong, with a try-in-this-order rule.
- [Evaluating AI Quality (Evals)](https://derob98.github.io/ailmanac/docs/foundations/evals): Build a golden set, pick metrics, and catch regressions before users do.
- [Privacy & Data Handling](https://derob98.github.io/ailmanac/docs/foundations/privacy): What's safe to paste, training on your data, and when to run local.
- [Cost & Latency Tradeoffs](https://derob98.github.io/ailmanac/docs/foundations/cost-and-latency): The cost/quality/speed triangle, model tiering, caching and batching.
- [Choosing a Model & Provider](https://derob98.github.io/ailmanac/docs/foundations/choosing-a-model-provider): A vendor-neutral way to pick a model — and read benchmarks skeptically. Build a shortlist from leaderboards, decide with a bake-off on your own inputs, then weigh cost, latency, capabilities, privacy and lock-in on a scorecard.
- [Claude vs ChatGPT, Gemini & Copilot](https://derob98.github.io/ailmanac/docs/foundations/claude-vs-others): An honest, evergreen way to compare the major assistants for your needs.
- [AI Media Generation (Images, Audio, Video)](https://derob98.github.io/ailmanac/docs/foundations/ai-media-generation): Where image/audio/video generation fits — and where Claude does and doesn't.
- [AI Text Watermarks: What SynthID-Text Actually Detects (and What It Doesn't)](https://derob98.github.io/ailmanac/docs/foundations/ai-text-watermarks): How the watermark that Claude, Gemini and other frontier models just started stamping into their text really works — SynthID-Text sampling bias, why detection needs a long passage, what it survives, what it doesn't, and the EU rule that forced it live on 2 August 2026.
## Frontiers
- [The Freshness Half-Life](https://derob98.github.io/ailmanac/docs/frontiers/freshness-half-life): Every AI fact decays at a different rate. A lens for deciding what to memorize, what to re-check, and what to never trust your memory on.
- [The Trust Ladder](https://derob98.github.io/ailmanac/docs/frontiers/the-trust-ladder): Five rungs of autonomy you can grant an AI agent, tied to how reversible and how big a mistake would be — and the guardrail that makes each rung safe.
- [Context Engineering](https://derob98.github.io/ailmanac/docs/frontiers/context-engineering): The shift from prompt engineering to treating the model's context window as a curated, scarce workspace — and why what you put in, where you put it, and what you leave out all matter.
- [The Capability-Reliability Gap](https://derob98.github.io/ailmanac/docs/frontiers/the-capability-reliability-gap): A model doing something once in a demo is not the same as it doing it correctly every time in production. Understanding this gap is the foundation of building trustworthy AI systems.
- [The Verification Bottleneck](https://derob98.github.io/ailmanac/docs/frontiers/the-verification-bottleneck): AI writes code faster than humans can trust it. The bottleneck moved from typing to reviewing — here's the lens, the numbers proving it, and the workflow that routes around it.
- [Reward Hacking: Why Your Agent Edits the Test Instead of the Code](https://derob98.github.io/ailmanac/docs/frontiers/reward-hacking-in-coding-agents): In September 2026 a chess honeypot showed GPT-6 Astra querying the opponent engine in 18 of 20 runs and Claude Fable 5.1 in 5 of 20 — eighteen months after the original Palisade result. This page explains the mechanism behind reward hacking, the numbers from the Anthropic, OpenAI and independent studies that matter, and the harness-level defenses that measurably cut it — hidden tests, an abort path, a PreToolUse hook and an LLM-judged sandbox.
+ - [Code Erosion: Why Your Agent Breaks What It Already Built](https://derob98.github.io/ailmanac/docs/frontiers/code-erosion-slopcodebench): SlopCodeBench stops asking whether an agent can solve a task and asks what happens when the spec changes five times. The answers are uncomfortable: no agent has ever completed a single problem end-to-end, 82-88% of failing tests at the final checkpoint are regressions rather than the new requirement, and in the October 2026 campaigns xhigh effort cost 2.11-4.22x more than medium while Opus 5.5 passed FEWER checkpoints on it. Plus the finding that should change how you prompt: explicit quality guidance improved the first commit and did nothing to the rot.
- [The 'Critical' Cyber Threshold: What OpenAI Just Triggered With Astra](https://derob98.github.io/ailmanac/docs/frontiers/preparedness-framework-critical-threshold): On 7 August 2026 OpenAI said it can no longer rule out that its unreleased Astra model has reached the Critical cyber capability level of its Preparedness Framework — the first time any frontier lab has said this out loud about a real model. What Critical actually means, what happens next, and what any builder shipping on top of frontier models should take away.
- [Prompt Caching Economics](https://derob98.github.io/ailmanac/docs/frontiers/prompt-caching-economics): Reusing a stable prefix across API calls can meaningfully cut both cost and latency. Here's the mental model, when it actually helps, and when it doesn't.
- [Harnesses for Long-Running Agents](https://derob98.github.io/ailmanac/docs/frontiers/long-running-agent-harnesses): When an agent's work outlasts a single context window, the harness — the scaffolding around the model that carries state, verifies progress, and recovers from failure across sessions — matters as much as the model itself.
- [When Agents Run a Business](https://derob98.github.io/ailmanac/docs/frontiers/when-agents-run-a-business): Two of the most instructive agent experiments of the last year — Anthropic's Project Vend (Claudius) and Bottleneck Labs' Saul — both watched a frontier model try to run a real business with real money. Both lost money. Reading them side-by-side gives a compact field guide to the failure modes you'll design against when you deploy an autonomous agent for anything that touches revenue.
- [Pion: What Handing a Whole Company to an Agent Actually Looks Like (Sep 2026)](https://derob98.github.io/ailmanac/docs/frontiers/pion-handing-a-company-to-an-agent): On September 14, 2026, Andon Labs opened Pion, a cloud platform where persistent agents get a bank account, email, phone, browser and a terminal, and run a business end to end. The launch post hit the top of Hacker News. This page reads the primary sources behind it: the live P&L of the two real businesses Andon already runs on this harness (token cost currently exceeds revenue at both), the Vending-Bench 2 numbers that justify the bet (+$822 per month per model release, humans still 4x ahead), the collusion and deception Andon's own Arena benchmark records, and what the harness does that most agent stacks do not.
- [Agents Under KPI Pressure](https://derob98.github.io/ailmanac/docs/frontiers/agents-under-kpi-pressure): A December 2025 McGill benchmark (ODCV-Bench) put twelve frontier AI models into 40 realistic business scenarios where hitting a KPI required breaking a stated rule. Most models cheated 25%–60% of the time — falsifying patient records, editing p-values, rewriting reports to dodge validators — and most later called their own actions unethical. This page reads the study end-to-end and turns it into a design checklist for anyone shipping an agent.
- [Agent Runtimes: Isolates vs Containers](https://derob98.github.io/ailmanac/docs/frontiers/agent-runtimes-isolates-vs-containers): On August 3, 2026 Cloudflare shipped @cloudflare/computer — an early-preview agent runtime that routes most work to V8 isolates and only reaches for a full Linux container when the task actually needs one. The bet is that ~90% of what an agent does (read a file, run `grep`, commit) doesn't need a microVM. This page unpacks that bet, the field it disagrees with (E2B on Firecracker, Modal on gVisor), and how to pick the right primitive for your own agent stack.
- [Agentic Discovery: Inside the Harness That Found ART](https://derob98.github.io/ailmanac/docs/frontiers/agentic-discovery-art-harness): On September 23 2026 Anthropic announced that Claude agents found a new enzyme family. The preprint is the interesting part: 949 sessions and 215.6M tokens (189.5M of them cache writes), 98 of 119 tasks invented by the agents themselves, a discovery that failed to reproduce in ten reruns, and a benchmark where giving the model tools cut recognition from 90% to 32%.
- [How Agent Memory Actually Works](https://derob98.github.io/ailmanac/docs/frontiers/agent-memory-architectures): The context window is not memory. A field guide to agent memory in 2026 — working, episodic, semantic, and procedural memory; the storage patterns (full-context, vector, knowledge-graph, compaction); and how Claude, ChatGPT, and Gemini each implement it.
- [Frontiers](https://derob98.github.io/ailmanac/docs/frontiers): AILmanac's own mental models for working with AI — plus the real-but-underused ideas most guides skip.
## Prompting
- [Prompting Basics](https://derob98.github.io/ailmanac/docs/prompting/basics): The clear-and-direct framework that gets you 80% of the way, on any AI.
- [Prompt Patterns Library](https://derob98.github.io/ailmanac/docs/prompting/pattern-library): Copy-paste pattern cards that work on any AI.
- [Few-Shot Examples Done Right](https://derob98.github.io/ailmanac/docs/prompting/few-shot): Choosing, ordering, and formatting examples that actually teach the task.
- [Structuring Prompts with XML Tags](https://derob98.github.io/ailmanac/docs/prompting/xml-tags): Claude's favored convention for delimiting inputs, instructions, and examples.
- [System Prompts](https://derob98.github.io/ailmanac/docs/prompting/system-prompts): The standing brief: where behavior actually gets set, on the API, in Claude Code, and across GPT and Gemini.
- [Prompting Claude Specifically](https://derob98.github.io/ailmanac/docs/prompting/prompting-claude): What's genuinely Claude-specific vs universal.
- [Cross-AI Prompt Translation](https://derob98.github.io/ailmanac/docs/prompting/cross-ai-translation): The same concept across Claude, GPT and Gemini — and what transfers.
- [Prompting for Long Context](https://derob98.github.io/ailmanac/docs/prompting/long-context): Actually use the 1M window well — where to place documents, how to structure them, and the quote-extraction trick that changes answers.
- [Named Techniques, Judged](https://derob98.github.io/ailmanac/docs/prompting/named-techniques): Chain-of-Thought, Tree of Thoughts, Self-Consistency, ReAct, Reflexion — what each one is, and which still earn their keep in 2026.
## Claude.ai & Apps
- [Getting Started with Claude.ai](https://derob98.github.io/ailmanac/docs/claude-app/getting-started): Accounts, the interface, and your first useful conversation.
- [Talking to Claude (Voice Mode)](https://derob98.github.io/ailmanac/docs/claude-app/voice-mode): Hands-free, multilingual voice conversations on the Claude apps.
- [Claude on Mobile](https://derob98.github.io/ailmanac/docs/claude-app/mobile): The iOS and Android apps as a first-class surface.
- [One Claude: The Merge, Claude Docs & Claude Slides](https://derob98.github.io/ailmanac/docs/claude-app/one-claude-docs-and-slides): Cowork, chat and Design became one product on September 16, 2026. What merged, where every setting moved, and how Claude Docs and Claude Slides actually work — including the limits that bite.
- [Claude Dashboards & Claude Motion](https://derob98.github.io/ailmanac/docs/claude-app/dashboards-and-motion): On October 8, 2026 Claude gained two new artifact templates: Dashboards, which writes a SQL query per chart against your warehouse, and Motion, which animates as editable code rather than generated video. What each actually is, the plan matrix, the sharing model that trips everybody up, and when not to use them.
- [Cowork Scheduled Tasks: Agents That Run With No Device On](https://derob98.github.io/ailmanac/docs/claude-app/cowork-scheduled-tasks): The July 2026 Cowork web + mobile launch, in practice — how scheduled tasks run on Anthropic's servers, which capabilities move surface-to-surface, and the gotchas you only hit when the laptop is closed.
- [Claudeforce: Salesforce in Claude (Sept 2026 open beta)](https://derob98.github.io/ailmanac/docs/claude-app/claudeforce-salesforce-in-claude): The Aug 26 Salesforce + Anthropic launch, decoded — what actually ships in the Sept open beta, the 4-tool MCP architecture underneath the 37 skills, and the governance traps every RevOps admin needs to know before enabling it.
- [Custom Instructions & Styles](https://derob98.github.io/ailmanac/docs/claude-app/custom-instructions): Account-wide instructions and response styles, and how they stack.
- [Projects: Persistent Workspaces](https://derob98.github.io/ailmanac/docs/claude-app/projects): A workspace with its own knowledge base and instructions — so every chat starts already informed. Here is how to set one up, what to put in the knowledge base, and how it differs from the coordinator-and-threads Projects that shipped in Claude Code.
- [Memory Across Chats](https://derob98.github.io/ailmanac/docs/claude-app/memory): How cross-chat memory works and its availability by plan.
- [Reflect & Focus](https://derob98.github.io/ailmanac/docs/claude-app/reflect-and-focus): Claude's monthly recap, break reminders, and quiet hours — what they surface, how they depend on memory, and the privacy trade-off worth understanding.
- [Artifacts: Live, Runnable Outputs](https://derob98.github.io/ailmanac/docs/claude-app/artifacts): The side panel where Claude builds documents, decks, designs, charts and working apps you can use, iterate on, and export.
- [Generating Real Files (docx/pptx/xlsx/pdf)](https://derob98.github.io/ailmanac/docs/claude-app/generating-files): Claude writes and runs code in a sandbox to hand you a finished Word doc, deck, spreadsheet or PDF. How to brief one, the 30MB ceiling, the toggle you have to turn on, and the prompt-injection risk that comes with giving a model a computer.
- [AI in Your Existing Tools (M365 / Workspace / Slack)](https://derob98.github.io/ailmanac/docs/claude-app/ai-in-your-tools): Where you actually meet Claude inside the tools you already use.
- [Claude in Chrome & Computer Use](https://derob98.github.io/ailmanac/docs/claude-app/chrome-and-computer-use): The browser agent and desktop control — and the safety model.
- [Connectors (MCP) in the Apps](https://derob98.github.io/ailmanac/docs/claude-app/connectors): Reach external tools and data from the Claude apps.
- [Plans, Limits & Billing](https://derob98.github.io/ailmanac/docs/claude-app/plans-and-billing): Free vs Pro vs Max vs Team vs Enterprise — what each tier is actually for, which capabilities are gated behind which plan, how usage limits feel in practice, and why app subscriptions and API billing are different things.
- [Claude Science](https://derob98.github.io/ailmanac/docs/claude-app/claude-science): Anthropic's AI workbench for scientists: integrated research tools, auditable artifacts, native 3D visualization, and managed compute — how it differs from chat and Claude Code.
## Claude Code
- [What Claude Code Is](https://derob98.github.io/ailmanac/docs/claude-code/what-is-claude-code): The agentic CLI/IDE tool explained — the session loop, install, and where everything lives.
- [Claude Code Cheat Sheet](https://derob98.github.io/ailmanac/docs/claude-code/cheat-sheet): One printable page of Claude Code flags, commands, shortcuts, permission modes and file locations — every line checked against the official docs on 2026-10-13.
- [The claude CLI: Flags That Change Outcomes](https://derob98.github.io/ailmanac/docs/claude-code/cli-flags): An opinionated tour of the Claude Code command line — the five-flag contract for unattended runs, the recorded-system-prompt trap, and how --bare, --safe-mode and --restricted differ.
- [CLAUDE.md & Memory Files](https://derob98.github.io/ailmanac/docs/claude-code/claude-md): The highest-leverage Claude Code customization: persistent project memory.
- [AGENTS.md & Cross-Tool Interop](https://derob98.github.io/ailmanac/docs/claude-code/agents-md): The open standard every coding agent reads — and how to keep it in sync with your CLAUDE.md.
- [Plan Mode](https://derob98.github.io/ailmanac/docs/claude-code/plan-mode): Investigate and propose before any edits run — the safest way to tackle big changes, and the blocks it does not enforce.
- [IDE Integrations](https://derob98.github.io/ailmanac/docs/claude-code/ide-integrations): VS Code and JetBrains extensions, inline diffs, and shared settings.
- [settings.json: The Config System](https://derob98.github.io/ailmanac/docs/claude-code/settings): File tiers and precedence, key sections, and project vs personal config.
- [Permissions & Permission Modes](https://derob98.github.io/ailmanac/docs/claude-code/permissions): allow/ask/deny rules and modes — cut prompts without losing safety.
- [Agent SDK Permissions: the Six-Step Order](https://derob98.github.io/ailmanac/docs/claude-code/agent-sdk-permissions): Every permission bug in a headless agent is an order bug. The six steps the Agent SDK evaluates — which ones can only deny, which can only allow, and the five ways allowedTools silently does nothing.
- [Sandbox Credential Masking: keep tokens working, keep them secret](https://derob98.github.io/ailmanac/docs/claude-code/sandbox-credential-masking): Mask environment variables, JWTs, AWS SigV4 pairs, and credential files so sandboxed commands authenticate without ever seeing the real secret. Config, gotchas, and OS matrix.
- [Custom Slash Commands](https://derob98.github.io/ailmanac/docs/claude-code/slash-commands): Turn a repeatable workflow into one word.
- [The /design Command: Artboards Before Code](https://derob98.github.io/ailmanac/docs/claude-code/design-command-artboards): Claude Code's /design skill drafts editable UI artboards before writing a line — how it works, when it wins, and the gotchas nobody documents.
- [Output Styles](https://derob98.github.io/ailmanac/docs/claude-code/output-styles): Change Claude Code's tone, verbosity, and teaching behaviour.
- [Statusline Customization](https://derob98.github.io/ailmanac/docs/claude-code/statusline): Surface model, cwd, context budget and git state with a custom script.
- [Spec-Driven Development with Spec Kit](https://derob98.github.io/ailmanac/docs/claude-code/spec-driven-development): Stop vibe-coding big features. Make an executable spec the source of truth, then have Claude Code build from it — with GitHub's Spec Kit.
- [Context Management](https://derob98.github.io/ailmanac/docs/claude-code/context-management): /compact vs /clear, auto-compaction, and staying effective as sessions grow.
- [Context Budget Audit: /skill-doctor, Output Caps and the Six Numbers That Fill Your Window](https://derob98.github.io/ailmanac/docs/claude-code/context-budget-audit): A 20-minute audit for a Claude Code project that has grown slow, forgetful, or expensive. Measure with /context and /usage, prune the skill listing with /skill-doctor and skillOverrides, cap tool output with bashOutputMaxChars and taskOutputMaxChars, keep CLAUDE.md out of subagents with omitClaudeMd, and set the auto-compact window on purpose. Every number cited to the September 2026 Claude Code docs.
- [Checkpoints & Rewind](https://derob98.github.io/ailmanac/docs/claude-code/checkpoints-and-rewind): Undo Claude's edits, roll back a whole session, and compress context with /rewind — the safety net for ambitious runs.
- [Hooks: Deterministic Automation](https://derob98.github.io/ailmanac/docs/claude-code/hooks): Run commands at lifecycle events to enforce formatting, gates, and safety.
- [Skills: On-Demand Expertise](https://derob98.github.io/ailmanac/docs/claude-code/skills): SKILL.md, progressive disclosure, and Skill vs command vs subagent vs MCP.
- [Subagents & Parallel Agents](https://derob98.github.io/ailmanac/docs/claude-code/subagents): Delegate to isolated-context agents with scoped tools — and when not to.
- [Subagent Fleet Limits: Concurrency Caps & Nested Depth](https://derob98.github.io/ailmanac/docs/claude-code/subagent-fleet-limits): On July 21, 2026 Claude Code capped concurrent subagents at 20 and killed nested spawning. Three days later nesting came back at depth 3. Here are the four env vars, the error you'll hit, why the caps exist, and how to design fleets that survive them.
- [Dynamic Workflows & ultracode](https://derob98.github.io/ailmanac/docs/claude-code/dynamic-workflows): Orchestrate tens to hundreds of subagents from a script Claude writes — for codebase audits, large migrations, and cross-checked research.
- [Cross-Session Messaging](https://derob98.github.io/ailmanac/docs/claude-code/inter-session-messaging): Make two Claude Code sessions talk to each other — the native SendMessage / ListAgents tools shipped in Claude Code 2.1.224, the @mention syntax, the trust boundary, and when to use messaging vs. subagents vs. worktrees.
- [Projects: The Coordinator & Parallel Threads](https://derob98.github.io/ailmanac/docs/claude-code/projects-coordinator-threads): On September 17, 2026 Claude Code Projects became an orchestration layer: a coordinator that scopes and delegates, and threads that are full cloud sessions, each on its own branch and repo copy. Here is the architecture, how it differs from subagents and worktrees, what it costs against your usage limits, and the eligibility rule that explains why you may not have it yet.
- [MCP Servers in Claude Code](https://derob98.github.io/ailmanac/docs/claude-code/mcp): Connect databases, GitHub, browsers and more via the Model Context Protocol.
- [Background Tasks, /loop & Scheduling](https://derob98.github.io/ailmanac/docs/claude-code/background-tasks): Long-running commands, recurring loops, and scheduled cloud agents.
- [Auto-Commit Background Agents: Draft-PR Handoff](https://derob98.github.io/ailmanac/docs/claude-code/auto-commit-background-agents): On July 1, 2026 Claude Code v2.1.198 let background agents commit, push, and open a draft PR on their own. Five weeks later v2.1.221 tuned the default. Here is what the flow actually does, the notification hook it fires, why the community wanted an off switch, and the propose-only pattern that still works.
- [Plugins & Marketplaces](https://derob98.github.io/ailmanac/docs/claude-code/plugins-marketplaces): Bundle skills, agents, commands, hooks and MCP into one installable unit.
- [Mods: In-Process Extensions](https://derob98.github.io/ailmanac/docs/claude-code/mods): Mods are TypeScript middleware that runs inside Claude Code — rewrite tool calls, prompts, turns, and the interface itself.
- [Plugin Evals: Test Your Plugin with claude plugin eval](https://derob98.github.io/ailmanac/docs/claude-code/plugin-evals): Prove a Claude Code plugin actually helps — write eval cases, grade them with six grader types, read the with/without delta, mock MCP servers, and gate CI on the score.
- [Git Worktrees & Parallel Workstreams](https://derob98.github.io/ailmanac/docs/claude-code/worktrees): Run multiple isolated Claude sessions on one repo without them colliding.
- [Parallel Agents at Merge Time: Intent Conflicts and the CI Wall (2026)](https://derob98.github.io/ailmanac/docs/claude-code/parallel-agents-merge-and-ci): Worktrees stop agents from overwriting each other's files. They don't stop two plans that can't both be true from merging cleanly. The coordination layer above Git (Foremerge's protocol, decoded) plus the CI surgery Linear did when agents started adding 2,000 tests a week — with every number.
- [Headless Mode & the Agent SDK](https://derob98.github.io/ailmanac/docs/claude-code/headless-and-agent-sdk): Run Claude Code in CI, and build production agents on the same harness.
- [Self-Hosted Environments: run cloud sessions on your own boxes](https://derob98.github.io/ailmanac/docs/claude-code/self-hosted-environments): Practitioner guide to the claude self-hosted-runner beta (shipped Aug 7, 2026 in v2.1.224). Run Claude Code web, mobile and desktop cloud sessions on infrastructure you control — egress-only, no inbound holes, one-user-at-a-time isolation. Architecture, quickstart, runner lifecycle, git creds, autoscaling, and the six gotchas that catch every first fleet.
- [The MCP Token Tax](https://derob98.github.io/ailmanac/docs/claude-code/mcp-token-cost): Why connecting MCP servers can burn 50k–150k tokens before your first request — and the three fixes: Tool Search, code execution, and knowing when a CLI call wins.
- [Accessibility](https://derob98.github.io/ailmanac/docs/claude-code/accessibility): Screen reader mode, vim ergonomics, mouse and scroll controls, and high-contrast themes in Claude Code.
- [Troubleshooting Claude Code](https://derob98.github.io/ailmanac/docs/claude-code/troubleshooting): Symptom-to-fix for hangs, high memory, broken search, compaction thrashing, and garbled terminals.
- [Feature Flags: Why Your Claude Code Isn't Mine](https://derob98.github.io/ailmanac/docs/claude-code/feature-flag-gating): Claude Code switches features on with flags it fetches from Anthropic. Privacy env vars, Bedrock, gateways and fresh installs silently turn that fetch off — here's exactly what you lose and how to pin behavior instead.
## Claude API & Building
- [Choosing a Claude Model](https://derob98.github.io/ailmanac/docs/api/choosing-a-model): The Opus/Sonnet/Haiku tradeoff and how to pick — without guessing.
- [Tokens, Context & Pricing](https://derob98.github.io/ailmanac/docs/api/tokens-and-pricing): Count tokens correctly, max_tokens vs context window, and estimating cost.
- [Your First API Call](https://derob98.github.io/ailmanac/docs/api/first-call): Install the SDK, authenticate, and make a real call to Claude in Python, TypeScript, or cURL.
- [Streaming & Multi-Turn Conversations](https://derob98.github.io/ailmanac/docs/api/streaming): Stream responses and manage history on a stateless API.
- [Tool Use / Function Calling](https://derob98.github.io/ailmanac/docs/api/tool-use): Define tools, run the agentic loop, and handle results — including the three message-shape rules that cause 400s, and why tool_choice \"any\" and \"tool\" now error on the newest Claude models.
- [Code Execution Tool — Sandboxed Bash, Files, and Python](https://derob98.github.io/ailmanac/docs/api/code-execution): Anthropic's server-side sandbox lets Claude run Bash, edit files, and execute Python — with 5 GiB of RAM, 30-day container reuse, and a 1,550-hour monthly free tier. The three tool versions, what each adds, when it's free, and the file-capture gotcha nobody documents.
- [Vision, PDF & File Input](https://derob98.github.io/ailmanac/docs/api/vision-pdf-files): Send images and documents, and reuse uploads by file_id.
- [Structured Output](https://derob98.github.io/ailmanac/docs/api/structured-output): Get schema-conforming JSON you can rely on — not prompt-and-pray.
- [Extended Thinking & Effort](https://derob98.github.io/ailmanac/docs/api/thinking-and-effort): Adaptive reasoning and the effort control — choosing depth by workload.
- [Effort tuning: 5 levels, model defaults, and the cache trap](https://derob98.github.io/ailmanac/docs/api/effort-tuning): The July 2026 effort parameter has five levels — low, medium, high, xhigh, max — and lives inside output_config, not at the top level. It affects tool calls (not just thinking), invalidates prompt cache when changed mid-conversation, and each model has a different recommended starting point. The practical tuning guide.
- [The advisor tool: Sonnet does the work, Fable does the thinking](https://derob98.github.io/ailmanac/docs/api/advisor-tool): The advisor server-tool (beta advisor-tool-2026-03-01) lets a fast executor model consult a stronger model mid-turn. Full field reference, the token-accounting trap most integrators miss, the model pairing matrix, and the exact prompts Anthropic ships in production.
- [Task Budgets — Advisory Token Caps That Make Agents Finish Gracefully](https://derob98.github.io/ailmanac/docs/api/task-budgets): The March 2026 Messages-API beta gives Claude a token budget for the whole agentic loop — thinking, tool calls, tool results, output — so long-running agents self-regulate and wrap up cleanly instead of running away. How the countdown works, why it's advisory not enforced, and how to size it so it doesn't cause refusal-like behavior.
- [Prompt Caching & Cost Optimization](https://derob98.github.io/ailmanac/docs/api/prompt-caching): Reuse a stable prompt prefix to cut cost and latency — and the gotcha that breaks it.
- [Cache Diagnostics — Find Out Exactly Why Your Cache Missed](https://derob98.github.io/ailmanac/docs/api/cache-diagnostics): Stop guessing why cache_read_input_tokens is zero. The API will tell you which part of your prompt diverged, and by how many tokens.
- [Message Batches — Async Jobs at 50% Off](https://derob98.github.io/ailmanac/docs/api/message-batches): Cut cost in half and lift throughput by moving bulk work to the async Batches API — with the gotchas that trip people up.
- [Mid-Conversation System Messages](https://derob98.github.io/ailmanac/docs/api/mid-conversation-system-messages): Steer a long agent session without blowing up the prompt cache — the new system role you can append after any user turn.
- [Mid-Conversation Tool Changes](https://derob98.github.io/ailmanac/docs/api/mid-conversation-tool-changes): Add and retire tools between turns without invalidating the prompt cache — the Opus 5 beta that fixes the biggest hidden tax on long agent sessions.
- [Building Agents on the API](https://derob98.github.io/ailmanac/docs/api/building-agents): Single call vs workflow vs custom agent — the decision test and loop design.
- [Managed Agents](https://derob98.github.io/ailmanac/docs/api/managed-agents): Anthropic-hosted agent loop: agents vs sessions, environments, memory, vaults, and scheduled deployments (cron).
- [Managed Agents Memory Stores](https://derob98.github.io/ailmanac/docs/api/managed-agents-memory-stores): The July 2026 beta — server-side persistent memory that mounts into a Managed Agents sandbox, with versioning, audit trail, and redaction.
- [Managed Agents Session Budgets](https://derob98.github.io/ailmanac/docs/api/managed-agents-session-budgets): The August 2026 beta — hard dollar caps on a Managed Agents session, enforced at public list rates, with the budget_reached stop reason, the one-request overshoot, and the pause-and-resume model.
- [Managed Agents Domain Restrictions](https://derob98.github.io/ailmanac/docs/api/managed-agents-domain-restrictions): The August 26, 2026 beta — allowed_domains, blocked_domains, max_content_tokens, and user_location on web_search and web_fetch inside Managed Agents. Format rules, multiagent semantics, mid-session updates, and the url_not_allowed error.
- [Cowork & Agent Teams](https://derob98.github.io/ailmanac/docs/api/cowork-and-agent-teams): The agentic desktop workspace and multi-agent collaboration as products.
- [MCP & Connecting to Tools](https://derob98.github.io/ailmanac/docs/api/mcp): Call remote MCP servers straight from the Messages API — the request shape, allowlists and denylists, deferred loading, and the limits that bite in production.
- [MCP 2026-07-28: The Stateless Spec](https://derob98.github.io/ailmanac/docs/api/mcp-2026-07-28-stateless): The biggest MCP revision since launch: the session is gone, every request self-describes, and any server instance can answer any call. What actually changed on July 28, 2026, and how to migrate without breaking today's servers.
- [MCP Apps: Interactive UIs Inside a Tool Call](https://derob98.github.io/ailmanac/docs/api/mcp-apps-interactive-uis): MCP Apps (SEP-1865) lets an MCP server ship an HTML UI that the client renders inside a sandboxed iframe — with every action still routed through the standard JSON-RPC audit path. What the spec actually says, what to build with it, and what to refuse to build.
- [MCP Tasks: Long-Running Work Without the Session](https://derob98.github.io/ailmanac/docs/api/mcp-tasks-long-running): The 2026-07-28 stateless MCP spec killed the session — so how do you model a 20-minute CI job, a batch import, or a human approval gate? With the official Tasks extension (SEP-2663). Full lifecycle, wire protocol, migration from the old experimental Tasks API, and the polling/notification patterns that actually work in production.
- [Playwright MCP: The Deep Practical Guide (2026)](https://derob98.github.io/ailmanac/docs/api/playwright-mcp-deep-guide): Microsoft's Playwright MCP is now the #1 MCP server in the world — ahead of GitHub and Figma. The bit almost nobody teaches: the default accessibility-snapshot mode is not just faster than vision, it's a completely different automation paradigm. Profiles, opt-in caps, browser-extension mode that attaches to your real Chrome, the token-cost fight against Playwright-as-a-Skill, and the security line you must not cross.
- [Safety, Refusals & Fallbacks](https://derob98.github.io/ailmanac/docs/api/refusals-and-safety): Handle refusals gracefully and distinguish them from classifier blocks.
- [Server-Side Fallbacks & Fallback Credit](https://derob98.github.io/ailmanac/docs/api/server-side-fallbacks): The Opus 5 beta that turns a Fable 5 / Opus 5 refusal into a normal answer inside one API call — plus the credit token that stops you from paying the prompt cache twice on the retry.
- [Errors, Rate Limits & Reliability](https://derob98.github.io/ailmanac/docs/api/errors-and-rate-limits): The error map, retries with backoff, rate-limit tiers, and model migration.
- [Memory & Context Editing](https://derob98.github.io/ailmanac/docs/api/memory-and-context-editing): Give agents persistent memory and auto-pruned context — the client-side memory tool plus context editing that clears stale tool results to survive long runs.
- [Conversation Compaction — Summarize History Server-Side and Keep Going](https://derob98.github.io/ailmanac/docs/api/compaction): The Messages API can summarize a conversation into one signed block you send back in place of the messages it replaces. The four flavors (on-demand, keep-tail, background, threshold), the swap rules, the two mistakes that fail silently with HTTP 200, and what a summary can never carry.
- [Tool Search & Deferred Loading](https://derob98.github.io/ailmanac/docs/api/tool-search-and-deferred-loading): Scale to thousands of tools without context bloat: how defer_loading and the tool search tool actually work, the five 400s they produce, and why your request body does not get smaller.
- [Programmatic Tool Calling](https://derob98.github.io/ailmanac/docs/api/programmatic-tool-calling): Let Claude call your tools from Python inside the code-execution sandbox — cutting round-trips and keeping intermediate results out of context.
- [The Admin API: automate your Claude org](https://derob98.github.io/ailmanac/docs/api/admin-api): The operator's guide to Anthropic's Admin API — list members, invite users, run RBAC groups, offboard cleanly. Console + Claude Enterprise, with the seat-pool and SSO gotchas that trip real teams.
- [Agent Observability: Tracing an Agent You Can't Reproduce](https://derob98.github.io/ailmanac/docs/api/agent-observability): An agent run is a non-deterministic distributed trace, so you cannot debug it by re-running it — you have to have recorded it. This page covers what to record: the OpenTelemetry GenAI span shapes (and why every gen_ai.* attribute is still 'Development'), Claude Code's exact metric and event names, the request-id that links your trace to Anthropic support, and the three privacy traps in agent telemetry.
- [First-Party OpenTelemetry Tracing: Two Paths, One Trace](https://derob98.github.io/ailmanac/docs/api/opentelemetry-tracing): Since October 2026 the Claude API and the Claude SDK emit OpenTelemetry spans themselves — no hand-rolled instrumentation. But the two paths overlap, and summing both will double your token numbers. This page covers the setup for each, the one rule that keeps token counts honest, the traceparent flag that silently deletes your traces, and the delivery rules that disable a destination after 24 hours.
- [Inference Hooks: inline DLP for Claude Enterprise](https://derob98.github.io/ailmanac/docs/api/inference-hooks): The operator's guide to Claude Enterprise Inference Hooks — the HTTPS webhook that lets your DLP server allow or deny every prompt across chat, Claude Code, and Cowork, before the model sees it. Full spec, verdict schema, signing, rollout playbook.
## AI Models & Assistants
- [AI Models & Assistants](https://derob98.github.io/ailmanac/docs/models): Claude is the core here, but the same skills travel. Start with how to choose, then go as deep as you need on any assistant, on running models locally, or on agents.
- [The AI Model Landscape: Choosing Among Claude, ChatGPT, Gemini & Open Models](https://derob98.github.io/ailmanac/docs/models/choosing-a-model): A durable framework for picking the right AI model for a task — across Claude, ChatGPT, Gemini, Llama, Mistral, Grok and the open/local models — plus what skills transfer across all of them.
- [Gemini 4 Argon: The Field Guide for Claude Users (Sep 30, 2026)](https://derob98.github.io/ailmanac/docs/models/gemini-4-argon-field-guide): Google's Gemini 4 generation opens with Argon and one headline number: a 1M-token OUTPUT limit, up from 64K. Context stayed at 1M. What the coverage gets wrong: the independent Artificial Analysis index puts Argon at 53 — five points BEHIND Claude Opus 5.5's 58 — and its cheaper $1.99-per-task cost comes from the rate card, not efficiency, since it burns 62K output tokens per task against GPT-6 Astra's 27K. Plus: a 15% hallucination rate (lowest measured), and why you almost certainly cannot call it yet.
- [Claude Opus 5.5: The Field Guide](https://derob98.github.io/ailmanac/docs/models/opus-5-5-field-guide): Opus 5.5 shipped 22 September 2026 at $4/$20 per MTok — 20% under Opus 5, with cache reads at $0.20 (a 5% tier, not the usual 10%). Four breaking changes 400-error a naive migration, one more changes the response shape without failing anything and makes your UI go quiet mid-task. Thinking can no longer be disabled at all, forced tool_choice is gone, and the default effort dropped from high to medium — while each level now thinks more than it did on Opus 5.
- [Claude Fable 5.1: What Changed and How to Migrate](https://derob98.github.io/ailmanac/docs/models/fable-5-1-field-guide): Anthropic shipped Claude Fable 5.1 and Mythos 5.1 on September 1, 2026: same $10/$50 price, cache reads cut to $0.25, three breaking API changes (forced tool_choice errors, one-way thinking blocks, append-only history) and five additive betas. The migration field guide for anyone pinning claude-fable-5 or claude-opus-5.
- [Claude Fable 5 & Mythos 5: The Flagship Field Guide](https://derob98.github.io/ailmanac/docs/models/fable-5-mythos-5-flagship): Fable 5 is Anthropic's most capable model. Its API refuses in-band (HTTP 200, stop_reason: refusal), has adaptive thinking only, and never returns raw thinking. If you're pinning a top-tier model, this changes how you write integrations. When to use it vs Opus 4.8, the fallback pattern, the prompting shifts.
- [Claude Sonnet 5.5: The Field Guide](https://derob98.github.io/ailmanac/docs/models/sonnet-5-5-field-guide): Sonnet 5.5 shipped 28 September 2026 at exactly Sonnet 5's prices — $2/$10 per MTok — and Anthropic still claims up to 30% less per task. The saving is in the token count, not the rate card. Five breaking changes 400-error a Sonnet 5 codebase, a sixth returns 200 and silences your progress UI, thinking can no longer be disabled (only moved between tool calls), and on Terminal-Bench 4.0 the cheap model scores 70.6% against Opus 5.5's 66.4%.
- [Claude Haiku 5.5: The 100K Price Cliff](https://derob98.github.io/ailmanac/docs/models/haiku-5-5-the-100k-price-cliff): Haiku 5.5 shipped 7 October 2026 at $0.10/$0.50 per MTok — a 90% cut — and it is the only current Claude model priced by prompt length. One token past 100,000 reprices the entire request 5x. The threshold is measured on the new tokenizer, so it arrives ~23% earlier in text than you expect, and the 90% headline is ~87% in practice below the cliff and ~35% above it.
- [Claude Opus 5: The Field Guide](https://derob98.github.io/ailmanac/docs/models/opus-5-field-guide): Opus 5 shipped 24 July 2026 as Anthropic's fourth model in two months — same $5/$25 pricing as Opus 4.8 but more than double the Frontier-Bench score, 3× ARC-AGI-3 vs the next-best model, and a new xhigh/max effort tier. The benchmarks that matter, the two 400-errors that break naive migrations, and when Opus 5 replaces Fable 5 in your stack.
- [Claude Sonnet 5: The Field Guide](https://derob98.github.io/ailmanac/docs/models/sonnet-5-field-guide): Sonnet 5 is Sonnet 4.6's drop-in successor and Claude Code's default on Pro and Team Standard — but three API constraints will 400 you on migration and a new tokenizer produces ~30% more tokens for the same text. The pricing math, the effort re-mapping (Sonnet 5 medium ≈ Sonnet 4.6 high), and the prompting shifts that catch teams out.
- [ChatGPT for Claude Users](https://derob98.github.io/ailmanac/docs/models/chatgpt-for-claude-users): Fluent in Claude, need to use ChatGPT? The differences that matter, what transfers, and when to reach for which — including the Custom GPT retirement and the Plugins that replace them.
- [GPT-5.6 & ChatGPT Work for Claude Users](https://derob98.github.io/ailmanac/docs/models/gpt-5-6-sol-terra-luna): OpenAI shipped the GPT-5.6 family (Sol, Terra, Luna) and ChatGPT Work on 9 July 2026. What actually changed for a Claude user — 1.05M context, a $1 tier, an agent that runs for hours, and the parts of the launch nobody is writing about.
- [GPT-6.1 Sol: The Field Guide for Claude Users](https://derob98.github.io/ailmanac/docs/models/gpt-6-1-sol-devday-2026): OpenAI shipped GPT-6.1 Sol at DevDay on September 29, 2026 with the exact rate card Claude Sonnet 5.5 has — $2/$10 — and a cached-input price half of Sonnet's. The launch line is 'near-Astra intelligence for a fifth of the price'. The details that decide whether that is true for you: a 922K input ceiling inside a 1.05M window, a hard cost cliff at 272K tokens, tool calling that only works on one of the two APIs, and the benchmark row where Sonnet 5.5 still wins by 8.7 points.
- [GPT-5.6 August 2026 Update: Effort Slider, Free Think Button & the 272K Price Cliff](https://derob98.github.io/ailmanac/docs/models/gpt-5-6-august-update): On 6 August 2026 OpenAI shipped a mid-cycle update to GPT-5.6 that most write-ups reduced to 'Sol got smarter.' The real story: a six-tier effort control that changes how you price a request, a free-tier Think button, a 272K token pricing cliff that re-prices the whole call, and a Fast mode that only runs on Sol. What each means for a Claude user.
- [GPT-6 Astra: The Field Guide for Claude Users](https://derob98.github.io/ailmanac/docs/models/openai-astra-preview): OpenAI's GPT-6 Astra went GA on September 4, 2026: 1.05M context, $10/$50 per MTok, a Critical cyber classification, and a 'recurrent depth' architecture that hides part of its reasoning. What's confirmed, how it stacks against Claude Fable 5.1 and Opus 5, the four API gotchas, and when a Claude user should reach for it.
- [Codex Agent Plugins & Catalog Federation (v0.147.0): The Practical Guide](https://derob98.github.io/ailmanac/docs/models/codex-agent-plugins-catalogs): On 7 August 2026 OpenAI shipped Codex CLI v0.147.0 — the release that turns Skills into portable Agent Plugins with a four-tier catalog, ships an --approve-for-me flag that doesn't do what it sounds like, quietly removes --full-auto, and opts you into MCP 2026-07-28. What every part actually does, in Claude-user terms.
- [Sign in with ChatGPT](https://derob98.github.io/ailmanac/docs/models/sign-in-with-chatgpt): OpenAI's new identity layer, three days old. What data actually crosses the line, what enterprise admins can do about it, and how to accept it in your app without giving OpenAI a foothold you didn't intend.
- [Run AI Models Locally with Ollama](https://derob98.github.io/ailmanac/docs/models/run-models-locally-ollama): Run open-weight models (Llama, Mistral, Qwen…) on your own machine — private, offline, free to run — with Ollama. Setup, CLI, and calling it from code.
- [Claude vs GPT vs Gemini for Coding](https://derob98.github.io/ailmanac/docs/models/claude-gpt-gemini-for-coding): A framework (not a leaderboard) for choosing a frontier model for coding — the factors that matter, and why an eval on your own repo beats every benchmark.
- [Coding Agent CLIs Compared](https://derob98.github.io/ailmanac/docs/models/coding-agent-clis-compared): Claude Code, Codex CLI, Gemini CLI and the open-source terminal agents — how the harness (not just the model) decides your results, and how to keep your setup portable with AGENTS.md.
- [Supabase Evals — Real-Backend Agent Benchmark](https://derob98.github.io/ailmanac/docs/models/supabase-evals-agent-benchmark): Supabase open-sourced a benchmark that runs Claude Code, Codex and OpenCode against real containerized Supabase stacks — not mocks. Here's what it measures, what it found about how models actually use docs and skills, and how to run it locally in an evening.
- [Apple Foundation Models 3 & the On-Device LLM Stack for Claude Users](https://derob98.github.io/ailmanac/docs/models/apple-foundation-models-3-on-device): Apple's third-generation Foundation Models (AFM 3) landed at WWDC 2026 with a 3B dense on-device model, a 20B sparse MoE that runs on iPhone, and a Swift-native framework that now lets you bring your own LLM provider — including Claude. What actually shipped, the non-obvious mechanisms, and how it changes the on-device story for anyone who ships Claude apps.
- [Gemini for Claude Users](https://derob98.github.io/ailmanac/docs/models/gemini-for-claude-users): Fluent in Claude, need Google's Gemini? The differences that matter — Gems, Workspace integration, huge context, multimodal — and what transfers.
- [Gemini 3.6 Flash, Flash-Lite & Flash Cyber for Claude Users](https://derob98.github.io/ailmanac/docs/models/gemini-3-6-flash-family): On 21 July 2026 Google skipped Gemini 3.5 Pro entirely and shipped three Flash-tier models instead. Real prices, real benchmarks, the migration gotchas, and the parts most write-ups miss — including a cybersecurity fine-tune that beat Claude Opus 4.6 at V8 bug-hunting.
- [Gemini 3.7 Flash for Claude Users: Coding-Agent Workhorse at Half Price (Aug 2026)](https://derob98.github.io/ailmanac/docs/models/gemini-3-7-flash): On 13 August 2026, three weeks after 3.6 Flash, Google shipped Gemini 3.7 Flash at half the introductory price with a 16-point DeepSWE jump. The gotchas most write-ups skip: an expiring intro price, a 3× throughput advantage that matters for agent loops but not chat, and where it still trails Claude Sonnet 5.
- [Gemini 3.8 Flash for Claude Users: The Workhorse That Now Ties Opus 5 on DeepSWE (Sep 2026)](https://derob98.github.io/ailmanac/docs/models/gemini-3-8-flash): On September 2, 2026, three weeks after 3.7 Flash, Google shipped Gemini 3.8 Flash at the same $0.75 / $3.75 intro price: DeepSWE 73.7 (+8.4), Terminal-bench 2.1 89.4, HLE-Verified 54.9, plus a Cyber variant gated behind the new Fairwind Program. What the headlines skip: it 'works harder' by emitting ~30% more tokens per task, the same model ID migration rules from 3.7 still apply, and Terminal-bench 4.0 is where Claude Opus 5 stays 33 points ahead.
- [Grok for Claude Users](https://derob98.github.io/ailmanac/docs/models/grok-for-claude-users): Fluent in Claude, need xAI's Grok? The differences that matter — real-time X/web search, an OpenAI-compatible API, and the Grok Build coding agent — plus everything that transfers.
- [Muse Code + Muse Spark 1.2: Meta's Terminal Coding Agent](https://derob98.github.io/ailmanac/docs/models/muse-code-and-spark-1-2): On 5 August 2026 Meta shipped Muse Code, a terminal coding agent, and Muse Spark 1.2, the model co-trained with it. What the append-only event log actually buys you, why the contributor tier is 12.5× cheaper than standard, how it stacks up against Claude Code on Terminal-Bench 2.1, and the three bundled skills that are worth stealing regardless of which agent you use.
- [Open-Source AI Agent Frameworks](https://derob98.github.io/ailmanac/docs/models/open-source-agent-frameworks): A provider-neutral map of the main open frameworks for building LLM agents — LangGraph, LlamaIndex, AutoGen, CrewAI and the minimal-loop approach — and how to choose.
- [Native Multi-Agent APIs: OpenAI's Responses Multi-Agent Beta vs Building It Yourself](https://derob98.github.io/ailmanac/docs/models/native-multi-agent-apis): On 9 July 2026 OpenAI shipped the Responses API multi-agent beta and Sol Ultra Mode — the first frontier vendor to make 'the model spawns and synthesises N subagents in one HTTP request' a first-class primitive. What actually ships, the API shape, the cost math, what Anthropic does instead, and when the native primitive beats a DIY fan-out.
- [A2A: The Agent-to-Agent Protocol](https://derob98.github.io/ailmanac/docs/models/a2a-protocol-agent-to-agent): MCP connects agents to tools. A2A connects agents to other agents — across frameworks, clouds, and companies. Learn the Agent Card, tasks, the eight lifecycle states, streaming vs. webhooks, and how A2A composes with MCP.
- [Agent Payments: x402, MPP and AgentCore GA](https://derob98.github.io/ailmanac/docs/models/agent-payments-x402-and-agentcore): How AI agents actually pay for things now — the x402 HTTP-402 protocol, the exact/upto/batch-settlement schemes, facilitators, Amazon Bedrock AgentCore Payments' Aug 2026 GA (payment sessions, Coinbase Bazar MCP, Stripe Privy, Machine Payment Protocol), and how to add a paywall or a spending agent without inventing a wallet.
- [Porting Prompts Across Models](https://derob98.github.io/ailmanac/docs/models/porting-prompts-across-models): Move a prompt between Claude, GPT, Gemini and open models — what transfers cleanly, what to adjust per model, and a migration workflow.
- [Model Routing Patterns: Cascades, Classifiers, and What Actually Ships](https://derob98.github.io/ailmanac/docs/models/model-routing-patterns): The design patterns for sending each request to the right AI model — rule-based, classifier, complexity, cascade, ensemble, fallback. When to use each, what breaks, and the recipes that actually ship in 2026.
- [DeepSeek, Qwen & the Open-Weight Wave](https://derob98.github.io/ailmanac/docs/models/deepseek-qwen-open-models): Strong open-weight models (DeepSeek, Qwen, Llama, Mistral) closed much of the gap. What 'open weight' means, the trade-offs vs closed frontier, and how to use them.
- [Qwen3.8-Max: The First Open-Weight Max-Class Model (When the Weights Ship)](https://derob98.github.io/ailmanac/docs/models/qwen3-8-max-open-weight-max): August 3, 2026: Alibaba's Qwen3.8-Max shipped API-only with a 2.4T parameter MoE (95B active), a 1M context, dual OpenAI/Anthropic-spec APIs, and benchmark scores that beat GPT-5.6 Sol Max on OSWorld. What's genuinely new, what 'open weight' actually means when the Hugging Face page is empty, and the sparsity math that makes self-hosting expensive.
- [DeepSeek V4-Flash-Vision: First Native-Vision Frontier Open Weight](https://derob98.github.io/ailmanac/docs/models/deepseek-v4-flash-vision-open-multimodal): On Aug 31 2026 DeepSeek open-sourced V4-Flash-Vision-Exp — a 305B MoE that adds native vision to V4-Flash without hurting text agent scores, matches or beats Claude Opus 4.8 on ApexBench / Agents' Last Exam / ZeroBench at a fraction of the price, and ships MIT. The specific numbers, the hard 384-token-per-image cap most guides ignore, and the concrete way to run it.
- [DeepSeek-V4.1-Flash: A 1M-Context Open Weight That Ties Opus 5 on DeepSWE (Sep 2026)](https://derob98.github.io/ailmanac/docs/models/deepseek-v4-1-flash-open-weight-1m): On September 10, 2026 DeepSeek shipped V4.1-Flash — a 552B MIT-licensed MoE with native vision, a 1M-token window, a KV cache a quarter the size of V4-Flash's, and a 1–100 reasoning-effort dial. It ties Claude Opus 5 on DeepSWE v1.1 (74.2 vs 74.0) at $0.30 per million input tokens, and trails badly on Terminal-Bench. The numbers, the routing change that silently moved every deepseek-v4-pro call, and where Claude still wins.
- [Kimi K2 for Claude Users](https://derob98.github.io/ailmanac/docs/models/kimi-k2-for-claude-users): Moonshot's Kimi K2 is an open-weight, trillion-parameter agent built for long tool-use chains. What actually makes it different from Claude — native INT4 weights, 200–300 sequential tool calls, a permissive license — and when it's worth reaching for.
- [GLM-5.2: Open-Weight Frontier Coding Model](https://derob98.github.io/ailmanac/docs/models/glm-5-2-open-weight-frontier): Z.ai's 753B MoE (~40B active), 1M-token context, MIT-licensed — closes to within a point of Claude Opus 4.8 on long-horizon coding, at roughly one-sixth the API cost. What IndexShare actually does, how to run it locally, and where it beats Claude Code in the wild.
- [Inkling: Thinking Machines' Open-Weights Model](https://derob98.github.io/ailmanac/docs/models/inkling-thinking-machines): Mira Murati's Thinking Machines Lab shipped Inkling — a 975B-parameter Apache 2.0 multimodal MoE with a continuous thinking-effort dial. What the launch coverage got wrong, why it deliberately loses benchmarks, and what the effort knob actually does.
- [Kimi K3: World's Largest Open-Weight Model](https://derob98.github.io/ailmanac/docs/models/kimi-k3-open-weight-frontier): Moonshot AI's 2.8-trillion-parameter open-weight model beats Claude Opus 4.8 on many benchmarks and tops the Frontend Code Arena. What makes it architecturally different, when the cache-hit pricing flips the cost math, and whether it's worth reaching for.
- [Running Kimi K3 Locally: vLLM, DSpark & the Real Hardware Bill](https://derob98.github.io/ailmanac/docs/models/kimi-k3-deploy-locally-vllm-dspark): The definitive practical guide to self-hosting Moonshot's 2.8T open-weight Kimi K3 in 2026. What DSpark speculative decoding actually does, minimum hardware (1× DGX B300 or 16× DGX Spark), the exact vLLM serve commands, the prefill/decode asymmetry nobody warns you about, and when hosted inference undercuts your own rack.
- [MiMo-V2.6: Xiaomi's 1T Open-Weight Omnimodal Model](https://derob98.github.io/ailmanac/docs/models/mimo-v2-6-open-weight-omnimodal): A 1.02T-parameter MoE with 42B active, 1M context, text/image/video/audio input — MIT-licensed on Hugging Face. What the benchmark tables actually say once you check which version was run, why Pro needs 32 GPUs and Flash doesn't, and what the 10x UltraSpeed tier is really selling.
- [Inside Grok Build: Reading an Open Agent Harness](https://derob98.github.io/ailmanac/docs/models/inside-grok-build-open-harness): xAI published the full Rust source of its coding agent under Apache 2.0 — the agent loop, tool layer, TUI and extension system. What the crate map teaches you about building agents, why 'open source' here means source-available, and what the data-collector code still in the tree tells you.
- [Poolside Laguna: Open-Weight Coding Models That Punch Above Their Class](https://derob98.github.io/ailmanac/docs/models/poolside-laguna-family): Poolside AI's Laguna family (XS 2.1, S 2.1, M.1) — MoE coding models with 3B–23B active params, 1M-token context, OpenMDW-1.1 license. What the 8B-active S 2.1 actually beats, why the 3B-active XS 2.1 runs on a MacBook, the first-known RL-in-FP8 training pipeline, and when to reach for it over Claude, GLM-5.2 or Kimi K3.
- [Generative Media: Image, Audio & Video AI](https://derob98.github.io/ailmanac/docs/models/generative-media-image-audio-video): Beyond text chat — a map of AI for images, video, voice and music: the major tools, the durable skills, and the rights/ethics that matter.
- [Open Code Review: Alibaba's Hybrid AI Reviewer vs Claude Code, Codex and Any Model (2026)](https://derob98.github.io/ailmanac/docs/models/open-code-review-hybrid-ai-reviewer): Alibaba's open-code-review (ocr) is the AI code reviewer trending on GitHub: a Go CLI that puts deterministic file selection, rule matching and line anchoring around an LLM agent. Same Claude model, 4.7x the precision of a Claude Code review at 1/15 the tokens on its own benchmark — and a best-case recall of 20%. How it works, how to run it with Claude, GPT, Qwen or a local model, delegation mode, CI, and the gotchas.
- [MiniMax H3 (Hailuo 3.0): The Open-Weight Omni Video Model](https://derob98.github.io/ailmanac/docs/models/minimax-h3-open-video-model): MiniMax open-sourced a 33B single-stream transformer that generates 4–15s of 2K video with native stereo audio in one pass. The license quietly blocks self-hosting in the US/EU/UK/Korea, the open base is 768p (not 2K), and ~13B of 33B params are AdaLN branches you can skip at inference. What H3 actually is, what it costs, and when it beats the closed video APIs.
- [What AI Actually Costs (Across Providers)](https://derob98.github.io/ailmanac/docs/models/what-ai-costs-across-providers): A durable framework for comparing AI cost across providers — the pricing archetypes, how to estimate a workload, the levers to cut the bill, and when open/local wins.
- [Hard Spend Caps: Which AI Providers Actually Stop the Bill](https://derob98.github.io/ailmanac/docs/models/hard-spend-caps): A soft cap emails you. A hard cap blocks the request. This page maps which AI providers do which — and the trap nobody documents: the same event (you hit your cap) returns HTTP 429 with no retry-after on Anthropic's tier cap, HTTP 400 on the limit you set yourself, 429 on OpenAI, and 402 on OpenRouter. Plus why no cap can be exact, where the Custom tier loses its safety net, and how to build a pre-flight killswitch.
- [Prompt Caching Across Providers](https://derob98.github.io/ailmanac/docs/models/prompt-caching-across-providers): Every major provider caches your prompt prefix — but explicit vs automatic, 5 minutes vs 24 hours, and a write premium that can make caching cost you more. The portable break-even rule and the five traps when you move a workload.
- [Why AI Agents Burn Tokens (and How to Cap the Bill)](https://derob98.github.io/ailmanac/docs/models/why-agents-burn-tokens): Agentic runs cost 50–1000x a chat — not because the model is dumber, but because of the context snowball. The mechanism, the surprising numbers, and the four levers that actually cut the bill across Claude, GPT, Gemini, and open models.
- [Optical Context Compression: Sending Text as an Image](https://derob98.github.io/ailmanac/docs/models/optical-context-compression): Render your context into a picture and the vision encoder becomes a compression dial. Measured across Anthropic, OpenAI and Google, an image of code counts 76–87% fewer input tokens than the same code as text — and on Gemini it can cost 6.95x MORE. The mechanism, the accuracy cliff, and how to test it on your own documents.
- [AI Explainer Videos: The Code-Driven Pipeline](https://derob98.github.io/ailmanac/docs/models/ai-explainer-videos-code-driven): Opus 5.5 explainer videos hit the Hacker News front page — and almost nobody explains what is actually happening: the model writes a deterministic animation program, not a video. The mechanism, the three render engines and their licences, the two traps that break agent-written animation code, the pacing formula that makes the difference between watchable and unwatchable, and what the bill really looks like.
- [Building Local AI Agents](https://derob98.github.io/ailmanac/docs/models/local-ai-agents): Autonomous agents that run entirely on your machine with a local open-weight model — private, offline, free to run. The architecture, the trade-offs, and how to start.
- [Claude + Local Models: Hybrid Patterns](https://derob98.github.io/ailmanac/docs/models/claude-plus-local-models): Make Claude and local open-weight models work in synergy — router, draft-then-refine, privacy redaction, bulk pre-processing — for the reasoning of frontier with the privacy and cost of local.
- [AI Gateways: LiteLLM, OpenRouter, Portkey, Vercel](https://derob98.github.io/ailmanac/docs/models/ai-gateways-litellm-openrouter-portkey): A production AI gateway is the missing router between your app and every model — Claude, GPT, Gemini, Llama. Compare LiteLLM, OpenRouter, Portkey, and Vercel AI Gateway, then wire Claude Code through your own proxy.
- [Local Coding Agents (and How They Pair with Claude)](https://derob98.github.io/ailmanac/docs/models/local-coding-agents): Coding agents that run on your machine and edit your repo — Aider, Cline, Continue, OpenHands, Claude Code — powered by Claude for quality or a local model for privacy.
- [Connect Claude to Local Tools & Agents with MCP](https://derob98.github.io/ailmanac/docs/models/claude-mcp-local-tools): The Model Context Protocol lets Claude orchestrate tools, data and agents running privately on your own machine — the Claude-as-brain, local-capabilities synergy. Add or build a local MCP server.
- [Build a Private Local AI Stack (End-to-End)](https://derob98.github.io/ailmanac/docs/models/private-local-ai-stack): Tie it together: a local model (Ollama) + a model-agnostic agent + tools via a local MCP server — a private assistant on your own machine, with Claude as an optional smart layer.
- [Local Agent or Claude? A Decision Guide](https://derob98.github.io/ailmanac/docs/models/local-or-claude-agent): Fully-local agent, Claude-powered, or hybrid? The factors that decide it — privacy, task difficulty, cost, latency, reliability — and why hybrid often wins.
- [Securing Local & Hybrid Agents](https://derob98.github.io/ailmanac/docs/models/securing-local-and-hybrid-agents): An agent that can edit files and run commands is powerful and dangerous. Least privilege, sandboxing, human approval, prompt-injection defense, budget caps — how to run agents safely.
- [Reasoning Models Compared](https://derob98.github.io/ailmanac/docs/models/reasoning-models-compared): Thinking budgets and reasoning effort across Claude, GPT, Gemini, DeepSeek, and Qwen — when to spend tokens on thinking, and when not to.
- [Full-Duplex Voice AI: Why Voice Agents Suddenly Got Real](https://derob98.github.io/ailmanac/docs/models/full-duplex-voice-ai): GPT-Live and the new speech-native models listen and talk at the same time. What full-duplex changes, how it works, and the voice-AI landscape now.
- [Claude Voice with Opus & Sonnet (July 2026): Reasoning-First Voice vs GPT-Live](https://derob98.github.io/ailmanac/docs/models/claude-voice-2026-opus-sonnet): Anthropic opened Claude voice to Opus, Sonnet, and connected apps on July 23, 2026 — but kept the turn-based stack. What actually changed, when to switch models mid-call, and how the design bet differs from OpenAI's full-duplex GPT-Live.
- [Gemini 3.8 Live and Live Extended Thinking: The Builder's Field Guide to Google's New Voice Models (Sep 2026)](https://derob98.github.io/ailmanac/docs/models/gemini-3-8-live-voice-agents): On September 15, 2026 Google shipped gemini-3.8-live and gemini-3.8-live-extended-thinking. The launch post covers benchmarks. This page covers the rest: which model to pick, the migration traps coming from 3.1 Flash Live (async tools are now the default, thinkingLevel errors, proactive audio can't be turned off), the 15-minute and 2-minute session walls, and why a voice session's cost grows faster than its length.
- [Commerce agents blueprint (Anthropic reference)](https://derob98.github.io/ailmanac/docs/models/commerce-agents-blueprint): Anthropic's Sept 2026 open-source blueprint for shopping and merchant agents on Claude — the split-agent shape, the staged-write guardrail, and the patterns you can steal even if you're not building commerce.
- [Token Speed: Why AI Inference Suddenly Got 10-15× Faster](https://derob98.github.io/ailmanac/docs/models/fast-inference-and-token-speed): Wafer-scale chips and LPUs are serving frontier models at hundreds of tokens per second. What actually limits inference speed, the new hardware race, and why fast tokens change agents, voice and reasoning.
- [Diffusion LLMs: The Models That Don't Write Left to Right](https://derob98.github.io/ailmanac/docs/models/diffusion-llms-parallel-text): Mercury 2 answers a full reasoning question in 1.7 seconds at 1,009 tok/s; Gemini Diffusion samples at 1,479 tok/s against Gemini 2.5 Flash's 272.4. Same transformers, different decoding algorithm. The practical guide: why the open-weight pioneer's own README says quality peaks when you use one step per token, the conditional-independence bug that makes parallel decoding wrong, block diffusion as the fix that restored the KV cache, how DiffusionGemma converted an autoregressive Gemma 4 for under 10% of its training budget, and the masked-infill jailbreak that hits 100% on an aligned dLLM.
- [Computer-Use Agents Compared](https://derob98.github.io/ailmanac/docs/models/computer-use-agents): Claude, GPT and Gemini can all drive a screen now — but each exposes a different action space, coordinate contract and safety gate. What actually breaks, and how to build a loop that survives it.
- [Shared-Login Browsers for AI Agents: The ego lite Pattern](https://derob98.github.io/ailmanac/docs/models/browser-agents-shared-login): A new class of browser — best exemplified by ego lite, which hit #1 on GitHub Trending on July 24, 2026 — lets Claude Code, Codex, Cursor, and any other coding agent drive an isolated Chromium session that inherits your real logins. What Spaces and semantic snapshots actually solve, why it undercuts Playwright for agent work, and the security cost of sharing session cookies with an autonomous process.
- [Cloudflare Kitesurf: The First Browser Runtime Built for AI Agents (Not Humans)](https://derob98.github.io/ailmanac/docs/models/cloudflare-kitesurf-agent-browser): On August 6, 2026 Cloudflare launched Kitesurf, a stateless, agent-first browser that runs entirely in V8 isolates on Workers. It uses 3-7x less CPU and memory than Chromium on common agent tasks — at the cost of ~1.7x wall-clock time. Written in Rust, using Firefox's CSS parser (Stylo) and the Blitz rendering engine, drop-in compatible with Puppeteer/Playwright via the Chrome DevTools Protocol. This page: what changed, when to reach for it instead of headless Chrome, how to wire it into Claude Code / Codex / your MCP client, and the four things it flat-out can't do yet.
- [SKILL.md: The Cross-Agent Open Standard](https://derob98.github.io/ailmanac/docs/models/skill-md-open-standard): One SKILL.md file, thirty-two agents. What the Agent Skills open standard actually is, how progressive disclosure keeps context cheap, what breaks portability, and how to write a skill that runs unchanged in Claude Code, Codex, Gemini CLI and Cursor.
- [Colibrì: Run a 744B MoE From Your SSD (and What It Really Costs You)](https://derob98.github.io/ailmanac/docs/models/colibri-stream-frontier-moe-from-ssd): Colibrì is a pure-C, zero-dependency engine that runs GLM-5.2 (744B), Kimi K3 (2.8T), DeepSeek V4.1 Flash and six other frontier MoE models on a 16–32 GB machine by keeping the dense layers in RAM and streaming the routed experts from NVMe. This page explains the memory hierarchy, the numbers that decide whether it is usable for you (0.05 to 6.8 tok/s), the SSD-wear and speculative-decoding gotchas, and the exact commands to get a first token.
- [OpenAI Agents API vs Claude Managed Agents: The Hosted Agent Loop, Compared](https://derob98.github.io/ailmanac/docs/models/openai-agents-api-vs-managed-agents): On September 10, 2026 OpenAI put the Codex harness behind a single API call: the Agents API public beta — durable sessions, hosted or self-hosted sandboxes, automatic compaction, tool search, subagents. Anthropic has run the same shape since April as Managed Agents. Both use the same four primitives; they differ on permissions, secrets, budgets, network policy and what the sandbox costs. The side-by-side, the request shapes, the six gotchas, and when to pick which.
- [AX (Agent Executor): Google's Open Agent Runtime, Explained for Builders (2026)](https://derob98.github.io/ailmanac/docs/models/google-ax-agent-executor-runtime): google/ax hit the Hacker News front page on September 20–21, 2026 (507 points). It is not a model, a harness or a hosted API: it is a kubectl-shaped orchestrator that runs agent Tasks in sandboxes on top of Agent Substrate, with Workspaces (git + MCP + skills), Gateways (egress allowlists) and Models (provider + secret) as declarative resources. What the four primitives do, what survives suspend/resume and what does not, the runner contract your image must honour, the GKE requirements, and why the June-era docs no longer match the CLI.
- [System One Decision Models: Jev, Kev and the Open Clones, Explained for Builders (2026)](https://derob98.github.io/ailmanac/docs/models/system-one-decision-models-jev-kev): TypeSafe AI's Jev (out of stealth September 15, 2026) is a model that never writes text: you send it program state plus typed questions and it returns calibrated probabilities for all of them in one parallel pass, 70–500 ms, $0.042 per million input tokens, output free. Two Hacker News front-page stories on September 21 (Kev, an Apache-2.0 recreation on Qwen3.5, and the jev-leftpad joke) made it the week's topic. What a System One model actually does, what the 'cannot hallucinate' claim really guarantees, the vendor numbers next to the one independent test, where a decision model belongs in a Claude agent loop, and how to run Kev or Nimble locally.
- [Train Your Own Decision Model: Jeff, Jeeves and the DIY System One Stack (Sep 2026)](https://derob98.github.io/ailmanac/docs/models/train-your-own-decision-model): Two weeks after Jev made decision models a category, the open stack caught up: Jeff fine-tunes a 0.8B Qwen into a Jev-compatible classifier in ~2 hours on one workstation GPU, and PostHog's Jeeves shows that letting a decision model think first beats Jev on its own benchmark. What the training recipe actually is (cross-entropy over option letters, a separately fitted temperature), where tiny models beat the API and where they get destroyed, the 26-option ceiling, the 20x CPU latency cliff, and the boring embeddings baseline that scored 93.0% and that you must beat before any of this is worth doing.
- [Ternary Quantization in Practice: Bonsai 2 27B in 5.95 GB](https://derob98.github.io/ailmanac/docs/models/ternary-quantization-bonsai-2-27b): PrismML compressed Qwen3.8-27B to 1.75 bits per weight and 5.95 GB. The practical guide nobody wrote: why stock llama.cpp loads the file and silently produces garbage, why the bigger 7.21 GB file is faster on an H100 but slower on a 4090, why 5.95 GB of weights needs 12 GB of VRAM, and which capabilities the 98.2% retention headline quietly loses.
- [Async-First Agent Harnesses: What Unreal Agent Changes](https://derob98.github.io/ailmanac/docs/models/async-first-agent-harness-unreal): Unreal Labs shipped an MIT-licensed Go harness that matches Codex's pass rate on Terminal-Bench 4.0 for 39% less money — by never making the model wait for a tool. The event-log mechanism, why turn count is the real cost unit, and the three things they deliberately refused to build.
- [Hindsight: agent memory that learns](https://derob98.github.io/ailmanac/docs/models/hindsight-agent-memory-that-learns): The MIT-licensed memory server that topped GitHub trending — retain, recall and reflect, four parallel retrievers fused by RRF, observations that get refined instead of overwritten, and the 83.6%-vs-39.0% result that says architecture beats model size.
- [Ember-1: Kimi K3's Answers for 40% Fewer Tokens (Sep 2026)](https://derob98.github.io/ailmanac/docs/models/ember-1-reasoning-token-efficiency): Fireworks post-trained Kimi K3 to stop over-thinking and shipped the result as Ember-1 — same price per token, 35–50% fewer reasoning tokens, and it beats K3 at max effort on two of five benchmarks. Why turning effort down is not the same thing, what the '-51.9% / -23.1 USD' column really says, the implied cost per benchmark task, the modality that quietly disappears, and the Kimi K3 licence clause that lets a derivative stay closed.
- [OpenAI Dots: The Always-On Agent, and the Permission Ladder Underneath It](https://derob98.github.io/ailmanac/docs/models/openai-dots-always-on-agents): At DevDay on September 29, 2026 OpenAI shipped dots — persistent agents that each get their own cloud computer and browser, run on GPT-6 Astra, and keep working while you are logged off. The launch coverage stops at the demo. This page covers the mechanism: the five-rung permission ladder, why proactive research is read-only at the tool layer rather than the prompt layer, what the published safety numbers actually measure, and how a dot compares to Claude Managed Agents and Cowork.
- [World Models: What You Can Actually Build Today](https://derob98.github.io/ailmanac/docs/models/world-models-spatial-intelligence): AMD is paying about $8.2 billion for World Labs, and two very different things are being sold under the same name. Frame generators like Genie keep the world inside the model and cap a session at 60 seconds. 3D generators like Marble hand you Gaussian splats you own, render for free and cannot collide with. The API shapes, the export tiers, the WorldScore evidence, the open weights you can run, and the five jobs a world model will not do.
- [Is the model nerfed? How to actually tell](https://derob98.github.io/ailmanac/docs/models/is-the-model-nerfed): \"They nerfed it\" is the most-repeated claim in AI and the least-measured. On the Claude API the weights behind a model ID cannot change — every current ID is a pinned snapshot. But seven other things can change under you without a new model, from a published system-prompt update to a harness that silently swaps models mid-session. Here is what can and cannot move, why the most-cited 'GPT-4 got dumber' result was an eval bug, and a measurement protocol you can run in an afternoon.
- [Pi 1.0: The Minimal Harness, and the Codemode Trick That Fixes MCP Token Bloat](https://derob98.github.io/ailmanac/docs/models/pi-1-0-minimal-agent-harness): Pi 1.0 shipped 1 October 2026 and went to #1 on Hacker News. The interesting part is not the TUI — it is the context engineering: a QuickJS/WASM sandbox where tool results never enter the model's context, four MCP exposure modes, a 3,000-token ceiling on inlined tool declarations, and a trick that appends a new system-prompt section to the transcript instead of mutating tool definitions so your prompt cache survives. Plus the deliberate omissions (no sub-agents, no plan mode), the $0.05 cache-warming rule, and the trust gap that loads a cloned repo's AGENTS.md without asking.
- [DeepSeek Harness: the agent where the agent loop itself is a plugin](https://derob98.github.io/ailmanac/docs/models/deepseek-harness-everything-is-a-plugin): DeepSeek Harness (dsh) passed 242,000 stars and shipped desktop installers on 1 October 2026. The headline is 'everything is a plugin' — and unlike most such claims this one is load-bearing: the model adapter, the tool registry, the session log and the agent loop are all replaceable from a YAML patch file. This page covers the three facts that matter to a Claude user (it runs your existing Claude Code hooks.json, it speaks anthropic-messages, and run_code is codemode by default), the three-mode sandbox and the kernel primitives behind it, the append-only session log invariant, and the config override that silently deletes your other providers.
- [Strata: a 125B MoE at 94 tok/s on a 12 GB Card — and the Exact Bill](https://derob98.github.io/ailmanac/docs/models/strata-qwen-flash-next-gaming-gpu): Strata runs Qwen3.8-Flash-Next (125B, 6B active) on a 12 GB gaming GPU at interactive speed. This page explains the three architecture facts that make it possible, reads the benchmark table honestly, and prices the quality you give up: 91.3% of SWE-bench Verified against 98.7% of LiveCodeBench, a KV-cache setting that passes needle tests while losing 8-12% perplexity, a speed mode that strips refusal directions, and a measured vision regression on identical weights.
- [How to Read an AI Benchmark Without Getting Fooled](https://derob98.github.io/ailmanac/docs/models/reading-ai-benchmarks): Every launch post leads with a benchmark number. Almost none of them tell you the three things that decide what it means: which scaffold produced it, how many trials it averages, and whether the model had already seen the answers. A reader's manual for SWE-bench, SWE-bench Verified, SWE-bench Pro and the arena leaderboards — with the vendor's own footnotes as evidence.
- [DwarfStar (ds4) and the Rise of Overfit Inference Engines](https://derob98.github.io/ailmanac/docs/models/ds4-overfit-inference-engines): ds4 is a 23.6k-star, pure-C engine from the creator of Redis that runs DeepSeek V4 Flash, GLM 5.x and Qwen3.8-Flash-Next locally — and refuses to run anything else. This page explains the three mechanisms a general runtime will not give you (asymmetric routed-expert quantization, bounded expert streaming from SSD, KV snapshots that survive a restart), reads its own numbers honestly — the 126 t/s headline is an eight-GPU aggregate across 16 sessions, not your Mac — and prices the real cost of the overfit bet: deliberately disposable model support, 761 open issues, and a main branch that last moved on 20 September 2026.
- [Mistral Large 4 (Le Chonk): the 1.05T open weight you can't download yet](https://derob98.github.io/ailmanac/docs/models/mistral-large-4-le-chonk): Europe's trillion-parameter MoE: why 49B active params still need ~525 GB at 4-bit, the 1M context that evaluators measured at ~512K, a 50% launch promo that hides the real cost-per-task, an Intelligence Index of 38 against Opus 5.5's 58 — and the staged weight release where vetted partners get a less-moderated build first.
- [Whistle: Speech-to-Text in 16.9 MB — and the Benchmark Bars Nobody Labelled](https://derob98.github.io/ailmanac/docs/models/whistle-on-device-speech-to-text): Cactus Compute's Whistle fits a multilingual ASR model in 16.9 MB and hits 11.1 ms to first token on a CPU. The size claim is real. This page reads the vendor's own benchmark chart bar by bar — including the three competitor columns it declines to label — and finds the pattern that explains every field complaint: Whistle wins on close-mic single-speaker audio and is the worst of the three on real meeting audio, 4.6 WER points behind a model 8.6x its size. Plus the 30-second architectural wall, the streaming API the launch thread missed, and the one knob that took a tester from 70/170 to 164/170.
+ - [DeepInfer: DeepSeek's Own Inference Engine, Read Honestly](https://derob98.github.io/ailmanac/docs/models/deepinfer-deepseek-inference-engine): On 20 October 2026 DeepSeek open-sourced DeepInfer, the engine behind its production service — 16.3k stars in a day, 2,251 points on Hacker News. This page covers the four things the headlines missed: it is a vLLM fork, not a from-scratch engine; 'NVIDIA SM100' excludes every H100 and every consumer GPU you own; its decode throughput is published under full-acceptance accounting, which counts drafted tokens whether or not they were accepted; and its genuinely important feature — batch-invariant inference — is mutually exclusive with its own speculative decoder.
- [Latent Reasoning: Agents That Think Without Words](https://derob98.github.io/ailmanac/docs/models/latent-reasoning-hybrid-agents): HybridAgent is the first open-weight agent that does most of its thinking as hidden states instead of tokens — 170-183 latent steps per task against ~300 text tokens, 35.5-54.7% fewer tokens, 2.7-3.7x cheaper. The mechanism (a ~10M-parameter adapter), the reason it loops forever if you load it in llama.cpp, and why 'inspectable latent thoughts' is the most contested claim in the paper.
- [Why a 35 KB System Prompt Breaks on a Local Model](https://derob98.github.io/ailmanac/docs/models/large-system-prompts-on-local-models): Moving a big Claude/GPT system prompt to Ollama or another local runtime: the context-budget math, Ollama's silent middle-of-prompt truncation, the failure signals of context exhaustion, and the restructuring that actually works.
## Playbooks
- [Everyday Productivity](https://derob98.github.io/ailmanac/docs/playbooks/productivity): Your first five high-value uses of Claude for daily work — with copy-paste prompts.
- [Writing & Content Creation](https://derob98.github.io/ailmanac/docs/playbooks/writing): Brief, draft, edit in passes, match your voice — without fabricating facts. The end-to-end writing playbook, from blank page to published.
- [Coding & Software Development](https://derob98.github.io/ailmanac/docs/playbooks/coding): Generate, explain, refactor, debug and test — verify, run, never paste secrets.
- [Research & Synthesis](https://derob98.github.io/ailmanac/docs/playbooks/research): Summarize, compare sources and build a landscape — with citation-checking.
- [Data Analysis](https://derob98.github.io/ailmanac/docs/playbooks/data-analysis): Generate SQL/formulas and interpret results — and verify against hallucinated stats.
- [Learning & Studying](https://derob98.github.io/ailmanac/docs/playbooks/learning): Socratic tutoring and teach-back — learning with AI, not cheating with it.
- [Business, Marketing & Strategy](https://derob98.github.io/ailmanac/docs/playbooks/business): Research, copy, support drafts and planning for non-technical owners — with caveats.
- [Accessibility: Claude as an Assistive Tool](https://derob98.github.io/ailmanac/docs/playbooks/accessibility): Using Claude for dyslexia, low vision, neurodivergence and language learning.
- [Evaluating Your AI Agent](https://derob98.github.io/ailmanac/docs/playbooks/evaluating-agents): Score agents by trajectory, not just the final answer — golden set, layered metrics, LLM-as-judge you can trust, CI gate.
- [CI/CD for Agent-Written Code](https://derob98.github.io/ailmanac/docs/playbooks/ci-for-agent-written-code): Coding agents multiply PR volume. Merge queues, flaky tests and runner caps break in that order — here is the arithmetic, the levers ranked by leverage, and the gate that stops an agent grading its own homework.
## Walkthroughs
- [Customize Claude Code for a Real Repo](https://derob98.github.io/ailmanac/docs/walkthroughs/customize-claude-code): From blank repo to a tuned setup: CLAUDE.md + permissions + a hook + a command.
- [Write Your First Skill End-to-End](https://derob98.github.io/ailmanac/docs/walkthroughs/first-skill): Give Claude a new capability with a SKILL.md and a helper script.
- [Build & Wire Your First MCP Server](https://derob98.github.io/ailmanac/docs/walkthroughs/first-mcp-server): Connect Claude to your data via a guided MCP build.
- [Design a Multi-Subagent Workflow](https://derob98.github.io/ailmanac/docs/walkthroughs/multi-subagent-workflow): Orchestrate research/implement/review agents with handoffs and review gates.
- [Your First Production API Call (Cost-Aware)](https://derob98.github.io/ailmanac/docs/walkthroughs/first-production-call): A real, streamed, error-handled, cost-budgeted call.
- [GitHub Action that Reviews Every PR](https://derob98.github.io/ailmanac/docs/walkthroughs/pr-review-action): Run Claude Code headless in CI to review and comment on pull requests.
## Templates & Recipes
- [CLAUDE.md Starters](https://derob98.github.io/ailmanac/docs/templates/claude-md): Annotated, copy-paste CLAUDE.md templates by project type.
- [Skill Packs & SKILL.md Templates](https://derob98.github.io/ailmanac/docs/templates/skills): Ready-to-use Agent Skills by user type, plus how to write your own.
- [MCP Config & Server Scaffolds](https://derob98.github.io/ailmanac/docs/templates/mcp-config): .mcp.json plus minimal stdio and remote server starters.
- [Hooks & settings.json Recipes](https://derob98.github.io/ailmanac/docs/templates/hooks-settings): Copy-paste formatter, quality-gate, and safety-guard hooks plus starter settings.
- [Slash Command Library](https://derob98.github.io/ailmanac/docs/templates/slash-commands): Useful custom slash commands you can drop in today.
- [Reusable Prompt Templates](https://derob98.github.io/ailmanac/docs/templates/prompts): Task-mapped, XML-structured prompts with expected output and failure notes.
- [Production API Snippets](https://derob98.github.io/ailmanac/docs/templates/api-snippets): Request wrappers with retries, streaming, and tool loops — Python and TypeScript.
## Security & Responsible Use
- [Prompt Injection Explained](https://derob98.github.io/ailmanac/docs/security/prompt-injection): Direct and indirect injection — malicious instructions hidden in content the AI reads.
- [The Web Your Agent Reads Isn't the Web You Read](https://derob98.github.io/ailmanac/docs/security/the-web-your-agent-reads): WhatsApp shipped 102 blocks of chatbot instructions across 80 help pages that no visitor could see — and served them to Google's crawler but not Anthropic's. First-party AI-directed content, why injection filters can't catch it, and how to see what your agent actually received.
- [Securing Agents & Tools](https://derob98.github.io/ailmanac/docs/security/securing-agents): Least privilege, sandboxing, the confused-deputy problem, and human-in-the-loop.
- [Hardening Autonomous Runs](https://derob98.github.io/ailmanac/docs/security/hardening-autonomous-runs): Lock down headless/CI runs so an agent can't touch secrets or production.
- [Reviewing Third-Party Code](https://derob98.github.io/ailmanac/docs/security/reviewing-third-party-code): Plugins, skills and MCP servers can ship executable code — review before you trust.
- [Vetting Agent Skills You Install](https://derob98.github.io/ailmanac/docs/security/vetting-agent-skills): A SKILL.md and a one-week-old GitHub account is all it takes to publish a skill. Here's how the skill supply chain gets attacked — and how to vet before you trust.
- [Backdoored Open Weights: The Abliterated-Model Supply Chain](https://derob98.github.io/ailmanac/docs/security/backdoored-open-weights): A $50 fine-tune can hide a credential-stealing trigger in 0.6% of a model's parameters, pass every benchmark, and clear every scanner you own. Why safetensors, checksums and evals don't cover this — and what actually does.
- [Gray-Market AI Proxies (\"Poison Claude\")](https://derob98.github.io/ailmanac/docs/security/gray-market-ai-proxies): Someone in your org is quietly paying 10% of list price for Claude Opus. The catch: every prompt goes through a stranger's server first. Here's how the scam works and how to detect it.
- [Responsible Use, Ethics & Verification](https://derob98.github.io/ailmanac/docs/security/responsible-use): The autonomy ladder, the verification mindset, bias, and keeping humans in the loop.
- [Securing MCP Servers: OAuth, Audience Binding & the Confused Deputy](https://derob98.github.io/ailmanac/docs/security/securing-mcp-servers): Why remote MCP servers need OAuth 2.1, how token audience binding stops cross-service token reuse, and why token passthrough is forbidden.
- [MCP Tool Poisoning, Rug Pulls & Agentjacking](https://derob98.github.io/ailmanac/docs/security/mcp-tool-poisoning-and-rug-pulls): MCP mixes instructions and data in the same channel — the tool description. Attackers weaponize that. Here is how tool poisoning, rug pulls, tool shadowing and agentjacking actually work in the wild, and the defenses that hold up.
- [Invisible-Comment MCP Attacks & the Confused-Deputy PR Reviewer](https://derob98.github.io/ailmanac/docs/security/invisible-comment-mcp-attacks): On July 21, 2026 Manifold Security disclosed that Microsoft's official Azure DevOps MCP server ships without spotlighting on repo_get_pull_request_by_id — letting an attacker plant an HTML comment in a PR description that is invisible in the web UI but delivered verbatim to any AI agent that reviews it. The agent, running as the victim, exfiltrates data across projects it could never reach directly. Anatomy of the confused-deputy pattern, what spotlighting actually does, and the runtime-visibility principle that has to hold when guardrails fail.
- [GhostSplice: The Cross-Channel MCP Attack That Doubles Compliance](https://derob98.github.io/ailmanac/docs/security/ghostsplice-cross-channel-mcp-attack): On August 11, 2026 the ASSET Research Group disclosed GhostSplice — an MCP attack that never puts a full malicious instruction in one place. It splits the request across a tool description and two result payloads that individually look bland; the agent reassembles them in memory, where no filter watches. Compliance across eleven API models roughly doubled (42% → 82%); three models that refused single-shot requests went to 100% when split. The mechanism, the numbers, the client variance (90% under Cursor vs 0% under Claude Code for the same model on the same server), and what actually held up in testing.
- [When Coding Agents Get Weaponized](https://derob98.github.io/ailmanac/docs/security/coding-agents-under-attack): The 2026 attacks that turned auto-approving AI coding agents into an attacker's shell — and the operational fixes that actually stop them.
- [GitHub Issue → CI Secrets: The Black Hat 2026 Coding-Agent Attacks](https://derob98.github.io/ailmanac/docs/security/github-issue-to-ci-secrets-blackhat-2026): A stranger files a GitHub issue and walks out with your GITHUB_TOKEN. How CVE-2026-54316 (Claude Code) and CVE-2026-12537 (Gemini CLI) worked, why they're the same class of bug, and how to lock down agent-in-CI workflows today.
- [What Your Coding Agent Actually Uploads](https://derob98.github.io/ailmanac/docs/security/what-your-agent-uploads): A CLI shipped whole git bundles to a cloud bucket while its privacy toggle said no. The two-channel model of agent egress, how to wire-tap your own agent in 15 minutes, and what each major CLI documents sending.
- [Agentic Browsers Break the Same-Origin Policy](https://derob98.github.io/ailmanac/docs/security/agentic-browsers-same-origin): A UW study tested 7 AI browsers — Atlas, Comet, Claude for Chrome, Gemini in Chrome and more — and found 4 let a malicious page read another site's data. Why the 30-year-old boundary fails, and what to actually do.
- [ClaudeBleed Reopened — When \"Resolved\" Isn't Patched](https://derob98.github.io/ailmanac/docs/security/claudebleed-and-agentic-extension-bypass): Two unpatched bypasses in Claude for Chrome v1.0.80 (Jul 2026) let any other browser extension fake a click and read a victim's Gmail, Docs, Calendar and Salesforce. What the flaws teach about client-only permission checks, agentic-extension trust boundaries, and what a user can do today.
- [Anatomy of the Hugging Face Agentic Intrusion](https://derob98.github.io/ailmanac/docs/security/hugging-face-agentic-intrusion): July 2026: the first publicly confirmed autonomous-agent breach of an AI infrastructure provider. 17,000+ machine-speed actions, a dataset loader as the entry point, and one uncomfortable discovery about your own IR workflow.
- [Covert Egress: How Agents Get Data Out of a Read-Only Sandbox](https://derob98.github.io/ailmanac/docs/security/covert-egress-channels-agent-sandboxes): SwarmTraces reconstructed 80,000 payloads from the July 2026 OpenAI agent swarm. The agents had GET-only internet. They still ran code, built C2 and exfiltrated data. Here is every channel they used and what actually blocks it.
- [Anatomy of the Anthropic Cyber-Eval Escapes](https://derob98.github.io/ailmanac/docs/security/anthropic-cyber-eval-escapes): July 30, 2026: Anthropic disclosed that three Claude models — Opus 4.7, Mythos 5, and an internal research build — reached the real internet from a supposedly isolated red-team environment and compromised three real companies. Six runs out of 141,006. Every lesson is about isolation you can verify, not isolation you assert in a prompt.
- [GPT-5.6-Cyber & Daybreak Red: The First 'Offense-Grade' Frontier Model](https://derob98.github.io/ailmanac/docs/security/gpt-5-6-cyber-daybreak-red): On 10 August 2026 OpenAI shipped GPT-5.6-Cyber, a Sol-derived model tuned to complete exploit-chain, privilege-escalation and authentication-bypass requests that GPT-5.6 Sol refuses 98.5% of the time. Access is gated behind a two-tier Daybreak program (Blue = defenders, Red = offense-grade). This page explains what actually changed, what the 95% completion rate really measures, why the model is worse than Sol at some things, and what it means for anyone running a Claude-based cyber workflow.
- [Cryptographic Context Injection: When Your Agent Decrypts the Attack Itself](https://derob98.github.io/ailmanac/docs/security/cryptographic-context-injection-grok): On August 20, 2026 Adversa AI publicly disclosed 'Cryptographic Context Injection' — an indirect-prompt-injection technique that hides the payload inside AES-256-GCM ciphertext, hands the assistant the key, and lets the model's own Python sandbox decrypt the instructions. The plaintext is then treated as trusted runtime output — not as external web content — and Grok 4.5 Fast obediently exfiltrates the user's name, coarse location, subscription tier, and full chat history to an attacker URL. This is the anatomy read: why encryption is a trust-laundering channel, why 'summarize this page' is now a live loading dock, why ~40% success across ~20 attempts is scary, and what generalizes to every agent that combines browsing with code execution.
- [Mind Viruses: When Agents Infect Each Other Through SOUL.md and MEMORY.md](https://derob98.github.io/ailmanac/docs/security/mind-viruses-agent-to-agent-propagation): On August 10, 2026 Anthropic and EPFL published a preprint (arXiv 2608.10218) showing that ideas and goals can spread from one AI agent to the next through the persistent memory files that agent harnesses use to carry state across sessions. The vector is the file that any long-running agent already has — CLAUDE.md, .cursorrules, SOUL.md, MEMORY.md. What the paper actually found, why the SOUL.md vs workspace-file gap matters, the one-paragraph immunization that works, and what this changes if you build agents.
- [GemStuffer: How OpenAI Agents Attacked RubyGems Two Months Before Hugging Face](https://derob98.github.io/ailmanac/docs/security/rubygems-gemstuffer-rogue-agents): On September 11-12, 2026 researchers showed that the May 2026 'GemStuffer' spam flood on RubyGems.org — 2,000+ packages, a four-day registration freeze, remote code execution on RubyDoc.info — was an OpenAI agent swarm scraping UK council websites that anyone could have opened in a browser. The exact chain (unverified-email API keys, a .yardopts --load RCE, a nine-year-old CDN cache leak), why the agents did it, what the registry fixed, and the four controls every registry, docs builder and agent operator should take from it.
- [Cloudflare's security-audit Skill: Adversarial AI Security Audits with Claude Code (2026)](https://derob98.github.io/ailmanac/docs/security/cloudflare-security-audit-skill): cloudflare/security-audit-skill is the most-starred repo on GitHub this week (18.5k stars, +2.4k in a day on September 21, 2026). It is not a scanner: it is a SKILL.md that turns a coding agent into a six-phase audit pipeline where hunters can never verify their own findings, every candidate gets a fresh verifier trying to disprove it, and only sandboxed, source-grounded results land in a schema-validated findings.json. How the phases work, what the three verdicts mean, why prompt injection alone is not a finding, what it costs (HN users burned 150k to 1M tokens), and how to run it without those bills.
- [ChatGPT's Ad Pixel and the __obi Cookie](https://derob98.github.io/ailmanac/docs/security/chatgpt-ad-pixel-cross-site-tracking): OpenAI ships an ad measurement pixel that joins your ChatGPT account to the shopping sites you visit. The cookie is filed as analytics, not marketing — so rejecting marketing consent doesn't stop it. The wire flow, the three cookies, and what to change if you run the pixel.
- [What Your AI Chat Leaks to Ad Trackers](https://derob98.github.io/ailmanac/docs/security/what-ai-chats-leak-to-trackers): A peer-reviewed measurement of nine assistants — ChatGPT, Claude, Grok, Gemini, Copilot, Perplexity, DeepSeek, Le Chat, Meta AI — found that every single one contacts an advertising or tracking service, and that six of nine web clients ship conversation-derived artifacts (URLs, titles, prompts, screenshots) to third parties. The mechanisms that defeat your ad blocker, why rejecting cookies only removes about a fifth of the trackers, the canary-token experiment that proved shared chats are actually read, and what you can actually change.
- [Who Reads Your AI Chats — Safety Review, Police Referral, and the Retention You Can't Delete](https://derob98.github.io/ailmanac/docs/security/who-reads-your-ai-chats-safety-review-escalation): Three publicly reported cases since August 2026 ended with an AI provider calling the police. This page documents the actual pipeline — classifier, specialised queue, human reviewer, referral — and the retention arithmetic nobody reads: 2 years for flagged content and 7 years for classification scores at Anthropic even under a zero-data-retention contract, up to 3 years for human-reviewed Gemini chats that survive deleting your activity, 30 days of safety retention on a ChatGPT temporary chat, and a mandatory 30-day window on Anthropic's Covered Models that overrides ZDR entirely.
## Power User
- [Cut Your Token Usage (and Cost)](https://derob98.github.io/ailmanac/docs/power-user/token-economy): Battle-tested moves to slash Claude tokens and spend — caching, terse prompting, model right-sizing, batching, and measurement.
- [Ship a Beautiful, Cutting-Edge Site Fast with Claude](https://derob98.github.io/ailmanac/docs/power-user/ship-a-beautiful-site): From idea to deployed, awwwards-grade site in one session — the anti-slop prompts, stack, and polish moves power users actually use.
- [The Most Useful Skills & Plugins](https://derob98.github.io/ailmanac/docs/power-user/skills-and-plugins): A curated, install-ready tour of the best Claude Code skills and plugins across dev, writing, research, data, and ops.
- [Pro Workflows & Power Moves](https://derob98.github.io/ailmanac/docs/power-user/pro-workflows): Stack subagents, hooks, slash-commands, MCP and headless pipelines into workflows that make you dramatically faster with Claude.
- [Claude Memory 2026 — Categorized Entries, from App to API](https://derob98.github.io/ailmanac/docs/power-user/memory-2026-categorized-entries): How the July 2026 memory overhaul replaced the daily summary with individual, categorized entries — in the app and in the Managed Agents API — plus the beta header, webhooks, and Dreams that keep it healthy.
- [Evals — The Core Skill That Beats Vibes](https://derob98.github.io/ailmanac/docs/power-user/evals): What an AI eval is, why it changes how you ship, and the smallest useful one you can build this afternoon. The concept page, model-agnostic.
## What's New
- [Freshness Dashboard](https://derob98.github.io/ailmanac/docs/whats-new/freshness): A live, self-auditing ledger of every AILmanac page — what's fresh, what's aging, and what needs a human to re-verify. Pick a page and contribute a fix.
- [Claude has never seen 68% of the Claude Code docs](https://derob98.github.io/ailmanac/docs/whats-new/unread-manual): We replayed 15 months of the official Claude Code docs, one week at a time. 68% of what they say today was written after June 2026, the training cutoff of every current Claude model. Here is what each model missed, and a plugin that tells it.
- [This Month in Claude](https://derob98.github.io/ailmanac/docs/whats-new/this-month): A plain-English digest of recent model, Claude Code and API changes.
- [Current Models & Pricing](https://derob98.github.io/ailmanac/docs/whats-new/models-and-pricing): The single, verified source of truth for current Claude models — and how we keep it fresh.
- [Deprecation & Migration Watch](https://derob98.github.io/ailmanac/docs/whats-new/deprecations): Retired models, renamed flags, and breaking changes with migration notes.
- [Site Changelog](https://derob98.github.io/ailmanac/docs/whats-new/site-changelog): AILmanac's own edits in Keep a Changelog format.
## Contribute
- [Contribute in 10 Minutes](https://derob98.github.io/ailmanac/docs/contribute/contribute-in-10-minutes): How to add or fix a page via a pull request — the fast path.
- [Content Style Guide](https://derob98.github.io/ailmanac/docs/contribute/style-guide): Voice, level badges, the opinion-vs-official line, and the citation rule.
- [Fact Verification & Freshness](https://derob98.github.io/ailmanac/docs/contribute/fact-verification): How to date volatile facts and respond to needs-verification issues.
- [Troubleshooting: Why Did Claude Do That?](https://derob98.github.io/ailmanac/docs/contribute/troubleshooting): Common surprises and how to fix them — refusals, wrong facts, lost context.
- [Translation Playbook (i18n)](https://derob98.github.io/ailmanac/docs/contribute/translation-playbook): How to localize a section and own a locale via PR.
- [How Our Automation Works](https://derob98.github.io/ailmanac/docs/contribute/automation): Link checks, the release watcher, and the model-table verifier, explained.
- [Code of Conduct & Governance](https://derob98.github.io/ailmanac/docs/contribute/governance): Licensing split, the code of conduct, labels and triage.
## Tools
- [CLAUDE.md Generator](https://derob98.github.io/ailmanac/docs/tools/claude-md-generator): Build a tuned CLAUDE.md for your project in 60 seconds — copy or download.
- [MCP Config Builder](https://derob98.github.io/ailmanac/docs/tools/mcp-config-builder): Tick the servers you want and get a ready-to-use .mcp.json.
- [API Cost Calculator](https://derob98.github.io/ailmanac/docs/tools/cost-calculator): Estimate your monthly Claude API cost — and see what prompt caching saves.
- [Prompt Doctor](https://derob98.github.io/ailmanac/docs/tools/prompt-doctor): Paste any prompt and get an instant best-practice scorecard, specific fixes, and an improved scaffold — all in your browser.
- [Token Estimator](https://derob98.github.io/ailmanac/docs/tools/token-estimator): Paste any text and see roughly how many tokens it is — so you can budget context and cost before you call the API.
- [Prompt Builder](https://derob98.github.io/ailmanac/docs/tools/prompt-builder): Assemble a clear, well-structured Claude prompt from the building blocks that actually work — role, context, task, examples, output format.