Templates

Design

A Slack design collaborator that answers from a reviewed, versioned corpus of your organization's approved design guidance.

View Source
  • Slack
agent/agent.tstypescript
import { defineAgent } from 'eve';

export default defineAgent({
  model:
    process.env.DESIGN_AGENT_MODEL ?? 'anthropic/claude-sonnet-4.6',
});

Eve design agent template

A Slack design agent that answers from your approved design guidelines.

Experimental: this template uses Eve preview APIs pinned to 0.27.3.

What it does

  • Answers Slack DMs.
  • Answers channel messages only when mentioned.
  • Reads a reviewed design corpus committed to your repository.
  • Uses message text, images, and documents as temporary context.
  • Labels general recommendations when enabled.
  • Flags equal-priority conflicts. In channels, it mentions your design owner.

It cannot search Slack or the web, change its corpus, edit artifacts, generate websites, or deploy projects.

Each DM or top-level mention starts a conversation. Continue in its reply thread. Channel replies must mention the agent again.

Before you deploy

You need:

  • A Vercel account.
  • Permission to authorize a Slack app.
  • A design owner and their Slack member ID.
  • Existing design guidance, or a design owner who can create it with the bootstrap interview.
  • A private repository if the guidance is private.

Set up

  1. Click Deploy with Vercel and authorize Slack.

  2. Clone the generated repository.

  3. Install Node.js 24 and pnpm 10, then run pnpm install.

  4. Open the repository in Codex, Claude Code, Conductor, or another coding agent.

  5. Send:

    Follow BOOTSTRAP.md and help me set up this design agent. Ask one small batch of questions at a time. Do not approve or publish the corpus for me.

  6. Review the approval packet from BOOTSTRAP.md and explicitly approve the corpus.

  7. Commit and push to main.

Until approval, the agent replies:

Design-agent setup is incomplete. Run the bootstrap workflow and approve the generated design corpus.

Git-connected projects deploy after the push. Otherwise run:

bash
pnpm exec vercel deploy --prod

Set up from the CLI

bash
pnpm installpnpm run setup

The setup script links the project, creates or reuses a Slack connector, attaches its production trigger, deploys production, and checks the Eve health and Slack routes. It opens Slack authorization in the browser when required.

See docs/manual-slack-setup.md to use direct Slack credentials.

Knowledge

  • knowledge/sources/: immutable source snapshots.
  • knowledge/guidelines/: concise, actionable rules.
  • knowledge/manifest.json: identity, ownership, provenance, precedence, access, and approval.
  • BOOTSTRAP.md: first-time knowledge setup.
  • REFRESH.md: reviewed knowledge updates.

The corpus is bundled at build time. Runtime conversations and attachments never change it.

Develop

Requires Node.js 24 and pnpm 10.

bash
pnpm installpnpm exec vercel linkpnpm exec vercel env pullpnpm dev

Run the full check:

bash
pnpm check

Other commands:

bash
pnpm verify:knowledgepnpm testpnpm type-checkpnpm buildpnpm run info

Set DESIGN_AGENT_MODEL to override the default model, anthropic/claude-sonnet-4.6.

Runtime safety

The agent can read and search only its bundled corpus. Shell, file writes, web access, delegation, todo management, and sandbox network access are disabled. Slack is its only connector.

License

MIT