How to use AI to code on Shopify as a non-coder

In short: Set up a git pipeline with separate development, testing and live themes, use Claude Code rather than Cowork, give your coding agent a short agents.md instruction file, and write concrete, specific prompts. If your store does significant volume, still have someone who can read the code review it.

Following these steps helps you avoid the pitfalls of blindly AI developing your site.

1. Set up a proper pipeline

Local version of your theme with git, connected to a github.

Two or three branches, development, testing and production / main.

NEVER push untested AI code to main without testing.

Main is connected as your live theme, the others are draft themes connected to Shopify as well (for testing / debugging).

2. [CLAUDE specific] Use Code, not Cowork

Cowork runs in a virtual machine and now in the cloud, so you'll run into some issues (I'll spare you the technical details).

Use Claude Code instead.

3. Create a short, specific instruction file

An agents.md file will be read by all the common coding agents.

You can use it to give specific instructions on how you want them to behave during coding.

This is where the magic happens.

For example: Tell it to use shared assets and reuse existing components instead of coding every new feature from scratch.

"all colors, spacing, and type scale are CSS variables in assets/base.css; never hardcode values, never create a new per-section stylesheet unless the styles are truly section-specific"

"new features go in sections with schema settings so I can configure them; no content hardcoded in Liquid"

This is theme specific, but this is how to prevent code bloat / slow sites and complicated code a human will struggle to read.

4. Be ultra specific

When giving instructions, avoid being general or platitudes.

You want to leave no room for hallucination / interpretation.

"Follow Shopify best practices" does almost nothing.

"Before adding any snippet, list snippets/ and reuse an existing one if it covers the need" works, because it's a concrete action tied to a trigger.

AI vibe coding your site is still pretty risky if you put through significant volume.

Ideally you want someone that can understand and modify the code output.

But following the above will give you the best shot at coding your site yourself without any issues.

Frequently asked questions

Can a non-coder safely edit a Shopify theme with AI?

Yes, as long as untested code never reaches your live theme. Work on a development branch connected to a draft theme, test there, and only merge into main (your live theme) once it works.

What is an agents.md file?

An instruction file in your theme repository that the common coding agents read before they work. Use it for rules such as reusing existing components and CSS variables instead of hardcoding new values.

Why use Claude Code instead of Cowork?

Cowork runs in a virtual machine and now in the cloud, which causes issues for theme development. Claude Code is the better fit for working on a local theme connected to git.

What makes a good instruction for an AI coding agent?

A concrete action tied to a trigger. “Follow Shopify best practices” does almost nothing; “Before adding any snippet, list snippets/ and reuse an existing one if it covers the need” works.

Sources

Spotted something wrong or out of date? Email hello@kirkbyconsulting.com with the details and we will correct it.