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— requiredANTHROPIC_AGENT_ID— optional, to reuse a pre-created agent definitionANTHROPIC_ENVIRONMENT_ID— optional, to reuse a pre-created environment