> ## Documentation Index
> Fetch the complete documentation index at: https://help.getatelier.design/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentic pinboard builder

> How Atelier uses Claude Managed Agents to build pinboards.

Atelier integrates **Claude Managed Agents** for AI-assisted pinboard creation.
Assigning the AI sentinel user to a task automatically triggers an agent session.

## Components

| File                                              | Responsibility                                           |
| ------------------------------------------------- | -------------------------------------------------------- |
| `apps/server/src/services/agent.ts`               | Session lifecycle, event loop, custom tool execution     |
| `apps/server/src/services/agent-tools.ts`         | The 13 custom tools for pinboard/product/task management |
| `apps/server/src/services/agent-tool-executor.ts` | Executes tools against the Prisma DB                     |
| `apps/server/src/routes/agent-sessions.ts`        | REST endpoints for agent session management              |

## The AI sentinel user

`ai@atelier.design` appears as a team member in assignee pickers. Assigning it to
a task auto-triggers an agent session that builds or edits the relevant pinboard.

## Configuration

Agent features require the following environment variables on the server:

* `ANTHROPIC_API_KEY` — **required**
* `ANTHROPIC_AGENT_ID` — optional, to reuse a pre-created agent definition
* `ANTHROPIC_ENVIRONMENT_ID` — optional, to reuse a pre-created environment