Agents
The Agents page (/agents) is the central hub for all AI agents in Nucleus. It provides visibility and control over the orchestrator (Nucleus self-development), the Dev Agent (client project automation), and business agents (analytics, resourcing, marketing, product, release).
Agent Types
Section titled “Agent Types”| Agent | Status | Purpose |
|---|---|---|
| Orchestrator | Active | Autonomous build system for Nucleus self-development. Manages Claude Code sessions to implement GitHub issues. |
| Dev Agent | Active | Automated Shopify theme and web development. Scopes, builds, tests, and deploys code for client projects. |
| Analytics | Active | Business metrics, utilisation, deals, and budget health reporting. |
| Resourcing | Active | Utilisation tracking, capacity planning, and squad allocation. |
| Marketing | Active | Content pipeline, story moments, and marketing metrics. |
| Product | Active | Feedback collection, roadmap management, and release communications. |
| Release | Active | PR merge, deployment, and rollback management. |
| Design Agent | Coming Soon | Figma-to-component workflows, design system generation. |
| Strategy Agent | Coming Soon | QBR prep, client research, opportunity analysis. |
| Delivery Agent | Coming Soon | Weekly reports, budget alerts, resourcing recommendations. |
Dev Agent
Section titled “Dev Agent”Pipeline Stages
Section titled “Pipeline Stages”The Dev Agent follows a 6-stage pipeline with human gates:
- Draft — Team member drafts a task spec, optionally with AI assistance
- Scoping — Claude Code analyses the task and repo, produces a structured scope document using the DC-MCP scope-writing skill
- Pending Approval — Human reviews and approves/rejects the scope
- Building — Claude Code implements the approved scope with full MCP stack (dc-mcp, shopify-dev, figma, playwright, github)
- Review — Human reviews PR, preview URL, Playwright screenshots, and CI status
- Done — PR merged and deployed to production
Project Configuration
Section titled “Project Configuration”Each project can enable the Dev Agent via the Agent tab in the project detail view. Configuration includes:
- Project type: Shopify Theme, Shopify Hydrogen, Website, Internal Platform, Custom
- GitHub org/repo: Repository for the agent to work in
- Deploy target: Shopify, Cloudflare Workers, Vercel, Netlify, Custom
- Preview URL pattern: Template for generating preview URLs
- Runner URL: URL of the dev runner container instance
Proof of Work
Section titled “Proof of Work”Before review approval, the system checks:
- Playwright status: Screenshots captured during the build verify visual correctness
- CI status: GitHub Actions or similar CI must pass
- Both gates can be force-overridden by managers
Cost Tracking
Section titled “Cost Tracking”The /agents/dev dashboard shows aggregate stats:
- Total tasks and runs
- Successful vs failed runs
- Total tokens used
- Total cost in USD
Orchestrator
Section titled “Orchestrator”The orchestrator dashboard at /agents/orchestrator (merged from the admin app) provides:
- Session monitoring: Live view of active Claude Code sessions
- Pipeline controls: Pause, resume, restart the autonomous loop
- Audit log: Recent events (session starts, completions, failures, escalations)
- Decision handling: Approve or block escalated tasks
Business Agents
Section titled “Business Agents”Each business agent at /agents/:agentId provides:
- Chat interface: Send commands and receive AI-generated responses
- Execution logs: History of scheduled runs and manual commands
- Manual triggers: Run daily/weekly reports on demand
Permissions
Section titled “Permissions”| Access Level | Can View | Can Update | Can Manage |
|---|---|---|---|
| Executive | Yes | Yes | Yes |
| Head | Yes | Yes | Yes |
| Manager | Yes | Yes | No |
| Lead | No | No | No |
| Employee | No | No | No |