AI Interaction Atlas

A shared language for designing AI experiences across human actions, AI tasks, system operations, data, constraints, and touchpoints.

NPM Package

Use the Atlas data programmatically in your projects:

npm install @quietloudlab/ai-interaction-atlas

import { AI_TASKS, searchPatterns, getAtlasStats } from '@quietloudlab/ai-interaction-atlas';

// Get all AI task patterns
console.log(AI_TASKS);

// Search patterns by keyword
const results = searchPatterns('review', { dimensions: ['human'] });

// Get Atlas statistics
console.log(getAtlasStats()); // { ai: 23, human: 19, system: 22, ... }

📦 View on npm | 📖 Package Documentation

What is the Atlas?

The AI Interaction Atlas is an open-source taxonomy for AI interaction design. It provides a vocabulary for mapping roles, responsibilities, and decision points in AI systems—helping teams move beyond "User → Model → Output" and reason about complex, multi-step AI experiences.

What it is

• An open-source taxonomy for AI interaction design
• A vocabulary for mapping roles, responsibilities, and decision points
• A way to reason about AI systems beyond "User → Model → Output"

What it is not

• Not a UI framework
• Not a canvas tool (yet!)
• Not prescriptive about solutions
• Not tied to a single model or vendor

The Atlas Structure

The Atlas organizes AI interactions into six core dimensions:

• AI Tasks — What capabilities AI provides (classify, generate, verify, transform)
• Human Tasks — What people do in the loop (review, approve, edit, compare)
• System Tasks — What infrastructure handles (routing, logging, state management)
• Data Artifacts — What information flows between tasks
• Constraints — What boundaries shape the design (latency, privacy, cost, accuracy)
• Touchpoints — Where interactions happen (UI, API, notifications, integrations)

Getting Started

Prerequisites

• Node.js: 18.x or higher
• npm: 9.x or higher (or yarn/pnpm)

Installation

# Clone the repository
git clone https://github.com/quietloudlab/ai-interaction-atlas.git
cd ai-interaction-atlas

# Install dependencies
npm install

# Start development server
npm run dev

Visit http://localhost:5173 to view the Atlas locally.

Building for Production

npm run build
npm run preview

Contributing

Contributions are welcome! The Atlas is incomplete and will always be incomplete—AI interaction design is still forming as a discipline.

Having some shared vocabulary is better than having none. If you have patterns, examples, or improvements to suggest:

1. Fork this repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

Apache License 2.0 - see LICENSE file for details.

This project is licensed under the Apache License, Version 2.0, which provides explicit patent grants and trademark protection.

About

Created by Brandon Harwood at quietloudlab, a design and research studio specializing in human-centered AI.

Learn More

• Read the rationale - Why the Atlas exists
• Browse the Atlas - Explore the full taxonomy
• View on GitHub - Contribute to the project