In partnership with

AI Agents Are Reading Your Docs. Are You Ready?

Last month, 48% of visitors to documentation sites across Mintlify were AI agents, not humans.

Claude Code, Cursor, and other coding agents are becoming the actual customers reading your docs. And they read everything.

This changes what good documentation means. Humans skim and forgive gaps. Agents methodically check every endpoint, read every guide, and compare you against alternatives with zero fatigue.

Your docs aren't just helping users anymore. They're your product's first interview with the machines deciding whether to recommend you.

That means: clear schema markup so agents can parse your content, real benchmarks instead of marketing fluff, open endpoints agents can actually test, and honest comparisons that emphasize strengths without hype.

Mintlify powers documentation for over 20,000 companies, reaching 100M+ people every year. We just raised a $45M Series B led by @a16z and @SalesforceVC to build the knowledge layer for the agent era.

FROM THE DESK

I opened my go-bag last April and found the winter hat, gloves, and hand warmers I'd packed in November. It was 75 degrees outside. If I'd needed to evacuate that day, I'd have been carrying two pounds of cold-weather gear I didn't need and missing the sunscreen, insect repellent, and extra water that April actually demanded. Seasonal swaps aren't just nice to have. They're the difference between a kit that matches reality and one that doesn't.

Here's what I've got this morning.

THE BRIEF

Updating Your Kit for the Season Ahead

Your emergency kit should change with the calendar. The threats of January are different from the threats of July, and the supplies you need shift accordingly. A twice-yearly swap, once in spring and once in fall, keeps your kit matched to the actual risks you face.

The spring swap (March/April) transitions from cold-weather to warm-weather preparedness. Remove heavy layers, hand warmers, and winter-specific items. Add sunscreen, insect repellent, extra water capacity, a lightweight rain layer, and electrolyte packets. If you're in tornado or hurricane country, this is when you verify your severe weather kit (Issue 26) is complete and current.

The fall swap (September/October) reverses the process. Add warm layers, a hat, gloves, hand warmers, a heavier blanket, and a thermos. Check your heating backup supplies (Issue 62). Verify that your pipes are insulated if you're in a freeze zone. This is also when you should check your snow/ice vehicle supplies (Issue 45).

Beyond clothing and comfort items, seasonal swaps should cover these categories. Food: rotate snacks and bars in your kit with fresh ones. Check expiration dates on everything. Batteries: test all flashlights and radios. Replace any batteries that are weak. Medications: check expiration dates on all OTC and prescription medications in your kit. Water: if stored water has been sitting for six months, rotate it. Documents: update anything that's changed, new insurance policy, new phone number, new emergency contact.

The swap itself takes about 30 minutes per kit. Create a checklist and keep it with the kit so you don't have to remember what to check each time. A laminated card inside the bag with two columns, spring items and fall items, makes the process mechanical.

If you maintain multiple kits (home, car, office, go-bag), stagger the swaps over a weekend so each gets attention. The car kit is the most commonly forgotten and the one most affected by seasonal extremes.

ONE THING THIS WEEK

Set two calendar reminders: one for April 1 and one for October 1. Label them "Kit Swap."

When those dates arrive, pull out your kits and run through the seasonal swap. The reminder is the system. Without it, the swap doesn't happen.

ON THE RADAR

Through early May, 24,222 wildfires have burned 1.85 million acres across the United States — 194% above the 10-year average for this point in the season. AccuWeather is forecasting 5.5 to 8 million total acres burned by year end. The driver: 62% of the continental US is currently in some form of drought, leaving vegetation critically dry heading into peak fire season (June through August). If you live in a wildfire-risk zone, now is the right moment to verify your go-bag, clear defensible space, and confirm your evacuation route.

LESSON FROM: MYKEL HAWKE

Mykel Hawke's Hawke's Green Beret Survival Manual organizes survival principles by environment and season, reflecting the military approach of matching equipment to conditions. In Special Forces, operators pack for the specific environment they're entering, not for generic readiness.

Hawke's civilian application: your kit should reflect where you are and when you are. A one-size-fits-all approach means you're always carrying unnecessary weight and always missing something season-specific. The 30-minute seasonal swap eliminates both problems. It's a small maintenance task that keeps your capability aligned with your actual risk profile.

WHAT'S HAPPENING

Hantavirus Outbreak Aboard Research Vessel Triggers Federal Quarantine

The CDC issued Health Alert Network advisory HAN #528 after an Andes hantavirus outbreak aboard the MV Hondius, a research vessel operating in Antarctic waters, killed two people and left one passenger in critical condition. The Nebraska National Quarantine Unit — one of a small number of federal biocontainment facilities — was activated to monitor and isolate exposed individuals. Unlike North American hantavirus strains that spread only through rodent contact, Andes hantavirus can transmit person to person. The virus carries a 35–50% case fatality rate and has no approved antiviral treatment.

What this means for preparedness: Person-to-person transmission changes the risk profile significantly. Standard hantavirus precautions — avoiding rodent droppings, ventilating enclosed spaces — are not sufficient when direct human contact is a vector. This is a reminder to include respiratory protection and basic isolation procedures in your preparedness planning, and to know where your nearest federal quarantine resources are located.

WHAT I'M TESTING

Seasonal Swap Checklist (Laminated Card)

I created a two-sided laminated card that lives inside my go-bag. One side lists spring swap items (add sunscreen, remove heavy layers, check water, etc.). The other side lists fall swap items (add warm layers, check heater fuel, rotate batteries, etc.). Each item has a checkbox.

During the swap, I use a dry-erase marker to check items off. When done, I wipe it clean and it's ready for next time. The card cost $2 to print and laminate at a copy shop.

The checklist eliminated the "did I remember everything?" anxiety that used to make the swap take longer. Now it's a mechanical 30-minute process. I follow the card. Nothing gets missed.

Budget alternative: A folded piece of paper with the same list, kept inside the kit. Replace it when it gets worn. The information matters more than the format.

Our Factory Is Solving the Housing Crisis

Azure’s robotic manufacturing platform prints modular homes in 24 hours, ready for use in 20 days, starting around $40K.

With three robots already operating in LA, the company is scaling to a second factory in Denver.

OVERRATED / UNDERRATED

Overrated: All-season emergency kits that claim to cover every scenario. They're too heavy, contain compromises in every category, and don't match any season well. Two seasonal configurations beat one bloated year-round kit.

Underrated: Rotating food in your vehicle kit. A protein bar that's been in a hot car for six months tastes terrible and may have degraded nutritionally. Swap vehicle snacks with each seasonal transition.

NOAA Climate Prediction Center — Three-month temperature and precipitation forecasts by region.

Windy.com — Detailed wind and weather visualization for tracking seasonal patterns.

Ventusky.com — Advanced weather mapping for regional seasonal risk assessment.

Grokipedia: Emergency Kit — Background on emergency kit evolution and best practices.

NEXT ISSUE

Teaching yourself new skills faster. The learning framework that military and emergency professionals use to acquire competence quickly.

PS: The seasonal swap took 28 minutes last time. I timed it. That's less than a single episode of whatever you're streaming. And it means every item in my kit matches the next six months of actual weather and risk.

Keep reading