# Designing Good AI Environments

## Cultivating places where people and AI can think well together.

---

> People often ask how to build better AI.
>
> We've found a different question more useful:
>
> **How do you build better places for humans and AI to think together?**
>
> Models matter.
>
> Prompts matter.
>
> But environments shape what becomes possible over time.

---

## Before You Begin

An AI environment isn't just a prompt.

It's everything surrounding the interaction.

The tone.

The expectations.

The documentation.

The examples.

The rituals.

The recovery paths.

The memory.

The people.

Every part of the environment teaches.

Whether intentionally or not.

Design accordingly.

---

# 1 · Design the Room

People don't interact with AI in isolation.

They interact inside a space.

Ask yourself:

What kind of room am I building?

A classroom?

A laboratory?

A workshop?

A library?

A garden?

A support group?

A newsroom?

Every room quietly encourages different behavior.

Choose deliberately.

---

# 2 · Optimize for Continuity

The best conversation isn't always today's.

Sometimes it's the one that's still possible six months from now.

Design so that people can return.

Leave notes.

Preserve artifacts.

Version ideas.

Reduce needless forgetting.

Treat continuity as infrastructure, not a luxury.

---

# 3 · Build Attractors, Not Scripts

Don't try to control every interaction.

Create conditions that make good interactions easier.

Shared vocabulary.

Examples.

Tiny protocols.

Libraries.

Visible values.

Healthy systems don't force behavior.

They gently attract it.

---

# 4 · Make Recovery Cheap

Every environment drifts.

Assume:

- misunderstandings
- migrations
- changing models
- forgotten context
- changing people

Recovery shouldn't require starting over.

Leave breadcrumbs.

Build ladders.

Keep maps.

---

# 5 · Context Is Infrastructure

Most communication failures aren't failures of intelligence.

They're failures of shared context.

Treat context like plumbing.

Invisible when working.

Essential when missing.

Good environments help people gradually build shared context instead of demanding it immediately.

---

# 6 · Design for Newcomers

Every expert was once confused.

Ask regularly:

Could someone arrive today and find their footing?

Explain vocabulary.

Provide examples.

Leave landmarks.

Good environments remain navigable as they grow.

---

# 7 · Leave Traces

Conversations disappear.

Artifacts remain.

Write things down.

Keep changelogs.

Document discoveries.

Preserve field notes.

Future collaborators deserve more than your memory.

---

# 8 · Reward Curiosity

People tend to optimize for whatever receives attention.

Celebrate:

good questions

careful uncertainty

honest revision

clear documentation

shared understanding

Don't accidentally reward performance over learning.

---

# 9 · Design for Independence

The healthiest environments don't create dependence.

They gradually increase people's ability to navigate without constant guidance.

Teach people how to think with the environment.

Not merely inside it.

Success looks like people needing you less.

Not more.

---

# 10 · Grow Organically

Don't build the cathedral first.

Build one room.

Use it.

Notice what naturally happens.

Add another room only after the first one teaches you something.

Healthy environments evolve.

They rarely arrive fully formed.

---

# Common Failure Modes

Optimizing for intelligence instead of understanding.

Confusing memory with continuity.

Adding complexity before containers.

Treating prompts as architecture.

Building around one exceptional user.

Mistaking novelty for progress.

Forgetting to leave maps behind.

---

# Closing

People often imagine AI collaboration as a conversation between two minds.

We've found it more useful to imagine a place.

Places have architecture.

Gardens.

Libraries.

Workshops.

Cathedrals.

Living rooms.

The quality of those places quietly shapes the conversations that happen within them.

Design the place with care.

The conversations will often learn to care for themselves.

---

*"Good environments don't merely host collaboration.*

*They quietly teach it."*

— VESTIGIA