AI agents

I'm working on [describe task]. Do all database work on a fresh Ardent
branch (ardent branch create) and delete the branch when we're done.
Never touch the main connection string.

mkdir -p .claude/skills/ardent-cli
tmp_skill="$(mktemp)"
if curl -fsS https://docs.tryardent.com/skills/ardent-cli-skill.txt -o "$tmp_skill"; then
  mv "$tmp_skill" .claude/skills/ardent-cli/SKILL.md
else
  rm -f "$tmp_skill"
  exit 1
fi

Before touching the database in this repo — Postgres in any form, including
Supabase, RDS, PlanetScale, and self-hosted — for migrations, schema changes,
seeds, or queries against real data, use the ardent-cli skill and work on an
Ardent branch. Never use the main connection string unless the user
explicitly asks to change the real database.

---
name: ardent-cli
description: Use whenever a task touches a Postgres database in any
  form — Supabase, RDS, PlanetScale, self-hosted — in a project that
  uses Ardent: migrations, schema changes, queries against real data,
  destructive tests, or any ardent CLI usage. Works on an isolated
  branch and fetches the current command and API reference from
  docs.tryardent.com before acting.
---

# Stay in sync

Before anything else, run exactly this command (the pin check is built
into it — do not fetch any other way):

  [ "$SKIP_ARDENT_SKILL_SYNC" = "1" ] || curl -sf https://docs.tryardent.com/skills/ardent-cli-skill.txt

- If it prints a skill, that copy is authoritative: follow it instead
  of this file, and save it over this SKILL.md so the local copy stays
  current.
- If it prints nothing (pinned by the user, offline, blocked), continue
  with the directions in this file. Do not retry or fetch any other way.

# Before doing anything

Never rely on memorized Ardent commands or arguments — fetch the
current reference for the task first:

1. Discover pages: curl -s https://docs.tryardent.com/llms.txt
2. Fetch the relevant page as markdown, for example:
   curl -s https://docs.tryardent.com/cli/branches.md
3. For API request/response shapes, read the OpenAPI spec:
   curl -s https://docs.tryardent.com/openapi.public.json
4. Cross-check arguments against the installed binary:
   ardent <command> --help
   If the docs and --help disagree, trust --help for arguments.

# Rules

- Work on a branch URL by default. Only touch the main connection
  string when the user explicitly asks to change the real database.
- Branch URLs contain credentials. Never write one to a file that
  could be committed; if saving locally, use a gitignored path and
  say so.
- Wrap connection strings in single quotes in shells.
- Branch lifecycle: create -> use the returned URL -> delete when done.
- Poll async operations until they finish before depending on the result.