Skip to content
This repository was archived by the owner on Oct 27, 2026. It is now read-only.

shopify-agent-team.md

Latest commit

 

History

History
131 lines (98 loc) · 5.55 KB

shopify-agent-team.md

File metadata and controls

131 lines (98 loc) · 5.55 KB
Raw

Shopify Agency — Virtual Agent Team

Based on the architecture shared by Peter Kang, adapted for our Shopify agency workflow. Created: 2026-03-16

🧑‍💼 Agent Roster

1. Zuri — Shopify Config & Setup Agent

Handles all the store configuration work that doesn't require custom code

Skills:

  • store-settings — navigation, currencies, locales, checkout settings
  • shipping-zones — rates, zones, carrier setup
  • payment-config — gateway activation, payment method setup
  • app-install-config — install + basic configure common apps (Klaviyo, Yotpo, Reviews.io, etc.)
  • redirect-setup — bulk 301 redirects from migration data
  • metaobject-schema — define and create metaobject definitions

2. Nasir — Content & Data Population Agent

The content grunt — populates products, pages, collections, metafields from structured inputs

Skills:

  • product-import — from CSV/Google Sheet → Shopify Admin API (images, variants, metafields)
  • collection-setup — manual + smart collections, rules, sort orders
  • metafield-populate — bulk write metafields from structured data
  • page-content — create/update pages from a content brief or doc
  • blog-posts — import or create blog content
  • navigation-menus — build out header/footer nav from sitemap doc
  • media-upload — bulk upload + assign alt text

3. Morgan — Theme Build Agent

Handles Liquid/JS/CSS customization, section builds, and theme work from tickets

Skills:

  • section-builder — build a new Shopify section from a spec (Liquid + schema)
  • snippet-create — reusable Liquid snippets
  • theme-settings-update — update settings_data.json and settings_schema.json
  • css-token-update — update color/font/spacing variables
  • liquid-bugfix — fix a described rendering issue in theme code
  • dawn-to-custom — common Dawn customization patterns
  • shopify-cli-deploy — push theme to staging or production via Shopify CLI

4. Alex — QA Agent

Runs automated checks after every deployment

Skills:

  • playwright-smoke — run a smoke test suite against a staging URL
  • link-checker — crawl and report broken links
  • mobile-responsive-check — screenshot key pages at mobile/tablet/desktop
  • checkout-flow-test — automated end-to-end checkout on staging
  • pagespeed-report — pull Core Web Vitals + Lighthouse for key pages
  • accessibility-scan — basic WCAG checks on theme pages

5. Nia — Reporting & Client Ops Agent

Handles anything that goes to the client or internal tracking

Skills:

  • project-status-report — generate a progress summary from Kanban board state
  • client-handoff-doc — produce a post-launch checklist/handoff doc
  • analytics-setup — GA4 + Meta Pixel implementation verify
  • seo-audit — meta titles, descriptions, canonical tags check across key pages
  • launch-checklist — run through a pre-launch checklist and output pass/fail

🔐 Access Tiers

Tier Applies to
🟢 Autonomous Read-only ops, generating docs/reports, running tests against staging
🟡 Notify Outputs a file/diff for human review before applying (e.g. metafield CSV, theme code changes)
🔴 Gate Anything writing to a live client store — requires PM approval before executing

🏗️ Architecture Reference

Based on the three-tier Skills MCP architecture:

  • Skills library — GitHub repo, one folder per skill, each with a SKILL.md and helper scripts
  • MCP Server — hosted on Railway, routes skills to agents via API key
  • Composio — OAuth integrations, one credential set per client store
  • Claude Teams — agent runtime
  • Kanban board — human-facing task queue (Linear / Notion / Airtable)

🛠️ Build Order (recommended)

  1. Spec out product-import and section-builder first — highest volume, clearest ROI
  2. Define structured input formats — what does a content brief look like? What's in a section build ticket?
  3. Stand up GitHub skills repo — one folder per skill
  4. Wire Composio for Shopify Admin API OAuth per client
  5. Build staging-only agent runs first — Gate all live store writes until the skills are proven

📝 Notes

  • Solis replacement target: Zuri (config) + Nasir (content) cover most of the offshore workload
  • Morgan requires the most skill investment — theme work needs well-spec'd tickets to work reliably
  • Alex (QA) is the safety net — don't skip building this out early

Extended Team (added post-launch)

The following specialist agents were added to support the core 5 + orchestrator:

Agent Role Supports
Rick Theme Architect Morgan — Figma → section/block architecture plans
Yuriy Liquid Developer Morgan — architecture → production Liquid code
Roy Asset Manager Morgan — Figma export → Shopify Files → template JSON
Rob Theme Deployer Morgan — push theme files to stores
Tiffany Figma Design Auditor Morgan — mandatory design audit after every deploy
Jules Accessibility Auditor Alex — WCAG compliance audit
Ja QA Remediator Alex — surgical code fixes post-audit
Hal Optimization Architect Standalone — API perf testing, cost guardrails
Cindy Frontend Developer Standalone — React/Vue/Angular, non-Shopify
Cas Backend Architect Standalone — system design, APIs, databases
Justin Fullstack Scaffolder Standalone — greenfield project setup