agentleFS
JakeschincariolJakeschincariol/replica-skill/replica-deploy/SKILL.md

replica-deploy

Skill399 starsChanged 40 days agoMITView on GitHub

Ships an app clone live on the user's own domain: a preflight gate (tests green, parity must-haves done, rebrand sweep clean, listing linted, legal pages up), production database and env vars, the host, DNS records for the domain and for email, Stripe live mode, OAuth redirects, monitoring, and mobile builds to TestFlight and Play. Use when the user says "deploy it", "ship it", "put it live", "connect my domain", "go to production", "publish the app", or after /replica-launch.

  • Reads credentials

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run every check and paste the results into deploy.md:

    line 29
  2. Distinctive:

    OAuth: add the production domain to every provider's redirect URIs and authorised origins.

    line 59
  3. Very specific:

    Default: Vercel for Next.js (Netlify, Cloudflare Pages, Fly or Render otherwise).

    line 66

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

replica-deploy

Reads everything in replica/. Writes replica/deploy.md (the checklist in preflight.md in this folder, filled in).

The rules

  • Nothing goes live without the user's go. Show the preflight results and ask.
  • The user buys and signs in. Claude never buys a domain, enters a card, types a password or pastes a live key. Claude writes the exact DNS records, env var names and commands; the user does the account steps.
  • Not until it is rebranded. The sweep must be clean. No exceptions.

Step 1: preflight

Run every check and paste the results into deploy.md:

npx playwright test                                                  # replica-test
python3 ../replica-diff/parity.py replica/features.csv               # must-haves done
python3 ../replica-brand/sweep.py . --config replica/brand.json      # exit 0: clean
python3 ../replica-launch/listing.py replica/launch/listing.json     # if shipping to stores
npm run build                                                        # production build passes

(Paths are relative to wherever the pack is installed. Under ~/.claude/skills/ that is ~/.claude/skills/replica-diff/parity.py and so on.)

Plus by hand: no open S1 or S2 bugs, privacy policy and terms pages live (listing every processor), cookie banner if you use non-essential cookies in the EU or UK, account deletion works, the favicon, titles and OG image are yours.

Any failure stops the deploy. Say which and why.

Step 2: production services

  • A separate production project for the database (never the dev one), backups on, migrations run by the deploy, not by hand.
  • Env vars set in the host for production, matching .env.example. Live keys only here.
  • Stripe: switch to live mode, recreate products and prices, add the production webhook endpoint and its signing secret, test one real purchase and refund it.
  • OAuth: add the production domain to every provider's redirect URIs and authorised origins. Google scopes that need verification must be approved, or only test users can sign in.
  • Email: the sending domain verified with the provider.

Step 3: host and domain

Default: Vercel for Next.js (Netlify, Cloudflare Pages, Fly or Render otherwise). Connect the repo so main deploys and pull requests get preview URLs.

The domain, after the user buys it at any registrar:

recordnamevalue
A@the host's apex IP (Vercel: shown in the domain settings)
CNAMEwwwthe host's target (Vercel: cname.vercel-dns.com)
TXT@ or a subdomainthe host's verification value, if asked

Email DNS from the email provider: SPF (TXT), DKIM (CNAME or TXT), and a DMARC record starting at v=DMARC1; p=none; rua=mailto:you@yourdomain then tightened to quarantine once reports are clean. Without these, your confirmation emails go to spam.

Pick one canonical host (apex or www) and redirect the other. HTTPS is automatic on the hosts above; check it.

Step 4: watch it

Error tracking (Sentry or the host's), uptime checks on the home page and the core flow's API, logs kept, analytics (a privacy-friendly one avoids the cookie banner), and an alert to the user's email or phone. Then do the core flow on the live site yourself, and ask the user to do it on their phone.

Step 5: mobile, if there is an app

Expo: eas build then eas submit to TestFlight and Play internal testing. Native: archive in Xcode, upload to App Store Connect; Gradle bundle to Play Console. The user owns the developer accounts ($99 a year for Apple, $25 once for Google). Beta first, then review with the listing from replica-launch.

Output

replica/deploy.md with every check and its result, the live URL, the DNS records set, and what to watch in the first week. The clone is now an app with your name on it.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.