The Agent-Friendly Stack: 50+ AI Projects Taught Me This

TL;DR >> From shipping 50+ AI projects in months, I learned that successful tools must master the duality between human needs (power/flexibility) and agent needs (clarity/determinism). Type safety, machine-readable docs, and friction-free workflows separate winners from losers in the AI-native era. <<

We’re speedrunning through a Cambrian explosion.

Fifty-plus projects pushed to GitHub in just a few months. Different tech stack each time. All while testing AI agents in the wild. What a ride.

The dust is settling, and the pattern is crystal clear: winners won’t be the most powerful tools. They’ll be the most agent-friendly ones.

The Great Duality

CLI tools sit at an inflection point that most developers haven’t fully grasped yet.

Humans want power and flexibility. We love customization, edge cases, and the ability to bend tools to our will. We want our git with 147 flags and also curl with infinite possibilities.

Agents need clarity and determinism. They want unambiguous APIs, predictable outputs, and clear success/failure states. They don’t appreciate artistic ambiguity.

This isn’t about dumbing down interfaces for AI. It’s about creating tools sophisticated enough to serve both masters, expressive for humans, deterministic for machines.

Type Safety Isn’t Just for Humans Anymore

Here’s something that surprised me: type safety has become how agents understand your intent.

When Claude Code generates a FastAPI endpoint, it’s not just writing Python, it’s crafting a contract that other agents can parse, validate, and build upon. The OpenAPI spec that gets generated automatically becomes the lingua franca for agent collaboration.

React 19 with TypeScript? Perfect guardrails for agents. They know exactly what props are expected, what events are available, what can break.

SQLite with WAL mode? Agents can iterate rapidly without stepping on each other’s transactions.

The type system has evolved from a developer productivity tool to an inter-agent communication protocol.

Documentation Is Evolving Into a New Species

We’re building a parallel universe of machine-readable documentation:

  • llms.txt files that agents consume directly
  • .cursorrules that shape AI behavior
  • AGENT.md files with structured instructions
  • CLAUDE.md files with project-specific intelligence

As Netlify’s Mathias Biilmann calls it: AX (Agent Experience).

This isn’t replacing human documentation, it’s augmenting it. The same way we have both human-readable RESTful URLs and machine-readable JSON APIs.

The Stack That Adapts Fast

Some frameworks are naturals at this game:

FastAPI generates OpenAPI specs that agents devour. Every endpoint becomes immediately discoverable and consumable by other AI systems.

Stripe’s API remains the gold standard: clean for humans, rich with metadata for machines. Perfect example of serving both audiences without compromise.

React with TypeScript gives agents the guardrails they need while preserving the flexibility developers demand.

SQLite with wal mode? perfect for agent iteration cycles without breaking things.

The Black Holes Are Real

But others remain stuck in the past, creating friction that kills agent productivity:

Auth flows that assume human interaction. Multi-step OAuth dances that require human intervention kill agent autonomy.

Error messages written for developers who can Google. Agents can’t intuitively understand “segmentation fault” or “unexpected token.”

Legacy APIs without machine-readable contracts. If an agent can’t parse your API specification, it can’t use your service.

These friction points will kill frameworks faster than any performance benchmark.

Agents Don’t Care About Your Favorite Paradigms

Biggest surprise from all this experimentation? Agents optimize for working code, not elegant abstractions.

They’ll mix procedural, functional, and OOP patterns in ways that make purists weep. They don’t have religious preferences about Redux vs. Zustand or tabs vs. spaces.

This forces us to rethink what “good” architecture means when half your codebase might be generated by systems that prioritize functionality over philosophy.

The future stack will be radically simple at the surface, deeply sophisticated underneath. Think Stripe’s API aesthetic applied to entire development environments.

The “Let Agents Rip” Patterns

Winners will embrace workflows where agents can operate with minimal human intervention:

  • Deployments that agents spin up instantly
  • APIs they wire together without permission
  • Databases they scaffold and seed
  • Break them. Fix them. Iterate fast.

Then humans step in for the polish pass, refactoring with the agent, optimizing together, adding the human touch where it matters.

What This Means for Your Next Project

We’re not just choosing tech stacks anymore. We’re choosing which tools will amplify human creativity through agent collaboration.

The frameworks that get this right won’t just survive, they’ll define the next decade of development.

When evaluating your next tool, ask:

  • Can an agent understand its inputs and outputs without human explanation?
  • Does it generate machine-readable contracts automatically?
  • Can agents iterate on it without breaking things?
  • Does it embrace the “let agents rip” workflow?

The Cambrian explosion is far from over. But the selection pressure is already clear: adapt to agents, or become extinct.

The future belongs to tools that understand they’re serving two kinds of intelligence, human and artificial, and excel at both.


The revolution isn’t just in what we’re building. It’s in who, or what, is helping us build it.

Continue Reading

Nikola Balić

I build go-to-market engines for AI driven products that matter.